Referencia

Configuración

config.yml clave por clave con sus valores por defecto, qué contiene messages.yml, los dos archivos de menú con sus valores y acciones, y las tablas de la base de datos.

Todo se genera en plugins/ExyliaPlayerVaults/ en el primer arranque, con comentarios. Edita los archivos de ahí, nunca las copias del jar. /pvadmin reload aplica un cambio.

config.yml

plugins/ExyliaPlayerVaults/config.yml

language: default
vaults:
  default-amount: 1
  max-amount: 9
  default-rows: 6
  hidden-slots: keep
  blocked-materials: []
  checkpoint: 30s
  save-player-on-write: true
restrictions:
  open-cooldown: 500ms
  block-in-combat: true
  disabled-worlds: []
  disabled-game-modes:
    - SPECTATOR
purchase:
  enabled: false
  currency: ''
  base-price: 5000.0
  price-multiplier: 1.5
  max-purchases: 9
history:
  keep: 10
customization:
  name-max-length: 24
  default-icon: BARREL
sounds:
  opened: BLOCK_BARREL_OPEN|1.0|1.2
  closed: BLOCK_BARREL_CLOSE|1.0|1.2

Las duraciones se leen como en todo Exylia: 500ms, 30s, 1m30s; un número solo son segundos.

language

Clave	Por defecto	Qué hace
`language`	`default`	El idioma de los menús y mensajes de este plugin. `default` sigue el idioma de `config.yml` de ExyliaLib; `en`, `es`, `pt`, `fr`, `ru` o `tr` lo fijan solo para este plugin. Cada uno es una carpeta dentro de `lang/`.

vaults

Clave	Por defecto	Qué hace
`default-amount`	`1`	Baúles que tiene un jugador sin un `exyliaplayervaults.amount.<number>` propio.
`max-amount`	`9`	El máximo de baúles para cualquiera, comprados incluidos, tenga los permisos que tenga. También cuántas entradas dibuja la lista.
`default-rows`	`6`	Filas por baúl sin un `exyliaplayervaults.rows.<1-6>` propio. Limitado a 1–6.
`hidden-slots`	`keep`	Qué pasa con los stacks que quedan tras la última ranura de un baúl más pequeño: `keep` los guarda fuera de la vista, `return` los devuelve. Ver Baúles.
`blocked-materials`	`[]`	Materiales que no pueden entrar en un baúl, por nombre, sin distinguir mayúsculas. Las cajas de shulker y bolsas que lleven uno también se rechazan.
`checkpoint`	`30s`	Cada cuánto se guarda un baúl abierto que cambió mientras sigue abierto, para que un crasheo cueste como mucho eso. Nunca menos de un segundo.
`save-player-on-write`	`true`	Guarda el archivo de inventario del jugador tras cada escritura que cambió su baúl, para que un crasheo justo después no pueda dejar un objeto en los dos sitios.

restrictions

Nada de esto se aplica al staff que abre el baúl de otro.

Clave	Por defecto	Qué hace
`open-cooldown`	`500ms`	Cuánto espera un jugador entre abrir dos baúles. `0s` lo desactiva. Se salta con `exyliaplayervaults.bypass.cooldown`.
`block-in-combat`	`true`	Impide abrir un baúl mientras el jugador está en combate, y cierra el que tenga abierto cuando golpea o recibe un golpe de un jugador.
`disabled-worlds`	`[]`	Mundos en los que no se pueden abrir baúles, por nombre.
`disabled-game-modes`	`[SPECTATOR]`	Modos de juego en los que no se pueden abrir baúles: `SURVIVAL`, `CREATIVE`, `ADVENTURE`, `SPECTATOR`.

Los tres últimos se saltan con exyliaplayervaults.bypass.restrictions.

purchase

Clave	Por defecto	Qué hace
`enabled`	`false`	Permite a los jugadores comprar baúles por encima de lo que les da su rango, desde la lista.
`currency`	`''`	La moneda en la que pagan, por ID. Vacío usa la moneda por defecto de ExyliaLib.
`base-price`	`5000.0`	Lo que cuesta el primer baúl comprado.
`price-multiplier`	`1.5`	Cada baúl siguiente cuesta estas veces el anterior. `1.0` deja todos en `base-price`.
`max-purchases`	`9`	El máximo de baúles que puede comprar un jugador. `max-amount` sigue limitando el total.

Ver Compras.

history

Clave	Por defecto	Qué hace
`keep`	`10`	Cuántas copias anteriores de cada baúl se guardan, de la más nueva a la más vieja. `0` no guarda ninguna. Ver Herramientas de staff.

customization

Clave	Por defecto	Qué hace
`name-max-length`	`24`	El nombre más largo que un jugador puede darle a un baúl. Los nombres solo admiten letras, números, espacios y `- _ ' . ! ? # ( )`.
`default-icon`	`BARREL`	Cómo se dibuja un baúl en la lista hasta que su dueño elige un icono: un material de menú como `CHEST`, `playerhead-<name>` o `basehead-<texture>`.

sounds

Clave	Por defecto	Qué hace
`opened`	`BLOCK_BARREL_OPEN\|1.0\|1.2`	Suena al abrirse una ventana de baúl, como `NAME\|volumen\|tono`. Vacío no suena nada.
`closed`	`BLOCK_BARREL_CLOSE\|1.0\|1.2`	Suena cuando un jugador cierra una ventana de baúl.

messages.yml

