Soporte

Solución de problemas

El plugin no carga

1. Verifica que usas Paper o Spigot 1.21.1.
2. Revisa logs/latest.log: busca errores de ClassNotFoundException o NoClassDefFoundError.
3. En Spigot, asegúrate de que también tienes PacketEvents 2.11.1.

El modelo no se ve en los clientes

1. Comprueba que el mod cliente está instalado en todos los jugadores.
2. Verifica que GeckoLib 4.8.2 para Fabric 1.21.1 está en la carpeta mods/.
3. Confirma que el fichero .geo.json existe en la ruta indicada en el YAML del modelo.
4. Revisa el log del cliente en .minecraft/logs/latest.log.

Animaciones en T-pose / sin animación

1. Verifica que los nombres de hueso en la animación coinciden exactamente (case-sensitive) con los del .geo.json.
2. Asegúrate de que animation_controllers contiene el controlador adecuado (simple_pose, idle, etc.).
3. Ejecuta /animorph reload después de cada cambio en los YAML.

La cámara en primera persona está desplazada

Ajusta head_offset en properties.first_person. Las unidades son píxeles GeckoLib (1 px = 1/16 bloque). Incrementa el valor Y para elevar la cámara.

FAQ

¿Funciona sin el mod cliente?

No. El mod cliente es imprescindible para renderizar los modelos. Los jugadores que no lo tengan verán el skin vanilla del jugador morfado, sin errores ni crashes.

¿Es compatible con Sodium?

Sí, Sodium es compatible. Si experimentas problemas visuales con alguna versión concreta, reporta el bug con la versión exacta de Sodium.

¿Qué formato de modelo acepta?

Solo el formato GeckoLib Geometry exportado desde Blockbench. No uses "Java Block/Item" ni "Bedrock Entity".

¿Puedo tener varios modelos a la vez en un jugador?

Un jugador tiene un modelo base activo. Puedes superponer múltiples capas (is_layer: true) o texturas de capa (layers:) sobre el modelo base.

¿Cómo sincronizo con Blockbench en tiempo real?

1. Activa el WebSocket en la config de Animorph.
2. Usa el comando /animorph socket connect <jugador> para conectar el cliente.
3. Conéctate desde Blockbench a la dirección de tu servidor.