Saltar al contenido

Comandos

Comandos de rangos (/access)

Todos los comandos /access para crear rangos, darlos y quitarlos, gestionar permisos y reglas condicionales, y migrar desde LuckPerms o PermissionsEx.

El módulo de rangos usa una única raíz configurable, /access por defecto, y un acceso directo opcional /color. No existen comandos /rank, /grant ni /user separados. Los subcomandos y argumentos son siempre en inglés.

ranks.ymlYAML
language: en
command: access
aliases: []
color-command: color   # '' desactiva el comando independiente
color-aliases: []

Autoridad necesaria

OperaciónRequisito
Definir o borrar rangos, herencias y reglasOWNER + sofycore.ranks.manage, o consola
Dar, extender y quitar grantsADMIN/OWNER + sofycore.ranks.grant, o consola
Consultar otros usuarios y rangossofycore.ranks.view (tus propios datos no lo necesitan)
Excepciones individuales y colores de otrosOWNER + sofycore.ranks.manage, o consola
Dar owner o editar su definiciónSolo consola

Comandos

/access status

Disponibilidad (READY, o SUSPENDED con LuckPerms o PermissionsEx instalado), alcance GLOBAL/LOCAL_SQLITE y revisión.

/access help

Resumen de todas las ramas y su sintaxis principal.

/access setup confirm

Instala la plantilla opcional: vip, helper, moderator y admin con herencia básica. Se rechaza entera si ya existe alguno de esos IDs.

Requiere además
Consola, u owner con sofycore.ranks.manage.
access owner <name|uuid>Solo consola

Concede el rango owner permanente. Solo la consola puede hacerlo; ser OP o tener * nunca basta.

Ejemplos

access owner Steve
access uuid <name>Solo consola

Muestra la UUID que esta red tiene registrada para un nombre. No crea identidades.

/access rank list [page]

Lista los rangos, diez por página.

Permiso
sofycore.ranks.view
/access rank info <rank>

Tipo, autoridad, peso, herencias y apariencia de un rango.

Permiso
sofycore.ranks.view
/access rank permissions <rank> [page]

Permisos combinados, identificando directos y heredados/default.

Permiso
sofycore.ranks.view
/access rank create <id> <NORMAL|DONATOR|STAFF|HIDDEN>

Crea un rango global. IDs: 1–32 caracteres en minúscula que empiezan por letra.

Permiso
sofycore.ranks.manage
Requiere además
Autoridad OWNER (o consola).

Ejemplos

/access rank create helper STAFF
/access rank set <id> <label|type|authority|weight|prefix|suffix|color> <value...>

Edita un rango: nombre visible, tipo, autoridad (STAFF/ADMIN, solo rangos STAFF), peso, prefijo, sufijo o color de nombre. `clear` vacía estilos.

Permiso
sofycore.ranks.manage
Requiere además
Autoridad OWNER (o consola).

Ejemplos

/access rank set helper weight 10
/access rank set helper prefix &b[Helper] 
/access rank set vip color &#55aaff
/access rank permission <id> <add|deny|remove> <node...>

Concede, deniega o quita uno o varios permisos de un rango. Se aceptan comodines finales como sofycore.chat.*.

Permiso
sofycore.ranks.manage
Requiere además
Autoridad OWNER (o consola).

Ejemplos

/access rank permission helper add sofycore.chat.staff sofycore.chat.mute
/access rank inherit <id> <add|remove> <parent>

Añade o retira una herencia. Las herencias circulares se rechazan.

Permiso
sofycore.ranks.manage

Ejemplos

/access rank inherit helper add default
/access rank rule <id> <add|deny|parent|list|remove> ...

Permisos y herencias condicionados con duración y condiciones (servidor, mundo, modo de juego, región/flags de WorldGuard). `global` significa sin condición.

Permiso
sofycore.ranks.manage

Ejemplos

/access rank rule vip add essentials.fly permanent world=parcelas
/access rank rule vip add essentials.fly 30m server=survival,world=parcelas
/access rank rule vip add essentials.fly permanent worldguard:region=spawn
/access rank delete <id> confirm

Elimina un rango. Sus grants pasan a RANK_DELETED y el ID queda retirado para siempre.

Permiso
sofycore.ranks.manage
/access user <player> grant <rank> <time|permanent> <reason...>

Añade un grant independiente. Se rechaza si ya hay uno igual activo (usar extend).

Permiso
sofycore.ranks.grant
Requiere además
Autoridad ADMIN u OWNER y un rango objetivo estrictamente inferior.

Argumentos

  • player (obligatorio) — Nombre conocido o UUID del jugador.
  • rank (obligatorio) — ID del rango.
  • time (obligatorio) — Entero positivo con s/m/h/d (máx. 3650 días) o permanent.
  • reason (obligatorio) — Texto libre, hasta 256 caracteres.

Ejemplos

/access user Steve grant vip 30d Purchase
/access user <player> grantat <rank> <time> <conditions> <reason...>

Concede un rango solo bajo ciertas condiciones.

Permiso
sofycore.ranks.grant

Ejemplos

/access user Steve grantat vip 30d server=survival,world=parcelas Purchase
/access user <player> revoke <grant-uuid> <reason...>

Retira exactamente un grant.

Permiso
sofycore.ranks.grant
/access user <player> extend <grant-uuid> <time|permanent> <reason...>

Extiende un grant o lo hace permanente. Suma desde el vencimiento si sigue activo, o desde ahora si venció.

Permiso
sofycore.ranks.grant
/access user <player> <info|grants|permissions> [page]

UUID, autoridad y revisión; grants con IDs, estado y vencimiento; excepciones individuales.

Permiso
sofycore.ranks.view
/access user <player> permission <add|deny|remove> <node...>

Excepciones individuales de permisos. Las reglas individuales aplicables tienen prioridad sobre las de rangos.

Permiso
sofycore.ranks.manage
/access user <player> check <node>

Explica de dónde sale un permiso. DEFAULT indica que no hay regla explícita.

Permiso
sofycore.ranks.view
/color [0-f|#rrggbb|reset]

Consulta o cambia tu color de nombre. Acceso directo a /access color; abre un menú con el módulo de menús.

Permiso
sofycore.ranks.color
Requiere además
Además sofycore.ranks.color.<0-f> o sofycore.ranks.color.rgb.
access migration luckperms analyze <file> <owner-uuid> <sofycore|import>Solo consola

Analiza una exportación de LuckPerms 5.x y genera un plan. Después: report, status, apply <plan> confirm, resume <plan> confirm.

access migration pex analyze <file> <owner-uuid> <sofycore|import>Solo consola

Analiza un permissions.yml de PermissionsEx desde plugins/sofyCore/migrations/pex/ y genera un plan. Después: report, status, apply <plan> confirm, resume <plan> confirm.

Formato de tiempo

Enteros positivos con s, m, h o d, hasta 3650 días por operación, o permanent. No se aceptan cero, negativos ni decimales. Una extensión suma desde el vencimiento actual si sigue activo, o desde ahora si ya venció.

Condiciones

Las condiciones limitan un grant, permiso o herencia a un contexto. Las del mismo tipo son alternativas; las de tipos distintos deben cumplirse todas. Usa global para no poner condición y ; como separador alternativo si los valores llevan comas.

CondiciónEjemplo
Servidorserver=survival
Mundoworld=world_nether
Modo de juegogamemode=creative
Región de WorldGuardworldguard:region=spawn
Flag de WorldGuardworldguard:flag-pvp=deny
Dentro de alguna regiónworldguard:in-region=false

También existen los contextos dimension-type, whitelisted y has-played-before.