AnnoyingLib

AnnoyingLib is the core library for the Annoying Villagers mod ecosystem, providing custom rigged models, advanced animations, animation-driven hitboxes, and shared combat utilities.

It also introduces a collection of reusable weapons designed for mobs, NPCs, and players across the ecosystem.

Features

• 300+ paid Blockbench animations integrated into the shared rig system.
• Reusable rigged models built around ModelRig, supporting animated characters and their equipment.
• Animation driven hitboxes that follow attacks and combat poses.
• Weapon categories and combat styles that determine which attack animations and combat behaviors a weapon uses.
• Customizable sword trails for visual feedback during attacks.
• Shared combat goals and controllers for melee attacks, ranged combat, guarding, recovery, and more.
• Shared utilities and APIs for other mods in the ecosystem.

For Mod Developers

AnnoyingLib provides a foundation for creating your own rigged entities and weapons:

1. Add AnnoyingLib as a required dependency.
2. Extend AVNpc to reuse its shared NPC behavior and rig combat support.
3. Extend RigMobRenderer, which uses ModelRig, to render your entity with your own skin.
4. Implement RigCombatProfileProvider on your weapons to assign their combat styles and supported dual-wield groups.
5. Add sword-trail definitions under assets/<your_mod_id>/sword_trails/.

Register your entities, attributes, items, and renderers in your own mod. AnnoyingLib supplies the shared rig and combat systems.