minecraft-datapack-language 15.4.4__py3-none-any.whl → 15.4.6__py3-none-any.whl

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.4'
-__version_tuple__ = version_tuple = (15, 4, 4)
+__version__ = version = '15.4.6'
+__version_tuple__ = version_tuple = (15, 4, 6)
 
 __commit_id__ = commit_id = None

minecraft_datapack_language/cli_help.py

@@ -5,7 +5,7 @@ CLI Help System - Comprehensive help documentation for MDL CLI
 from .cli_colors import (
     print_header, print_title, print_section, print_separator,
     print_success, print_warning, print_info, print_bullet,
-    print_code, print_command, print_option, color
+    print_code, color
 )
 
 
@@ -27,15 +27,15 @@ def show_main_help():
     print_section("Available Commands")
     print()
     
-    print_command("build")
+    print_code("build")
     print_info("    - Compile MDL files into a Minecraft datapack")
     print()
     
-    print_command("check")
+    print_code("check")
     print_info("    - Validate MDL files for syntax and semantic errors")
     print()
     
-    print_command("new")
+    print_code("new")
     print_info("    - Create a new MDL project with template files")
     print()
     
@@ -110,12 +110,12 @@ def show_build_help():
     print_section("Arguments")
     print()
     
-    print_option("--mdl, -m <input>")
+    print_code("--mdl, -m <input>")
     print_info("     Input MDL file or directory containing .mdl files")
     print_info("     Examples: --mdl project.mdl, --mdl src/, --mdl .")
     print()
     
-    print_option("-o, --output <output>")
+    print_code("-o, --output <output>")
     print_info("     Output directory for the generated datapack")
     print_info("     Example: -o dist, -o build/my_pack")
     print()
@@ -123,22 +123,22 @@ def show_build_help():
     print_section("Options")
     print()
     
-    print_option("--verbose, -v")
+    print_code("--verbose, -v")
     print_info("     Enable verbose output with detailed build information")
     print_info("     Shows file parsing, function generation, and progress")
     print()
     
-    print_option("--pack-format <number>")
+    print_code("--pack-format <number>")
     print_info("     Override the pack format number (default: 82)")
     print_info("     Higher numbers support newer Minecraft versions")
     print()
     
-    print_option("--wrapper <name>")
+    print_code("--wrapper <name>")
     print_info("     Create a zip file with the specified name")
     print_info("     Example: --wrapper my_pack.zip")
     print()
     
-    print_option("--ignore-warnings")
+    print_code("--ignore-warnings")
     print_info("     Suppress warning messages during build")
     print_info("     Only errors will be shown")
     print()
@@ -189,7 +189,7 @@ def show_check_help():
     print_section("Arguments")
     print()
     
-    print_option("<input>")
+    print_code("<input>")
     print_info("     Input MDL file or directory to check")
     print_info("     Examples: project.mdl, src/, .")
     print()
@@ -197,12 +197,12 @@ def show_check_help():
     print_section("Options")
     print()
     
-    print_option("--verbose, -v")
+    print_code("--verbose, -v")
     print_info("     Enable verbose output with detailed validation information")
     print_info("     Shows parsing steps, variable analysis, and scope checking")
     print()
     
-    print_option("--ignore-warnings")
+    print_code("--ignore-warnings")
     print_info("     Suppress warning messages during check")
     print_info("     Only errors will be shown")
     print()
@@ -266,7 +266,7 @@ def show_new_help():
     print_section("Arguments")
     print()
     
-    print_option("<project_name>")
+    print_code("<project_name>")
     print_info("     Name for the new project (will create project_name/ directory)")
     print_info("     Examples: my_datapack, adventure_pack, minigame")
     print()
@@ -274,12 +274,12 @@ def show_new_help():
     print_section("Options")
     print()
     
-    print_option("--pack-name <name>")
+    print_code("--pack-name <name>")
     print_info("     Custom pack name (default: same as project name)")
     print_info("     This appears in the pack.mcmeta file")
     print()
     
-    print_option("--pack-format <number>")
+    print_code("--pack-format <number>")
     print_info("     Pack format number (default: 82)")
     print_info("     Higher numbers support newer Minecraft versions")
     print_info("     Common values: 15 (1.17+), 26 (1.18+), 82 (1.20+)")
@@ -290,11 +290,11 @@ def show_new_help():
     
     print_info("The new command creates:")
     print_bullet("project_name/ directory")
-    print_bullet("project_name.mdl - Main MDL source file")
+    print_bullet("main.mdl - Main MDL source file with basic hello world example")
     print_bullet("README.md - Project documentation template")
     print_bullet("Proper pack.mcmeta configuration")
-    print_bullet("Basic function structure (load, main, tick)")
-    print_bullet("Example variable and command usage")
+    print_bullet("Simple function structure (main function with on_load hook)")
+    print_bullet("Clean, working example that demonstrates basic MDL syntax")
     print()
     
     print_section("Examples")
@@ -316,11 +316,10 @@ def show_new_help():
     print()
     
     print_info("New projects include:")
