ServerSelectorX Premium icon

ServerSelectorX Premium -----

A modern server selector plugin with advanced features




  • Compatibility with newer server versions
  • Fix player heads for newer server versions that can no longer do it with NBT
----------, Sep 26, 2024

  • Fixed being able to interact with items in some cases with cancel-click-event enabled
  • Fixed effect particles not being hidden
  • Removed debug messages from multi-server actions
  • Dependency updates
----------, Mar 3, 2024

  • Updated NBT API for 1.20.2 support
  • Fixed third party head database plugins
  • Players are now prevented from picking up duplicate server selector items (the items are deleted)
  • Improved error messages for placeholder conditions
  • Placeholders in 'placeholder-value' option are now parsed
  • Minimessage can now be used in menu titles: https://github.com/ServerSelectorX/ServerSelectorX/wiki/RGB-color-codes
----------, Sep 22, 2023

  • Updated NBT API for Minecraft 1.20 support
  • Added 'amount-online: true' option to set the item count to the number of online players
  • Fixed parsing of legacy color codes in PlaceholderAPI placeholders as part of MiniMessage messages
----------, Jun 23, 2023

New features:
  • New 'has-hidden-others' condition, for checking the state of the 'togglehideothers' action
  • New 'effect-minimum-strength' option for the 'has-effect' condition, to require a minimum potion effect strength
  • Command to update hotbar items: /ssx updateitems

Bug fixes:
  • Hotbar items now always update properly if conditions change
  • Fixed mojang-api-head-auto setting doing the opposite of what it should

This update also contains updated dependencies, for improved 1.19.4 support.
----------, Apr 22, 2023

Breaking changes:
  • New heads system with slightly changed head syntax
New features:
  • 1.19.3 compatibility
  • Add color option to set leather armor color (e.g. color: '#FF0000')
  • Allow nesting items, menus and commands in subdirectories
  • Add in-world condition
  • Add support for TheSilentPro's head database plugin
  • Add fill-skip option to specify list of slots not to fill
Fixes:
  • Add back 'data' option for legacy version
  • Improved error message for wrong placeholder value type in config
----------, Dec 14, 2022

This is a major update. Old configuration files are not compatible. A migration guide is available here: https://github.com/ServerSelectorX/ServerSelectorX/wiki/Migration-guide-v2-to-v3

New features:
  • 'conditional' section replacing the previous online, offline, and dynamic sections. This allows for new functionality, you can now also change the item based on PlaceholderAPI placeholders, potion effects, open menus, and more!
  • 1.19 support
  • 'chat' action to send chat message from the player clicking an item
  • Allow configuring actions for empty slots (for example for servers using a resource pack to retexture the menu)
Bug fixes:
  • Fixed error spam when opening menu with invalid config
  • Fixed '/ssx openmenu' command
  • Fixed IndexOutOfBoundsException when using blank materials
  • Fixed 'nbt' option. it now works instead of sending a confusing "compound" warning
----------, Sep 3, 2022

New features:
  • 1.18.2 support
  • The nbt option is now a json string, allowing you to add any NBT data to items [BREAKING CHANGE]
  • Allow async item loading in menus, this solves lag spikes the first time a head texture needs to be downloaded from mojang
  • Add support for placeholders in item material (prefix with !)
Bug fixes:
  • Fixed hex colors being downsampled for adventure minimessage title/lores
  • connected: section wasn't being used when the server was offline (not possible, the player is connected!)
  • Item cooldowns are now only applied when there are actions to run
Library updates:
  • placeholderapi from 2.11.0 to 2.11.1
  • bstats from 2.2.1 to 3.0.0
  • gson from 2.8.9 to 2.9.0
  • adventure-platform-bukkit from 4.0.1 to 4.1.0
  • adventure-api from 4.9.3 to 4.10.0
  • adventure-text-minimessage from 4.1.0-SNAPSHOT 4.10.0
  • item-nbt-api from 2.9.1 to 2.9.2
----------, Mar 12, 2022

(This is an update for SSX-Connector, SSX is unchanged)

