ToshA_Localization — Runtime i18n (CSV/JSON) for RPG Maker MZ

Auto-capture UI/messages/database strings into CSV/JSON and replace them at runtime. Hotkeys for export/reload, language switch, and optional title/options UI.

Demo vs Full

Feature	Demo	Full
Additional languages	+1	Unlimited
Capture: Database, System Terms, Event text (Show Text/Choices)	✔	✔
Capture on-screen UI via drawText/Bitmap.drawText (menus, window headers, button labels, plugin UI, etc.)	—	✔ (everything on screen)
Best for	Evaluation & small tests	Production projects & total coverage

Features

• Auto-extract: database (names/descriptions), system terms, event text; Full also captures UI text drawn on screen.
• Optional full map scan on boot (reads MapXXX.json in NW.js test/PC build).
• Stores to CSV (default, ; delimiter) or JSON; optional split by category (DB/Events/UI/Terms).
• Stable keys from source text and DB paths (e.g. Database.Items.1.name).
• Runtime replacement for DB and $dataSystem.terms; auto-refreshes the current scene.
• Hotkeys: F6 export, F7 reload, F8 next language.
• Optional language switch in Options/Title + title language icon with flags.

Install & Setup

1. Put ToshA_Localization.js into js/plugins/ and enable it.
2. Recommended format: CSV. Default output folder: data/i18n (configurable).
3. Run the game in NW.js (test/PC). The plugin collects strings into CSV/JSON on the fly.
4. Edit translations and press F7 to reload; use F8 to switch language.

Plugin Commands

• setLanguage — set current language (code=en).
• exportNow — write CSV/JSON immediately.
• reload — reload translations from disk and reapply.
• setFreezeCapture — stop/start capturing new strings (value=true/false).

Examples

// Event command → Script call:
PluginManager.callCommand(this,"ToshA_Localization","setLanguage",{ code:"en" });
PluginManager.callCommand(this,"ToshA_Localization","exportNow",{});
PluginManager.callCommand(this,"ToshA_Localization","reload",{});
PluginManager.callCommand(this,"ToshA_Localization","setFreezeCapture",{ value:true });

Notes

• Writing CSV/JSON works only in NW.js (desktop). In browser builds, writing is disabled; the game still runs with existing translations.
• UI capture (drawn text) is Full only; enabling it may pick dynamic/noisy strings — use filters if needed.

License & Credits

Paid plugin on itch.io. Purchasing grants a license to use it in your projects. Please credit ToshaAngel.
Do not redistribute or re-sell the plugin file.

---

Author: ToshaAngel • Prefix: ToshA_ • Engine: RPG Maker MZ