minecraft-datapack-language 15.4.5__py3-none-any.whl → 15.4.7__py3-none-any.whl

minecraft_datapack_language/cli_help.py

@@ -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/utils.py

@@ -21,18 +21,3 @@ def ns_path(namespace: str, path: str) -> str:
     if path.startswith("/"):
         path = path[1:]
     return f"{namespace}/{path}"
-
-def find_mdl_files(directory: Path) -> list[Path]:
-    """Find all .mdl files in a directory recursively.
-    
-    Args:
-        directory: Directory to search in
-        
-    Returns:
-        List of Path objects for .mdl files
-    """
-    mdl_files = []
-    for item in directory.rglob("*.mdl"):
-        if item.is_file():
-            mdl_files.append(item)
-    return sorted(mdl_files)

{minecraft_datapack_language-15.4.5.dist-info → minecraft_datapack_language-15.4.7.dist-info}/METADATA

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

@@ -1,12 +1,12 @@
 minecraft_datapack_language/__init__.py,sha256=i-qCchbe5b2Fshgc6yCU9mddOLs2UBt9SAcLqfUIrT0,606
-minecraft_datapack_language/_version.py,sha256=Zxfq99u22jZB71sDMEEPEvR-RO6FyKTaD89o-xqeg3Y,706
+minecraft_datapack_language/_version.py,sha256=SIXKzGXg_ZDjpdiyLe3C99MU-0N6v8GJBEqcqIzfHEs,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_build.py,sha256=HvrQdINx8EmF4OW6IZCx_S6Rs4NZQ-eB1PSlcDMnCmA,47939
 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=w8u8eeLhDCR_Jw4rfcMcCyY3rfOnQh-LUMZPg1WndrA,13124
-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
@@ -16,10 +16,10 @@ minecraft_datapack_language/mdl_lexer_js.py,sha256=VvbhKm727khdSAABxa03hoIIA7H3h
 minecraft_datapack_language/mdl_linter.py,sha256=z85xoAglENurCh30bR7kEHZ_JeMxcYaLDcGNRAl-RAI,17253
 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.5.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-minecraft_datapack_language-15.4.5.dist-info/METADATA,sha256=cl3gAuSE8F9RnGk5cTkdKAiHo4Xam1rs5wQsVFN0d4M,35229
-minecraft_datapack_language-15.4.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-minecraft_datapack_language-15.4.5.dist-info/entry_points.txt,sha256=c6vjBeCiyQflvPHBRyBk2nJCSfYt3Oc7Sc9V87ySi_U,108
-minecraft_datapack_language-15.4.5.dist-info/top_level.txt,sha256=ADtFI476tbKLLxEAA-aJQAfg53MA3k_DOb0KTFiggfw,28
-minecraft_datapack_language-15.4.5.dist-info/RECORD,,
+minecraft_datapack_language/utils.py,sha256=Aq0HAGlXqj9BUTEjaEilpvzEW0EtZYYMMwOqG9db6dE,684
+minecraft_datapack_language-15.4.7.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+minecraft_datapack_language-15.4.7.dist-info/METADATA,sha256=Y1SE5p89bmmGEXZK674BS73GdhoYCCm9YAYtT0yYPdc,35229
+minecraft_datapack_language-15.4.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+minecraft_datapack_language-15.4.7.dist-info/entry_points.txt,sha256=c6vjBeCiyQflvPHBRyBk2nJCSfYt3Oc7Sc9V87ySi_U,108
+minecraft_datapack_language-15.4.7.dist-info/top_level.txt,sha256=ADtFI476tbKLLxEAA-aJQAfg53MA3k_DOb0KTFiggfw,28
+minecraft_datapack_language-15.4.7.dist-info/RECORD,,