Using the exaroton Discord bot

The exaroton Discord bot enables you to display your live game server status on your Discord server and to allow your players to start your server whenever they want.

Quick-start

Step 1: Inviting the bot to your Discord server

You can use this link to invite the exaroton bot to your Discord server: https://discord.com/oauth2/authorize?client_id=833825964080889886&scope=bot%20applications.commands&permissions=330752

By adding this bot to your Discord server, you agree to our privacy policy.

Step 2: Linking your Discord account to your exaroton account

You can link your Discord account in the exaroton account settings.

Screenshot_from_2021-04-20_22-10-44.png

Step 3: Adding your game server to your Discord server

Use the command /link <server> to link your server to your Discord server.

Example

/link example.exaroton.me

Step 4: Create an embed for your game server

Use the command /embed <server> to create an embed for your game server.

Example

/embed example.exaroton.me

Embeds always show the current status of your server. Buttons in the embed message can be used to start, stop, or restart the server.

Screenshot_from_2021-10-21_12-35-13.png

We recommend creating a separate channel for your server information and embed, in which regular Discord server members are not allowed to send messages. This way, your embed always remains visible and can easily be found by your players.

Step 5: Allow other people to start your server

To use your server embed or commands to control your server, other people need your permission.

You can use the command /server-permissions add <server> <role> <permission> to give certain roles permission to control your server.

Example

/server-permissions add example.exaroton.me @everyone start

You can also allow people to stop, restart or embed your server, or execute in-game commands.

Unlinking servers

You can unlink game servers from your Discord server using the command /unlink <server>.

Example

/unlink example.exaroton.me

A game server is also unlinked automatically if the person who linked it leaves the Discord server or unlinks their Discord account from their exaroton account.

Status pings

In addition to the embed that is always shows the current status of your server, you can set up a channel where a message is posted every time the server is started or stopped and mention a specified Discord role.

/status-ping set <server> <channel> [<online-message>] [<online-ping-role>] [<offline-message>] [<offline-ping-role>]

Options

  • Server: The game server this applies to
  • Channel: The Discord channel to send the messages in
  • Online message: The message to send when the server goes online (default message if not specified)
  • Online ping role: The Discord role to mention when the server goes online
  • Offline message: The message to send when the server goes offline (default message if not specified)
  • Offline ping role: The Discord role to mention when the server goes offline

Placeholders

Both the offline and online message can contain placeholders to dynamically add additional information. Placeholders can be added by adding {{placeholder-name}} anywhere within your message, where placeholder-name is one of the names listed below:

  • server-name: The name of the game server
  • server-address: The default server address
  • server-host: The hostname of the host the game server is running on
  • server-port: The port currently used by the server
  • server-dyn-ip: The current DynIP of the game server (See Connect to your server)
  • server-motd: The MOTD of the game server
  • software-name: The name of the server software used (e.g. PaperMC)
  • software-version: The version of the server software (e.g. 1.21.4)

More commands

The exaroton bot offers some other, more advanced features. To get a full list of all available commands, use /help. You can also show more information about a specific command using /help <command>.

 

 

Related articles