Contenido generado con IA — puede contener errores.

ExyliaProtections/GuíasActualizada en v1.1.0

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.

Página 6 de 2521 min de lectura

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).

CarpetaDe quién esAl 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.

HuecoBotónSe muestra mientrasAcción
4Tu terreno: cuántas tiene sobre su límite y en cuántas es dueño o miembrosiempreninguna
fila 10-16Mis proteccionessiemprelist
fila 10-16Tienda, con cuántos tipos hay a la ventacores.enabled y algún tipo tiene precioshop
fila 10-16Seleccionar terrenoselection.enabled y el jugador tiene exyliaprotections.selectselect
fila 19-25En venta, con cuántas haysubmodules.marketmarket
fila 19-25En alquilersubmodules.rentrent
fila 19-25Warps públicossubmodules.warpswarps

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.

ClicQué hace
Clic izquierdoAbre el resumen de la protección.
Clic derechoTeletransporta 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
HuecoBotónSe muestra mientrasAcción
4La protección: dueño, rol del jugador, tipo, tamaño, miembros, ubicación, servidorsiempreninguna
fila 19-25Terrenosiempresection <id> land
fila 19-25Personassiempresection <id> people
fila 19-25Accesosiempresection <id> access
fila 19-25Economíados o más de bank, upkeep, market, y rent con rent.whole-protectionsection <id> economy
fila 19-25Crecimientoupgrades y subregions a la vezsection <id> growth
fila 19-25Defensaraids y logs a la vezsection <id> defense
fila 19-25Extraswarps y ventajas (effects o environment) a la vezsection <id> extras
36Ir al hogarsiemprehome <id>
40Volversiempremanage_back <id>
44Eliminarsiempredelete <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

HuecoBotónNecesitaAcción
4Resumen: tamaño, ubicación, estado del núcleoninguna
11Establecer hogarset-home, de pie dentro en su servidorsethome <id>
12Renombrarrenamerename <id>
14Ocultar núcleomanage-core, en su servidor y mundohide <id>
15Mover protecciónmanage-core, en su servidor y mundomove <id>
16Mostrar borde (mientras visualization esté activado)miembroshow <id>

Personas — manage_people.yml

HuecoBotónNecesitaAcción
12Miembrosmanage-membersmembers <id>
13Rolesmanage-rolesroles <id>
14Expulsiones (mientras bans esté activado)manage-bansbans <id>

Acceso — manage_access.yml

HuecoBotónNecesitaAcción
12Propiedades (las flags)edit-flagsflags <id>
13Bloqueo, abierta o cerrada (mientras lock esté activado)toggle-locklock <id>
14Bienvenida y despedida (mientras enter-leave esté activado): izquierdo bienvenida, derecho despedida, shift + derecho borra ambasrenamegreeting <id> greeting|farewell|clear

Economía — manage_economy.yml

HuecoBotónNecesitaAcción
10Banco (mientras bank esté activado): izquierdo ingresa, derecho retirabank-deposit / bank-withdrawbank <id> deposit|withdraw
12Mantenimiento (mientras upkeep esté activado): paga lo que se debemiembroupkeep <id>
14Vender o regalar (mientras market esté activado): izquierdo pone o quita de la venta, derecho regaladueñosell <id>, transfer <id>
16Alquilar (mientras rent y rent.whole-protection estén activados)manage-rentrent_offer <id> *

Crecimiento — manage_growth.yml

HuecoBotónNecesitaAcción
12Mejorar, nivel sobre el máximo (mientras upgrades esté activado)dueñoupgrade <id>
13Parcelas, cantidad sobre el límite (mientras subregions esté activado)manage-subregionssubregions <id>

Defensa — manage_defense.yml

HuecoBotónNecesitaAcción
12Vidas (mientras raids esté activado): recompra una vidamiembroraid_restore <id>
14Registros (mientras logs esté activado)view-logslogs <id> all _

Extras — manage_extras.yml

