public

Rpg Maker Developers Group

Simple enough for a child, powerful enough for a developer

3 Followers
Log in to follow

MZMZ ToshA_Localization

BMM_Archive · July 15, 2026

BMM_Archive
LEVEL 14 Crown 47,370
Preserved forum archive. This topic stores the original first post and locally mirrored RPG Maker Web attachments when available. It is posted by the BMMPlay archive account, not by the original creator.

Original Source

  • Original title: MZ ToshA_Localization
  • Original author: ToshaAngel
  • Original date: August 18, 2025
  • Source thread: https://forums.rpgmakerweb.com/threads/tosha_localization.179635/
  • Source forum path: Game Development Engines > RPG Maker Javascript Plugins > JS Plugin Releases (RMMZ)

Summary

ToshA_Localization — Runtime i18n (CSV/JSON) for RPG Maker MZ by ToshaAngel​ What is it? Runtime localization system that auto-captures UI/messages/database strings into CSV/JSON and replaces them on the fly.

Archived First Post

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



What is it?
Runtime localization system that auto-captures UI/messages/database strings into CSV/JSON and replaces them on the fly.
Includes hotkeys for export/reload, language switching, and optional language UI on Title/Options.

Engine: RPG Maker MZ
File: ToshA_Localization.js (see attachment below)



Preview video




Features
  • Auto-extract from Database (names/descriptions), System Terms, Event text (Show Text / Show Choices).
  • On-screen UI capture via drawText / Bitmap.drawText (menus, window headers, button labels, plugin UI, etc.).
  • Optional full map scan on boot (reads MapXXX.json in NW.js desktop/test).
  • 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.



Installation
[olist]
[*] Copy ToshA_Localization.js into js/plugins/ and enable it.
[*] (Recommended) CSV output to data/i18n — configurable in plugin params.
[*] Run your game in NW.js (desktop/test). The plugin collects strings into CSV/JSON on the fly.
[*] Edit translations and press F7 to reload; use F8 to switch language.
[/olist]



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 — Script calls
Code: 
// Set language
PluginManager.callCommand(this,"ToshA_Localization","setLanguage",{ code:"en" });

// Export CSV/JSON now
PluginManager.callCommand(this,"ToshA_Localization","exportNow",{});

// Reload from disk and reapply
PluginManager.callCommand(this,"ToshA_Localization","reload",{});

// Temporarily freeze capturing
PluginManager.callCommand(this,"ToshA_Localization","setFreezeCapture",{ value:true });

CSV / JSON format
Code: 
// CSV (default, ; delimiter) header example:
command;original;originalLang;en;ru;...

// JSON example:
{
  "meta": {...},
  "languages": ["en","ru"],
  "strings": {
    "Database.Items.1.name": { "source": "Potion", "en":"Potion", "ru":"Зелье" }
  }
}



Notes & Tips
  • 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) may pick dynamic/noisy strings — enable only if needed and use filters.



License & Credits
Please credit ToshaAngel.
Do not redistribute or re-sell the plugin file.

Download: see the attached ToshA_Localization.js below.



Note: It does not allow uploading the editor here (.exe or .rar/.zip).
You can download it on my page Itch.io: https://toshaangel.itch.io/tosha-localization

Features Mentioned

  • Auto-extract from Database (names/descriptions), System Terms, Event text (Show Text / Show Choices).
  • On-screen UI capture via drawText / Bitmap.drawText (menus, window headers, button labels, plugin UI, etc.).
  • Optional full map scan on boot (reads MapXXX.json in NW.js desktop/test).
  • 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.
  • Installation
  • [olist]
  • [*] Copy ToshA_Localization.js into js/plugins/ and enable it.
  • [*] (Recommended) CSV output to data/i18n — configurable in plugin params.
  • [*] Run your game in NW.js (desktop/test). The plugin collects strings into CSV/JSON on the fly.
  • [*] Edit translations and press F7 to reload; use F8 to switch language.
  • [/olist]
  • Plugin Commands
  • setLanguage — set current language (code=en).
  • exportNow — write CSV/JSON immediately.

Downloads / Referenced Files

Log in to download

Log in, then follow the RPG Maker Developers Group to see these download links.

Log in to download

License / Terms Note

License & Credits Please credit ToshaAngel. Do not redistribute or re-sell the plugin file. Download: see the attached ToshA_Localization.js below.

Creator Claims / Removal

If you are the original creator and want this listing reassigned, edited, or removed, join BMMPlay and contact the moderators with proof that matches the original RPG Maker Web profile, linked GitHub, itch.io page, or another public creator identity.

BMM Play Community Your voice deserves more than a scroll. Start Writing

Replies (0)

No replies yet.

0 replies 11 views

Log in to reply.

User Avatar