Matterbridge link for Minecraft Server chat.

Elytra

Last update: Mar 28, 2022

Related tags

Overview

MatterLink

Downloads
Dependencies
Features
Setup

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

Dependencies

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:    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

Comments

Not getting the /config command

i installed the lastest release for 1.12 on a sevtech: ages server and the /config command does not show up. I'm having other issues too, but i'm pretty sure those are my-side right now.

opened by jasperfirecai2 8
Build MatterLink as a Spigot/Bukkit plugin

Currently, MatterLink is a mod for Forge. But would it be possible to extend it to also support building it as a plugin for Spigot/Bukkit?

Spigot supports plugins written in Kotlin, so I guess it should be easy to add the correct event handlers. But I don't know how to setup a project which supports Forge and Spigot/Bukkit from the same code base.

I have some knowledge in writing plugins using the Bukkit API, but I have no knowledge of Kotlin at all.

opened by Programie 5

Error repeatedly logs

Hi,

A friend and I have tried to set up a matterlink and bridge but we've currently run into this issue whenever we type something in minecraft:

[21:09:59] [Server thread/INFO] [STDERR]: [matterlink.api.MessageHandler:transmitMessage:161]:  at matterlink.api.MessageHandler.transmitMessage(MessageHandler.java:166)
[21:09:59] [Server thread/INFO] [STDERR]: [matterlink.api.MessageHandler:transmitMessage:161]:  at matterlink.api.MessageHandler.transmit(MessageHandler.java:119)
[21:09:59] [Server thread/INFO] [STDERR]: [matterlink.api.MessageHandler:transmitMessage:161]:  at matterlink.api.MessageHandler.stop(MessageHandler.java:61)

these three lines keep repeating themselves and time everyone out from the server. What other info do you need from me to help resolve this? NikkyAI/MatterLinkAPI#1

opened by jasperfirecai2 2

Log "spam", user disconnected

http://prntscr.com/k19idg

This is not anything important but if a user keeps relogging it will start to spam console. I suggest only printing this message if its used and not empty.

https://github.com/elytra/MatterLink/blob/master/core/src/main/kotlin/matterlink/handlers/JoinLeaveHandler.kt#L20

opened by Wurmatron 1
multi gateway
support multipl gateways based on

position

dimension

we also want ot be able to map from gateway (incoming) to dimesnion and location as well as chat range

config sketch:

gateways.json

{ "default": "global", "mapping": { "global": [ { "dimension": 0 } ] "gateway1": [ { "x": 123, "y": 456, "z": 678, "range": 90, "dimension": 0 }, { "dimension": 2 } ] } }

missing location / range values would imply to be dimension-global

dimension must be specified to define location restrictions

how do we handle chat in a not defined location ? options

send to the default / global
how do we handle chat coming back then ? make it all global ?

ignore it
you are in a unmapped area .. maybe that is intended

this does not handle possibilities of priorities.. areas enclosing other areas, etc for that we would likely need to use rulesengine
opened by NikkyAI 1
logger log4j method not found

using Minecraft 1.7.10 (modpack Tekkit Legends)
using MatterLink MatterLink-1.7.10-1.6.3.jar in mods folder.
matterbridge is running and also working between telegram and discord. MatterLink now should be added to the pipe.
But when the Minecraft Server starts, the error
java.lang.NoSuchMethodError: org.apache.logging.log4j.Logger.info(Ljava/lang/String;Ljava/lang/Object;)V
occures.
Is there no log4j compiled in the jar? How to add such a specific dependency?

opened by toddeTV 0
prefixed commands and other things on the TODO list
we need commands that can be executed from the bridge using a configurable prefix

example: !players

later we want to register more commands and configure whhere/who cna invoke them (bridged-chat, ingame-chat, ingame-ops & server)

maybe add a mapping in the config for easily addding custom commands

example:

structure

info: text: get the the client here.. (insert url) and connect to (insert server url) permission: [bridge, chat, op] targets: [bridge, chat] # possibly console too consume_invocation: true # do not send the invocation command to the mc server (or the other way around)

other possibilities include.. replacing text in the text variable, eg {{PLAYERNAME}}

mapping different responses (as differend strings can be replaced in different context) example:

bacon: response: bridge: "spam spam spam spam" chat: "spammedy spaaaaam" console: "and eggs - {{COMMAND_SENDER}}"

