Emotecraft Compat (Neoforge)

What Does This Mod Fix?

Emotecraft Compat resolves animation and rendering conflicts between Emotecraft and Entity Model Features (EMF), including player animation resource packs such as Fresh Animations Player and Fresh Moves.

Starting with version 0.2.0, it also fixes server emote definition synchronization in Emotecraft 2.4.12.

Features

Client Rendering Compatibility

• Prevents EMF animation conflicts while Emotecraft emotes are playing.
• Restores normal EMF animation behavior when emotes finish.
• Fixes bending-related rendering issues and crashes.
• Improves bending compatibility with 3D Skin Layers.

Server Emote Synchronization

• Fixes server-provided emote definitions failing to synchronize correctly to clients.
• Safely transfers large emote definitions using multiple packets when necessary.
• The synchronization fix applies only to Emotecraft 2.4.12. Later versions are left untouched to avoid overriding future upstream fixes.

All compatibility features work automatically without configuration.

Compatibility with other EMF-based resource packs is expected but has not been fully tested.

Installation

Client and server installations are independent:

• Install on the client to enable EMF, Player Animator, BendyLib, and 3D Skin Layers rendering compatibility.
• Install on the server to enable the Emotecraft 2.4.12 server emote synchronization fix.

Install the mod on whichever side requires the corresponding functionality.

Tested Versions

• Minecraft 1.21.1
• NeoForge 21.1.249
• Emotecraft 2.4.12
• Entity Model Features (EMF) 3.3.5
• Player Animator 2.0.4+1.21.1
• BendyLib 5.1
• 3D Skin Layers 1.11.2

These versions have been tested successfully. Other versions may also work but have not been verified.

Emotecraft is required on clients using the rendering integrations. EMF, Player Animator, BendyLib, and 3D Skin Layers are optional, and each integration activates only when its required mods are installed.

Development Notes

This project was developed with the assistance of AI tools, including code generation, Gradle project setup, and test case creation.

The implementation was guided, reviewed, adjusted, and manually tested by the author to address real compatibility issues.

AI-assisted code may still have limitations, so bug reports and feedback are welcome.