Enhancements:
  • Now catches errors during placeholder parsing so if one of your placeholder plugins/extensions/addons has a bug, other placeholders will continue working
  • Added timeouts to requests, this prevents async tasks from getting stuck and leaking memory
  • Set API version to 1.13 so spigot doesn't have to load the compatibility layer. The plugin will still work fine on 1.7.10-1.12.2 (it doesn't use any of the features the legacy compatibility layer was made for)
Library updates:
  • Gson from 2.8.6 to 2.8.9
  • bStats from 2.2.1 to 3.0.0
----------, Feb 12, 2022

No breaking changes besides one small API change.

New features
  • Support for 1.18 and 1.18.1
  • Tab completion for all /ssx subocmmands
  • Added /ssx openmenu <menu> <player> command
Fixed
  • NPE when opening a menu with an invalid config file
  • Error 500 in /ssxc status
  • The hide-flags option now works again
  • Placeholders or server names with non-ascii utf-8 characters now work again
Other changes
  • Removed the need for the commons-lang3 dependency, reducing jar size by 0.2MB
  • Return types for API methods getServer and getOnlineServers have changed
  • Updated head database API from 1.3.0 to 1.3.1
  • Updated PlaceholderAPI from 2.10.10 to 2.11.0
  • Updated NBT API from 2.8.0 to 2.9.0
----------, Dec 22, 2021

No breaking changes.

New features:
  • MiniMessage support for item names and lores (when you set minimessage: true)
  • World whitelist/blacklist for cancel-item-move and cancel-item-drop
  • New servergroup action for the upcoming servergroup bungeecord plugin
Bug fixes:
  • Fixed confusing "Title cannot be longer than 32 characters" error message when a menu config failed to load
  • Fixed anyone (without permission) being able to clear their own inventory using /clear when clear-inv is enabled
Other changes:
  • Moved from Jetty to Grizzly for the internal webserver. Grizzly is simpler and more lightweight, as you can see from the reduction in jar size.
  • Updated head database api from 1.0 to 1.3.0
  • Updated adventure api from 4.9.1 to 2.9.3
  • Updated gson from 2.8.8 to 2.8.9
----------, Nov 19, 2021

No breaking changes.

Bug fixes:
  • Fixed menu re-opening on close on 1.16+
  • NPE when cooldown-message wasn't set in misc.yml
  • Fixed being able to move items using number keys
Library updates:
  • slf4j-simple from 2.0.0-alpha1 to 2.0.0-alpha2
  • jetty from 11.0.5 to 11.0.6 (non-legacy version)
  • jetty from 9.4.42 to 9.4.43 (legacy version)
  • PlaceholderAPI from 2.10.9 to 2.10.10
----------, Aug 10, 2021

No breaking changes.

Added:
- 1.17 support
- /ssx placeholders command that lists all servers and their placeholders

Fixed:
- All servers appearing with server name "Server name is null" in /ssx status

Library updates:
- Jetty from 11.0.2 to 11.0.5 (non-legacy version)
- Jetty from 9.4.40 to 9.4.42 (legacy version)
- Gson from 2.8.6 to 2.8.7
- NBT API from 2.7.1 to 2.8.0
----------, Jun 14, 2021

No breaking changes.

Fixed:
- Menu not opening in creative mode
- NullPointerException when clicking in an empty slot with cancel-item-move enabled
- Menus sometimes not responding on busy servers
- Wrong path used by config sync to download files
- Error when another plugin cancelled opening the SSX menu

New features:
- Run actions when the menu closes: https://github.com/ServerSelectorX/ServerSelectorX/wiki/Menu-close-actions
- New advmessage action to send messages using Adventure MiniMessage: https://docs.adventure.kyori.net/minimessage.html#the-components

Library updates:
- Jetty from 9.4.37 to 9.4.40 (legacy version)
- Jetty from 11.0.1 to 11.0.2 (non-legacy version)
----------, May 12, 2021

