Translate RPG Maker MV/MZ/VX Ace/2000/2003, Ren'Py, TyranoScript, SRPG Studio, Kirikiri, Wolf RPG, and Crowd engine games using local or cloud LLMs.
Local LLM (Ollama + Sugoi or Qwen 3.5 — free, private, no content filters) or Cloud API (OpenAI, Gemini, DeepSeek, Anthropic, OpenRouter — experimental, pay-per-token or free models).
Event-aware translation. Pronoun-aware. Glossary-driven. Batch translation with resume.
Per-engine settings, prompts, and model selection via the Engines tab.
Designed by a human, coded with Claude Code.
Cloud API engine ported from DazedMTLTool (MIT).
Built solo with local LLMs and Claude Code. If this saved you hours of work, consider supporting development:
More screenshots
Open a game folder. Hit Batch Translate. Get a playable translation. Supports 11 engines — auto-detected on open.
| 1 | |
| Local LLM (free) | Ollama on your GPU — Sugoi 14B for English, Qwen 3.5:9b for every language. Auto-tuned for your hardware, no API keys, no content filters, no account bans. Your data never leaves your PC |
| Cloud API (experimental) | OpenAI, Gemini, DeepSeek, Anthropic, OpenRouter — DazedMTL-compatible batch mode with live cost tracking |
| Per-engine settings | Each engine has its own context, batch size, workers, word wrap, model, and system prompt — configurable in the Engines tab |
| Pronoun system | Actor genders, speaker detection, \N[n] character mapping — the LLM knows who's "he" and who's "she" |
| Glossary-driven | Two-layer glossary auto-built from translated DB names — "Potion" stays "Potion" everywhere |
| Open in RPG Maker | One-click workspace with directory junctions — edit and playtest translations in RPG Maker's visual editor |
| Crash-proof | Auto-saves every 25 entries, project resume, translation memory deduplication |
- Key Features
- Download / Releases
- Quick Start
- Building from Source
- Recommended Models
- Cloud API Providers
- Translation Workflow
- Glossary System
- Open in RPG Maker
- Settings Reference
- Supported Formats & Languages
- Troubleshooting
- Acknowledgments
- License
- More from MoriTranslates
- Pronoun-aware gender system — Assigns actor genders, detects speakers from dialogue headers, maps
\N[n]codes to characters so the LLM uses correct pronouns. - Two-stage workflow — Translate database names first (items, skills, enemies), then dialogue. DB names auto-populate the glossary.
- Two-layer glossary — General glossary (shared, ~100 presets) + project glossary (auto-built from DB translations). Smart injection — only matching terms sent per request.
- Batch by Actor — Groups dialogue by speaker gender (female > male > unknown) for maximum pronoun accuracy.
- Translation memory — Deduplicates identical strings before batch. If 50 NPCs say the same line, the LLM translates it once.
- Event-grouped translation — Each worker translates one whole event at a time, in order, so the LLM's history actually corresponds to prior lines in the same scene. Pronouns, tone, and callbacks stay consistent within a scene; history resets at event boundaries so unrelated scenes don't bleed into each other. More workers = more events translated in parallel, no context lost.
- Translation history — Last 10 translations within the current event sent as user/assistant pairs so the LLM maintains consistent voice across the scene.
- Auto-retry — Detects leftover Japanese in output and retries with a stronger prompt.
- Server-down detection — If the LLM server hangs or crashes (5+ connection errors in 30s), translation pauses and prompts you to restart it. Resume picks up where it left off — no lost progress.
- Auto-save & checkpointing — Saves every 25 entries during batch. Crash-proof.
- Per-engine configuration — Each engine gets its own context window, batch size, workers, word wrap, model override, and system prompt via the Engines tab in Settings. A "Default (All Engines)" row lets non-tinkers set everything at once.
- DazedMTL Mode — One-click toggle: batch 30, 4 workers, DazedMTL prompt. Works with both local Sugoi and cloud APIs.
- Open in RPG Maker — Creates a workspace with directory junctions so you can QA and playtest translations in RPG Maker's visual editor. Auto-detects MV vs MZ.
- Cloud cost tracking — Real-time token count and USD cost during batch translation.
- Translation variants — Generate 3 different translations per entry and pick the best one.
- Word wrap plugin — Auto-injected JS plugin wraps dialogue at render time using pixel measurements. Also hooks Window_Help for skill/item descriptions. No manual line break guessing.
- Post-processor — Automated fixes after batch translate: placeholder leaks, collapsed color codes, missing spaces, spurious newlines, skill message spacing, and more.
- Grammar polish — English-to-English LLM pass to fix awkward phrasing without retranslating from Japanese.
- Prompt presets — Default, Sugoi (DazedMTL Full), DazedMTL Simple, or Custom. Reset Default and Clear buttons.
Upgrading from a pre-1.0 version? Version 1.0 fixes ~200 bugs, including several that could lose saved progress or damage game files — see CHANGELOG.md for the full list. Your saved projects carry over. The old code is kept on the
legacy/v2branch (tagv2-pre-overhaul) but is no longer maintained.
Windows (no Python needed): grab RPGMakerTranslator-<version>-win64.zip from the
Releases page,
extract it anywhere (not inside Program Files), and run RPGMakerTranslator.exe.
Your settings are saved next to the exe, so the folder is portable.
- The exe is not code-signed yet, so Windows SmartScreen may say "Windows protected your PC" — click More info → Run anyway.
- Each release lists a SHA256 checksum; verify with
Get-FileHash RPGMakerTranslator-*.zipin PowerShell. - To update, extract the new zip and copy your old
_settings.jsoninto the new folder. - You still need Ollama (or a cloud API key) — see Quick Start step 1.
- What changed in each version: CHANGELOG.md.
Prefer running from source (any OS, latest code)? Follow the Quick Start below.
Linux / macOS: not officially supported, but the app runs from source. Install Ollama for your system, start it yourself (
ollama serve) and pull your model before launchingpython main.py— the app can't start or restart Ollama for you there. Open in RPG Maker and the EasyRPG Player download are Windows-only.
# Install Ollama: https://ollama.com/download
# Then grab a model (see Recommended Models for your GPU and target language):
ollama pull qwen3.5:9bpip install -r requirements.txt
python main.py- Project > Open Project — point to your game folder (any supported engine auto-detected)
- Assign actor genders in the popup dialog (RPG Maker engines)
- Batch DB (
Ctrl+D) — translate names/items/skills first - Batch Dialogue (
Ctrl+T) — translate dialogue with auto-glossary - Game > Apply Translation (
Ctrl+E) — write back to game files - Game > Open in RPG Maker (
Ctrl+R) — QA in the visual editor (MV/MZ only)
Requires Python 3.12+ (3.14 recommended — it's what releases are built with).
git clone https://github.com/MoriTranslates/rpgmaker-translator.git
cd rpgmaker-translator
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements-dev.txt # app + pytest, ruff, pyinstaller
python -m pytest -q # run the test suite
python main.py # run the app
# Optional, for opening packed Wolf RPG games (Data.wolf) from source:
# downloads the pinned UberWolfCli.exe into third_party\UberWolf\ (SHA-256 checked)
powershell -ExecutionPolicy Bypass -File packaging\fetch_uberwolf.ps1
# Build the Windows bundle (dist\RPGMakerTranslator\ + a zip; fetches UberWolf too):
powershell -ExecutionPolicy Bypass -File packaging\build_windows.ps1See CONTRIBUTING.md for the development and release workflow.
Picked with a 100-line benchmark of real adult-RPG dialogue, graded line by line for meaning errors. Sugoi is a Japanese→English specialist with the most natural English; it only translates into English. Qwen 3.5 handles every target language.
| GPU VRAM | Translating into English | Translating into any other language |
|---|---|---|
| 8GB | Qwen 3.5:9b — ollama pull qwen3.5:9b |
Qwen 3.5:9b |
| 12GB | Sugoi 14B i1-IQ4_XS — ollama pull hf.co/mradermacher/Sugoi-14B-Ultra-HF-i1-GGUF:i1-IQ4_XS |
Qwen 3.5:9b |
| 16GB+ | Sugoi 14B Q4_K_M — ollama pull hf.co/sugoitoolkit/Sugoi-14B-Ultra-GGUF:Q4_K_M |
Qwen 3.5:9b Q8 — ollama pull qwen3.5:9b-q8_0 |
On a 10GB card, Sugoi 14B i1-IQ3_M (hf.co/mradermacher/Sugoi-14B-Ultra-HF-i1-GGUF:i1-IQ3_M) is nearly as good
as the 12GB pick. The smaller Qwen 3.5 4B and 2B models are not recommended for dialogue: they flip meanings
and swap answers between lines. Settings > Suggest Model shows these picks for your GPU and target language.
The window highlights the pick for your GPU, marks models you already have installed with a check mark,
and lets you type any Ollama tag (for example a hf.co/... GGUF) and pull it. Tags are checked before
anything runs: only letters, digits and . _ : / - are allowed, and a tag cannot start with -.
The list lives in models.json. The app ships a copy and, when the window opens, tries to
refresh it from this repository on GitHub (5 second limit, in the background). If the download fails or the
file does not validate, the built-in list is used and nothing is shown. It has four parts:
recommended: the best models.tier_pickssays which one is highlighted for 8, 12 and 16+ GB of VRAM for any target language (each pick must be listed underrecommendedand work for every language).tier_picks_by_languageoverrides it for one target language, such as English.specialist: Japanese to English fine-tunes such as Sugoi. A new specialist goes here.experimental: models that are not recommended or not yet tested for translation. Newer models start here.- Each entry has
label,tag,vram_gb(download size plus about 1.5 GB),notes, and optionallylanguages(the target languages it is good for; leave it out for all). Check that a tag exists (https://registry.ollama.ai/v2/library/<name>/manifests/<tag>) before adding it.
In Settings, switch Provider to OpenAI/Gemini/DeepSeek/Anthropic/OpenRouter, enter your API key, and go. Same workflow, same features, pay per token. Cheapest options: gpt-6-luna or Claude Haiku 5.5 at $0.10/$0.50 per 1M tokens (prices checked November 2026).
Note: Cloud APIs may refuse or filter adult content and can ban accounts for repeated NSFW requests. For unrestricted translation of all content types, use Local LLM — everything runs on your GPU, nothing is sent to the cloud.
Experimental: Cloud API support is functional but less battle-tested than local Ollama. Expect occasional edge cases. Cloud APIs may also refuse or filter adult content — see Local LLM note above.
| Provider | Models | Pricing (per 1M tokens) |
|---|---|---|
| Google Gemini | gemini-3.5-flash-lite, gemini-3.8-flash | $0.30–$1.50 in / $2.50–$7.50 out |
| OpenAI | gpt-6-luna, gpt-5.6-luna, gpt-6-sol | $0.10–$2.00 in / $0.50–$10.00 out |
| DeepSeek | deepseek-flash, deepseek-v4-pro | $0.30–$1.32 in / $1.20–$3.96 out (peak hours; off-peak is half) |
| Anthropic | claude-haiku-5-5, claude-sonnet-5-5, claude-opus-5-5 | $0.10–$4.00 in / $0.50–$20.00 out |
| OpenRouter | deepseek/deepseek-chat, plus free :free models (e.g. nvidia/nemotron-3-ultra-550b-a55b:free) |
varies by model |
All providers use the OpenAI SDK as a universal abstraction. Switch in Settings > Provider, enter your API key, and the rest is automatic — batch size, workers, and prompt presets auto-configure. With a key entered, the model list is read from the provider itself; the models above are the built-in suggestions used when that fails. Prices were checked in November 2026 and change often; a model with no price on file shows its cost as "unknown".
OpenRouter gives one API key for hundreds of models from many makers. Pick "OpenRouter" as the provider (its address is built in, so your Ollama address is never touched), paste your key, and choose or type a model name exactly as OpenRouter lists it (for example deepseek/deepseek-chat). Models ending in :free cost nothing but have daily request limits, and the free providers may log your prompts. Set your privacy options in your OpenRouter account settings before sending game text. The cost line shows "unknown" for OpenRouter models.
- Batch DB (
Ctrl+D) — Translates database entries: item names, skill names, enemy names, system terms. These become glossary entries. - Review DB names — Fix any mistranslations in the table. Corrections auto-update the glossary.
- Batch Dialogue (
Ctrl+T) — Translates dialogue, events, and plugin text using the glossary built in step 1.
This prevents inconsistencies like an NPC saying "Take the Holy Sword" when the inventory calls it "Sacred Blade".
- Batch All (
Ctrl+Shift+T) — DB + dialogue in one pass (skips manual review step) - Batch by Actor (
Ctrl+Shift+A) — Groups by speaker gender for best pronoun accuracy. Shows a breakdown before starting.
- Translate Selected — Translate specific rows
- Retranslate with Correction — Hint what was wrong ("use she/her", "too literal")
- Show Variants (3 options) — Pick from 3 different translations
- Mark Reviewed / Skip — Track QA progress
- Polish Grammar — English-to-English cleanup pass
The glossary forces the LLM to use specific translations for Japanese terms. Only terms that appear in the current text are injected — a 200-entry glossary doesn't bloat prompts.
Two layers:
- General Glossary (Settings) — Shared across all projects. ~100 presets for common RPG terms.
- Project Glossary (Settings) — Per-project. Auto-populated from translated DB names.
Project entries override general entries for the same JP term.
Glossary menu:
- Import/Export vocab files (DazedMTL-compatible format)
- Scan a translated game folder for JP→EN pairs
- Build glossary from this project's translations
- Apply glossary to fix inconsistent translations
Game > Open in RPG Maker (Ctrl+R) creates a workspace folder with directory junctions pointing to the game's data and assets. RPG Maker opens it as a project — you can playtest, inspect events, and verify translations in the visual editor.
- Auto-detects MV vs MZ engine
- Zero disk space (junctions, not copies)
- Edits in RPG Maker write directly to game files
- Works with RPG Maker MV ($6 on sale) or MZ
| Setting | Default | Description |
|---|---|---|
| Provider | Ollama (Local) | Translation engine — Ollama, OpenAI, Gemini, DeepSeek, Anthropic, Custom |
| Model | (auto-detected) | LLM model. Qwen 3.5:9b recommended for JP→EN |
| Prompt Preset | Default / Sugoi | Preset prompt or Custom. Reset Default / Clear buttons |
| DazedMTL Mode | Off | One-click: batch 30, 4 workers, DazedMTL prompt |
| Target Language | English | 24 languages with quality ratings |
| Context window | 10 | Recent dialogue lines as context (higher = better coherence) |
| Workers | 2 | Parallel events translated at once. More workers = more events in parallel. 2-3 for 12GB GPUs running 9-14B models, 4+ for cloud APIs |
| Batch size | 5 | Lines per request within an event. Batches never cross event boundaries — a 4-line event sends 4, a 25-line event with batch=10 sends 10/10/5 |
| Translation history | 10 | Recent translations sent as assistant messages |
| Dark mode | On | "Candlelit" dark theme (off = parchment light theme) |
Per-engine overrides for Context, Batch Size, Workers, Word Wrap, and Model. A Default (All Engines) row sets values for all engines at once — individual engines can override specific settings. Each engine also has its own system prompt that evolves independently.
| Engine | Files | Status |
|---|---|---|
| RPG Maker MV | .json | Supported |
| RPG Maker MZ | .json | Supported |
| RPG Maker VX Ace | .rvdata2 | Supported |
| RPG Maker 2000/2003 | .ldb, .lmu | Supported |
| Ren'Py | .rpy | Supported |
| TyranoScript | .ks | Supported |
| SRPG Studio | data.dts | Supported |
| Kirikiri | .ks (KAG) + .xp3 archives | Supported |
| Crowd | .sce | Experimental |
| Wolf RPG Editor | .wolf / .dat | Experimental (2.x and 3.x; 3.5 compressed and Pro-protected games not supported yet) |
| CSV Game | .x (CSV scripts) | Experimental |
All engines auto-detect when you open a game folder — no manual configuration needed.
RPG Maker MV/MZ — Separate engine handlers with independent system prompts. Full plugin extraction, speaker detection, namebox handling, face-aware word wrap, and patch zip export.
RPG Maker VX Ace — Parses Ruby Marshal binary files via
rubymarshal. Full database + event support (actors, items, skills, maps, common events, troops). Same two-stage DB → Dialogue workflow as MV/MZ. Window Scaler auto-injected on project open — VX Ace games run at tiny resolutions (544x416 or 640x480), so a Win32 API script is injected intoScripts.rvdata2that adds: PgUp/PgDn to scale the window (1x / 1.5x / 2x / 2.5x / 3x), F3 to cycle borderless fullscreen (ratio-kept → stretched → off). Pick your default scale in the dialog.
RPG Maker 2000/2003 — LCF binary parser for
.ldband.lmufiles. Word wrap at 50 chars/line. EasyRPG Player auto-downloaded on export for locale-free play on non-Japanese Windows.
Ren'Py — Parses
.rpyscript files for dialogue, narration, choices, and character definitions. Preserves{i},{b},{color=...}inline tags. Language-agnostic prompt (works for any source language, not just Japanese). Backup togame_original/, idempotent re-export.
TyranoScript — Auto-extraction from NW.js executables,
[r]/[p]/[emb]tag preservation via«CODE»placeholders, self-calibrating word wrap from original JP line lengths, VN-specific LLM prompt, and a dedicated post-processor for tag leak cleanup.
SRPG Studio — Decrypts and parses
data.dts(AES-128-CBC encrypted, zlib-compressed XML). Translates all text content and exports directly back to the encrypted format.
Kirikiri — Parses KAG3 script files in both
@name chara=/@eand[cn name=]/[en]dialogue formats. Built-in XP3 archive extraction — packed games are auto-extracted on open, no external tools needed. Auto-detected viastartup.tjsengine marker or[cn name=tags. Shares the visual novel LLM prompt with TyranoScript. Backup toscenario_original/, idempotent re-export.
Crowd (Experimental) — Reverse-engineered XOR cipher for
.sceencrypted script files (X-Change series, late 1990s–2000s). Auto-extracts the decryption key from the game exe — no manual configuration. Parses dialogue with 62+ speakers, narration, scene titles, and sound effects. Backup tosce_original/, idempotent re-export with re-encryption. Caveat: The Crowd engine's text renderer treats ASCII spaces as page breaks, so re-injecting English text into the original exe does not produce playable results without binary patching. Translation extraction and review works fine — consider using the translated script as a base for porting to Ren'Py or another modern engine.
24 languages supported. English is the primary target (use Sugoi for best quality). Other languages use Qwen3 with quality rated 2-5 stars in Settings.
Top tier: English, Chinese (Simplified/Traditional), Korean, Spanish, Portuguese, French, German Good: Russian, Italian, Polish, Dutch, Turkish, Indonesian, Vietnamese, Thai, Malay Fair: Arabic, Hindi, Ukrainian, Czech, Romanian, Hungarian, Tagalog
| Problem | Fix |
|---|---|
| "Cannot connect to Ollama" | Run ollama serve in a terminal first |
| Translations are slow | Use Qwen 3.5:9b with batch size 5-10 or enable DazedMTL Mode (batch 30, 4 workers). Add more workers to translate more events in parallel |
| Wrong pronouns | Assign correct genders in the actor dialog, or use Batch by Actor mode |
| Missing control codes | Right-click > Restore Missing Codes, or they auto-restore at checkpoints |
| Cloud API errors | Check your API key in Settings. Test Connection button verifies connectivity |
| Ollama crashes mid-batch (connection reset 10054) | OOM on KV cache. Drop workers to 1-2 for 14B models on a 12GB GPU. Server-down dialog will pause and let you Resume |
| Plugin translations break game | Plugin entries are skipped by default. Only unskip display text (menu labels, descriptions) |
| RM2K game won't launch | Japanese locale issue — use EasyRPG Player (auto-copied on export) or Locale Emulator |
- DazedMTLTool (MIT) — Cloud API engine, batch translation approach, prompt presets, and pricing config ported from DazedMTL. DazedMTL Mode mirrors their exact translation pipeline.
- Sugoi Toolkit — Fine-tuned JP→EN translation models optimized for visual novels and RPGs.
- Ollama — Local LLM inference server that makes GPU translation free and private.
- rubymarshal — Ruby Marshal binary format parser, used for RPG Maker VX Ace
.rvdata2files. - pycryptodome — AES decryption for SRPG Studio
data.dtsfiles. - EasyRPG Player — Open-source RPG Maker 2000/2003 runtime, used for locale-independent play of translated RM2K games.
- UberWolf by Sinflower (MIT) — Wolf RPG archive unpacker. The Windows release bundles its command-line tool (
UberWolfCli.exe, unchanged) to unpackData.wolf; its licence is in_internal/third_party/UberWolf/LICENSEand THIRD_PARTY_NOTICES.md. - WolfTL by Sinflower (MIT) — Wolf RPG translation tool; its format code is the reference for this app's WOLF RPG Editor 3.x support (see THIRD_PARTY_NOTICES.md).
PolyForm Noncommercial 1.0.0 — free for any non-commercial use: personal use, fan translation, hobby projects, education and research. Commercial use (selling translations, games or services made with it) is not permitted without a separate agreement with MoriTranslates. Code ported from DazedMTLTool stays under its MIT License; see THIRD_PARTY_NOTICES.md.
Releases up to and including v1.0.0 were published under the Business Source License 1.1.








