Contenido generado con IA — puede contener errores.

ExyliaEmotes/EmpezarActualizada en v1.4.1

Instalación

Los jars, los archivos que escribe y las dos tablas que usa.

Página 2 de 215 min de lectura

Al terminar tendrás ExyliaEmotes funcionando, sus archivos escritos y una zona de vista previa fijada.

Antes de empezar#

Un servidor Paper 1.21.1+ (o Folia 1.21.4+) y el jar de packetevents. Ver Introducción.

Instalar#

Pon los jars

ExyliaEmotes.jar y packetevents en plugins/. packetevents es una dependencia dura: sin él el plugin no carga. ExyliaLib es una dependencia blanda — el loader lo instala en el primer arranque si no está.

Arranca el servidor

Escribe config.yml, emotes.yml, database.yml y las carpetas lang/ con los menús y los mensajes en inglés, español, portugués, francés, ruso y turco, y crea su tabla.

Concede los permisos

No se puede usar nada hasta que los jugadores puedan abrir el menú y tengan al menos un emote. Ver Permisos.

Fija un escenario de previsualización

Clic derecho en un emote del menú lo previsualiza, y una instalación nueva no tiene dónde hacerlo. Ponte donde deban verse las previsualizaciones y ejecuta /emotesadmin preview location.

Comprueba que funciona#

La consola muestra ExyliaEmotes activado y plugins/ExyliaEmotes/ contiene ahora config.yml, emotes.yml y database.yml. /emote abre el menú.

Archivos#

ArchivoContenido
config.ymlEl idioma, el comportamiento, la cámara, los duetos, el icono de favoritos, las rarezas, la caja, el aspecto del objeto llave, el escenario de previsualización, los showcases, el feedback y la tienda.
lang/<código>/messages.ymlCada línea que envía el plugin, el prefijo, los textos del menú, el nombre y el lore del objeto llave, y los valores de reserva de los placeholders.
lang/<código>/emotes.ymlLas cinco pestañas y los 107 emotes, un catálogo por idioma. Escrito a mano, no gestionado por esquema: tus comentarios y tu formato sobreviven a una recarga.
lang/<código>/menus/emotes.ymlLa pantalla principal: pestañas, cuadrícula, plantillas y botones.
lang/<código>/menus/crate.ymlLa primera pantalla de la caja: cuántas abrir a la vez.
lang/<código>/menus/crate_open.ymlLos rodillos cayendo, una columna por caja.
spatial/emotes.ymlDónde está cada pieza del selector 3D.
spatial/crate.ymlEl aspecto de la apertura 3D de la caja, que ExyliaLib escribe la primera vez que hace falta.
spatial/spots.ymlLos selectores 3D colocados con /emotesadmin spatial place, cuando hay alguno.
database.ymlDónde se guardan las filas.

Qué carpeta de lang/ se lee lo decide language en config.yml — ver Configuración.

emotes.yml es tuyo, y aun así recibe emotes nuevos

config.yml y messages.yml se escriben desde un esquema, así que una clave desconocida se descarta y los comentarios se regeneran. emotes.yml no: se lee tal cual está escrito. En cada arranque y recarga se compara con el del jar — un emote que añade una actualización se escribe en tu archivo, y lo que tú cambiaste o borraste se deja en paz.

Los archivos de menú siguen la misma regla. Cuando una versión tiene que cambiar el diseño de un menú, sube menu-version al principio del archivo; entonces el archivo se reemplaza y el tuyo anterior se guarda al lado.

Las tablas#

emotes_players#

La tabla propia de este plugin, una fila por jugador. Las dos tablas están clasificadas como datos @account para /exylialib wipe y resetplayer de ExyliaLib: un wipe de temporada o un reinicio de jugador normal deja en paz favoritos, llaves y desbloqueos, y nombrar @account los borra — consulta los comandos de ExyliaLib.

ColumnaQué guarda
uuidEl jugador.
nameSu último nombre conocido.
favouritesLos emotes que marcó, separados por comas, en su propio orden.
unlockedLo que había desbloqueado la caja antigua del plugin. Se lee una vez y no se vuelve a escribir.
crate_keysLas llaves que tenía la caja antigua del plugin. Se lee una vez y no se vuelve a escribir.
created_at / updated_atCuándo se creó la fila y cuándo se escribió por última vez.

La fila de un jugador nuevo solo se guarda en memoria hasta que se escribe algo en ella, como su primer favorito.

Un id marcado que el catálogo ya no declara se conserva en la columna y se descarta al dibujarlo, así que una errata en una recarga no vacía la lista de nadie.

exylia_crate_players#

Las llaves y los desbloqueos viven en la tabla de cajas de ExyliaLib, una fila por jugador y por plugin. La primera vez que se ve a un jugador ahí, su fila se siembra a partir de emotes_players:

Lo que emotes_players tiene de élCon qué empieza su fila de la caja
Ninguna filacrate.start-keys llaves y nada desbloqueado — un recién llegado.
Una filaSus crate_keys y su unlocked, tal cual, aunque estén vacíos.

Así que actualizar desde una versión que tenía su propia caja se lleva todas las llaves y todos los desbloqueos. Las columnas antiguas no se vuelven a escribir, así que una vuelta atrás las encuentra como estaban. Las llaves en forma de objeto que ya están en los inventarios siguen abriendo la caja.

Actualizar#

Cambia el jar y reinicia. /emotesadmin reload vuelve a leer config.yml, messages.yml, emotes.yml y los menús, reconstruye la caja y reinicia los showcases sin tocar el resto del servidor — a propósito no recarga la librería, que es para lo que está /exylialib reload.

Los emotes necesitan un ExyliaLib reciente

ExyliaEmotes 1.4 necesita ExyliaLib 1.461.0 o superior: el selector 3D, la apertura 3D de la caja y funcionar en Paper 1.21.1 viven ahí. El loader instala la versión más nueva, así que solo importa en un servidor que fije una anterior.

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