Skip to content

Repository files navigation

OctopusBridge

OctopusBridge

License Ko-fi Release

Translate and mod PC games.
Supported: RPG Maker MV/MZ (including Electron builds), Ren'Py, Twine and TyranoScript.
Translation is batch-based: text is extracted from the game files, translated and written back before the game is launched.

Русская версия

⚠ Work in progress. OctopusBridge is under active development. Bugs, crashes and corrupted translations are possible, especially for the Twine engine. Always keep a backup of your game before translating, and report any issues you find.

Features

  • Batch translation — extract game text, translate, write it back, CSV import/export. Old translations are restored on re-extraction.
  • Fast translation — batches of up to 100 lines, several batches in parallel (~28,600 lines/min on Google's free endpoints).
  • No keys, no sign-up — free Google endpoints (a cascade of three, with built-in rate-limit protection) and Bing; for heavy workloads connect an AI provider (OpenAI-compatible API).
  • AI corrector — polish translations with glossary and context, review diffs before applying.
  • Cheats & tools — per engine: variables, gold, teleport, map editor, save editor, resource browser, font patch.
  • Glossary & translation memory — shared database across all projects (SQLite), game-code masking (\C[8], <center>, …).
  • Unified translation cache — all engines write one octopus_cache.json in the game folder; legacy caches are migrated automatically.
  • Nice UI — dark theme, Russian/English, system tray, drag-and-drop, About dialog with a changelog.

Engines

Engine Status
RPG Maker MV / MZ stable (incl. Electron builds with app.asar)
Ren'Py stable
TyranoScript / TyranoBuilder supported
Twine (SugarCube) experimental

Requirements

  • Windows 10/11 (64-bit).
  • ~500 MB of disk space.

Installation

  1. Download OctopusBridge.exe from the releases and run it.

The EXE is unsigned — Windows SmartScreen may show a warning («More info → Run anyway»).

Quick start

  1. Open a game — drag the game folder or Game.exe into the app window (or into the list on the "Projects" tab).
  2. Translate — "File translation" tab: extract the text, press "Translate", then "Apply" to write the translation back into the game.
  3. Cheats / maps / saves — appear in the engine tabs after opening a project: cheats and maps work with a running game, the save editor works with files directly.

Notes

  • Google/Bing are unofficial free endpoints: no keys, but they may limit volume. For big projects, connect an AI provider in the settings.
  • Injections modify the game process in memory — use the tool only on games you own or are allowed to modify.
  • Changelog — CHANGELOG.md.

License

GPL-3.0 — see LICENSE. Projects you create in the app remain yours.

About

Windows tool for translating and modding Twine / Ren'Py / RPG Maker / Tyrano games: AI-assisted translation (OpenAI-compatible APIs), glossary, translation memory, in-game cheat injection, save editor

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages