Docs/Plugins

Utility plugin

The Utility plugin provides server management, search, info, message tools, voice helpers, and bot meta commands. All commands are slash commands and gated by can_* config flags.

#Permission flags

FlagCommand(s)
can_search/search, /bansearch
can_clean/clean
can_userinfo/user
can_server/server
can_channelinfo/channel
can_messageinfo/message
can_inviteinfo/invite
can_roleinfo/role
can_emojiinfo/emoji
can_snowflake/snowflake
can_roles/rolelist
can_level/level
can_context/context
can_source/source
can_nickname/nickname
can_vcmove/voice move, /voice move-all
can_vckick/voice disconnect
can_ping/ping
can_about/about
can_help/help
can_reload_guild/reload
can_avatar/avatar
can_jumbo/jumbo
can_info/info

#Settings

KeyDefaultDescription
jumbo_size128Pixel size for /jumbo (max 2048)
autojoin_threadstrueBot auto-joins new threads
info_on_single_resulttrue/search shows user info when exactly one match

#/search

Search members by username or nickname.

OptionDescription
querySearch text
pagePage number
in_voiceOnly members in voice
bots_onlyOnly bots
case_sensitiveCase-sensitive match
regexTreat query as regex
ids_onlyOutput user IDs only
sortname, joined, created, or level

#/bansearch

Search banned users. Requires Ban Members Discord permission.

OptionDescription
querySearch text (required)
pagePage number
case_sensitiveCase-sensitive match
regexTreat query as regex

#Info commands

#/info

Auto-detect target type (channel, role, user, invite, snowflake) from a string.

#/user

User information including infraction and message stats for this server and globally. Message counts are tracked by Dreamliner from when the bot is running. Defaults to yourself.

OptionDescription
memberTarget user
compactShorter output

#/server

Information about the current server.

#/channel

Channel information. Defaults to current channel.

#/message

Message information by ID (current channel).

#/invite

Invite code or URL information.

#/role

Role information.

#/emoji

Custom emoji information.

#/snowflake

Decode a Discord snowflake ID (timestamp, worker, process, increment).

#/rolelist

List server roles.

OptionDescription
countsShow member counts
sortname, position, or memberCount

#/level

Show a member's config permission level.


#Message tools

#/clean

Bulk delete messages. Requires Manage Messages.

OptionDescription
amountMessages to scan (1–100, required)
userOnly from this user
bots_onlyOnly bot messages
pins_onlyOnly pinned messages
contains_inviteOnly messages with invite links
regexContent filter regex
update_caseRecord a mod case entry

Deleted messages are archived to the database. Discord only allows bulk-deleting messages less than 14 days old.

#/context

Link to the message immediately before a given message ID.

#/source

Export full message JSON as a file attachment. Archived in the database.


#Nicknames

#/nickname set

Set a member's nickname (2–32 characters). Requires Manage Nicknames when changing others.

#/nickname reset

Clear a member's nickname.

#/nickname view

Show current nickname.


#Voice

#/voice move

Move a member to a voice channel. Requires Move Members. Logged to moderation_log_channel_id if set.

#/voice move-all

Move all members from one voice channel to another.

#/voice disconnect

Disconnect a member from voice.


#Meta

#/ping

Latency test (roundtrip and WebSocket).

#/about

Bot version, uptime, runtime stats, and loaded plugins, with link buttons for documentation, terms, and privacy.

#/help

Browse every command through a category home screen (Moderation, Roles, Lookups, Automation, Server tools, Configuration).

  • Category menu jumps between topics
  • Command menu opens usage details and options
  • Home / Back / Previous / Next for navigation, plus a Docs link
  • Optional query searches across all commands (e.g. /help query:ban)

#/reload

Hot-reload guild configuration from the database.

#/avatar

Display a user's avatar (2048px).

#/jumbo

Enlarge a custom server emoji. Size from jumbo_size config.


#Events

When autojoin_threads is enabled, Dreamliner automatically joins new public threads so it can read and respond in thread channels.