Instalación

Requisitos

Servidor	Paper 26.2 o 26.3
Java	25
PacketEvents	obligatorio, 2.14.0 o más nuevo
FancyHolograms	opcional, solo para los hologramas sobre NPCs
PlaceholderAPI	opcional, para los %placeholders% en interacciones
Una clave de MineSkin	opcional pero recomendada, gratis

Pasos

1. Pon PacketEvents y AnimatedBB en tu carpeta plugins, y los opcionales que quieras.
2. Inicia el servidor una vez. Se crea plugins/AnimatedBB/.
3. Abre plugins/AnimatedBB/config.yml y pon tu clave de licencia:

   license-key: "TU-CLAVE"

   Una clave por servidor. Se vincula a la primera máquina en la que funciona; si cambias de servidor, pídenos en Discord que la reiniciemos (la consola muestra el id de la máquina).
4. Consigue una clave de MineSkin gratis en account.mineskin.org/keys y ponla en el mismo archivo:

   mineskin:
     api-key: "tu-clave-de-mineskin"

   Sin ella los modelos funcionan igual, solo que suben sus texturas despacio la primera vez (mira Modelos).
5. Reinicia el servidor.

Carpetas

plugins/AnimatedBB/
├── config.yml        ajustes y tu clave de licencia
├── messages.yml      todos los mensajes, editables
├── npcs.yml          tus NPCs
├── skincache.yml     texturas subidas, para no subir nada dos veces
└── models/           aquí van tus archivos .bbmodel

Actualizar

Cambia el jar y reinicia. Tus NPCs, modelos y ajustes se conservan.