Template:VisuMZ Events and Movement Core Notetags

From Yanfly.moe Wiki
Revision as of 16:13, 15 April 2022 by Yanfly (talk | contribs) (Event and Event Page Notetags)
Jump to navigation Jump to search

The following are notetags that have been added through this plugin. These notetags will not work with your game if this plugin is OFF or not present.

Some of these are comment tags. Comment tags are used for events to mark and affect individual event pages rather than the whole event.

Map Notetags

The following notetags are used for maps only. While some of these options are also available in the Plugin Parameters, some of these notetags extend usage to specific maps marked by these notetags as well.

---

EventsMoveCoreVS8.gif

<Diagonal Movement: On>
<Diagonal Movement: Off>

- Used for: Map Notetags
- Turns on/off diagonal movement for those maps.
- If notetag isn't present, use Plugin Parameter setting.

---

EventMoveCoreRegions.png

<type Allow Region: x>
<type Allow Region: x, x, x>

<type Forbid Region: x>
<type Forbid Region: x, x, x>

<type Dock Region: x>
<type Dock Region: x, x, x>

- Used for: Map Notetags
- Replace 'type' with 'All', 'Walk', 'Player', 'Event', 'Vehicle', 'Boat',
  'Ship', or 'Airship'.
- 'Allow' notetag variants allow that type to pass through them no matter
  what other passability settings are in place.
- 'Forbid' notetag variants forbid that type from passing through at all.
- 'Dock' notetag variants allow vehicles to dock there. Boats and ships must
  face the region direction while airships must land directly on top.

---

<Save Event Locations>

- Used for: Maps Notetags
- Saves the locations of all events on the map so that when you return to
  that map at a later point, the events will be in the position they were
  last in.

---

<Hide Player>
<Show Player>

- Used for: Map Notetags
- Forcefully hides or shows the player sprite. This is so you don't need to
  manually turn the setting on/off each time you enter a specific map.
- These settings will take priority over the event commands.
- If the player sprite is hidden, so are the player's followers.
- If the player sprite is visible, the player's followers will still depend
  on their settings.
- These notetags are mutually exclusive from each other.

---

<Hide Followers>
<Show Followers>

- Used for: Map Notetags
- Forcefully hides or shows the player's followers. This is so you don't
  need to manually turn them on/off each time you enter a specific map.
- These settings will take priority over the event commands.
- These notetags are mutually exclusive from each other.

---

Page Comment Tags

The following comment tags are to be put inside of the pages of events, troops, and common events for them to work!

---

<Page Conditions>
  conditions
  conditions
  conditions
</Page Conditions>

- Used for: Map Event Page, Troop Page, and Common Event Page Comment Tags
- This allows you to create custom page conditions that utilize the
  Conditional Branch event command to see if the additional page conditions
  are met.

---

<Conditions Met>
- Used for: Map Event Page, Troop Page, and Common Event Page Comment Tags
- If used between the <Page Conditions> and </Page Conditions> comment tag,
  upon reaching this part of event command list, the custom page conditions
  will be considered met.

---

EventsMoveCoreCustomPageCondition.png

Example:

◆Comment:<Page Conditions>
◆If:Reid has equipped Potion Sword
  ◆Comment:If Reid has equipped the Potion Sword
:       :<Condition Met>
  ◆
:End
◆Comment:</Page Conditions>

If Reid has the "Potion Sword" weapon equipped, then the additional custom
page conditions are met and the event page will be present/active.

If this is a troop condition, the troop page event will activate.

If this is a common event, there will be a parallel common event active.

---

Event and Event Page Notetags

The following notetags have comment tag variants (with a few exceptions). If a notetag is used for an event, it will affect the event constantly. If a comment tag is used, it will only affect the page the comment tag is on and only that page.

---

EventsMoveCoreActivationRegion.png

<Activation Region: x>
<Activation Regions: x,x,x>

- Used for: Event Notetags and Event Page Comment Tags
- Allows this event to be remotely activated as long as the player is
  standing within a tile marked by a designated region.
- Replace 'x' with the regions you wish to remotely activate this event in.
  - Action Button: Player must press OK while being in the region.
  - Player/Event Touch: Player must step onto the region.
  - Autorun/Parallel: Player be in the region.
