(Formerly known as Trainguy's Animation Overhaul)
Locomotion is a Minecraft: Java mod centered around giving the game's entities and blocks complex gameplay-driven animations through a real-time animation system inspired by Unreal Engine's Animation Blueprints.
Warning! This project is still in heavy development! You are free to compile yourself and try it out, but keep in mind that there will be missing animations, placeholders, and debugging visuals that will not look correct in a normal gameplay context.
- 🟩 Complete
- 🟨 High Priority
- 🟥 Low Priority
- ❌ Currently out-of-scope
| Feature | Status | Notes |
|---|---|---|
| Pose Function System | 🟩 | Implementation of state machines, blend spaces, and montage tracks. |
| PyQT Maya Exporter | 🟩 | Tool for exporting animations out of Maya with new format with scale support. |
| First Person Player Animations | 🟨 | The first proper stress-test of the system. |
| In-game configuration | 🟩 | Settings for tweaking individual aspects of different joint animators. |
| Block / Block Entity Animations | 🟥 | Would like to re-add support for block animations, similar to the earlier implementation with Pollen, after first person animations are far enough along. |
| Third Person Player Animations | 🟥 | Whether or not this will be included with the release version or not is TBD. |
| Back-porting | 🟥 | Depends on the demand, given that this mod is intended to be used on vanilla-ish versions of the game and usually people playing vanilla don't often play older versions. |
| Synchronised Sound | ❌ | I don't know how the sound system works currently, or what it would take to make sounds trigger with animations without breaking other sound mods, but it's something I'm keeping in mind. |
| Open API for Modding | 🟥 | I would like to lock down the design of the animation systems further before considering making this an open API |
| Entity Animations | ❌ | Too high-scope to do on my own at this juncture, requires a large amount of animations/character rigs. Functionality will support it if I were to find somebody to help out on this. |
| Data-Driven Joint Animators | ❌ | Design would need to be locked down enough prior to considering this. |
- Discord server: https://discord.gg/KxqCSGhaFZ
- My Twitter: https://twitter.com/Trainguy9512
- Discord contact: @trainguy9512
- Moonflower Website: https://moonflower.gg/
- Moonflower Twitter: https://www.moonflower.gg/twitter
- Moonflower Discord: https://www.moonflower.gg/discord
- Development, Rigging, Animation
- Animators
- Scott Smoker - Trident animations
- Micah Preciado - Sword attack animations
- Austan Todd - Axe attack animation
- Contributors
- Marvin Schürz - Timeline and easing system
- The Panda Oliver - Multi-loader template
- TomB-134
- AlphaKR93
- LizIsTired
- CaioMGT
- Superpowers04
- Special thanks to members of the Moonflower team for supporting my development on this and helping answer my questions!
- Pull requests for the API, bugs, and localization are welcome, but currently I'm not accepting outward contributions for animations themselves while I'm still working on the core of the mod. I would love to make this mod a use-able API for other mod developers, so any input from others on the API design is very valuable to me!
- Do not redistribute or publish compiled versions, forks, or ports of the mod publicly to places such as Curseforge or Modrinth without explicit written permission from me.
- Inclusion of the mod in publicly distributed mod packs is only allowed with written permission from me as it for now requires including the play testing JAR with the mod pack.
- You can read the license here
- The project is under an All Rights Reserved license for the time being until I begin publishing builds on Modrinth and CurseForge.
- How can I download the mod?
Currently, the mod is not available on Modrinth or Curseforge as I'm still working towards making the project feature complete for first person animations. However, if you'd like to try playing with a pre-release playtest version, you can find the latest verions here
- What versions of the game will this mod support?
For right now, the mod is being worked on in the latest release version of Minecraft: Java Edition. Minecraft: Bedrock Edition will not be supported.
Currently backports to versions such as 1.20 and 1.21.1 are not planned due to the wide changes to the game's rendering system throughout the 1.21.x drops. I'm going to look into ways I can make it happen without restructuring the mod, but I can't make any guarantees.
- What mod loaders will this mod be compatible with?
Right now both Fabric and NeoForge are supported.
- What will the mod require as a dependency?
For the fabric version, just Fabric API. Mod Loader and YACL are optional dependencies for both Fabric and NeoForge for the configuration interface.
- What is this mod compatible with?
Currently there is no list of what will or will not work, but generally most cosmetic vanilla-friendly mods like Essential, 3D Skin Layers, and other cosmetic mods should work perfectly fine, along with other performance mods such as Sodium or shader mods such as Iris.
Additionally, right now there are no plans to implement compatibility with heavier content mods which would have their own player interaction animations (depends on the implementation).
Resource packs that change animations like Fresh Animations should be compatible, but animations added for the same kind of thing by both this mod and a resource pack will not work together.
If you have any additional questions, please let me know by sending me a message through my discord server.
