Staffly

How to Use Staffly

A quick guide to getting set up and using the bot day-to-day.

Getting Started

Invite Staffly to your server from the home page. It sets itself up automatically, no commands needed. Once invited, the server owner (or a Discord Administrator) can log in at StafflyBot.com with Discord, and it'll already be listed under "Your servers."

Setting Up Tracking

Open your server's dashboard and go to Settings. From there you can:

  • Choose which roles count as "staff" (Tracked Roles): only members with one of these roles are tracked
  • Optionally limit tracking to specific channels, or ignore certain roles/channels entirely
  • Tune spam and AFK detection thresholds
  • Set a Log Channel and a Staff Channel for notifications and flag reviews

Changes take effect within a few minutes automatically, or immediately by running /sync in Discord.

Setting Quota Targets

On the Quota Policies tab, add one row per role with a voice-hour and message-count target and how often it resets (daily, weekly, monthly, or manual). Staff automatically get a DM when they hit their quota for the period.

Discord Commands

  • /setup: re-confirms the dashboard connection (rarely needed, since joining does this automatically)
  • /sync: forces an immediate refresh of settings, quotas, and tracked members
  • /myquota: any staff member can check their own progress
  • /quota-reset-all: resets quota for every tracked staff member at once and posts the pass or fail report. It asks you to confirm first. This is how you reset when the quota period is set to Manual
  • /quota-reset: manually resets a staff member's current period (also clears their flags)
  • /apply: apply for a position, when applications are open (Beta)
  • /promote and /demote: move someone along your rank order. Needs Manage Roles, or a role chosen in the Promotions settings (Beta)
  • /loa: request a leave of absence with a start and end date (and an optional reason). Staff only. Your server leadership approves or denies it, and Staffly won't flag you for inactivity while approved leave is active
  • /addadmin and /removeadmin: server owner only, grants or revokes an individual's dashboard access

Flags

Staffly raises a flag automatically in three situations:

  • Spam: sending too many messages too quickly. Staffly first posts a friendly reminder in the channel asking you to slow down, and only flags after repeated warnings
  • Voice AFK: sitting inactive in a voice channel. You get a DM warning first, and if it continues you're flagged and removed from the voice channel
  • Inactivity: no tracked activity for the number of days set in Settings. Anyone on an active leave of absence is skipped

If a Staff Channel is set, each flag posts there with its Flag ID and a button to mark it reviewed or reopen it, no need to open the dashboard. Flags are also listed on the Flags tab and on the Overview tab under "Needs attention," and they clear automatically whenever that person's quota period resets.

Beta features

Applications and Promotions are in beta. They are free, and stay hidden until you switch them on under Settings. Each one then gets its own tab with its own settings.

  • Applications: add the positions people can apply for and the role each one gives, write up to five questions, and choose a review channel. Members run /apply, and you accept or deny with the buttons on each application. Accepting gives the role automatically.
  • Promotions: set your rank order, then use /promote and /demote to move people along it. You can limit how far one change can go, add a cooldown, require a reason, and announce changes in a channel.

Staffly needs a role higher than the roles it gives out. Move the Staffly role above them in Server Settings, Roles.

Controlling Who Can Manage the Dashboard

By default, the server owner and anyone with Discord's Administrator permission can access the dashboard. On the Access Control tab (owner only), you can also grant access to specific roles or to individual people by Discord user ID, or use /addadmin in Discord to grant it to an individual person. Admins can edit everything else, but only the owner can decide who else gets access.

Need More Help?

Questions not covered here? Reach out through our support channels, or see our Terms of Use and Privacy Policy for policy questions.