Add Minecraft <-> Matrix chat bridge for the SMP #7

New Issue

2026-08-02T00:57:16-04:00

jared commented

2026-08-02 00:57:16 -04:00

Bridge in-game chat on lotus-smp-vanilla-mc with a Matrix room, similar in spirit to the existing hookshot webhook integrations (Grafana, Proxmox, Sonarr, etc. -> Spam and Stuff).

Scope (rough)

Minecraft chat messages -> posted into a Matrix room (probably a dedicated room, not Spam and Stuff, since Spam and Stuff is unencrypted/hookshot-only and this would ideally be a normal room)
Matrix messages in that room -> relayed into Minecraft chat (via RCON tellraw/say, or a plugin-side listener)
Join/leave/death messages posted to Matrix too, for the same low-key visibility hookshot gives other services

Relevant existing infra

matrixbot already lives on LXC 151 (/opt/matrixbot), has RCON access to the SMP server (10.10.10.68:25575) as of the !minecraft whitelist command work
RCON auth: MINECRAFT_RCON_HOST/MINECRAFT_RCON_PORT/MINECRAFT_RCON_PASSWORD in /opt/matrixbot/.env, and a minimal socket-based RCON client already exists in matrixbot/utils.py (rcon_command) - no external dependency needed
For MC -> Matrix direction, likely need either a lightweight Paper plugin that POSTs chat events to a webhook (hookshot generic webhook, like the other integrations), or matrixbot polls/tails server logs - plugin+webhook is probably cleaner and matches the existing pattern
For Matrix -> MC direction, matrixbot can already run arbitrary RCON commands (rcon_command helper), so relaying an incoming Matrix message as a tellraw command is straightforward

Not being worked on right now - flagging so it does not get lost.

Bridge in-game chat on lotus-smp-vanilla-mc with a Matrix room, similar in spirit to the existing hookshot webhook integrations (Grafana, Proxmox, Sonarr, etc. -> Spam and Stuff). **Scope (rough)** - Minecraft chat messages -> posted into a Matrix room (probably a dedicated room, not Spam and Stuff, since Spam and Stuff is unencrypted/hookshot-only and this would ideally be a normal room) - Matrix messages in that room -> relayed into Minecraft chat (via RCON `tellraw`/`say`, or a plugin-side listener) - Join/leave/death messages posted to Matrix too, for the same low-key visibility hookshot gives other services **Relevant existing infra** - matrixbot already lives on LXC 151 (`/opt/matrixbot`), has RCON access to the SMP server (10.10.10.68:25575) as of the `!minecraft` whitelist command work - RCON auth: `MINECRAFT_RCON_HOST`/`MINECRAFT_RCON_PORT`/`MINECRAFT_RCON_PASSWORD` in `/opt/matrixbot/.env`, and a minimal socket-based RCON client already exists in `matrixbot/utils.py` (`rcon_command`) - no external dependency needed - For MC -> Matrix direction, likely need either a lightweight Paper plugin that POSTs chat events to a webhook (hookshot generic webhook, like the other integrations), or matrixbot polls/tails server logs - plugin+webhook is probably cleaner and matches the existing pattern - For Matrix -> MC direction, matrixbot can already run arbitrary RCON commands (`rcon_command` helper), so relaying an incoming Matrix message as a `tellraw` command is straightforward Not being worked on right now - flagging so it does not get lost.

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: LotusGuild/matrix#7