К основному содержанию
скилл CX Codex

arabic-game-localization — скилл для Claude Code

Скилл arabic-game-localization для Claude Code переводит видеоигры на арабский язык, исправляет отображение текста и создаёт патчи для установки. Он автоматизирует процесс локализации и проверку файлов.

MIT ★ 75 обновлён 2026-11-11

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add axxx503/Arabic-localization-game --skill arabic-game-localization -a claude-code
Открыть на GitHub

Что делает arabic-game-localization

Скилл сканирует файлы игры для определения движка, делает резервные копии с проверкой SHA-256 и формирует рабочую среду через Python. Он интегрирует арабские шрифты в движки вроде Unity, Unreal или Godot, исправляя соединение букв и направление письма RTL. Для работы используются библиотеки arabic_reshaper и bidi.algorithm.

Программа защищает плейсхолдеры и теги в строках, создавая отменяемые пакеты для установки локализации. Для работы требуется доступ к файловой системе игры и установленный интерпретатор Python.

Какие задачи решает

  • перевод игровых интерфейсов на арабский язык
  • исправление ошибок отображения RTL-текста
  • интеграция арабских шрифтов в движки
  • создание патчей для установки локализации

Примеры запросов агенту

  • Локализуй игру в этой папке на арабский с помощью arabic-game-localization
  • Исправь отображение арабских символов в игре через arabic-game-localization

Как установить arabic-game-localization

1Через Skills CLI (Vercel)

npx skills add axxx503/Arabic-localization-game --skill arabic-game-localization -a claude-code

2Вручную: положить файлы

~/.claude/skills/arabic-game-localization/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/arabic-game-localization/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об arabic-game-localization

Как установить arabic-game-localization в Claude Code?

Используйте команду npx skills add axxx503/Arabic-localization-game --skill arabic-game-localization -a claude-code. Затем обратитесь к файлу ~/.claude/skills/arabic-game-localization/SKILL.md.

Что делает arabic-game-localization?

Он автоматизирует полный цикл локализации игры на арабский, от анализа движка и подготовки шрифтов до создания инсталляторов.

Что нужно для работы arabic-game-localization?

Необходим установленный Python для создания виртуального окружения и доступ к файлам игры.

Исходный текст

