utilities & info.

afk saves a status and tries to add [afk] to your nickname. if havoc cannot change the nickname, the status is still active. mentioning an afk member records a link for them, and speaking again clears their afk state without overwriting a nickname someone changed in the meantime.

,afk back after lunch
/afk mentions

statuses may be up to 500 characters. havoc retains at most the latest 50 mention records and only displays records from channels where you can currently view the channel and read message history.

these commands are available to everyone and read current discord data. omitting the member from avatar or user looks up the caller.

use ids when names are ambiguous. avatar returns a direct media url rather than reposting the file, while user and server information are compact text intended for quick checks.

,help utility
,help reactionhistory
/utility ping
/help query: embed edit

uptime resets when the process restarts; it is not the age of the bot account. the invite link itself requests no broad bot permissions, so server administrators can grant only the permissions needed by the modules they use.

snipes are short-lived, in-memory records for the current channel. each cache holds up to 30 deleted messages, edits, and removed reactions, and entries expire after one hour. index 1 is the most recent record; higher indexes walk backward.

callers must be able to view the channel and read its message history. reactionhistory accepts a discord message link and filters the cached reaction removals to that message.

say sends plain text as havoc with all mentions disabled. by default it posts in the current channel. a leading channel mention chooses another channel in the same server, and --replysearches that channel’s latest 100 messages for the named user and replies to the newest match.

,say #announcements Maintenance starts in ten minutes.
,say #support --reply 123456789012345678 Please include the error text.

the reply id must be numeric. reply lookup additionally needs read message history for both havoc and the command runner. if no recent message from that user is found, nothing is sent.

embed commands accept one nonempty json object. use a fenced json block or compact json after the command. the top-level properties below are the complete accepted set; unknown properties are rejected.

::title, description, url, color, timestamp

title is limited to 256 characters, description to 4096, urls must be public http or https, color is a hex value, and timestamp must be an ISO-style discord timestamp.

::author

an object with required name and optional url and icon_url.

::footer

an object with required text and optional icon_url.

::image, thumbnail

an object containing a required public url.

::fields

an array of at most 25 objects with name, value, and optional boolean inline.

,embed create {"title":"status","description":"services are online","color":"#5865f2","fields":[{"name":"region","value":"us-east","inline":true}],"footer":{"text":"updated by staff"}}

field names are limited to 256 characters and values to 1024; footer text allows 2048. all embed text together is limited to 6000 characters, and the object needs visible content. embed json does not substitute placeholder variables: text such as {user} remains literal here.

havoc needs send messages and embed links to create an embed, and embed links in the target channel to edit one. editing accepts only a message authored directly by havoc, not a webhook message. it replaces the existing embed with the validated object.