Chat, Kanäle, Chat-Logs & Social Spy

Diese Seite deckt drei Bereiche ab: die Chat-Kanäle (Teil von core), die netzwerkweiten Chat-Logs (Modul chatlog) und Social Spy (Modul socialspy).

Chat-Kanäle

Jeder Spieler hat einen aktiven Kanal zum Schreiben (normaler Chat geht dorthin) und beliebig viele Kanäle, die er empfängt. /chat öffnet das Kanal-Menü: Linksklick = in diesem Kanal schreiben, Rechtsklick = Empfang an/aus. Jede Nachricht trägt ihren Kanal-Tag ([G], [Slow], [Team], [Clan], [Party], [Gruppe], [MSG]).

Kurzformen für /chat <Kanal>: g, s, l/lc/lokal, t/tc/staff, c/cc, p/pc, gr.

Lokal-Chat

/localchat (Aliase /lc, /local, /lokal, /umkreis) schaltet den Lokal-Modus an und beim zweiten Mal wieder aus; /localchat on|off setzt ihn fest. Beim Verlassen schreibst du wieder in dem Kanal, den du vorher aktiv hattest. Im Kanal-Menü steht Lokal neben Global und Slow, ein Linksklick schaltet ihn ebenso an und aus.

chat:
  local:
    radius: 20          # Blöcke
    keep-private: true  # /msg kommt im Lokal-Modus trotzdem an (false = wirklich alles aus)

Owner-Nachrichten im Global-Kanal (eternal.chat.owner) erreichen weiterhin alle, auch Spieler im Lokal-Modus. Hört niemand im Umkreis mit, bekommt der Schreiber einen Hinweis.

Befehle

Spieler im Vanish gelten für alle, die sie nicht sehen können, als offline: /msg, /tell, /reply, /pay und die Tab-Vervollständigung melden „Spieler nicht gefunden“.

Sonderrechte

Der Globalmute-Schalter liegt in der Datenbank; alle Server übernehmen ihn innerhalb von 10 Sekunden.

config.yml

chat:
  # Sekunden zwischen zwei Nachrichten im Slow-Chat
  slow-seconds: 10
  # Chat-Format mit Rang aus Eternal Perms.
  # Platzhalter: {prefix} {suffix} {color} {name} {group} {message}
  # Leer lassen, wenn ein anderes Chat-Plugin das Format setzen soll.
  format: "{prefix}{color}{name}{suffix} &8» &7{message}"

Kanal-Tags und Formate stehen in translations/<sprache>.yml: chat-tag-*, chat-team-format, chat-party-format, chat-group-format, clan-chat-format. Der Clan-Tag ([TAG]) steht im Global- und Slow-Chat vor dem Namen.

Farben im Chat

Farbcodes in Chat, /msg, Team-, Clan-, Party- und Gruppenchat wirken nur mit Recht – sonst bleibt &a als Text stehen. /colors (/farben) zeigt jedem, was er nutzen darf, jeweils in der Farbe.

Abschaltbar als Feature listener:chat-colors (Server → Zuordnung).

Chat-Format, Tab- und Anzeigename

Das Chat-Format aus chat.format, der Rang im Tab und der Anzeigename kommen aus Eternal Perms. Ist Eternal Perms nicht lizenziert, setzt Eternal davon nichts – dann formatiert, wer sonst da ist (CloudNet-Chat, LuckPerms mit einem Chat-Plugin, Essentials …). Mute, Globalmute, Kanäle und Farben bleiben trotzdem aktiv.

Chatfilter

Der Chatfilter blockt oder zensiert automatisch Beleidigungen, Hassrede, Sexuelles, Schimpfwörter und Werbung. Er prüft:

• den Chat (Global, Slow, Lokal)
• /msg und /reply
• Team-, Clan-, Party- und Gruppen-Chat
• Schilder und Bücher

Einstellen kannst du alles im Dashboard unter Moderation → Chatfilter. Der 18+ Chat wird nie gefiltert.

Kategorien (alle änderbar, eigene lassen sich anlegen):

Aktionen:

• Blocken: Die Nachricht geht nicht raus, der Spieler sieht warum.
• Zensieren: Das Wort wird zu ****, der Rest geht raus.
• Nur melden: Die Nachricht geht raus, das Team sieht den Treffer.

Der Filter erkennt die üblichen Tricks:

• Groß/klein und Umlaute
• Zahlen statt Buchstaben (4rschl0ch)
• wiederholte Buchstaben (aaarschloch)
• getrennte Buchstaben (a r s c h, a.r.s.c.h)

Ein Eintrag wort trifft das ganze Wort, wort* den Anfang, *wort das Ende und *wort* jede Stelle. Wörter auf der Whitelist (z. B. dein Servername) treffen nie. Für Links und IPs gibt es reguläre Ausdrücke.

Caps: Eine Nachricht aus fast nur Großbuchstaben wird kleingeschrieben (Standard: mehr als 70 %, ab 8 Buchstaben).

Punkte und Auto-Mute

Jeder Treffer gibt die Punkte seiner Kategorie. Kommen innerhalb von 60 Minuten 10 Punkte zusammen, wird der Spieler automatisch gemutet:

• 1\. Mal 10 Minuten
• 2\. Mal 1 Stunde
• 3\. Mal 1 Tag
• danach jedes Mal 7 Tage

Stufen, Grenze und Zeitraum stellst du im Dashboard ein (10m, 1h, 1d, 7d, perm). Nach einem Auto-Mute zählen die Punkte von vorn. Der Mute steht wie jeder andere unter Aktive Strafen, Grund „Chatfilter: …“, Aussteller „Chatfilter“.

