SPRITEbot

Quick start

Quick Start Guide

The short version of using SPRITEbot in Discord: join a game, make a character, then roleplay, roll dice, and manage inventory without leaving the server.

For players

Join a game and start playing.

  1. Join a public game with /join-game.
  2. Pick the game from the menu.
  3. Create a character with /create-character.
  4. Fill in the required character fields.
  5. Submit the character draft.
  6. Use /switch-character if you have more than one character.
  7. Use /ic in a roleplay channel when messages should post as your character.
  8. Use /ooc in that channel when you want normal Discord messages again.
Your active game matters.It controls which characters, fields, and sheet details Spritebot uses for you. Use/switch-game if you are in more than one game.

Characters

Create, view, and switch character sheets.

Run /create-character after joining a game. Spritebot opens an interactive draft where you pick a field, fill in the modal, and continue until the required fields are complete.

Common fields

  • Name
  • Bio
  • Avatar URL
  • RP Display Name
  • RP Display Avatar URL
  • Game-specific fields such as HP, Strength, Class, Skills, or Notes

Useful commands

  • /view-character shows your active sheet.
  • /switch-character changes your active character.
  • /list-characters browses public characters in the current game.
  • /restore-character recovers a character for up to 30 days after deletion.
RP display name and avatar

RP display fields control webhook roleplay posts. They can be shorter names, titles, disguises, or alternate avatar URLs. If left blank, Spritebot falls back to your normal character name and avatar.

To edit them later, run /view-character, use the edit button, choose the RP display field, and submit the new value.

Deleted a character by mistake?Run /restore-character within 30 days while you are in the same server and active game. Restored characters return as private so you can review them first.

Roleplay proxy

Post as your active character.

Use /ic in a channel to turn on in-character proxy mode for yourself in that channel. Use /ooc in the same channel to turn it off.

Write a normal messageSpritebot reposts through a webhookYour original message is deleted after success
Long posts, edits, and deletes

Spritebot supports roleplay posts up to 4000 characters. Longer Discord messages can be split into multiple proxied messages, and text attachments named message.txtcan be proxied when they fit the supported limit.

Use /ic-edit message:<message id or message link> or right-click your proxied message and choose Apps, then Edit IC Message. Use/ic-delete message:<message id or message link> to delete one of your own proxied messages, or right-click it and choose Apps, thenDelete IC Message. Spritebot only allows you to edit or delete messages proxied by your own Discord account.

Each chunk of a split roleplay post is a separate Discord message. Edit the specific chunk you want to change, or delete each chunk separately.

Copying a message link or ID

On desktop Discord, right-click the proxied message and chooseCopy Message Link. For raw IDs, enable Developer Mode in User Settings, then right-click the message and choose Copy Message ID.

Inventory

Manage items for the active character.

Run /inventory to view and manage your active character's items. You can also open inventory from /view-character. Large inventories use separate paginated views so character sheets stay readable.

Add items

Open inventory, choose Add Item, enter the name, and optionally add type, quantity, and description.

Edit details

Pick an item from the inventory dropdown, choose View/Edit Item, then update the modal fields.

Equip or delete

Select an item, then choose Equip Item, Unequip Item, orDelete Item. Use Delete All carefully.

Dice

Roll dice in strict notation.

Use /roll dice:3d6 for a quick result. Spritebot supports rolls from1d2 through 15d999, including uppercase notation like2D20.

Example resultRobin Sage rolled 4d20: [14, 14, 13, 1] = 42

Rolls use cryptographic local randomness, which is suitable for normal table play but is not publicly verifiable like a shared-seed system.

Voice transcription

Capture a raw session transcript.

GMs can run/transcribe start voice-channel:<voice channel> text-channel:<text channel>to begin. Spritebot listens without posting live updates, then attaches one raw.txt transcript to the chosen text channel when the session ends.

Check progress

Run /transcribe status to see the channels, participant count, and number of speech segments transcribed so far.

Finish the session

Run /transcribe stop. Spritebot finishes in-progress work and posts the timestamped transcript. It also stops automatically if everyone leaves voice.

Transcription is best-effort.The output is intentionally raw and may mishear names, accents, overlapping speakers, background noise, or Discord audio glitches.

For GMs

Create games, configure fields, and keep sessions moving.

  1. Run /create-game name:<name> description:<description>.
  2. Define game-specific character fields with the buttons Spritebot shows.
  3. Add fields players should fill in, such as HP, Class, Strength, Skills, or Notes.
  4. Publish the game when players should be able to join it.
  5. Use /view-game later to manage fields or publish status.
Thread bumping

If thread bumping is configured, use /bump-thread actions such asadd, remove, list, bump-now,set-note, and set-interval to keep important threads active.

Troubleshooting

When something feels stuck.

  • If /create-character says you have not joined a game, run /join-game first.
  • If a game has no stat fields, ask the GM to finish setting up the game fields.
  • If roleplay proxying does not start after /ic, check that you are typing in the same channel.
  • If proxying says you have no active character, run /switch-character.
  • If a proxied post has the wrong name or avatar, update RP Display Name or RP Display Avatar URL.
  • If /ic-edit or /ic-delete cannot find the message, copy the webhook message Spritebot posted.
  • If /ic-edit or /ic-delete says the message is not yours, it was proxied by another Discord account.
  • If /restore-character does not show a character, check that you are in its original server and active game.