- If this is placed in a notetag, the effect will be present across
  all event pages used.
- If this is placed inside a page's comment, the effect will only occur
  if that event page is currently active.
- NOTE: This cannot be used with any other activation tags.

---

EventsMoveCoreActivationAreas.png

<Activation Square: x>
<Activation Radius: x>
<Activation Row: x>
<Activation Column: x>

- Used for: Event Notetags and Event Page Comment Tags
- Allows this event to be remotely activated as long as the player is
  within range of its activation type.
- Replace 'x' with a number stating the range in tiles.
  - Square: A square-shaped range with the event at the center.
  - Radius: A diamond-shaped range with the event at the center.
  - Row: Spans horizontally across the map. 'x' expands up and down.
  - Column: Spans vertically across the map. 'x' expands left and right.
- If this is placed in a notetag, the effect will be present across
  all event pages used.
- If this is placed inside a page's comment, the effect will only occur
  if that event page is currently active.
- NOTE: This cannot be used with any other activation tags.

---

<Always Update Movement>

- Used for: Event Notetags and Event Page Comment Tags
- Events normally have to be within screen range for them to update their
  self movement. If this tag is present, the event is always updating.
- If this is placed in a notetag, the effect will be present across
  all event pages used.
- If this is placed inside a page's comment, the effect will only occur
  if that event page is currently active.

---

EventsMoveCoreClickTrigger.gif

<Click Trigger>

- Used for: Event Notetags and Event Page Comment Tags
- Allows this event to activate upon being clicked on with the mouse.
- If this is placed in a notetag, the effect will be present across
  all event pages used.
- If this is placed inside a page's comment, the effect will only occur
  if that event page is currently active.

---

<Copy Event: Map x, Event y>
<Copy Event: x, y>

<Copy Event: template>

- Used for: Event Notetags ONLY
- Makes this event copy all of the event settings from a different event
  that can be found on a different map (as long as that map is registered
  inside of Plugin Parameters => Event Template Settings => Preloaded Maps).
- Replace 'x' with a number representing the copied event's Map ID.
- Replace 'y' with a number representing the copied event's Event ID.
- For the 'template' variant, replace 'template' with the name of the
  template made in Plugin Parameters => Event Template Settings =>
  Event Template List.
- If this is placed in a notetag, the effect will be present across
  all event pages used.
- If this is placed inside a page's comment, the effect will only occur
  if that event page is currently active.

---

<Custom Z: x>

- Used for: Event Notetags and Event Page Comment Tags
- Replace 'x' with a number value to determine the event sprite's Z value
  relative to the tilemap.
- For reference from rmmz_core.js:
  - 0 : Lower tiles
  - 1 : Lower characters
  - 3 : Normal characters
  - 4 : Upper tiles
  - 5 : Upper characters
  - 6 : Airship shadow
  - 7 : Balloon
  - 8 : Animation
  - 9 : Destination
- You can use numbers below 0 and above 9.
  - Values under 0 go below the tilemap.
  - Values above 9 go above everything else on the tilemap.
  - These values do NOT go below or above other screen objects that are
    NOT attached to the tilemap layer such as parallaxes or weather or
    windows because that's simply not how z-axis work with sprite layers.

---

EventsMoveCoreHitbox fixed.png

<Hitbox Left: x>
<Hitbox Right: x>
<Hitbox Up: x>
<Hitbox Down: x>

- Used for: Event Notetags and Event Page Comment Tags
- Replace 'x' with a number to extend the hitbox of the event by that many
  tiles towards the listed direction.
- Use multiples of this notetag to extend them to different directions.
- If this is placed in a notetag, the effect will be present across
  all event pages used.
- If this is placed inside a page's comment, the effect will only occur
  if that event page is currently active.

---

EventsMoveCoreIcon.png

<Icon: x>

- Used for: Event Notetags and Event Page Comment Tags
- Replace 'x' with the Icon ID you wish to put above this event.
- This will not override any Icons designated to the ID through a
  Plugin Command.
- If this is placed in a notetag, the effect will be present across
  all event pages used.
