Grimoire API - Universal Mixin Loader Framework

Before you lies a multi-purpose Mixin loading system designed for developing and applying mixins in Minecraft versions 1.7.10 and 1.12.2. This project is an independent continuation of Legacy Grimoire and offers a simpler and more reliable alternative to SpongeMixins for version 1.7.10.

For Regular Users

If you're a regular player who ended up here because one of your mods requires Grimoire as a dependency - simply download the latest Grimoire version for your Minecraft version, place the file in the mods folder, and you're all set!

For Developers

If you're a developer looking to utilize Grimoire's powerful mixin capabilities in your projects, get ready to discover an impressive set of features:

• Built-in Sponge Mixin library, eliminating the need to include the full Mixin implementation in your mod (which is bad practice)
• Version-independent core - most of Grimoire API works equally well on both 1.7.10 and 1.12.2
• Grimmix system for declaring framework presence, handling important events, and communication between different implementations
• Simple API for creating mixin configurations at runtime, instead of needing to include them as .json files
• Automatic separation of configurations into two categories: for Minecraft/Forge and for other mods, with loading at the correct time
• Version-independent EventBus implementation without unnecessary ASM elements, more convenient for extension
• Integrated Omniconfig API for creating configuration files via IOmniconfigBuilder or @AnnotationConfig
• Integration with EventHelper for safe use of EventUtils without singleplayer compatibility issues
• Full development environment support

Workspace Setup

Examples of workspace setup for Grimoire-dependent mods:

• For 1.7.10: https://github.com/Aizistral-Studios/ForgeWorkspaceSetup/tree/1.7.10-grimmix
• For 1.12.2: https://github.com/Aizistral-Studios/ForgeWorkspaceSetup/tree/1.12.2-grimmix

More detailed information can be found in our repositories and on the Wiki. Particularly worth noting: Grimoire fully supports the development environment! Launching the client via the runClient task or IDE launch configuration will ensure proper loading of Grimoire and all dependent grimmixes. Refmap generation also works flawlessly, so there's no need to target obfuscated production names and sacrifice development environment compatibility.