Crqzy's Server Selector

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.