InsureInv

---

🌍 Per-Player Language System

Players can now choose their preferred language — messages are served individually based on each player's selection.

Command	Description
/insureinv setlang <language>	Set your preferred language
/insureinv setlang	View current language & available options

• Language preference persisted via Bukkit's PersistentDataContainer
• Tab completion dynamically suggests all loaded languages
• Fully hot-reloadable — /insureinv reload refreshes all translations without restart

---

📄 locales.yml — Admin-Configurable Language Registry

A new config file at plugins/InsureInv/locales.yml gives server admins full control over available languages:

languages:
  en_US:
    file: en_US.yml
  vi_VN:
    file: vi_VN.yml
  pirate:                  # Custom identifier — no naming restrictions!
    file: pirate_speak.yml

How to add a custom language

1. Copy an existing translation file from plugins/InsureInv/lang/
2. Translate the messages in your new file
3. Place it in plugins/InsureInv/lang/
4. Add an entry in locales.yml with your chosen key and file name
5. Run /insureinv reload

[!NOTE] Translation files are loaded from the data folder (plugins/InsureInv/lang/), not from the JAR. Admins can edit translations directly on disk.

---

🆕 Bundled Languages

Language	Key	File
🇺🇸 English (US)	en_US	en_US.yml
🇬🇧 English (UK)	en_GB	en_GB.yml
🇻🇳 Vietnamese	vi_VN	vi_VN.yml
🇫🇷 French	fr_FR	fr_FR.yml
🇯🇵 Japanese	ja_JP	ja_JP.yml

---

🔧 Internal Improvements

• Atomic i18n reload — I18nManager uses AtomicReference for thread-safe bootstrap swapping during reloads, eliminating race conditions where concurrent message lookups could receive stale or null data
• Merged langreload → reload — a single /insureinv reload now handles config, storage, and language reloads
• Library update — hyticallib-i18n-core no longer enforces ISO locale codes (xx_XX), enabling fully custom language identifiers

---

⚠️ Known Limitations

[!CAUTION]

• Translations for fr_FR and ja_JP are AI-generated and may contain inaccuracies — community contributions welcome
• Custom language file hot-reloading has not been extensively tested under heavy production load
• This build has not undergone full QA — edge cases may exist
• Breaking changes may occur in future pre-releases without prior notice