← Back to jefehz.org

Bot Command Reference

Complete command documentation for Jefebot, GygaxBot, and VibeBot

💬

Core

3 commands
!helpalias: !h
Quick-start guide and command overview
!jefebotaliases: !info !about !bot !commands
Full command reference
!personalitiesaliases: !modes !personality
List all 38 personality modes
🎭

Personalities (38 modes)

Use: !<personality> <message>

Every personality can be used as a command. Reply to any bot message to continue in that personality.

!uhm Know-it-all
!please Overly polite
!uwu Anime cute
!zoomer Gen Z
!goth Dark & melancholic
!yarr Pirate
!bard Shakespearean
!noir Detective
!beep Robot
!howdy Cowboy
!sire Knight
!villain Evil mastermind
!sports Commentator
!dude Surfer
!gamer Gaming
!streamer Twitch
!techbro Silicon Valley
!bro Gym bro
!valleygirl Valley girl
!lebowski The Dude
!scarface Tony Montana
!forrest Forrest Gump
!spock Logical Vulcan
!chef Gordon Ramsay
!gandalf Wise wizard
!seinfeld Jerry Seinfeld
!ozzy Ozzy Osbourne
!trump Trump style
!biden Biden style
!woke Progressive
!dale Dale Gribble
!alexjones Conspiracy
!tucker Tucker Carlson
!benshapiro Ben Shapiro
!macho Randy Savage
!nerd Nerdy technical
!aussie Australian
!clippy MS Clippy
!dad Dad jokes
!tenantdan Angry tenant
🧠

Personality System

4 commands
!mood [primary] [secondary]
Set Jefebot's emotional tone. Moods layer on top of personalities.
Subcommands
  • !mood - Show current mood
  • !mood happy sarcastic - Set primary + secondary
  • !mood clear - Reset to default
  • !mood list - See all available moods
!trait [add|remove|list|clear] [trait]
Set persistent personality traits (max 10). Traits persist across conversations.
!moodhelp
Detailed guide for the mood system with examples and combinations
!traithelp
Detailed guide for personality traits with categories and best practices
🎨

Image Generation

5 commands
!image <prompt>alias: !imagine
Generate AI images. Supports image attachments for modification. Models: ComfyUI (free/local), DALL-E 3, DALL-E 2, GPT-Image-1.
!imagemodel [model|list]
Switch image generation model (comfyui-sdxl, comfyui-realistic, dall-e-3, dall-e-2, gpt-image-1)
!imagesize [size|list]
Set image dimensions (256x256 through 1792x1024)
!imagequality [quality|list]
Set generation quality (draft/fast/balanced/quality/ultra for ComfyUI; auto/high/low for OpenAI)
!imagemodify <prompt>alias: !modify
Edit an existing image with AI. Attach an image or reply to a message with one.
📜

Historical & Trivia

5 commands
!today
Random historical event from today's date, told in period personality with AI illustration
!todaymore
Comprehensive list of today's historical events, births, and deaths
!trivia [category]aliases: !quiz !question
AI-generated trivia. Categories: movies, gaming, history, science, etc. Use !trivia categories to list all.
!triviafast [category]
Same as !trivia but answered by a faster, cheaper model — handy when chat is moving quickly. Requests queue FIFO, so asking during a busy round tells you your position rather than dropping it.
!triviascoresaliases: !triviastats !trivialeaderboard
View trivia leaderboard and your rank
🎬

Film Club

5 commands
!filmclub <movie>aliases: !fc !filmlist !filmsearch
Search the Rory Gilmore Film Club watchlist — 1,190+ films with OMDB metadata, synced daily from the club's doc. Falls back to the request queue when a film hasn't been watched yet.
Subcommands
  • !filmclub barbie - Search by title
  • !filmclub actor nicolas cage - Also: director, genre, writer, rated, language, country
  • !filmclub stats - Totals and metadata coverage
  • !filmclub remove <movie> - Remove from the watchlist
!filminfo <movie> [year]aliases: !fi !movieinfo !movie
Look up any film via OMDB — plot, cast, ratings, box office. Tags the result if it's already on the watchlist.
!filmrequest <movie>aliases: !fr !requestfilm
Request a film for the watchlist. Rejects anything already watched or already queued.
!filmqueue [search]alias: !fq
View pending film requests. Bare text filters the queue; !filmqueue remove <movie> drops one.
!filmtonight [movie]aliases: !tonight !whatsplaying !nowplaying
Set or view tonight's feature. Setting it also adds the film to the watchlist with today's date. Add a year to disambiguate, or dir:<name> to pick by director. !filmtonight clear unsets it.
Twitch only
  • !filmpick <#> - Switch to a numbered match after !filmtonight finds several