- If this is placed inside a page's comment, the effect will only occur
  if that event page is currently active.

---

<Icon Buffer X: +x>
<Icon Buffer X: -x>

<Icon Buffer Y: +x>
<Icon Buffer Y: -x>

<Icon Buffer: +x, +y>
<Icon Buffer: -x, -y>

- Used for: Event Notetags and Event Page Comment Tags
- Allows you to adjust the positions of the icon on the envent by buffers.
- Replace 'x' and 'y' with the values to adjust the position buffers by.
- If this is placed in a notetag, the effect will be present across
  all event pages used.
- If this is placed inside a page's comment, the effect will only occur
  if that event page is currently active.

---

EventsMoveCoreLabel.png

<Label: text>

- Used for: Event Notetags and Event Page Comment Tags
- Puts a label over the event's head displaying 'text'.
- Text codes can be used.
- If this is placed in a notetag, the effect will be present across
  all event pages used.
- If this is placed inside a page's comment, the effect will only occur
  if that event page is currently active.

---

<Label>
text
text
</Label>

- Used for: Event Notetags and Event Page Comment Tags
- Puts a label over the event's head displaying 'text'.
- This can display multiple lines.
- Text codes can be used.
- If this is placed in a notetag, the effect will be present across
  all event pages used.
- If this is placed inside a page's comment, the effect will only occur
  if that event page is currently active.

---

<Label Range: x>

- Used for: Event Notetags and Event Page Comment Tags
- Sets a range requirement for the player to be in order for the event's
  label to appear.
- Replace 'x' with a number value depicting the range in tiles.
- If this is placed in a notetag, the effect will be present across
  all event pages used.
- If this is placed inside a page's comment, the effect will only occur
  if that event page is currently active.

---

<Label Offset X: +x>
<Label Offset X: -x>

<Label Offset Y: +x>
<Label Offset Y: -x>

<Label Offset: +x, +y>
<Label Offset: -x, -y>

- Used for: Event Notetags and Event Page Comment Tags
- Allows you to adjust the positions of the label on the envent by offsets.
- Replace 'x' and 'y' with the values to adjust the position offsets by.
- If this is placed in a notetag, the effect will be present across
  all event pages used.
- If this is placed inside a page's comment, the effect will only occur
  if that event page is currently active.

---

EventsMoveCore MirrorSprite.gif

<Mirror Sprite>

- Used for: Event Notetags and Event Page Comment Tags
- The event sprite's visual appearance is mirrored.

---

EventsMoveCoreMoveOnlyRegion.gif

<Move Only Region: x>
<Move Only Regions: x,x,x>

- Used for: Event Notetags and Event Page Comment Tags
- Sets the move range of this event to only the region(s) marked by the
  notetag(s) or comment tag(s).
- This will bypass terrain passability.
- This will not bypass event collision.
- If this is placed in a notetag, the effect will be present across
  all event pages used.
- If this is placed inside a page's comment, the effect will only occur
  if that event page is currently active.

---

EventsMoveCoreMoveSynch.gif

<Move Synch Target: Player>

<Move Synch Target: Event x>

- Used for: Event Notetags and Event Page Comment Tags
- Synchronizes the movement of this event with a target (either the player
  or another event). This event will only move whenever the synchronized
  target moves.
- For 'Event x' variant, replace 'x' with the ID of the event to synch to.
- If this is placed in a notetag, the effect will be present across
  all event pages used.
- If this is placed inside a page's comment, the effect will only occur
  if that event page is currently active.

---

<Move Synch Type: Random>
<Move Synch Type: Approach>
<Move Synch Type: Away>
<Move Synch Type: Custom>

<Move Synch Type: Mimic>
<Move Synch Type: Reverse Mimic>

<Move Synch Type: Mirror Horizontal>
<Move Synch Type: Mirror Vertical>

- Used for: Event Notetags and Event Page Comment Tags
- Choose the type of movement the event will have if it is synchronized to
  a target.
  - Random: Move to a random position.
  - Approach: Approaches target.
  - Away: Flees from target.
  - Custom: Follows a custom move route.
  - Mimic: Imitates the target's movement style.
  - Reverse Mimic: Does the opposite of the target's movement.
  - Mirror Horizontal: Moves as if a mirror is placed horizontally.
  - Mirror Vertical: Moves as if a mirror is placed vertically.
