Getting Started

From a fresh server to a fully configured Sploodji install in about five minutes.

1 · Invite the bot

Use the invite link from the Sploodji landing page. The OAuth2 scopes Sploodji requires are bot and applications.commands. On the permissions page, confirm these are checked:

  • Manage Roles, Manage Channels, Manage Webhooks
  • Send Messages, Embed Links, Attach Files
  • Read Message History, Use External Emojis
  • Moderate Members (verification timer kicks and warnings)
  • View Audit Log (moderation logging)

2 · Check role hierarchy

Drag the Sploodji role above every role you expect the bot to manage. If a verified role, jail role, or quarantine role sits higher than Sploodji, the bot cannot assign or remove it.

3 · Open the dashboard and complete setup

Click Login with Discord on the dashboard's home page. Sploodji only requests the identify and guilds OAuth scopes, and after the callback the code is stripped from the URL while the access token stays in your encrypted session cookie.

Once you're in, pick the server you administer and finish setup from its overview page:

  1. Add at least one admin role.
  2. Add at least one staff role.
  3. Pick the modules you want enabled (verification, tickets, moderation, AutoMod, economy, events, roles, etc.).
  4. Configure log channels for the modules you turn on.
  5. Mark setup complete from the overview.

Per-feature command visibility flips automatically as you enable each module.

4 · Test before opening the server

  • Verification: open a verification ticket as a test account and walk it through to approval.
  • Tickets: post a panel, open a ticket, claim it, close it, confirm the transcript writes to the log channel.
  • Moderation: trigger a warn or timeout against a test account and confirm the mod-case row writes.
  • Roles: post a self-assign menu and confirm the role assignment matches the menu config.

5 · Tour the overview

  • Health warnings: features that are enabled but misconfigured (for example, verification on with no verified role).
  • Feature cards: toggle a feature on or off with the switch, or click Manage to open its detail page.
  • Audit log: every dashboard write is recorded with the actor's user ID, IP, user-agent, and a before/after diff.
  • Permissions: see exactly which Discord permissions Sploodji currently holds in the guild.
  • Scopes: grant non-admin roles fine-grained access to specific dashboard surfaces.
Confirm