| title | Animus |
|---|---|
| description | JSON-defined NPCs with behaviors, navigation, combat, shops, GUIs, and a web editor |
| published | true |
| date | 2026-11-09 00:00:00 UTC |
| tags | animus, npc, bukkit, paper, spigot, folia, fabric, neoforge, forge |
| editor | markdown |
| dateCreated | 2026-11-05 00:00:00 UTC |
{.align-center}
Animus manages NPCs. Each NPC is a JSON definition file that you can edit by hand, from commands, or in the web editor. NPCs are packet-only and shown separately to each viewer. An NPC is either spawned, and shown to players, or dormant: saved but not shown. Behaviors, routes, combat, shops, chest GUIs, and builds are all set in JSON.
| Minecraft | 26.1.2, 26.2, and 26.3 |
| Server software | Paper, Spigot, Folia; Fabric, NeoForge, and Forge as an experimental server-side mod |
| Java | 25 or newer |
| Main command | /animus |
| Config file | plugins/Animus/config.toml |
| Editor | animus-editor.web.app |
- Overview How Animus NPCs work, and a glossary
- Installation and compatibility Requirements, files, and platform differences
- Commands and permissions Every command and node
- Configuration Every config.toml setting
- Migrating from Citizens Import NPCs and add-on data {.links-list}
- Introduction Install, set up, and make your first NPC in ten minutes
- First NPC Install, then make, edit, skin and dress NPCs in game
- Movement Routes, recordings, mounts and riding
- Conversations, shops and combat Behaviors, shops, GUIs, health and pairing
- Web editor Pair, edit, apply and undo in the browser {.links-list}
- NPC definitions Files, spawning, appearance, and limits
- Trait groups Values shared by many NPCs
- Movement, mounts, and riding Routes, mounts, riders, and hiring
- NPC schedules Places an NPC goes at set times of day
- Performance recordings Record a player, replay it on an NPC
- Rigs and animations Bone rigs, clips, and resource packs
- Behaviors Triggers, capabilities, and packs
- Combat Targets, weapons, guards, and protection
- Building Schematics built block by block {.links-list}
- In-game toolkit Edit NPCs in game with /animus tools
- Web editor Pairing and editing in the browser
- Shops Buy, sell, and trade pages
- Quests Givers, stages, rewards, and the journal
- GUIs, holograms, and menus Gloss-format windows and text {.links-list}
- Quest plugins Quests, BeautyQuests and BetonQuest
- Model Engine Model Engine models on NPCs
- LibsDisguises NPCs that wear a disguise
- MythicMobs NPCs made from Mythic mobs, and their skills {.links-list}
- Storage and recovery Checkpoints, journals, and rollback
- Folia Region-owned NPCs and the stationary preview
- Mod servers Fabric, NeoForge, and Forge, experimental
- Debug and React metrics Network and server-time measurements {.links-list}
- Java modules and API Modules, hooks, and converters {.links-list}