TRS Server Rules

TRS Server Rules ist ein kostenloses Plugin und Server-Mod. Es sagt dem TRS Client, was auf deinem Server erlaubt ist: einzelne Module sperren, erzwingen oder ihre Einstellungen festlegen und begrenzen – global, je Welt oder je Unterserver.

Herunterladen und installieren

Alle Plattformen stecken in einem GitHub-Release: github.com/theredstonee/TRS-Launcher/releases/tag/server-plugin. Überblick: Für Server.

Konfiguration

# TRS Server Rules – control TRS Client features on your server.
# Note: members of the TRS team with the "serverrules.bypass" permission can override these rules
# after an in-game confirmation. This is documented on purpose.
modules:            # global
  minimap: false    # false = forced off, true = forced on
  fullbright: false
settings:
  zoom.factor: {max: 4}
  cinematic.freecamFairPlay: true
worlds:             # Bukkit/Sponge/mods: per world; Velocity/Bungee: "servers:" per backend server
  pvp_arena:
    modules: {zoom: false, freelook: false}
message: ""         # optional text shown once to TRS Client players
missing-client:     # players whose client does not answer with a TRS Client hello
  action: ignore    # ignore | notify | kick
  timeout-seconds: 10
  notify-message: "This server works best with the TRS Client."
  kick-message: "Please join with the TRS Client."
bypass-permission: trsrules.bypass   # players with this server permission get no rules

Alles auskommentiert (oder nicht vorhanden) heißt: nichts gesperrt, der Spieler entscheidet.

modules

<Modul-ID>: true | false. false sperrt das Modul aus, true erzwingt es an. Ein Modul, das nicht drinsteht, bleibt Sache des Spielers. Alle IDs: Modul-IDs.

settings

<Modul-ID>.<Einstellungs-ID>: … – die Einstellungs-IDs sind die Schlüssel eines Moduls in der Config-Datei des TRS Clients config/trsclient.json (flags, numbers, choices).

Unbekannte Module oder Einstellungen ignoriert der Client – eine Config funktioniert also auch mit älteren und neueren TRS-Client-Versionen.

worlds / servers

Regeln für einzelne Welten (Bukkit, Sponge, Server-Mods: worlds:) oder Unterserver (Velocity, BungeeCord: servers:), jeweils mit eigenen modules: und settings:. Ein Eintrag dort geht vor den globalen Eintrag mit demselben Schlüssel; alles andere kommt aus dem globalen Teil.

message

Optionaler Text, den der TRS Client einmal als TRS-Hinweis zeigt, wenn die Regeln ankommen. Leer = kein Hinweis.

missing-client

Was mit Spielern passiert, deren Client nicht innerhalb von timeout-seconds mit einem TRS-Client-Hello antwortet:

bypass-permission

Spieler mit dieser Server-Permission (Standard trsrules.bypass) bekommen gar keine Regeln – für deine Admins und Builder.

bypass-players und bypass-op-level

• bypass-players: [] – Namen oder UUIDs, die keine Regeln bekommen, auf allen Plattformen.
• bypass-op-level: 0 – nur Server-Mods (Fabric/NeoForge/Forge haben kein Permission-Plugin): Operatoren ab diesem Level bekommen keine Regeln (0 = aus). Auf Fabric wirken bypass-permission und trsrules.admin zusätzlich, wenn LuckPerms oder eine andere Mod mit fabric-permissions-api installiert ist.

Befehle

Permission trsrules.admin; bei Fabric, NeoForge und Forge OP-Level 3.

TRS-Team-Bypass

Mitglieder des TRS-Teams, deren Rolle das Team-Recht serverrules.bypass hat, können ein gesperrtes Modul oder eine gesperrte Einstellung trotzdem benutzen. Wenn sie es ändern wollen, fragt der TRS Client zuerst: „Dieser Server sperrt „Minimap“. Als TRS-Team trotzdem benutzen?“. Ja hebt genau diese Sperre auf, bis sie den Server verlassen.

• Es gibt ihn, damit das Team Funktionen auf jedem Server testen und Spielern helfen kann.
• Der Spiel-Server erfährt davon nichts und kann es nicht abschalten.
• Er ist bewusst offen dokumentiert: hier, auf der Seite Für Server, in der README des Plugins und als Kommentar oben in jeder erzeugten Config.
• Die Ausnahme für dein eigenes Team ist die Server-Permission aus bypass-permission – die hast du komplett selbst in der Hand.

Protokoll

Für alle, die eine eigene Umsetzung schreiben wollen. Plugin Messaging (Custom Payload), Inhalt ist UTF-8-JSON als rohe Bytes (ohne Längenpräfix), höchstens 32 KiB.

Server registrieren beide Namen, wo die Plattform es erlaubt (gemischte Versionen hinter ViaVersion).

Hello (Client → Server):

{"v":1,"client":"trsclient","version":"0.20.0","mc":"1.21.11","loader":"fabric","modules":["fps","minimap","zoom"]}

Regeln (Server → Client):

{"v":1,
 "modules":{
   "minimap":{"enabled":false},
   "fullbright":{"enabled":false},
   "zoom":{"settings":{"factor":{"max":4.0}}},
   "cinematic":{"settings":{"freecamFairPlay":{"value":true}}},
   "toggleSprint":{"enabled":true}
 },
 "message":"Optionaler Text, den der Client einmal zeigt"}

• enabled: false = gesperrt aus, enabled: true = erzwungen an, fehlt = der Spieler entscheidet.
• settings.<id>: {"value": x} erzwingt einen Wert (Bool, Zahl oder Auswahl über den Enum-Namen), {"min": a, "max": b} begrenzt eine Zahl.
• Unbekannte Module und Einstellungen werden ignoriert. Bei v größer als 1 liest der Client nur die Felder, die er kennt.

Modul-IDs

Die IDs sind in jeder Minecraft-Version gleich. Ein Modul, das es in einer Version nicht gibt, wird einfach ignoriert. Die Namen sind die englischen Namen aus dem TRS-Menü.

HUD

PvP

Welt

Chat

Redstone

Leistung

Sonstiges

Codes im Chat oder MOTD

Auch ohne Plugin kann ein Server unsichtbare Codes schicken: jeder Buchstabe mit einem § davor, in einer Chat-Nachricht oder im MOTD. Sie gelten, bis der Spieler den Server verlässt, und wirken auch neben TRS Server Rules.

Die Karten-Codes sind die verbreiteten Codes anderer Karten-Mods – vorhandene Fair-Play-Plugins wirken also auch beim TRS Client.