exaroton-proxy-plugin

About exaroton

exaroton provides high-end on demand game servers. This is very useful for proxy networks as you can turn off servers which aren't used right now to save money and start them automatically when you need them.

Commands

The Plugin provides the /exaroton command with the following subcommands:

Permissions

Commands are not available to players by default. You can give players access to the commands by giving them the required permission nodes. The exaroton permission node is required for all commands.

Configuration

Since this plugin uses the exaroton API to manage servers, you need to provide an API token, which can be obtained on https://exaroton.com/account/. You can also configure this plugin to start servers alongside your proxy (e.g. for your main lobby) and stop servers when the proxy stops.

It's also possible to disable the watch servers feature which automatically removes servers from the proxy when they go offline.

Default configuration

# exaroton API token. You can generate this on https://exaroton.com/account/
apiToken = 'example-token'

# Watch servers in the proxy config and automatically remove them when they go offline
# Note that this only works if you use .exaroton.me addresses in your velocity config.
watchServers = true

# Automatically start servers when the proxy starts
[autoStartServers]
enabled = false
servers = ["example.exaroton.me"]

# Automatically stop servers when the proxy stops
[autoStopServers]
enabled = false
servers = ["example.exaroton.me"]

Bukkit plugin

The bukkit plugin forwards commands from your backend servers to the proxy using plugin messages. This makes it possible to use these commands in command blocks or other plugins (e.g. for NPCs).

Since plugin messages are sent using a player connection, at least one player has to be connected to the backend server. If the plugin is missing from one of your proxies, the player could read the command that would have been executed.

Selectors like @a, @p and @r will automatically be replaced on the backend server. @a therefore refers to all players on the backend server, not all players on the proxy. These selectors are not supported on the proxy directly.

Using multiple Proxies

Since this plugin does not synchronize the proxy servers with each other, there are some limitations when you try to use it with multiple proxies. Starting a server using /exaroton start <server> only adds the server to the proxy you are connected to right now. Stopping/Restarting works across proxies, assuming that all proxies have the plugin installed as they will automatically remove the server when it is no longer online and will automatically add it back once it comes back online.

If all servers you intend to use with the proxy are already in your proxy configuration, starting a server should also work across proxies because the other proxies are already watching the status of this server.