Modkit

A suite of Gradle plugins for building multi-loader Minecraft mods from a single model. Describe your mod once — identity, target versions, dependencies, metadata — and Modkit drives the per-loader tooling (Fabric via Loom, NeoForge via ModDevGradle) to produce a build for each.

Status: beta. The plugins are ready for early adopters; expect some churn before 1.0.0. Found a bug or have feedback? Open an issue.

Documentation: https://mc.oliveryasuna.com/modkit/

Note

AI disclosure: This software was, for the most part, hand-written (not generated by AI). However, the majority of documentation, including this README, Javadocs, code comments, etc., was generated by AI. Some assets (e.g., icons) were generated by AI (because I am not an artist). Additionally, AI was used to help identify, diagnose, and fix bugs.

Plugins

Plugin	ID	Version	Summary
core	com.oliveryasuna.modkit.core		Foundation shared by every other plugin: the modkit { } model (mod identity, group, version, loader) that the rest build on.
loaders	com.oliveryasuna.modkit.loaders		Unifies Fabric Loom and ModDevGradle behind the Modkit model, applying and configuring the right loader per build.
metadata	com.oliveryasuna.modkit.metadata		Generates fabric.mod.json and neoforge.mods.toml from the Modkit model and packages them.
dependencies	com.oliveryasuna.modkit.dependencies		Unifies mod-dependency declaration, jar-in-jar nesting, and mod repositories across both loaders.
run	com.oliveryasuna.modkit.run		Unifies Fabric Loom and ModDevGradle run configurations behind a single Modkit DSL.
datagen	com.oliveryasuna.modkit.datagen		Wires Minecraft data generation across both loaders and routes generated output into resources.
mixins	com.oliveryasuna.modkit.mixins		Registers mixin configs, provides the refmap convention, and publishes config names to the shared manifest registry.
testing	com.oliveryasuna.modkit.testing		Sets up the JUnit Platform for pure-logic tests and wires the Fabric and NeoForge GameTest runs.
multiversion	com.oliveryasuna.modkit.multiversion		Per-version overrides over Stonecutter's source preprocessor, driven by the Modkit model.
multiversion (settings)	com.oliveryasuna.modkit.multiversion.settings		Settings-plugin variant: declares the version × loader matrix in settings.gradle.kts and builds the Stonecutter tree.
scaffold	com.oliveryasuna.modkit.scaffold		Generates a working Modkit consumer project (settings, build script, example sources) for a chosen loader/version matrix.
ci	com.oliveryasuna.modkit.ci		Generates GitHub Actions workflows from the Modkit version × loader matrix.
publish	com.oliveryasuna.modkit.publish		Publishes built artifacts to Modrinth, CurseForge, GitHub, and Discord from the Modkit model.

License

Copyright © 2026 Oliver Yasuna. All rights reserved.