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
| Tipo | Uso |
|---|---|
NORMAL | Rangos normales. El peso es cualquier entero de 32 bits |
DONATOR | Rangos comprables o de donación. Peso 0–999999 |
STAFF | Rangos de staff con autoridad STAFF o ADMIN. Peso 0–999999 |
HIDDEN | Solo 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:
- Primero se filtran condiciones y vencimientos.
- Las condiciones más específicas tienen prioridad; entre rangos se considera después el peso.
- Una regla temporal gana a una permanente equivalente; entre temporales, gana la que vence antes.
- Si persiste el empate, gana
false. - 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
/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 CompraLos 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 7aaff.
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.