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.