Saltar al contenido

Funciones

Rangos y permisos

Cómo funcionan en sofyCore los rangos, grants, herencias, autoridad, reglas condicionales, vencimientos y la resolución de permisos en la red.

El módulo ranks gestiona las definiciones de rangos, los rangos que tiene cada jugador (grants), las excepciones individuales de permisos y las reglas condicionales. Las definiciones son compartidas por toda la red; los grants pueden ser globales o limitarse a un servidor, mundo, modo de juego o región de WorldGuard, con vencimiento opcional.

Tipos de rango

TipoUso
NORMALRangos normales. El peso es cualquier entero de 32 bits
DONATORRangos comprables o de donación. Peso 0–999999
STAFFRangos de staff con autoridad STAFF o ADMIN. Peso 0–999999
HIDDENSolo aportan permisos: sin prefijo, sufijo, color ni autoridad

default es único y siempre se aplica. owner tiene el peso máximo reservado (1000000). Los IDs de rango tienen de 1 a 32 caracteres en minúscula y empiezan por letra.

Autoridad y jerarquía

La autoridad es independiente del rango visible: consola > OWNER > ADMIN > STAFF > USER, y dentro de cada nivel decide el peso. La autoridad nunca se hereda; sale del tipo y la autoridad de los grants activos del jugador.

  • Un administrador solo da rangos estrictamente inferiores al suyo y solo edita jugadores con menor autoridad.
  • Nadie puede modificarse a sí mismo ni a un igual o superior.
  • OP y * nunca sustituyen estas comprobaciones. Un rango HIDDEN con permisos administrativos tampoco crea autoridad.
  • Las restricciones se vuelven a comprobar en el almacenamiento al confirmar el cambio, no solo al escribir el comando.

Rango visible

Si un jugador tiene varios rangos, el visible (prefijo, sufijo, color, chat y nametags) se elige así: STAFF gana a USER; dentro de la misma escala gana el mayor peso, después el grant más reciente y después el ID del rango. Los rangos HIDDEN nunca participan.

Los jugadores pueden elegir entre su rango global y el rango local del servidor actual con /rankdisplay (un grant con server=<este servidor>).

Resolución de permisos

Todos los grants activos combinan sus permisos, y default siempre se aplica. Para un nodo concreto:

  1. Primero se filtran condiciones y vencimientos.
  2. Las condiciones más específicas tienen prioridad; entre rangos se considera después el peso.
  3. Una regla temporal gana a una permanente equivalente; entre temporales, gana la que vence antes.
  4. Si persiste el empate, gana false.
  5. Los nodos exactos ganan a los comodines, y los comodines más específicos a los generales.

Las reglas individuales (/access user <jugador> permission ...) prevalecen sobre el resultado de los rangos. remove vuelve al resultado heredado; no es una denegación.

Reglas condicionales

Text
/access rank rule vip add essentials.fly permanent world=parcelas
/access rank rule vip deny essentials.fly permanent world=minas
/access rank rule vip parent base 7d server=survival
/access user Steve grantat vip 30d server=survival,world=parcelas Compra

Los contextos se actualizan al moverse de bloque, teletransportarse y cambiar de mundo o de modo de juego, y se revisan hasta ocho jugadores por tick para detectar cambios de región. No se consulta Redis ni la base de datos por cada movimiento o comprobación de permiso.

WorldGuard

WorldGuard es opcional. Las condiciones de región usan su API pública (familias 6 y 7) sin NMS: worldguard:region=<id>, worldguard:in-region=<true|false> y worldguard:flag-<flag>=<valor>. Se reconocen las claves de ExtraContexts y el alias antiguo wg-region.

Colores de nombre

Los jugadores con sofycore.ranks.color eligen un color personal con /color (0–f con sofycore.ranks.color.<código>, o #rrggbb con sofycore.ranks.color.rgb). Los colores de rango aceptan &a o &#55aaff.

Sincronización en la red

Los cambios se guardan primero y después se anuncian por Redis Pub/Sub. Un cambio en los grants de un jugador solo recarga a ese jugador; los cambios del catálogo invalidan todas las vistas. Cada servidor comprueba además la revisión cada dos segundos para recuperar avisos perdidos. La propagación es rápida pero no instantánea: durante una invalidación, los placeholders devuelven vacío y rank_ready=false en lugar de mezclar revisiones.

Límites

Hasta 128 rangos, 64 padres por rango, 1024 reglas por rango, 512 grants históricos y 512 excepciones por usuario. Los motivos tienen hasta 256 caracteres.