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:

build.gradle.kts
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:

messages.yml
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.