Proteger terreno

Menús

El menú /protections, la lista, el resumen de una protección y sus siete secciones, el resto de pantallas, los archivos donde viven y cada acción exyliaprotections: con sus argumentos.

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.

Los archivos

Cada pantalla es un archivo bajo lang/<idioma>/menus/, en la carpeta del idioma que tenga configurado ExyliaLib (en, es, pt o fr).

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.

Los archivos de menú se leen cuando se activa el plugin y otra vez con /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
12	Mis protecciones	siempre	`list`
13	Tienda de protecciones, con cuántos tipos hay a la venta	algún tipo tiene precio	`shop`
14	Seleccionar terreno	`selection.enabled` y el jugador tiene `exyliaprotections.select`	`select`
21	En venta, con cuántas hay	`submodules.market`	`market`
22	En alquiler	`submodules.rent`	`rent`
23	Warps públicos	`submodules.warps`	`warps`

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 espera.
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. Necesita ser miembro; los admins abren la de cualquiera.

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
19	Terreno	siempre	`section <id> land`
20	Personas	siempre	`section <id> people`
21	Acceso	siempre	`section <id> access`
22	Economía	`bank`, `upkeep` o `market` activado, o `rent` con `rent.whole-protection`	`section <id> economy`
23	Crecimiento	`upgrades`, `subregions` o `merge` activado	`section <id> growth`
24	Defensa	`raids` o `logs` activado	`section <id> defense`
25	Extras	`warps`, `effects` o `environment` activado	`section <id> extras`
36	Ir al hogar	siempre	`home <id>`
40	Volver	siempre	`manage_back <id>`
44	Eliminar	siempre	`delete <id>`

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, cuyo Volver (hueco 31) regresa al resumen con section <id> hub.

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.

Terreno — `manage_land.yml`

Hueco	Botón	Necesita	Acción
4	Resumen: tamaño, ubicación, estado del núcleo		ninguna
10	Ir al hogar	miembro o inquilino	`home <id>`
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>`
14	Fusionar (mientras `merge` esté activado)	dueño	`merge <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.

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. 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.
`user/merge.yml`	`merge`	Las protecciones del dueño que tocan esta. Un clic la fusiona.
`admin/admin.yml`	`/protections admin`, `admin`	Todas las protecciones de la red, con filtros. Ver Administración.
`admin/admin_protection.yml`	`admin_protection`	Los botones de admin de una protección.
`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.

Terreno y la protección en sí

Acción	Argumentos	Necesita	Qué hace
`open`			El menú principal
`list`			La lista
`shop`			La tienda
`select`		`exyliaprotections.select`, `selection.enabled`	Entrega el selector
`buy`	`<tipo>`	el permiso del tipo	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 espera
`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
`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
`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
`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`
`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`
`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
`merge`	`<id>`	dueño, `merge`	La pantalla de fusión, o "nada que fusionar"
`merge_pick`	`<id> <otro id>`	dueño, `merge`	Fusiona la otra protección en esta

Admin

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

Acción	Argumentos	Qué hace
`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