Instala ExyliaArmorTrims
Dependencias, los archivos que escribe, y lo que guarda en la base de datos.
Al terminar tendrás ExyliaArmorTrims funcionando, sus archivos escritos y el primer trim listo para entregar. No hay que editar nada: los valores por defecto funcionan.
Antes de empezar#
Un servidor Paper 1.21.1+ o Folia 1.21.4+, y el jar de packetevents. ExyliaLib se instala solo si falta.
Pasos#
Mete los jars
Pon ExyliaArmorTrims.jar y packetevents en plugins/. ExyliaLib es una dependencia blanda: si falta, el loader lo instala en el primer arranque.
Arranca el servidor
Escribe config.yml, trims.yml y los archivos de idioma en lang/.
Elige el modo
behaviour.mode en config.yml es both por defecto. Déjalo así salvo que quieras solo objetos (item) o solo el menú (menu). Ver Elige cómo se llevan los trims.
Da los permisos
Todos pueden abrir el menú, el vestidor, la caja y la tienda por defecto. Los patrones y materiales siguen bloqueados hasta que un nodo, un desbloqueo de caja o una compra los entrega. Ver Permisos.
Comprueba que funciona#
En el juego ejecuta /armortrimsadmin give <tu nombre> sentry/netherite 1, coge el objeto con el cursor y haz clic sobre una pieza de armadura de tu inventario. Debe aparecer el trim en ella y el objeto se gasta. Después /armortrim abre el menú. Ver Tu primer trim.
Para ir más lejos#
Cambia el idioma#
language en config.yml es default, que sigue el idioma de ExyliaLib. Vienen en, es, pt, fr, ru y tr; cualquier otro código parte de los archivos en inglés. Cada uno es una carpeta de lang/ que puedes editar.
Actualiza el plugin#
Cambia el jar y reinicia. /armortrimsadmin reload relee config.yml, messages.yml, trims.yml y los menús, y redibuja a todos los conectados.
El primer arranque de la 1.5.0 mueve la sección presets: de trims.yml a legacy-presets.yml. La armadura y las filas con un id de preset conservan su aspecto, y los desbloqueos de caja de un preset pasan a ser desbloqueos de sus dos mitades. Los nodos de permiso de los presets ya no se leen: da en su lugar los nodos de patrón y de material. Ver Si vienes de los presets.
El primer arranque pone language: custom y mueve menus/trims.yml a lang/custom/. Los textos que vivían en config.yml (mensajes, nombres y lore de objetos, lore de armadura, textos del menú y el valor de reserva de los placeholders) pasan a lang/custom/messages.yml, así que no se pierde nada de lo que editaste. Pon language en default para usar las traducciones que vienen con el plugin.
Archivos que escribe
| Archivo | Contenido |
|---|---|
config.yml | El idioma, el modo, cómo se dibujan los objetos, efectos, vitrinas, la caja y la tienda. |
trims.yml | Los patrones y materiales que se ofrecen, y la rareza y el precio de cada uno. |
lang/<idioma>/messages.yml | Cada línea que envía el plugin, los nombres y lore de los objetos y los textos de los menús. |
lang/<idioma>/menus/trims.yml | La pantalla clásica de trims. |
lang/<idioma>/menus/crate.yml, crate_open.yml | Las dos pantallas de la caja. |
spatial/wardrobe.yml | Dónde está cada pieza del vestidor 3D. Sus textos están en messages.yml. |
spatial/spots.yml | Los vestidores colocados en el mundo con /armortrimsadmin wardrobe place. |
legacy-presets.yml | Se escribe una vez cuando arranca un servidor que viene de la 1.4 o anterior: los presets que tenía trims.yml, como pattern/material. Son datos, no configuración: no lo edites. |
database.yml | Dónde se guardan las filas de abajo. H2 por defecto. |
<idioma> es language en config.yml, o el de ExyliaLib cuando es default.
La base de datos
Se abre en todos los modos: las llaves y desbloqueos de la caja viven en la tabla exylia_crate_players de ExyliaLib, y los objetos que no cupieron en un inventario esperan en exylia_pending_rewards hasta el siguiente login del jugador.
Con menu o both, las elecciones viven además en la tabla armortrim_selection, una fila por jugador:
| Columna | Qué guarda |
|---|---|
uuid | El jugador. |
helmet, chestplate, leggings, boots | Un par pattern/material, como sentry/netherite. |
Una fila escrita cuando existían los presets aún guarda el id suelto de un preset; se reescribe con el aspecto que ese preset tenía la primera vez que se carga la fila. Un valor que el catálogo no conoce, como un patrón que quitaste de trims.yml, no se dibuja y no se limpia. Vuelve el día que vuelve la entrada.
Wipes y reinicios de jugador
Cada tabla declara lo que guarda, así que /exylialib wipe y /exylialib resetplayer de ExyliaLib las cubren sin un comando propio de este plugin.
| Tabla | Tipo |
|---|---|
armortrim_selection | @account: las elecciones del jugador sobreviven a una temporada. |
exylia_crate_players | @account: llaves y desbloqueos de la caja. |
exylia_pending_rewards | @progress: objetos a la espera de un login. |
Un resetplayer normal solo borra progreso, mundo y caché, así que los trims y desbloqueos del jugador se quedan. Nombra @account para llevártelos también: /exylialib resetplayer Steve ExyliaArmorTrims @account. Ver Comandos de ExyliaLib.
¿Falta algo en esta página? Dínoslo en Discord