Effortlessly craft complex animations for Minecraft: Java Edition

---

Animated Java DF

About this fork (animated-java-df)

This repository is a fork of Animated Java with support for exporting projects to DiamondFire.

Install the plugin

1. Download animated_java.js from the latest release.
2. In Blockbench, go to File > Plugins and click Load Plugin from File next to the search bar.
3. Select the downloaded file.
4. Restart Blockbench.

Important

Use Blockbench 4.12.6 (Animated Java is not compatible with version >=5): Download 4.12.6.

Export to DiamondFire

1. Install CodeClient.
2. Enable CodeClient API
   • Run /ccconfig CodeClientAPI true.
     or
   • Open the config menu using /ccconfig or mod menu, under the General tab, enable CodeClient API.
3. Restart Minecraft.
4. In Blockbench, click Animated Java > DiamondFire > Export.

Important

You must be in dev mode on DiamondFire for export to work.

Use exported rigs in-game

1. Send both template sets from Blockbench.
   • Animated Java > DiamondFire > Export sends your project-specific init function as rig.init.<project_name>.
   • Animated Java > DiamondFire > Base Templates > ...
     • ... > Get Required Templates sends the core helpers (rig.spawn, rig.animate, etc.).
     • ... > Get Optional Templates sends useful helpers (rig.setVariant, offset helpers, etc.).
     • ... > Get All Templates sends both sets at once.
2. Initialize each model once (for example in your setup/load code).
   • Use rig.init.rig("<project_name>") for one model, or rig.init.rigs(<list>) for multiple.
3. Spawn a rig instance.
   • Use rig.spawn(<entities_return_var>, "<instance_id>", "<project_name>", <location>).
   • <instance_id> is the unique runtime instance key, while <project_name> is the exported model id from the previous steps.
4. Animate the spawned instance.
   • Use rig.animate("<instance_id>", "<project_name>", "<animation_name>", <tick>, <interp_optional>).
   • <tick> is the current frame.
   • <interp_optional> should always match the amount of ticks waiting between each frame. (set to 0 to disable interpolation)
   • Use rig.animate.noReset(...) when you want to keep the rig-entities selection active after animating.
   • Use rig.animate(...) when you want that selection reset automatically and restore your previous selection.
5. Removing the rig.
   • Use rig.remove("<instance_id>").

Note

rig.spawn automatically applies animation default at tick 0 after spawning.
If you need lower-level control, rig.load_animation(...) and rig.decodeMatrices(...) are available.

Credits

This fork is based on Millo5/animated-java-df, with the goal of being more up to date, user friendly and feature complete.

For questions or discussion: join the Discord server.

---

❔ What is Animated Java?

Animated Java is a cutting-edge Blockbench plugin designed for Minecraft: Java Edition mapmakers and Data Pack developers. By leveraging Blockbench's familiar interface, and the power of Java Edition's Data Pack and Resource Pack systems, Animated Java allows you to create complex animations with ease!

✨ Key Features

• Function API - Simple, yet powerful, API for summoning, and controlling animated models.

• Variants - Swap between different textures in-game.

• Text Displays - Preview, edit, and animate text displays in Blockbench.

• Keyframe Easing Curves - Create smooth animations with ease.

• Locators - Execute commands using Function Keyframes, teleport entities in an animation, and more.

• Animation Tweening - Smoothly transition between animations.

• Camera Support - Install the Official Camera Plugin to create cinematic camera paths with ease.

• Well Optimized - Hours of effort have been poured into making Animated Java's Data Pack as low-impact as possible.

• Resource Packs are Optional - Animate Vanilla block and item models using Item and Block Display entities.

• Molang Support - If Blockbench can render your Molang expressions in the preview, you can use it in Animated Java.

📦 Installation

• ❔ Getting Started
• 📚 Documentation
• 🌐 Website
• 🗣️ Discord

💬 Testimonials

I love AJ 3000! — MrMakistein

Wonderful tool, thank you for contributing to the creative possibilities in this game! — Leroidesafk

Super thankful for AJ Snave! Its allowed me to create some insane sh** — phiac

Thank you for the lovely tool! — LeCarbonator

🧑‍💻 Contributing

Contributions are always welcome! Check out CONTRIBUTING.md for more information.

⭐ Star History