Guía Plugin + Mod MC 1.21.1

Instalación

EventUI tiene dos componentes que deben instalarse por separado: el plugin en el servidor y el mod en el cliente. Ambos son necesarios para que el sistema funcione.

Requisitos

Servidor

Requisito Versión Notas
Java 21 o superior Requerido por Minecraft 1.21.1
Paper 1.21.1 Recomendado para servidores vanilla-like
Arclight 1.21.1 Para servidores con mods Forge. EventUI incluye soporte nativo para Arclight

Cliente

Requisito Versión Notas
Fabric Loader 0.16 o superior Instalador disponible en fabricmc.net
Fabric API Compatible con 1.21.1 Único mod requerido además de EventUI
Minecraft 1.21.1 Versión Java Edition
El mod es solo cliente. Los jugadores que se conecten sin el mod instalado podrán jugar normalmente — simplemente no verán las UIs personalizadas ni el HUD de misiones.

Instalación del plugin

Descarga el plugin
Descarga el archivo eventui-core-1.0.0.jar desde la página de releases en GitHub o desde CurseForge/Modrinth.
eventui-core-1.0.0.jar
Copia el JAR a la carpeta plugins/
Mueve el archivo a la carpeta plugins/ de tu servidor. No es necesario descomprimir nada.
Estructura esperada
tu-servidor/
└── plugins/
    └── eventui-core-1.0.0.jar
Inicia el servidor
Arranca el servidor normalmente. EventUI se cargará y generará su carpeta de configuración automáticamente. En la consola deberías ver:
Consola del servidor
[EventUI] EventUI Plugin initialization...
[EventUI] ✓ EventUI enabled — 0 events, 0 UIs loaded
Si ves 0 events es normal en la primera ejecución. El plugin genera un archivo de ejemplo en events/ que puedes usar como referencia.
Verifica la estructura generada
Tras el primer inicio, la carpeta plugins/EventUI/ habrá sido creada con todos los archivos necesarios:
Carpetas generadas
plugins/
└── EventUI/
    ├── config.yml        ← configuración principal
    ├── events/           ← aquí van tus archivos de eventos (.yml)
    │   └── example-event.yml
    ├── uis/              ← aquí van tus archivos de UI (.yml)
    ├── playerdata/       ← progreso de jugadores (no editar manualmente)
    └── playerstate/      ← variables de estado UI (no editar manualmente)

Instalación del mod cliente

Instala Fabric si aún no lo tienes
Descarga el instalador de Fabric desde fabricmc.net y selecciona la versión 1.21.1. Esto crea un perfil nuevo en el launcher de Minecraft.
fabricmc.net → Descargar instalador
Instala Fabric API
Descarga Fabric API compatible con 1.21.1 desde Modrinth o CurseForge y colócalo en tu carpeta mods/. Es el único requisito del mod.
modrinth.com → "Fabric API" → 1.21.1
Descarga e instala el mod EventUI
Descarga eventui-fabric-1.0.0.jar y colócalo también en la carpeta mods/ de tu instancia de Fabric.
Estructura esperada en mods/
.minecraft/mods/           (o la carpeta de tu instancia)
├── fabric-api-x.x.x.jar
└── eventui-fabric-1.0.0.jar
Inicia el juego y entra al servidor
Abre Minecraft con el perfil de Fabric 1.21.1 y entra a tu servidor. El mod se conecta automáticamente — no requiere configuración adicional en el cliente.
Para verificar que el mod cargó correctamente, abre el chat y busca en los logs de Fabric: [EventUI-Client] EventUI client initialized!

Teclas del mod

El mod registra dos atajos de teclado en la categoría EventUI, configurables desde Opciones → Controles en Minecraft:

Tecla por defecto Acción Descripción
K Abrir pantalla de eventos Abre la UI de EventUI configurada en el servidor (hardcoded o custom)
H Mostrar/ocultar HUD Activa o desactiva el tracker de misiones en pantalla
F3 + Shift Debug overlay Muestra información de depuración sobre los elementos UI renderizados (solo en pantallas custom)

Verificación de la instalación

Con ambos componentes instalados, entra al servidor y ejecuta estos comandos para confirmar que todo funciona:

Verificación desde el servidor (consola o op) 
# Listar eventos cargados
/eventui list

# Ver información del plugin
/eventui reload

# Abrir la UI manualmente a un jugador
/eventui open <jugador>
Verificación desde el cliente (jugador) 
# Presiona K para abrir la pantalla de EventUI
# Presiona H para ver el HUD de misiones activas
La tecla K no responde: asegúrate de que el mod esté correctamente instalado en el cliente y de que estés conectado a un servidor con el plugin activo. El mod solo funciona online — no en singleplayer.

Problemas comunes

Síntoma Causa probable Solución
El plugin no aparece en /plugins Java desactualizado o JAR corrupto Verifica que usas Java 21+. Vuelve a descargar el JAR
Error NoSuchMethodError al iniciar Servidor Spigot en lugar de Paper Migra a Paper 1.21.1 o Arclight
La tecla K no abre nada Mod no instalado o Fabric API faltante Verifica que ambos JARs están en mods/
La UI abre pero está en blanco screenId apunta a un archivo que no existe Verifica que el archivo en uis/ tiene el mismo id que el screenId en config.yml
El progreso no se guarda al reconectar El servidor se apagó antes de guardar El progreso se guarda al desconectar cada jugador. Usa /eventui reload antes de apagar si es urgente
Anterior ← Primeros pasos