iuf we find a usable string templating engine that can do loops and similar things too we cna implement playerlist and other features completly config driven too.. until then we hardcode things
opened by NikkyAI 0
Additional Documentation

Hey, this looks like a useful tool for MC, could you add a few clarifications to the documentation though? I assume this tool is a mod meant to work with Forge, rather than a standalone program or server plugin? Also is there any confirmation or any plans for 1.14 support?

opened by makcuber 1
Server crash

Apparently server crashes when empty message or message containing some special symbols sent, but I'm not sure Crash log: https://pastebin.com/akB9BMKG

opened by Lgmrszd 3

Internal Server Error (IllegalArgumentException)

java.lang.IllegalArgumentException: bound must be positive
at java.util.Random.nextInt(Random.java:388) ~[?:1.8.0_191]
at matterlink.handlers.DeathHandler.handleDeath(DeathHandler.kt:23) ~[DeathHandler.class:?]
at matterlink.EventHandler.deathEvent(EventHandler.kt:71) ~[EventHandler.class:?]

Log: https://pastebin.com/QrAn2isR

opened by Wurmatron 0

Releases(1.6.4)

1.6.4(Apr 3, 2019)
update cursegradle

remove gson dependency, update dependency checks

fix update check for CI builds

update gitignore

make location logging also debug instead of info

reduce info logging

accept older forge versions

do not use the same arguments as nonce and perm level

little bit of debugging help

fix potential library mismatch.. again

bumping forgelin, kotlin and libraries version

fix strict json parsing

make sure debug logging is actually debug

fix idiotic errors in config

make json parsing nonstrict

update coroutines

fix dependency mismatch with Forgelin

forgot to shadow kotlinx-serialization-runtime

bump Fuel version

fix async mess

version bump

update to kotlin 1.3

update Jankson

revert dropping 1.7.10, adding 1.9.4 instead of 1.10/1.11

move api into core

update 1.12.2 with locations

drop 1.7.10 support

Source code(tar.gz)
Source code(zip)
MatterLink-1.12.2-1.6.4.jar(3.89 MB)
MatterLink-1.7.10-1.6.4.jar(8.16 MB)
MatterLink-1.9.4-1.6.4.jar(3.52 MB)
1.6.3(Aug 8, 2018)
release 1.6.3

improve color stripping

ignore Jankson in sonarqube

add sonarqube

add IllegalArgument checks, because parsing UUID can throw

fix curse update check

add update checks to jenkins builds

add avatars for players and server user

adding version command for simplified debugging of user issues

cleanup gradle stuff

improve logging

fixed crash due to runtime constraints

execute bridge commands ingame

paste long output

update README

add linking chat accounts to uuid

remove attempts at cleanup

clean git mess, loads of jenkins experimentation

update jankson

buildscript cleanup for 1.10 and 1.11

reduce INFO spam from messages

Source code(tar.gz)
Source code(zip)
MatterLink-1.10.2-1.6.3.jar(269.38 KB)
MatterLink-1.11.2-1.6.3.jar(269.32 KB)
MatterLink-1.12.2-1.6.3.jar(290.23 KB)
MatterLink-1.7.10-1.6.3.jar(7.25 MB)
1.6.2(Jun 28, 2018)
add more extensions for Jankson

add badges to top of readme

fix defaults for incomingOptions and remnants of space-seperated emoji

fix NPE in Jankson and finetune hjson loading

this really should not break

add option to disable req command globally

raise permission requirement for exec

added permisssion request commands

switch main config to hjson

improve type adapters for CustomCommand

implemented jankson loading for commands and permissions

add jankson dependency

Source code(tar.gz)
Source code(zip)
MatterLink-1.10.2-1.6.2.jar(206.46 KB)
MatterLink-1.11.2-1.6.2.jar(206.46 KB)
MatterLink-1.12.2-1.6.2.jar(221.81 KB)
MatterLink-1.7.10-1.6.2.jar(1.25 MB)
1.6.1(Jun 17, 2018)
lower permission requirement for uptime

fix small typo

changing allowArgs to regex check

fix colorcodes in death message

small cleanup

Source code(tar.gz)
Source code(zip)
MatterLink-1.10.2-1.6.1.jar(135.79 KB)
MatterLink-1.11.2-1.6.1.jar(135.79 KB)
MatterLink-1.12.2-1.6.1.jar(150.41 KB)
MatterLink-1.7.10-1.6.1.jar(1.17 MB)
1.6.0(May 24, 2018)
fix actions not sending / receiving properly

