Referencia

Configuración

config.yml clave por clave con cada valor por defecto, qué guarda messages.yml y los valores que recibe cada línea, los archivos de menú y sus valores, y la tabla de la base de datos.

Todo se genera en plugins/ExyliaGraves/ en el primer arranque, con comentarios. Edita los archivos de ahí, nunca las copias del jar. /gravesadmin reload aplica los cambios.

config.yml

Los valores por defecto, sin los comentarios:

plugins/ExyliaGraves/config.yml

config-version: 1
language: default
graves:
  expire-time: 60
  on-expire: DROP
  protection-time: 15
  killer-can-loot: true
  max-per-player: 5
  disabled-worlds: []
contents:
  experience: VANILLA
  experience-percent: 100
  ignored-materials: []
  kept-materials: []
collect:
  auto-equip: true
  sneak-to-preview: true
teleport:
  enabled: false
  cost: 0.0
hologram:
  enabled: true
  offset: 1.4
respawn:
  point-compass: true
  remind: true

config-version es la versión del propio archivo, para que el plugin lo actualice; no la toques.

language

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

graves

Clave	Por defecto	Qué hace
`graves.expire-time`	`60`	Cuánto dura una tumba, en minutos, o con unidad: `30m`, `2h`, `1d`. `-1` la mantiene hasta que se recoja. `exyliagraves.expire.<minutes>` le da más a un rango. Ver Caducidad.
`graves.on-expire`	`DROP`	Qué pasa con el contenido cuando una tumba caduca: `DROP` lo suelta donde estaba, `DELETE` lo borra. Cualquier valor que no sea `DELETE` lo suelta.
`graves.protection-time`	`15`	Cuántos minutos solo el dueño puede abrirla. `0` es cualquiera desde el principio, `-1` solo el dueño, siempre. Ver Protección.
`graves.killer-can-loot`	`true`	Si quien hizo la muerte puede abrirla mientras está protegida. No con una protección de `-1`.
`graves.max-per-player`	`5`	Cuántas tumbas puede tener en pie un jugador en este servidor. Morir con esas vacía la más antigua donde está. `-1` es sin límite. `exyliagraves.limit.<n>` lo sube. Ver Límites.
`graves.disabled-worlds`	`[]`	Mundos, por nombre, donde nadie recibe tumba. Sin distinguir mayúsculas.

Clave	Por defecto	Qué hace
`contents.experience`	`VANILLA`	`NONE` (los orbes caen como siempre), `VANILLA` (lo que habría caído en orbes) o `ALL` (cada punto que tenía el jugador, niveles incluidos). Un valor desconocido se lee como `VANILLA`. Ver Experiencia.
`contents.experience-percent`	`100`	De esa experiencia, el porcentaje que guarda la tumba, de 0 a 100. El resto se pierde.
`contents.ignored-materials`	`[]`	Materiales que nunca entran en una tumba: caen al suelo como siempre.
`contents.kept-materials`	`[]`	Materiales que el jugador conserva al morir, en su inventario.

collect

Clave	Por defecto	Qué hace
`collect.auto-equip`	`true`	Si la armadura y la mano secundaria del dueño se vuelven a poner directamente, en huecos vacíos, cuando recoge él mismo su tumba.
`collect.sneak-to-preview`	`true`	Si hacer clic agachado en una tumba mira dentro en lugar de recogerla. Necesita `exyliagraves.preview`.

teleport

Clave	Por defecto	Qué hace
`teleport.enabled`	`false`	Si `/graves` deja que un jugador vaya a una de las suyas. Necesita `exyliagraves.teleport`.
`teleport.cost`	`0.0`	Lo que cuesta ese teletransporte, en la moneda por defecto de ExyliaLib. `0` es gratis; `exyliagraves.teleport.free` se lo salta. Ver El menú /graves.

hologram

Clave	Por defecto	Qué hace
`hologram.enabled`	`true`	Si una tumba tiene texto flotando encima. Al desactivarlo, todos los hologramas se quitan en un segundo; al volver a activarlo, vuelven cuando sus chunks cargan de nuevo o en el siguiente arranque.
`hologram.offset`	`1.4`	A qué altura sobre el bloque flota el texto.

Las líneas del holograma son hologram-lines en messages.yml.

respawn

Clave	Por defecto	Qué hace
`respawn.point-compass`	`true`	Si la brújula del jugador apunta a su tumba más reciente al reaparecer, cuando está en el mismo mundo.
`respawn.remind`	`true`	Si se le recuerda dónde está su tumba más reciente al reaparecer.

messages.yml

lang/<code>/messages.yml guarda cada línea que dice el plugin. %prefix% se sustituye por el valor prefix del principio, {primary}&lTUMBAS {letters_black}•<reset> en español. Los colores son tokens de paleta, así que cambiar los colores del servidor nunca obliga a editar este archivo.

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 se envía — así se desactiva un mensaje.