Ein Mute gilt jetzt auch in Team-, Clan-, Party-, Gruppen- und 18+ Chat.

Dashboard: Moderation → Chatfilter

Gespeichert gilt nach spätestens 30 Sekunden auf allen Servern.

18+ Chat

Ein netzwerkweiter Kanal ohne Filter. Hinein kommt nur, wessen Alter das Team geprüft hat:

1. Der Spieler stellt mit /18 antrag [Notiz] einen Antrag, z. B. /18 antrag Discord: name#1. Das Team bekommt ingame Bescheid.
2. Das Team prüft das Alter außerhalb von Eternal, z. B. per Ausweis im Discord-Ticket.
3. Unter Moderation → 18+ Freigaben schaltet das Team frei oder lehnt ab, jeweils mit Notiz. Dort geht es auch ohne Antrag direkt per Name.
4. Nach spätestens 30 Sekunden kann der Spieler /18 nutzen. Wer, wann und warum, bleibt gespeichert. Entziehen wirft den Spieler sofort aus dem Kanal.

Aliase: /ue18, /adult; im Kanal-Menü (/chat) steht der 18+ Chat ebenfalls. Nachrichten landen im Chat-Log als ADULT (Filter „18+“).

Sprache pro Spieler

Jeder Spieler kann die Sprache aller Plugin-Nachrichten selbst wählen: /settings lang <server|auto|de|en|…>. Details auf der Seite Einstellungen.

Chat-Logs (Modul chatlog)

Das Modul speichert Chat, Befehle und private Nachrichten netzwerkweit in der Datenbank und zusätzlich in Dateien pro Server. Es liefert außerdem den Chat-Verlauf zu Reports.

• Modul-Schlüssel: chatlog (keine Abhängigkeiten). Auf allen Servern einschalten, deren Chat geloggt werden soll, auch auf dem Proxy.
• Auch für das Aufräumen alter Server-Logs (log-cleanup) zuständig.

chatlog:
  enabled: true
  directory: "chatlogs"               # relativ zu plugins/Eternal/
  log-chat: true
  log-commands: true
  report-context-before: 10
  report-context-after: 10
  report-context-window-seconds: 120
  flush-interval-ticks: 40            # Schreib-Takt (~2 s)
  sensitive-commands:                 # erstes Wort ohne Slash, Groß/klein egal
    - "login"
    - "l"
    - "register"
    - "reg"
    - "changepassword"
    - "changepass"
    - "2fa"
    - "authme"
  socialspy-network: true

Befehle aus sensitive-commands landen getrennt und sind im Dashboard nur mit eigenem Recht sichtbar.

Log-Aufräumen

Läuft auf Spigot und Proxy und löscht rotierte Server-Logs:

log-cleanup:
  enabled: true
  directory: logs              # relativ zum Server-Ordner
  max-age-days: 7
  interval-minutes: 120
  patterns: ["*.log.gz", "*.log", "proxy.log.*"]
  keep: ["latest.log"]

Dashboard: Moderation → Chat-Logs

Recht: eternal.web.chatlogs (Standard-Stufe Team).

• Filter: Server, Freitext-Suche, Zeitraum (Von/Bis) und Arten CHAT, COMMAND, MSG, GROUP, TEAM, CLAN, PARTY, SLOW.
• Sensibler Modus: zeigt nur die Befehle aus sensitive-commands. Recht eternal.web.chatlogs.sensitive (Standard-Stufe Admin, braucht eternal.web.chatlogs).
• Im Spielerprofil (eternal.web.player.view) gibt es den Chat-Verlauf pro Sitzung.

Nicknamen im Log

Log-Zeilen speichern immer den echten Namen. War der Spieler genickt, steht der angezeigte Name zusätzlich dabei; das Dashboard zeigt ihn als lila Chip „als Nickname“ hinter dem Namen, die Dateien als Name (als Nick). Die Suche findet auch Nicknamen. Jede Nick-Phase steht außerdem unter Moderation → Nicknamen (Recht eternal.web.nicks). Siehe Autonicker.

Social Spy (Modul socialspy)

Teammitglieder lesen private Nachrichten (/msg, /reply) netzwerkweit mit.

• Modul-Schlüssel: socialspy, braucht core. Der Befehl ist nur da, wenn chatlog oder socialspy auf dem Server läuft.
• /socialspy [on|off] (Alias /spy), Recht eternal.socialspy (Standard-Stufe Admin). Ohne Argument wird umgeschaltet.
• Der Zustand wird gespeichert und an den Proxy gemeldet; mit chatlog.socialspy-network: true (Standard) sieht man Nachrichten aller Server.
• Alternativ in /settings → Social Spy (nur für Teammitglieder mit dem Recht sichtbar).
• Format: Schlüssel socialspy-format in den Übersetzungen.

Typische Stolperfallen

• Chat doppelt formatiert: Ein anderes Chat-Plugin setzt ebenfalls das Format. Ohne Eternal-Perms-Lizenz formatiert Eternal nicht; mit Lizenz chat.format: "" setzen, wenn das andere Plugin gewinnen soll.
• Teamchat leer: Nur wer eternal.team hat (über den Rang, eine Wildcard wie * oder als OP), sieht und schreibt im Teamchat. Das Recht ist nicht in der plugin.yml vorbelegt.
• Globalmute wirkt nicht sofort: bis zu 10 s Verzögerung pro Server.
• Keine Chat-Logs im Dashboard: Server und REST-API müssen dieselbe MySQL-Datenbank nutzen.
• Social Spy sieht nur den eigenen Server: chatlog.socialspy-network steht auf false.