TRS Server Rules

TRS Server Rules es un plugin y mod de servidor gratuito. Le dice al TRS Client qué está permitido en tu servidor: desactivar módulos, forzarlos o fijar y limitar sus ajustes, de forma global, por mundo o por servidor del proxy.

Descargar e instalar

Todas las plataformas están en una versión de GitHub: github.com/theredstonee/TRS-Launcher/releases/tag/server-plugin. Resumen: Para servidores.

Configuración

# 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

Si todo está comentado (o no existe), no se bloquea nada y decide el jugador.

modules

<id del módulo>: true | false. false bloquea el módulo desactivado, true lo fuerza activado. Un módulo que no aparece sigue siendo decisión del jugador. Todos los IDs están en la sección «IDs de módulos» más abajo.

settings

<id del módulo>.<id del ajuste>: …: los IDs de ajustes son las claves de un módulo en el archivo de configuración del TRS Client config/trsclient.json (flags, numbers, choices).

El cliente ignora los módulos o ajustes desconocidos, así que una configuración funciona también con versiones más antiguas y más nuevas del TRS Client.

worlds / servers

Reglas para mundos concretos (Bukkit, Sponge, mods de servidor: worlds:) o servidores del proxy (Velocity, BungeeCord: servers:), cada uno con sus propios modules: y settings:. Una entrada ahí tiene prioridad sobre la entrada global con la misma clave; todo lo demás viene de la parte global.

message

Texto opcional que el TRS Client muestra una vez como aviso TRS cuando llegan las reglas. Vacío = sin aviso.

missing-client

Qué pasa con los jugadores cuyo cliente no responde con un saludo de TRS Client dentro de timeout-seconds:

bypass-permission

Los jugadores con este permiso del servidor (predeterminado trsrules.bypass) no reciben reglas: para tus administradores y constructores.

bypass-players y bypass-op-level

• bypass-players: [] – nombres o UUID que no reciben reglas, en todas las plataformas.
• bypass-op-level: 0 – solo mods de servidor (Fabric/NeoForge/Forge no tienen plugins de permisos): los operadores con al menos este nivel no reciben reglas (0 = desactivado). En Fabric, bypass-permission y trsrules.admin también funcionan si LuckPerms u otro mod con fabric-permissions-api está instalado.

Comandos

Permiso trsrules.admin; en Fabric, NeoForge y Forge, nivel de OP 3.

Bypass del equipo TRS

Los miembros del equipo TRS cuyo rol tiene el permiso de equipo serverrules.bypass pueden usar igualmente un módulo o ajuste bloqueado. Cuando intentan cambiarlo, el TRS Client pregunta primero: «Este servidor bloquea “Minimapa”. ¿Usarlo igualmente como equipo TRS?». Sí levanta solo ese bloqueo hasta que salen del servidor.

• Existe para que el equipo pueda probar funciones y ayudar a jugadores en cualquier servidor.
• El servidor de juego no se entera y no puede desactivarlo.
• Está documentado a propósito: aquí, en la página Para servidores, en el README del plugin y como comentario al principio de cada configuración generada.
• La excepción para tu propio equipo es el permiso de servidor de bypass-permission, que controlas por completo.

Protocolo

Para quien quiera escribir su propia implementación. Plugin messaging (custom payload); el contenido es JSON UTF-8 como bytes sin procesar (sin prefijo de longitud), como máximo 32 KiB.

Los servidores registran ambos nombres cuando la plataforma lo permite (versiones mezcladas con ViaVersion).

Saludo (cliente → servidor):

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

Reglas (servidor → cliente):

{"v":1,
 "modules":{
   "minimap":{"enabled":false},
   "fullbright":{"enabled":false},
   "zoom":{"settings":{"factor":{"max":4.0}}},
   "cinematic":{"settings":{"freecamFairPlay":{"value":true}}},
   "toggleSprint":{"enabled":true}
 },
 "message":"Texto opcional que el cliente muestra una vez"}

• enabled: false = bloqueado desactivado, enabled: true = forzado activado, ausente = decide el jugador.
• settings.<id>: {"value": x} fuerza un valor (booleano, número u opción por su nombre de enum), {"min": a, "max": b} limita un número.
• Los módulos y ajustes desconocidos se ignoran. Con v mayor que 1, el cliente solo lee los campos que conoce.

IDs de módulos

Los IDs son iguales en todas las versiones de Minecraft. Un módulo que no existe en una versión simplemente se ignora. Los nombres son los nombres en inglés del menú TRS.

HUD

PvP

Mundo

Chat

Redstone

Rendimiento

Otros

Códigos en el chat o el MOTD

Incluso sin plugin, un servidor puede enviar códigos invisibles: cada letra con un § delante, en un mensaje de chat o en el MOTD. Valen hasta que el jugador sale del servidor y siguen funcionando junto a TRS Server Rules.

Los códigos de mapa son los habituales de otros mods de mapas, así que los plugins de juego limpio existentes también funcionan con el TRS Client.