Downloads

Get the latest version of Minecraft Datapack Language (MDL) and the VS Code extension.

Latest Release

🎯 Latest Version

Check GitHub for the most up-to-date version information

🐍 Python Package

Install via pip or pipx for command-line usage

📦 View on PyPI 📥 Download Source
pipx install minecraft-datapack-language

🔧 VS Code Extension

Syntax highlighting, error checking, and build commands for VS Code/Cursor

📥 Download VSIX 📋 View All Releases
Install from VSIX in VS Code/Cursor

How to Get the Latest Version

For Python Package

  1. Check PyPI: Visit PyPI project page for the latest version
  2. Install: Use pipx install minecraft-datapack-language to get the latest version
  3. Update: Use pipx upgrade minecraft-datapack-language to update to the latest version

For VS Code Extension

  1. Check Releases: Visit GitHub Releases
  2. Download: Look for the .vsix file in the latest release
  3. Install: Follow the installation instructions below

Installation Methods

Python Package

# Install pipx if you don't have it
python3 -m pip install --user pipx
python3 -m pipx ensurepath

# Install MDL
pipx install minecraft-datapack-language

# Verify installation
mdl --help

# Update to latest version
pipx upgrade minecraft-datapack-language

Option 2: pip (Virtual Environment)

# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate  # Windows: .\.venv\Scripts\Activate.ps1

# Install MDL
pip install minecraft-datapack-language

# Verify installation
mdl --help

# Update to latest version
pip install --upgrade minecraft-datapack-language

Option 3: From Source

# Clone the repository
git clone https://github.com/aaron777collins/MinecraftDatapackLanguage.git
cd MinecraftDatapackLanguage

# Install in development mode
python -m pip install -e .

# Update from source
git pull origin main

VS Code Extension

  1. Download: Go to GitHub Releases and download the .vsix file
  2. Install: In VS Code/Cursor, go to Extensions (Ctrl+Shift+X)
  3. Install from VSIX: Click the “…” menu and select “Install from VSIX…”
  4. Choose file: Select the downloaded .vsix file
  5. Restart: Restart VS Code/Cursor to activate the extension

Features

Command Line Tool

  • Build datapacks: mdl build --mdl file.mdl -o dist
  • Check code: mdl check file.mdl
  • Create projects: mdl new project_name
  • Multi-file support: Build entire directories
  • Pack format support: Modern and legacy formats

VS Code Extension

  • Syntax highlighting: MDL files with proper colors
  • Error detection: Real-time error checking and validation
  • Build commands: Quick compile with Ctrl+Shift+P
  • IntelliSense: Auto-completion and suggestions
  • Integrated terminal: Run MDL commands directly

System Requirements

  • Python: 3.8 or higher
  • Minecraft: 1.20+ (pack format 82) or 1.19+ (pack format 15)
  • Operating System: Windows, macOS, or Linux
  • VS Code: 1.60+ (for extension)

Version Information

To check the current version you have installed:

# Check Python package version
mdl --version

# Or check via pip
pip show minecraft-datapack-language

For the latest version information and release notes, visit:

Getting Started

After installation, create your first datapack:

# Create a new project
mdl new my_first_pack

# Build it
mdl build --mdl my_first_pack.mdl -o dist

# Install in Minecraft
# Copy dist/my_first_pack/ to your world's datapacks folder
# Run /reload in-game

Support

Contributing

Want to help improve MDL? Check out our Contributing Guide for:

  • Development setup
  • Code style guidelines
  • Testing procedures
  • Release process

License

MDL is open source software licensed under the MIT License. See the LICENSE file for details.