Engaging your members

The basics live in Setup: pick a channel with /welcome channel, write a template with /welcome message, test it with /welcome test. This sub-section covers the parts you only need once you are running it day-to-day. Template variables, restart safety, and inspection commands.

1. The {user} placeholder is the only template variable, and it expands to a Discord mention of the new member at post time. That mention pings them, which is what causes their client to highlight your welcome channel as having unread activity. Drop it anywhere in the template:

   /welcome message template:"Hey {user}, welcome. Read #rules first, then say hi in #general."

   You can use it multiple times in one template ("Hey {user}! {user}, here is what to do first.") but doing so pings the member twice. Usually once is plenty.
2. Inspect the current config before you change anything:

   /welcome show

   The bot prints the configured channel, the current template, and whether the flow is enabled or disabled. Use this when you take over a guild from another mod and want to see what is already set up.
3. Preview a real post without waiting for someone to actually join:

   /welcome test

   The bot posts the template to the configured channel exactly the way it would for a genuine guildMemberAdd event. The {user} placeholder expands to your own mention, so you can read what the message looks like and what a real new member would see.
4. Disable temporarily without losing the config:

   /welcome disable

   The channel and template stay saved. New joins do not produce a post. Re-run /welcome channel to turn it back on later; the saved template is still there.

The flow is restart-safe by design. When the bot reboots, Discord sometimes re-fires guildMemberAdd for members who joined right before the restart. Without protection, those members would get greeted twice. The bot keeps a per-member dedup record with a 1-hour TTL, so a re-fire within an hour is suppressed. The original welcome stands; no double-post.

After the hour passes, the dedup expires. That is intentional. If a member legitimately leaves the guild and rejoins later in the day, they get a fresh welcome, which is the right behavior; they are a returning member and the greeting should reflect that.

The birthday tools turn member birthdays into a recurring small-celebration moment in the guild. Members opt in by registering their birthday with the bot. Once a day, the bot scans for matches and posts a shoutout in the channel you configured. No mod has to remember anything. The whole flow is opt-in, so members who do not want a public birthday post simply do not register one.

1. Pick the shoutout channel as a mod with Manage Server:

   /birthday channel channel:#birthdays

   Every daily shoutout lands in #birthdays. Pick a channel that fits the energy of the moment; #general works fine if you are a small guild.
2. Members register their own birthday with the day in MM-DD format. Year is intentionally not collected:

   /birthday set day:03-14

   The bot stores the registration scoped to this guild and confirms back to the member. Members can re-run this any time to update it, which matters if someone fat-fingered the date the first time.
3. Look up a friend's birthday if they have registered one:

   /birthday check user:@Friend

   The bot returns the friend's saved date, or a "not registered" message if they have not opted in. There is no way to see a date someone has not chosen to share.
4. The daily scan runs once per day on a cron schedule. It queries every birthday with today's MM-DD and posts one shoutout per matching member in the configured channel. If three members share a birthday, three shoutouts post, one after the other.

Behind the scenes, the bot stores birthdays in a per-guild, per-user record keyed on MM-DD. That lets the daily scan be a single efficient query ("find all birthdays on 03-14") instead of a scan over every member's data. Year is not stored because age is sensitive information and not needed for the shoutout. The member knows how old they are; the guild does not need to.

If you want to turn announcements off guild-wide, a mod with Manage Server can run /birthday disable. Stored birthdays are kept and the daily scan simply stops posting; re-enable any time with /birthday enable. Any member can delete their own stored birthday at any time with /birthday remove, no mod involvement needed.

Temporary voice channels solve the "all our rooms are either empty or full" problem. You designate one voice channel as a join-to-create hub. When a member joins it, the bot instantly spins up a personal voice channel for them, moves them into it, and deletes it again the moment the last person leaves. Members get a private room on demand without a mod making channels by hand, and your channel list never fills up with abandoned rooms.

1. Pick the hub channel as a mod with Manage Server. Make an ordinary voice channel first (call it something like "➕ Join to Create"), then point the bot at it:

   /voice hub channel:#Join to Create

   From now on, anyone who joins that channel triggers the create-and-move flow. The hub itself stays empty; it is only a trigger.
