Custom Notetag Cheat-Sheet

Auto-generated from tools/notetag-tools.js — covers only this project's home-grown plugins (not VisuStella). Run the same tool's lint mode to validate your data files against these.

NotetagApplies toValueWhat it doesExample
GameUtilities.js
<Anim Offset X: …> skillitem integer Shift this skill/item's animation horizontally by N pixels (positive = right). <Anim Offset X: 20>
<Anim Offset Y: …> skillitem integer Shift this skill/item's animation vertically by N pixels (positive = up). <Anim Offset Y: 50>
<Attack SE: …> weaponactorenemy audio/se filename SE played on this battler's basic attack. An equipped weapon's tag overrides the actor's. <Attack SE: Slash5>
<Auto State: …> actor state ID State automatically applied when the actor's HP drops to/below the Auto State Threshold. <Auto State: 17>
<Auto State Threshold: …> actor number (0…1) HP rate (0.0–1.0) at or below which Auto State is applied. Pair with <Auto State>. <Auto State Threshold: 0.5>
<Basic Attack Animation: …> actorenemy animation ID Override the basic attack animation ID. On actors a weapon's own Animation field still wins; on enemies it sets the normal-attack animation (needs VisuMZ_1_BattleCore). <Basic Attack Animation: 7>
<Negative> state flag (no value) Marks a state as negative so removeNegativeStates() helper clears it. <Negative>
<ScavengePool: …> map weapon ID list Weapon IDs Aida can scavenge on this map (comma-separated). Read when scavenge() is called without a pool argument. <ScavengePool: 4, 7, 12>
<Silent Hit SE> skillitem flag (no value) Suppress the animation's built-in SE for this skill so an <Attack SE> can play instead. <Silent Hit SE>
HpFaceSwap.js
<Face Index Override: …> state integer (0…∞) While this state is active, force the actor's face index to N (ignores HP logic). <Face Index Override: 8>
<No HP Face Swap> actor flag (no value) Disable HP-based face-index swapping for this actor. <No HP Face Swap>
<No HP Portrait Swap> actor flag (no value) Disable HP-based portrait-filename swapping for this actor. <No HP Portrait Swap>
<Portrait Suffix Override: …> state text While this state is active, append this suffix to the actor's portrait filename. <Portrait Suffix Override: _angry>
PronounDisplay.js
<Pronouns: …> actor text Pronoun string drawn under the actor's name in the main menu status window. <Pronouns: they/them>
TextSounds.js
<Text Pitch: …> actor integer (0…150) Base pitch for this actor's text sound. <Text Pitch: 120>
<Text Sound: …> actor audio/se filename Per-actor text blip SE, used when the message contains \Voice[actorId]. <Text Sound: blip1>
<Text Volume: …> actor integer (0…100) Base volume for this actor's text sound. <Text Volume: 80>

Generated 2026-05-29 · 17 custom notetags across 4 plugins.