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.

Download Now View Documentation
🧱

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

✅ Stable Releases
1.21.4 1.21.5 1.21.6 1.21.7 1.21.8
⚠️ Snapshots & Pre-releases
25w31a

All features are fully supported across all versions: Custom blocks, items, recipes, paintings, structures, and equipment work in every supported version. Snapshot support may have bugs, and we cannot promise we will fix them.

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

Development Blog

Stay updated with the latest developments, features, and behind-the-scenes insights from the mDirt team.

July 14th Development Update: Generators!

July 14, 2025

Welcome to our first development blog post! We're excited to share what we've been working on lately and give you a glimpse into the future of mDirt.

Generators System

This week, we've been developing our new "Generators" system! Once complete, these tools will allow you to create different Minecraft things.

The first is the Text Component Generator, which will let you create custom signs, books, /tellraw commands, and more, all with rich formatting, colors, and click events!

Another Generator in the works is a Custom Potion Generator - but we can't reveal too much about that yet!

Localization

We're currently laying the groundwork for proper localization support! While we're starting with English only (since that's what our team speaks), we welcome anyone fluent in another language to help translate!

And More...

There is even more going on behind the scenes that we aren't quite ready to announce! Stay tuned - we hope to push out an update within a couple of months!

July 16th Development Update: v3.1.0 Beta 1 is here!

July 16, 2025

mDirt v3.1.0 Beta 1 has been released!

Tools System

We've renamed the Generators System to the Tools System.

There are two tools right now, with more on the way!

What's Next?

In the coming betas we will be releasing more tools and localizing the entire app! We might have another trick up our sleeve... Guess you'll just have to wait and find out!

July 29th Development Update: Snapshot Support!

July 29, 2025

mDirt now supports Minecraft Snapshots!!

Snapshots

With some changes on the backend, Snapshots are now supported! mDirt will not support every snapshot, only the ones we have time to make versions for.

What's Next?

Progress has been slow recently, but we hope to return in the next week with a new Beta, introducing localization and a few more tools! See you then!

Frequently Asked Questions

What versions of Minecraft does mDirt support? +

To see the list of supported versions, head on over to the Docs page.

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, with more to come!

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.