Command documentation

Spamsu Commands

Reference for slash commands, options, and setup details.

Commands
16
Usages
39
16 commands

Utility

/balance

#

Check cat points and active Cat Game cosmetics for yourself or another server member.

/balance [target:user]

Show your spendable cat points.

  • If you leave target empty, Spamsu shows your own spendable cat point balance.
  • The reply also shows the current Cat Game title and any active shop color role, including time left before it expires.
Option Type Required Description
target User Optional The user to check.

Utility

/catgame

#

Run automatic Cat Game drops and view the Cat Game leaderboard.

/catgame start [channel:channel] [min_minutes:integer] [max_minutes:integer]

Start automatic random cat drops in a channel.

  • Admin only. If channel is empty, Spamsu uses the channel where you run the command.
  • If you do not provide intervals, drops are scheduled randomly every 60-180 minutes.
  • When a cat appears, players type Cat; the first three correct replies earn 9, 6, and 3 points.
Option Type Required Description
channel Channel Optional The channel to drop cats in. Text channels only
min_minutes Integer Optional Minimum minutes between random cat drops. 1-1440
max_minutes Integer Optional Maximum minutes between random cat drops. 1-1440
/catgame stop [channel:channel]

Stop automatic random cat drops in a channel.

  • Admin only. If channel is empty, Spamsu stops drops in the current channel.
  • The command only disables automatic drops; existing scores and shop balances are kept.
Option Type Required Description
channel Channel Optional The channel to stop cat drops in. Text channels only
/catgame leaderboard [period:string]

Show the cat game leaderboard.

  • Shows the top Cat Game players for the selected period.
  • If period is empty, the leaderboard defaults to all time.
Option Type Required Description
period String Optional Which leaderboard period to show. DailyWeeklyMonthlyAll time

Utility

/clash

#

Open a short signup, collect custom character names, then let Spamsu run an AI-judged battle royale.

/clash start [join_seconds:integer] [referee:string] [battleground:string] [custom_battleground:string]

Open signups for a character battle royale.

  • Players press Submit Character and enter a character name before signups close.
  • If join_seconds is empty, signups stay open for 60 seconds. At least two players must submit characters.
  • If referee is empty, Chaos Ref is used. If battleground is empty, Spamsu picks a preset arena at random. A custom battleground overrides the preset choice.
Option Type Required Description
join_seconds Integer Optional How long people can join and submit a character. 15-120
referee String Optional Who judges the battle. Chaos RefThe StrategistThe DivaPetty RefWholesome Ref
battleground String Optional Where the battle takes place. Haunted KitchenNeon RooftopInfinite Ball PitForbidden LibraryBroken Arcade
custom_battleground String Optional Write your own battleground instead of using a preset. Max 60 characters

Utility

/firstmessage

#

Give users a role after they send enough messages in specific text channels.

/firstmessage setup <channel:channel> <role:role> [count:integer]

Assign a role after a user sends enough messages in a channel.

  • Admin only. Spamsu watches the selected channel and assigns the selected role once a user reaches the required message count.
  • If count is empty, the role is assigned after 1 message.
  • The bot must be able to manage the chosen role, and the role has to be below Spamsu in the server role order.
Option Type Required Description
channel Channel Required The channel to watch. Text channels only
role Role Required The role to assign.
count Integer Optional How many messages are required before assigning the role. 1-100000
/firstmessage stop <channel:channel> [role:role]

Stop assigning a first-message role in a channel.

  • Admin only. If role is supplied, only that channel-role rule is removed.
  • If role is empty, all message-count role rules for the selected channel are disabled.
Option Type Required Description
channel Channel Required The channel to stop watching. Text channels only
role Role Optional Only stop this role rule. Leave empty to stop all rules in the channel.
/firstmessage status

Show active first-message role rules.

  • Admin only. Shows all active message-count role rules for the server.

No options.

Utility

/kissmarrykill

#

Start a one-minute Kiss Marry Kill vote with three candidates.

/kissmarrykill [user_1:user] [user_2:user] [user_3:user]

Play Kiss Marry Kill with three users.

  • If you provide no users, Spamsu creates three celebrity candidates. It tries AI-generated names first and falls back to a built-in celebrity list if needed.
  • If you provide one or two users, Spamsu fills the remaining slots with random non-bot server members.
  • You cannot use the same user twice, and bot users are rejected.
  • Everyone votes from a select menu for 1 minute; the final result summarizes the submitted choices.
Option Type Required Description
user_1 User Optional A user to include.
user_2 User Optional Another user to include.
user_3 User Optional Another user to include.

Utility

/leaderboard

#

Show message-count leaders for this server.

