═══════════════════════════════════════════════════════════════
 Visitante Nocturno Mod — Translation guide
═══════════════════════════════════════════════════════════════

HOW TO CREATE A TRANSLATION:

  1. Copy _template.json (EN base) or _template_es.json (ES base).
  2. Rename it to <langcode>.json. Examples:
       fr.json   French
       de.json   German
       it.json   Italian
       pt.json   Portuguese (BR or PT)
       ru.json   Russian
       ja.json   Japanese
       ko.json   Korean
       zh.json   Chinese Simplified
  3. Translate the VALUES (right side). Keep the KEYS (left side) untouched.
  4. Drop the file in this same folder (translations/).
  5. Restart The Sims 4. The mod auto-detects the language and loads it.

PLACEHOLDER RULES:

  - {name}, {target}, {vn_name}, {n}, {min}, {mode}, etc. — these MUST
    stay exactly as they are. They get replaced at runtime with sim names,
    counts, etc. If you change them, the text breaks.

  - {F0.text}{M0.text} — gender tokens. The game shows the F0 part for
    female sims and the M0 part for male sims. Translate BOTH parts:
       {F0.She did this.}{M0.He did this.}
    Keep the braces and the F0./M0. exactly as they are.

  - \n — line break. Keep as-is, the game renders it as a new line.

PARTIAL TRANSLATIONS ARE OK:

  Missing keys fall back automatically to English. You can ship a partial
  translation and add keys later. The mod will never crash on a missing key.

TIPS:
  - Save the file as UTF-8 (with or without BOM — both work).
  - Use single quotes inside string values to avoid escaping the double quotes.
  - If a value has a literal { or } that is NOT a placeholder, you do not
    need to escape it — the mod uses .replace() not .format().

SUPPORT:
  - In-game cheat: visitante.translations_status
    Tells you which language was detected and which JSON files were loaded.
  - In-game cheat: visitante.translations_status <key>
    Tests a specific key (e.g. visitante.translations_status menu.atacar)
