Home


Matrix Server Administrator Guide

Quickstart guide for moderationbots


Disclaimer:

All tips and suggestions here are provided without any liability/warranty and are not legal advice.
For legal advice contact a lawyer.

This guide contains suggestions of actions and practises that may help when dealing with abuse.

Introduction

What are moderation bots?

Moderationbots in Matrix are mainly used to easily ban users from rooms, delete spam messages and handle server ACLs in rooms.
Though some of them have extended capabilities for moderating individual rooms, a whole set of rooms or even the server itself.

The single most effective feature that all of them share however, is the ability to subscribe to so called "policy lists" where they can synchronize user and server bans.
The best example of such a list is the CME (community moderation effort) list. This list is maintained by a set of highly trusted community members and used by many in the matrix community to keep their rooms free of spam.

Why should I set one up?

Provide effective moderation tools to keep your users safe

By offering a moderationbot to your users, you can help to improve the overall experience that your users will have on matrix. Moderationbots need to be installed and configured, they also need to run somewhere and require special accounts without ratelimits to work effectively, this is out of reach for the average user.
Draupnir and Meowlnir can even block incomming invites from known threat actors based on policy lists.

Provide helpfull features for yourself as a server admin

Bots like Draupnir as of v2.3.0-beta.1 have the ability to automatically suspend accounts of local users when they get added to one of the earlier mentioned policy list. This can help you to prevent more spam originating from your server. Once you reviewed the user, you can always "unsuspend" the account again or deactivate it via the bot if the user broke your TOS.


← Back to all topics

Which bots exist?

Basic features that they all share:

✅ Automatically ban users in rooms based on policy lists

✅ Automatically set server ACLs in rooms based on policy lists

✅ Automatically redact messages based on preconfigured ban reasons


Draupnir

Github repo: Draupnir
Support room on matrix: #draupnir:matrix.org

Draupnir is a fork of mjolnir, with faster paced and more community driven development, often deployed to non-foundation communities. Its more performant than Mjolnir and has more features. It has also seen a lot of work in terms of making it more user error safe than Mjolnir, meaning that its harder to accidentally do something wrong.


Meowlnir

Github repo: Meowlnir
Support room on matrix: #meowlnir:maunium.net

Meowlnir is the youngest and probably fastest one of them. It works best with synapse and can even send redactions for softfailed events.


Mjolnir

Github repo: Mjolnir
Support room on matrix: #mjolnir:matrix.org

Mjolnir is the oldest one of the bots, used for all the rooms under matrix.org control. Similar to Draupnir but slower and with less features.

← Back to all topics

Policy lists

What are Policy lists?

Policy lists are special matrix rooms that contain "m.policy.rule.user" events, these events can be read by moderation bots. Policy lists are like a shared blacklist and bots can subscribe to them.
For example: If a user starts spamming in a room and gets added to a policy list that your bot subscribes to, your bot will block that user from your rooms too.


What lists exist?

Community Moderation Effort [CME]:

This list is maintained by the matrix community itself and contains spammer & scammer.
It is trusted by many, including the Debian and the Ubuntu community. This list is generally really fast and has a extremely low rate of false positives. False positives also get removed as soon as people are made aware of it.

The policy room is: #community-moderation-effort-bl:neko.dev


Matrix.org code of conduct [COC]:

This list is maintained by the matrix.org foundation.
It is used by the foundation itself and some communities use it too. This list contains bans for all kinds of behaviour that violdated the matrix.org code of conduct. This means that this list does not only contain spammers but also trolls, rude people and more.

The policy room is: #matrix-org-coc-bl:matrix.org


More lists?

There is a matrix space with a big collection of ban lists, they usually have descriptions for the scope they aim to cover.

The space is at: #banlists:nexy7574.co.uk



← Back to all topics