Item Model Animations API 🔗

A comprehensive modpack for Luanti that provides a complete solution for creating animated 3D item models with sophisticated behavior profiles. This modpack combines two powerful mods to give you full control over how items appear and behave in your game. It also comes prepackaged with preset examples and models to demonstrate.

What This Does 🔗

Item Model Animations API enables you to:

• Replace 2D item sprites with animated 3D models - Transform flat inventory icons into dynamic, living models when held
• Apply behavior templates to items - Use reusable profiles to modify item properties across single items or entire groups
• Create interactive animations - Build charge attacks, mining motions, idle breathing, and custom actions triggered by player input
• Hide default item rendering - Automatically suppress the default held item display when using custom models

This modpack is perfect for creating:

• Custom weapons with attack animations
• Tools with realistic usage motions
• Magic items with charge-up effects
• Dual-wielded items
• Any item that needs more personality than a static 2D sprite

Included Mods 🔗

Charged Models 🔗

The animation engine that handles:

• 3D model attachment and rendering
• Keyframe-based animation system
• Input-driven triggers (dig, place, jump, etc.)
• Multi-model support for complex items
• Particle effects and callbacks
• Automatic 3D cube display for items without custom models

Item Profiles 🔗

The behavior management system that provides:

• Reusable item modification templates
• Bulk operations across multiple items
• Filter functions for selective application
• Built-in "invisible" profile that hides default held items
• Original state preservation when profiles are removed

Documentation 🔗

For detailed API documentation, examples, and advanced usage:

• Charged Models: See charged_models/README.md for the complete animation API
• Item Profiles: See item_profiles/README.md for profile management documentation

Both mods include working examples in their respective folders.

Dependencies 🔗

None - this modpack is standalone and ready to use.

Compatibility 🔗

Works with any Luanti game

License 🔗

• Source Code: MIT License
• Media Assets: CC0

Credits 🔗

Created by TomCon for the Luanti community!

Notes 🔗

Thank you for playing with my mod. The Item Animation Model API took months of development time to get into a working state for release. If you would like to help support my open source development efforts to make Luanti games better for everyone, please leave a comment/review here on CDB or on the luanti fourms, make an issue or contribute to the git, and check out my donation links.