The Atlas plugin
The Atlas plugin connects a server to the worker on its node. It reports the player count and the server's metadata, keeps a live list of every running server in the network, and lets proxies send players to the right server.
Paper, Velocity and BungeeCord
There's nothing to install. Each time a server starts, Atlas puts the plugin that matches its software in plugins/atlas.jar, always the version that fits your panel. Paper and Purpur take the Paper plugin, and Velocity and BungeeCord each take their own.
Vanilla servers and other jars get no plugin, because Atlas can't tell what they run.
Minestom
A Minestom server has no plugin loader, so it adds the Atlas library to its own build:
dependencies {
implementation("gg.getatlas:atlas-minestom:0.1.1-beta.5")
}Then start Atlas once, after MinecraftServer.init(), and register its commands. Minestom has no permissions of its own, so you decide who may run them:
Atlas atlas = AtlasMinestom.start();
AtlasMinestom.registerCommands(atlas, (sender, permission) ->
sender instanceof ConsoleSender); Commands
| Command | Permission | What it does |
|---|---|---|
/atlas servers [group] |
atlas.command.servers |
Lists the running servers of the network, or of one group, with their players |
/atlas link <code> |
Everyone | Links your Minecraft account to your panel account with the code from your profile |
/deploy <world> <Name> [template] |
atlas.deploy |
Sends a world into a template draft, on Paper 1.21.7 or later. See Map deploys |
/deploy done |
atlas.deploy |
Saves the setup files on a setup server and sends you back |
Hover a server in the list to see its id and metadata. Arguments complete as you type.
Staff with atlas.notify.servers on a proxy see a line in chat when a server is created, has started or is stopping.
Change the messages
Every line the plugin writes to chat comes from messages.yml in the plugin's folder: plugins/Atlas on Paper and BungeeCord, plugins/atlas on Velocity and atlas on Minestom. The plugin writes the file with its defaults on the first start, and reads it each time the server starts.
The lines use MiniMessage, so you can change the wording, the colours and the language:
servers:
none-running: "<gray>No servers are running."
unknown-group: "<red>No group called <group> is running servers."A line you leave out keeps its default. To change the messages for a whole group, put messages.yml in the group's template.