minecraft-datapack-language 15.4.27__tar.gz → 15.4.29__tar.gz

minecraft_datapack_language-15.4.29/.cursor/rules/aispec.mdc

@@ -0,0 +1,9 @@
+---
+description: AI SPEC SHEET
+globs:
+alwaysApply: true
+---
+
+- Use the MDL_AI_SPEC_SHEET (living spec doc) to remember the important context. Update it if it is out of date. Do NOT forget to follow the development cycle.
+- Test locally via python, not necessarily using mdl.
+- Use ./scripts/UpdateMDL.sh to update mdl after making changes

{minecraft_datapack_language-15.4.27 → minecraft_datapack_language-15.4.29}/.github/workflows/ci.yml

@@ -45,29 +45,29 @@ jobs:
       - name: Test MDL Parser Import
         run: |
           echo "Testing MDL parser import..."
-          python -c "from minecraft_datapack_language.mdl_parser_js import parse_mdl_js; print('[+] MDL parser imported successfully')"
+          python -c "from minecraft_datapack_language.mdl_parser import MDLParser; print('[+] MDL parser imported successfully')"
 
       - name: Test MDL Lexer Import
         run: |
           echo "Testing MDL lexer import..."
-          python -c "from minecraft_datapack_language.mdl_lexer_js import MDLLexer; print('[+] MDL lexer imported successfully')"
+          python -c "from minecraft_datapack_language.mdl_lexer import MDLLexer; print('[+] MDL lexer imported successfully')"
 
-      - name: Test MDL Linter Import
+      - name: Test AST Nodes Import
         run: |
-          echo "Testing MDL linter import..."
-          python -c "from minecraft_datapack_language.mdl_linter import MDLLinter; print('[+] MDL linter imported successfully')"
+          echo "Testing AST nodes import..."
+          python -c "from minecraft_datapack_language.ast_nodes import Program, PackDeclaration; print('[+] AST nodes imported successfully')"
 
-      - name: Test Expression Processor Import
+      - name: Test Error Classes Import
         run: |
-          echo "Testing expression processor import..."
-          python -c "from minecraft_datapack_language.expression_processor import ExpressionProcessor; print('[+] Expression processor imported successfully')"
+          echo "Testing error classes import..."
+          python -c "from minecraft_datapack_language.mdl_errors import MDLLexerError, MDLParserError; print('[+] Error classes imported successfully')"
 
       - name: Test Python API
         run: |
           echo "Testing Python API functionality..."
           python - <<'PY'
           from minecraft_datapack_language import Pack
-          p = Pack('test', 'Test pack', 82)
+          p = Pack('test', 'Test pack', 15)
           ns = p.namespace('test')
           ns.function('test_func', 'say Hello World')
           print('[+] Python API test passed')
@@ -76,15 +76,16 @@ jobs:
       - name: Test MDL Parsing
         run: |
           echo "Testing MDL parsing..."
-          python -c "from minecraft_datapack_language.mdl_parser_js import parse_mdl_js; print('[+] MDL parser imported successfully')"
+          python -c "from minecraft_datapack_language.mdl_parser import MDLParser; print('[+] MDL parser imported successfully')"
 
       - name: Test Variable System
         run: |
           echo "Testing variable system..."
           python - <<'PY'
-          from minecraft_datapack_language.mdl_parser_js import parse_mdl_js
-          test_code = 'var num test_var = 0;'
-          ast = parse_mdl_js(test_code)
+          from minecraft_datapack_language.mdl_parser import MDLParser
+          parser = MDLParser()
+          test_code = 'var num test_var<@s> = 0;'
+          ast = parser.parse(test_code)
           print('[+] Variable system test passed')
           PY
 
@@ -92,9 +93,10 @@ jobs:
         run: |
           echo "Testing control flow..."
           python - <<'PY'
-          from minecraft_datapack_language.mdl_parser_js import parse_mdl_js
-          test_code = 'if "$test$ > 0" { say "test"; }'
-          ast = parse_mdl_js(test_code)
+          from minecraft_datapack_language.mdl_parser import MDLParser
+          parser = MDLParser()
+          test_code = 'if $test<@s>$ > 0 { say "test"; }'
+          ast = parser.parse(test_code)
           print('[+] Control flow test passed')
           PY
 