2. Members just join the hub. No command required. The bot creates a channel named after them ("Alex's Channel") in the same category, moves them in, and posts an owner control panel into the new channel's text chat. When everyone leaves, the bot deletes the channel automatically. If a member leaves and rejoins the hub within a few seconds, they land back in their existing room instead of getting a duplicate.
3. The owner controls their own room from the panel the bot posts. Only the member who created the channel can use the buttons:
   • Rename (✏️) opens a text box to retitle the channel.
   • User limit (👥) caps how many people can join, from 2 up to 99, or removes the cap entirely.
   • Kick (🚪) disconnects someone from the room.
   Every response is private to the owner, so the panel does not clutter the channel.
4. Inspect or turn it off as a mod. /voice show prints the configured hub and any live temp channels (anyone can run it). /voice disable clears the hub so no new channels are created; rooms that already exist are left alone to empty out naturally.

Everything here is per-guild and free. The only setup cost is the one-time /voice hub call. There is no per-member configuration and nothing for mods to clean up afterward.

Voice activity stats reward the people who actually show up in voice. When you turn the feature on, the bot quietly tracks how long each member spends in voice channels and exposes a leaderboard and per-member ranks. It is opt-in per guild and off by default, so existing servers do not suddenly start counting time without you asking.

1. Turn tracking on as a mod with Manage Server:

   /voice stats-enable

   From that point, qualifying voice time accrues for every member. Turning it back off with /voice stats-disable stops new counting but keeps every total already recorded; re-enabling later picks up where it left off.
2. See the leaderboard (any member can run it):

   /voice leaderboard
   /voice leaderboard window:this-week

   The default window is all-time; pass window:this-week for a rolling weekly board. Either way the bot shows the top ten members by time spent in voice.
3. Check one member's rank with the optional user option, defaulting to yourself:

   /voice rank
   /voice rank user:@Friend

   The reply is that member's total voice time and their position on the board.

Time only counts when it represents real participation. A member accrues time when they are not in the AFK channel, not self-deafened, and there is at least one other person in the channel with them. Sitting alone in a channel, or sitting deafened, does not pad anyone's numbers. All-time totals are kept permanently; the weekly window rolls off after 90 days.

Message leveling turns regular chatting into a visible progression. Members earn XP for posting, level up on a curve, and can compare standings on a leaderboard. It runs entirely on Discord events and the database (no AI tokens are spent), so it is free and instant. Like voice stats it is opt-in per guild and off by default.

1. Switch it on as a mod with Manage Server:

   /level enable

   Members start earning XP immediately. /level disable stops new XP but preserves everyone's existing totals, so toggling the feature never wipes progress.
2. Members track their own progress:

   /level rank
   /level rank user:@Friend

   The reply shows the member's current level, total XP, how far they are into the next level, and their rank in the guild. Omit the user option to see yourself.
3. See the standings (open to any member):

   /level leaderboard

   The bot lists the top ten members by total XP, with medals for the top three.
4. Tune the economy as a mod. Each control is its own command, and /level show prints the current settings:

   /level xp-per-message amount:15
   /level cooldown seconds:60
   /level voice-xp-per-minute amount:10
   /level announce enabled:true
   /level channel channel:#level-ups

   The defaults are 15 XP per message, a 60-second message cooldown, and 10 XP per minute of active voice. Level-up announcements are on by default and post in the channel where the member levelled up; set /level channel to funnel them all to one place instead.

Members earn XP two ways: posting messages, and time spent genuinely active in voice. A once-a-minute sweep awards the voice-xp-per-minute amount to anyone who is not in the AFK channel, not muted or deafened, and sharing a channel with at least one other person (set it to 0 to switch voice XP off entirely). Levels follow a gently accelerating curve (each level costs a little more than the last), and a member's level is always computed from their total XP rather than stored, so changing the XP rates re-derives everyone's level consistently. The message cooldown is per member, per guild: only the first message inside each window earns XP.

Personal reminders let any member ask the bot to ping them later (no permissions, no setup). You can set them relative to now or at an exact date and time, and the bot delivers a DM when they fire, falling back to a mention in the channel if your DMs are closed. Scheduled channel announcements for mods are a separate tool, covered just below in scheduled channel announcements.

1. Remind me in a while with a relative duration like 10m, 2h, 3d, or 1w:

   /remind in duration:2h message:"stretch and drink water"

   The bot confirms and fires the reminder two hours later.
2. Remind me at a specific time using YYYY-MM-DD HH:MM in your saved timezone:

   /remind at when:"2026-06-12 19:30" message:"raid night"

   Set your timezone first so the bot knows what 19:30 means for you:

   /util set-timezone tz:America/New_York

   The timezone field has autocomplete, so start typing a city or region and pick from the list.
