Menús
Encuentra cada pantalla de /protections, cambia el aspecto de un botón y consulta el archivo y la acción detrás de cada uno.
Todo lo que los jugadores hacen con su terreno pasa por menús abiertos desde /protections. Cada botón
lleva el id de la protección en su acción, así que una pantalla no guarda estado propio: un clic se
comprueba de nuevo contra la protección tal como está cuando llega, y se rechaza si el jugador perdió
entretanto el derecho a hacerlo.
Antes de empezar#
Los textos, los colores y la colocación de los botones siguen ExyliaLib, mira Menús, Colores y Mensajes e idiomas. Edita solo los archivos de menus/user/; los de menus/admin/ se reescriben en cada arranque.
Cambia un botón#
Abre el archivo
En la carpeta del plugin abre lang/<idioma>/menus/user/, por ejemplo main.yml para el menú de /protections, en el idioma que tenga configurado ExyliaLib.
Edítalo
Cambia el nombre, la descripción o el hueco de un botón, o su condition. El archivo de cada pantalla está en El resto de pantallas y en el resumen de abajo.
Recarga
Ejecuta /protectionsadmin reload.
Comprueba que funciona#
Ejecuta /protections y mira el botón que cambiaste. Un archivo que no se puede leer se nombra en la consola y se deja fuera, en lugar de abrirse como una pantalla vacía.
Los archivos#
Cada pantalla es un archivo bajo lang/<idioma>/menus/, en la carpeta del idioma que tenga configurado
ExyliaLib (en, es, pt, fr, ru o tr).
| Carpeta | De quién es | Al actualizar |
|---|---|---|
menus/user/ | Tuya. Cambia estilo, posiciones y textos libremente. | Se conserva. Solo se escriben los archivos que falten. Una versión que tenga que cambiar la disposición de una pantalla sube su menu-version; ese archivo se reemplaza y el tuyo anterior se guarda al lado. |
menus/admin/ | Del plugin. | Se reescribe desde el jar en cada arranque, así las pantallas del staff siempre coinciden con la versión. |
El comentario de cabecera de cada archivo lista los placeholders que recibe. Los botones solo se muestran
mientras se cumple su condition; los placeholders %…_enabled% valen true o false según
submodules. Una acción con el prefijo left:, right:, shift_left: o shift_right: solo se ejecuta con
ese clic; sin prefijo se ejecuta con cualquiera.
Muchas pantallas colocan sus botones con una entrada groups en vez de huecos fijos: un grupo nombra un
rango de huecos ("19-25", por ejemplo), y los botones que lo nombran con group: se dibujan centrados
en ese rango, en el orden del archivo, sin dejar huecos por los que oculta su condition. Los huecos de abajo
son donde los archivos incluidos ponen cada botón con todo activado; con menos botones visibles se juntan
alrededor del centro.
Los archivos de menú se leen cuando se activa el plugin y otra vez con /protectionsadmin reload (o
/protections admin reload) y /exylialib reload. Un archivo que
no se puede leer se nombra en la consola y se deja fuera, en vez de abrirse como una pantalla vacía.
El menú principal#
/protections (o /ps, /claims) abre menus/user/main.yml, una pantalla de 27 huecos.
| Hueco | Botón | Se muestra mientras | Acción |
|---|---|---|---|
| 4 | Tu terreno: cuántas tiene sobre su límite y en cuántas es dueño o miembro | siempre | ninguna |
| fila 10-16 | Mis protecciones | siempre | list |
| fila 10-16 | Tienda, con cuántos tipos hay a la venta | cores.enabled y algún tipo tiene precio | shop |
| fila 10-16 | Seleccionar terreno | selection.enabled y el jugador tiene exyliaprotections.select | select |
| fila 19-25 | En venta, con cuántas hay | submodules.market | market |
| fila 19-25 | En alquiler | submodules.rent | rent |
| fila 19-25 | Warps públicos | submodules.warps | warps |
Los tres primeros son el grupo own y los tres últimos el grupo offers, cada uno centrado en su fila.
La lista#
menus/user/list.yml: cada protección de la que el jugador es dueño o miembro, en cualquier servidor, de
la más antigua a la más nueva, 36 por página. Cada una muestra su dueño, el rol del jugador, tamaño,
ubicación, servidor y número de miembros.
| Clic | Qué hace |
|---|---|
| Clic izquierdo | Abre el resumen de la protección. |
| Clic derecho | Teletransporta al hogar, con la cuenta atrás. |
| Volver (hueco 49) | El menú principal. |
El resumen#
menus/user/manage.yml es la pantalla de una protección: 45 huecos, un resumen arriba y un botón por
sección, centrados en los huecos 19 a 25 (el grupo sections). Necesita ser miembro; los admins abren la de
cualquiera. Un miembro también la abre haciendo clic derecho en el núcleo de la protección (sin agacharse).
Botones del resumen y tarjetas de sección
| Hueco | Botón | Se muestra mientras | Acción |
|---|---|---|---|
| 4 | La protección: dueño, rol del jugador, tipo, tamaño, miembros, ubicación, servidor | siempre | ninguna |
| fila 19-25 | Terreno | siempre | section <id> land |
| fila 19-25 | Personas | siempre | section <id> people |
| fila 19-25 | Acceso | siempre | section <id> access |
| fila 19-25 | Economía | dos o más de bank, upkeep, market, y rent con rent.whole-protection | section <id> economy |
| fila 19-25 | Crecimiento | upgrades y subregions a la vez | section <id> growth |
| fila 19-25 | Defensa | raids y logs a la vez | section <id> defense |
| fila 19-25 | Extras | warps y ventajas (effects o environment) a la vez | section <id> extras |
| 36 | Ir al hogar | siempre | home <id> |
| 40 | Volver | siempre | manage_back <id> |
| 44 | Eliminar | siempre | delete <id> |
Una página de sección nunca tiene una sola tarjeta. Cuando solo una función de la sección Economía,
Crecimiento, Defensa o Extras está activada, el resumen muestra la tarjeta propia de esa función en lugar de
la sección (economy_bank, economy_upkeep, economy_market, economy_rent, growth_upgrade,
growth_subregions, defense_raid, defense_logs, extras_warp, extras_perks), con la misma acción que
tendría la tarjeta de la sección; sin ninguna activada no se muestra nada. Los placeholders %economy_view%,
%growth_view%, %defense_view% y %extras_view% dicen cuál: section (dos o más activadas), la clave de
la única tarjeta activa (bank, upkeep, market, rent, upgrade, subregions, raid, logs, warp,
perks) o none. Los antiguos %economy_enabled%, %growth_enabled%, %defense_enabled% y
%extras_enabled% siguen funcionando.
Volver regresa a la lista, salvo para un admin que mira la protección de otro, que vuelve a la pantalla de admin de la que vino. Todos los botones se muestran a todos los miembros; uno que su rol no permite responde "No puedes hacer eso en esta protección."
Secciones, y la sección que se recuerda#
Cada sección es una pantalla de 36 huecos, menus/user/manage_<sección>.yml, cuyas tarjetas se dibujan
centradas en los huecos 10 a 16 (el grupo cards) y cuyo Volver (hueco 31) regresa al resumen con
section <id> hub. Los huecos de abajo son los de los archivos incluidos con todas las tarjetas activadas.
Abrir una sección la recuerda para ese jugador y esa protección. Cada vez que se vuelve a abrir la pantalla de la protección — un Volver desde miembros, roles, baneos o registros, o la pantalla que vuelve tras un cambio — se llega otra vez a esa sección, no al resumen. Se olvida cuando el jugador vuelve al resumen, abre otra protección o sale del servidor. Abrir una protección desde la lista siempre empieza en el resumen.
Cada sección y sus botones
Terreno — manage_land.yml
| Hueco | Botón | Necesita | Acción |
|---|---|---|---|
| 4 | Resumen: tamaño, ubicación, estado del núcleo | ninguna | |
| 11 | Establecer hogar | set-home, de pie dentro en su servidor | sethome <id> |
| 12 | Renombrar | rename | rename <id> |
| 14 | Ocultar núcleo | manage-core, en su servidor y mundo | hide <id> |
| 15 | Mover protección | manage-core, en su servidor y mundo | move <id> |
| 16 | Mostrar borde (mientras visualization esté activado) | miembro | show <id> |
Personas — manage_people.yml
| Hueco | Botón | Necesita | Acción |
|---|---|---|---|
| 12 | Miembros | manage-members | members <id> |
| 13 | Roles | manage-roles | roles <id> |
| 14 | Expulsiones (mientras bans esté activado) | manage-bans | bans <id> |
Acceso — manage_access.yml
| Hueco | Botón | Necesita | Acción |
|---|---|---|---|
| 12 | Propiedades (las flags) | edit-flags | flags <id> |
| 13 | Bloqueo, abierta o cerrada (mientras lock esté activado) | toggle-lock | lock <id> |
| 14 | Bienvenida y despedida (mientras enter-leave esté activado): izquierdo bienvenida, derecho despedida, shift + derecho borra ambas | rename | greeting <id> greeting|farewell|clear |
Economía — manage_economy.yml
| Hueco | Botón | Necesita | Acción |
|---|---|---|---|
| 10 | Banco (mientras bank esté activado): izquierdo ingresa, derecho retira | bank-deposit / bank-withdraw | bank <id> deposit|withdraw |
| 12 | Mantenimiento (mientras upkeep esté activado): paga lo que se debe | miembro | upkeep <id> |
| 14 | Vender o regalar (mientras market esté activado): izquierdo pone o quita de la venta, derecho regala | dueño | sell <id>, transfer <id> |
| 16 | Alquilar (mientras rent y rent.whole-protection estén activados) | manage-rent | rent_offer <id> * |
Crecimiento — manage_growth.yml
| Hueco | Botón | Necesita | Acción |
|---|---|---|---|
| 12 | Mejorar, nivel sobre el máximo (mientras upgrades esté activado) | dueño | upgrade <id> |
| 13 | Parcelas, cantidad sobre el límite (mientras subregions esté activado) | manage-subregions | subregions <id> |
Defensa — manage_defense.yml
| Hueco | Botón | Necesita | Acción |
|---|---|---|---|
| 12 | Vidas (mientras raids esté activado): recompra una vida | miembro | raid_restore <id> |
| 14 | Registros (mientras logs esté activado) | view-logs | logs <id> all _ |
Extras — manage_extras.yml
| Hueco | Botón | Necesita | Acción |
|---|---|---|---|
| 12 | Warp público (mientras warps esté activado) | manage-warp | warp <id> |
| 14 | Ventajas y ambiente (mientras effects o environment estén activados) | dueño, o edit-environment | perks <id> |
El hueco 4 de cada sección es un resumen de lo que contiene y no tiene acción.
El resto de pantallas#
Cada lista de abajo es una pantalla paginada de 54 huecos: hasta 36 entradas por página (menos en las de cuadrícula), botones de página anterior y siguiente, y Volver en el hueco 49.
Todas las demás pantallas
| Archivo | Lo abre | Qué es |
|---|---|---|
user/members.yml | members | Miembros y clanes; ver Miembros y clanes. Los clanes usan clan_template. Agregar jugador (45), Agregar clan (46). |
user/roles.yml | roles | Roles, con visitor al final usando visitor_template. Crear rol (45). |
user/permissions.yml | flags, role_edit, overrides, subregion_flags, subregion_overrides | Una lista de interruptores. Su título dice qué edita. Pulsar un interruptor ejecuta toggle; Volver ejecuta back. |
user/shop.yml | shop | Cada tipo con precio. Un clic compra un núcleo. |
user/bans.yml | bans | Los baneos en curso. Clic derecho levanta uno. Banear jugador (45). |
user/logs.yml | logs | El registro de auditoría con sus filtros de acción y jugador (45, 46). |
user/market.yml | market | Protecciones en venta, cada una con el estado de su mantenimiento y su banco, que va al vendedor (%protection_upkeep_state%, %protection_bank%, menu-version 3). Izquierdo compra, derecho visita. |
user/rent.yml | rent | Primero los alquileres del propio jugador (rented_template: izquierdo renueva, derecho va al hogar), luego cada oferta (izquierdo alquila, derecho visita). |
user/subregions.yml | subregions | Las parcelas de una protección. Crear parcela (45). |
user/subregion.yml | subregion | Los miembros de una parcela (izquierdo rol, shift + izquierdo ajustes, derecho quita) y sus botones: agregar miembro (45), reglas de parcela (46), privada (47), alquilar (51, mientras rent esté activado), eliminar (53). |
user/warps.yml | warps | Warps públicos. Izquierdo visita, derecho valora. Ordenar (45) recorre visitas, valoración, más nuevos. |
user/warp.yml | warp | El warp de una protección: publicar, llegar aquí, renombrar, icono, descripción. |
user/perks.yml | perks | Interruptores de ventajas para el dueño, y hora (38) y clima (42) mientras environment esté activado. |
admin/hub.yml | /protectionsadmin, admin_hub | El panel de admin: protecciones, tipos, limpieza, ajustes, recarga. Ver Administración. |
admin/settings.yml, settings_*.yml | settings_hub, settings_page, setting | El panel de ajustes y sus páginas (general, funciones, sistemas, asaltos, mantenimiento, comercio, teletransporte). |
admin/raid_replays.yml, raid_replay_controls.yml | /protectionsadmin replays | La lista de repeticiones de asalto y los controles mientras se ve una. |
admin/admin.yml | /protectionsadmin list, admin | Todas las protecciones de la red, con filtros. |
admin/admin_protection.yml | admin_protection | Los botones de admin de una protección, centrados en los huecos 19 a 25; Fijar nivel solo con upgrades activado. |
admin/tiers.yml, admin/tier.yml | admin_tiers, admin_tier | El editor de tipos. |
admin/cleanup.yml | admin_cleanup | La vista previa de la limpieza de inactivas. |
Un interruptor de permissions.yml muestra SÍ / NO para flags y roles, PERMITIR / DENEGAR
/ ROL para los ajustes de un miembro, y PERMITIR / DENEGAR / PROTECCIÓN (seguir a la
protección) para las flags de una parcela.
Acciones#
Cada botón ejecuta una acción escrita exyliaprotections:<nombre> <argumentos>, así que un menú
rediseñado puede llamar a cualquiera. Placeholders como %protection_id% rellenan los argumentos. Se leen
hasta cuatro argumentos.
Antes de ejecutarse, toda acción se rechaza mientras su función está desactivada ("Esa función está
desactivada."), cuando la protección ya no existe ("Esa protección ya no existe."), o cuando el requisito
de abajo no deja pasar al jugador. <id> es un id de protección. La mayoría de acciones de jugador piden
además el nodo de su función, exyliaprotections.<función>, que todos tienen por defecto ("Tu rango no
incluye esa función."); la página de Permisos dice
cuáles.
Todas las acciones
Terreno y la protección en sí
| Acción | Argumentos | Necesita | Qué hace |
|---|---|---|---|
open | El menú principal | ||
list | La lista | ||
shop | cores.enabled | La tienda | |
select | exyliaprotections.select, selection.enabled | Entrega el selector | |
buy | <tipo> | el permiso del tipo, cores.enabled | Compra un núcleo de un tipo con precio |
manage | <id> | miembro | El resumen, o la sección recordada |
section | <id> <land|people|access|economy|growth|defense|extras|hub> | miembro | Abre una sección y la recuerda; hub o cualquier otra cosa abre el resumen y la olvida |
manage_back | <id> | La lista, o la pantalla de admin para un admin que no pertenece a la protección | |
home | <id> | miembro o inquilino | Teletransporta al hogar con la cuenta atrás |
sethome | <id> | set-home | Mueve el hogar a donde está el jugador, dentro |
rename | <id> | rename | Pide un nombre, hasta 32 caracteres de texto plano |
hide | <id> | manage-core | Oculta o muestra el núcleo |
move | <id> | manage-core | Mueve la protección sobre el bloque que se mira, por settings.move-price |
delete | <id> | dueño | Borra tras una confirmación y devuelve el núcleo, en blanco. Si está abandonada, paga antes su mantenimiento tras preguntar; se rechaza mientras se debe mantenimiento |
raid_restore | <id> | miembro, raids | Recompra una vida tras una confirmación |
show | <id> | miembro, visualization | Dibuja el borde |
Personas y acceso
| Acción | Argumentos | Necesita | Qué hace |
|---|---|---|---|
members | <id> | manage-members | La pantalla de miembros |
member_add | <id> | manage-members | Pide un nombre de jugador y luego un rol |
clan_add | <id> | manage-members | Pide la etiqueta de un clan y luego un rol |
member_role | <id> <uuid|clan:<clan>> | manage-members | Pide un rol nuevo |
member_remove | <id> <uuid|clan:<clan>> | manage-members | Quita un miembro o clan tras una confirmación |
overrides | <id> <uuid> | manage-members | Los ajustes personales de un miembro |
roles | <id> | manage-roles | La pantalla de roles |
role_create | <id> | manage-roles | Pide un nombre y abre el rol nuevo |
role_edit | <id> <rol> | manage-roles | Los interruptores de un rol |
role_rename | <id> <rol> | manage-roles | Pide un nombre nuevo |
role_delete | <id> <rol> | manage-roles | Borra tras una confirmación |
flags | <id> | edit-flags | Los interruptores de flags |
toggle | <id> <objetivo> <clave> | depende del objetivo | Cambia un interruptor; ver abajo |
back | <id> <objetivo> | Sale de una pantalla de interruptores: un rol a roles, un miembro a miembros, un objetivo de parcela a la parcela, cualquier otra cosa a la protección | |
lock | <id> | toggle-lock, lock | Cierra o abre; se rechaza mientras visitor-entry esté forzada |
bans | <id> | manage-bans, bans | La pantalla de baneos |
ban_add | <id> | manage-bans, bans | Pregunta a quién y por cuánto tiempo, con un resumen |
unban | <id> <uuid> | manage-bans, bans | Levanta un baneo |
greeting | <id> <greeting|farewell|clear> | rename, enter-leave | Pide la bienvenida o la despedida, o borra ambas. Todo lo que no sea farewell ni clear edita la bienvenida |
logs | <id> <acción|all> <jugador|_> | view-logs, logs | El registro, filtrado; all y _ significan sin filtro |
logs_action | <id> <acción|all> <jugador|_> | view-logs, logs | El registro con el siguiente filtro de acción |
logs_player | <id> <acción|all> | view-logs, logs | Pide un nombre de jugador por el que filtrar |
Objetivos de toggle, tal como los escribe PermissionTarget:
| Objetivo | Interruptores | Necesita |
|---|---|---|
flags | Las flags de la protección | edit-flags; se rechaza para una flag forzada |
role:<nombre> | Los permisos de un rol | manage-roles y tener el permiso; no el rol que tiene el jugador; nunca un permiso de gestión para visitor |
player:<uuid> | Los ajustes personales de un miembro, recorriendo rol, permitir, denegar | manage-members y tener el permiso; no uno mismo |
sub:<parcela>:flags | Las flags de una parcela, recorriendo seguir, activada, desactivada; sin visitor-entry | manage-subregions; se rechaza para una flag forzada |
sub:<parcela>:player:<uuid> | Los ajustes personales de un miembro de la parcela | manage-subregions y tener el permiso; no uno mismo |
Economía y fincas
| Acción | Argumentos | Necesita | Qué hace |
|---|---|---|---|
bank | <id> <deposit|withdraw> | bank-deposit o bank-withdraw, bank | Pide una cantidad. Todo lo que no sea withdraw ingresa |
upkeep | <id> | miembro, upkeep | Paga lo que se debe |
sell | <id> | dueño, market | Pide un precio y la pone en venta, o la retira si ya lo está |
transfer | <id> | dueño, market | Pide un nombre de jugador y le regala la protección |
market | market | El mercado | |
market_buy | <id> | market | Compra una protección en venta |
market_visit | <id> | market | Teletransporta a una protección en venta |
upgrade | <id> | dueño, upgrades | Mejora al siguiente nivel |
subregions | <id> | manage-subregions, subregions | La pantalla de parcelas |
subregion | <id> <parcela> | lo mismo | Una parcela |
subregion_create | <id> | lo mismo | Entrega el selector y luego pide el nombre |
subregion_delete | <id> <parcela> | lo mismo | Borra tras una confirmación |
subregion_private | <id> <parcela> | lo mismo | Alterna privada y compartida |
subregion_flags | <id> <parcela> | lo mismo | Los interruptores de flags de la parcela |
subregion_member_add | <id> <parcela> | lo mismo | Pide un nombre y luego un rol |
subregion_member_role | <id> <parcela> <uuid> | lo mismo | Pide un rol nuevo |
subregion_member_remove | <id> <parcela> <uuid> | lo mismo | Quita a un miembro de la parcela |
subregion_overrides | <id> <parcela> <uuid> | lo mismo | Los ajustes personales de un miembro de la parcela |
rent_offer | <id> <parcela|*> | manage-rent, rent | Pide precio y periodo con un resumen, o cancela la oferta en curso. * o vacío es la protección entera |
rent | rent | La pantalla de alquiler | |
rent_take | <oferta> | rent | Alquila una oferta |
rent_visit | <oferta> | rent | Teletransporta a una oferta |
rent_renew | <id> <parcela|*> | rent | Renueva el alquiler propio del jugador |
Extras
| Acción | Argumentos | Necesita | Qué hace |
|---|---|---|---|
warps | [visits|rating|newest] | warps | Los warps públicos, ordenados; por visitas por defecto |
warps_sort | <orden actual> | warps | Lo mismo, con el siguiente orden |
warp_visit | <id> | warps | Visita un warp |
warp_rate | <id> <orden> | warps | Pide de una a cinco estrellas y vuelve a la lista en ese orden |
warp | <id> | manage-warp, warps | La pantalla del warp de la protección |
warp_toggle | <id> | lo mismo | Publica o retira |
warp_here | <id> | lo mismo | Mueve el warp a donde está el jugador |
warp_rename | <id> | lo mismo | Pide el nombre del warp |
warp_icon | <id> | lo mismo | Pide el icono |
warp_description | <id> | lo mismo | Pide la descripción |
perks | <id> | dueño o edit-environment; effects o environment | La pantalla de ventajas |
perk_toggle | <id> <ventaja> | dueño, effects | Activa o desactiva una ventaja desbloqueada |
time | <id> | edit-environment, environment | Siguiente hora del día |
weather | <id> | edit-environment, environment | Siguiente clima |
Admin
Todas necesitan exyliaprotections.admin. Se describen en
Administración.
| Acción | Argumentos | Qué hace |
|---|---|---|
admin_hub | El panel de admin | |
settings_hub | El panel de ajustes | |
settings_page | <página> | Una página de ajustes |
setting | <clave> | Edita un ajuste |
admin_setting | <clave> | Cambia un ajuste: alterna un interruptor, recorre una flag forzada (permitir, denegar, sin forzar), añade o quita el mundo del admin, o pide un número o texto |
admin_reload | Recarga el plugin, como /protectionsadmin reload | |
admin | La búsqueda de admin | |
admin_filter | <owner|text|world|server|state> | Pide el filtro de dueño o de nombre, o recorre el de mundo, servidor o estado |
admin_filter_clear | <owner|text|world|server|state|all> | Quita un filtro; cualquier otra cosa los quita todos |
admin_protection | <id> | La pantalla de admin de una protección |
admin_teleport | <id> | Teletransporta a ella |
admin_lives | <id> | Pide sus vidas (raids) |
admin_raid_clear | <id> | Termina su asalto (raids) |
admin_abandoned | <id> | La saca del abandono (upkeep) |
admin_level | <id> | Pide su nivel |
admin_transfer | <id> | Pide un dueño nuevo |
admin_delete | <id> | Borra tras una confirmación |
admin_tiers | La lista de tipos | |
admin_tier | <tipo> | Un tipo |
admin_tier_create | Pide un id de tipo nuevo | |
admin_tier_edit | <tipo> <item|name|lore|radius|height|y-radius|price|currency|permission|limit|lives|upkeep> | Edita un campo |
admin_tier_flag | <tipo> <flag> | Cambia una flag inicial |
admin_tier_delete | <tipo> | Borra un tipo sin uso tras una confirmación |
admin_cleanup | Pide los días y muestra la vista previa | |
admin_cleanup_view | <días> <true|false> | La vista previa, con o sin jugadores nunca vistos |
admin_cleanup_run | <días> <true|false> | Ejecuta la limpieza tras una confirmación |
¿Falta algo en esta página? Dínoslo en Discord