Minecraft Datapack & Resourcepack Utility [Java Edition]

A powerful CLI tool to upgrade and manage Minecraft Datapacks and Resourcepacks.

---

Table of Contents

• Introduction
• Features
• Quick Start
• Usage
• Contributors
• Contributing
• License

---

Introduction

Minecraft Datapack & Resourcepack Utility (MDRU) is designed to help developers seamlessly upgrade their commands and assets from older versions (like 1.20.4) to the latest Minecraft standards (1.21+). It features a robust SNBT parser and a modular transformation engine.

---

Features

• Version Upgrade: Support upgrading commands from 1.20.4 to 1.21.4+.
• Command Support:
  • /give, /item, /clear
  • /summon (Firework and Item)
  • /setblock, /fill
  • /execute (if block/data)
  • /data
  • All commands using selectors (@a[nbt=...])
• NBT to Component: Automatic conversion of legacy NBT tags to the new 1.21+ Component system.
• Minimized Output: Automatically removes comments and empty lines, standardizing line endings to LF.
• Translation Engine: Extract and apply translation keys for internationalization.

---

Quick Start

Prerequisites

• Node.js (Latest LTS recommended)

Installation

git clone https://github.com/Rayfor000/mdru.git
cd Datapack-Upgrader
npm install

---

Usage

Command Arguments

Usage: mdru [options]

Options:
  -i, --input <path>       Input file or folder
  -o, --output <path>      Output file or folder
  -v, --version <ver>      Transformation version (1.20/1.21.4)
  -y, --yes                Overwrite existing files
  -d, --debug              Enable debug mode
  -c, --command <command>  Transform a single command
  -h, --help               Show this help

Examples

Transform a single command

node index.js -c "give @s diamond_sword{Enchantments:[{id:\"sweeping\",lvl:1s}]}"

Batch upgrade a folder

node index.js -i "./my_datapack" -o "./upgraded_pack" -v 1.21.4 -y

---

Contributors

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Open a Pull Request

License

Primary Project License

The main source code and documentation in this repository are licensed under the MIT License.

Third-Party Components and Attributions

Component Name	Source / Author	License Type	Location of License Document	Hash Values
OG-Open-Source README.md Template	OG-Open-Source	MIT	/licenses/OG-Open-Source/LICENSE	120aee1912f4c2c51937f4ea3c449954
wifi-left/Datapack-Upgrader	Bamboo Gamom	GPL-3.0	/licenses/wifi-left/LICENSE	e62637ea8a114355b985fd86c9ffbd6e

---

© 2026 Ray. All rights reserved.