FCBot

Installation & Commands

Quick install

Click Add to Discord and choose your server. For the easiest setup choose Administrator in the OAuth grant; if you prefer, you can grant a minimal set of permissions: Manage Roles, Manage Channels, and Send Messages.

We no longer provide an auto-configure flow. Instead, use the bot's /set_channel command to map the following suggested channels after installation.

Recommended server layout

  • #apply_here — Apply button target (/set_channel apply_here <#channel>)
  • #matches — match publishing & RSVP collection (/set_channel matches <#channel>)
  • #bot-logs — operational logs (/set_channel bot_logs <#channel>)
  • #welcome — welcome text and instructions (/set_channel welcome_info <#channel>)

Available commands

The following manager/admin commands are available once the bot is installed. Use these from your server's chat.

/applybutton       — Managers only: post the Apply Here message for trialists
/match_new         — Create a match; optionally choose a publish channel
/purge             — Managers only: delete all messages in this channel (fast)
/reload_config     — Reload dashboard/base config at runtime
/set_channel       — Managers only: persist a guild channel for bot use (keys: bot_logs, apply_here, welcome_info)
/squaddepth        — Show squad depth (ephemeral)
/welcome           — Managers: post welcome info here and ensure the Apply button exists
/resync_guild      — Admin: force sync app commands to a single guild by id

Publishing teamsheets

From the dashboard, drag players onto the pitch and click Publish teamsheet to Discord. The bot posts the image back to the match channel and removes the RSVP/match entry. Use the publish_channel option to target a different channel when creating the match.

Troubleshooting & tips

  • If commands don't appear in a guild, run /resync_guild <guild_id> from an administrator account or restart the bot process to force a sync.
  • Check the bot's permissions and that its highest role is above the roles it needs to manage.
  • Use /set_channel bot_logs <#channel> to configure the bot-logs destination.