this mod is serverside ONLY and you need to run a matterbridge: https://github.com/42wim/matterbridge First of all.. you need to run a matterbridge: https://github.com/42wim/matterbridge and for this mod to connect the websocket to the api https://github.com/42wim/matterbridge/wiki/API must be accessible

matteridge allows for many complex chat brdige setups it is worthwile to read through their wiki: https://github.com/42wim/matterbridge/wiki

the mod will create a default config file in ModConfig/matterbidge.json

with the following properties

websocket uri, configure this differently if you setup reverse procies for wss:https:// or different paths

matterbridge api token, leave empty if not defined on matterbridge

announces when the mod connects or when the server shuts down

announces when players join or leave the server

announces when players die

announces storm events

main gateway for status updates and linking to general chat

default: "system" username for the announcer system

default: "" url to avatar of announcer system empty string will not set it (will use defult avatar of bots on discord or slack) will only be displayed on things that support it (discord webhooks for example)

mapping of group names to gateways

example:

{
  "ChannelMapping": [
    {
      "groupName": "announcements",
      "gateway": "announcements",
      "isPrivate": false
    }
  ]
}

groupName is the group name in VS, the groups are created automatically gateway is matching gateway.name in the matterbridge config (see: Gateway config (basic)) isPrivate controls if people can use /bridge join|leave and listing the

text templates for messages sent to matterbridge

/me <message>

do a action

/bridge join <gateway>
join a gateway/bridge

/bridge leave <gateway>
leave a gateway/bridge

/bridge list
lists gateways that you are not in

/bridge listall list all gateways

/bridgereload

admin only
reloads config and restarts the websocket connection to matterbridge

https://github.com/42wim/matterbridge/wiki/How-to-create-your-config

matterbridge gateways are a collections of channels from different platforms each channel can be receive-only (in), send-only (out) or send-and-receive (in-out) example: announcements channel bridged to VS

• example1
• example2 readonly twitch chat & irc

thanks to @copygirl for providing a quick to setup sample repo https://github.com/copygirl/howto-example-mod

huge thanks to @Capsup the game related features are mostly based on https://gitlab.com/vsmods-public/vschatbot and https://gitlab.com/vsmods-public/proximitychat

without that as a sample i could not have written my first VS mod

follow the README at https://github.com/copygirl/howto-example-mod

(mainly the ENV variable setup)