rpgmaker-dialog

RPG Maker Dialog Skill

This skill covers reading, writing, and editing NPC dialog in RPG Maker MV and MZ projects. It teaches agents where dialog lives in the project files, what the event command structure looks like, and how to maintain character voice consistency when drafting new lines.

All dialog suggestions generated by this skill are drafts for developer review — never authoritative final copy.

---

Where Dialog Lives

Dialog is stored as structured event commands in three locations:

1. data/CommonEvents.json

Reusable dialog sequences — inn conversations, quest hand-ins, shop greetings. This file is a JSON array where index 0 is always null. Each event object has an id, name, and list of event commands.

[
  null,
  {
    "id": 1,
    "name": "Innkeeper Dialog",
    "trigger": 0,
    "switchId": 0,
    "list": [
      { "code": 101, "indent": 0, "parameters": ["Actor1", 0, 0, 2] },
      { "code": 401, "indent": 0, "parameters": ["Welcome to the village inn!"] },
      { "code": 0,   "indent": 0, "parameters": [] }
    ]
  }
]

2. data/MapXXX.json event pages

NPC dialog attached to a specific map. Each map file has an events array (null at index 0). Each event has a pages array, and each page has a list of event commands.

{
  "events": [
    null,
    {
      "id": 1,
      "name": "Innkeeper",
      "pages": [
        {
          "list": [
            { "code": 101, "indent": 0, "parameters": ["Actor1", 0, 0, 2] },
            { "code": 401, "indent": 0, "parameters": ["Hello traveler!"] },
            { "code": 0,   "indent": 0, "parameters": [] }
          ]
        }
      ]
    }
  ]
}

3. data/System.json terms

UI text — menu labels, battle messages, status names. Not NPC dialog, but text fields agents may need to review or update. Modify with care; this file also holds the currency unit name (currencyUnit) and other engine settings.

---

Dialog Command Codes

Every dialog block follows this structure. For the full command code reference, see ../shared/references/event-command-codes.md.