actually stripping colors attempt 3 and counting

actually stripping colors attempt 2

add color stripping to incoming chat

fix NPE in kotlin.. and several smaller issues

fix dangling import

add colorcode stripping

fix readme

add exec command to the defaults

Source code(tar.gz)
Source code(zip)
MatterLink-1.10.2-1.6.0.jar(134.89 KB)
MatterLink-1.11.2-1.6.0.jar(134.90 KB)
MatterLink-1.12.2-1.6.0.jar(149.38 KB)
MatterLink-1.7.10-1.6.0.jar(1.16 MB)
1.5.9(May 21, 2018)
allow execute commands to run as op

Source code(tar.gz)
Source code(zip)
MatterLink-1.10.2-1.5.9.jar(122.77 KB)
MatterLink-1.11.2-1.5.9.jar(122.77 KB)
MatterLink-1.12.2-1.5.9.jar(134.11 KB)
MatterLink-1.7.10-1.5.9.jar(1.14 MB)
1.5.8(May 21, 2018)
keep track of default commands for updating

Source code(tar.gz)
Source code(zip)
MatterLink-1.10.2-1.5.8.jar(122.10 KB)
MatterLink-1.11.2-1.5.8.jar(122.10 KB)
MatterLink-1.12.2-1.5.8.jar(133.34 KB)
MatterLink-1.7.10-1.5.8.jar(1.14 MB)
1.5.7(May 9, 2018)
hotfix, blame past me

version bump

Added submodule api

Source code(tar.gz)
Source code(zip)
MatterLink-1.10.2-1.5.7.jar(119.73 KB)
MatterLink-1.11.2-1.5.7.jar(119.73 KB)
MatterLink-1.12.2-1.5.7.jar(130.76 KB)
MatterLink-1.7.10-1.5.7.jar(1.14 MB)
1.5.6(May 7, 2018)
updated defaults, added whoami

Badges on all the README's and code formatting

Source code(tar.gz)
Source code(zip)
MatterLink-1.10.2-1.5.6.jar(1.06 MB)
MatterLink-1.11.2-1.5.6.jar(1.06 MB)
MatterLink-1.12.2-1.5.6.jar(1.08 MB)
MatterLink-1.7.10-1.5.6.jar(2.24 MB)
1.5.5(Apr 22, 2018)
fix gson type confusion bug

Source code(tar.gz)
Source code(zip)
MatterLink-1.10.2-1.5.5.jar(1.07 MB)
MatterLink-1.11.2-1.5.5.jar(1.07 MB)
MatterLink-1.12.2-1.5.5.jar(1.08 MB)
MatterLink-1.7.10-1.5.5.jar(2.24 MB)
1.5.4(Apr 15, 2018)

1.5.4
Source code(tar.gz)
Source code(zip)
MatterLink-1.10.2-1.5.4.jar(1.07 MB)
MatterLink-1.11.2-1.5.4.jar(1.07 MB)
MatterLink-1.12.2-1.5.4.jar(1.08 MB)
MatterLink-1.7.10-1.5.4.jar(2.24 MB)
1.5.3(Mar 8, 2018)
oops

fix 1.7.10 relations, update license

update update checker

