Skip to content
Matterbridge link for Minecraft Server chat. Simple bridge between Minecraft, Mattermost, IRC, XMPP, Gitter, Slack, Discord, Telegram, Rocket.Chat, Hipchat(via xmpp), Matrix and Steam.
Kotlin Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
1.12.2 accept older forge versions Nov 28, 2018
1.7.10 remove gson dependency, update dependency checks Dec 11, 2018
1.9.4 update to kotlin 1.3 Nov 2, 2018
Jankson @ 7d27c28 update to kotlin 1.3 Nov 2, 2018
buildSrc/src/main/kotlin update to kotlin 1.3 Nov 2, 2018
core remove gson dependency, update dependency checks Dec 11, 2018
gradle/wrapper add jankson dependency Jun 22, 2018
scripts remove gson dependency, update dependency checks Dec 11, 2018
.gitignore update gitignore Nov 28, 2018
.gitmodules update 1.12.2 with locations Aug 14, 2018
Jenkinsfile revert dropping 1.7.10, adding 1.9.4 instead of 1.10/1.11 Aug 16, 2018
LICENSE
README.md revert dropping 1.7.10, adding 1.9.4 instead of 1.10/1.11 Aug 16, 2018
TODO.MD update to kotlin 1.3 Nov 2, 2018
build.gradle update to kotlin 1.3 Nov 2, 2018
gradle.properties update cursegradle Apr 3, 2019
gradlew make gradlew exutable Jan 27, 2018
gradlew.bat oops Jan 19, 2018
matterbridge-sample.toml add more know properties to the RESPONSE template Feb 24, 2018
settings.gradle revert dropping 1.7.10, adding 1.9.4 instead of 1.10/1.11 Aug 16, 2018

README.md

Discord Discord Download 1.12.2 Jenkins Patreon

MatterLink

A Matterbridge endpoint for MC servers!

THIS MOD REQUIRES YOU TO ALSO RUN A MATTERBRIDGE RELAY https://github.com/42wim/matterbridge

Chat with us on IRC: #matterlink @ irc.esper.net

Downloads

Github All Releases

Jenkins

Files

Download 1.12.2

Download 1.9.4

Dependencies

Forgelin Files

Features

Custom bridge commands

includes pass-through to Minecraft commands!
Default commands: help, tps, list, seed, uptime

Commands are specified in JSON format as follows:

Passthrough command (executes the configured command from the MC server console)

{
    "tps": {
        "type": "PASSTHROUGH",
        "execute": "forge tps",
        "permLevel": 0,
        "help": "Print server tps",
        "allowArgs": false
    }
}

Response command

{
    "uptime": {
        "type": "RESPONSE",
        "response": "{uptime}",
        "permLevel": 1,
        "help": "Print server uptime",
        "allowArgs": false
    }
}

Acount Linking

To link your chat account to your minecraft uuid
execute !auth Username
make sure to use the proper username and command prefix, the system will then guide you through

internally the identity links are stored like so:

{ 
    /* username: NikkyAi */ 
    "edd31c45-b095-49c5-a9f5-59cec4cfed8c": { 
        /* discord id */ 
        "discord.game": [ 
            "112228624366575616"
        ]
    }
}

Command permissions

Higher numbers mean more permissions. Configured per uuid.

{
  "edd31c45-b095-49c5-a9f5-59cec4cfed8c": 9000
}

Reload

Edit and reload the config file without restarting the server!

/ml <connect|disconnect|reload>
    connect:    Connects the MC chat to the MatterBridge server
    disconnect: Disconnects the chat from the MatterBridge server
    reload:     Disconnects, reloads the config and custom command files, 
                then reconnects.

Setup

Requires the matterbridge config api section to be setup along these lines:

Local

If ou know the matterbridge will run on the same machine as the Minecraft Server

[api]
[api.local]
    BindAddress="127.0.0.1:4242" // Listens only for localhost
    #OPTIONAL (no authorization if token is empty)
    Token="" # Token left empty
    Buffer=1000
    RemoteNickFormat="{NICK}"
    ShowJoinPart = true

With this you need no extra configuration steps.. just run matterbridge and then start the minecraft server (or reload matterlink with command if it runs already)

Remote

If the matterbridge runs on a different machine

[api]
[api.local]
    BindAddress="0.0.0.0:4242"
    #OPTIONAL (no authorization if token is empty)
    Token="mytoken"
    Buffer=1000
    RemoteNickFormat="{NICK}"
    ShowJoinPart = true

you need to know the ip / domain of the matterbridge and the token used, enter them in the ´connection' section in the config and reload matterlink

Sample

Install matterbridge and try out the basic sample:

go get github.com/42wim/matterbridge
mv matterbridge-sample.toml matterbridge.toml
matterbridge

now start the server with matterlink (and forgelin) in the mods folder

and then RTFM!!! and configure all your needed gateways, endpoints etc

powered by wishful thinking

You can’t perform that action at this time.