SKILL.md · MIT
---
name: arabic-game-localization
description: Autonomous end-to-end Arabic game localization skill for Google Antigravity IDE. Discovers game engines (Unity, Unreal, Godot, GameMaker, Ren'Py, custom), backs up originals with SHA-256 verification, merges OFL Arabic fonts with full isolated/connected Presentation Forms-B coverage, shapes RTL/BiDi Arabic while protecting {placeholders} and <tags>, translates full inventories in context, localizes in-game graphical posters, and builds reversible lightweight install/uninstall packages.
---

# Arabic Game Localization Skill (`arabic-game-localization`)

> **⚠️ تنبيه الاستخدام وحقوق الملكية (Usage & Licensing Notice)**:
> - **يُمنع الاستخدام التجاري** لهذا الإطار أو المهارة أو البرومبت دون التواصل المسبق مع صاحب المشروع (`V7dt1` / `axxx503`) عبر حسابات التواصل الاجتماعي (https://bio.site/V7dt1) أو الإيميل (`[email protected]`) وإعلامه بالموضوع للاتفاق على **تقاسم الأرباح**.
> - **عند النشر العام (غير التجاري)**: يكفي ويُشترط **ذكر اسم صاحب المشروع (`V7dt1` / `axxx503`) في حقوق التعريب** (وفي ملف `README_AR.txt` داخل الحزمة) كمساعد في البرومبت ومساعد في الاستخدام العام.

Use this skill whenever the user asks to localize/translate a video game into Arabic (`تعريب لعبة`), fix disconnected/reversed Arabic letters in a game, merge Arabic glyphs into game fonts, or build an Arabic localization patch.

## Mandatory 7-Phase Workflow

### Phase 1: Automatic Discovery & Safe Workspace
1. Verify access to the target game directory. Never claim inspection if the path is inaccessible.
2. Detect the engine, exact version, architecture (`x86` / `x86_64`), runtime (`Mono` / `IL2CPP` / `Pak` / `IoStore` / `PCK`), active localization system, and font assets from binary/file evidence.
3. Create an isolated workspace in `<scratch>/<game_name>_arabic` with a local Python virtual environment (`.venv`).
4. Record `SHA-256` hashes of all target original files in `backups/original_hashes.json` and copy clean originals to `backups/originals/` before any modification. Never touch user save directories.

### Phase 2: Engine-Specific Routing (Least Invasive Path)
- **Unity**: Inspect `StreamingAssets/aa` (`Addressables`), `resources.assets`, `sharedassets*.assets`, `Unity.Localization` `StringTable` MonoBehaviours, and `TMP_FontAsset` / `Font` objects.
  - Check `catalog.bin` for `m_Crc` values before modifying Addressables bundles.
  - If `resources.assets` strips custom MonoBehaviour TypeTrees (`obj.read_typetree()` fails), extract `obj.serialized_type.nodes` from a `TMP_FontAsset` inside an Addressables bundle and pass those nodes to `read_typetree(nodes)` / `save_typetree(tree, nodes)`.

### Phase 3: Intelligent Font Engineering
1. Select an OFL-licensed Arabic font matching the game's visual style (e.g., `Tajawal` under SIL OFL 1.1) unless the user attached a distributable font.
2. **Critical Isolated Presentation Forms-B Fix**:
   - Many Arabic fonts map isolated glyphs only to `U+0621..U+064A` and omit the 36 isolated codepoints in `U+FE80..U+FEF1` emitted by `arabic_reshaper`.
   - Always map all `LETTERS_ARABIC` `(isolated, initial, medial, final)` codepoints in `cmap`, falling back to `U+0621..U+064A` whenever `isolated` (`U+FE80..U+FEF1`) is absent from `cmap`.
3. Scale merged Arabic glyphs proportionally (`scale = 1.15 * (base_upm / arabic_upm)`) and verify `0` missing glyphs using `freetype-py` (`face.get_char_index(cp) != 0`) across all contextual forms, hamzas (`أ إ آ ؤ ئ ء`), and lam-alef ligatures (`لا لأ لإ لآ`).
4. Enable `m_IsMultiAtlasTexturesEnabled = 1` on static `TMP_FontAsset` objects or link dynamic fallback font assets.

### Phase 4: Early In-Game Rendering Proof
1. Before translating the full inventory, inject a representative 30–60 string Arabic test build covering connected letters, mixed Arabic + Latin + numbers, multi-line wrapping, `{placeholders}`, and UI buttons.
2. Keep logical Arabic (`logical_ar`) strictly separate from shaped/visual display Arabic (`display_ar`).
3. **Token-Safe Shaping & Line Wrapping**:
   - When the game engine renders LTR (`m_isRightToLeft = 0`) without native HarfBuzz shaping:
     1. Wrap long paragraphs into lines at natural word boundaries first (protecting `{...}` and `<...>` tokens so they are never split).
     2. Shape inner choices of `SmartFormat` plural expressions `{var:plural:choice1|choice2}` individually.
     3. Replace each `{...}` placeholder and `<...>` tag with a temporary strong-RTL sentinel character (`chr(0x05D0 + idx)`) before calling `arabic_reshaper.reshape()` and `bidi.algorithm.get_display(..., base_dir="R")`, then restore the original token.
4. Launch the game or inspect `Player.log` to confirm `0` missing-character warnings and `0` bundle load errors.

### Phase 5: Complete Contextual Localization
1. Extract the full string inventory (`extracted/master_inventory.json`) with stable IDs, table names, contexts, and placeholder lists.
2. Establish a unified glossary (`reports/glossary.json`) before translating batches.
3. Translate 100% of strings into natural, context-aware Modern Standard Arabic (`logical_ar`), preserving speaker voice, humor, and 100% of `{...}` / `<...>` placeholders.
4. Localize editable graphical text/posters using `Pillow` and visually inspect the result with `read_file` before injecting into `Texture2D` objects.

### Phase 6 & 7: Verification & Lightweight Reversible Package
1. Validate 100% translation coverage, 0 placeholder mismatches, 0 missing FreeType glyphs, and clean `UnityPy` re-opening of all modified bundles.
2. Build a beginner-friendly `package/` containing:
   - `Install-Arabic.bat` & `Install-Arabic.ps1`
   - `Uninstall-Arabic.bat` & `Uninstall-Arabic.ps1`
   - `README_AR.txt` & font license (`OFL.txt`)
   - Object-level patch payload (`payload/font_objects_patch.json.gz` + localized string/asset bundles) rather than redistributing multi-hundred-MB proprietary game archives.
3. Test clean install, re-install/update, and full uninstall (verifying restored `SHA-256` hashes match `original_hashes.json` 100%) before declaring completion.

© axxx503 · MIT · axxx503/Arabic-localization-game

Похожие скиллы

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
game-development miles990 Скилл game-development для Claude Code и пяти других платформ: паттерны игрового цикла, ECS, коллизий и поведения врагов под Unity, Godot и Flutter. CX Codex +1 417установок game-engine-resources gmh5225 Скилл game-engine-resources помогает агенту опознать игровой движок и его версию, прежде чем строить карту объектов и выбирать инструменты. CX Codex +1 1установок game-reverse-document AlterLab-IEU Скилл game-reverse-document для Claude Code читает код существующей игры и создаёт документацию: обратный GDD, архитектурный обзор, концепт-документ или бриф для команды. CX Codex +1 ★ 57звёзд репо AI Game Developer: MCP for Unity, Unreal and Godot IvanMurzak AI Game Developer: MCP for Unity, Unreal and Godot — MCP-сервер для Claude Code и Codex, связывающий агента с редактором Unity и запущенной игрой. Считывает сцены, меняет ассеты и запускает тесты через MCP. CX Codex +1 ★ 4 680звёзд репо level-design gamedev-skills Скилл level-design для Claude Code помогает проектировать игровые уровни, проверяя их проходимость и темп. CX Codex +1 14 800установок performance-optimization gamedev-skills Скилл performance-optimization для Claude Code находит причины низкой частоты кадров и рывков в Godot, Unity, Unreal и Roblox. Подключается для профилирования игры и выбора самой затратной проблемы. CX Codex +1 14 200установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой