Features4 min read

Control your bots from Discord

Add the MinecraftAFK app to your Discord account and switch macros on or off, connect accounts and send chat with /macro, /account and /chat, from any server or your DMs.

The MinecraftAFK app puts three commands in your Discord: /macro switches a macro on or off, /account connects or disconnects an account, and /chat sends a message from your accounts. You add it to your own Discord account, so the commands go with you into every server and your DMs, and you can check on your bots from your phone without opening the dashboard.

The commands only ever act on your own MinecraftAFK account: the one your Discord is linked to. Nobody else can reach your bots through them, and their replies are only shown to you.

Add the app

  1. Link your Discord first, if you haven't: see Link your Discord account. The commands find your bots through that link.
  2. Visit minecraftafk.com/dashboard/user/settings/ and find the Control your bots from Discord card, under Login methods.
  3. Click Add to my Discord account. Discord opens and asks whether to add the app to your account. Confirm it.

That's it: type / in any Discord chat and the three commands are there. If your Discord isn't linked yet, the card says so and has its own Link Discord button.

Use the commands

Every command offers your own things as you type: start typing a macro, an account or a server and pick it from the list. Each line of the list says where it is and how it's doing, such as "Steve on DonutSMP (online)" or "AFK fishing (DonutSMP, paused)".

Each command has an action: on, off or status. Leave it out and you get the status.

/macro

/macro macro:<one of your macros> action:on|off|status

  • on switches the macro on, the same as its switch on the Macros page. It runs on its trigger from then on.
  • off pauses it.
  • status shows whether it's on, which server it's on, and which accounts it's running on right now.

The list has your macros on every server profile. Spam messages and webhooks aren't macros here, so they aren't listed. A macro locked above your plan's macro limit shows as Locked, and switching it on is refused, as it is on the dashboard. So is a macro the builder marks Unfinished: open it on the dashboard and fill the gap first.

/account

/account account:<one of your accounts> action:on|off|status

  • on connects the account, the same as Connect on the Connect page. The reply says it's connecting; run /account again with status a moment later to see it online.
  • off disconnects it.
  • status shows whether it's Online, Connecting, Queued, Disconnecting or Offline, which server it's on, and the macros running on it.

An account you have on more than one server profile is listed once for each, so pick the one on the server you mean. Connecting is refused for the same reasons the dashboard would refuse it, and the reply says why.

/chat

/chat message:<text> server:<one of your server profiles> account:<one of your accounts>

Sends the message in the server's chat, from every online account on that server profile, or only from account when you pick one. Start the message with / to run a command, such as /spawn or /bal. A message can be up to 256 characters.

  • server is needed when you have more than one server profile. With just one, leave it out.
  • Offline accounts are skipped, and the reply counts them: "Sent from 3 accounts on DonutSMP (1 offline, skipped)". If none are online, nothing is sent.
  • Picking an account without a server sends on the server that account is on.

To read what the server says back, open the Chat page on the dashboard. For a post in Discord when something happens, set up a Discord webhook.

Who sees what

  • Only you see the replies. Every answer is marked "Only you can see this", in a server's channel as well as your DMs. Nobody else in the channel sees the command or its reply, so your bots, servers and messages stay yours.
  • Only your bots. A command acts as the MinecraftAFK account your Discord is linked to. Typing someone else's account or macro name finds nothing.
  • Nothing pings anyone. Names and chat lines in a reply never mention a member or a role.

Some servers turn off apps for their members. If the commands don't show up in a server, use them in your DMs with the app instead.

Too many commands

You can run about 20 commands a minute. Past that, the reply says "You're sending commands too fast" and how many seconds to wait.

Remove the app or switch Discord accounts

  • Remove the app: in Discord, open User Settings, then Authorized Apps, and remove MinecraftAFK. The commands disappear from your Discord. You can add it again any time from the settings card.
  • Stop the commands without removing the app: disconnect Discord under Login methods. Until you link it again, every command answers that your Discord isn't linked, with the steps to link it.
  • Use another Discord account: add the app to that Discord account too, and link that one instead. The commands follow the link, not the app.

Still stuck?

If an account won't connect, Fix connection problems covers every status and warning. Otherwise ask in our Discord, where the team and other players answer, or email support and we will get back to you.