Skip to content

TwitchmodsDACH/Bann-Hammer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

70 Commits
 
 
 
 
 
 
 
 

Repository files navigation

TwitchModsDACH Bann-Hammer

Der TwitchModsDACH Bann-Hammer ist ein Fork von RaidHammer. Ein sehr nützliches Tool für Moderatoren die in mehreren Kanälen massenhaft Leute zu bannen haben.

Da uns manche Funktionen des RaidHammer nicht genutzt haben oder schlecht implementiert waren und andere Funktionen wiederum gefehlten, wurde für die Community eine eigene Version des RaidHammer erstellt.

Unseren Mitglieder soll damit eine einfache Möglichkeit an die Hand geben werden, auf einfache Weise & feingranular zu bestimmen, welche Liste gebannt oder entbannt werden soll.

Disclaimer

Grundsätzlich ist mit Tools wie Tempermonkey und eigenen Users-Scripts vorsicht geboten. Denn mittels dieser Erweiterungen ist potentiell möglich, eure Session von Youtube Twitch oder was auch immer abzugreifen. Daher ist uns hier die Transparenz sehr wichtig.

Es wurde sich ganz bewusst dagegen entschieden, satt das Senden von Chat-Nachrichten direkt gegen die API von Twitch zu gehen. Denn dazu müsset das Tool sich eben dann euren Token ausleihen für die Authentifizierung gegen die API. Und damit hier erst gar keine Vermutungen aufkommen, wurde einfach darauf verzichtet und an der Art, wie auch schon der Raidhammer funktioniert hat nichts geändert.

Der Code kann aktuell nur von 2 Menschen hier im Repo verändert werden, weiter habt ihr bei der Updatet-Funktion immer die Möglichkeit direkt den Code zu sehen, der nachgeladen werden soll BEVOR ihr das Update durchführt.

Wir hoffen damit die nötige Transparenz und Vertrauen in das Tool zuschaffen.

Funktionsweise des Bann-Hammer

  • Es wird ein Speicher mit localStorage eures Browsers abgelegt.
    • kanalname_banlist (Pro Kanal wird ein Speicher angelegt)
    • kanalname_unbanlist (Pro Kanal wird ein Speicher angelegt)
    • Dort werden nur die User gespeichert die gebannt/entbannt wurden in einem Kanal
    • Wird ein User entbannt wird er, wenn vorhanden, aus der jeweiligen kanalname_banlist entfernt.
  • Es können die Listen von TwitchModsDach Bannlisten abgerufen werden. Dabei wird das localStorage eines Kanals abgeglichen und nur die User geladen, die noch nicht gebannt/entbannt wurden.
  • Es können auch eigene Liste mittels Copy&Paste eingefügt werden.
    • hierbei erfolgt keine Überprüfung, ob User die Ihr in das Tool kopiert bereits gebannt wurden.
    • Dadurch kann man auch überprüfen, ob eine Bannliste wirklich auch gebannt hat, wenn man die Liste noch einmal per Copy&Paste einfügt und durchlaufen lässt.

Nachteile des Designs

  • Keine synchronisierten zwischen den Moderatoren eines Kanals.
    • Im schlimmsten Fall lassen einmal alle Moderatoren eines Kanals die Listen durchlaufen. Das ist nicht dramatisch nur initial etwas lästig.
  • Löscht euer Browser beim Beenden den localStorage, werden auch die Listen gelöscht.
    • Das Problem hat man auch beim Gerätewechsel oder bei einer Neuinstallation

In diese Nachteile wird keine Arbeit investiert, da das Tool irgendwann durch einen vernünftigen Twitch-Bot ersetzt werden soll, mit ihr dann gar keine Arbeit mehr habt

Wesentliche Veränderungen zu RaidHammer

  • CORS-Funktion eingebaut, um auf das Repository TwitchModsDach Bannlisten zugreifen zu können
  • TwitchModsDach Bannlisten Synchronisation integriert
  • Unban-Funktion hinzugefügt
  • BannGrund-Funktion hinzugefügt
  • Update-Funktion hinzugefügt
  • Re-Design durchgeführt
  • Prinzessinnen Modus hinzugefügt
  • Nützliche Moderator Tools hinzugefügt
  • Pause-Funktion hinzugefügt
  • LocalStorage integriert
  • Die Funktion das Follower automatisch auch im Banntool angezeigt werden wurde ausgebaut
    • Sie funktionierte im RaidHammer über die Mechanik, das Streamlabs oder Streamelemnts einen ganz bestimmten Satz sagen mussten, damit das erkannt wird. Follower löschen kann man mit ComanderRoot.

Funktioniert nicht mit ...

  • Safari

Voraussetzungen

Eine der folgenden Erweiterungen wird benötigt.

Installation

Wenn Termper-/Grease-/ViolentMonkey installiert ist, einfach diesen Link anklicken --> bannhammer.user.js Es öffnet sich euer Monkey und man kann das User-Script mit einem Klick instalieren.

