Strife

Strife is board games in Discord.

This is the rescoped rewrite of PlayCord. This project has taken me a lot of time and effort to get right, so a star and a follow would be greatly appreciated (I love seeing number go up)

Invite

You can use the link below:

Invite Strife

PSA: the bot is NOT hosted currently because I'm still trying to polish it.

In the Discord Developer Portal, create an app, add a bot, and turn on:

• Server Members
• Message Content

Invite with applications.commands and bot. Permissions:

• View Channels, Send Messages, Send Messages in Threads
• Create Public Threads, Manage Threads
• Embed Links, Attach Files, Use External Emojis
• Add Reactions, Read Message History

After starting the bot, upload application emoji with strife/emoji

If you end up hosting the bot, point the app’s privacy-policy URL at docs/privacy.md (or a similarly worded copy). As a reminder, the

Commands

I tried my best to make this as intuitive as possible. Suggestions are appreciated :3

Command	What it does
/play	Start a lobby (game: required, private: optional)
/strife catalog	Browse games. Play posts a public lobby in the channel
/strife profile	Wins, losses, recent matches (user:, game:, page: optional)
/strife replay	Open a finished match by 6-character code
/strife forfeit	Forfeit a live game (leave a lobby with Leave / /strife lobby leave)
/strife settings	Lobby settings (creator edits; members can view)
/strife server	Default lobby channel (administrators)
/strife about	About, attributions, and Changes
/strife lobby join/leave/ready	Join by creator, leave, ready. Everything else is on the lobby message

Games

Tic-Tac-Toe, Connect Four, Chess, Coup, Mafia, Spyfall, Liar’s Dice.

There is also an API Test game used for development that is disabled by default.

Self-host

Needs Python 3.14 and PostgreSQL.

cp .env.example .env
# set STRIFE_DISCORD_TOKEN and STRIFE_OWNER_IDS

docker compose up --build

Or run the bot on the host against local Postgres (not officially supported):

python -m pip install -e .
python -m strife

Game extras (Chess: chess, resvg-py) live in each plugin’s plugin.toml, not this package. Docker installs shipped extras at image build. A host install pip-installs missing extras on boot unless STRIFE_SYNC_PLUGIN_DEPS=false. Compose mounts ./plugins. strife/install needs git on PATH (the Docker image has it).

Once the bot is online, in a server where you are in STRIFE_OWNER_IDS:

• run strife/sync to register slash commands (STRIFE_SYNC_ON_START=true to sync every boot, probably not reccomended)
• run strife/emoji to upload assets/emoji/ and each plugin’s emoji/ folder into Discord's backend

Owner (message) commands

Type strife/… at the start of a message. You must be in STRIFE_OWNER_IDS for this to work.

Command	What it does
strife/sync	Push slash commands (global, local, or a guild id)
strife/emoji	Re-upload application emoji
strife/dbreset confirm	Wipe the database and re-run migrations
strife/plugins	List builtin and installed games
strife/install <git-url> [ref]	Install a game from git
strife/install <key>	Restore an uninstalled builtin
strife/update <key> [ref]	Replace a git plugin’s files; keep match history
strife/uninstall <key> confirm	Remove a game and delete its match history

To hide a game without deleting history, set enabled: false in config/games.yaml. Uninstall wipes matches and stats. See docs/plugins.md.

Write a game yourself!

Doc	For
game-development.md	Tutorial
game-api.md	Methods and move log
plugins.md	Install / update / uninstall
game-architecture.md	How the host loads a game

python scripts/scaffold_game.py my_game "My Game"
python scripts/run_game.py my_game

Third-party games: GitHub template in templates/game-plugin/, then strife/install <url>. Each plugin has plugin.toml and changelog.toml (shown in /strife about → Changes).

License

GPLv3: LICENSE. Data privacy notes: docs/privacy.md.