Docs / Introducción

¿Por qué Animorph?

Una mirada general al mod: qué problema resuelve, qué trae a tu servidor y en qué se diferencia de otras opciones.

¿Qué es Animorph?

Animorph es un mod que reemplaza el modelo del jugador en Minecraft por un personaje 3D completamente personalizado, con animaciones propias, emotes, equipamiento que se adapta al cuerpo y soporte completo de primera persona. Funciona en servidores multijugador y también en single player, sin que el jugador tenga que hacer nada más allá de tener el mod instalado.

En términos simples: en lugar de ver el skin cuadrado de siempre, tus jugadores pueden verse como personajes animados totalmente distintos, con movimientos fluidos y accesorios que forman parte del modelo.

Cliente Fabric Forge NeoForge
Servidor Paper / Spigot Fabric Forge NeoForge
¿Necesito saber programar?
No. Los modelos se crean en Blockbench (gratis), se exportan como archivos JSON y se colocan en una carpeta del servidor. El mod incluye un plugin de Blockbench que sincroniza el trabajo directamente.

¿Qué puedes hacer?

Estos son los pilares del mod, desde lo más visual hasta lo más técnico:

Modelos personalizados

Aplica cualquier modelo GeckoLib 3D a cualquier jugador. Múltiples modelos en el mismo servidor, cambiables en tiempo real sin reiniciar.

Animaciones por capas

Sistema de controladores independientes para cada parte: idle, pose, emotes, brazo derecho, brazo izquierdo. Cada capa funciona de forma separada y se puede combinar.

Emotes

Lanza animaciones especiales desde comandos. Configura si congelan al jugador, si paran al recibir daño o al morir, y si corren en paralelo con otras capas.

Primera persona

Los brazos del modelo aparecen en primera persona con sus propias animaciones. Soporta renderizado de ítems a través de las manos y visibilidad del cuerpo completo.

Equipamiento adaptado

Casco, pecho, pantalones, botas, capa y elytra pueden tener geometría propia que encaja perfectamente en el cuerpo del modelo, sin usar el vanilla.

Layers (capas extras)

Encima del modelo principal puedes agregar capas: accesorios, auras, máscaras, overlays de textura. Cada layer se activa o desactiva por jugador de forma independiente.

Cubos de texto dinámicos

Partes del modelo pueden mostrar texto en tiempo real: nombre del jugador, vida, rango u otro dato via PlaceholderAPI.

Hueso de cámara

El modelo puede definir un hueso especial que controla la posición de la cámara del jugador, permitiendo efectos de cámara ligados al propio personaje.

Hitbox personalizado

Cada modelo puede tener su propio hitbox. Si tu personaje es más alto, más bajo o tiene una forma especial, la colisión refleja eso.

Poly mesh y ragdoll

Soporte para mallas de polígonos con skinning avanzado, y un sistema de ragdoll para que el modelo reaccione físicamente a eventos del juego.

Plugin de Blockbench

Plugin oficial para Blockbench que sincroniza el modelo con el servidor en tiempo real mientras diseñas, incluyendo hitbox y configuración.

Reacciona a la voz

Si el jugador usa Simple Voice Chat o Plasmo Voice, el modelo puede mover la boca al hablar, diferenciar cuando grita o susurra, y hasta reaccionar según qué tan cerca está de quien habla. Es totalmente opcional: sin uno de esos mods instalado, no pasa nada raro, el modelo se comporta como siempre.

API para desarrolladores

Plugins Bukkit/Paper y mods Fabric, Forge o NeoForge pueden integrarse con Animorph: cambiar modelos, escuchar eventos, controlar layers, acceder a huesos y definir queries Molang personalizadas.

¿Cómo funciona?

Animorph se distribuye como un único JAR por loader (Fabric, Forge o NeoForge). El mismo archivo funciona en cliente, servidor y single player — no hay builds separados para cada lado.

Renderizado (cliente)

El mod recibe los datos del servidor y renderiza el modelo en pantalla. En single player, este lado y el lado servidor corren dentro del mismo proceso.

Lógica (servidor)

Aquí viven todos los modelos, texturas y animaciones. El servidor decide qué modelo tiene cada jugador y cuándo cambia. Puede ser un servidor dedicado o una partida single player.

La única excepción es Paper/Spigot: por ser una plataforma Bukkit, usa un JAR de plugin independiente en lugar del mod universal. En todo lo demás, un solo archivo cubre todos los casos.

¿Por qué Animorph?

Existen otros mods que permiten personalizar el modelo del jugador. La siguiente tabla muestra qué incluye Animorph frente a lo que ofrece la mayoría de las alternativas disponibles.

Característica Animorph Alternativas típicas
Completamente gratuito Algunos tienen versión de pago
Modelos GeckoLib animados Algunos
Múltiples modelos en el servidor Generalmente uno
Sistema de emotes Poco común
Layers / accesorios independientes Raro
Primera persona personalizada
Equipamiento con geometría propia
Hitbox por modelo
Hueso de cámara
Cubos de texto dinámicos
Poly mesh + ragdoll
API completa (servidor + cliente) Muy pocas
Soporte Paper / Spigot Mayoría solo Fabric
Fabric, Forge y NeoForge (cliente, servidor y single player) Generalmente uno solo
Single player La mayoría requiere servidor
Plugin de Blockbench oficial

¿Para quién es Animorph?

Administradores de servidor

Quieres diferenciar tu servidor con una identidad visual propia. Animorph te da control total: qué modelos existen, quién puede usarlos y cuándo cambian, todo sin depender de los jugadores para instalar nada complejo.

Creadores de contenido

Diseñas personajes en Blockbench y quieres verlos animados en el juego tal como los creaste, con sus emotes, accesorios y primera persona. Animorph es el puente directo entre Blockbench y Minecraft.

Desarrolladores de plugins

Tu plugin necesita cambiar el modelo de un jugador en ciertos eventos, o reaccionar cuando un jugador equipa un emote. La API de Animorph cubre ambos casos, tanto desde el servidor como desde el cliente.