Wenn alles richtig durchgeführt ist, sollte es aussehen (das Logo kann variieren je nach ....Monkey).

Wir eine Twitch Seite besucht (ggf. offene Tabs neuladen), wird in einem Kanal in dem man Moderator unter dem Chat ein kleiner grüner BannHammer angezeigt:

  1. Durch anklicken öffnet sich der BannHammer

  1. Anklicken des TwitchModsDACH Logo in der Mitte

  1. Liste einfügen oder auswählen

  1. Bannen/Entbannen

Hinweise zur Benutzung

WICHTIG: Es darf nur einen Twitch Tab im Browser-Fenster geben, sobald ein weiteren Tab dazukommt, versucht der Bannhammer dort zu bannen.

‼ Das Tool arbeitet mit eurem Chatfenster. Klickt ihre da rein oder schreibet etwas, dann bringt ihr das Tool aus dem tritt. Das Tool ist nicht dafür gedacht, während der normladen Nutzung mit Tonnen von User betankt zu werden. Möchte man das machen ist die Empfehlung: eigenes Browserfenster in dem nur der Kanal offen ist in dem gebannt werden soll und sonst nichts.

‼: Nicht mehrere Kanäle gleichzeitig bannen! Hintergrund: Shadowban-Gefahr, da zu viele Anfragen in zu kurzer Zeit bei Twitch aufschlagen. Das mag Twitch nicht!

⁉ Bei einigen kommt es je nach Einstellungen mit Erweiterungen wie Frankers/BetterTTV/7TVAPP/Darkreader zu Problem. Hier ggf. für das Bannen diese Erweiterungen deaktivieren, wenn man Probleme hat.

Die Sache mit "Merken wo welcher User gebannt wurde

Das Tool verwendet dazu den LocalStorage des Browsers.

Das bedeutet:

  • man benutzt mehrere Browser?
    • Der Speicher ist pro Browser. Browser übergreifend funktioniert das also nicht!
  • Im LocalStorage gespeichert Listen löschen
    • Entwicklungs-Konsole des Browser öffnen
    • den Tab Application/Anwendung suchen
    • Dort LocalStorage auswählen
    • dann nach "_bannlist" filtern
    • die gefunden Einträge mit Rechts-Klick löschen

Werden Coockies und das LocalStorage gelöscht, müssen alle Listen noch einmal gebannt werden!

Das Tool läuft eine Weile, dann kommt ein Fehler auf der Website von Twitch

Dann ist vermutlich für euer Setup die Geschwindigkeit zu hoch für die MassenBann/MassenUnbann funktionen. Das könnt ihr an diesen beiden Stellen anpassen: HINWEIS: Es ist dringend davon abzuraten den Wert runter zu setzen -> Twitch Shadow-Ban Gefahr!!!

    async function banAll() {
      console.log(LOGPREFIX, 'Banning all...', queueList);
      for (const user of queueList) {
          banItem(user);
          await delay(125); <<<<<< Hier in kleinen 10er Schritter bis 200 gehen
      }
    }

    async function unbanAll() {
      console.log(LOGPREFIX, 'Banning all...', queueList);
      for (const user of queueList) {
          unbanItem(user);
          await delay(125); <<<<<< Hier in kleinen 10er Schritter bis 200 gehen
      }
    }

Für unsere Prinzessinnen

Auf vielfachen Wunsch einer Person wurde ein Prinzessinen Modus eingebaut. Ändert die Farbe :)

Mod-Menü

Mit Version 3.0 wurde das Mod-Menü eingeführt. Das Mod Menü ist ein Schwert Icon oben links, wenn man einen Twitch Kanal besucht erscheint in der linken oberen Ecke, rechts vom Twitch Logo. In der der Mod-View wird das bestehende Schwert nach dem Laden etwas kleiner und ist nun anklickbar. Hierbei handelt es um ein kleines Menü, in dem man die Kanäle hinterlegen kann in welchen man Mod ist. Klickt man auf einen Namen, so wird die Mod-View des Kanals in einem neuen Tab geöffnet.

Einen Kanal als Mod Kanal hinzufügen

Schreibe alle Kanäle in das Feld in das man Namen schreiben kann. Hinweis: Die Kanäle werden in der Reihenfolge angelegt wie man sie in die Liste schreibt.

Dann auf "+ Hinzufügen" klicken und die User werden dann in eine Liste geladen, wie man das von den Bannlisten kennt. Dort hat man nun die Möglichkeit unten ALLE auf einmal zu Mod Kanälen als Mod-Kanäle festzulegen, oder eben jeden einzeln.

Mit dem nächsten Neuladen der Webseite, wird der Kanal dann hinzugefügt:

Einen kanal als Mod Kanal entfernen

Das funktioniert analog zuum Hinzufügen.

Support

Ihr könnt gern hier ein Ticket aufmachen. Unsere Mitglieder können auch sehr gern auf unserem Community Discord ein Ticket erstellen.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published