Utility Commands¶
General-purpose tools for server information, polls, announcements, reminders, and timestamps.
Server Information — /utility¶
/utility serverinfo¶
Display comprehensive server information: leadership contact, member count, roles, channels, boost level, features, and creation date.
/utility userinfo [user]¶
Display user profile information.
| Parameter | Type | Required | Description |
|---|---|---|---|
user |
Member | No | User to look up (defaults to yourself) |
Shows account creation date, join date, status, roles, and avatar.
/utility roleinfo <role> [options]¶
Display role metadata and, for moderators, filtered role-member dumps.
| Parameter | Type | Required | Description |
|---|---|---|---|
role |
Role | Yes | Role to inspect |
include_member_dump |
Boolean | No | Include roster preview in response |
include_bots |
Boolean | No | Include bots in dump/export |
granted_on_after |
String | No | Lower date bound (YYYY-MM-DD or YYYY-MM-DD HH:MM) |
granted_on_before |
String | No | Upper date bound (YYYY-MM-DD or YYYY-MM-DD HH:MM) |
held_for_min |
String | No | Minimum held time (30d, 12h, 90m) |
held_for_max |
String | No | Maximum held time (365d, 48h) |
sort_preset |
Choice | No | Explicit sort mode (held_longest, granted_newest, etc.) |
sort_by |
Choice | No | Custom sort field |
sort_order |
Choice | No | Ascending/descending for custom sort |
custom_filter |
String | No | User-defined query clauses |
export_csv |
Boolean | No | Attach CSV of filtered result set |
limit |
Integer | No | Max rows shown in embed preview |
Permission
Advanced roster filters and exports are moderator-only.
Custom Filter Query Format¶
Use semicolon-separated clauses (;) in field operator value format.
Supported operators: =, !=, >, >=, <, <=, ~.
Supported fields: display_name, username, user_id, bot, has_nickname, granted_on, held_for.
Aliases: name, id, userid, joined, joined_on, held.
Polls — /poll¶
Interactive voting system with real-time result updates.
/poll create <question> <option1> ... [option20]¶
Create a poll with up to 20 options.
| Parameter | Type | Required | Description |
|---|---|---|---|
question |
String | Yes | The poll question |
option1 |
String | Yes | First option |
option2..20 |
String | No | Additional options |
Supports single-vote and multi-vote modes, anonymous or visible voting, and optional auto-close timer.
/poll close <poll_id>¶
Close a poll and archive results.
| Parameter | Type | Required | Description |
|---|---|---|---|
poll_id |
Integer | Yes | Poll to close |
Permission
Requires admin or moderator role.
Announcements — /announce¶
/announce create <channel> <message> [title]¶
Send a text announcement to a channel.
| Parameter | Type | Required | Description |
|---|---|---|---|
channel |
TextChannel | Yes | Target channel |
message |
String | Yes | Announcement text |
title |
String | No | Optional title |
/announce embed <channel>¶
Opens a modal to build a custom embed announcement with title, description, colour (hex), and footer.
Reminders — /remind¶
/remind me <duration> <message>¶
Set a personal reminder.
| Parameter | Type | Required | Description |
|---|---|---|---|
duration |
String | Yes | Time until reminder (10s, 5m, 2h, 1d) |
message |
String | Yes | Reminder text (max 1000 chars) |
/remind list¶
List all your active reminders with IDs and time remaining.
/remind cancel <id>¶
Cancel a reminder by ID.
Timestamps — /timestamp¶
/timestamp [day] [month] [year] [hour] [minute] [second] [format]¶
Generate a Discord timestamp code. All parameters are optional and default to the current time.
Formats: R (relative), F/f (full date), D/d (date), T/t (time).
/countdown <days> <hours> <minutes> <label>¶
Create a countdown to a future time. Returns both relative and full timestamp displays.