-    print_bullet("load function - Runs when datapack is loaded")
-    print_bullet("main function - Main game logic")
-    print_bullet("tick function - Runs every game tick")
-    print_bullet("Example variables and scoreboard setup")
-    print_bullet("Basic command structure")
+    print_bullet("main function - Simple hello world example")
+    print_bullet("on_load hook - Automatically runs the main function when loaded")
+    print_bullet("Clean, minimal code that compiles and works immediately")
+    print_bullet("Proper pack declaration and namespace setup")
     print()
     
     print_success("Project created! Start editing the .mdl file and use 'mdl build' to compile.")

minecraft_datapack_language/cli_new.py

@@ -78,79 +78,16 @@ def create_new_project(project_name: str, pack_name: str = None, pack_format: in
 
 
 def _generate_mdl_template(project_name: str, pack_name: str, pack_format: int) -> str:
-    """Generate the template MDL content."""
-    return f'''pack "{pack_name}" "Generated by MDL CLI" {pack_format};
-namespace "{pack_name}";
+    """Generate the MDL template content."""
+    return f'''pack "{pack_name}" "A simple hello world datapack" {pack_format};
+namespace "{project_name}";
 
-// Example variables
-var num score = 0;
-var num lives = 3;
-
-// Main function - this runs when called
 function "main" {{
-    say Hello from {project_name}!;
-    
-    // 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] {pack_name} loaded successfully!;
-    say Type: /function {project_name}:main;
-}}
-
-// Tick function - this runs every tick (20 times per second)
-function "tick" {{
-    // Add your tick logic here
-    // Be careful with performance!
+    say Hello, Minecraft!;
+    tellraw @a {{"text":"Welcome to my datapack!","color":"green"}};
 }}
 
-// Example function with parameters
-function "greet_player" {{
-    say Welcome to {pack_name}!;
-    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 "{project_name}:init";
+on_load "{project_name}:main";
 '''
 
 
@@ -162,14 +99,14 @@ 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.
+This datapack was generated using the MDL CLI tool. MDL is a simplified language for creating Minecraft datapacks with clean, readable syntax.
 
 ## [DIR] Project Structure
 
 ```
 {project_name}/
 ├── README.md              # This file
-└── main.mdl              # Main MDL source file
+└── main.mdl              # Main MDL source file with basic hello world example
 ```
 
 ## [NEXT] Getting Started
@@ -183,19 +120,19 @@ This datapack was generated using the MDL CLI tool. MDL is a simplified language
 
 1. **Build the project:**
    ```bash
-   mdl build --mdl {project_name}.mdl -o dist
+   mdl build --mdl main.mdl -o dist
    ```
 
 2. **Check for errors:**
    ```bash
-   mdl check {project_name}.mdl
+   mdl check main.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 {project_name}.mdl -o dist --wrapper {project_name}
+     mdl build --mdl main.mdl -o dist --wrapper {project_name}
      ```
 
 ### Using the Datapack
@@ -208,37 +145,31 @@ This datapack was generated using the MDL CLI tool. MDL is a simplified language
 
 ### Editing the Code
 
-Open `{project_name}.mdl` in your favorite text editor. The file contains:
+Open `main.mdl` in your favorite text editor. The file contains:
 
 - **Pack declaration** - Datapack metadata
-- **Variables** - Scoreboard variables for storing data
+- **Namespace** - Datapack namespace for organization
 - **Functions** - The main logic of your datapack
-- **Control structures** - If/else statements and loops
-- **Raw commands** - Direct Minecraft commands when needed
+- **on_load hook** - Automatically runs when the datapack loads
 
 ### Key Features
 
-- **Variables**: Use `variable name = value` to create scoreboard objectives
-- **Functions**: Define reusable code blocks with `function name { ... }`
-- **Conditionals**: Use `if (condition) { ... } else { ... }`
-- **Loops**: Use `while (condition) { ... }` for repeating actions
-- **Variable substitution**: Use `$variable$` in commands to insert values
+- **Functions**: Define reusable code blocks with `function "name" {{ ... }}`
+- **Basic commands**: Use `say` and `tellraw` for player communication
+- **Automatic loading**: The `on_load` hook runs your main function automatically
+- **Clean syntax**: Simple, readable MDL syntax that compiles to Minecraft commands
 
 ### 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!"
+// Define a function
+function "main" {{
+    say Hello, Minecraft!;
+    tellraw @a {{"text":"Welcome!","color":"green"}};
 }}
+
+// Hook it to run when loaded
+on_load "{project_name}:main";
 ```
 
 ## [INFO] Resources
@@ -258,7 +189,7 @@ if (score > 5) {{
    - Check that the file has a `.mdl` extension
 
 2. **Syntax errors**
-   - Use `mdl check {project_name}.mdl` to find and fix errors
+   - Use `mdl check main.mdl` to find and fix errors
    - Check the error messages for line numbers and suggestions
 
 3. **Datapack not loading**

{minecraft_datapack_language-15.4.4.dist-info → minecraft_datapack_language-15.4.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minecraft-datapack-language
-Version: 15.4.4
+Version: 15.4.6
 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.4.dist-info → minecraft_datapack_language-15.4.6.dist-info}/RECORD

@@ -1,12 +1,12 @@
 minecraft_datapack_language/__init__.py,sha256=i-qCchbe5b2Fshgc6yCU9mddOLs2UBt9SAcLqfUIrT0,606
-minecraft_datapack_language/_version.py,sha256=e7cVAYttJ6XjmTS7-7yEW5j6L0kOM71XT1X8_H-3TcA,706
+minecraft_datapack_language/_version.py,sha256=orqZrdTIAmN40ec2-mUiqfcn77NJi5YYCW2ApoD5pgg,706
 minecraft_datapack_language/ast_nodes.py,sha256=pgjI2Nlap3ixFPgWqGSkqncG9zB91h5BKgRjtcJqMew,2118
 minecraft_datapack_language/cli.py,sha256=p5A_tEEXugN2NhQFbbgfwi4FxbWYD91RWeKR_A3Vuec,6263
 minecraft_datapack_language/cli_build.py,sha256=hbBqAI0VeoffF2EPaZu0HSCRfFBsEnjpwSZm0PNCfDE,9023
 minecraft_datapack_language/cli_check.py,sha256=bPq9gHsxQ1CIiftkrAtRCifWkVAyjp5c8Oay2NNQ1qs,6277
 minecraft_datapack_language/cli_colors.py,sha256=Ims0KbdYpsiwoqv96Y_g89uOB5l1qdETm_P51rkljfk,7884
-minecraft_datapack_language/cli_help.py,sha256=n2cJLYlKRz0umCgWuKrZm2Il0qEAkOloSUOcZvPa4Qk,13186
-minecraft_datapack_language/cli_new.py,sha256=Uw-xuW6KTTRTeOsnS3wgoZnna7xA203SM8qvUUDFHTk,8112
+minecraft_datapack_language/cli_help.py,sha256=z7PTqkrRYOFhfqe7CLdaF68kEAO5R1iP0j45b_36bEw,13196
+minecraft_datapack_language/cli_new.py,sha256=3K6gHCYwmOTXysicSWJNsjU1YXyz2xa5IGjoOtj1CKc,6489
 minecraft_datapack_language/cli_utils.py,sha256=nl22j96vpCW0XRMpD_zjwamnMU4e4LXEjACsnwiFGzs,9931
 minecraft_datapack_language/dir_map.py,sha256=HmxFkuvWGkzHF8o_GFb4BpuMCRc6QMw8UbmcAI8JVdY,1788
 minecraft_datapack_language/expression_processor.py,sha256=GN6cuRNvgI8TrV6YnEHrA9P0X-ACTT7rCBh4WlOPjSI,20140
@@ -17,9 +17,9 @@ minecraft_datapack_language/mdl_linter.py,sha256=z85xoAglENurCh30bR7kEHZ_JeMxcYa
 minecraft_datapack_language/mdl_parser_js.py,sha256=SQzc67pKls3NVnQaT0xIILGqpZYAmcZn78TQ0KIM4TE,40216
 minecraft_datapack_language/pack.py,sha256=nYiXQ3jgJlDfc4m-65f7C2LFhDRioaUU_XVy6Na4SJI,34625
 minecraft_datapack_language/utils.py,sha256=LauI6WqNys1F9R6j-TaMVDsTBXzpDxDb5snHYJT8NZo,1074
-minecraft_datapack_language-15.4.4.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-minecraft_datapack_language-15.4.4.dist-info/METADATA,sha256=1egPSOT4WXO5QtHumrIgpHztjCh_Q_FR13fAFaFPCyc,35229
-minecraft_datapack_language-15.4.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-minecraft_datapack_language-15.4.4.dist-info/entry_points.txt,sha256=c6vjBeCiyQflvPHBRyBk2nJCSfYt3Oc7Sc9V87ySi_U,108
-minecraft_datapack_language-15.4.4.dist-info/top_level.txt,sha256=ADtFI476tbKLLxEAA-aJQAfg53MA3k_DOb0KTFiggfw,28
-minecraft_datapack_language-15.4.4.dist-info/RECORD,,
+minecraft_datapack_language-15.4.6.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+minecraft_datapack_language-15.4.6.dist-info/METADATA,sha256=fZugtvdrhsWv_BWLUgKoUxf3ZI22VePFcE-u9Ij01Mc,35229
+minecraft_datapack_language-15.4.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+minecraft_datapack_language-15.4.6.dist-info/entry_points.txt,sha256=c6vjBeCiyQflvPHBRyBk2nJCSfYt3Oc7Sc9V87ySi_U,108
+minecraft_datapack_language-15.4.6.dist-info/top_level.txt,sha256=ADtFI476tbKLLxEAA-aJQAfg53MA3k_DOb0KTFiggfw,28
+minecraft_datapack_language-15.4.6.dist-info/RECORD,,