create_state
Create a status condition (like Poison or Sleep) in RPG Maker MZ's States.json. Only a name is required; the tool assigns the next unused state ID automatically.
Instructions
Create a new state (status condition like Poison/Sleep) in data/States.json. Only name is required; omitted fields use the editor's new-state defaults (no restriction, priority 50, no auto-removal, 1-turn duration). Allocates and returns the next unused state id.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | State name shown in the database and battle messages | |
| note | No | Note field | |
| dryRun | No | Preview only: return a diff of what would change without writing to disk. | |
| motion | No | SV-actor motion (0 normal, 2 sleep, 3 dead, …) | |
| traits | No | Trait objects { code, dataId, value } | |
| overlay | No | Overlay animation index (0 = none) | |
| maxTurns | No | Maximum duration in turns when auto-removed | |
| message1 | No | Message when an actor gains the state | |
| message2 | No | Message when an enemy gains the state | |
| message3 | No | Message when the state persists | |
| message4 | No | Message when the state is removed | |
| minTurns | No | Minimum duration in turns when auto-removed | |
| priority | No | Icon-slot display priority 0-100 (default 50) | |
| iconIndex | No | Icon shown on the battler/status (0 = none) | |
| messageType | No | Engine's message routing form | |
| restriction | No | Behavior restriction: 0 none, 1 attack enemy, 2 attack anyone, 3 attack ally, 4 cannot move | |
| stepsToRemove | No | Steps to walk off the state when removeByWalking | |
| chanceByDamage | No | Chance (%) of removal per damage instance when removeByDamage | |
| removeByDamage | No | Remove when the battler takes damage | |
| releaseByDamage | No | Whether damage can release the state | |
| removeByWalking | No | Remove after walking a number of steps | |
| autoRemovalTiming | No | Auto-removal timing: 0 none, 1 at action end, 2 at turn end | |
| removeAtBattleEnd | No | Remove automatically when the battle ends | |
| removeByRestriction | No | Remove when the battler's restriction changes |