📺

TV Club

6 commands
!tvrequest <show> [year]aliases: !tvr !requesttv !showrequest
Add a series to the watch queue. Resolved through OMDB, so entries carry the canonical title, year, season count, poster and IMDb link.
!tvqueue [search]aliases: !tvq !showqueue
View the queue. Bare text filters it — adding is !tvrequest's job.
!tvwatching [show]aliases: !tvw !watching !nowwatching
List shows in progress, or start one. Naming a show moves it onto the list, adding it if it isn't tracked yet.
!tvhold [show]aliases: !tvpending !tvh !onhold !betweenseasons
For shows you're caught up on and waiting on the next season. Move one back with !tvwatching when it returns.
!tvwatched [show]aliases: !tvdone !watched !tvseen
List finished shows, or mark one done.
!tvinfo <show> [year]aliases: !tvi !showinfo !seriesinfo
Look up any series via OMDB — seasons, creator, cast, ratings. Tags the result with its status if you're already tracking it.
Shared options
Every list command takes the same two subcommands.
On !tvqueue, !tvwatching, !tvhold, !tvwatched
  • search <text> - Filter that list
  • remove <show> - Stop tracking it entirely
  • Shows flow queued → watching → on hold → watched, and can move back at any time. A partial title that matches more than one show is refused with the candidates listed, never guessed.
⚙️

Utility

6 commands
!model [model-name]aliases: !gptmodel !setmodel
Change GPT model. Available: gpt-5.1, gpt-5, gpt-5-mini, gpt-5-nano, gpt-4.1, gpt-4.1-mini, gpt-4.1-nano
!tracking [on|off|status]
Enable/disable message history storage (opt-in). Disabling deletes all stored data.
!history [limit]aliases: !hist !messages
View recent conversation history (requires tracking enabled)
!historylimit [number]
Set message history retention (10-10,000 messages, default 1,000)
!mystats
Your usage statistics: messages sent, active days, engagement level (requires tracking)
!comfycheckaliases: !imagecheck !checkcomfy
Check ComfyUI availability and reinitialize connection
🔧

Admin

Jefe-only
!spam <add|edit|remove|start|stop|hours|list>
Schedule periodic AI-generated messages in Discord channels
Admin only
!twitchnotify, !twitchjoin, !twitchleave, !twitchlist, !twitchspam
Twitch stream monitoring, go-live notifications, and chat integration
Admin only
🎲

Core

3 commands
!helpaliases: !gygax !gygaxbot
Show main help. Use !help detailed for full command list.
!roll <notation> [advantage|disadvantage]
Roll dice using D&D notation. Examples: !roll 1d20+5, !roll 2d6, !roll 1d20 advantage
!summon <character_id> <message>aliases: !call !quote
Generate an AI response from a character (PC or NPC) based on their personality
🏰

Campaign Management

5 subcommands
!campaign <subcommand>
Manage campaigns and switch between them
Subcommands
  • !campaign list - List all campaigns
  • !campaign info [name] - Campaign details and party members
  • !campaign set <name> - Set your active campaign
  • !campaign join <name> - Join a campaign
  • !campaign characters - List party members with race/class
🎭

Character Management

10 subcommands
!char <subcommand>alias: !character
Manage player characters, inventories, and visual descriptions
Subcommands
  • !char list - List all campaign characters
  • !char add <id> <name> "<personality>" - Add new character
  • !char info <id> - Show character details (aliases: show)
  • !char describe <id> - Show visual description used for AI image generation (aliases: desc, visual, ref)
  • !char appearance <id> <text> - Set/update visual description for AI image gen (owner/DM/admin, alias: setdesc)
  • !char claim <id> - Claim ownership of an unclaimed character (alias: own)
  • !char modify <id> "<personality>" - Update personality (owner/DM only, alias: update)
  • !char remove <id> - Remove character (owner/DM/admin, alias: delete)
  • !char inv <id> - Character inventory (aliases: inventory, items, gear)
  • !char inv <id> add <item> - Add item to character inventory (owner only)
👤

NPC Management

DM/Admin
!npc <subcommand>
Manage campaign NPCs with detailed profiles
Subcommands
  • !npc list [category] - List NPCs, optionally by category
  • !npc add <id> <name> [personality] - Add NPC (DM/Admin)
  • !npc info <id> - Full NPC profile
  • !npc category <id> <category> - Categorize NPC (DM/Admin)
  • !npc search <term> - Search NPCs
  • !npc remove <id> - Remove NPC (DM/Admin)
