Skip to content

🛠️ Troubleshooting

Command not found

  • Check PATH: ~/.cargo/bin (Linux/macOS), %USERPROFILE%\.cargo\bin (Windows).
  • On macOS for downloaded builds: bash chmod +x ./rimloc-cli ./rimloc-cli --help

Placeholder issues after import

  • Validate the .po first: bash rimloc-cli validate-po --po ./MyMod.ru.po --strict
  • Ensure placeholders in msgid/msgstr match exactly.

Empty or duplicate keys

  • Validate XML sources: bash rimloc-cli validate --root ./Mods/MyMod --format text

Encoding problems

  • Ensure UTF‑8 (no BOM) in your editor.
  • See xml health: cli/xml_health.md

Import does nothing

  • .po has empty msgstr values only.
  • Keys/paths don’t match XML.
  • Use --report --dry-run to inspect mapping.