Claves	Cuándo	Valores
`prefix`	Abre cada línea del chat mediante `%prefix%`.
`created`	Una muerte creó una tumba.	`%x%` `%y%` `%z%` `%world%` `%items%` `%time_left%`
`collected`	El dueño la recogió.	`%items%` `%experience%` `%player%`
`looted`	Otro la recogió.	`%items%` `%experience%` `%player%` (el dueño)
`protected-grave`, `protected-grave-forever`	Un jugador que no puede abrirla hizo clic.	`%player%` `%time_left%`
`gone`	La tumba ya se la había llevado otro.
`cannot-break`	Alguien intentó picarla.
`claim-failed`	No se pudo llegar a la base de datos; la tumba sigue ahí.
`rewards-delivered`	Se entregó al entrar el contenido guardado para un jugador.	`%amount%`
`respawn-reminder`	Al reaparecer.	`%x%` `%y%` `%z%` `%world%`
`looted-notice`	Aviso para el dueño cuando alguien saqueó su tumba.	`%player%` `%items%` `%world%`
`expired-dropped`, `expired-deleted`	Aviso para el dueño cuando una tumba caducó.	`%items%`
`preview-title`	El título de la ventana de vista previa.	`%player%`
`cannot-preview`	Una vista previa no permitida.
`teleported`, `teleport-disabled`, `not-enough-money`, `teleport-refunded`	El teletransporte desde `/graves`.	`%cost%`, con el formato de la moneda
`in-combat`	Un teletransporte rechazado en combate.	`%time%`
`server-unreachable`, `world-not-loaded`, `teleport-failed`	Por qué no llegó un teletransporte.
`no-permission`	Falta un nodo.
`hologram-protected`, `hologram-open`, `hologram-forever`, `hologram-protected-for`	Las palabras de `%protection%` y de un `%time_left%` que no termina.	`%time_left%` en `hologram-protected-for`
`hologram-lines`	Las líneas encima de una tumba, de arriba abajo.	`%player%` `%items%` `%time_left%` `%protection%`
`menu-teleport`, `menu-preview`, `menu-restore`, `menu-remove`	Las indicaciones de clic de una tumba en los menús. Vacía oculta una.
`admin-usage`	`/gravesadmin` solo.
`restore-prompt`, `restored`, `restored-all`	Devolver tumbas.	`%player%` `%count%`
`remove-prompt`, `removed`	Eliminar una tumba.	`%player%`
`no-graves`	`/gravesadmin restore` sobre un jugador sin tumbas.	`%player%`
`reloaded`	`/gravesadmin reload`.

%items% siempre es un número de stacks, y %experience% un número de puntos.

Menús

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

Archivo	Se abre con	Cambios
`user/graves.yml`	`/graves`	Tuyos. Una versión solo añade lo que falta, salvo que suba `menu-version`, que reemplaza el archivo y guarda el anterior a su lado.
`admin/graves.yml`	`/gravesadmin list <player>`	Se reemplaza desde el jar en cada arranque y en cada recarga de menús.

Las dos son paginadas, de 54 huecos, con las tumbas en los huecos 0-35, página anterior y siguiente en 48 y 50, y la cabecera en 49. Un archivo de menú que no se puede leer se nombra en consola y esa pantalla no se abre; arréglalo y ejecuta /gravesadmin reload.

Valores

Dónde	Valores
La pantalla	`%owner_name%`, `%graves%` (cuántas)
Cada tumba	`%grave_id%`, `%grave_owner%`, `%grave_items%`, `%grave_experience%`, `%grave_server%`, `%grave_world%`, `%grave_x%`, `%grave_y%`, `%grave_z%`, `%grave_age%`, `%grave_time_left%`, `%grave_protection%`, `%grave_actions%`

%grave_age%, %grave_time_left% y %grave_protection% siguen corriendo mientras la pantalla está abierta. %grave_actions% son las indicaciones de clic que puede usar quien mira, de los mensajes menu-…, cada una en su línea.

Acciones

Los botones de las tumbas llaman a estas. Cada una vuelve a comprobar, en el clic, contra la tumba tal como está guardada.

Acción	Qué hace
`exyliagraves:teleport <id>`	Teletransporta a la tumba: al dueño con las reglas del teletransporte, al staff con `admin.view` a cualquiera.
`exyliagraves:preview <id>`	Abre la vista previa.
`exyliagraves:restore <id>`	La devuelve tras una confirmación. Necesita `exyliagraves.admin.restore`.
`exyliagraves:remove <id>`	La elimina tras una confirmación. Necesita `exyliagraves.admin.remove`.

Base de datos

Tabla	Guarda
`sc_graves`	Una fila por tumba en pie, en todos los servidores. Ver Red.

El contenido que espera a que un jugador entre se guarda en las recompensas pendientes de ExyliaLib, y los avisos que esperan a que entre en exylia_notices de ExyliaLib, en la misma base de datos.

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