ToshA_Localization

じ☆ve冰风

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

https://www.youtube.com/embed/oTkKdMzbUMM

---

Features

• Auto-extract from Database (names/descriptions), System Terms, Event text (Show Text / Show Choices).
  
• On-screen UI capture via
  1. drawText / Bitmap.drawText

  复制代码
  (menus, window headers, button labels, plugin UI, etc.).
  
• Optional full map scan on boot (reads
  1. MapXXX.json

  复制代码
  in NW.js desktop/test).
  
• Stores to CSV (default,
  1. ;

  复制代码
  delimiter) or JSON; optional split by category (DB/Events/UI/Terms).
  
• Stable keys from source text and DB paths (e.g.
  1. Database.Items.1.name

  复制代码
  ).
  
• Runtime replacement for DB and
  1. $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

1. js/plugins/

复制代码

and enable it.

(Recommended) CSV output to

1. 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 (
  1. code=en

  复制代码
  ).
  
• exportNow — write CSV/JSON immediately.
  
• reload — reload translations from disk and reapply.
  
• setFreezeCapture — stop/start capturing new strings (
  1. value=true/false

  复制代码
  ).
  

Examples — Script calls
                Code:       

1. // Set language
2. PluginManager.callCommand(this,"ToshA_Localization","setLanguage",{ code:"en" });
4. // Export CSV/JSON now
5. PluginManager.callCommand(this,"ToshA_Localization","exportNow",{});
7. // Reload from disk and reapply
8. PluginManager.callCommand(this,"ToshA_Localization","reload",{});
10. // Temporarily freeze capturing
11. PluginManager.callCommand(this,"ToshA_Localization","setFreezeCapture",{ value:true });

复制代码

CSV / JSON format
                Code:       

1. // CSV (default, ; delimiter) header example:
2. command;original;originalLang;en;ru;...
4. // JSON example:
5. {
6.   "meta": {...},
7.   "languages": ["en","ru"],
8.   "strings": {
9.     "Database.Items.1.name": { "source": "Potion", "en":"Potion", "ru":"Зелье" }
10.   }
11. }

复制代码

---

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


本贴来自国际rpgmaker官方论坛作者:ToshaAngel处,因国际论坛即将永久关站,为了存档多年珍贵资料,署名转载到本论坛存档,由于官方帖子为英文原帖，需要中文翻译请点击论坛顶部切换语言为中文就可以将帖子翻译成中文浏览,方便大家随时查看,原文地址：https://forums.rpgmakerweb.com/threads/tosha_localization.179635/