3. Snooze or dismiss when the reminder arrives. The delivery comes with buttons (+10m, +1h, +1d, and Done) so you can push it back with one tap or mark it handled. Only you can use the buttons on your own reminder.
4. Manage your reminders any time:

   /remind list
   /remind edit id:<id> when:"2026-06-13 20:00"
   /remind cancel id:<id>

   /remind list shows your active reminders with their short IDs; edit and cancel take that ID (with autocomplete) and let you change the time or text, or drop the reminder entirely.

You can have up to 25 active reminders at once per server. Reminders survive a bot restart: if the bot reboots right as one was due, it catches up and fires it on the next start rather than dropping it.

Scheduled messages let a mod queue the bot to post in a channel later, once or on a repeating cadence. It is the tool for "remind everyone of the rules every Monday" or "announce the event at 7pm Friday" without anyone having to be around to hit send. These post to a channel and require Manage Messages, which is what separates them from the personal reminders any member can set.

1. Schedule a one-shot at an exact time, in your saved timezone:

   /schedule once when:"2026-06-13 19:00" channel:#events message:"Movie night starts now in voice."

   The bot posts the message in that channel at that time, then forgets about it.
2. Schedule a recurring post daily, weekly, or monthly:

   /schedule recurring frequency:weekly day:monday time:09:00 channel:#general message:"Weekly check-in: how is everyone doing?"

   For weekly pass a weekday in day; for monthly pass a day number from 1 to 28; for daily, day is ignored. Times are HH:MM in your timezone, and the bot re-schedules itself after each fire.
3. List, edit, and cancel what is queued:

   /schedule list
   /schedule edit id:<id> time:10:00
   /schedule cancel id:<id>

   /schedule list shows every active schedule with its short ID, cadence, and target channel; edit and cancel take that ID, with autocomplete. When you change a recurring schedule's cadence, supply the frequency, time, and day together.

Weekly schedules take a single day, a comma-separated set (mon,wed,fri), or the presets weekdays and weekends, so a weekday-only daily post is one schedule, not five.

Set your timezone once with /util set-timezone so every scheduled time is interpreted correctly. You can keep up to 25 one-shot schedules and 5 recurring ones active per server. The bot checks it can post in the target channel when you create the schedule, so a permissions problem surfaces immediately rather than silently at fire time.

The looking-for-group board is how members rally a squad without spamming @everyone. Anyone posts an LFG card describing what they want to play; others join by clicking a button on the card. The card tracks who is in, counts down "need N more" until the party is full, and expires on its own so the channel does not fill up with stale posts.

1. Post a card in the channel where people look for games:

   /lfg create game:"Overwatch competitive" slots:5 when:"8pm EST" notes:"Diamond+ preferred"

   Only game is required. slots (2–25) sets the target party size: the card shows "need N more" and flips to FULL when reached; omit it for an open-ended post. when and notes are free text, and expires takes a duration like 30m or 2h (default 2 hours, max 12).
2. Members join by button. The card carries a join/leave button; clicking it adds or removes the member and updates the count live. Joiners run no commands; they just click.
3. See what is open, or close a post:

   /lfg list
   /lfg close id:<id>

   /lfg list shows the guild's active cards with their short IDs; /lfg close ends your post early (it closes on its own at the expiry otherwise).

LFG is free and member-driven: any member with slash-command access can post one. A guild is capped at 25 active cards and each member at 3 of their own, so the board stays readable.

Once a group has gathered and it is time to pick sides, the pick-up-game tools form teams so nobody has to be the bad guy doing it by hand. Two modes: a straight random split, or a captain draft. Both can take an explicit list of players or just pull everyone out of a voice channel.

1. Randomly split into even teams:

   /pug split teams:2 channel:#Scrim VC
   /pug split teams:3 players:@A @B @C @D @E @F

   Choose how many teams (2–8, default 2). Pass players as @mentions, or channel to pull everyone currently in that voice channel. The bot shuffles and posts the rosters.
2. Run a captain draft in snake order:

   /pug draft captains:@Captain1 @Captain2 channel:#Scrim VC

   Name the captains as @mentions (that sets the number of teams), or set teams and let the bot pick captains. Players come from players mentions or the named voice channel. The bot walks the draft in snake order (1-2-2-1…) so the first-pick advantage evens out.

