Ayuda & FAQ

No. EventUI requiere Paper 1.21.1 o Arclight 1.21.1. El plugin usa la API de Adventure de Paper para enviar mensajes — en Spigot esto lanza un NoSuchMethodError en runtime porque Spigot no expone esa API.

Si tu servidor usa Spigot, migra a Paper — es un reemplazo directo compatible con todos los plugins de Spigot.

Actualmente solo Minecraft 1.21.1, tanto en el servidor (Paper/Arclight) como en el cliente (Fabric). No hay planes de backport a versiones anteriores por el momento.

No es obligatorio. Los jugadores sin el mod pueden conectarse y jugar normalmente. Simplemente no verán las UIs personalizadas ni el HUD de misiones — el progreso de sus eventos sigue funcionando en el servidor igual.

Causas más comunes:

Java desactualizado — verifica que usas Java 21 o superior con java -version.

JAR corrupto — descarga el JAR de nuevo desde Modrinth o GitHub Releases.

Servidor Spigot — EventUI solo funciona en Paper o Arclight.

Revisa la consola del servidor al arrancar — si el plugin falla al cargar, el error aparece ahí con el motivo exacto.

Esto ocurre cuando el screenId en config.yml no coincide con el campo id dentro del archivo de UI. Verifica que:

config.yml:
  ui:
    mode: "custom"
    custom:
      screenId: "main-menu"   # ← debe coincidir exactamente

uis/main-menu.yml:
  id: "main-menu"             # ← con este campo

Si fallback: true está activado, el plugin usa la UI hardcoded cuando falla — por eso no ves un error sino una pantalla por defecto.

El cliente no encuentra la textura en su resource pack. EventUI no valida la existencia de texturas desde el servidor — si el archivo no está en el resource pack del cliente, el elemento se renderiza rojo.

Verifica que la ruta en el YAML coincide exactamente con la ruta dentro del resource pack, incluyendo el namespace. Por ejemplo:

texture: "eventui:textures/ui/fondo.png"
# El resource pack debe tener:
# assets/eventui/textures/ui/fondo.png

Causas más comunes en el YAML de eventos:

Tabs en lugar de espacios — YAML no acepta tabs. Usa siempre espacios (2 o 4 por nivel).

target_amount entre comillas — debe ser un número sin comillas: target_amount: 10, no target_amount: "10".

Tipo de objetivo en minúsculas — debe ir en mayúsculas: type: KILL_ENTITY, no type: kill_entity.

El error exacto aparece en la consola del servidor con el nombre del archivo que falló. Pega el contenido del archivo en yamllint.com para detectar errores de sintaxis.

Usa el comando /ev reload para recargar todos los eventos y UIs en caliente sin reiniciar el servidor. Los cambios se aplican inmediatamente y los clientes conectados son notificados.

Verifica dos cosas:

Dobles llaves — el binding usa {{variable}} con llaves dobles, no simples. Una sola llave no se resuelve.

La variable existe — si usas {{state.mi_variable}}, asegúrate de haberla establecido con /ev setuivar <jugador> mi_variable <valor>.

Cuando una variable no se encuentra, el cliente imprime un warning en sus logs: Variable not found in context: nombre.

visible_if compara strings — todos los valores de las variables de estado son strings. Asegúrate de que el valor en la condición coincide exactamente:

# Si estableciste la variable así:
/ev setuivar Steve activo true

# La condición debe ser:
visible_if: "activo == true"   # ✅ correcto
visible_if: "activo == True"   # ❌ incorrecto (mayúscula)

Verifica en orden:

El evento está activo — usa /ev progress <id> para ver el estado. Si dice AVAILABLE en lugar de IN_PROGRESS, el evento no ha iniciado. Actívalo con /ev start <id> o verifica que always_active: true esté configurado.

El parámetro del objetivo es correcto — por ejemplo, para MINE_BLOCK el parámetro es block_id, no block_type. Consulta la referencia de objetivos para el parámetro exacto de cada tipo.

El tipo de objetivo está implementado — BREW_POTION y COLLECT_ITEM tienen limitaciones conocidas. Consulta la página de objetivos para ver el estado de cada tipo.

Verifica el bloque rewards en el archivo del evento. Los ítems usan el formato "minecraft:id cantidad" — si el ID del material no existe en Minecraft vanilla el ítem se descarta silenciosamente.

Para recompensas de ítems de mods, usa el tipo command en lugar de item:

rewards:
  commands:
    - "give {player} modid:mi_item 1"

El progreso se guarda de forma asíncrona cuando el jugador se desconecta. Si el servidor se apaga abruptamente (crash) antes de que el guardado termine, puede haber pérdida de datos.

Para minimizar este riesgo, usa siempre /stop para apagar el servidor en lugar de matar el proceso directamente. No hay base de datos en esta versión — todo se guarda en archivos YAML en playerdata/.

# Resetear un evento específico
/ev reset <id-del-evento>

# Resetear todos los eventos del jugador
/ev reset all

Estos comandos requieren el permiso eventui.admin.

Verifica en orden:

El mod está instalado — asegúrate de que eventui-fabric.jar está en tu carpeta mods/ junto a Fabric API.

Estás conectado a un servidor con el plugin — el mod no funciona en singleplayer ni en servidores sin EventUI Plugin.

Conflicto de teclas — ve a Opciones → Controles → EventUI y verifica que la tecla K no está asignada a otra acción.

El HUD puede estar oculto. Presioca la tecla H para alternarlo. Si sigue sin aparecer, verifica que el evento está en estado IN_PROGRESS con /ev progress <id> — el HUD solo muestra eventos activos.

Con la pantalla de EventUI abierta, presiona F3 + Shift. Esto activa el overlay de depuración que muestra las posiciones, dimensiones e IDs de todos los elementos renderizados. Muy útil para ajustar layouts con el sistema de anclas.