- If this is placed in a notetag, the effect will be present across
  all event pages used.
- If this is placed inside a page's comment, the effect will only occur
  if that event page is currently active.

---

<Move Synch Delay: x>

- Used for: Event Notetags and Event Page Comment Tags
- If this tag is present, the event will wait a bit after each move before
  moving again.
- Replace 'x' with the number of movement instances in between.
- If this is placed in a notetag, the effect will be present across
  all event pages used.
- If this is placed inside a page's comment, the effect will only occur
  if that event page is currently active.

---

<Move Synch Distance Opacity: x>

- Used for: Event Notetags and Event Page Comment Tags
- Changes the opacity of the event based on the distance between it and its
  move synched target. Closer means more opaque. Further away means more
  transparent.
- Replace 'x' with a number representing the opacity change per pixel
  distance away. 'x' can use decimal values like 1.05 and 1.5.

---

EventsMovementCore Update25 WeightedRandom.png

<Random Move Weight: x>

- Used for: Event Notetags and Event Page Comment Tags
- If this tag is used on an event with random-type autonomous movement, then
  the event will stick closer to their home location (where they are located
  upon spawning on the map). How close they stick to their home location
  will depend on the weighted 'x' value.
- Replace 'x' with a number between 0 and 1. Numbers closer to 0 give the
  event more freedom when moving randomly while numbers closer to 1 cause
  the event to stick closer to their home position.

---

<True Random Move>

- Used for: Event Notetags and Event Page Comment Tags
- If this tag is used on an event with random-type autonomous movement, then
  that event will ignore the effects of weighted randomized movement.

---

<Save Event Location>

- Used for: Event Notetags ONLY
- Saves the locations of the event on the map so that when you return to
  that map at a later point, the event will be in the position it was
  last in.

---

EventsMoveCoreShadow.png

<Hide Shadow>
- Used for: Event Notetags and Event Page Comment Tags
- Hides the shadow for the event.
- If this is placed in a notetag, the effect will be present across
  all event pages used.
- If this is placed inside a page's comment, the effect will only occur
  if that event page is currently active.

---

<Shadow Filename: filename>

- Used for: Event Notetags and Event Page Comment Tags
- Replaces the shadow graphic used with 'filename' found in the
  img/system/ project folder.
- If this is placed in a notetag, the effect will be present across
  all event pages used.
- If this is placed inside a page's comment, the effect will only occur
  if that event page is currently active.

---

<Sprite Offset X: +x>
<Sprite Offset X: -x>

<Sprite Offset Y: +x>
<Sprite Offset Y: -x>

<Sprite Offset: +x, +y>
<Sprite Offset: -x, -y>

- Used for: Event Notetags and Event Page Comment Tags
- Changes how much the event's sprite is visibly offset by.
- Replace 'x' and 'y' with numbers indicating the offset in pixels.
- If this is placed in a notetag, the effect will be present across
  all event pages used.
- If this is placed inside a page's comment, the effect will only occur
  if that event page is currently active.

---

<Step Pattern: Left to Right>
<Step Pattern: Right to Left>

<Step Pattern: Spin Clockwise>
<Step Pattern: Spin CW>

<Step Pattern: Spin CounterClockwise>
<Step Pattern: Spin CCW>
<Step Pattern: Spin AntiClockwise>
<Step Pattern: Spin ACW>

- Used for: Event Notetags and Event Page Comment Tags
- Changes the way the event animates if a tag is present.
  - Left to Right: Makes the event sprite's step behavior go from frame 0 to
    1 to 2, then back to 0 instead of looping backward.
  - Right to Left: Makes the event sprite's step behavior go from frame 2 to
    1 to 0, then back to 2 instead of looping forward.
  - Spin Clockwise: Makes the event sprite's step behavior spin CW.
  - Spin CounterClockwise: Makes the event sprite's step behavior spin CCW.
- If this is placed in a notetag, the effect will be present across
  all event pages used.
- If this is placed inside a page's comment, the effect will only occur
  if that event page is currently active.

---