SSX-Connector update. Changelog:
  • Allow installing and uninstalling addons without restarting (especially useful for modded servers)
  • One permission node ssxc.admin for all /ssxc subcommands (previously, some subcommands had their own permissions and some didn't have any)
  • Updated bStats from 1.7 to 2.1.0
----------, Apr 7, 2021

For the changelog, see the previous update. I accidentally uploaded the old zip file instead of the new one when publishing the update.
----------, Mar 17, 2021

⚠️ Breaking changes ⚠️
  • The non-legacy version (1.13+) now requires Java 11+
  • If you used left/right click actions in the menu, you will need to update the config
  • If you used player names for heads (in the legacy version), you need to change those to UUIDs.
New features:
  • Added option to only cancel drop/move for SSX items
  • Include online status for servers in HTTP API
  • New cooldown option for items in menus, along with a cooldown-actions setting.
  • head:uuid now automatically makes a Mojang API request to get the base64 head texture value, this means that heads load quickly and reliably now.
  • Old SSX items are now removed from the player's inventory, even without clear-inv: true
Bug fixes:
  • NBT API update checker is now properly disabled, no more annoying messages
  • Right/left click actions now work the same as hotbar items (actions, left-click-actions, right-click-actions, you can use multiple at the same time)
  • Fixed submenus not working reliably on 1.16.2+ when holding an SSX item
Library updates:
  • bStats from 1.7 to 2.1.0
  • NBT API from 2.6.0 to 2.7.1
  • Jetty from 9.4.34 to 9.4.37 (legacy version)
  • Jetty from 9.4.34 to 11.0.1 (non-legacy version)
----------, Mar 17, 2021

Quick bug fix release to fix errors introduced in the previous version for servers with PlaceholderAPI installed.
----------, Nov 8, 2020

No breaking changes! This update is a drop-in replacement, however if you are not on 1.16 you can probably skip this update. Only SSX has been updated, you do not need to update SSX-Connector.

New features:
- 1.16.4 compatibility
- Set durability for items in non-legacy version using the new 'durability' option

Fixed:
- Submenus not working on 1.16.2+
- Typo in default config (action instead of actions), resulting in items not doing anything and causing confusion
----------, Nov 7, 2020

This release has some breaking changes related to the API (connector, config sync, etc). However, because of the security improvements this brings I recommend spending a bit of time to update your servers to this version, especially if you run your servers without a proper firewall.

You will need to update both SSX and SSX-Connector at the same time.

Breaking changes:
  • New host option in api.yml, which defaults to 127.0.0.1. If you update, the API will only be accessible on localhost. This makes sure that the API is not exposed to the internet even if there is no firewall installed. If you are using shared hosting or are in some other situation where the API needs to be open to the internet, add host: 0.0.0.0 to api.yml to make it bind to all interfaces like it did previously.
  • Removed password support. Passwords were mostly useless anyway, and were only confusing users.
  • Files API (used by config sync) disabled by default. Delete api.yml to get the option to enable it if you are using config sync.
Changes:
  • 1.16.2 compatibility
  • Compatibility with PlaceholderAPI 2.10.7+
  • Comma separated slot numbers, finally! Use for example '2,4,6,7': instead of having to add 4 items
  • Fixed placeholders being sent way too often when using more than one address with a low send interval. This bug could cause a lot of lag.
  • Add support for server names with special characters. People speaking languages with characters not in the latin alphabet, enjoy!
  • Many minor fixes that are not worth noting individually.
----------, Sep 10, 2020

Breaking changes
  • If you're using left-click-actions for items, the configuration has changed. Instead of 'actions' for right click and 'left-click-actions' for left click, the plugin now uses 'right-click-actions' for right click, 'left-click-actions' for left click, and 'actions' for both.
New features
  • 1.16 compatibility
  • Configurable values for missing placeholders (see misc.yml)
Fixed
  • Old server names sticking around in /ssx status until the server was restarted (now this is cleared on /ssx reload as well)
  • firstavailableserver action sending players to multiple servers at once
Other changes
  • Updated jetty to 9.4.30.v20200611
  • Updated NBT API to 2.4.1
  • Disabled NBT API update checker to avoid update warnings in the future
----------, Jun 29, 2020

A small update for SSX-Connector. ServerSelectorX hasn't changed.
  • Fixed NoSuchElementException when running /ssxc placeholders
  • Clear old ping errors (in /ssx status) when using /ssx reload
  • Fixed player placeholders not working properly when sending data to multiple addresses
  • Don't attempt to send data if server-name setting is empty
  • Added option to disable caching
  • various other minor changes
----------, May 27, 2020

This update contains some breaking changes, please read before updating. You only need to update the SSX jar file, the connector hasn't changed.

Breaking changes:
  • The effects.yml file is no longer used, please delete it to avoid confusion. Use join.yml for giving effects on join
  • The toggleeffect action has changed from toggleeffect:name to toggleeffect:name:amplifier or toggleffect:name:amplifier:duration
  • PlaceholderAPI placeholder namespace has changed from serverselectorx to ssx. If you use SSX placeholders in other plugins using PAPI, change serverselectorx to ssx in your placeholders.
New features:
  • Join actions
  • Exclude files from config sync
  • addeffect: action with custom amplifier and duration
  • Effect amplifier is now specified in the action instead of in a separate effects.yml file
  • Text for PlaceholderAPI status placeholder is now configurable
  • Head Database support! Use hdb:<id>
Bug fixes:
  • Fixed PlaceholderAPI NullPointerExceptions when a player leaves the server
  • Fixed dynamic modes less and more swapped
  • Fixed config sync replacing non-latin characters with question marks
  • Fixed config sync not syncing directories recursively
  • NoSuchMethodException on player join on 1.7.10/1.8.8 servers with clear inventory enabled
Library updates:
  • Updated Jetty to 9.4.28.v20200408
  • Updated NBT API to 2.3.1. This version fixes a 1-2 second server freeze the first time the NBT API is used. You will also no longer see the update warning.
  • Updated PlaceholderAPI to 2.10.6
----------, May 16, 2020

These releases contain bug fixes and performance improvements. Changing the configuration is not required, so I recommend updating.

Sponge:
  • Fixed plugin not loading when using another plugin/mod that used bStats
SSX-Connector:
  • Fixed player placeholders not working when sending data to multiple servers
  • More efficient internal data storage
  • Added debug mode
  • Rewritten error handling and made /ssxc status more user friendly
  • When pinging multiple addresses, spread out requests. For example, with interval set to 5 seconds with 10 servers, instead of pinging all 10 servers at once every 5 seconds it will now ping one server every half a second.
  • Fix concurrent modification exceptions with using some placeholders
  • Added option to cache some placeholders (for example, configure the plugin to only refresh the rank prefix placeholder every 10 seconds instead of every time it pings a server)
  • Added option to load some placeholders async (useful for plugins that need to get data from databases)
  • Added command to view placeholder collection and caching statistics: /ssxc count
ServerSelectorX:
  • No changes, no need to update.
----------, Mar 18, 2020

This release contains some important bug fixes, I recommend updating as soon as possible. You do not need to change your configuration files, and you do not need to update SSX-Connector.
  • Config sync: fixed files being deleted even when file deletion was disabled
  • Fixed color codes in cooldown message
  • Added option to disable menu updates as a workaround for the annoying item bounce animation issue on the legacy version
  • Fixed custom NBT not working
  • Fixed material: NONE not working in no-permission section
  • Fixed permission not working for commands
  • Added configurable no-permission message
  • Fix PlaceholderAPI NullPointerExceptions when a player leaves the server
  • Default menu refresh interval set to 5 seconds to reduce lag
  • Configurable menu refresh interval
----------, Feb 4, 2020

You do not need to update SSX-Connector. Only update from 2.0.0. If you are using an older version, please read the previous update.
----------, Jan 24, 2020

Before updating, please note: Your old config files are not compatible. There have been so many changes that you'll probably have to go through the learning process again when configuring the plugin. Hopefully the learning curve is less steep this time, since I've improved the documentation and simplified the configuration. You'll have to upgrade everything, nothing is compatible. New connector, new addons, new everything.

Changelog:
- Improved config sync: It is now faster and can sync any file on the entire server. The interval is now configurable and there is a command to manually sync.
- Added support for 1.15
- Fixed bug where players could take items out of the menu
- Fixed enchantments
- Added support for all effects instead of just speed and invisibility
- New teleport action
- New firstavailableserver action: Teleports to the first available server in a list of servers. A server is available when it is online and online players < max players
- Actions can now be configured per section (separate actions for online, offline dynamic)
- Sponge connector now supports addons
- Player specific placeholders support
- Allow adding custom commands and items separate from menus (commands/items that can run any action)
- Restructured configuration files for more flexibility
- New java API for getting server status and registering custom actions
- No more console spam from connector messages. You can now check pinging status using /ssx status and /ssxc status
- Added command to view placeholders: /ssxc placeholders
- Allow creating multiple menus with the same title
- Added give delay option so it can work with plugins that annoyinly clear the player's inventory on join
- Opening the menu from another plugin no longer breaks it
- Added /ssx lagdebug command
- Connector addons are files instead of folders making it less annoying to install
- Instead of not opening the menu, the plugin will now send you a nice message in chat telling you what is wrong (in most cases)
- Fixed duplication bug when cancel-item-drop was turned on
- Fixed cancel-item-move not working for offhand in legacy version
- New connected: section that is active when you are currently connected to that server
- The server that is used for placeholders has been made independent from actions
- All SSX server placeholders are registered as PlaceholderAPI placeholders
- Removed /ss alias to avoid conflict with silkspawners
- SSX-Connector can now send player specific placeholders!
- All effects are supported now, instead of just invisibility and speed (as action and on join)
- Action to play sound
- Action to execute another action with a delay
- New randomserver: action
- New roundrobinserver: action
- Set commands to run after config sync
- Support for heads with custom textures
- Set custom item NBT (only ints, strings, bools, no compounds/lists)
- Addons are now reloaded using /ssxc reload
- Configurable cooldown for item clicking and command executing with configurable message
- Don't require a restart when adding new commands
- Added /ssx lagdebug and /ssx itemdebug
- Dependency updates
----------, Jan 23, 2020

  • Fixed item 'NONE' not working
  • Fixed NPE when dynamic sections are used
  • Fixed NPE when using the 'sel' action
----------, Jul 8, 2019

  • Backported 2.0.0 to legacy (1.8-1.12). Since I started running my own server, I understand why people don't use 1.13 and especially 1.14 yet. Mojang, make your game stable again!
  • Fix inventory being cleared after adding items in the hotbar, instead of before (when clear-inv was turned on)
  • Added support for player specific placeholders. SSX-Connector doesn't support it yet, but it will soon. When it will, you won't need to update ServerSelectorX.
  • A bunch of permission related fixes
  • Update to latest version of jetty (internal webserver)
  • Enchantments should now work for all versions
----------, Jun 25, 2019

Only update from v2.0.0-rc1, or do a fresh install!
  • If you are using version 1.4.4, you do not need to update anything.
  • The zip is very small now because it only contains a download link to the actual resource (Spigot didn't let me upload the file becauses it was too large, and it also didn't allow me to specify an external url)
  • Fixed SSX-Connector system not working in v2.0.0-rc1
  • Added jar file for 1.13 servers (it's the same plugin as for 1.14, but with the api version set to 1.13 so spigot will load it)
----------, May 11, 2019

This is not a drop-in replacement! See https://github.com/ServerSelectorX/ServerSelectorX/wiki/Premium-|-Installation-Instructions

New version of ServerSelectorX. This version is made for 1.13 and 1.14 only and probably will not work on older versions. The old version is still included in the zip, and is still supported. Changes:
- Completely redesigned the layout of menu files, making the plugin easier to configure. The config file is much shorter now.
- Added a configuration synchronization feature. This allows you to automatically sync menus and other configuration files across servers, so you don't have to manually copy files to all servers after making changes.
- General performance improvements and bug fixes
- Allow the use of 1.13 and 1.14 item names

Please note that this is a release candidate and is not guaranteed to be stable. Additionally, not all wiki articles have been updated yet.
----------, May 5, 2019

  • New SSX-Connector addon for the plugin BuildBattle
  • New SSX-Connector addon for sending PlaceholderAPI placeholders from other servers to the hub server
  • Fixed SSX-Connector for Sponge not adding a 'key' option to the config file.
Note: ServerSelectorX and SSX-Connector for Spigot have not been updated. You do not need to update these plugins. For installing the new addons, see this wiki page.
----------, Apr 17, 2019

SSX-Connector for Sponge API 7.1.0 (Minecraft 1.12.2). It does not support addons (yet). It will provide online/offline status and player count.
----------, Jan 20, 2019

Resource Information
Author:
----------
Total Downloads: 1,332
First Release: Jan 20, 2019
Last Update: Sep 26, 2024
Category: ---------------
All-Time Rating:
37 ratings
Find more info at github.com...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings