Discord Bot Docs

Botsquatch Commands

Slash commands available in the active bot modules (31 total).

admin

  • /badge_manage

    Admin: add, remove, or list player badges

  • /elimination

    Eliminate a player, process egg tokens, assign spectator role, and increment week

  • /export_channel_embeds

    Export all embeds from a channel as JSON files packed in a zip

  • /refill

    Admin: trigger refill actions for house/campers

  • /seachart_list

    Shows where everyone is on The Sea Chart

  • /seachart_view_admin

    Render the Sea Chart with all seeded items (admin view)

  • /vote_end

    End the active elimination vote, download vote images, and post a summary

  • /vote_start

    Begin an elimination vote.

player

  • /alliance

    Create an alliance channel and invite players

  • /alliancemember

    Manage membership for the current alliance channel

  • /bellow

    Reply with the gecko image

  • /big

    Replies with foot!

  • /coins

    Show campers ranked by coins (top 25).

  • /gamble

    Play a minigame gamble for stars or coins

  • /house

    Show the house's gambling resources and stats

  • /inventory

    View your player stats: curses, inventory, badges, and more

  • /join

    Register as a player (creates your player record)

  • /profile

    Show a player profile and stand graph

  • /rps

    Challenge another player to Rock Paper Scissors

  • /seachart_dredge

    Take your dredge action on The Sea Chart!

  • /seachart_move

    Take your move action on The Sea Chart!

  • /seachart_scan

    Take your scan action on The Sea Chart!

  • /seachart_view

    Look at The Sea Chart (image)

  • /stars

    Show campers ranked by stars (top 25).

  • /steak

    Steak related fun commands

  • /thief

    Attempt to steal stars from another camper

  • /token

    Use a special token (immunity, seance, time, nothing, egg)

  • /trade

    Give tokens or coins to another player

  • /umarble_race

    Betting closes ${closeTs}\n\nClick a horse's button to open a bet form!

  • /vote

    Cast an elimination vote

  • /vote_extra

    Spend an extra vote to cast an additional elimination vote

Beyond Slash Commands

Other Bot Functionality

Operational and event-driven systems currently active in Botsquatch.

Automated Cycles

  • Persistent minigame scheduler

    Runs challenges on a rolling 1-3 hour cadence per guild and persists next drop timestamps so the schedule survives restarts.

  • Daily house notifier

    Posts a daily economy and minigame summary embed with star pool, RPSH counts, and win/loss metrics.

  • Scheduled maintenance

    Handles periodic pool redistribution and resource refills for gambling and player inventories.

Event-Driven Systems

  • Ceremony vote watcher

    Listens to ceremony vote changes in MongoDB and pushes vote-status notifications to configured channels.

  • Message curse enforcement

    Applies silent/confused curse rules in real time by deleting invalid messages and posting themed feedback embeds.

  • Ready-time service boot

    On client ready, the bot initializes long-running background services needed for gameplay loops.

Interactive Gameplay Flows

  • Button/select/modal workflows

    Supports non-slash interaction flows for voting, alliance invites, and Umarble betting via components and modals.

  • Busy-state guardrails

    Prevents overlapping actions for users already inside a gated interaction flow to reduce race conditions.

  • Gambling session engine

    Runs timed game sessions with payout/state tracking and protected inventory updates against persistent storage.