Installation

Requirements

Server	Paper 26.2 or 26.3
Java	25
PacketEvents	required, 2.14.0 or newer
FancyHolograms	optional, only for holograms over NPCs
PlaceholderAPI	optional, for %placeholders% in interactions
A MineSkin key	optional but recommended, free

Steps

1. Put PacketEvents and AnimatedBB in your plugins folder, plus the optional ones you want.
2. Start the server once. It creates plugins/AnimatedBB/.
3. Open plugins/AnimatedBB/config.yml and put your license key:

   license-key: "YOUR-KEY"

   One key per server. It binds to the first machine it runs on; if you move servers, ask us in Discord to reset it (the console prints the machine's id).
4. Get a free MineSkin key at account.mineskin.org/keys and put it in the same file:

   mineskin:
     api-key: "your-mineskin-key"

   Without it models still work, they just upload their textures slowly the first time (see Models).
5. Restart the server.

Folders

plugins/AnimatedBB/
├── config.yml        settings and your license key
├── messages.yml      every message, editable
├── npcs.yml          your NPCs
├── skincache.yml     uploaded textures, so nothing is uploaded twice
└── models/           your .bbmodel files go here

Updating

Replace the jar and restart. Your NPCs, models and settings are kept.