# Minecraft Server Management Protocol Legacy Support<\/p>\n
Adds a Minecraft Server Management Protocol endpoint to server software that does not provide Mojang’s native implementation.<\/p>\n
The Minecraft Server Management Protocol is the newer management API for Minecraft servers. It exposes server information and management actions through JSON-RPC over WebSocket, instead of relying on older mechanisms such as server-list ping or RCON. This plugin brings that protocol shape to older server versions and proxy environments so external tools can speak one management protocol across mixed infrastructure.<\/p>\n
## What it provides<\/p>\n
– A WebSocket endpoint for Minecraft Server Management Protocol clients.
\n– JSON-RPC request and response handling compatible with the protocol model documented on the Minecraft Wiki.
\n– Discovery through `rpc.discover`, so clients can inspect which methods are available.
\n– Server\/proxy status support, including online player list and version information.
\n– Management operations for Bukkit-based servers, including players, allowlist, bans, operators, selected server settings, gamerules, save, stop, and system messages.
\n– Proxy management operations for Velocity and BungeeCord, including players, kick, status, stop, and system messages.
\n– Authentication by shared secret, with browser-origin checks for WebSocket subprotocol authentication.
\n– Optional TLS using a PKCS12 keystore.<\/p>\n
Reference: https:\/\/minecraft.wiki\/w\/Minecraft_Server_Management_Protocol<\/p>\n
## Platform Status<\/p>\n
| Platform | Status |
\n| — | — |
\n| Spigot \/ Paper | Main supported runtime. Built against the Spigot 1.8.8 API for legacy compatibility. |
\n| Velocity | Proxy runtime support for discovery, players, kick, proxy status, proxy stop, system messages, and proxy\/player notifications. |
\n| BungeeCord | Proxy runtime support for discovery, players, kick, proxy status, proxy stop, system messages, and proxy\/player notifications. |<\/p>\n
For legacy SpaceChunks usage, install the Spigot\/Paper build on the backend server when you need live server status and online player counts from old Minecraft versions.<\/p>\n
## Supported Methods<\/p>\n
| Method group | Spigot \/ Paper | Velocity | BungeeCord |
\n| — | — | — | — |
\n| `rpc.discover` | yes | yes | yes |
\n| `minecraft:players` | yes | yes | yes |
\n| `minecraft:players\/kick` | yes | yes | yes |
\n| `minecraft:server\/status` | yes | yes, proxy status | yes, proxy status |
\n| `minecraft:server\/stop` | yes | yes, stops proxy | yes, stops proxy |
\n| `minecraft:server\/system_message` | yes | yes, proxy players | yes, proxy players |
\n| `minecraft:server\/save` | yes | no | no |
\n| `minecraft:allowlist\/*` | yes | no | no |
\n| `minecraft:bans\/*` | yes | no | no |
\n| `minecraft:ip_bans\/*` | yes | no | no |
\n| `minecraft:operators\/*` | yes | no | no |
\n| `minecraft:serversettings\/*` | partial | no | no |
\n| `minecraft:gamerules\/*` | yes | no | no |<\/p>\n
Spigot\/Paper server settings are limited to APIs available through the Spigot 1.8.8 API. Implemented settings are `autosave`, `difficulty`, `use_allowlist`, `player_idle_timeout`, `allow_flight` read-only, `motd` read-only, `spawn_protection_radius`, `game_mode`, and `view_distance` read-only.<\/p>\n
## Supported Notifications<\/p>\n
| Notification group | Spigot \/ Paper | Velocity | BungeeCord |
\n| — | — | — | — |
\n| `minecraft:notification\/server\/started` | yes | yes | yes |
\n| `minecraft:notification\/server\/stopping` | yes | yes | yes |
\n| `minecraft:notification\/server\/status` | yes | yes | yes |
\n| `minecraft:notification\/server\/activity` | yes | yes | yes |
\n| `minecraft:notification\/players\/joined` | yes | yes | yes |
\n| `minecraft:notification\/players\/left` | yes | yes | yes |
\n| `minecraft:notification\/server\/saving` | yes | no | no |
\n| `minecraft:notification\/server\/saved` | yes | no | no |
\n| `minecraft:notification\/allowlist\/*` | management API changes only | no | no |
\n| `minecraft:notification\/bans\/*` | management API changes only | no | no |
\n| `minecraft:notification\/ip_bans\/*` | management API changes only | no | no |
\n| `minecraft:notification\/operators\/*` | management API changes only | no | no |
\n| `minecraft:notification\/gamerules\/*` | management API changes only | no | no |<\/p>\n
## Configuration<\/p>\n
The service is disabled by default. Enable it only after setting a secret and deciding where it should listen.<\/p>\n
Spigot\/Paper uses `plugins\/MinecraftServerManagementProtocolLegacySupport\/config.yml`:<\/p>\n
“`yaml
\nmanagement-server-enabled: true
\nmanagement-server-host: localhost
\nmanagement-server-port: 25585
\nmanagement-server-secret: ‘replaceWithExactly40AlphaNumericCharacters’
\nmanagement-server-allowed-origins: ”
\nmanagement-server-tls-enabled: false
\nmanagement-server-tls-keystore: ”
\nmanagement-server-tls-keystore-password: ”
\n“`<\/p>\n
Velocity and BungeeCord create `management-server.properties` in the plugin data folder with the same setting names.<\/p>\n
### Settings<\/p>\n
– `management-server-enabled`: Starts or disables the management endpoint.
\n– `management-server-host`: Interface to bind. Use `localhost` when only local tooling or a reverse proxy should connect.
\n– `management-server-port`: Port for the WebSocket server. Use a fixed port for production.
\n– `management-server-secret`: Required shared secret. It must be exactly 40 alphanumeric characters.
\n– `management-server-allowed-origins`: Comma-separated list of allowed browser origins when authenticating through `Sec-WebSocket-Protocol`.
\n– `management-server-tls-enabled`: Enables `wss:\/\/`. Requires a valid keystore.
\n– `management-server-tls-keystore`: Path to a PKCS12 keystore.
\n– `management-server-tls-keystore-password`: Keystore password. It can also be supplied through `MINECRAFT_MANAGEMENT_TLS_KEYSTORE_PASSWORD` or the JVM property `management.tls.keystore.password`.<\/p>\n
## License<\/p>\n
Licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE).<\/p>\n","protected":false},"excerpt":{"rendered":"
Adds legacy version support for Minecraft Server Management Protocol<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"minecraft-server-management-protocol-legacy-support","_minecraft_project_id":"38WxG5ix","_minecraft_author":"FllipEis","_minecraft_license":"Apache-2.0","_minecraft_downloads":11,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"minecraft-server-management-protocol-legacy-support.zip","_minecraft_size_bytes":7876486,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T23:03:04.008711Z","_minecraft_date_created":"2026-05-07T22:29:14.592193Z","_minecraft_date_modified":"2026-05-01T14:22:14.223014Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/minecraft-server-management-protocol-legacy-support","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-05T20:44:45+00:00","_minecraft_import_hash":"fc47fe878c08a264446496ff145abb0b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,894,126,127,129,123,92,985,992],"mod_loader":[130,895,132,134,986,993],"minecraft_version":[341,360,385,449,114,117,48,50,53,58,102,82,30,864],"class_list":["post-102071","mod","type-mod","status-publish","hentry","mod_category-bukkit","mod_category-bungeecord","mod_category-management","mod_category-paper","mod_category-spigot","mod_category-technology","mod_category-utility","mod_category-velocity","mod_category-waterfall","mod_loader-bukkit","mod_loader-bungeecord","mod_loader-paper","mod_loader-spigot","mod_loader-velocity","mod_loader-waterfall","minecraft_version-1-10-2","minecraft_version-1-11-2","minecraft_version-1-12-2","minecraft_version-1-13-2","minecraft_version-1-14-4","minecraft_version-1-15-2","minecraft_version-1-16-5","minecraft_version-1-17-1","minecraft_version-1-18-2","minecraft_version-1-19-4","minecraft_version-1-20-6","minecraft_version-1-21-9","minecraft_version-1-8-8","minecraft_version-1-9-4"],"yoast_head":"\n