@@ -102,9 +104,10 @@ jobs:
         run: |
           echo "Testing while loops..."
           python - <<'PY'
-          from minecraft_datapack_language.mdl_parser_js import parse_mdl_js
-          test_code = 'while "$counter$ < 10" { counter = $counter$ + 1; }'
-          ast = parse_mdl_js(test_code)
+          from minecraft_datapack_language.mdl_parser import MDLParser
+          parser = MDLParser()
+          test_code = 'while $counter<@s>$ < 10 { counter<@s> = $counter<@s>$ + 1; }'
+          ast = parser.parse(test_code)
           print('[+] While loops test passed')
           PY
 
@@ -112,9 +115,10 @@ jobs:
         run: |
           echo "Testing error handling..."
           python - <<'PY'
-          from minecraft_datapack_language.mdl_parser_js import parse_mdl_js
+          from minecraft_datapack_language.mdl_parser import MDLParser
+          parser = MDLParser()
           try:
-              parse_mdl_js('invalid syntax {')
+              parser.parse('invalid syntax {')
               print('[-] Should have failed')
           except:
               print('[+] Error handling test passed')
@@ -129,38 +133,34 @@ jobs:
         run: |
           echo "Testing basic MDL file parsing..."
           python - <<'PY'
-          from minecraft_datapack_language.mdl_parser_js import parse_mdl_js
+          from minecraft_datapack_language.mdl_parser import MDLParser
+          parser = MDLParser()
           test_code = '''
-          pack "test" "Test pack" 82;
+          pack "test" "Test pack" 15;
           namespace "test";
-          var num counter = 0;
-          function "main" {
-              counter = 0;
-              while "$counter$ < 5" {
-                  counter = $counter$ + 1;
-                  say "Counter: $counter$";
+          var num counter<@s> = 0;
+          function test:main<@s> {
+              counter<@s> = 0;
+              while $counter<@s>$ < 5 {
+                  counter<@s> = $counter<@s>$ + 1;
+                  say "Counter: $counter<@s>$";
               }
           }
-          on_tick "test:main";
+          on_tick test:main;
           '''
-          ast = parse_mdl_js(test_code)
+          ast = parser.parse(test_code)
           print('[+] Basic MDL file test passed')
           PY
 
-      - name: Run Basic Test Suite
+      - name: Run Comprehensive End-to-End Tests
         run: |
-          echo "Running basic test suite..."
-          python -m pytest tests/test_basic.py -v --tb=short
+          echo "Running comprehensive end-to-end tests..."
+          python test_comprehensive_end_to_end.py
           
-      - name: Run I/O Test Suite
+      - name: Run Complex Scenario Tests
         run: |
-          echo "Running I/O test suite..."
-          python -m pytest tests/test_io.py -v --tb=short
-
-      - name: Run Comprehensive Test Suite
-        run: |
-          echo "Running comprehensive test suite..."
-          python -m pytest tests/test_comprehensive_features.py -v --tb=short
+          echo "Running complex scenario tests..."
+          python test_complex_scenarios.py
 
       - name: Upload dist artifacts
         uses: actions/upload-artifact@v4
@@ -191,9 +191,14 @@ jobs:
       - name: Run All Comprehensive Tests
         run: |
           echo "Running comprehensive feature tests..."
-          python -m pytest tests/test_comprehensive_features.py -v --tb=short
+          python test_comprehensive_end_to_end.py
+          
+      - name: Run Complex Scenario Tests
+        run: |
+          echo "Running complex scenario tests..."
+          python test_complex_scenarios.py
           
       - name: Run All Test Suites
         run: |
           echo "Running all test suites..."
-          python -m pytest tests/ -v --tb=short
+          python test_comprehensive_end_to_end.py && python test_complex_scenarios.py

minecraft_datapack_language-15.4.29/PKG-INFO