/leaderboard

Provides leaderboard on this server.

  • Shows the top 5 users for today and the top 5 all-time message counts.
  • Counts are tracked per server, so another server has a separate leaderboard.

No options.

Utility

/meme

#

Generate an AI meme image from a prompt, optionally featuring server member avatars.

/meme generate <prompt:string> [avatar_mode:string] [style:string] [user_1:user] [user_2:user] [user_3:user] [user_4:user] [user_5:user] [user_6:user]

Generate a meme from a prompt.

  • Spamsu replies privately while generating, then posts the finished image publicly in the channel.
  • If avatar_mode is empty, avatars are integrated into the generated scene. Overlay mode places them as visible stickers.
  • Duplicate avatar users are ignored, and you can include up to six unique users.
  • If style is empty, Spamsu chooses a style from the prompt.
Option Type Required Description
prompt String Required The meme idea to generate. Max 500 characters
avatar_mode String Optional How mentioned user avatars should be used. Integrated into the generated imageOverlayed as visible stickers
style String Optional The drawing style for the meme. AutoRealisticComic bookAnimePixel artOil painting
user_1 User Optional A user whose avatar should appear in the meme.
user_2 User Optional Another user whose avatar should appear in the meme.
user_3 User Optional Another user whose avatar should appear in the meme.
user_4 User Optional Another user whose avatar should appear in the meme.
user_5 User Optional Another user whose avatar should appear in the meme.
user_6 User Optional Another user whose avatar should appear in the meme.

Utility

/movies

#

Manage a shared server movie wishlist with votes, random picks, and movie-night polls.

/movies add <title:string>

Add a movie to the wishlist.

  • Searches TMDB for the title, adds the matched movie to this server wishlist, and includes overview and streaming provider information when available.
Option Type Required Description
title String Required The movie title to search on TMDB. Max 120 characters
/movies list

Show the active movie wishlist.

  • Shows active unwatched wishlist movies and their IDs so people can vote, mark watched, or delete them later.

No options.

/movies vote <id:integer>

Vote for a movie.

  • Adds your vote to the selected wishlist movie. If you already voted for it, Spamsu tells you instead of adding a duplicate vote.
Option Type Required Description
id Integer Required The wishlist movie ID.
/movies watched <id:integer>

Mark a movie as watched.

  • Marks a movie as watched and moves it out of the active wishlist.
Option Type Required Description
id Integer Required The wishlist movie ID.
/movies random

Pick a random movie from the wishlist.

  • Picks one active wishlist movie at random. If the wishlist is empty, Spamsu says so.

No options.

/movies poll [count:integer]

Start an interactive movie night poll.

  • Starts an interactive movie-night poll using top wishlist movies.
  • If count is empty, Spamsu includes up to 5 movies. The command accepts 2-5.
Option Type Required Description
count Integer Optional How many top wishlist movies to include. 2-5
/movies delete <id:integer>

Delete a movie from the wishlist.

  • Removes a movie from the server wishlist by ID.
Option Type Required Description
id Integer Required The wishlist movie ID.

Utility

/nosegame

#

Run automatic Nose Game rounds and view the Nose Game leaderboard.

/nosegame start [channel:channel] [min_minutes:integer] [max_minutes:integer]

Start automatic random nose-picking rounds in a channel.

  • Admin only. If channel is empty, Spamsu uses the channel where you run the command.
  • If you do not provide intervals, rounds are scheduled randomly every 60-180 minutes.
Option Type Required Description
channel Channel Optional The channel to start rounds in. Text channels only
min_minutes Integer Optional Minimum minutes between random nose-picking rounds. 1-1440
max_minutes Integer Optional Maximum minutes between random nose-picking rounds. 1-1440
/nosegame stop [channel:channel]

Stop automatic random nose-picking rounds in a channel.

  • Admin only. If channel is empty, Spamsu stops rounds in the current channel.
Option Type Required Description
channel Channel Optional The channel to stop rounds in. Text channels only
/nosegame leaderboard [period:string]

Show the nose-picking leaderboard.

  • Shows the top Nose Game players for the selected period.
  • If period is empty, the leaderboard defaults to all time.
Option Type Required Description
period String Optional Which leaderboard period to show. DailyWeeklyMonthlyAll time

Utility

/ping

#

A simple health check command.

/ping

Replies with Pong!

  • Spamsu immediately replies Pong, which is useful for confirming the bot is online and responding to slash commands.

No options.

Utility

/redeem

#

Spend Cat Game points on shop items, channel effects, flexes, and temporary color roles.

/redeem <item:string>

