minecraft-datapack-language 15.4.15__tar.gz → 15.4.16__tar.gz

{minecraft_datapack_language-15.4.15/minecraft_datapack_language.egg-info → minecraft_datapack_language-15.4.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minecraft-datapack-language
-Version: 15.4.15
+Version: 15.4.16
 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.16/docs/_data/version.yml

@@ -0,0 +1,3 @@
+current: "15.4.15"
+tag: "v15.4.15"
+updated_at: "2025-09-02T03:39:38Z"

{minecraft_datapack_language-15.4.15 → minecraft_datapack_language-15.4.16}/docs/_docs/cli-reference.md

@@ -120,6 +120,47 @@ Context:
 Suggestion: Add closing quote '"' at the end of line 20
 ```
 
+### New Command
+
+Create a new MDL project with template files:
+
+```bash
+mdl new <project_name>
+```
+
+**Examples:**
+```bash
+# Create a new project in current directory
+mdl new my_awesome_pack
+
+# Create a project with specific name
+mdl new adventure_map
+
+# Create a project in a subdirectory
+mdl new projects/survival_plus
+```
+
+**What it creates:**
+The new command generates a complete project structure with:
+- `README.md` - Project documentation and setup instructions
+- `main.mdl` - Main MDL file with basic template structure
+- Proper pack declaration and namespace setup
+- Example functions and basic syntax
+
+**Generated project structure:**
+```
+my_awesome_pack/
+├── README.md
+└── main.mdl
+```
+
+**Template content includes:**
+- Pack metadata (name, description, format)
+- Namespace declaration
+- Sample function definitions
+- Basic MDL syntax examples
+- Load function setup
+
 ## Command Options
 
 ### Build Options
@@ -139,6 +180,12 @@ Suggestion: Add closing quote '"' at the end of line 20
 | `--verbose` | Show detailed validation information | `--verbose` |
 | `--ignore-warnings` | Suppress warning messages | `--ignore-warnings` |
 
+### New Options
+
+| Option | Description | Example |
+|--------|-------------|---------|
+| `<project_name>` | Name of the new project to create | `mdl new my_pack` |
+
 ## Error Handling
 
 MDL provides comprehensive error handling and reporting:
@@ -206,7 +253,27 @@ Summary: 3 errors found
 
 ### Basic Workflow
 
-1. **Create MDL file:**
+1. **Create a new project:**
+```bash
+mdl new hello_world
+```
+
+2. **Check the generated file:**
+```bash
+mdl check hello_world/main.mdl
+```
+
+3. **Build the datapack:**
+```bash
+mdl build --mdl hello_world/main.mdl -o dist
+```
+
+4. **Install in Minecraft:**
+- Copy `dist/hello_world/` to your world's `datapacks/` folder
+- Run `/reload` in-game
+
+**Alternative: Manual file creation**
+If you prefer to create files manually, you can start with:
 ```mdl
 // hello.mdl
 pack "hello" "My first datapack" 82;

{minecraft_datapack_language-15.4.15 → minecraft_datapack_language-15.4.16}/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.15'
-__version_tuple__ = version_tuple = (15, 4, 15)
+__version__ = version = '15.4.16'
+__version_tuple__ = version_tuple = (15, 4, 16)
 
-__commit_id__ = commit_id = 'geb71911c0'
+__commit_id__ = commit_id = 'g0453ad24f'

{minecraft_datapack_language-15.4.15 → minecraft_datapack_language-15.4.16}/minecraft_datapack_language/cli_help.py

@@ -324,7 +324,7 @@ def show_check_help():
     print()
     
     # More Info
-    print(color.info(f"For more information, visit: {color.file_path('https://www.mcmdl.com/docs/cli-reference#check')}"))
+    print(color.info(f"For more information, visit: {color.file_path('https://www.mcmdl.com/docs/cli-reference#check-command')}"))
     print()
 
 def show_new_help():
@@ -478,5 +478,5 @@ def show_new_help():
     print()
     
     # More Info
-    print(color.info(f"For more information, visit: {color.file_path('https://www.mcmdl.com/docs/cli-reference#new')}"))
+    print(color.info(f"For more information, visit: {color.file_path('https://www.mcmdl.com/docs/cli-reference#new-command')}"))
     print()

{minecraft_datapack_language-15.4.15 → minecraft_datapack_language-15.4.16/minecraft_datapack_language.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minecraft-datapack-language
-Version: 15.4.15
+Version: 15.4.16
 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.15 → minecraft_datapack_language-15.4.16}/minecraft_datapack_language.egg-info/SOURCES.txt

@@ -1262,6 +1262,8 @@ test_examples/test_output_while_loops_fixed/data/while_loops/function/load.mcfun
 test_examples/test_output_while_loops_fixed/data/while_loops/function/main.mcfunction
 test_examples/test_output_while_loops_fixed/data/while_loops/function/test_countdown_while_1.mcfunction
 test_examples/test_output_while_loops_fixed/data/while_loops/function/test_main_while_2.mcfunction
+test_project/README.md
+test_project/main.mdl
 test_single/pack.mcmeta
 test_single/data/basic_hello/function/load.mcfunction
 test_single/data/basic_hello/function/main.mcfunction

minecraft_datapack_language-15.4.16/test_project/README.md

@@ -0,0 +1,122 @@
+# test_project
+
+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_project/
+├── 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_project.mdl -o dist
+   ```
+
+2. **Check for errors:**
+   ```bash
+   mdl check test_project.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_project.mdl -o dist --wrapper test_project
+     ```
+
+### Using the Datapack
+
+1. Load your world in Minecraft
+2. The datapack will automatically load
+3. Run the main function: `/function test_project:main`
+
+## [OPT] Development
+
+### Editing the Code
+
+Open `test_project.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_project.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.16/test_project/main.mdl

@@ -0,0 +1,72 @@
+pack "test_project" "Generated by MDL CLI" 82;
+namespace "test_project";
+
+// Example variables
+var num score = 0;
+var num lives = 3;
+
+// Main function - this runs when called
+function "main" {
+    say Hello from test_project!;
+    
+    // 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_project loaded successfully!;
+    say Type: /function test_project: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_project!;
+    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_project:init";

minecraft_datapack_language-15.4.15/docs/_data/version.yml

@@ -1,3 +0,0 @@
-current: "15.4.14"
-tag: "v15.4.14"
-updated_at: "2025-09-02T03:36:08Z"