Tuna

First minigames bot for Echoed.

Setup

npm install
cp .env.example .env # add your zbot_ key
npm start

Requires Node.js 20+ (uses node:sqlite).

Commands

Command	Description
!2048 [image|text]	Start 2048. Without an argument the bot asks for a board style.
!stop	Stop your running game and save the score.
!stats	Your games, wins and best score.
!top	Top 10 by best score.
!help	List commands.

Games are controlled with reactions: ⬆️ ⬇️ ⬅️ ➡️ to move, ⏹️ to stop. Text mode redraws in one API call; image mode uploads a rendered PNG per move, so it is slower but prettier.

Layout

src/
index.js entry point — validates the token, wires the gateway
config.js endpoints, prefix, colours, db path
db.js node:sqlite — player stats and match history
echoed/
api.js REST wrapper for the Bot API
gateway.js Socket.IO connection, auth and heartbeat
commands/
index.js command registry and dispatch
games/
sessions.js maps message ids to running games for reaction routing
2048/
board.js pure game rules — no I/O
game.js session: move queue, embeds, lifecycle
render.js board to PNG
test/ board rules and move-queue tests

Tests

npm test