Matrix Bridge (Better Than Adventure)
Matrix Bridge mod creates a seamless connection between Minecraft server chat and a Matrix room. Using this modification, Matrix participants can communicate directly with players in Minecraft without entering the game world.
Main Features
The system transmits various alerts in both directions: server startup and shutdown, player connections and disconnections, character death cases, and in-game chat messages. Additionally, support for "!ping", "!list", and "!invite
Technically, the bridge focuses only on standard password-based authentication. Token-based access or single sign-on systems are not currently supported.
Configuration Setup
Configuration file is located at 'matrix-bridge/config.json'.
Example configuration file:
"version": 1, # DO NOT MODIFY. Used to determine if configuration update is needed
"homeserver": "https://example.org", # Synapse server address. Delegation is supported.
"username": "user", # Local part of user's MXID before domain
"password": "password", # User's password. Tokens and SSO are not supported.
"deviceName": "Matrix-Minecraft Bridge", # Device name
"verifyType": "KEY", # Can be either KEY or PASSPHRASE
"verifyToken": "AaAA aaAa AAaa...", # Corresponding value for verifyType. Example uses KEY
"room": "!Msdjfjxcjdj323:example.org", # Internal room identifier
"verbose": false, # Enables detailed Trixnity log messages. Useful for debugging.
"commandInvite": true, # Whether !invite command is enabled
"messagePlayer": "[§e%player%§r] ", # %player% is replaced with player's username
"messageStart": "❇ Server started",
"messageStop": "🛑 Server stopped",
"messageJoin": "🟡 %player% joined the game",
"messageLeft": "🟡 %player% left the game",
"messageDeath": "🪦 %message%",
"messageList": "📜 Online players: ", # Displays before the player list
"messagePong": "🏓 Pong!",
"messageInvalid": "⛔ Command not found! Available commands: !ping, !list, !invite <username>",
"messageDisabled": "⛔ Command disabled! Please contact an administrator if this is an error.", # Used when invite command is disabled
"messageWhitelistSuccess": "🔵 '%player%' has been whitelisted!",
"messageWhitelistError": "🔵 '%player%' could not be found.",
"messageWhitelistAlready": "🔵 '%player%' is already whitelisted!",
"messageChat": "<%player%> "Important configuration notes:
- Homeserver address must include 'http(s)' prefix. Example: 'https://example.org'
- Username is specified only as local part: 'user', not '@user:example.org'
- For rooms, specify the full identifier: '!Msdjfjxcjdj323:example.org'
If you're unsure about your homeserver address, you can find it in Element under 'Settings' → 'Help & About' → 'Advanced'.
Technologies Used
Matrix Bridge utilizes Trixnity Matrix SDK for interaction with the Matrix platform and requires Fabric Language Kotlin for operation in the Fabric environment.
Rendering: Mooctip
This modification is only compatible with the 'Better Than Adventure' mod package. For standard Minecraft versions, the corresponding mod version should be used.
