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.
language: en
command: access
aliases: []
color-command: color # '' desactiva el comando independiente
color-aliases: []Autoridad necesaria
| Operación | Requisito |
|---|---|
| Definir o borrar rangos, herencias y reglas | OWNER + sofycore.ranks.manage, o consola |
| Dar, extender y quitar grants | ADMIN/OWNER + sofycore.ranks.grant, o consola |
| Consultar otros usuarios y rangos | sofycore.ranks.view (tus propios datos no lo necesitan) |
| Excepciones individuales y colores de otros | OWNER + sofycore.ranks.manage, o consola |
| Dar owner o editar su definición | Solo consola |
Comandos
/access statusDisponibilidad (READY, o SUSPENDED con LuckPerms o PermissionsEx instalado), alcance GLOBAL/LOCAL_SQLITE y revisión.
/access helpResumen de todas las ramas y su sintaxis principal.
/access setup confirmInstala 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 consolaConcede el rango owner permanente. Solo la consola puede hacerlo; ser OP o tener * nunca basta.
Ejemplos
access owner Steve
access uuid <name>Solo consolaMuestra 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 7aaff
/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> confirmElimina 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 consolaAnaliza 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 consolaAnaliza 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ón | Ejemplo |
|---|---|
| Servidor | server=survival |
| Mundo | world=world_nether |
| Modo de juego | gamemode=creative |
| Región de WorldGuard | worldguard:region=spawn |
| Flag de WorldGuard | worldguard:flag-pvp=deny |
| Dentro de alguna región | worldguard:in-region=false |
También existen los contextos dimension-type, whitelisted y has-played-before.