Instalación

Animorph requiere dos componentes: un mod Fabric en el cliente y un servidor compatible (Paper/Spigot o Fabric).

Requisitos

Componente	Versión	Lado
Java	21 o superior	Cliente y servidor
Minecraft	1.21.1	—
Fabric Loader	0.16.9+	Cliente
Fabric API	0.116.7+1.21.1	Cliente
GeckoLib	4.8.2 (Fabric)	Cliente
Paper / Spigot	1.21.1	Servidor (opción 1)
Fabric Server	0.16.9+ con Fabric API	Servidor (opción 2)

Cliente (mod Fabric)

Instala Fabric Loader 0.16.9+ para Minecraft 1.21.1.
Descarga GeckoLib 4.8.2 para Fabric 1.21.1 y colócalo en mods/.
Descarga el JAR de Animorph (cliente) y colócalo en mods/.
Lanza Minecraft con el perfil Fabric y comprueba que los mods aparecen en la lista.

plaintext mods/ (estructura esperada)

mods/
├── animorph-client-1.0.4.jar
├── geckolib-fabric-1.21.1-4.8.2.jar
└── fabric-api-0.116.7+1.21.1.jar

Servidor (plugin Paper/Spigot)

Usa Paper 1.21.1 (recomendado) o Spigot 1.21.1.
Coloca el JAR de Animorph (servidor) en plugins/.
Reinicia el servidor. Se generará la carpeta plugins/Animorph/.

Spigot

En Spigot también necesitas instalar PacketEvents 2.11.1 para el seguimiento de entidades. En Paper no es necesario.

Dependencias opcionales (Paper/Spigot)

PlaceholderAPI 2.11.6 habilita placeholders dinámicos en los cubos de texto del modelo.
EmoteCraft permite convertir sus animaciones al formato de Animorph con /animorph emote-parser.

Servidor (mod Fabric)

Alternativamente, puedes usar Animorph como mod de servidor Fabric en lugar de un plugin Bukkit.

Instala Fabric Loader 0.16.9+ y Fabric API en el servidor.
Coloca el JAR de Animorph (server-mod) en mods/ del servidor.
Inicia el servidor. Se generará la carpeta config/animorph/.

Ruta de configuración

En el servidor Fabric, los archivos de configuración van en config/animorph/ en lugar de plugins/Animorph/. La estructura interna (models, animations, textures, controllers) es la misma.

Estructura de carpetas del servidor

Animorph genera la siguiente estructura al arrancar por primera vez. La ruta base es plugins/Animorph/ en Paper/Spigot o config/animorph/ en Fabric:

plaintext plugins/Animorph/

plugins/Animorph/
├── config.yml
├── models/
│   ├── mi_modelo.yml          ← configuración del modelo
│   └── mi_modelo.geo.json     ← geometría GeckoLib (mismo nombre)
├── animations/
│   ├── wave.yml               ← configuración del emote
│   └── wave.animation.json    ← animaciones GeckoLib
└── textures/
    └── mi_modelo.png          ← textura del modelo

Detección automática del .geo.json

El archivo .geo.json se detecta por nombre: si el modelo se llama mi_modelo.yml, Animorph buscará mi_modelo.geo.json en la misma carpeta.

config.yml

Archivo de configuración principal del plugin:

yaml plugins/Animorph/config.yml

# Modelo que se aplica automáticamente al unirse un jugador al servidor.
# Usa "empty" para no aplicar ninguno.
model-on-join: player

# Intervalo en ticks para actualizar los placeholders de PlaceholderAPI.
# 20 ticks = 1 segundo.
placeholder-check-interval: 20

Campo	Tipo	Descripción
`model-on-join`	string	ID del modelo que se aplica al conectar. Usa `empty` para desactivar.
`placeholder-check-interval`	int	Ticks entre actualizaciones de PlaceholderAPI. Por defecto `20`.