Documentation
Get running without the guesswork.
A compact setup path for Discord authentication, guild permissions, configuration, testing, and recovery.
$ connect discord
$ select guild
$ verify permissions
$ test workflow
✓ ready for production
Connect your account
Sign in with Discord so YSF Utils can identify you and list servers you are allowed to manage. Your Discord access token stays in an HTTP-only cookie.
- OAuth state validation
- HTTP-only session cookies
- No password collection
Select a guild
Open the dashboard and choose a server where you have management permissions. Only guilds you can manage should appear in operational views.
- Manage Server / owner checks
- Server-scoped dashboard
- Safe reconnect flow
Review bot permissions
Keep the bot role high enough to do its job, but avoid Administrator when narrower permissions are enough. Least privilege makes mistakes smaller and recovery easier.
- Role hierarchy check
- Channel override review
- Least-privilege setup
Configure and test
Save one change at a time, verify the guild health checklist, and test in a private channel before enabling a workflow for the whole community.
- Small reversible changes
- Private-channel testing
- Health verification
05 · Troubleshooting
Fast checks before opening a ticket
- A guild is missing
- Confirm you are signed into the intended Discord account, verify Manage Server permission, then sign out and reconnect.
- A command is denied
- Review channel overrides and the bot role position. Channel-level rules can override server-level permissions.
- Setup still fails
- Check the public status page, then contact support with the guild ID, affected workflow, and timestamp. Never send a token, password, or secret.