Redeem cat points for shop items.

  • You need enough spendable cat points for the selected item. If you do not have enough, nothing is spent.
  • Force Cat Drop, Cat Hint, Double Cat Stakes, and Chaos Cat must be redeemed in a text channel because they affect that channel.
  • Force Cat Drop is refunded if a cat round cannot be started. Color roles last 7 days and require Spamsu to have Manage Roles permission.
  • Use /shop first if you want to compare item costs and effects.
Option Type Required Description
item String Required The item to redeem. Force Cat DropLeaderboard FlexCat HintDouble Cat StakesChaos CatSteal The SpotlightCat Game EmeraldCat Game JadeCat Game RubyCat Game SapphireCat Game AmethystCat Game Rose QuartzCat Game Diamond

Utility

/rpg

#

Play asynchronous Moonlit Raid RPG adventures with characters, subscriptions, parties, and XP.

/rpg subscribe

Subscribe to Moonlit Raid pings in this server.

  • Opt in to expedition pings for this server. You still need a character before joining expeditions.

No options.

/rpg unsubscribe

Stop receiving Moonlit Raid pings in this server.

  • Stops expedition pings for this server without deleting your character.

No options.

/rpg create <name:string> <class:string> [overwrite:boolean]

Create a pixel-art adventurer from your Discord avatar.

  • Creates your character and subscribes you to expedition pings.
  • If you already have a character, set overwrite to true to replace it.
Option Type Required Description
name String Required Your character name. 2-32 characters
class String Required Your adventuring class. WarriorRangerMageLancerArtificerShadowblade
overwrite Boolean Optional Replace your existing character.
/rpg sheet

Show your RPG character sheet.

  • Shows your own character sheet privately. If you do not have a character yet, Spamsu tells you to create one first.

No options.

/rpg profile [user:user]

Show an RPG profile.

  • Shows an RPG profile for you or another user.
  • If user is empty, Spamsu shows your own profile.
Option Type Required Description
user User Optional The user to inspect.
/rpg start [channel:channel] [difficulty:string] [signup_minutes:integer] [min_players:integer] [max_players:integer]

Open a co-op Moonlit Raid party in a channel.

  • Admin only. Posts an expedition signup in the selected channel or the current channel if channel is empty.
  • Defaults are normal difficulty, 5 signup minutes, 1 minimum player, and 4 maximum players.
  • Minimum players cannot be higher than maximum players.
Option Type Required Description
channel Channel Optional The channel to post the expedition in. Text channels only
difficulty String Optional Expedition difficulty. StoryAdventurerHeroic
signup_minutes Integer Optional How long signup should stay open. 1-30
min_players Integer Optional Minimum party size. 2-4
max_players Integer Optional Maximum party size. 2-4
/rpg stop [channel:channel]

Cancel the open Moonlit Raid in a channel.

  • Admin only. Cancels the open expedition in the selected channel or current channel.
Option Type Required Description
channel Channel Optional The channel with the open expedition. Text channels only
/rpg status [channel:channel]

Show the open Moonlit Raid in a channel.

  • Shows the open expedition status for the selected channel or current channel.
Option Type Required Description
channel Channel Optional The channel to inspect. Text channels only
/rpg leaderboard

Show the RPG XP leaderboard.

  • Shows the top Moonlit RPG characters by XP for this server.

No options.

Utility

/server

#

Show basic information about the Discord server.

/server

Provides information about the server.

  • Replies with the server name and current member count.

No options.

Utility

/shop

#

List Cat Game shop items, item IDs, costs, and short effect descriptions.

/shop

Show the cat point shop.

  • Use this before /redeem to see what you can buy with cat points.
  • The item ID shown in backticks is the value used by the redeem command.

No options.

Utility

/spotify

#

Connect Spotify and share current playback through Spamsu.

/spotify connect

Connect your Spotify account.

  • Replies privately with a Spotify authorization link that only you can see.

No options.

/spotify disconnect

Disconnect your Spotify account.

  • Removes your connected Spotify account from Spamsu.

No options.

/spotify me

Show your connected Spotify account.

  • Privately confirms which Spotify account is connected, or tells you to connect first.

No options.

/spotify nowplaying [target:user]

Show your current Spotify playback.

  • Shows the current track for you or the selected target user.
  • If target is empty, Spamsu checks your playback. The target must have connected Spotify first.
  • If nothing is playing, Spamsu says that instead of showing a track card.
Option Type Required Description
target User Optional The user whose playback you want to see.

Utility

/user

#

Show today's tracked message count for yourself or another user.

/user [target:user]

Provides information about the user.

  • If target is empty, Spamsu checks your own message count for today.
  • Counts reset by date and are separate for each server.
Option Type Required Description
target User Optional The user to get information about