Skip to content

Faith-and-Code-Technologies/mDirt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

App Logo

🌐 Visit the mDirt Website

mDirt – A Minecraft Datapack Generator

making Datapacks is really tedious – mDirt makes it easy.

Creating custom Minecraft datapacks can be time-consuming and complex. mDirt simplifies this process by providing an easy-to-use tool for generating datapacks with custom features like blocks, items, recipes, structures, equipment, and more.


🛠️ Snapshots

  • Minecraft Snapshot Support
    • mDirt now has the ability to support snapshots! Not every snapshot will be getting support, but some will when we have time to make them!

💻 Getting Started

  1. Download the latest release

    • For Windows only: Pre-built executable (mDirt.exe)
    • No Python or extra dependencies required
    • Extract and run — no installation needed
  2. Use the GUI

    • Hover over inputs to see tooltips and guidance
    • Define your datapack elements: blocks, items, structures, equipment, etc.
  3. Generate Your Datapack

    • Click “Generate Pack” to build your datapack and resourcepack
    • Output is placed in the exports/ folder inside your mDirt directory
  4. Deploy in Minecraft

    • Move the generated datapack to .minecraft/saves/<your-world>/datapacks/
    • Move the resourcepack to .minecraft/resourcepacks/
    • Enable the resourcepack in-game
    • Use commands to access your custom content:
      • /function YOURNAMESPACE:give_blocks
      • /function YOURNAMESPACE:give_items
      • /function YOURNAMESPACE:give_paintings
      • /function YOURNAMESPACE:give_equipment

📚 Full Documentation

Check out the mDirt Wiki for setup instructions, tutorials, and detailed feature documentation.


🧩 Feature Support by Version

As of v3.0.0

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

💡 If a feature is not listed for a version, it is not supported for that version.


💡 Tips & Best Practices

  • Namespaces: Choose a unique namespace to avoid conflicts with other datapacks.
  • Testing: Always test in a separate world before using in a main save.
  • Backups: Backup your world before applying new datapacks — especially custom ones.

🙌 Credits


🌍 Get Involved

Found a bug? Have a feature request?
Open an issue or pull request on the GitHub Repository.


About

A tool for easily creating custom features using Minecraft Datapacks.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages