New: Held Item Models & Animations API

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.