LotusGuild/matrix
1
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity
Files
a67bc2c33bc0f01387e072fc412976784b14e65b
matrix/README.md
Jared Vititoe a67bc2c33b Initial commit: README with project plan and todo list 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-11 00:06:21 -05:00

2.7 KiB
Raw Blame History

Lotus Matrix Bot

Matrix bot for the Lotus Guild homeserver (matrix.lotusguild.org), built with matrix-nio.

Status: Planning

Todo

Core Setup

  • Project scaffolding (bot.py, config, .env, requirements)
  • matrix-nio async client with E2EE support
  • Device verification / trust storage
  • Logging (rotating file + stdout, matching Discord bot pattern)
  • Config validation (homeserver URL, access token, room IDs)
  • Graceful shutdown and reconnection handling

Command Porting (from Discord bot)

  • !help - List all available commands
  • !ping - Bot latency check
  • !8ball <question> - Magic 8-ball
  • !fortune - Fortune cookie message
  • !flip - Coin flip
  • !roll <NdS> - Dice roller
  • !random <min> <max> - Random number generator
  • !rps <choice> - Rock Paper Scissors
  • !poll <question> - Poll (using reactions)
  • !trivia - Trivia game (using reactions for answers)
  • !agent - Random Valorant agent picker
  • !champion - Random LoL champion picker
  • !problem - Canada geese appreciation

Integrations

  • !minecraft <username> - RCON whitelist (Mojang API validation + RCON)
  • !hytale <username> - Hytale whitelist request (audit log to admin room)
  • !ask <question> - Ollama LLM integration (lotusllm model)

Media Commands

  • !kill @user - Kill GIF
  • !punch @user - Punch GIF
  • !hug @user - Hug GIF
  • !revive @user - Revive GIF
  • Media file management (GIF storage and random selection)

Admin Commands

  • !clear <count> - Redact messages (requires power level)
  • !health - Bot stats (uptime, command counts, service status)
  • Power level checks (Matrix equivalent of Discord role checks)

Audit Logging

  • Member join/leave events
  • Message edits and redactions
  • Room state changes
  • Batched audit log posting to admin room

Deployment

  • Systemd service (matrixbot.service)
  • Auto-deploy from Gitea webhook (matching Discord bot pattern)
  • Deployment script (/usr/local/bin/matrix_bot_deploy.sh)
  • Determine host LXC (new container or colocate with Synapse on 10.10.10.205)

Not Porting (Discord-specific)

  • Reaction roles (no Matrix equivalent)
  • Status cycling (Matrix presence is simpler)
  • Guild-specific event handlers (channel create/delete, boost, etc.)

Tech Stack

  • Language: Python 3
  • Library: matrix-nio (with E2EE)
  • Homeserver: matrix.lotusguild.org (Synapse on 10.10.10.205)
  • Dependencies: matrix-nio[e2ee], aiohttp, python-dotenv, mcrcon

Production Server

  • Host: TBD
  • Bot Directory: TBD
  • Service: matrixbot.service

Gitea

Reference in New Issue View Git Blame Copy Permalink