## Compatibility - Supports every Paper release from 1.21.11 to 1.21.26.2 - Compiled against `paper-api:1.21.11` (Java 21, `api-version: '1.21'`) - Added a new `checkLatestApi` Gradle task: - Recompiles the plugin against the latest Paper API (26.2) - Runs automatically as part of `check` - Detects API removals during development instead of at runtime - Replaced deprecated string-based Bukkit APIs with Adventure Components: - `ChatColor` - `ItemMeta#setDisplayName` - `Bukkit.createInventory(..., String)` - `InventoryView#getTitle()` - Materials are now resolved by name with automatic fallback and warning logging - Verified on: - Paper 1.21.11 (Build 132) - Paper 1.21.26.2 (Build 84) - LuckPerms 5.5.65 ## Configurable Commands & Permissions - Command name, aliases, description and usage are now fully configurable - All permission nodes are configurable, including their default value (`true` or `op`) - Commands are registered dynamically at runtime - Command labels are automatically sanitized: - Removes leading `/` - Removes invalid spaces and colons - Normalizes casing - Aliases already owned by another plugin are skipped and logged instead of appearing broken - Permission nodes are registered with Bukkit, allowing `default: true` to work correctly - Per-server permission nodes: - Generated automatically from the server key - Can be overridden individually - Can be hidden or shown as locked ## Bug Fixes ### Menu & Interaction - Fixed the menu opening twice because interact events fired for both hands - Left-clicks no longer prevent normal block breaking while holding the selector - Menu now uses an `InventoryHolder` instead of comparing inventory titles - Prevented players from: - Taking menu items - Dragging items - Using number keys - Swapping with the offhand - Placing items into item frames - Eating menu items ### Selector Item - Selector items are now identified using a `PersistentDataContainer` tag instead of their display name - Added a display-name fallback for backwards compatibility - Fixed selector duplication after death and respawn - Fixed null checks for `ItemMeta` ### Configuration - Added startup validation for all configuration values - Invalid configuration entries now generate detailed warnings: - Unknown materials - Invalid inventory sizes - Invalid slots - Duplicate server slots - Configuration is now parsed once into an immutable snapshot instead of reading YAML on every event ### Stability - Fixed a `NullPointerException` when the command was missing from `plugin.yml` - Fixed open menus remaining after plugin shutdown - Fixed `unregisterOutgoingPluginChannel(this)` unregistering every outgoing plugin channel instead of only `BungeeCord` - Removed the Guava (`ByteStreams`) dependency for plugin messaging in favour of the Java standard library ## Additions - Fully customizable messages section - Any message can be disabled by setting it to `""` - Supports: - Legacy `&` colour codes - MiniMessage - Hex colours - Added `prevent-connect-to-current` to prevent reconnecting players to the server they are already on - Added new selector item options: - `enabled` - `open-on` - `locked` - `force-slot` - `give-on-join` - `give-on-respawn` - Added: - `gui.filler` - `gui.close-on-click` - Full backwards compatibility with v1 configurations: - Missing values automatically fall back to defaults - `gui.fill-border` is still supported - Configuration version mismatches are reported in the console ## Notes > Changing `command.name` requires a full server restart. > Running `/selector reload` will continue using the previous command label and will notify you in chat instead of pretending the change was applied.

## 1.0.0 - Initial release - Compass given on join (configurable hotbar slot, default center slot 4) - Chest GUI with fully configurable server entries - BungeeCord/Velocity connect via plugin messaging - Drop prevention for the selector compass (configurable) - `/selector` and `/selector reload` commands - Full `config.yml` support — material, name, lore, slot, server ID per entry