Skip to main content

​
Purge

Bulk delete messages with statistics and witty commentary. 
/purge amount:<2-100>
​
amount
integer
required
Number of messages to delete (2-100)

​
Features

  • Bulk Deletion: Delete up to 100 messages at once
  • Age Filtering: Automatically skips messages older than 14 days (Discord limitation)
  • Statistics Tracking: Shows who sent the most deleted messages
  • Contextual Humor: Jill’s commentary adapts based on the “top offender”
  • Visual Feedback: Includes cleanup image and detailed embed

​
Example Output

Deleted 47 messages.

"half of this trash belonged to @User. Get a hobby."

The Noise Makers:
@User1: 23
@User2: 12
@User3: 8
Requires permission configuration. Default: Manage Messages

​
Audit

Access server diagnostics and forensic tools for role management. 
/audit
Opens an interactive forensics suite with multiple scan modules.

​
Audit Modules

​
Empty Node Scan

Identifies roles with zero members. Features:
  • Lists all empty roles
  • Excludes managed roles (bots, integrations)
  • Excludes @everyone
  • Interactive checklist for deletion
  • Batch deletion capability
  • Position-sorted display

​
Identity Isolation

Tracks roles assigned to only one member. Use Cases:
  • Find personal/custom roles
  • Identify potential role cleanup targets
  • Verify single-user permissions

​
Structure Analysis

Visualizes role hierarchy by position. Shows:
  • Top 15 roles by position
  • Position numbers for precise /role move commands
  • Hierarchy overview
The audit interface uses buttons to switch between modules:
  • Scan Empty Nodes: Find unused roles
  • Check Isolations: View single-user roles
  • Analyze Structure: See hierarchy
  • Return: Go back to main menu
Requires permission configuration. Default: Administrator

​
Role

Complete role management suite with create, delete, edit, move, assign, and list capabilities.

​
List Roles

/role list
Displays all server roles sorted by position with indicators. Features:
  • Position numbers (for use with /role move)
  • Hoisted role indicators (🚩)
  • Mention-formatted display
  • Pagination support

​
Create Role

/role create name:<name> hex:<color> [icon:<attachment>] [hoist:<true/false>] [mentionable:<true/false>]
​
name
string
required
Name of the role
​
hex
string
required
Hex color code (e.g., “FF0055”)
​
icon
attachment
Role icon image (requires Server Level 2)
​
hoist
boolean
default:"false"
Display separately from online members
​
mentionable
boolean
default:"false"
Allow anyone to @mention this role
Features:
  • Preview embed before creation
  • Confirmation button
  • Icon support for boosted servers
  • Color preview
  • Base64 icon encoding

​
Delete Role

/role delete target:<@role>
​
target
role
required
The role to delete
Safety:
  • Confirmation required
  • Hierarchy checks (can’t delete roles above yours)
  • Bot hierarchy validation
  • Irreversible warning

​
Edit Role

/role edit target:<@role> [name:<new name>] [color:<hex>] [icon:<attachment>] [hoist:<true/false>] [mentionable:<true/false>]
​
target
role
required
The role to edit
All other parameters are optional. Only specified fields will be updated. Features:
  • Partial updates supported
  • Icon replacement for Level 2 servers
  • Hierarchy validation
  • Change summary in response

​
Move Role

/role move target:<@role> position:<number>
​
target
role
required
The role to move
​
position
integer
required
New position number (see /role list)
Use:
  1. Run /role list to see position numbers
  2. Use /role move with desired position
  3. Role hierarchy updates instantly

​
Assign Role

/role assign role:<@role> user1:<@user> [user2:<@user>] [user3:<@user>] [user4:<@user>] [user5:<@user>]
​
role
role
required
The role to assign
​
user1
user
required
First user to receive the role
Features:
  • Bulk assignment (up to 5 users at once)
  • Preview with avatars
  • Confirmation required
  • Success counter
All role commands require Manage Roles permission or higher.

​
Ghost

Data integrity and forensics for database cleanup. 
/ghost
Opens the data integrity protocol interface.

​
Ghost Scan Modules

​
Scan Emotes

Cross-references emoji database with current server emojis. Finds:
  • Emojis in database but deleted from server
  • Orphaned usage statistics
  • Ghost emoji IDs
Actions:
  • View discrepancy report
  • Purge dead entries from database
  • Clean up emoji statistics

​
Scan Patrons

Cross-references drink database with current members. Finds:
  • User IDs in drink logs who left the server
  • Orphaned patron statistics
  • Ghost user records
Actions:
  • View missing patron list
  • Delete records for departed users
  • Maintain database hygiene

​
Use Cases

  • Database Maintenance: Keep statistics accurate
  • Storage Optimization: Remove orphaned records
  • Integrity Checks: Verify data consistency
  • Migration Cleanup: Clean up after server changes
Requires permission configuration. Default: Administrator

​
Selfmute

Banish yourself to the shadow realm with combined blind + timeout. 
/selfmute minutes:<1-10080>
​
minutes
integer
required
Duration in minutes (1-10080 = 1 week max)

​
How It Works

  1. Role Creation (first use only):
    • Creates “Jill-Blind” role
    • Denies VIEW_CHANNEL on all channels
    • Positions role below bot’s highest role
  2. Application:
    • Assigns Jill-Blind role
    • Applies Discord timeout
    • Saves to database
  3. Removal (automatic):
    • Bot checks database every minute
    • Removes role when timer expires
    • Clears timeout

​
Features

  • Total Isolation: Can’t see channels OR send messages
  • Self-Imposed: Only you can trigger it on yourself
  • Automatic Removal: No manual intervention needed
  • One-Time Setup: Role persists across uses
  • Database Tracking: Survives bot restarts

​
Example

/selfmute minutes:30
Response: 
🌑 You should mute yourself, NOW!
You are blinded and muted for 30 minutes.
(See you at 3:45 PM)
This is a voluntary self-moderation tool. Users can only mute themselves, not others.

Build docs developers (and LLMs) love

Get started for freeTalk to us