Skip to content
Back to search

gamelingo

MarketplaceWorks with Claude CodeGitHub

Claude Code skills that localize PC games into any language: scan Steam/Epic games, extract text, translate with a glossary, fix Arabic/RTL rendering, ship reversible patches.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lechehebdjaafar--gamelingo/badge.svg)](/listings/lechehebdjaafar--gamelingo)

HTML

<a href="/listings/lechehebdjaafar--gamelingo"><img src="/api/listings/lechehebdjaafar--gamelingo/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Option A — Claude Code plugin marketplace

/plugin marketplace add LechehebDjaafar/gamelingo
/plugin install gamelingo@gamelingo

Option B — install script

git clone https://github.com/LechehebDjaafar/gamelingo
cd gamelingo
./install.sh            # macOS / Linux
# .\install.ps1         # Windows PowerShell

Option C — manual

Copy every folder inside `skills/` to `~/.claude/skills/` (Windows: `%USERPROFILE%\.claude\skills\`).

Requirements

- [Claude Code](https://claude.com/claude-code) - Python 3.10+ - For Arabic / RTL: `python -m pip install -r requirements-rtl.txt` - Optional engine tools per game (UABEA, repak, GDRE Tools, unrpa, UndertaleModTool…) — see [engine recipes](skills/gamelingo/references/engines/).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 11 lines
  1. {
  2. "name": "gamelingo",
  3. "owner": { "name": "YOUR_NAME" },
  4. "plugins": [
  5. {
  6. "name": "gamelingo",
  7. "source": "./",
  8. "description": "Game localization pipeline for Claude Code: any game, any language, with first-class Arabic/RTL support."
  9. }
  10. ]
  11. }
README.md · README · 206 lines
  1. <div align="center">
  2. <img src="assets/banner.svg" alt="GameLingo - localize any game into any language" width="100%"/>
  3. # GameLingo
  4. **Localize any PC game into any language — with Claude Code skills.**
  5. Scan a game, extract its text, translate it with context, fix right-to-left rendering and fonts, and ship a reversible patch.
  6. [![CI](https://github.com/LechehebDjaafar/gamelingo/actions/workflows/ci.yml/badge.svg)](https://github.com/LechehebDjaafar/gamelingo/actions)
  7. [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  8. [![Claude Code Skills](https://img.shields.io/badge/Claude%20Code-skills-8A63D2)](#install)
  9. [![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-3776AB)](#requirements)
  10. [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
  11. [Install](#install) · [Quick start](#quick-start) · [How it works](#how-it-works) · [Engine support](#engine-support) · [Arabic & RTL](#arabic--rtl-first-class) · [Safety](#safety--legal) · [Contribute](#contributing) · [العربية](README.ar.md)
  12. </div>
  13. ---
  14. ## Why GameLingo?
  15. Millions of players can't enjoy great games because their language isn't supported. Fan translation is a craft that normally needs a reverse-engineer, a translator, a font hacker and a tester. **GameLingo turns that into one conversation with Claude Code.**
  16. > *"Translate the game in `D:\SteamLibrary\steamapps\common\MyGame` into Arabic."*
  17. Claude finds the engine, extracts the strings, translates them with a consistent glossary, makes Arabic render correctly, runs QA, backs up your files and installs the patch. If anything goes wrong: one command restores the original.
  18. ## Features
  19. - 🎮 **Steam, Epic Games, GOG & custom folders** — auto-discovers installed games.
  20. - 🔍 **Engine detection** — Unity (Mono/IL2CPP), Unreal, Godot, RPG Maker, Ren'Py, GameMaker, Electron/NW.js.
  21. - 🌍 **Any target language** — Arabic, Persian, Turkish, Spanish, Japanese, Chinese… whatever the user asks for.
  22. - 🧠 **Context-aware translation** — glossary, tone, character voice, UI length limits.
  23. - 🛡️ **Placeholder safety** — `{0}`, `%s`, `<b>`, `\C[2]`, `\N[1]` are protected and verified.
  24. - ↔️ **Real RTL support** — letter shaping, bidi ordering, font plans (Arabic, Persian, Urdu, Hebrew).
  25. - ✅ **Automated QA** — placeholders, glossary, wrong-script output, overflow risk + in-game checklist.
  26. - ♻️ **Non-destructive** — overlay patches, SHA-256 verified backups, one-command restore.
  27. - 🧪 **Tested tooling** — stdlib-only Python helpers with unit tests on Windows, macOS and Linux.
  28. ## Install
  29. ### Option A — Claude Code plugin marketplace
  30. ```text
  31. /plugin marketplace add LechehebDjaafar/gamelingo
  32. /plugin install gamelingo@gamelingo
  33. ```
  34. ### Option B — install script
  35. ```bash
  36. git clone https://github.com/LechehebDjaafar/gamelingo
  37. cd gamelingo
  38. ./install.sh # macOS / Linux
  39. # .\install.ps1 # Windows PowerShell
  40. ```
  41. ### Option C — manual
  42. Copy every folder inside `skills/` to `~/.claude/skills/` (Windows: `%USERPROFILE%\.claude\skills\`).
  43. ### Requirements
  44. - [Claude Code](https://claude.com/claude-code)
  45. - Python 3.10+
  46. - For Arabic / RTL: `python -m pip install -r requirements-rtl.txt`
  47. - Optional engine tools per game (UABEA, repak, GDRE Tools, unrpa, UndertaleModTool…) — see [engine recipes](skills/gamelingo/references/engines/).
  48. ## Quick start
  49. Open Claude Code and just describe what you want:
  50. ```text
  51. > Translate "Moonlight Courier" into Arabic
  52. > Add Turkish to my Steam game in D:\Games\SomeGame
  53. > What engine does this game use and can it be localized? C:\Program Files\Epic Games\X
  54. > The Arabic text in my patched game shows disconnected letters — fix it
  55. > Undo the translation patch
  56. ```
  57. Or call the skills directly:
  58. | Command | What it does |
  59. |---|---|
  60. | `/gamelingo` | Runs the whole pipeline |
  61. | `/gamelingo-scan` | Find the game, detect the engine, map text files |
  62. | `/gamelingo-extract` | Extract text into `strings.jsonl` |
  63. | `/gamelingo-translate` | Translate with glossary and placeholder protection |
  64. | `/gamelingo-rtl` | Shaping, bidi and fonts for RTL / complex scripts |
  65. | `/gamelingo-qa` | Automated checks + in-game checklist |
  66. | `/gamelingo-pack` | Build overlay, back up, install |
  67. | `/gamelingo-restore` | Return the game to its original state |
  68. ### Try the demo (no game required)
  69. ```bash
  70. S=skills/gamelingo/scripts
  71. python $S/detect_engine.py examples/demo-game
  72. python $S/strings_io.py extract examples/demo-game/data -o /tmp/strings.jsonl \
  73. --keys name,profile,gameTitle,parameters --min-len 3
  74. python $S/strings_io.py stats /tmp/strings.jsonl
  75. ```
  76. ## How it works
  77. ```mermaid
  78. flowchart LR
  79. A[Find game<br/>Steam · Epic · folder] --> B[Detect engine]
  80. B --> C[Extract text<br/>strings.jsonl]
  81. C --> D[Translate<br/>glossary + context]
  82. D --> E[QA<br/>placeholders · glossary]
  83. E --> F{RTL?}
  84. F -- yes --> G[Shape · bidi · fonts]
  85. F -- no --> H
  86. G --> H[Overlay patch]
  87. H --> I[Backup + install]
  88. I --> J[(Restore anytime)]
  89. ```
  90. Claude handles judgment (engine reasoning, translation, glossary, tone). Small, unit-tested scripts handle plumbing (parsing, writing back, hashing, backups). Details: [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
  91. ## Engine support
  92. Status is deliberately conservative. **Stable** = round-trip covered by automated tests. **Beta** = documented recipe that works with a third-party tool. **Experimental** = needs per-game investigation.
  93. | Engine / format | Status | Text access | Notes |
  94. |---|---|---|---|
  95. | JSON / CSV / PO / `.properties` files | ✅ Stable | built-in `strings_io.py` | Works for any engine that ships plain text tables |
  96. | RPG Maker MV / MZ | 🟢 Beta | JSON in `data/` | No repack needed |
  97. | Electron / NW.js | 🟢 Beta | JSON / locale files, `app.asar` | Chromium shapes Arabic natively |
  98. | Godot | 🟢 Beta | CSV / PO, `.pck` via GDRE Tools | Godot 4 has RTL text server |
  99. | Ren'Py | 🟢 Beta | `game/tl/<lang>/` translate blocks | Built-in translation system |
  100. | Unity (Mono / IL2CPP) | 🟡 Experimental | loose files, localization tables, runtime plugin | Text often inside assets |
  101. | Unreal Engine | 🟡 Experimental | `.locres` + patch `_P.pak` | Needs pak/locres tools |
  102. | GameMaker | 🟡 Experimental | `data.win` via UndertaleModTool | Single-file, back up carefully |
  103. Not supported: games with encrypted/anti-cheat-protected files, text baked into images or audio, online-only titles.
  104. Missing your engine? See [docs/ADDING-ENGINE-SUPPORT.md](docs/ADDING-ENGINE-SUPPORT.md).
  105. ## Arabic & RTL: first-class
  106. Correct translations can still look broken in-game: disconnected letters, reversed words, boxes. GameLingo treats this as three separate problems — **shaping, bidi ordering, glyph coverage** — and picks one of three modes per engine:
  107. | Mode | Engine behavior | Action |
  108. |---|---|---|
  109. | `none` | does shaping + bidi | just provide an Arabic font |
  110. | `shape` | bidi only | pre-shape letters |
  111. | `visual` | neither | pre-shape + reorder |
  112. ```bash
  113. python skills/gamelingo/scripts/rtl.py text "مرحبا بالعالم" --mode visual
  114. ```
  115. Read the [Arabic & RTL guide](skills/gamelingo/references/rtl-arabic.md). The same machinery covers Persian, Urdu and Hebrew, plus font plans for CJK and other scripts.
  116. ## Safety & legal
  117. - **Your own copy only**, preferably offline/single-player games.
  118. - **Never in place** — overlay + verified backup + restore.
  119. - **No DRM or anti-cheat bypass.** Games with EasyAntiCheat/BattlEye/Vanguard are flagged; modifying them can get accounts banned.
  120. - **Share only your translation overlay**, never game files or extracted assets. Check each publisher's policy on fan translations.
  121. Full notes: [legal-and-safety.md](skills/gamelingo/references/legal-and-safety.md). Not legal advice.
  122. ## Repository layout
  123. ```text
  124. gamelingo/
  125. ├── .claude-plugin/ plugin + marketplace manifests
  126. ├── skills/
  127. │ ├── gamelingo/ orchestrator + scripts/ + references/
  128. │ ├── gamelingo-scan/ find game, detect engine
  129. │ ├── gamelingo-extract/ text → strings.jsonl
  130. │ ├── gamelingo-translate/ context-aware translation
  131. │ ├── gamelingo-rtl/ shaping, bidi, fonts
  132. │ ├── gamelingo-qa/ validation + in-game checklist
  133. │ ├── gamelingo-pack/ overlay, backup, install
  134. │ └── gamelingo-restore/ undo
  135. ├── examples/ synthetic demo game, glossary example
  136. ├── tests/ unit tests for every script
  137. ├── tools/ skill validator, release builder
  138. ├── docs/ architecture, FAQ, roadmap, engine guide
  139. └── .github/ CI, issue and PR templates
  140. ```
  141. ## Roadmap
  142. Ren'Py `.rpy` handler · XLIFF/`.resx`/`.locres` readers · XUnity.AutoTranslator exporter · shared translation memory · font-coverage checker · screenshot QA · community recipe catalog. See [docs/ROADMAP.md](docs/ROADMAP.md).
  143. ## Contributing
  144. Engine recipes, format handlers, RTL knowledge and glossaries are all welcome. Start with [CONTRIBUTING.md](CONTRIBUTING.md) and the [engine guide](docs/ADDING-ENGINE-SUPPORT.md). Good first issues: add a format handler, verify an engine recipe on a real game, improve a glossary.
  145. ```bash
  146. make validate test
  147. ```
  148. ## FAQ
  149. See [docs/FAQ.md](docs/FAQ.md).
  150. ## License
  151. [MIT](LICENSE). GameLingo is unofficial and not affiliated with any game publisher, engine vendor, Steam/Valve or Epic Games. Names are trademarks of their owners.
  152. <div align="center">
  153. If GameLingo helped you play a game in your language, **give it a ⭐** and share your recipe.
  154. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.