@@ -0,0 +1,266 @@
+Metadata-Version: 2.4
+Name: minecraft-datapack-language
+Version: 15.4.29
+Summary: Compile MDL language with explicit scoping into a Minecraft datapack (1.21+ ready). Features variables, control flow, error handling, and VS Code extension.
+Project-URL: Homepage, https://www.mcmdl.com
+Project-URL: Documentation, https://www.mcmdl.com/docs
+Project-URL: Repository, https://github.com/aaron777collins/MinecraftDatapackLanguage
+Project-URL: Bug Tracker, https://github.com/aaron777collins/MinecraftDatapackLanguage/issues
+Project-URL: VS Code Extension, https://marketplace.visualstudio.com/items?itemName=mdl.minecraft-datapack-language
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mecha>=0.99.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Dynamic: license-file
+
+# <img src="https://github.com/aaron777collins/MinecraftDatapackLanguage/raw/main/icons/icon-128.png" width="32" height="32" alt="MDL Icon"> Minecraft Datapack Language (MDL)
+
+A **modern, scope-aware language** that lets you write Minecraft datapacks with **explicit scoping, variables, control structures, and expressions** that actually work.
+
+📖 **[View Full Documentation](https://www.mcmdl.com/)** - Complete guides, examples, and API reference  
+📦 **[View on PyPI](https://pypi.org/project/minecraft-datapack-language/)** - Download and install from PyPI  
+🔧 **[VS Code Extension](https://marketplace.visualstudio.com/items?itemName=mdl.minecraft-datapack-language)** - Syntax highlighting, IntelliSense, and snippets
+
+![CI](https://github.com/aaron777collins/MinecraftDatapackLanguage/workflows/CI/badge.svg)
+![Test Examples](https://github.com/aaron777collins/MinecraftDatapackLanguage/workflows/Test%20Examples/badge.svg)
+![Documentation](https://github.com/aaron777collins/MinecraftDatapackLanguage/workflows/Build%20and%20Deploy%20Documentation/badge.svg)
+![PyPI](https://img.shields.io/pypi/v/minecraft-datapack-language?style=flat-square)
+![Release](https://github.com/aaron777collins/MinecraftDatapackLanguage/workflows/Release/badge.svg)
+
+## 🎯 **MODERN** MDL Language with Explicit Scoping
+
+**MDL uses a modern, scope-aware language format** with **explicit scoping, control structures, variables, and expressions**:
+
+### ✨ **MODERN** Features
+- **🎯 Explicit scoping** with angle brackets `<@s>`, `<@a[team=red]>` for all operations
+- **📝 Modern comments** using `//` and `/* */`
+- **🔢 Number variables** with `var num` type (stored in scoreboards)
+- **🔄 Full control structures** including `if/else`, `while` loops
+- **💲 Variable substitution** with `$variable<scope>$` syntax
+- **🧮 Expressions** with arithmetic operations (`+`, `-`, `*`, `/`)
+- **📦 Namespace system** for modular code organization
+- **🏷️ Tag system** for all datapack resources (recipes, loot tables, advancements, etc.)
+- **🎨 VS Code extension** with full IntelliSense and snippets
+- **🧪 Comprehensive testing** with E2E validation
+- **📚 Extensive documentation** with examples for every feature
+
+### 🏗️ Core Features
+- ✅ **Modern pack format 15** by default for latest Minecraft features
+- ✅ **Explicit scoping** - every variable operation specifies its scope
+- ✅ **Real control structures** - `if/else`, `while` loops
+- ✅ **Number variables** stored in scoreboards with `$variable<scope>$` substitution
+- ✅ **Expressions** with arithmetic operations and variable substitution
+- ✅ **Multi-file projects** with automatic merging and dependency resolution
+- ✅ **Variable optimization** - automatic load function generation for initialization
+- ✅ **Selector optimization** - proper `@a` usage for system commands
+- ✅ **Easy hooks** into `minecraft:tick` and `minecraft:load` via function tags
+- ✅ **Tag support** for `recipe`, `loot_table`, `advancement`, `item_modifier`, `predicate`, and `structure`
+- ✅ **Raw blocks** for direct Minecraft command injection
+- ✅ **Say commands** that auto-convert to `tellraw` with JSON formatting
+
+> **Note**: Version 1.0+ uses **pack_format 15** by default for the modern MDL syntax.
+
+---
+
+## 🚀 Install
+
+### Option A — from PyPI (recommended for users)
+Global, isolated CLI via **pipx**:
+```bash
+python3 -m pip install --user pipx
+python3 -m pipx ensurepath    # reopen terminal
+pipx install minecraft-datapack-language
+
+mdl --help
+```
+
+Virtualenv (if you prefer):
+```bash
+python3 -m venv .venv
+source .venv/bin/activate      # Windows: .\.venv\Scripts\Activate.ps1
+pip install minecraft-datapack-language
+```
+
+### Option B — from source (for contributors)
+```bash
+# inside the repo
+python -m pip install -e .
+```
+
+---
+
+## 🔄 Update
+
+- **pipx**: `pipx upgrade minecraft-datapack-language`  
+- **pip (venv)**: `pip install -U minecraft-datapack-language`  
+- Pin a version: `pipx install "minecraft-datapack-language==<version>"` (replace `<version>` with desired version)
+
+---
+
+## 💻 CLI
+
+### Modern MDL (v1.0+)
+```bash
+# Build MDL files
+mdl build --mdl my_pack/mypack.mdl -o dist --wrapper mypack
+mdl check my_pack/mypack.mdl
+
+# Validate generated mcfunction files
+mdl check my_pack/mypack.mdl
+
+# Multi-file projects
+mdl build --mdl my_pack/ -o dist      # Build entire directory
+mdl build --mdl "file1.mdl file2.mdl" -o dist  # Build specific files
+
+# Create new projects
+mdl new my_awesome_pack
+```
+
+### Quick Start
+```bash
+# Create a new project
+mdl new my_first_pack
+
+# Build it
+cd my_first_pack
+mdl build --mdl main.mdl -o dist
+
+# Check for errors
+mdl check main.mdl
+```
+
+---
+
+## 📝 Language Examples
+
+### Basic Structure
+```mdl
+pack "MyPack" "My awesome datapack" 15;
+namespace "game";
+
+var num player_score<@s> = 0;
+var num team_score<@a[team=red]> = 0;
+
+function game:start<@s> {
+    player_score<@s> = 100;
+    say "Welcome! Your score is $player_score<@s>$";
+}
+
+on_load game:start<@s>;
+```
+
+### Control Structures
+```mdl
+function game:check_score<@s> {
+    if $player_score<@s>$ > 10 {
+        say "Great score!";
+        player_score<@s> = $player_score<@s>$ + 5;
+    } else {
+        say "Keep trying!";
+    }
+    
+    while $player_score<@s>$ < 100 {
+        player_score<@s> = $player_score<@s>$ + 1;
+    }
+}
+```
+
+### Tags and Resources
+```mdl
+// Recipe tags
+tag recipe "diamond_sword" "recipes/diamond_sword.json";
+tag loot_table "epic_loot" "loot_tables/epic_loot.json";
+tag advancement "first_spell" "advancements/first_spell.json";
+
+// Item modifiers and predicates
+tag item_modifier "enchanted_tool" "item_modifiers/enchanted_tool.json";
+tag predicate "has_mana" "predicates/has_mana.json";
+tag structure "wizard_tower" "structures/wizard_tower.json";
+```
+
+### Raw Blocks and Say Commands
+```mdl
+function game:special_effect<@s> {
+    $!raw
+    execute as @s run particle minecraft:explosion ~ ~ ~ 1 1 1 0 10
+    execute as @s run playsound minecraft:entity.player.levelup player @s ~ ~ ~ 1 1
+    raw!$
+    
+    say "Special effect triggered! Score: $player_score<@s>$";
+}
+```
+
+---
+
+## 🔧 Development
+
+### Building from Source
+```bash
+git clone https://github.com/aaron777collins/MinecraftDatapackLanguage.git
+cd MinecraftDatapackLanguage
+python -m pip install -e .
+```
+
+### Running Tests
+```bash
+# Run all tests
+python -m pytest
+
+# Run specific test file
+python -m pytest test_comprehensive_end_to_end.py
+
+# Run with coverage
+python -m pytest --cov=minecraft_datapack_language
+```
+
+### Building the Extension
+```bash
+cd vscode-extension
+npm install
+npm run compile
+```
+
+---
+
+## 📚 Documentation
+
+- **[Language Reference](docs/_docs/language-reference.md)** - Complete language specification
+- **[VS Code Extension](vscode-extension/README.md)** - Extension documentation
+- **[Examples](examples/)** - Sample projects and code snippets
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+### Development Setup
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests for new functionality
+5. Submit a pull request
+
+---
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+## 🙏 Acknowledgments
+
+- Minecraft community for inspiration
+- Contributors and testers
+- VS Code team for the excellent extension API
+
+---
+
+**Happy coding with MDL! 🎮**

minecraft_datapack_language-15.4.29/README.md

@@ -0,0 +1,245 @@
+# <img src="https://github.com/aaron777collins/MinecraftDatapackLanguage/raw/main/icons/icon-128.png" width="32" height="32" alt="MDL Icon"> Minecraft Datapack Language (MDL)
+
+A **modern, scope-aware language** that lets you write Minecraft datapacks with **explicit scoping, variables, control structures, and expressions** that actually work.
+
+📖 **[View Full Documentation](https://www.mcmdl.com/)** - Complete guides, examples, and API reference  
+📦 **[View on PyPI](https://pypi.org/project/minecraft-datapack-language/)** - Download and install from PyPI  
+🔧 **[VS Code Extension](https://marketplace.visualstudio.com/items?itemName=mdl.minecraft-datapack-language)** - Syntax highlighting, IntelliSense, and snippets
+
+![CI](https://github.com/aaron777collins/MinecraftDatapackLanguage/workflows/CI/badge.svg)
+![Test Examples](https://github.com/aaron777collins/MinecraftDatapackLanguage/workflows/Test%20Examples/badge.svg)
+![Documentation](https://github.com/aaron777collins/MinecraftDatapackLanguage/workflows/Build%20and%20Deploy%20Documentation/badge.svg)
+![PyPI](https://img.shields.io/pypi/v/minecraft-datapack-language?style=flat-square)
+![Release](https://github.com/aaron777collins/MinecraftDatapackLanguage/workflows/Release/badge.svg)
+
+## 🎯 **MODERN** MDL Language with Explicit Scoping
+
+**MDL uses a modern, scope-aware language format** with **explicit scoping, control structures, variables, and expressions**:
+
+### ✨ **MODERN** Features
+- **🎯 Explicit scoping** with angle brackets `<@s>`, `<@a[team=red]>` for all operations
+- **📝 Modern comments** using `//` and `/* */`
+- **🔢 Number variables** with `var num` type (stored in scoreboards)
+- **🔄 Full control structures** including `if/else`, `while` loops
+- **💲 Variable substitution** with `$variable<scope>$` syntax
+- **🧮 Expressions** with arithmetic operations (`+`, `-`, `*`, `/`)
+- **📦 Namespace system** for modular code organization
+- **🏷️ Tag system** for all datapack resources (recipes, loot tables, advancements, etc.)
+- **🎨 VS Code extension** with full IntelliSense and snippets
+- **🧪 Comprehensive testing** with E2E validation
+- **📚 Extensive documentation** with examples for every feature
+
+### 🏗️ Core Features
+- ✅ **Modern pack format 15** by default for latest Minecraft features
+- ✅ **Explicit scoping** - every variable operation specifies its scope
+- ✅ **Real control structures** - `if/else`, `while` loops
+- ✅ **Number variables** stored in scoreboards with `$variable<scope>$` substitution
+- ✅ **Expressions** with arithmetic operations and variable substitution
+- ✅ **Multi-file projects** with automatic merging and dependency resolution
+- ✅ **Variable optimization** - automatic load function generation for initialization
+- ✅ **Selector optimization** - proper `@a` usage for system commands
+- ✅ **Easy hooks** into `minecraft:tick` and `minecraft:load` via function tags
+- ✅ **Tag support** for `recipe`, `loot_table`, `advancement`, `item_modifier`, `predicate`, and `structure`
+- ✅ **Raw blocks** for direct Minecraft command injection
+- ✅ **Say commands** that auto-convert to `tellraw` with JSON formatting
+
+> **Note**: Version 1.0+ uses **pack_format 15** by default for the modern MDL syntax.
+
+---
+
+## 🚀 Install
+
+### Option A — from PyPI (recommended for users)
+Global, isolated CLI via **pipx**:
+```bash
+python3 -m pip install --user pipx
+python3 -m pipx ensurepath    # reopen terminal
+pipx install minecraft-datapack-language
+
+mdl --help
+```
+
+Virtualenv (if you prefer):
+```bash
+python3 -m venv .venv
+source .venv/bin/activate      # Windows: .\.venv\Scripts\Activate.ps1
+pip install minecraft-datapack-language
+```
+
+### Option B — from source (for contributors)
+```bash
+# inside the repo
+python -m pip install -e .
+```
+
+---
+
+## 🔄 Update
+
+- **pipx**: `pipx upgrade minecraft-datapack-language`  
+- **pip (venv)**: `pip install -U minecraft-datapack-language`  
+- Pin a version: `pipx install "minecraft-datapack-language==<version>"` (replace `<version>` with desired version)
+
+---
+
+## 💻 CLI
+
+### Modern MDL (v1.0+)
+```bash
+# Build MDL files
+mdl build --mdl my_pack/mypack.mdl -o dist --wrapper mypack
+mdl check my_pack/mypack.mdl
+
+# Validate generated mcfunction files
+mdl check my_pack/mypack.mdl
+
+# Multi-file projects
+mdl build --mdl my_pack/ -o dist      # Build entire directory
+mdl build --mdl "file1.mdl file2.mdl" -o dist  # Build specific files
+
+# Create new projects
+mdl new my_awesome_pack
+```
+
+### Quick Start
+```bash
+# Create a new project
+mdl new my_first_pack
+
+# Build it
+cd my_first_pack
+mdl build --mdl main.mdl -o dist
+
+# Check for errors
+mdl check main.mdl
+```
+
+---
+
+## 📝 Language Examples
+
+### Basic Structure
+```mdl
+pack "MyPack" "My awesome datapack" 15;
+namespace "game";
+
+var num player_score<@s> = 0;
+var num team_score<@a[team=red]> = 0;
+
+function game:start<@s> {
+    player_score<@s> = 100;
+    say "Welcome! Your score is $player_score<@s>$";
+}
+
+on_load game:start<@s>;
+```
+
+### Control Structures
+```mdl
+function game:check_score<@s> {
+    if $player_score<@s>$ > 10 {
+        say "Great score!";
+        player_score<@s> = $player_score<@s>$ + 5;
+    } else {
+        say "Keep trying!";
+    }
+    
+    while $player_score<@s>$ < 100 {
+        player_score<@s> = $player_score<@s>$ + 1;
+    }
+}
+```
+
+### Tags and Resources
+```mdl
+// Recipe tags
+tag recipe "diamond_sword" "recipes/diamond_sword.json";
+tag loot_table "epic_loot" "loot_tables/epic_loot.json";
+tag advancement "first_spell" "advancements/first_spell.json";
+
+// Item modifiers and predicates
+tag item_modifier "enchanted_tool" "item_modifiers/enchanted_tool.json";
+tag predicate "has_mana" "predicates/has_mana.json";
+tag structure "wizard_tower" "structures/wizard_tower.json";
+```
+
+### Raw Blocks and Say Commands
+```mdl
+function game:special_effect<@s> {
+    $!raw
+    execute as @s run particle minecraft:explosion ~ ~ ~ 1 1 1 0 10
+    execute as @s run playsound minecraft:entity.player.levelup player @s ~ ~ ~ 1 1
+    raw!$
+    
+    say "Special effect triggered! Score: $player_score<@s>$";
+}
+```
+
+---
+
+## 🔧 Development
+
+### Building from Source
+```bash
+git clone https://github.com/aaron777collins/MinecraftDatapackLanguage.git
+cd MinecraftDatapackLanguage
+python -m pip install -e .
+```
+
+### Running Tests
+```bash
+# Run all tests
+python -m pytest
+
+# Run specific test file
+python -m pytest test_comprehensive_end_to_end.py
+
+# Run with coverage
+python -m pytest --cov=minecraft_datapack_language
+```
+
+### Building the Extension
+```bash
+cd vscode-extension
+npm install
+npm run compile
+```
+
+---
+
+## 📚 Documentation
+
+- **[Language Reference](docs/_docs/language-reference.md)** - Complete language specification
+- **[VS Code Extension](vscode-extension/README.md)** - Extension documentation
+- **[Examples](examples/)** - Sample projects and code snippets
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+### Development Setup
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests for new functionality
+5. Submit a pull request
+
+---
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+## 🙏 Acknowledgments
+
+- Minecraft community for inspiration
+- Contributors and testers
+- VS Code team for the excellent extension API
+
+---
+
+**Happy coding with MDL! 🎮**