Download

The plugin allows you to manage events by calling commands.

In its arsenal it contains such things as changing the local switch of any event on any map and the ability to change the position of an event or automatically remember its last state.

Now let's take things in order.

The plugin has 4 commands.

---

Let's look at the first command "Switch event A B C D"

The command allows you to toggle the local switch of any event on any map. The structure is as follows:

1.  Map Id — explicitly specifies the id of the map on which the event is located. If you do not specify a value or specify a value of 0, the current map on which the player is currently located is automatically taken.
2. Event Id — explicitly specifies the event id for which you want to change the switch state. The field is required. If you specify a non-existent id or 0, the command simply will not work, no errors are displayed in the console.
3. Switch — responsible for defining the switch to be toggled. Required.
4. State — the flag indicating whether the switch is on (true) or off (false).

---

Let's look at the "Move Event" command

The command allows you to move any event on any map by X, Y coordinates and set the direction. The state is saved to the save file.

IMPORTANT! The command has a "deferred" effect. This means that all changes will be applied only when you switch to the specified map.

1. Map Id — as before, works similarly to the previous command.
2. Event Id — as before, works similarly to the previous command.
3. X — coordinate is responsible for changing the position of the event along the X coordinate. If there is no value, the coordinate does not change. If the value is 0 or more, the coordinate changes to the corresponding value.
4. Y — coordinate is responsible for changing the position of the event along the Y coordinate. If there is no value, the coordinate does not change. If the value is 0 or more, the coordinate changes to the corresponding value.
5. Direction — sets the direction for the event. By default, the choice consists of: up, down, left, right.

This way, the command can be used to change the X or Y coordinate or direction separately without changing the rest of the original event values.

---

Let's look at the commands "Switch event A B C D [MULTI]" and "Move event [MULTI]"

The commands are similar in their functionality, so they are considered together. The structure looks like this:

1. List of switches or list of moves. Contains a list of one or another structure.
2. Next comes the list of commands that are executed in sequence from 1 to the last element in the collection.
3. The very structure of the switch or movement, which is completely analogous to the work of calls to single commands.

Commands like these can be useful if you need to switch or move multiple events on an event page.

The advantage of the [MULTI] commands is the ability to copy the entire list of actions (or part of it) and simply paste or supplement the list in any other similar [MULTI] command. Thus, making the transfer process simpler and more flexible.

---

Let's look at the script <FSEvent_SaveLoc>

This script is used to save the last state of an event before exiting the map. The state is saved to a save file.

To use it, simply place the command in the event note:

The command is protected from accidental indents, spaces, other commands of a similar format, or nesting in another command (not recommended), which ensures its execution.

IMPORTANT! The command has the highest execution priority. This means that if any other command with a delayed action (for example, moving) was previously applied to the specified event within the current map, these changes will be cancelled.

If you apply a command to an event with the <FSEvent_SaveLoc> command to move outside the map on which the event with the <FSEvent_SaveLoc> command is located, then the changes to the command will become relevant.

This is due to the fact that the <FSEvent_SaveLoc> command and the move plugin command use the same mechanism for saving the event position and its state, and accordingly the commands are able to overwrite the values, updating them.