Skip to content

MatrixNotifications

Tristan edited this page Apr 11, 2020 · 2 revisions

Misc > MatrixNotifications sends out queue position notifications via Riot/Matrix.

This mod requires a bit of configuration on Matrix/Riot to be usable before enabling it on the Minecraft side. This guide will assume you are using the Riot client.

Once you are signed up and logged in, press the "+" button next to "Rooms" in the left sidebar:

The "Create Private Room" modal will open. You should give your room the name of your choice and press "Create Room":

Once your room is created, press the "Invite to this room" button in the top right corner:

The "Invite To This Room" modal will open. In the text box, type the username of a webook bridge. @_webhook:nerdsin.space is a good one you can use. Then press "Invite":

Once the webhook bridge joins the room, send the message "!webhook" and the bridge will respond with a URL that looks like https://nerdsin.space/api/v1/matrix/hook/<longstring>:

Once you have obtained this url, open forgehax and type .matrixnotifications url <the url you got in the step above>. You can also configure other options as seen below.

If everything was set up correctly, your matrix room should look something like this once you've connected to 2b2t. You may get a message from the bridge saying that your room is no longer a suitable administrative room. This may safely be ignored:

ForgeHax In-Game command reference

.matrixnotifications enabled <0/1>

.matrixnotifications url <url> - URL to the Matrix web hook

.matrixnotifications user <name> - user to ping for high priority messages

.matrixnotifications skin-server-url <url> - URL to the skin server. If left empty then no image will be used. (Default: https://visage.surgeplay.com/face/160/)

.matrixnotifications queue-notify-pos <num> - Position to start sending notifications at. (Default: 5)

.matrixnotifications on-connected <0/1> - Message once connected to server (Default: 1)

.matrixnotifications on-disconnected <0/1> - Message once disconnected from server (Default: 1)

.matrixnotifications queue-move <0/1> - Message when player moves in the queue (Default: 1)

Clone this wiki locally