Configura los rangos y permisos del clan
Los 29 permisos internos, cómo el peso decide quién puede actuar sobre quién, y el bloque default-roles con el que nacen los clanes.
Decide quién del clan puede invitar, expulsar, reclamar terreno o gastar el banco, creando rangos y marcando lo que puede hacer cada uno.
Antes de empezar#
Tienes que ser el líder del clan, o tener un rango con el permiso MANAGE_ROLES. Los rangos pertenecen a cada clan: default-roles en config.yml solo fija cómo queda un clan el día que se crea, y nada de ese archivo llega a los clanes existentes.
Pasos#
Abre el menú de roles
Ejecuta /clan, haz clic en Ajustes y luego en Roles.
Crea el rango
Haz clic en Crear Rol. Escribe el nombre en el chat y luego su peso como número. Un peso mayor tiene más rango (los rangos por defecto usan 100, 50 y 1).
Marca sus permisos
Haz clic en el nuevo rol para abrir Gestionar Rol. Cada permiso es un botón, por ejemplo Expulsar miembros o Reclamar territorio; haz clic para darlo o quitarlo.
Elige quién lo recibe
Para dar el rol a un miembro, ejecuta /clan, haz clic en Miembros, en el miembro y en Asignar rol, y elige el rango. Para que sea el rol de todo miembro nuevo, haz clic en Por defecto dentro de Gestionar Rol.
En Gestionar Rol también puedes cambiar el Peso, Renombrar o Borrar el rol.
Comprueba que funciona#
Da el rol a un miembro de prueba y pídele que intente algo que permite (por ejemplo /clan invite) y algo que no. Lo segundo debe rechazarse. En el menú de roles cada rol muestra su peso, cuántos miembros tiene y si es el rol por defecto.
Quién puede actuar sobre quién#
El peso responde a una sola pregunta: ¿puede este miembro actuar sobre aquel? Solo si el peso de quien actúa es estrictamente mayor que el del objetivo.
- Expulsar, banear, ascender y degradar pasan por ahí.
- Un rango más pesado que el actual del miembro necesita
PROMOTE; uno más ligero,DEMOTE./clan promotey/clan demoteabren el mismo menú de Asignar rol. - Un peso debe ser único en el clan y menor que el de quien lo fija.
- No se puede borrar el rango más pesado ni el último que queda.
Con pesos 100, 50 y 1 puedes insertar un rango entre dos sin renumerar. Con pesos consecutivos no.
El líder es una columna del clan, no un rango. Pasa todas las comprobaciones de permisos sea cual sea su rango y cuenta como más pesado que todos. Un líder no puede hacer /clan leave: debe usar /clan transferleader o /clan disband, y disolver exige que el estado de DTR del clan sea NORMAL.
Cambia los rangos con los que empiezan los clanes nuevos#
Edita default-roles en plugins/ExyliaClans/config.yml y ejecuta /clanadmin reload. Los clanes creados después reciben estos rangos; los existentes conservan los suyos. Las claves (leader, officer, member) las puedes añadir, renombrar o borrar. Exactamente una entrada debe tener is-default: true, y el fundador recibe el rango más pesado del bloque.
/clan create se niega y registra Cannot create a clan: default-roles is empty in config.yml. Deja al menos un rango.
Qué permite cada permiso#
Los 29 permisos de rango
| Permiso | Botón del menú | Qué permite |
|---|---|---|
INVITE | Invitar miembros | /clan invite, cancelar una invitación |
KICK | Expulsar miembros | /clan kick |
BAN | Banear miembros | /clan ban, /clan unban |
PROMOTE | Ascender miembros | Asignar un rango por encima del actual del miembro |
DEMOTE | Degradar miembros | Asignar un rango por debajo |
MANAGE_ROLES | Gestionar roles | Crear, renombrar y borrar rangos, pesos, rango por defecto y marcar permisos |
SEND_ALLIANCE_REQUEST | Pedir alianzas | /clan ally add |
ACCEPT_ALLIANCE | Aceptar alianzas | /clan ally accept, /clan ally decline |
REMOVE_ALLY | Quitar aliados | /clan ally remove |
MANAGE_RIVALS | Gestionar rivales | /clan rival add, /clan rival remove |
SET_HOME | Fijar base | /clan sethome |
REGROUP | Reagrupar | /clan regroup |
DEPOSIT_BANK | Depositar en banco | /clan deposit |
WITHDRAW_BANK | Retirar del banco | /clan withdraw |
TOGGLE_FRIENDLY_FIRE | Fuego amigo | /clan ff |
TOGGLE_OPEN | Abrir/cerrar clan | /clan open |
CLAIM_LAND | Reclamar territorio | /clan claim, /clan reclaim |
UNCLAIM_LAND | Liberar territorio | /clan unclaim |
BUILD | Construir en territorio | Poner y romper bloques, cubos y marcos dentro del terreno del propio clan |
OPEN_DOORS | Abrir puertas | Puertas, trampillas y puertas de valla dentro del terreno |
OPEN_CONTAINERS | Abrir contenedores | Cofres y cualquier otro contenedor dentro del terreno |
SEND_CLAN_MAIL | Enviar correo del clan | Enviar correo a todo el clan |
MANAGE_LFP | Gestionar LFP | Publicar, editar, renovar y cancelar el anuncio /lfp del clan y responder solicitudes |
VIEW_LOGS | Ver registro | El menú de registro |
FOCUS | Fijar focus | /clan focus, fijar y quitar |
CAMP | Fijar campeo | /clan camp |
RALLY | Convocar rally | /clan rally, /clan rally clear |
MANAGE_WEBHOOK | Gestionar webhook | Conectar, probar, configurar y quitar el webhook de Discord del clan |
MANAGE_WARS | Gestionar guerras | Declarar, aceptar y rechazar guerras de clanes |
Cada uno tiene un interruptor en Gestionar Rol. BUILD, OPEN_DOORS y OPEN_CONTAINERS solo se aplican cuando protection-mode es BUILTIN, mira Reclama terreno. No los confundas con los permisos del servidor de Permisos.
Detalles técnicos
default-roles:
leader:
name: Leader
weight: 100
permissions: [all 29, see the table]
is-default: false
officer:
name: Officer
weight: 50
permissions: [INVITE, KICK, BAN, PROMOTE, DEMOTE, SEND_ALLIANCE_REQUEST, ACCEPT_ALLIANCE, REMOVE_ALLY, MANAGE_RIVALS, SET_HOME, REGROUP, DEPOSIT_BANK, WITHDRAW_BANK, SEND_CLAN_MAIL, MANAGE_LFP, VIEW_LOGS, FOCUS, CAMP, RALLY, MANAGE_WARS]
is-default: false
member:
name: Member
weight: 1
permissions: [FOCUS]
is-default: true| Clave | Qué hace |
|---|---|
name | Lo que ven los jugadores. Se quita el formato, se recorta y se corta a 32 caracteres visibles; un nombre vacío tras limpiar se rechaza con errors.role-name-invalid. Lo mismo vale para los rangos escritos en el juego. |
weight | Más alto manda sobre más bajo. |
permissions | Los nombres de la tabla. Lo que no aparece se rechaza; un nombre desconocido se descarta. |
is-default | Si los miembros nuevos reciben este rango. |
El rango líder por defecto tiene los 29 permisos; el oficial tiene 20 (sin MANAGE_ROLES, TOGGLE_FRIENDLY_FIRE, TOGGLE_OPEN, CLAIM_LAND, UNCLAIM_LAND, BUILD, OPEN_DOORS, OPEN_CONTAINERS, MANAGE_WEBHOOK); el miembro solo tiene FOCUS.
Antes de la 1.2.0 los comandos de marcadores no comprobaban ningún permiso de rango, así que en el primer arranque de la 1.2.0 cada rango existente recibió FOCUS, CAMP y RALLY una sola vez (se anota en plugins/ExyliaClans/.migrations). MANAGE_WEBHOOK y MANAGE_WARS no se dan a rangos existentes, así que solo el líder los usa hasta que el clan los marque para otro.
¿Falta algo en esta página? Dínoslo en Discord