Source code(tar.gz)
Source code(zip)
MatterLink-1.10.2-1.5.3.jar(1.07 MB)
MatterLink-1.11.2-1.5.3.jar(1.07 MB)
MatterLink-1.12.2-1.5.3.jar(1.08 MB)
MatterLink-1.7.10-1.5.3.jar(2.24 MB)
1.5.2(Feb 26, 2018)
improve command aliases (#4)

add timeous to commands

add more know properties to the RESPONSE template

how did i miss this.. ?

Source code(tar.gz)
Source code(zip)
MatterLink-1.10.2-1.5.2.jar(1.07 MB)
MatterLink-1.11.2-1.5.2.jar(1.07 MB)
MatterLink-1.12.2-1.5.2.jar(1.08 MB)
MatterLink-1.7.10-1.5.2.jar(2.24 MB)
1.5.1(Feb 21, 2018)
improve docs and reconnection handling

remove offending tickCounter

improve update check and add handleTick

add custom command: uptime to the defaults

refactor config and add connect / disconnect announcements as debug option

Source code(tar.gz)
Source code(zip)
MatterLink-1.10.2-1.5.1.jar(1.06 MB)
MatterLink-1.11.2-1.5.1.jar(1.06 MB)
MatterLink-1.12.2-1.5.1.jar(1.07 MB)
MatterLink-1.7.10-1.5.1.jar(2.46 MB)
1.5(Feb 19, 2018)
wtf gradle

more curseGradle fixes

curseforge uploaded recompiled the wrong files and everything broke

MatterLink actually works now, no promises though

FUCK YOU GRADLE

fix 1.7.10 receive and send messaes to chat

skip update check for jenkins and dev builds, add default users (power 0) to permissions as examples

experimental 1.7.10 fixes, improved version comparison in update checker

fix some invalid commands being passed through

format all the things

finished loading custom commands and permissions from file

WIP custom commands and permissions loading from json

fix duplicate achievment display

version bump to 1.4

restructure configuration, fix connection errors, register events properly on 1.7.10

add 1.7.10 to jenkins

add 1.7.10

refactor message stream

fix achievment/advancement string

refactorio

Merge branch 'master' of https://github.com/elytra/MatterLink

Begin refactor

fix update checker output format

finalize Update checker

add Update Check, simplify config access

Update checker

Update README.MD

Update README.MD

Wrong variable....

fixed oversight in refactor

because ForgeGradle sucks.. at least before 2.3-SNAPSHOT

Should actually work now

Should work now

Ability to access above-mentioned commandsender

Implement new custom ICommandSenders

WIP command passthrough

add proper required-after forgelin and forge version, improves to the build.gradle

Added command pass-through config

Added $uptime command, abstracted command registration into core

Merge remote-tracking branch 'origin/master'

implement getUptime

refactor config loading and reloading more

delet todo

Refactor BaseConfig.reload()

make sure /bridge reload works

Implement /reload

Abstracted commands into core

add fake debug and trace loggers

restructure config

adding changelog to cursegradle config

fix CurseGradle displaynames

try to fix cursegradel changelog

add damage type emoji to death message

update .gitignore

release 1.2.3

add sample and update README

remove unecessary Enum

deduplicate configuration code

versioning scheme change

Source code(tar.gz)
Source code(zip)
MatterLink-1.10.2-1.5.jar(1.05 MB)
MatterLink-1.11.2-1.5.jar(1.05 MB)
MatterLink-1.12.2-1.5.jar(1.06 MB)
MatterLink-1.7.10-1.5.jar(2.46 MB)
1.2.2(Feb 11, 2018)

1.2.2
Source code(tar.gz)
Source code(zip)
MatterLink-1.10.2-1.2.2.jar(1.01 MB)
MatterLink-1.11.2-1.2.2.jar(1.01 MB)
MatterLink-1.12.2-1.2.2.jar(1.02 MB)
1.2.1(Feb 11, 2018)

1.2.1
Source code(tar.gz)
Source code(zip)
MatterLink-1.11.2-1.2.1.jar(1.01 MB)
MatterLink-1.12.2-1.2.1.jar(1.02 MB)
1.2(Feb 10, 2018)
configurable join/leave messages

support 1.11.2 in addition to 1.12.2

Source code(tar.gz)
Source code(zip)
MatterLink-1.11.2-1.2.jar(1.01 MB)
MatterLink-1.12.2-1.2.jar(1.01 MB)

Owner

Elytra

A group of people who like making cool mods and modpacks.

GitHub

This app brings the Matterbridge binary to your server to connect Nextcloud Talk with other chat services

27 Sep 12, 2022

Matterbridge API plugin for Reddit Community Chat

Mattereddit 2 Mattereddit is a Matterbridge API plugin allowing you to connect Reddit group chats to the various chat services supported by Matterbrid

13 Sep 13, 2022

Matterbridge API Connector for Vintage Story Server

2 Oct 21, 2021

go-chat is a gRPC based chat CLI written in golang for command line lovers

go-chat go-chat is a gRPC based chat CLI written in golang for command line lovers. This CLI allows you to chat with your friends without leaving the

3 Oct 14, 2022

Tcp chat go - Create tcp chat in golang

TCP chat in GO libs Go net package and goroutines and channels tcp tcp or transm

0 Feb 5, 2022

Go-random-chat - Fast and scalable real-time random chat written in go

Go Random Chat Fast and scalable real-time random chat written in go. Features:

13 Dec 21, 2022

Matterbridge mattermost plugin

mattermost-plugin Matterbridge mattermost plugin WIP Configuration You have to create a matterbridge.toml configuration file before running make. Beca