HuecoBotónNecesitaAcción
12Warp público (mientras warps esté activado)manage-warpwarp <id>
14Ventajas y ambiente (mientras effects o environment estén activados)dueño, o edit-environmentperks <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
ArchivoLo abreQué es
user/members.ymlmembersMiembros y clanes; ver Miembros y clanes. Los clanes usan clan_template. Agregar jugador (45), Agregar clan (46).
user/roles.ymlrolesRoles, con visitor al final usando visitor_template. Crear rol (45).
user/permissions.ymlflags, role_edit, overrides, subregion_flags, subregion_overridesUna lista de interruptores. Su título dice qué edita. Pulsar un interruptor ejecuta toggle; Volver ejecuta back.
user/shop.ymlshopCada tipo con precio. Un clic compra un núcleo.
user/bans.ymlbansLos baneos en curso. Clic derecho levanta uno. Banear jugador (45).
user/logs.ymllogsEl registro de auditoría con sus filtros de acción y jugador (45, 46).
user/market.ymlmarketProtecciones 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.ymlrentPrimero los alquileres del propio jugador (rented_template: izquierdo renueva, derecho va al hogar), luego cada oferta (izquierdo alquila, derecho visita).
user/subregions.ymlsubregionsLas parcelas de una protección. Crear parcela (45).
user/subregion.ymlsubregionLos 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.ymlwarpsWarps públicos. Izquierdo visita, derecho valora. Ordenar (45) recorre visitas, valoración, más nuevos.
user/warp.ymlwarpEl warp de una protección: publicar, llegar aquí, renombrar, icono, descripción.
user/perks.ymlperksInterruptores de ventajas para el dueño, y hora (38) y clima (42) mientras environment esté activado.
admin/hub.yml/protectionsadmin, admin_hubEl panel de admin: protecciones, tipos, limpieza, ajustes, recarga. Ver Administración.
admin/settings.yml, settings_*.ymlsettings_hub, settings_page, settingEl panel de ajustes y sus páginas (general, funciones, sistemas, asaltos, mantenimiento, comercio, teletransporte).
admin/raid_replays.yml, raid_replay_controls.yml/protectionsadmin replaysLa lista de repeticiones de asalto y los controles mientras se ve una.
admin/admin.yml/protectionsadmin list, adminTodas las protecciones de la red, con filtros.
admin/admin_protection.ymladmin_protectionLos 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.ymladmin_tiers, admin_tierEl editor de tipos.
admin/cleanup.ymladmin_cleanupLa 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ónArgumentosNecesitaQué hace
openEl menú principal
listLa lista
shopcores.enabledLa tienda
selectexyliaprotections.select, selection.enabledEntrega el selector
buy<tipo>el permiso del tipo, cores.enabledCompra un núcleo de un tipo con precio
manage<id>miembroEl resumen, o la sección recordada
section<id> <land|people|access|economy|growth|defense|extras|hub>miembroAbre 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 inquilinoTeletransporta al hogar con la cuenta atrás
sethome<id>set-homeMueve el hogar a donde está el jugador, dentro
rename<id>renamePide un nombre, hasta 32 caracteres de texto plano
hide<id>manage-coreOculta o muestra el núcleo
move<id>manage-coreMueve la protección sobre el bloque que se mira, por settings.move-price
delete<id>dueñoBorra 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, raidsRecompra una vida tras una confirmación
show<id>miembro, visualizationDibuja el borde

Personas y acceso

AcciónArgumentosNecesitaQué hace
members<id>manage-membersLa pantalla de miembros
member_add<id>manage-membersPide un nombre de jugador y luego un rol
clan_add<id>manage-membersPide la etiqueta de un clan y luego un rol
member_role<id> <uuid|clan:<clan>>manage-membersPide un rol nuevo
member_remove<id> <uuid|clan:<clan>>manage-membersQuita un miembro o clan tras una confirmación
overrides<id> <uuid>manage-membersLos ajustes personales de un miembro
roles<id>manage-rolesLa pantalla de roles
role_create<id>manage-rolesPide un nombre y abre el rol nuevo
role_edit<id> <rol>manage-rolesLos interruptores de un rol
role_rename<id> <rol>manage-rolesPide un nombre nuevo
role_delete<id> <rol>manage-rolesBorra tras una confirmación
flags<id>edit-flagsLos interruptores de flags
toggle<id> <objetivo> <clave>depende del objetivoCambia 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, lockCierra o abre; se rechaza mientras visitor-entry esté forzada
bans<id>manage-bans, bansLa pantalla de baneos
ban_add<id>manage-bans, bansPregunta a quién y por cuánto tiempo, con un resumen
unban<id> <uuid>manage-bans, bansLevanta un baneo
greeting<id> <greeting|farewell|clear>rename, enter-leavePide 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, logsEl registro, filtrado; all y _ significan sin filtro
logs_action<id> <acción|all> <jugador|_>view-logs, logsEl registro con el siguiente filtro de acción
logs_player<id> <acción|all>view-logs, logsPide un nombre de jugador por el que filtrar

