ivx-localization

Files (1)

• SKILL.md

SKILL.md (first lines)

# IntelliVerseX Localization

## Overview

The Localization skill covers the full i18n/l10n lifecycle for games — from in-game text to store listings to screenshot localization to ASO keyword translation. It integrates with Content-Factory's `screenshot_localizer` pipeline and the GDD localization plan.

```
Localization Plan (from GDD)
       │
       ▼
┌── Localization Workflows ────────────────────────────────┐
│                                                           │
│  In-Game Text → Store Listings → Screenshots → Keywords   │
│       │              │               │             │      │
│  CSV/JSON        LLM Translate   Localizer     ASO Tool   │
│  per locale      per store       pipeline      per market  │
│                                                           │
└──────────────────────────────────────────────────────────┘
       │
       ▼
  Localized Assets on S3 / in Build
```

---

## 1. In-Game Text Localization

### String Table Format

All user-facing strings live in CSV or JSON string tables, one per language:

```
localization/
├── en.csv           # English (base)
├── es-419.csv       # Latin American Spanish
├── pt-BR.csv        # Brazilian Portuguese
├── fr-FR.csv        # French
├── de-DE.csv        # German
├── ja-JP.csv        # Japanese
├── ko-KR.csv        # Korean
├── zh-Hans.csv      # Simplified Chinese
├── ar-SA.csv        # Arabic
└── hi-IN.csv        # Hindi
```

### CSV Format

```csv
key,text,context,max_chars
main_menu.play,"Play",Button label,10
main_menu.settings,"Settings",Button label,15
game.correct,"Correct!",Feedback on right answer,20
game.wrong,"Wrong!",Feedback on wrong answer,20
game.score,"Score: {0}",Score display with number placeholder,25
store.season_pass_title,"Season Pass",IAP display name,30
```

### Unity Integration

```csharp
using IntelliVerseX.Localization;

var text = IVXLocalization.Get("main_menu.play");
var formatted = IVXLocalization.GetFormatted("game.score", score);

IVXLocalization.OnLanguageChanged += lang =>
{
    RefreshAllUI();
};
```

### Scanning for Hardcoded Strings

```bash
python tools/localization/scan_hardcoded.py --src Assets/_QuizVerse/Scripts/ \
  --ignore "Debug.Log" --ignore "nameof" \
  --output reports/hardcoded_strings.csv
```

---

## 2. Store Listing Localization

### LLM-Powered Translation

```bash
python tools/localization/translate_store.py \
  --base-locale en \
  --target-locales es-419,pt-BR,fr-FR,de-DE,ja-JP,ko-KR,zh-Hans \
  --input design/store-metadata.md \
  --output localization/store/
```

### Output Structure

```
localization/store/
├── en/
│   ├── title.txt
│   ├── short_description.txt
│   ├── full_description.txt
│   └── keywords.txt
├── es-419/
│   ├── title.txt
│   ├── short_description.txt
│   ├── full_description.txt
│   └── keywords.txt
└── ... (per locale)
```

### Character Limits Per Store

| Field | iOS | Google Play | Steam |
|-------|-----|-------------|-------|
| App Name | 30 chars | 30 chars | Unlimited |
| Short Description | 45 chars (subtitle) | 80 chars | N/A |
| Full Description | 4000 chars | 4000 chars | Unlimited |
| Keywords | 100 chars | N/A (tags) | Up to 20 tags |
| What's New | 4000 chars | 500 chars | N/A |

From intelli-verse-x/Intelli-verse-X-SDK, MIT.

More from intelli-verse-x/Intelli-verse-X-SDK