# SkyBot Commands

All commands are prefixed with your configured prefix (e.g. `s/`). Arguments in `[brackets]` are optional.

---

## Fun

| Command | Aliases | Description |
|---|---|---|
| `8ball [question]` | — | Ask the magic 8 ball a question |
| `cat` | — | Post a random cat picture |
| `choose <options>` | — | Pick one of the given options |
| `coinflip` | — | Flip a coin |
| `dice` | — | Roll a die |
| `echo <text>` | — | Repeat text through the bot |
| `hangman [category]` | — | Start a channel-wide game of hangman (`hg <letter or word>` to guess) |
| `image <query>` | `img` | Fetch a random image matching your search |
| `mock` | — | mOcK tExT of a message (reply to one) |
| `reverse` | — | Reverse a message (reply to one or pass text) |
| `rockpaperscissors` | `rps` | Play rock paper scissors against the bot |
| `t9encode <text>` | — | Encode text into old phone keypad multi-tap digits |
| `t9decode <digits>` | — | Decode old phone keypad multi-tap digits |
| `trivia` | — | Start a channel-wide trivia question with 30 seconds to answer (`tg <A/B/C/D>` to guess) |
| `wordle` | — | Start a channel-wide Wordle; guess the 5-letter word in 6 tries (`wg <word>` to guess) |

---

## Info

| Command | Aliases | Description |
|---|---|---|
| `botguide` | `bot`, `bguide` | Link to the Valour bot guide |
| `devcentral` | — | Invite link to the Dev Central planet |
| `info` | — | User and planet info |
| `joinsite` | — | Link to a site to help bots join a planet |
| `minecraft` | — | Unofficial ValourSMP server IPs |
| `ping` | — | Check bot latency |
| `source` | — | Link to the bot's source code |
| `suggest <text>` | — | Submit a suggestion for the bot |
| `swagger` | — | Link to the Valour API docs |
| `uptime` | — | Show how long the bot has been running |
| `usercount` | — | Show the total Valour user count |
| `version` | — | Show the current bot and Valour SDK version |

---

## Moderation

| Command | Aliases | Description |
|---|---|---|
| `ban <@user> [reason]` | — | Ban a member from the planet |
| `bans` | — | List all bans in the planet |
| `kick <@user> [reason]` | — | Kick a member from the planet |
| `setwelcome` | — | Configure a welcome channel and message |
| `unban <user id>` | — | Unban a member from the planet |

---

## RP

All RP commands accept an optional `[@user]` argument or a message reply to target someone.

### Marriage

| Command | Description |
|---|---|
| `marriage propose @user` | Propose to someone (reply to their message or mention them). Proposal expires after 5 minutes. |
| `marriage accept` | Accept a pending proposal |
| `marriage decline` | Decline a pending proposal |
| `marriage status` | Show your current marriage status |
| `marriage divorce` | End your current marriage |

Marriages persist across bot restarts.

### GIF Commands

| Command | Description |
|---|---|
| `angry` | Express anger |
| `baka` | Call someone a baka |
| `bite` | Bite someone |
| `blowkiss` | Blow a kiss |
| `blush` | Blush |
| `bonk` | Bonk someone |
| `carry` | Carry someone |
| `clap` | Clap |
| `cry` | Cry |
| `cuddle` | Cuddle someone |
| `dance` | Dance |
| `facepalm` | Facepalm |
| `happy` | Express happiness |
| `holdhand` | Hold hands with someone |
| `hug` | Hug someone |
| `kiss` | Kiss someone |
| `laugh` | Laugh |
| `lurk` | Lurk |
| `nom` | Nom someone |
| `nya` | Nya |
| `pat` | Pat someone |
| `poke` | Poke someone |
| `pout` | Pout |
| `punch` | Punch someone |
| `run` | Run |
| `shocked` | Act shocked |
| `sleep` | Sleep |
| `smug` | Be smug |
| `spin` | Spin |
| `tableflip` | Flip a table |
| `teehee` | Teehee |
| `tickle` | Tickle someone |
| `wave` | Wave |
| `wink` | Wink |
| `yawn` | Yawn |