# MatrixSRV
\nA simple bridge between Minecraft and Matrix. Made with blood, sweat, and Trixnity<\/p>\n
<\/p>\n
NOTICE: MatrixSRV does **_NOT_** work in encrypted rooms. Once encryption is enabled it cannot be disabled, and you will have to make a new room<\/p>\n
## Why MatrixSRV
\nThis plugin connects your Minecraft server chat to a Matrix room, so messages appear in both places at the same time.
\nPlayers can chat from inside Minecraft while others can join the conversation from Matrix, even when they are not in-game.
\nIt\u2019s easy to set up and helps keep your community connected outside the server.
\nMatrixSRV also has an optional dependancy with DiscordSRV, to keep messaging with both platforms as seamless as possible!<\/p>\n
## Who is this for?
\nThis plugin is for Minecraft server owners who want to stay in touch with their community, moderators who want to monitor chat remotely, and players who want to keep chatting when they are not online in Minecraft.<\/p>\n
## Features!
\n– Listens to player chat messages
\n– Listens to player deaths
\n– Listens to player join\/leave
\n– Listens to player advancements
\n– Listens to player `\/me` commands
\n– Forwards most standard matrix messages (including all file types, and 3 text formats)
\n– RELOADABLE config, with preferences
\n– Copyleft FOSS project
\n– Broadcast command
\n– OPTIONAL compatability with DiscordSRV
\n– AND MORE!<\/p>\n
## Compilation
\nAlthough the Modrinth page is public, it is highly recommended that you compile the plugin on your own:<\/p>\n
1. Clone the git repository
\n – `git clone https:\/\/git.gay\/Stigstille\/MatrixSRV`
\n2. Enter the project files
\n – `cd .\/MatrixSRV`
\n3. Build and Compile the plugin
\n – `.\/gradlew shadowJar`
\n4. Find the freshly generated plugin
\n – Should be located at `.\/build\/libs\/MatrixSRV-x.x.x-all.jar`<\/p>\n
## Commands ## Config # Preferences forward-me-command: true canned-responses: {“!ip”: “play.example.com”, “!seed”: “The seed for this world is …”} A free and open source project that bridges your Minecraft chat to a Matrix Room of your choice!<\/p>\n","protected":false},"featured_media":98748,"template":"","meta":{"_minecraft_slug":"matrixsrv","_minecraft_project_id":"B4AKBohJ","_minecraft_author":"Stigstille","_minecraft_license":"AGPL-3.0-or-later","_minecraft_downloads":85,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"matrixsrv.zip","_minecraft_size_bytes":134699439,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-15T20:11:06.164485Z","_minecraft_date_created":"2026-02-16T22:40:21.241766Z","_minecraft_date_modified":"2026-03-06T18:19:23.096948Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/matrixsrv","_minecraft_icon_attachment_id":98748,"_minecraft_imported_at":"2026-06-05T16:07:50+00:00","_minecraft_import_hash":"d6fab6750b6a0263eb0239d285d4d649","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,127,128,867,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-98747","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/matrixsrv`: Shorthand for `\/matrixsrv source`
\n– `\/matrixsrv source`: Shows players a clickable URL to the source code, along with a copy of the license
\n– `\/matrixsrv broadcast
\n– `\/matrixsrv reload`: Reloads the configuration. (Server still needs a restart to change the Access Token or the Homeserver<\/p>\n
\nYou can find the configuration file after starting the server with the plugin for the first time.
\n“`yaml
\n# Your Bot’s Access token.
\n# It is not recommended to use the Access token for your own account
\nmatrix-access-token: “CHANGEME_THISISNOT_AREALVALUE”
\n# The ID for the room that should be bridged
\nmatrix-channel-link: “!somewhere:over.therain.bow”
\n# Your homeserver.
\n# If you don’t know what this is, you *probably* shouldn’t touch this
\nmatrix-homeserver: “https:\/\/matrix.org”<\/p>\n
\nshow-full-matrix-uname: false<\/p>\n
\nme-command-permission: “minecraft.command.me”<\/p>\n
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"