$ 41_bot

41 Command Reference

29 slash commands across 7 categories. All commands are slash-only — type / in Discord to browse.

Jump to

User Image Gen Fun Status Moderator Admin Owner Guides API

USER User Commands

/help

Show every command 41 supports.

No arguments. Organized by category with descriptions.

/ping

Measure Discord API round-trip latency and isolate uptime.

Shows API ms + worker uptime. Use to verify 41 is alive.

/avatar [user]

Display a user's avatar at full resolution.

Option	Type	Description
user	user (optional)	Defaults to you.

Clickable embed image (512px). Supports animated GIF avatars.

/userinfo [user]

Show a user's account details: ID, creation date, join date, roles, nickname.

Option	Type	Description
user	user (optional)	Defaults to you.

Shows snowflake-based account creation, server join date, role count, timeout status.

/serverinfo

Display server stats: members, boosts, channels, roles, creation date.

Guild-only. Shows approximate member/presence counts, boost tier, channel/role counts.

/poll question options:

Create a reaction poll with up to 4 options.

Option	Type	Description
question	string (required)	Up to 250 chars.
options	string (required)	Separate with `\|` — e.g. `pizza \| sushi \| tacos`

Posts an embed then auto-reacts with 1️⃣ 2️⃣ 3️⃣ 4️⃣ so users can vote.

USER Image Generation

/imagine prompt: [shape:]

Generate AI art from a text prompt — rynzen-style, powered by pollinations.ai flux model.

Option	Type	Description
prompt	string (required)	Up to 400 chars. Describe what you want.
shape	choice (optional)	`square` (1024x1024) · `wide` (1280x768) · `tall` (768x1280)

/imagine prompt: a cyberpunk cat on a motorcycle at sunset, neon lights /imagine prompt: medieval castle on a floating island shape: wide

Shows "thinking..." while generating (5-20s). Free — no API key needed. Image appears as a Discord attachment you can download.

FUN Fun Commands

/8ball question:

Ask the magic 8-ball a yes/no question.

Option	Type	Description
question	string (required)	Your yes/no question, up to 200 chars.

Returns one of 16 classic 8-ball responses at random.

/coinflip

Flip a coin — heads or tails.

No arguments. 50/50 random result.

/dice [sides:] [count:]

Roll dice.

Option	Type	Description
sides	int (optional)	Sides per die, 2-1000. Default: 6.
count	int (optional)	Number of dice, 1-10. Default: 1.

/dice = 1d6 → "4" /dice sides: 20 count: 3 = 3d20 → "17 3 11" total: 31

/rps choice:

Play rock-paper-scissors against 41.

Option	Type	Description
choice	choice (required)	rock · paper · scissors

STATUS Status Commands

/status

Live health check of the website, this bot, and the Discord API.

Fetches the website's /api/health endpoint, measures Discord REST latency, and counts servers. Shows green/yellow/red status. This is what the landing page widget also displays.

/stats

Bot uptime, requests served, server count, version, and worker isolate info.

Owner sees extra runtime details (isolate boot time, exact request count). Normal users see uptime, servers, latency, version.

MOD Moderator Commands

All mod commands require Moderate Members permission (or higher). The owner bypasses all permission checks.

/kick user: [reason:]

Kick a member from the server. They can rejoin with a new invite.

Option	Type	Description
user	user (required)	Member to kick.
reason	string (optional)	Shown in audit log and mod-log.

Sends a DM to the target before kicking (if their DMs are open). Logged to mod-log if configured.

/ban user: [delete_days:] [reason:]

Permanently ban a user. Optionally purge their recent messages.

Option	Type	Description
user	user (required)	User to ban.
delete_days	choice (optional)	Delete messages from last 0/1/3/7 days.
reason	string (optional)	Reason for the ban.

Can ban users not currently in the server (via resolved user). Sends DM notification.

/unban user_id:

Lift a ban by user ID.

Option	Type	Description
user_id	string (required)	The banned user's Discord ID.

/timeout user: duration: [reason:]

Temporarily mute a member (30s to 28 days).

Option	Type	Description
user	user (required)	Member to timeout.
duration	string (required)	e.g. `30s` `10m` `2h` `7d`
reason	string (optional)	Reason.

Max 28 days (Discord limit). Uses Moderate Members permission.

/untimeout user:

Remove a member's timeout early.

Option	Type	Description
user	user (required)	Member to un-timeout.

/warn user: [reason:]

Issue a warning stored persistently in KV.

Option	Type	Description
user	user (required)	Member to warn.
reason	string (optional)	Why they were warned.

Warnings are stored per-guild in Cloudflare KV. DMs the target. Shows total warn count after issuing.

/warnings user:

List all warnings for a member.

Option	Type	Description
user	user (required)	Which member?

Shows the last 15 warnings with timestamps, moderator, and reason.

/clearwarnings user:

Wipe every warning for a member.

Option	Type	Description
user	user (required)	Which member?

/purge count: [user:]

Bulk-delete recent messages in this channel.

