# LostCrafters Server Plugin<\/p>\n
A Velocity plugin that provides a customizable `\/server` command with support for server groups, GUIs (via Protocolize), and text-based selection.<\/p>\n
## Features<\/p>\n
– **Server Groups**: Define groups of servers. Players only see servers within their current group.
\n– **GUI Support**: Use Protocolize to show an interactive inventory for server selection.
\n– **Text-based Selection**: Fallback to clickable chat messages if GUIs are disabled.
\n– **Customizable Messages**: All messages support MiniMessage and can be fully customized in the config.
\n– **LuckPerms Integration**: Fine-grained permission control.
\n– **MiniPlaceholders Support**: Integration with MiniPlaceholders for dynamic placeholders from other plugins.<\/p>\n
## Commands<\/p>\n
– `\/server [server]`: Opens the server selection GUI\/menu or connects directly to the specified server.
\n– `\/lcserver reload`: Reloads the plugin configuration.<\/p>\n
## Permissions<\/p>\n
– `lostcrafters.server.use`: Allows use of the `\/server` command. **Note**: By default, players have no access to any server. You must explicitly grant access via these permissions.<\/p>\n If a player’s permission is revoked while they are connected to a server, they will be automatically redirected to a fallback server (as defined in `velocity.toml`) or disconnected if no fallback is available.<\/p>\n ## Configuration<\/p>\n The configuration is located at `plugins\/lostcrafters\/server\/config.yml`.<\/p>\n ### Example Configuration<\/p>\n > **Note**: For GUI items, it is recommended to use vanilla Minecraft IDs (e.g., `minecraft:compass`). Modded items may not be supported by the GUI library and will default to a diamond sword if not found.<\/p>\n “`yaml ### Configuration Breakdown<\/p>\n #### Server Groups #### Server Entries ### Message Configuration<\/p>\n You can customize all plugin messages in the `messages` section of the config. The following placeholders are available and valid per message as indicated:<\/p>\n – `%servername%`: The display name of the server as configured in `server-groups`. #### Valid Placeholders per Message:<\/p>\n | Message | Default Message | Valid Placeholders | Example usage in `hover-text`: ## Dependencies<\/p>\n – **Velocity API**: 3.4.0-SNAPSHOT Customizable \/server command and connection management velocity plugin<\/p>\n","protected":false},"featured_media":95696,"template":"","meta":{"_minecraft_slug":"lost-crafters-server-switcher","_minecraft_project_id":"ajlK45vO","_minecraft_author":"SilentSean","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":30,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"lost-crafters-server-switcher.zip","_minecraft_size_bytes":56233,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:05:55.812357Z","_minecraft_date_created":"2026-01-05T21:19:20.051309Z","_minecraft_date_modified":"2026-02-07T16:17:34.175357Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/lost-crafters-server-switcher","_minecraft_icon_attachment_id":95696,"_minecraft_imported_at":"2026-06-05T11:34:25+00:00","_minecraft_import_hash":"d00c84a996bd84d7835353a67f652ca4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,92,985],"mod_loader":[986],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-95695","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `lostcrafters.server.reload`: Allows use of the `\/lcserver reload` command.
\n– `lostcrafters.serveraccess.
\n– `lostcrafters.serveraccess.*`: Grants access to all servers.<\/p>\n
\nserver-groups:
\n survival_group:
\n name: “
\n show-gui: true
\n enable-switch-broadcast: true
\n servers:
\n – lobby:
\n name: “Lobby”
\n item: “minecraft:compass”
\n – survival:
\n name: “Survival”
\n item: “minecraft:iron_pickaxe”
\n – creative:
\n name: “Creative”
\n item: “minecraft:grass_block”
\n – staff_lounge:
\n name: “Staff Lounge”
\n hide-from-list: true
\n minigames_group:
\n name: “
\n show-gui: false
\n servers:
\n – minigames_lobby:
\n name: “Minigames Lobby”
\n item: “minecraft:clock”
\n“`<\/p>\n
\nEach entry under `server-groups` defines a collection of servers.
\n– `name`: (String) The display name of the group. Supports MiniMessage.
\n– `show-gui`: (Boolean) If `true`, a GUI (chest menu) will be shown when using `\/server`. If `false`, a text-based selection message will be sent in chat.
\n– `enable-switch-broadcast`: (Boolean, Optional, Default: `true`) If `true`, a message will be broadcast to all players within the group when a player switches from one server in the group to another.<\/p>\n
\nEach server within a group is defined by its internal Velocity name and the following properties:
\n– `name`: (String) The display name of the server.
\n– `item`: (String, Optional, Default: `minecraft:diamond_sword`) The Minecraft item ID for the GUI representation (e.g., `minecraft:compass`).
\n– `hide-from-list`: (Boolean, Optional, Default: `false`) If `true`, this server will be hidden from the GUI and the text selection list. The server remains accessible via `\/server
\n– `%playercount%`: The current number of players online on that server.
\n– `%players%`: A comma-separated list of names of players currently on that server.
\n– `%server%`: The internal ID\/name of the server.
\n– `%player%`: The name of the player who is switching servers.
\n– `%previousserver%`: The internal ID of the previous server.
\n– `%previousservername%`: The display name of the previous server.<\/p>\n
\n| :— | :— | :— |
\n| `select-server` | `
\n| `server-format` | `[
\n| `current-server-format` | `[
\n| `hover-text` | `
\n| `no-permission` | `
\n| `reloaded` | `
\n| `server-not-found` | `
\n| `already-connected` | `
\n| `connecting` | `
\n| `no-server-permission` | `
\n| `no-fallback-server` | `
\n| `server-switch-broadcast` | `
\n“`yaml
\nhover-text: “
\n“`<\/p>\n
\n– **Protocolize**: 2.4.1 (Optional, required for GUIs)
\n– **MiniPlaceholders**: (Optional, for additional placeholders)
\n– **LuckPerms**: For permission management
\n– **Configurate (YAML)**: For configuration management<\/p>\n","protected":false},"excerpt":{"rendered":"