Skip to content

Latest commit

 

History

History
73 lines (55 loc) · 1.84 KB

matterbridge.md

File metadata and controls

73 lines (55 loc) · 1.84 KB
Raw

Matterbridge relay

This manual describes how to set up a local matterbridge chat relay.

The beerchat mod communicates via http to the matterbridge api, for details see: https://github.com/42wim/matterbridge/wiki/Api

Install matterbridge

Get the matterbridge binary from https://github.com/42wim/matterbridge or set it up with docker

A working example with docker-compose is located in the /dev folder of this repository

Configure the matterbridge

This matterbridge.toml example connects the ingame main channel to libera #beerchat and a personal discord server:

[irc]
[irc.Libera]
Server="irc.libera.chat:6667"
Nick="BeerchatTestBot"
RemoteNickFormat="<{NICK}> "
ColorNicks=true
ShowJoinPart=true

[discord]
[discord.Discord]
Token="<omitted>"
Server="839951944515715084"
RemoteNickFormat="<{NICK}> "
ShowJoinPart=true
UseUserName=true

[api.minetest]
BindAddress="0.0.0.0:4242"
Token="mytoken"
Buffer=1000
RemoteNickFormat="{NICK}"
ShowJoinPart=true

[[gateway]]
name="main"
enable=true
[[gateway.inout]]
account="irc.Libera"
channel="#beerchat"
[[gateway.inout]]
account = "discord.Discord"
channel="matterbridge"
[[gateway.inout]]
account="api.minetest"
channel="api"

(tokens and passwords are omitted in this example)

For all settings see: https://github.com/42wim/matterbridge/wiki/Setting

Configure the minetest server

Add the beerchat mod to the http-settings and configure the url and token:

secure.http_mods = beerchat
# your local matterbridge setup
beerchat.matterbridge_url = http://127.0.0.1:4242
# The token you set up in the previous `matterbridge.toml` file (under `[api.myapi]`/Token)
beerchat.matterbridge_token = mytoken

Start the matterbridge and minetest server

Start the matterbridge server and minetest, there might be some errors in the minetest console if the matterbridge isn't available