minecraft-datapack-language 15.4.9__tar.gz → 15.4.10__tar.gz

{minecraft_datapack_language-15.4.9/minecraft_datapack_language.egg-info → minecraft_datapack_language-15.4.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minecraft-datapack-language
-Version: 15.4.9
+Version: 15.4.10
 Summary: Compile JavaScript-style MDL language or Python API 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

minecraft_datapack_language-15.4.10/docs/_data/version.yml

@@ -0,0 +1,3 @@
+current: "15.4.9"
+tag: "v15.4.9"
+updated_at: "2025-09-02T03:13:13Z"

{minecraft_datapack_language-15.4.9 → minecraft_datapack_language-15.4.10}/minecraft_datapack_language/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '15.4.9'
-__version_tuple__ = version_tuple = (15, 4, 9)
+__version__ = version = '15.4.10'
+__version_tuple__ = version_tuple = (15, 4, 10)
 
-__commit_id__ = commit_id = 'g01b2b393b'
+__commit_id__ = commit_id = 'ge4660907f'

{minecraft_datapack_language-15.4.9 → minecraft_datapack_language-15.4.10}/minecraft_datapack_language/cli_help.py

@@ -291,7 +291,164 @@ For more information, visit: https://www.mcmdl.com/docs/cli-reference#check
 
 def show_new_help():
     """Display detailed help for the new command."""
-    print("""
+    try:
+        from .cli_colors import color, print_header, print_title, print_section, print_separator, print_info, print_bullet, print_code
+        
+        # Header
+        print()
+        print_header("MDL New Command - Create New MDL Projects")
+        print_separator("=", 65)
+        print()
+        
+        # Description
+        print(color.info("The new command creates a new MDL project with template files and proper"))
+        print(color.info("structure to get you started quickly."))
+        print()
+        
+        # Usage
+        print_section("Usage")
+        print()
+        print(f"  {color.code('mdl new <project_name> [options]')}")
+        print()
+        
+        # Arguments
+        print_section("Arguments")
+        print()
+        print(f"  {color.highlight('<project_name>')}        Name for your new MDL project")
+        print(f"                        This will be used for the project directory and pack name")
+        print(f"                        Example: {color.code('my_awesome_pack')}, {color.code('hello_world')}, {color.code('magic_system')}")
+        print()
+        
+        # Options
+        print_section("Options")
+        print()
+        print(f"  {color.command('--pack-name')} {color.highlight('<name>')}    Custom name for the datapack (defaults to project name)")
+        print(f"                        This appears in the pack.mcmeta description")
+        print(f"                        Example: {color.code('--pack-name "My Awesome Magic Pack"')}")
+        print()
+        print(f"  {color.command('--pack-format')} {color.highlight('<num>')}   Pack format number for Minecraft version compatibility")
+        print(f"                        Default: {color.highlight('82')} (Minecraft 1.20+)")
+        print(f"                        Example: {color.code('--pack-format 15')} (for older versions)")
+        print()
+        
+        # Examples
+        print_section("Examples")
+        print()
+        print(f"1. Create a basic project:")
+        print(f"   {color.code('mdl new hello_world')}")
+        print()
+        print(f"2. Create project with custom pack name:")
+        print(f"   {color.code('mdl new magic_system --pack-name "Epic Magic Pack"')}")
+        print()
+        print(f"3. Create project for older Minecraft version:")
+        print(f"   {color.code('mdl new retro_pack --pack-format 15')}")
+        print()
+        print(f"4. Create project with all custom options:")
+        print(f"   {color.code('mdl new my_project --pack-name "My Project" --pack-format 82')}")
+        print()
+        
+        # Generated Structure
+        print_section("Generated Structure")
+        print()
+        print(color.info("The new command creates a complete project structure:"))
+        print()
+        print(f"  {color.file_path('<project_name>/')}")
+        print(f"  ├── {color.file_path('README.md')}                    # Project documentation")
+        print(f"  └── {color.file_path('<project_name>.mdl')}          # Main MDL file with template code")
+        print()
+        
+        # Template Content
+        print_section("Template Content")
+        print()
+        print(color.info("The generated MDL file includes:"))
+        print()
+        
+        print_section("Pack Declaration")
+        print(f"{color.code('pack {')}")
+        print(f"{color.code('  name: "project_name"')}")
+        print(f"{color.code('  format: 82')}")
+        print(f"{color.code('  description: "Generated by MDL CLI"')}")
+        print(f"{color.code('}')}")
+        print()
+        
+        print_section("Example Functions")
+        print(f"{color.code('function main {')}")
+        print(f"{color.code('  say "Hello from MDL!"')}")
+        print(f"{color.code('  ')}")
+        print(f"{color.code('  // Variable example')}")
+        print(f"{color.code('  score = 10')}")
+        print(f"{color.code('  say "Score: $score$"')}")
+        print(f"{color.code('  ')}")
+        print(f"{color.code('  // Conditional example')}")
+        print(f"{color.code('  if (score > 5) {')}")
+        print(f"{color.code('    say "High score!"')}")
+        print(f"{color.code('  } else {')}")
+        print(f"{color.code('    say "Try again!"')}")
+        print(f"{color.code('  }')}")
+        print(f"{color.code('}')}")
+        print()
+        print(f"{color.code('function load {')}")
+        print(f"{color.code('  // This function runs when the datapack loads')}")
+        print(f"{color.code('  say "Datapack loaded successfully!"')}")
+        print(f"{color.code('}')}")
+        print()
+        
+        # Features
+        print_section("Features")
+        print()
+        print_bullet("Complete project setup - Ready-to-use structure")
+        print_bullet("Template code - Working examples to learn from")
+        print_bullet("Proper pack metadata - Correct pack.mcmeta configuration")
+        print_bullet("Documentation - README with usage instructions")
+        print_bullet("Best practices - Follows MDL conventions")
+        print()
+        
+        # Getting Started
+        print_section("Getting Started")
+        print()
+        print(color.info("After creating a new project:"))
+        print()
+        print(f"1. Navigate to the project directory:")
+        print(f"   {color.code('cd <project_name>')}")
+        print()
+        print(f"2. Edit the MDL file:")
+        print(f"   # Edit {color.file_path('<project_name>.mdl')} with your code")
+        print()
+        print(f"3. Build the datapack:")
+        print(f"   {color.code('mdl build --mdl <project_name>.mdl -o dist')}")
+        print()
+        print(f"4. Check for errors:")
+        print(f"   {color.code('mdl check <project_name>.mdl')}")
+        print()
+        print(f"5. Load in Minecraft:")
+        print(f"   # Copy the dist folder to your world's datapacks directory")
+        print()
+        
+        # Tips
+        print_section("Tips")
+        print()
+        print_bullet("Use descriptive project names - They become your namespace")
+        print_bullet("Start with the template code - It demonstrates key MDL features")
+        print_bullet("Check your code regularly - Use `mdl check` during development")
+        print_bullet("Use version control - Git is great for tracking changes")
+        print_bullet("Read the documentation - Learn about all available features")
+        print()
+        
+        # Next Steps
+        print_section("Next Steps")
+        print()
+        print_bullet(f"Language Reference: {color.file_path('https://www.mcmdl.com/docs/language-reference')}")
+        print_bullet(f"Examples: {color.file_path('https://www.mcmdl.com/docs/examples')}")
+        print_bullet(f"CLI Reference: {color.file_path('https://www.mcmdl.com/docs/cli-reference')}")
+        print()
+        
+        # More Info
+        print(color.info(f"For more information, visit: {color.file_path('https://www.mcmdl.com/docs/cli-reference#new')}"))
+        print()
+        
+    except ImportError:
+        # Fallback if colors aren't available
+        print("""
 [NEW] MDL New Command - Create New MDL Projects
 ============================================
 

{minecraft_datapack_language-15.4.9 → minecraft_datapack_language-15.4.10/minecraft_datapack_language.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minecraft-datapack-language
-Version: 15.4.9
+Version: 15.4.10
 Summary: Compile JavaScript-style MDL language or Python API 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

{minecraft_datapack_language-15.4.9 → minecraft_datapack_language-15.4.10}/minecraft_datapack_language.egg-info/SOURCES.txt

@@ -1141,6 +1141,8 @@ structures/test_structure.json
 structures/workshop.json
 test_color_project/README.md
 test_color_project/main.mdl
+test_colors_final/README.md
+test_colors_final/main.mdl
 test_examples/01_basic_hello_world.mdl
 test_examples/02_variables_and_scopes.mdl
 test_examples/03_scoped_function_calls.mdl

minecraft_datapack_language-15.4.10/test_colors_final/README.md

@@ -0,0 +1,122 @@
+# test_colors_final
+
+A Minecraft datapack created with MDL (Minecraft Datapack Language).
+
+## [GAME] About
+
+This datapack was generated using the MDL CLI tool. MDL is a simplified language for creating Minecraft datapacks with variables, control structures, and easy syntax.
+
+## [DIR] Project Structure
+
+```
+test_colors_final/
+├── README.md              # This file
+└── main.mdl              # Main MDL source file
+```
+
+## [NEXT] Getting Started
+
+### Prerequisites
+
+- Minecraft Java Edition (1.20+ recommended)
+- MDL CLI tool installed (`pipx install minecraft-datapack-language`)
+
+### Building the Datapack
+
+1. **Build the project:**
+   ```bash
+   mdl build --mdl test_colors_final.mdl -o dist
+   ```
+
+2. **Check for errors:**
+   ```bash
+   mdl check test_colors_final.mdl
+   ```
+
+3. **Install in Minecraft:**
+   - Copy the `dist` folder to your world's `datapacks` directory
+   - Or use the `--wrapper` option to create a zip file:
+     ```bash
+     mdl build --mdl test_colors_final.mdl -o dist --wrapper test_colors_final
+     ```
+
+### Using the Datapack
+
+1. Load your world in Minecraft
+2. The datapack will automatically load
+3. Run the main function: `/function test_colors_final:main`
+
+## [OPT] Development
+
+### Editing the Code
+
+Open `test_colors_final.mdl` in your favorite text editor. The file contains:
+
+- **Pack declaration** - Datapack metadata
+- **Variables** - Scoreboard variables for storing data
+- **Functions** - The main logic of your datapack
+- **Control structures** - If/else statements and loops
+- **Raw commands** - Direct Minecraft commands when needed
+
+### Key Features
+
+- **Variables**: Use `variable name = value` to create scoreboard objectives
+- **Functions**: Define reusable code blocks with `function name Ellipsis`
+- **Conditionals**: Use `if (condition) Ellipsis else Ellipsis`
+- **Loops**: Use `while (condition) Ellipsis` for repeating actions
+- **Variable substitution**: Use `$variable$` in commands to insert values
+
+### Example Code
+
+```mdl
+// Set a variable
+score = 10
+
+// Use it in a command
+say "Your score is: $score$"
+
+// Conditional logic
+if (score > 5) {
+  say "Great job!"
+} else {
+  say "Keep trying!"
+}
+```
+
+## [INFO] Resources
+
+- **Language Reference**: https://www.mcmdl.com/docs/language-reference
+- **CLI Reference**: https://www.mcmdl.com/docs/cli-reference
+- **Examples**: https://www.mcmdl.com/docs/examples
+- **Website**: https://www.mcmdl.com
+- **GitHub**: https://github.com/aaron777collins/MinecraftDatapackLanguage
+
+## 🐛 Troubleshooting
+
+### Common Issues
+
+1. **"No .mdl files found"**
+   - Make sure you're in the correct directory
+   - Check that the file has a `.mdl` extension
+
+2. **Syntax errors**
+   - Use `mdl check test_colors_final.mdl` to find and fix errors
+   - Check the error messages for line numbers and suggestions
+
+3. **Datapack not loading**
+   - Verify the pack format is correct for your Minecraft version
+   - Check that the `dist` folder is in the right location
+
+### Getting Help
+
+- Check the error messages - they include helpful suggestions
+- Visit the documentation: https://www.mcmdl.com/docs
+- Report bugs: https://github.com/aaron777collins/MinecraftDatapackLanguage/issues
+
+## [FILE] License
+
+This project is licensed under the MIT License - see the LICENSE file for details.
+
+---
+
+Happy coding! [GAME]

minecraft_datapack_language-15.4.10/test_colors_final/main.mdl

@@ -0,0 +1,72 @@
+pack "test_colors_final" "Generated by MDL CLI" 82;
+namespace "test_colors_final";
+
+// Example variables
+var num score = 0;
+var num lives = 3;
+
+// Main function - this runs when called
+function "main" {
+    say Hello from test_colors_final!;
+    
+    // Set initial values
+    score = 10;
+    lives = 3;
+    
+    // Display current values
+    say Score: $score$;
+    say Lives: $lives$;
+    
+    // Example conditional statement
+    if "$score$ > 5" {
+        say Great score!;
+    } else {
+        say Keep trying!;
+    };
+    
+    // Example while loop
+    while "$lives$ > 0" {
+        say You have $lives$ lives remaining;
+        lives = lives - 1;
+    };
+    
+    say Game over!;
+}
+
+// Init function - this runs when the datapack loads
+function "init" {
+    say [GAME] test_colors_final loaded successfully!;
+    say Type: /function test_colors_final:main;
+}
+
+// Tick function - this runs every tick (20 times per second)
+function "tick" {
+    // Add your tick logic here
+    // Be careful with performance!
+}
+
+// Example function with parameters
+function "greet_player" {
+    say Welcome to test_colors_final!;
+    say Have fun playing!;
+}
+
+// Raw Minecraft commands example
+$!raw
+# You can use raw Minecraft commands here
+# These are passed through directly to the output
+# Useful for complex commands or commands not yet supported by MDL
+tellraw @a {"text":"Raw command example","color":"gold"}
+raw!$
+
+// Example recipe (optional)
+// recipe "diamond_sword" "diamond_sword.json";
+
+// Example loot table (optional)
+// loot_table "chest_loot" "chest_loot.json";
+
+// Example advancement (optional)
+// advancement "first_diamond" "first_diamond.json";
+
+// Hook the init function to run when the datapack loads
+on_load "test_colors_final:init";

minecraft_datapack_language-15.4.9/docs/_data/version.yml

@@ -1,3 +0,0 @@
-current: "15.4.8"
-tag: "v15.4.8"
-updated_at: "2025-09-02T03:01:58Z"