Documentation

Setup notes for owners and admins.

A practical starting point for connecting bots, enabling modules and operating Kickoff competitions.

Guides

Connect a Discord bot

Create or select a bot profile, add the token, verify access and confirm detected servers.

Configure Kickoff

Open the Kickoff admin page, create a competition, manage registrations and publish the live hub.

Kickoff flow

Create competition, open sign-up, accept players, run check-in, assign teams, generate fixtures and resolve scores.

Use server admin tools

Review detected members, roles, channels and categories before applying permission changes.

Permissions checklist

Check Administrator, role hierarchy, Manage Roles, Manage Channels, View Channels and Send Messages before live edits.

Rotate a token

Generate a new token in Discord, update the bot profile and verify that server resources load again.

Troubleshooting

Use health checks, notifications, action queue results and audit logs to diagnose token, permission and sync issues.

Troubleshooting assistant

A guided premium support flow for the most common setup and module problems.

Bot not online

Check bot token, Discloud process, BOTFORGE_API_URL, BOTFORGE_AGENT_SECRET and module manifest sync.

Server resources missing

Verify bot is invited to the guild, has Administrator or required permissions, and role hierarchy is above managed roles.

Queued action stuck

Open Action Queue, check bot heartbeat, retry once, then inspect module action result and bot logs.

Player cannot report score

Confirm Discord OAuth login, player is registered in the competition, and the match belongs to their Discord user ID.

White-label domain issue

Check custom domain DNS, Discloud domain attachment, HTTPS status and the white-label hub domain setting.

Premium limits

Billing controls bot count and staff seats now; module, actions, storage and server limits are visible for enforcement.