Option	Type	Description
count	int (required)	1-100 messages.
user	user (optional)	Only delete messages from this user.

Skips pinned messages. Respects Discord's 14-day bulk-delete age limit. Ephemeral response (only you see it).

/slowmode seconds:

Set the channel's slowmode rate limit.

Option	Type	Description
seconds	int (required)	0 to disable, max 21600 (6 hours).

/lock

Lock this channel — @everyone can no longer send messages.

Sets the Send Messages deny bit for @everyone. Preserves all other permission overwrites. Logged to mod-log.

/unlock

Unlock this channel — restore @everyone send permission.

Reverses /lock. Removes the Send Messages deny bit for @everyone.

ADMIN Admin Commands

Admin commands require Manage Server or Administrator permission.

/setlog channel:

Set the moderation-log channel for this server.

Option	Type	Description
channel	channel (required)	Where mod actions get logged.

Once set, every kick/ban/timeout/warn/purge/lock action posts an embed here. Requires BOT_KV (Cloudflare KV namespace).

/unsetlog

Disable moderation logging for this server.

Clears the stored log channel. Mod actions will no longer be logged.

/announce title: message: [color:]

Post an announcement embed in this channel.

Option	Type	Description
title	string (required)	Embed title, up to 200 chars.
message	string (required)	Body text, up to 1500 chars.
color	choice (optional)	green · yellow · red · blue

OWNER Owner Commands

These commands are owner-only — only user ID 1379382159969878107 can use them. Works in DMs and servers.

/owner botinfo

Full runtime details: isolate boot time, token status, KV availability, requests served, version.

/owner servers

List every guild the bot is in with member counts and IDs.

/owner leave guild_id:

Make 41 leave a guild by ID.

Option	Type	Description
guild_id	string (required)	The guild to leave.

/owner dm user_id: message:

Send a DM to any user as 41.

Option	Type	Description
user_id	string (required)	Target user's ID.
message	string (required)	Message text, up to 1500 chars.

/owner say channel_id: message: [title:]

Make 41 send a message to any channel.

Option	Type	Description
channel_id	string (required)	Target channel ID.
message	string (required)	Message text, up to 1500 chars.
title	string (optional)	If set, sends an embed instead of plain text.

/owner blacklist action: [user_id:] [reason:]

Block or unblock users from using the bot globally.

Option	Type	Description
action	choice (required)	add · remove · list
user_id	string (optional)	Target user (not needed for list).
reason	string (optional)	Why they're blacklisted.

Blacklisted users get an ephemeral error when they try any command. Stored in Cloudflare KV.

/owner config [guild_id:] [reset:]

View or reset a guild's stored config.

Option	Type	Description
guild_id	string (optional)	Guild to inspect (default: current).
reset	bool (optional)	Set true to clear config back to defaults.

/owner exec method: path:

Run a raw Discord REST API call as the bot (advanced debugging).

Option	Type	Description
method	choice (required)	GET · POST · PUT · PATCH · DELETE
path	string (required)	API path — e.g. `/guilds/{id}/members?limit=10`

Use with caution. Directly hits the Discord API. Response is shown as a JSON code block.

Guides

Permissions

41 uses Discord's built-in permission system. Each command requires specific permissions:

User / Fun / Status — everyone can use these
Moderator — requires Moderate Members, Kick Members, Ban Members, Manage Messages, or Manage Channels (varies by command)
Admin — requires Manage Server or Administrator
Owner — only user ID 1379382159969878107. Admins cannot use these.

The server owner always bypasses all permission checks (except the owner commands, which are ID-gated).

Global Blacklist

The bot owner can blacklist users globally. Blacklisted users cannot use any command — they get an ephemeral error message.

Blacklist storage is per-isolate in Cloudflare KV
The owner cannot be blacklisted
Use /owner blacklist action: add user_id: ... to block
Use /owner blacklist action: list to see all blacklisted users

Mod-log Setup

Moderation actions (kick, ban, timeout, warn, purge, lock) can be automatically logged to a channel.

Run /setlog channel: #mod-log to enable
Each action posts an embed with: target user, moderator, reason, timestamp
Run /unsetlog to disable
Requires the BOT_KV Cloudflare KV namespace to be bound

API Reference

GET /api/health

Returns JSON with live bot stats. Used by the landing page widget and /status command.

{ "ok": true, "service": "41-discordbot", "version": "1.0.1", "commands": 29, "uptime_ms": 123456, "requests": 42, "bot": { "username": "41", "id": "1524837327455649992" }, "guilds": [ { "id": "...", "name": "Froggy", "members": 7 } ], "ts": "2026-08-23T06:00:00.000Z" }

CORS enabled. No authentication required. Cache-Control: no-store.

POST /api/interactions

Discord Interactions Endpoint. Handles all slash commands via Ed25519-verified POST requests.

Endpoint URL: https://41-discordbot.pages.dev/api/interactions
Signature verification uses the application public key
Responds to Discord's PING verification with {"type":1}
Image generation uses pollinations.ai (free, no key)