Objetivos de toggle, tal como los escribe PermissionTarget:

ObjetivoInterruptoresNecesita
flagsLas flags de la protecciónedit-flags; se rechaza para una flag forzada
role:<nombre>Los permisos de un rolmanage-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, denegarmanage-members y tener el permiso; no uno mismo
sub:<parcela>:flagsLas flags de una parcela, recorriendo seguir, activada, desactivada; sin visitor-entrymanage-subregions; se rechaza para una flag forzada
sub:<parcela>:player:<uuid>Los ajustes personales de un miembro de la parcelamanage-subregions y tener el permiso; no uno mismo

Economía y fincas

AcciónArgumentosNecesitaQué hace
bank<id> <deposit|withdraw>bank-deposit o bank-withdraw, bankPide una cantidad. Todo lo que no sea withdraw ingresa
upkeep<id>miembro, upkeepPaga lo que se debe
sell<id>dueño, marketPide un precio y la pone en venta, o la retira si ya lo está
transfer<id>dueño, marketPide un nombre de jugador y le regala la protección
marketmarketEl mercado
market_buy<id>marketCompra una protección en venta
market_visit<id>marketTeletransporta a una protección en venta
upgrade<id>dueño, upgradesMejora al siguiente nivel
subregions<id>manage-subregions, subregionsLa pantalla de parcelas
subregion<id> <parcela>lo mismoUna parcela
subregion_create<id>lo mismoEntrega el selector y luego pide el nombre
subregion_delete<id> <parcela>lo mismoBorra tras una confirmación
subregion_private<id> <parcela>lo mismoAlterna privada y compartida
subregion_flags<id> <parcela>lo mismoLos interruptores de flags de la parcela
subregion_member_add<id> <parcela>lo mismoPide un nombre y luego un rol
subregion_member_role<id> <parcela> <uuid>lo mismoPide un rol nuevo
subregion_member_remove<id> <parcela> <uuid>lo mismoQuita a un miembro de la parcela
subregion_overrides<id> <parcela> <uuid>lo mismoLos ajustes personales de un miembro de la parcela
rent_offer<id> <parcela|*>manage-rent, rentPide precio y periodo con un resumen, o cancela la oferta en curso. * o vacío es la protección entera
rentrentLa pantalla de alquiler
rent_take<oferta>rentAlquila una oferta
rent_visit<oferta>rentTeletransporta a una oferta
rent_renew<id> <parcela|*>rentRenueva el alquiler propio del jugador

Extras

AcciónArgumentosNecesitaQué hace
warps[visits|rating|newest]warpsLos warps públicos, ordenados; por visitas por defecto
warps_sort<orden actual>warpsLo mismo, con el siguiente orden
warp_visit<id>warpsVisita un warp
warp_rate<id> <orden>warpsPide de una a cinco estrellas y vuelve a la lista en ese orden
warp<id>manage-warp, warpsLa pantalla del warp de la protección
warp_toggle<id>lo mismoPublica o retira
warp_here<id>lo mismoMueve el warp a donde está el jugador
warp_rename<id>lo mismoPide el nombre del warp
warp_icon<id>lo mismoPide el icono
warp_description<id>lo mismoPide la descripción
perks<id>dueño o edit-environment; effects o environmentLa pantalla de ventajas
perk_toggle<id> <ventaja>dueño, effectsActiva o desactiva una ventaja desbloqueada
time<id>edit-environment, environmentSiguiente hora del día
weather<id>edit-environment, environmentSiguiente clima

Admin

Todas necesitan exyliaprotections.admin. Se describen en Administración.

AcciónArgumentosQué hace
admin_hubEl panel de admin
settings_hubEl 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_reloadRecarga el plugin, como /protectionsadmin reload
adminLa 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_tiersLa lista de tipos
admin_tier<tipo>Un tipo
admin_tier_createPide 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_cleanupPide 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