Categories: recurring, major, minor, shopkeepers, antagonists, allies
🎒

Bag of Holding (Party Inventory)

5 subcommands
!boh <subcommand>aliases: !inv !inventory !donkey !mule
Shared party inventory with transaction history
Subcommands
  • !boh - List all items and gold
  • !boh add <item> [qty] [description] - Add items
  • !boh remove <item> [qty] - Remove items
  • !boh gold add|remove <amount> - Manage party gold
  • !boh search <term> - Search items
  • !boh history [count] - Transaction history
📖

Game Log

4 subcommands
!gamelog <subcommand>aliases: !lore !loremaster !log
Track campaign events, sessions, and lore
Subcommands
  • !gamelog add <event> - Log an event
  • !gamelog recent [count] - Recent events (default 10)
  • !gamelog session start [name] - Start session (DM only)
  • !gamelog session end - End session (DM only)
  • !gamelog search <term> - Search events
🏯

Bastions (D&D 2024)

7 subcommands
!bastion <subcommand>aliases: !stronghold !fortress
Manage D&D 5e 2024 bastions with facilities, defenders, and resources
Subcommands
  • !bastion create <char_id> <name> <location> - Create bastion
  • !bastion info <char_id> - View bastion details
  • !bastion facilities [char_id] - List facilities
  • !bastion defenders [char_id] - View defenders
  • !bastion add facility <char_id> <type> <name> - Build facility
  • !bastion add defender <char_id> <type> <name> - Recruit defender
  • !bastion turn <char_id> - Advance bastion turn
📜

Session Archive & AI Media

6 subcommands
!session <subcommand>alias: !archive
Archive sessions with AI-generated illustrations, narration, and semantic search. See the showcase
Subcommands
  • !session archive [name] [--backend gemini|flux|both] - Archive session (attach .txt transcript, DM only)
  • !session view [number] - View archived session with images and audio
  • !session list - List all archived sessions
  • !session recap [number] - AI-generated session recap
  • !session search <query> - Semantic search across sessions (RAG)
  • !session status <job_id> - Check archive pipeline progress
Archive creation requires DM role. Image backends: gemini (cloud, reference photos), flux (local GPU), both (side-by-side comparison)
🎭

Personalities

Custom AI characters
!personality <subcommand>
Manage custom AI personalities with configurable triggers
Subcommands
  • !personality list - List all personalities with triggers
  • !personality create <name> <trigger> <prompt> - Create personality (Admin)
  • !personality delete <name> - Delete personality (Admin)
🌊

Core

1 command
!vibe <message>alias: !vibebot
Ask VibeBot4000 for an AI-generated response in its oceanmeme DJ personality. A channel's vibe list may limit who can use this command.
🎧

Automatic Features

No command required
First-chat greetings
Welcomes chatters once per configured greeting window, with individual greetings for channel roles and batched greetings for regular viewers.
Role-aware shoutouts
Queues Twitch shoutouts for configured roles such as moderators, VIPs, and DJs while respecting persistent viewer opt-outs.
Chat translation
Detects supported non-English chat messages and posts an English translation. English, emote-only, and no-change translations are skipped.
🔕

Viewer Preferences

4 command groups
!noshout [username]alias: !dontshout
Turn off shoutouts while keeping greetings and translations enabled.
!allowshout [username]aliases: !doshout !unnoshout !undontshout
Turn shoutouts back on. A separate !killvibes preference remains in effect until cleared.
!killvibes [username]
Opt out of VibeBot greetings and shoutouts.
!unkillvibes [username]
Restore greetings and shoutouts unless a separate shoutout-only opt-out is still active.
Leave off the username to manage yourself. Broadcasters, moderators, lead moderators, and configured admins can manage another viewer. Preferences persist across restarts.
🛠️

Channel Controls

Broadcaster / moderator
!vibelist [username ...]
View or manage the channel's list of viewers allowed to request AI vibe responses.
Usage
  • !vibelist - Show the current list
  • !vibelist username - Add one or more viewers
  • !vibelist remove username - Remove one or more viewers
  • !vibelist clear - Clear the list
Anyone can view the list; broadcaster, moderators, lead moderators, and configured admins can change it.
!memelord <on|off|fire|status>
Control the cross-channel memelord vibe scheduler, trigger it immediately, or show its status.
Broadcaster or configured admin only