Permisos

El diseño en un párrafo

Aquí hay dos clases de nodo, y lo que las diferencia no es su nombre: es si plugin.yml los declara.

Los nodos que un jugador necesita para usar el plugin están declarados, cada uno con su valor por defecto, para que una instalación nueva funcione antes de que hayas configurado un plugin de permisos: todo el mundo puede abrir el menú, susurrar y enseñar lo que lleva en la mano, y solo los operadores pueden ejecutar el comando de administración. Todos los nodos que dicen que un jugador posee un cosmético están sin declarar a propósito. En Bukkit un nodo sin declarar es solo para operadores, así que nada del catálogo es de nadie hasta que tú lo digas — que es justo lo que hace de un cosmético algo que se concede en vez de algo que ya tiene todo el mundo.

Usar el plugin

Los cuatro nodos .create son el permiso para crear siquiera. Cuántos puede crear después es un saldo de tokens, no un nodo — ver Tokens.

Poseer un cosmético

Cuatro formas, comprobadas en este orden. Con cualquiera de ellas ya es suyo.

Los tipos son tag, nick_color, rank_color, chat_color, shadow_color, font y modifier: los siete que salen de archivos. Los cuatro que un jugador se escribe — customtag, customcolor, customnick, customrank — no tienen ningún nodo de propiedad: quien lo hizo lo posee, de forma permanente, igual que lo haría un nodo.

El permiso se pregunta en vivo, cada vez, y nunca se guarda. Por eso quitar un nodo surte efecto en el momento en que se quita, incluso para un jugador que está desconectado mientras lo haces.

Las dos excepciones

Una entrada puede escribir permission: false, y entonces los nodos de propiedad de arriba no se consultan para ella. Solo se tiene por una concesión — /cca give, una compra, una llamada a la API. Úsalo para todo lo que tenga que comprarse o ganarse en vez de asignarse a un grupo.

Los colores de rango parten del valor por defecto contrario. En todos los demás sitios una entrada que no dice nada de permission se lee como permission: true. En rank-colors.yml una entrada que no lo menciona se lee como false, y la propiedad pasa a la lista groups de la entrada:

Ese es el mecanismo, no una descripción del tipo: los tres casos están en el archivo que viene incluido. De sus 77 entradas, las 15 de SOLID no nombran ninguna de las dos cosas, así que las puede llevar cualquier rango; las 12 de METAL, 15 de GEMS, 15 de GRADIENT y 12 de ANIMATED escriben permission: true, así que necesitan un nodo o una concesión como todo lo demás; y solo las 8 de STAFF son propiedad de groups. Un jugador en admin lleva el color de admin porque está en admin, y deja de llevarlo el día que ya no lo está — por eso esa pestaña no necesita ningún nodo, y por eso los nombres de grupo que trae son suposiciones sobre los tuyos y hay que editarlos. La pertenencia a grupos viene de LuckPerms, así que los colores de rango lo necesitan.

El módulo de chat

Todos los nodos de abajo valen solo mientras el módulo está en marcha. Con él apagado no se comprueba ninguno.

Comandos

Un comando cuyo interruptor en chat/config.yml → commands está apagado no se registra en absoluto, y entonces su nodo no concede nada.

Lo que un jugador puede escribir

Staff

Excepciones

Sin declarar, así que solo operadores hasta que digas otra cosa. Cada una se salta exactamente una comprobación.

Contenido

Hay tres nodos más, y sus nombres son tuyos y no del plugin, porque cada uno sale de un archivo:

Ten en cuenta que exyliachatcosmetics.chat.format y un nodo de formato como exyliachatcosmetics.chat.format.vip son nodos sin relación entre sí: en Bukkit un nodo no manda sobre los que cuelgan de él. Conceder el segundo no concede el primero.

Los valores por defecto declarados, completos

Todo lo de abajo es lo que escribe plugin.yml. Todo lo que no esté en estas dos listas está sin declarar y, por tanto, es solo para operadores.

default: true — todo el mundo, incluso en un servidor sin plugin de permisos: command.cosmetics, customtag.create, customcolor.create, customnick.create, customrank.create, chat.command.msg, chat.command.reply, chat.command.ignore, chat.command.ignoreall, chat.command.channel, chat.mentions, chat.render.item, chat.render.inv, chat.render.ec.

default: op — operadores hasta que los concedas: admin, chat.command.spymsg, chat.command.mutechat, chat.command.clearchat, chat.command.broadcast, chat.links, chat.format, chat.staff, chat.staff.alerts, chat.staff.filtered.