starengine is a Discord bot designed to allow for play of the Ironsworn: Starforged roleplaying system over Discord. The bot enables play-by-post gameplay with interactive commands, oracle rolls, and move resolution.
If you are familiar with hosting Discord bots yourself for personal use, you may deploy this bot on your own server.
Requirements
- Bun Runtime
- Discord bot token provided as a
DISCORD_TOKENenvironment variable. You can obtain one by creating a new bot application on the Discord Developer Portal.
# Install dependencies
bun install
# Run the bot
bun run start# Install dependencies
bun install
# Run in development mode with auto-reload
bun run dev
# Run in production mode
bun run start
# Run all tests
bun test
# Run specific test file
bun test src/core/custom-id.test.ts
# Lint and format code
bunx @biomejs/biome check --write