Documentation
Getting started with YSF Utils
A practical setup path for Discord authentication, guild permissions, configuration, and troubleshooting.
1. Connect your account
Sign in with Discord. YSF Utils requests identity and guild-list access so the dashboard can display servers you are allowed to manage. Your Discord access token stays in an HTTP-only cookie.
2. Select a guild
Open the dashboard and choose a server where you have management permissions. If a server is missing, confirm your Discord permissions and refresh the connection.
3. Review bot permissions
Place the bot role high enough to manage only the roles and channels required by your workflow. Avoid granting Administrator when narrower permissions are sufficient.
4. Configure and test
Save one change at a time, use the guild health checklist, and test in a private channel before enabling the workflow for the whole community.
Troubleshooting
- A guild is missing
- Confirm that you are signed into the intended Discord account and have Manage Server permission, then sign out and reconnect.
- A command is denied
- Review channel overrides and the bot role position. Discord channel permissions can override server-level permissions.
- Setup still fails
- Check the public status page, then contact support with the guild ID, affected workflow, and a timestamp. Never send a token or password.