discord.py 2.x · mongodb · python 3.10+
fusion
documentation
A complete reference for all bot modules and slash commands. Built for staff management, moderation, and server automation.
slash commands
all features free
prefix:
/
⚠️
Infractions
4 commandsTrack and manage staff rule violations with a centralized log. Supports custom infraction types, predefined reasons, approval flows, and automatic expiration.
/infraction issue
Issue an infraction to a staff member
▶
Syntax/infraction issue [user] [type] [reason] [expiration]
| Option | Required | Description |
|---|---|---|
| user | required | The staff member to infract. |
| type | required | Infraction type — Add Role, Remove Role, Channel, Removal From Staff Database, Remove From Group, Change Group Role. |
| reason | required | Reason for the infraction. Can select from predefined reasons. |
| expiration | optional | Duration after which the infraction expires automatically. |
Infraction types:
Add Role — Adds a Discord role to the user.
Remove Role — Removes a Discord role from the user.
Channel — Sends the infraction log to a different channel.
Removal From Staff Database — Removes user from the Staff Panel module.
Remove From Group / Change Group Role — Roblox integration only.
Add Role — Adds a Discord role to the user.
Remove Role — Removes a Discord role from the user.
Channel — Sends the infraction log to a different channel.
Removal From Staff Database — Removes user from the Staff Panel module.
Remove From Group / Change Group Role — Roblox integration only.
/infraction view
View and manage a specific infraction
▶
Syntax/infraction view [id]
Opens an interactive panel — allows voiding, editing, or reviewing the infraction. If "Notify on Void" is enabled, the staff member is notified when their infraction is voided.
/infraction list
View infractions for a user or the server
▶
Syntax/infraction list [user]
No user specified → shows all infractions for the server. With a user → filters to that user's history only.
/infraction multiple
Infract multiple users at once
▶
Syntax/infraction multiple [users] [type] [reason]
Issue the same infraction to multiple staff members simultaneously. Useful for mass moderation events.
⭐
Promotions
3 commandsPromote and recognize staff achievements. Supports three systems: OG System (free Discord role select), Single Hierarchy (structured role ladder), Multi Hierarchy (multiple departments with own ladders).
/promote
Promote a staff member to the next role
▶
Syntax/promote [user] [reason] [department]
| Option | Required | Description |
|---|---|---|
| user | required | Staff member to promote (or demote). |
| reason | optional | Reason for the promotion. |
| department | optional | Specific department (Multi Hierarchy only). |
In Single/Multi Hierarchy mode, the bot automatically assigns the correct next role. You can also use this to demote by selecting a lower role.
/promotion view
View details about a specific promotion
▶
Syntax/promotion view [id]
/promotions
List all promotions for a specific user
▶
Syntax/promotions [user]
📊
Message Quota
7 commandsTrack staff activity by counting messages and displaying results on a leaderboard. Staff are automatically categorized as Passed, Failed, or On LOA based on activity.
/quota messages
View your current message count
▶
Syntax/quota messages
Shows your personal message count for the current quota period and progress toward the minimum requirement.
/quota manage
Manually manage staff message counts
▶
Syntax/quota manage [user]
/staff leaderboard
View the staff message leaderboard
▶
Syntax/staff leaderboard
Ranks all staff members by message count for the current quota period.
/quota reset
Reset message counts for all staff members
▶
Syntax/quota reset
⚠️ Resets all message counts to zero. Use at the start of a new quota period.
/quota export
Export staff message data as a CSV file
▶
Syntax/quota export
Downloads a CSV with all staff members and their message counts. Useful for record-keeping or external analysis.
/quota activity view
View staff activity results
▶
Syntax/quota activity view
Shows staff categorized as Passed, Failed, or On LOA based on message activity for the current period.
/quota activity wave
Auto-issue infractions based on activity results
▶
Syntax/quota activity wave
⚠️ Triggers an automated infraction wave — issues infractions to all staff who failed the quota. Confirm before running.
💬
Staff Feedback
3 commandsLet server members rate and give feedback on staff performance. Enable "Multiple Feedbacks" to allow members to submit more than one entry per staff member.
/feedback give
Give a staff member feedback
▶
Syntax/feedback give [user] [rating] [comment]
| Option | Required | Description |
|---|---|---|
| user | required | The staff member to rate. |
| rating | required | Numeric rating (e.g. 1–5). |
| comment | optional | Additional comment alongside the rating. |
/feedback rating
View feedback ratings for a staff member
▶
Syntax/feedback rating [user]
/feedback remove
Remove feedback from a staff member
▶
Syntax/feedback remove [user] [id]
🏖️
LOA (Leave of Absence)
6 commandsAllow staff to temporarily step away without losing rank or permissions. Active LOA members are automatically exempt from message quota counting.
/loa request
Request a Leave of Absence
▶
Syntax/loa request [duration] [reason]
Submits an LOA request. Once approved, the LOA role is assigned and message counting is paused for the duration.
/loa admin
Manage a staff member's LOA status
▶
Syntax/loa admin [user] [action]
Approve, deny, or end a staff member's LOA. All actions are logged to the LOA Audit Channel.
/loa manage
Manage your own active LOA
▶
Syntax/loa manage
Allows a staff member to extend or end their own active Leave of Absence.
/loa active
View all currently active LOA requests
▶
Syntax/loa active
/loa history
View the history of LOA requests
▶
Syntax/loa history [user]
/loa pending
View all pending LOA requests awaiting approval
▶
Syntax/loa pending
💡
Suggestions
1 commandLet server members submit suggestions and ideas. All suggestions are posted to the configured channel for staff to review.
/suggest
Submit a suggestion for the server
▶
Syntax/suggest [suggestion] [image]
| Option | Required | Description |
|---|---|---|
| suggestion | required | Your suggestion or idea text. |
| image | optional | Attach an image to support your suggestion. |
📩
Modmail
9 commandsDirect DM-based communication between users and staff via the bot. Supports Threaded Modmail or Channel Modmail. Users simply DM the bot — no command needed to open a thread.
/modmail reply
Reply to an active modmail thread
▶
Syntax/modmail reply [message]
If "Auto Message" is enabled in config, any message sent in the modmail channel is automatically forwarded — no command needed.
/modmail alert
Get pinged for the next modmail message
▶
Syntax/modmail alert
/modmail close
Close a modmail conversation
▶
Syntax/modmail close
Closes the active modmail thread. A transcript is automatically sent to the configured transcripts channel.
/modmail blacklist unblacklist
Block or unblock a user from using modmail
▶
Syntax/modmail blacklist [user]
/modmail unblacklist [user]
/modmail unblacklist [user]
/modmail snippets
Manage and view modmail snippets (response templates)
▶
Syntax
/modmail snippets create [name] [content]
/modmail snippets edit [name] [content]
/modmail snippets delete [name]
/modmail snippets all
/modmail snippets edit [name] [content]
/modmail snippets delete [name]
/modmail snippets all
Snippets are reusable message templates for common modmail replies. Use
/modmail snippets all to view all available snippets.🤖
Auto Responder
Automatically replies to specific keywords or phrases in your server. Configured entirely through
/config — no slash command to trigger it, it activates automatically.
Configuration options:
Trigger — The keyword or phrase that activates the response.
Response — The message sent when the trigger is detected.
Channel — (Optional) Restrict the auto-responder to a specific channel.
Cooldown — (Optional) Set a cooldown period to prevent spam.
Trigger — The keyword or phrase that activates the response.
Response — The message sent when the trigger is detected.
Channel — (Optional) Restrict the auto-responder to a specific channel.
Cooldown — (Optional) Set a cooldown period to prevent spam.
❓
Daily Questions
Automatically posts a daily question to keep your server's chat active. Configured through
/config.
Configuration options:
Channel — Where the daily question is posted.
Ping — Role or user to notify when a question is posted.
Date / Time — When the question is posted each day.
Threading — Automatically create a discussion thread for each question.
Channel — Where the daily question is posted.
Ping — Role or user to notify when a question is posted.
Date / Time — When the question is posted each day.
Threading — Automatically create a discussion thread for each question.
Daily questions may occasionally be delayed by an hour or more. This is actively being improved.
👥
Staff Panel (Database)
5 commandsCreate a detailed staff database with ranks, timezones, and personal introductions. More detailed than the Staff List — supports full individual profiles. Configure through
/config → Staff Panel./staff add
Add a staff member to the database
▶
Syntax/staff add [staff] [rank] [timezone]
| Option | Required | Description |
|---|---|---|
| staff | required | The staff member to add. |
| rank | required | Their rank or position title. |
| timezone | required | Their timezone (e.g. UTC+2, EST). |
/staff remove
Remove a staff member from the panel
▶
Syntax/staff remove [staff]
/staff edit
Edit an existing staff member's details
▶
Syntax/staff edit [staff] [rank] [timezone] [introduction]
/staff introduction
Set your own staff profile introduction
▶
Syntax/staff introduction [introduction]
Can only be used after you've been added to the database via
/staff add./staff view
View detailed info about a staff member
▶
Syntax/staff view [staff]
Shows the member's rank, timezone, introduction, and other profile details from the database.
📋
Staff List
3 commandsDisplay all staff members and their ranks in a simple, automatically updated list. For detailed profiles, use the Staff Panel instead.
/staff list add
Add a new rank to the staff list
▶
Syntax/staff list add [rank] [position]
| Option | Description |
|---|---|
| rank | The rank name to add (e.g. "Moderator", "Admin"). |
| position | Position in the hierarchy. Lower number = higher rank. |
/staff list remove
Remove a rank from the staff list
▶
Syntax/staff list remove [rank]
/staff list send
Send the staff list embed to a channel
▶
Syntax/staff list send [channel]
Use after all ranks and members have been added. The list updates automatically as changes are made.
🎫
Tickets
14 commandsOrganized support ticket system using panels. Panels can be nested, each with their own category, staff roles, and automation settings.
Available variables in ticket embeds:
{author.mention} {author.name} {time.relative} {time.absolute} {ticket.id}/ticket open
Open a new support ticket
▶
Syntax/ticket open
Creates a new ticket channel in the configured category. Staff with access roles can join and assist.
/ticket close
Close a ticket
▶
Syntax/ticket close
Closes and archives the ticket. Use
/ticket closerequest to request a close rather than force it./ticket closerequest
Request to close a ticket
▶
Syntax/ticket closerequest
Sends a close request to the ticket creator rather than forcing the close immediately.
/ticket claim unclaim
Claim or unclaim a ticket
▶
Syntax/ticket claim
/ticket unclaim
/ticket unclaim
Claiming assigns the ticket to you. Ticket quotas limit simultaneous claims per staff member.
/ticket add remove
Add or remove a user from a ticket
▶
Syntax/ticket add [user]
/ticket remove [user]
/ticket remove [user]
/ticket rename
Rename a ticket channel
▶
Syntax/ticket rename [name]
/ticket panel
Send a ticket panel to a channel
▶
Syntax/ticket panel [channel]
Sends the interactive ticket panel. Users click a button to open a ticket. Panels can be nested inside each other.
/ticket blacklist unblacklist
Block or unblock a user from creating tickets
▶
Syntax/ticket blacklist [user]
/ticket unblacklist [user]
/ticket unblacklist [user]
/ticket stats leaderboard
View ticket statistics and staff leaderboard
▶
Syntax/ticket stats [user]
/ticket leaderboard
/ticket leaderboard
/ticket stats shows individual ticket handling stats. /ticket leaderboard ranks all staff by tickets handled./ticket automation
Toggle ticket automation settings
▶
Syntax/ticket automation
Opens a panel for managing automations — auto-close on inactivity, auto-archive, and other configured rules.