monop-board/bot
2026-02-20 21:06:36 +00:00
..
__pycache__ Add project README, fix holdings parser, update bot config for #monop-dev 2026-02-20 21:06:36 +00:00
board_data.py Add IRC bot/parser for monop-irc game state tracking 2026-02-20 21:02:08 +00:00
config.json Add project README, fix holdings parser, update bot config for #monop-dev 2026-02-20 21:06:36 +00:00
monopbot.py Add project README, fix holdings parser, update bot config for #monop-dev 2026-02-20 21:06:36 +00:00
parser.py Add project README, fix holdings parser, update bot config for #monop-dev 2026-02-20 21:06:36 +00:00
README.md Add IRC bot/parser for monop-irc game state tracking 2026-02-20 21:02:08 +00:00
requirements.txt Add IRC bot/parser for monop-irc game state tracking 2026-02-20 21:02:08 +00:00

monop-board IRC Bot

Watches an IRC channel for monop-irc game output and writes game-state.json.

Setup

pip install -r requirements.txt

Configuration

Edit config.json:

{
  "server": "irc.darkscience.net",
  "port": 6697,
  "tls": true,
  "nick": "monopbot",
  "channel": "#your-channel",
  "game_nick": "monop",
  "state_file": "../game-state.json"
}
  • game_nick — the IRC nick of the monop-irc game process
  • state_file — where to write the JSON game state (relative to bot dir)

Usage

python3 monopbot.py

Or with a custom config:

MONOPBOT_CONFIG=/path/to/config.json python3 monopbot.py

The bot will:

  1. Connect to IRC and join the configured channel
  2. Watch for messages from the game bot
  3. Parse game events (rolls, moves, purchases, rent, etc.)
  4. Write updated state to game-state.json after each change