mDirt

Minecraft Datapack Generator

Making Datapacks is really tedious. mDirt simplifies this process by providing an easy-to-use tool for generating datapacks with custom features like blocks, items, recipes, and more.

🧱

Custom Blocks

Create custom blocks with unique textures and properties. Full compatibility across supported Minecraft versions.

⚔️

Custom Items

Design custom items with special behaviors. 80% feature coverage for enhanced gameplay.

🔧

Custom Recipes

Build crafting recipes for your custom items and blocks. Complete recipe support for all versions.

🎨

Custom Paintings

Add beautiful custom paintings to decorate your Minecraft world.

🏠

Custom Structures

Create brilliant custom structures across your world.

🛡️

Custom Equipment

Create new armor sets with custom textures and models. Horse armor is also supported.

Documentation

Full documentation is available on GitHub:

View Wiki

📋 Supported Versions & Features

Feature 1.21.4 1.21.5 1.21.6/1.21.7
Blocks ✅ 100% ✅ 100% ✅ 100%
Items ✅ 100% ✅ 100% ✅ 100%
Recipes ✅ 100% ✅ 100% ✅ 100%
Paintings ✅ 100% ✅ 100% ✅ 100%
Structures ✅ 100% ✅ 100% ✅ 100%
Equipment ✅ 100% ✅ 100% ✅ 100%

🔧 What's Next: Schema-Driven UI

We're working on KoreUI - a powerful solution that will load JSON Schemas and convert them into PySide6 widgets. This will enable:

  • More complex generators
  • Recursive datapack creation
  • Advanced customization options
  • Schema-driven UI generation

We're currently creating the necessary JSON Schemas - thousands of lines of JSON by hand. We appreciate your patience!

Downloads

Latest: v3.0.1

mDirt for Windows

Pre-packaged binary with no dependencies required


Download from GitHub Releases

Windows Only • No Python Installation Required • ~70MB Download

📦 Installation Instructions

  1. Head over to the Releases Page on GitHub
  2. Download the latest version of mDirt
  3. Extract the downloaded folder to your desired location
  4. Run the executable (mDirt.exe)
  5. Start generating your custom Minecraft datapacks!

🎮 Using Your Generated Datapacks

Installation:

  • Place the generated datapack into your world's datapacks folder
  • Place the generated resourcepack into the resourcepacks folder
  • Enable the resourcepack in Minecraft settings

Getting Your Custom Items:

Use these commands in Minecraft:

/function YOURNAMESPACE:give_blocks /function YOURNAMESPACE:give_items /function YOURNAMESPACE:give_paintings /function YOURNAMESPACE:give_equipment

Frequently Asked Questions

What versions of Minecraft does mDirt support? +

mDirt currently supports Minecraft versions 1.21.4, 1.21.5, and 1.21.6/1.21.7. Full compatibility for version 1.21.6/1.21.7 has been recently added, including support for all features like blocks, items, recipes, paintings, structures, and equipment.

Do I need Python installed to use mDirt? +

No! mDirt comes as a pre-packaged binary created using PyInstaller. You don't need Python or any other dependencies installed. Just download, extract, and run the executable.

Is mDirt available for Mac or Linux? +

Currently, mDirt is only available for Windows. We're focusing on perfecting the Windows version first, but cross-platform support may be considered in future releases.

What features can I create with mDirt? +

mDirt allows you to create custom blocks, items, recipes, paintings, structures, and equipment. We are currently working on a new major update to add more than a dozen new features..

How do I avoid namespace conflicts? +

Make sure the namespace you define in mDirt doesn't clash with any other datapack you're using. Use unique, descriptive names for your namespace to avoid conflicts.

Should I backup my world before using custom datapacks? +

Yes! Always back up your Minecraft world before applying new datapacks, especially when using custom features. It's also recommended to test datapacks in a separate world first.

Who created mDirt? +

mDirt was created by @TheJupiterDev and @JustJoshinDev, with special thanks to Admin for his custom block generation method. We welcome contributions and suggestions from the community!

How can I contribute or report bugs? +

We welcome contributions and bug reports! Please create an issue or open a pull request on our GitHub Repository. Your feedback helps make mDirt better for everyone.