lang/<code>/messages.yml contiene cada línea que dice el plugin y cada título de ventana. %prefix% se sustituye por el valor prefix del principio, {primary}&lBAÚLES {letters_black}•<reset> en español. Los colores son tokens de la paleta.

Una línea puede empezar con una etiqueta de efecto, que nunca llega a la pantalla: [sound:NAME|volume|pitch] reproduce un sonido a quien la recibe. Una línea vacía no envía nada — así se desactiva un mensaje.

Claves	Qué son
`prefix`	Abre cada línea de chat a través de `%prefix%`.
`title`, `admin-title`, `view-title`, `snapshot-title`	Títulos de ventana: tu propio baúl, un baúl que edita el staff, una vista de solo lectura, una copia del historial. `%number%` es el baúl, `%player%` su dueño, `%name%` su nombre (en `title` y `admin-title`).
`default-name`	Cómo se llama un baúl hasta que se renombra: `#%number%`.
`in-use`, `not-unlocked`, `unreadable`, `blocked-item`, `lock-lost`, `taken-over`, `taking-over`	Abrir y mantener un baúl.
`hidden-stacks`, `returned`, `rewards-delivered`	Un baúl que encogió (`%count%` stacks), y los objetos devueltos al entrar (`%amount%`).
`cooldown`, `in-combat`, `disabled-world`, `disabled-game-mode`	Restricciones. `%time%` es lo que queda del cooldown.
`rename-prompt`, `name-invalid`, `renamed`, `rename-reset`, `icon-prompt`, `icon-changed`, `no-permission`	Nombres e iconos.
`buy-prompt`, `bought`, `buy-too-poor`, `buy-limit`, `buy-disabled`, `buy-failed`	Compras. `%price%` va con el formato de la moneda, `%number%` es el baúl comprado.
`search-header`, `search-line`, `search-none`	`/pv search`. `%query%` es lo buscado, `%amount%` cuántos se encontraron, `%name%` el baúl.
`admin-usage`	Las líneas que muestra `/pvadmin`.
`clear-prompt`, `cleared`, `restore-prompt`, `restored`, `history-empty`, `snapshot-missing`, `reloaded`	Herramientas de staff. `%when%` es hace cuánto se tomó una copia.

Menús

Dos pantallas, en lang/<code>/menus/.

Archivo	Se abre con	Cambios
`user/vaults.yml`	`/pv`, `/pvadmin list`	Tuyo. Se conserva entre actualizaciones; una versión que tenga que cambiar su diseño sube `menu-version`, reemplaza el archivo y deja el tuyo anterior al lado.
`admin/history.yml`	`/pvadmin history`	Se reemplaza desde el jar en cada arranque y en cada recarga de menús.

Un archivo de menú que no se puede leer se nombra en la consola y esa pantalla no se abre; arréglalo y ejecuta /pvadmin reload.

La lista de baúles

vaults.yml es un menú PAGINATION con tres plantillas: item_template para los baúles que tiene el dueño, buy_template para el siguiente a la venta, locked_template para el resto.

Valores de la pantalla	Cada baúl
`%owner_name%`, `%vaults_unlocked%`, `%vaults_max%`, `%vaults_bought%`, `%vaults_rows%`	`%vault_number%`, `%vault_name%`, `%vault_icon%`, `%vault_used%`, `%vault_size%`, `%vault_free%`, `%vault_owner%` y, en el que está a la venta, `%vault_price%`

%vault_owner% es el UUID del dueño, que los botones pasan a las acciones. %vaults_max% es cuántas entradas se dibujan: max-amount, o la cantidad desbloqueada si es mayor.

La pantalla del historial

Valores de la pantalla	Cada copia
`%owner_name%`, `%vault_number%`, `%history_size%`	`%snapshot_id%`, `%snapshot_date%`, `%snapshot_when%`, `%snapshot_cause%`, `%snapshot_actor%`, `%snapshot_used%`

%snapshot_cause% es CLOSED, EDITED, CLEARED o RESTORED; %snapshot_used% es cuántos stacks tiene la copia.

Acciones

Los botones llaman a estas, y cualquier menú de cualquier plugin de Exylia también puede:

Acción	Qué hace
`exyliaplayervaults:open <owner> <number>`	Abre un baúl. El tuyo pasa por todas las comprobaciones de jugador; el de otro se abre para editar con `admin.edit`, en solo lectura con `admin.view`, y si no, no hace nada.
`exyliaplayervaults:rename <owner> <number>`	Pide un nombre nuevo. Tu propio baúl desbloqueado con `customize.name`, o el de cualquiera con `admin.edit`.
`exyliaplayervaults:icon <owner> <number>`	Pide un icono nuevo, en las mismas condiciones con `customize.icon`.
`exyliaplayervaults:buy`	Le vende a quien hace clic su siguiente baúl.
`exyliaplayervaults:snapshot_view <id>`	Muestra una copia del historial, en solo lectura. Necesita `admin.history`.
`exyliaplayervaults:snapshot_restore <id>`	Restaura una copia del historial tras una confirmación. Necesita `admin.history` y `admin.edit`.

<owner> es un UUID; nunca se confía en el dueño que dice el botón, así que actuar sobre el baúl de otro siempre vuelve a pedir el permiso de staff.

Base de datos

Todas las tablas están en la base de datos a la que apunta database.yml; se listan en Red.

¿Falta algo en esta página? Dínoslo en Discord