Both are stateless, free, and game-agnostic, handy for any scrim, game night, or "let us just run customs." Pulling from a voice channel is the fast path: get everyone into the VC, then one command makes the teams.

The fun tools are exactly what they sound like. Light, instant, no setup required. They exist to give members easy ways to break a tie, settle a bet, or post a quick reaction. None of them touch the moderation or AI-access layers; any member who can use slash commands in your guild can use these.

1. Flip a coin when you need a random binary decision:

   /fun coinflip

   The bot replies with heads or tails. The randomness is real (Node's crypto-grade PRNG), not a weighted pick. Both outcomes are equally likely.
2. Pick from a list of options when "heads or tails" is not enough:

   /fun pick options:"option 1, option 2, option 3"

   The command takes a single options parameter containing a comma-separated list of choices. The bot splits on commas, picks one of the supplied options at random, and announces it. Useful for "what should we play tonight?" or "who buys the next round?". Add as many comma-separated entries as you like inside the one string.

None of these tools require permissions beyond the default member ability to use slash commands. None of them store any state. The bot does not remember what coin flips were heads or what options were picked. They are pure stateless utilities by design.

If your guild has channels where casual tools should not be runnable (an announcements channel, say, or a serious-discussion channel), restrict slash-command usage to specific channels using Discord's built-in Integrations settings under server settings. The bot does not need to enforce that itself; Discord's permission system handles it.

Custom lists are named, reusable pick-lists your server saves once and draws from whenever. Think map pools, game-mode rotations, a roster to draw a winner from, or anything else you would otherwise re-type into /fun pick every time. Mods curate the lists; anyone can pick from them.

1. Create or replace a list (Manage Messages):

   /list set name:"maps" items:"Ilios, Lijiang, Oasis, Nepal, Busan"

   Items are comma-separated and de-duplicated. Edit a list in place with /list add name:maps items:"Antarctica" and /list remove name:maps items:"oasis" (matching is case-insensitive), or drop it entirely with /list delete name:maps.
2. Pick from a list (anyone):

   /list pick name:maps
   /list pick name:maps count:3

   The bot draws count distinct items at random (1–25, default 1). Handy for "what map next?" or drawing names without re-typing the pool.
3. Browse what exists:

   /list show name:maps
   /list all

   /list show prints one list's items; /list all lists every saved list with its item count. The name field autocompletes from existing lists everywhere it appears.

Lists are case-insensitive by name and shared across the guild, capped at 25 lists of up to 100 items each. Editing is gated to Manage Messages so a shared map pool cannot be wiped by just anyone; picking and viewing are open to all. For a one-off pick you do not want to save, /fun pick still takes a comma-separated list inline.

Discord's built-in Twitter/X embeds are bad on purpose. The platform deprecated rich previews for X links a while back, so members posting tweets see a stripped-down card with no image and no video. The bot fixes this by quietly watching for Twitter/X URLs and posting a fxtwitter-based embed underneath each one. Original message stays intact. The bot's embed adds the image, the video, and the post text inline.

1. Post a tweet URL the same way you always would:

   https://x.com/SomeAccount/status/1234567890

   The bot detects the URL, fetches a fxtwitter version of the embed, and replies in the same channel with the rich preview. No mod action required. The original poster does not have to use a special command or remember to convert the URL by hand.
2. For non-English tweets, the embed is enough to see the image or video, but not the text. Use the translation command to get an English version:

   /util translate content:https://x.com/SomeAccount/status/1234567890

   The bot detects that the URL is a tweet, fetches the post text via fxtwitter, runs it through the translation pipeline, and posts the translated text in the channel. Source language is auto-detected; target defaults to English. Override the target with the optional target option if you need something else.
3. Translate raw text the same way when there is no URL:

   /util translate content:"今日はいい天気ですね"

   Same command, same auto-detect, same target default. The bot returns the English translation in a single reply.

The auto-unfurl happens for every Twitter/X URL the bot sees in any channel it has read access to. There is no per-guild toggle and no per-channel opt-out. If you do not want the embeds in a specific channel, deny the bot read or send-message permission in that channel and the auto-unfurl stops there.

Translation is decoupled from unfurling on purpose. The unfurl is cheap (a single HTTP fetch to fxtwitter), so doing it on every tweet is fine. Translation is not cheap (it costs LLM tokens), so doing it on every tweet would be wasteful and annoying. Making it on-demand means you spend tokens only on the tweets that actually need translating.

The clip-to-GIF tool is a member-facing utility for turning content into a shareable format. It is not a moderation tool and it does not require any per-guild setup. Any member with slash-command access can run it. It exists because turning a 30-second video clip into a GIF used to require leaving Discord and using a separate app. The bot does it inline.

Extract a GIF from a video tweet when someone posts a Twitter/X URL with embedded video and you want to reuse the clip. The command lives in the /fun group, not /util:

/fun gif url:https://x.com/SomeAccount/status/1234567890

The bot fetches the video, transcodes the first few seconds (or the full clip if it is short enough) into a GIF, and posts the result as a Discord attachment. The conversion runs server-side via ffmpeg, so the member does not need to install anything. The output is a true GIF (not an MP4), so you can right-click it and add it to your Discord favorites.

The tool enforces the file-size limit set by your guild's Discord upload cap. Free guilds cap attachments at 10 MB; boosted guilds get higher caps depending on the boost level. If a video tweet is longer than the GIF conversion can fit inside your cap, the bot automatically steps down the resolution and frame rate until it fits, and only returns an error if even the lowest-quality pass is still too large. It never posts a partial result.

The tool also has an implicit timeout. Transcoding a video to GIF can take several seconds for longer clips, and Discord's slash-command interaction has a fixed deadline. The bot uses a "thinking" placeholder to extend the deadline, but if the conversion still does not finish in time, the bot returns a timeout error. Re-running on a shorter source clip usually resolves it.

If your guild does not want the clip-to-GIF tool enabled in specific channels (an announcements channel, for example), deny the bot send-attachment permission in that channel. The slash command will still show, but the result of the conversion will not post.

The translate tool is a one-shot text translator. Paste content, get back the same content in another language. Backed by a fast, low-cost AI model. The default target is English, which is what you want most of the time when something lands in your guild that nobody can read. You can pick a different target language with the target option.

1. Translate any text to English by passing it as content:

   /util translate content:"some text"

   The bot auto-detects the source language and replies with the English translation. No source-language flag required.
2. Pick a different target language with a two-letter language code:

   /util translate content:"some text" target:fr

   Common targets: en, es, fr, ja, de, pt. Any ISO 639-1 code the translator recognises works.
3. Drop in an X (Twitter) URL and the tool routes through fxtwitter instead of trying to scrape the page itself:

   /util translate content:https://x.com/someone/status/1234567890

   The bot fetches the tweet text via fxtwitter, then runs the same AI translation pass. This is how you handle "what does this tweet say?" without copy-pasting the body yourself.

Translation used to auto-fire on every tweet linked in a channel. That behaviour was removed because it misbehaved intermittently. The current model is explicit: you ask, the bot translates. That covers the same use case without the noise.

The /util group also ships two small conveniences that come up often enough in technical guilds to be worth a slash command. Neither does anything magical; they are just faster than the alternatives.

1. Pretty-print JSON when someone pastes a wall of minified output and you want to read it:

   /util json content:"<paste>"

   The bot reformats the input with indentation and posts it back in a code block. Useful for API responses, config files, and "is this even valid JSON?" sanity checks.
2. Check the current time across timezones:

   /util time

   The bot replies with the current UTC time and, if your Discord locale is set, your local time alongside it. Quick way to confirm "is it actually 2am for the person I am pinging?" before sending a non-urgent message.

The feedback command is the one-way channel from you to the bot owner. Use it for bug reports, feature requests, or anything in the "this thing broke" bucket. There is no inbox you read back; submissions go to a private log the owner sees, and any follow-up happens out of band. Treat it as fire-and-forget.

1. Submit feedback from any channel the bot can see:

   /feedback message:"<text>"

   The bot acknowledges in the channel with a short confirmation and writes your message to the owner's feedback log along with your user ID and the guild it came from.
2. Pick the right tool for the right report. Use feedback for bot issues: a tool that returned the wrong answer, a feature you wish existed, a confusing reply you did not expect. Do not use it for guild moderation issues; those are local to your guild and the bot owner cannot help with them.
3. Do not expect a reply through Discord. The bot does not accept direct messages, and there is no per-feedback response thread. If your report needs follow-up, the owner reaches out through whichever channel they normally use (the support guild, GitHub issues, or whatever is configured).