InsureInv

Release Notes

Breaking Changes

Removed i18n support* — the plugin no longer supports per-player language configuration. Removed all i18n-related commands* and their associated functionality. Messages are now managed through a single `messages.yml` file*.

Build & Dependencies

Updated Gradle Wrapper* to 9.7.1. Updated Kotlin* to 2.4.10.

Migration

If you're upgrading from a previous version, review your existing language configuration and migrate any custom messages into the new messages.yml format.

• Restructuring: Code refactored for better performance. • Removed: Useless features cleaned out. • Compatibility: Works on all versions from 1.20.x to 26.x.

InsureInv Changelog

Version 1.3.2

Dropped Spigot Support

- InsureInv now requires Paper or Folia (including forks). Spigot and other non-Bukkit servers are no longer supported. - If you're still using Spigot, please upgrade to Paper to continue using the plugin.

Economy System Improvements

- Better fallback logic when choosing which economy provider to use. - Improved compatibility with different server types when using Vault.

Better Statistics (bStats)

- More detailed server information is now collected to help the developer improve the plugin. - Added timezone detection for better understanding of server demographics. - Cleaned up unnecessary system info collection.

Behind the Scenes

- Plugin now starts more reliably in certain edge cases. - Improved language file reloading to prevent rare errors. - General code cleanup and optimizations. --- Important: If you're running Spigot, please migrate to Paper before updating to version 1.3.2. Paper is fully compatible with Spigot plugins and offers better performance.

Improvements

- Improved overall UX for a smoother and more consistent experience when interacting with commands and menus. ---

Permissions & Bypass

- Admins / OPs now bypass costs when using /inv buy - Admins / OPs also bypass `maxUsage` limits ---

Platform Compatibility

- Confirmed compatibility with: - Folia (region-safe scheduling supported) - Spigot/Paper-based servers - Improved cross-platform behavior for economy handling and task scheduling - Arclight & more soon ---

Fixes

- Fixed incorrect plugin name lookup causing economy provider to always return null - Fixed edge cases where no valid economy provider was selected even when available ---

Notes

- Recommended for all servers using economy integrations

---

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

<details> <summary><b>How to add a custom language</b></summary> 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 </details>

[!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