A-Bot

A multi-purpose Discord bot built with inspiration from the University of Michigan EECS 370 course Discord server. Adapted from zombbblob.

Features

BotCasino — join a virtual casino, get a job, earn coins, and gamble them away
Server management — send messages, reply, react, create semester channels, and generate invite links as the bot
EECS 370 utilities — quick links to course notes
Reaction roles — automatic role assignment via message reactions
Auto-replies — replies “Soon:tm:” to messages asking when exams, grades, and the like are coming

Setup

Prerequisites

Node.js >= 24 (see .nvmrc)
Yarn 4.x (via corepack enable)

Discord setup

Create an application in the Discord Developer Portal and add a Bot to it.
Copy the bot token — this becomes DISCORD_TOKEN in your .env.
Under Bot → Privileged Gateway Intents, enable Message Content Intent and Server Members Intent (both are required and off by default).
Generate an invite URL (OAuth2 → URL Generator) with the bot and applications.commands scopes, and grant the permissions the bot needs: Manage Roles, Manage Channels, Create Invite, Add Reactions, Send Messages.
Invite the bot to your server with that URL.

Note: Slash commands are registered globally on startup, so they can take up to an hour to propagate the first time.

Server-specific IDs: The default role IDs (reaction roles) and invite channel ID target the original EECS 370 server. When self-hosting, override them in .env (see below), or those features will not work / will link to the wrong server.

Installation

corepack enable
yarn install

Copy .env.example to .env and fill in your values:

cp .env.example .env

Variable	Required	Description
`DISCORD_TOKEN`	Yes	Bot token from the Discord Developer Portal
`ROLE_MESSAGE_CHANNEL`	No	Channel ID of the reaction-role message, used to prefetch it at startup
`ROLE_MESSAGE_ID`	No	Message ID users react to for roles (🖥️ = Student, 🎓 = Student Alum); unset disables reaction roles
`STUDENT_ROLE_ID`	No	Role granted for 🖥️ (defaults to the EECS 370 server’s role)
`STUDENT_ALUM_ROLE_ID`	No	Role granted for 🎓 (defaults to the EECS 370 server’s role)
`INVITE_CHANNEL_ID`	No	Channel `/invite` creates invites for (defaults to the EECS 370 server)
`STATIC_INVITE_URL`	No	Invite returned by `/invite` with no arguments
`DB_PATH`	No	SQLite database path (defaults to `db/casino.db`)

Development

yarn dev

Build & Run

yarn build
yarn start

Or in one step: yarn prod.

Tests

yarn test

Scripts

Script	Description
`yarn dev`	Run from source with live reload (tsx watch)
`yarn build`	Compile TypeScript to `dist/`
`yarn start`	Run the compiled bot
`yarn prod`	Build, then start
`yarn test`	Run the test suite (node:test via tsx)
`yarn typecheck`	Typecheck all sources and tests without emitting
`yarn lint`	Lint with ESLint (`yarn lint:fix` to auto-fix)
`yarn format`	Format with Prettier (`yarn format:check` to verify)
`yarn db:reset`	Delete the casino database (destructive)

Database

Casino state (balances, jobs, bonus and work timestamps) is stored in a SQLite database at db/casino.db, created automatically on first run. The database uses WAL journal mode, so casino.db-wal and casino.db-shm sidecar files will appear alongside it. The db/ directory is gitignored. To wipe all casino state, run yarn db:reset (destructive, cannot be undone).

Commands

Command names are derived from the file basenames in src/commands/, lowercased.

General

Command	Description
`/help`	Prints the help menu
`/ping`	Checks the bot is responsive
`/sourcecode`	Links to this repository
`/gpr`	Grass privileges revoked

EECS 370

Command	Description
`/coursenotes`	Link to the unofficial course notes

Server

Command	Description
`/invite [n]`	Generate an invite link with optional limited uses (1-100)

Administration (requires Administrator permission)

Command	Description
`/send <channel> <message>`	Send a message as the bot
`/reply <message_link> <reply_text>`	Reply to a message as the bot
`/react <message_link> <emoji>`	React to a message as the bot
`/create <semester-year>`	Create a semester category with channels (e.g. `F23`)

BotCasino

Command	Description
`/joincasino`	Join the casino
`/leavecasino`	Leave the casino (cannot be undone)
`/getjob`	Get assigned a random job for coin income
`/work`	Earn your hourly paycheck (1h cooldown)
`/bonus`	Claim a one-time starting bonus (random 500-1499 coins)
`/coins [user]`	Check your or another user’s balance
`/dice <bet>`	Roll dice against the house (30s cooldown)
`/roshambo <bet>`	Play rock paper scissors (30s cooldown)
`/coinflip <bet>`	Flip a coin, heads or tails (30s cooldown)

Game rules: games pay out your bet amount on a win and take it on a loss; ties return the bet. Dice pays 2x on a winning double and 4x on winning double sixes.

Project structure

src/
├── index.ts          # Client setup, command/event loader, interaction dispatch
├── config.ts         # Environment-derived configuration
├── db.ts             # SQLite persistence layer (better-sqlite3)
├── types.ts          # Command interfaces
├── lib/              # Pure, unit-tested game/validation/formatting logic
├── commands/         # Slash commands (filename = command name)
└── events/           # Event handlers (directory name = Discord event)
test/                 # node:test suites

Contributing

A-Bot is open source — contributions are welcome! See CONTRIBUTING.md for the development workflow.

License

This site is open source. Improve this page.