Der Role Merge Bot führt Mitglieder einer von zwei Rollen in eine Rolle zusammen. Das ist zum Beispiel sinnvoll, wenn du Leute nur nach einer Rolle in der Mitgliederliste sortieren möchtest. Diesen Fall könntest du bekommen, wenn auf deinem Server zwei Mitglieder mit Twitch-Integration aktiv sind und du alle Abonnenten auflisten möchtest.
Hierzu überwacht der Bot die beiden Quellrollen auf Veränderung. Sollte jemand neu in eine der beiden Rollen gelangen, wird der User auch der Zielrolle hinzugefügt. Sollte keine Mitgliedschaft mehr in einer der beiden Rollen bestehen, wird der User aus der Zielrolle entfernt.
Sicherheitshalber werden die Rollenmitgliedschaften einmal stündlich abgeglichen, falls der Bot offline war und Änderungen nicht live mitbekommen hat.
Zwingend angegeben benötigt der Bot mehrere Umgebungsvariablen:
DISCORD_ROLE_SOURCE1- Rollen-ID der ersten Quell-RolleDISCORD_ROLE_SOURCE2- Rollen-ID der zweiten Quell-RolleDISCORD_ROLE_SOURCE3- Rollen-ID der dritten Quell-Rolle (optional)DISCORD_ROLE_DEST- Rollen-ID der Ziel-RolleDISCORD_SERVER_ID- Server-ID des Servers, benötigt für die IntentsDISCORD_TOKEN- Token des Bots
Die IDs können per Rechtsklick auf die Rolle bzw. den Server und ID kopieren herausgefunden werden. Sollte der Menüpunkt nicht bestehen, unter den erweiterten Einstellungen den Entwicklermodus aktivieren.
Für den Bot-Token muss ein Bot im Discord Developer Portal angelegt werden. Unter Bot kann ein neuer Bot angelegt werden, zwingend erforderlich ist die Aktivierung der Server Members Intent.
Der Bot ist als fertig gebauter Container auf Docker Hub verfügbar unter dem Image-Namen jaydee2202/discord-rmb:latest. Für die Verwendung mit Docker Compose siehe das docker-compose-image.yml.
Die Dockerfile als auch die bot.py liegen hier im Repository, ebenso kann auch mittels Docker Compose und der docker-compose-build.yml gebaut werden.
Sollte import discord nicht aufgelöst werden können, muss zunächst noch discord.py installiert werden.
Python 3.10 als venv ist empfehlenswert.
The Role Merge Bot merges members of one of two roles into one role. This is useful, for example, if you want to sort people by only one role in the member list. You might get this case if there are two members with Twitch integration active on your server and you want to list all subscribers in the member list.
To do this, the bot monitors the two source roles for change. If someone new joins one of the two roles, the user will also be added to the target role. If there is no more membership in either role, the user will be removed from the target role.
To be on the safe side, the role memberships are synchronized once an hour in case the bot was offline and did not notice any changes live.
Mandatory specified the bot needs several environment variables:
DISCORD_ROLE_SOURCE1- role ID of the first source roleDISCORD_ROLE_SOURCE2- role ID of the second source roleDISCORD_ROLE_SOURCE3- role ID of the third source role (optional)DISCORD_ROLE_DEST- Role ID of the target roleDISCORD_SERVER_ID- server ID of the server, needed for the intentsDISCORD_TOKEN- token of the bot
The IDs can be found out by right-clicking on the role or server and copy ID. If the menu item does not exist, activate the developer mode under the advanced settings.
For the bot token, a bot must be created in the Discord Developer Portal. Under Bot a new bot can be created, it is mandatory to activate the Server Members Intent.
The bot is available as a built container on Docker Hub under the image name jaydee2202/discord-rmb:latest. For use with Docker Compose, see the docker-compose-image.yml.
The Dockerfile as well as the bot.py are here in the repository, likewise you can also build using Docker Compose and the docker-compose-build.yml.
If import discord can't be resolved then you have to install discord.py first.
It's recommended to use Python 3.10 as venv.
Vielen Dank an @Breuxi für die Unterstützung!