Instalación

Animorph se distribuye como un único JAR por loader. El mismo archivo funciona como mod de cliente, mod de servidor y en single player — no hay JARs separados para cada lado. La única excepción es el plugin para Paper/Spigot, que es un JAR independiente.

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)
Forge	52.1.0	Cliente o Servidor (opción 3)
NeoForge	21.1.197	Cliente o Servidor (opción 4)

Fabric (cliente, servidor y single player)

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 Animorph (Fabric) y colócalo en mods/.
El mismo JAR funciona en cliente, servidor Fabric y single player.

plaintext mods/ (estructura esperada)

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

Single player

En single player el mod actúa como cliente y servidor al mismo tiempo. Los modelos van en .minecraft/config/animorph/.

Forge (cliente, servidor y single player)

Instala Forge 52.1.0 para Minecraft 1.21.1.
Descarga GeckoLib 4.8.2 para Forge 1.21.1 y colócalo en mods/.
Descarga Animorph (Forge) y colócalo en mods/.
El mismo JAR funciona en cliente, servidor Forge y single player.

NeoForge (cliente, servidor y single player)

Instala NeoForge 21.1.197 para Minecraft 1.21.1.
Descarga GeckoLib 4.8.2 para NeoForge 1.21.1 y colócalo en mods/.
Descarga Animorph (NeoForge) y colócalo en mods/.
El mismo JAR funciona en cliente, servidor NeoForge y single player.

Servidor (plugin Paper/Spigot)

Si tu servidor corre Paper o Spigot, usas el JAR de plugin (el único caso donde es un archivo separado del mod de cliente).

Usa Paper 1.21.1 (recomendado) o Spigot 1.21.1.
Coloca el JAR de Animorph (Paper/Spigot) 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)

Si tu servidor corre Fabric, usas el mismo JAR que en el cliente — no necesitas un archivo separado.

Instala Fabric Loader 0.16.9+ y Fabric API en el servidor.
Coloca el JAR de Animorph (Fabric) 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.

Servidor (mod Forge)

Puedes usar Animorph como mod de servidor Forge.

Instala Forge 52.1.0 para Minecraft 1.21.1.
Coloca el JAR de Animorph (forge) en mods/ del servidor.
Inicia el servidor. Se generará la carpeta config/animorph/.

Ruta de configuración

En servidor Forge, los archivos van en config/animorph/. La estructura interna es la misma que en Paper/Spigot.

Servidor (mod NeoForge)

También puedes usar Animorph como mod de servidor NeoForge.

Instala NeoForge 21.1.197 para Minecraft 1.21.1.
Coloca el JAR de Animorph (neoforge) en mods/ del servidor.
Inicia el servidor. Se generará la carpeta config/animorph/.

Ruta de configuración

En servidor NeoForge, los archivos van en config/animorph/. La estructura interna es la misma que en Paper/Spigot.

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 por defecto del servidor para un jugador que se conecta sin ningún modelo activo. Solo se usa si el jugador no tiene ya un modelo propio y tampoco tiene un default personal marcado con `/animorph model-default` (ver Comandos) — el default personal siempre tiene prioridad. Usa `empty` para desactivar.
`placeholder-check-interval`	int	Ticks entre actualizaciones de PlaceholderAPI. Por defecto `20`.