minecraft-datapack-language 17.0.0__tar.gz → 17.0.2__tar.gz

{minecraft_datapack_language-17.0.0 → minecraft_datapack_language-17.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minecraft-datapack-language
-Version: 17.0.0
+Version: 17.0.2
 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

minecraft_datapack_language-17.0.2/docs/_data/version.yml

@@ -0,0 +1,3 @@
+current: "17.0.1"
+tag: "v17.0.1"
+updated_at: "2025-09-10T07:34:01Z"

minecraft_datapack_language-17.0.2/docs/_docs/examples.md

@@ -0,0 +1,194 @@
+---
+layout: page
+title: MDL Examples
+permalink: /docs/examples/
+---
+
+This page contains working examples of MDL features.
+
+## Basic Hello World
+
+A simple datapack that says hello when loaded:
+
+```mdl
+pack "hello" "A simple hello world datapack" 82;
+namespace "hello";
+
+function hello:main {
+    say "Hello, Minecraft!";
+    tellraw @a {"text":"Welcome to my datapack!","color":"green"};
+}
+
+on_load hello:main;
+```
+
+## Logical Operators and Precedence
+
+```mdl
+pack "logicalops" "Generated by MDL CLI" 82;
+namespace "logicalops";
+
+// Variables
+var num a<@s> = 0;
+var num b<@s> = 0;
+
+// Main function
+function logicalops:main {
+    say "Hello from logicalops!";
+    exec logicalops:add<@a>;
+}
+
+function logicalops:init {
+    a<@s> = 1;
+    b<@s> = 2;
+}
+
+function logicalops:add {
+    var result<@s> = $a<@s>$ + $b<@s>$;
+    say "Result: $result$";
+}
+
+function logicalops:subtract {
+    var result<@s> = $a<@s>$ - $b<@s>$;
+    say "Result: $result$";
+}
+
+function logicalops:multiply {
+    var result<@s> = $a<@s>$ * $b<@s>$;
+    say "Result: $result$";
+}
+
+function logicalops:divide {
+    var result<@s> = $a<@s>$ / $b<@s>$;
+    say "Result: $result$";
+}
+
+function logicalops:andop {
+    if $a<@s>$ > 0 && $b<@s>$ > 0 {
+        say "Both are greater than 0";
+    } else {
+        say "At least one is not greater than 0";
+    }
+}
+
+function logicalops:orop {
+    if $a<@s>$ > 0 || $b<@s>$ > 0 {
+        say "At least one is greater than 0";
+    } else {
+        say "Both are not greater than 0";
+    }
+}
+
+function logicalops:notop {
+    if !$a<@s>$ > 0 {
+        say "a is not greater than 0";
+    } else {
+        say "a is greater than 0";
+    }
+}
+
+function logicalops:whileloop {
+    a<@s> = 0;
+    while $a<@s>$ < 10 {
+        say "a is less than 10";
+        a<@s> = $a<@s>$ + 1;
+    }
+}
+
+function logicalops:scheduledwhileloop {
+    // the scheduledwhile is just like the while loop, but it is scheduled to run every tick. This is useful for large calculations that would exceed the command recursion limit.
+    a<@s> = 0;
+    scheduledwhile $a<@s>$ < 10 {
+        say "a is less than 10";
+        a<@s> = $a<@s>$ + 1;
+    }
+}
+
+function logicalops:complexops {
+    var c<@s> = 5;
+    var d<@s> = 10;
+    var e<@s> = 15;
+    var f<@s> = 20;
+    var g<@s> = 2;
+    var h<@s> = 0;
+    h<@s> = $h<@s>$ - 1;
+
+    var result<@s> = ($c<@s>$ + $d<@s>$ - $e<@s>$ * $f<@s>$ / $g<@s>$) * $h<@s>$;
+
+    if !$result<@s>$ == 135 {
+        say "Result is not 135, there is an issue!";
+    } else {
+        say "Result is -135, everything is good!";
+    }
+}
+
+on_load logicalops:main;
+```
+
+<!-- Trimmed non-core examples to focus on core language concepts -->
+
+## Raw Commands
+
+Using raw Minecraft commands:
+
+```mdl
+pack "raw" "Raw command example" 82;
+namespace "raw";
+
+function raw:custom {
+    // Use raw Minecraft commands
+    effect give @s minecraft:speed 10 1;
+    particle minecraft:explosion ~ ~ ~ 1 1 1 0 10;
+    playsound minecraft:entity.player.levelup player @s ~ ~ ~ 1 1;
+}
+
+on_load raw:custom;
+```
+
+## Function Macros
+
+Demonstrates macro lines and passing macro data to functions:
+
+```mdl
+pack "macros" "Function macro examples" 82;
+namespace "macros";
+
+// Target function using a macro line with $(name)
+function macros:greeter {
+    $say "Hello $(name)"
+    say "Done";
+}
+
+// Callers using inline JSON and with-clause
+function macros:callers {
+    // Inline JSON compound (prefer single quotes outside)
+    exec macros:greeter '{name:"Alex"}';
+
+    // Pull compound from a data source via with-clause
+    exec macros:greeter with storage macros:ctx player.info;
+}
+
+on_load macros:callers;
+```
+
+## Fan-out Execution Pattern
+
+Run a function once per matching entity using an outer exec scope, then use default `@s` inside:
+
+```mdl
+pack "fanout" "Fan-out example" 82;
+namespace "fanout";
+
+var num visits<@s> = 0;
+
+function fanout:increment {
+    // Runs per-entity; scope defaults to @s inside
+    visits = $visits$ + 1;
+    say "Visits: $visits$";
+}
+
+// Fan out to all players on load
+on_load fanout:increment<@a>;
+```
+
+

{minecraft_datapack_language-17.0.0 → minecraft_datapack_language-17.0.2}/docs/_docs/getting-started.md

@@ -199,12 +199,12 @@ on_tick "example:update";
 mdl build --mdl myfile.mdl -o dist
 ```
 
-### Multiple Files
+### Build a directory (multiple files)
 ```bash
-mdl build --mdl "file1.mdl file2.mdl" -o dist
+mdl build --mdl . -o dist
 ```
 
-### Directory
+### Directory (explicit path)
 ```bash
 mdl build --mdl myproject/ -o dist
 ```

{minecraft_datapack_language-17.0.0 → minecraft_datapack_language-17.0.2}/docs/_docs/language-reference.md

@@ -142,6 +142,11 @@ exec game:spawn_mob '{id:"minecraft:cow",name:"Betsy"}';
 exec game:spawn_mob with storage mymod:ctx path.to.compound;
 ```
 
+### Exec and Scope Execution Rules
+- `exec ns:name` runs `function ns:name` in the current executor context.
+- `exec ns:name<selector>` compiles to `execute as <selector> run function ns:name`.
+- Macro args compile to `function ns:name {json}` form; with-clause compiles to `function ns:name with <data source and path>`.
+
 ### Control Structures
 
 #### If Statements
@@ -324,8 +329,23 @@ exec utils:helper;                              // Execute from different namesp
 && (logical AND)
 || (logical OR)
 !  (logical NOT)
+
+// Range (for matches)
+.. (range operator)
 ```
 
+### Unary Operators and Precedence
+- Unary minus: `-x` applies before multiplication/division and addition/subtraction. Literals are constant-folded; non-literals are compiled as `0 - x` via a temp score.
+- Logical NOT: `!expr` negates a boolean expression. For comparisons like `!$a$ > 0`, the comparison is compiled first, then inverted using `execute unless`.
+- Precedence (lowest to highest):
+  1) `||`
+  2) `&&`
+  3) Comparisons (`>`, `>=`, `<`, `<=`, `==`, `!=`)
+  4) `+`, `-`
+  5) `*`, `/`
+  6) Unary (`!`, unary `-`)
+  7) Parentheses `(...)`
+
 ### Expression Examples
 ```mdl
 // Complex expressions with different scopes
@@ -348,15 +368,18 @@ if $a<@s>$ > 0 || $b<@s>$ > 0 {
     say "At least one is greater than 0";
 }
 
-// NOT negates the entire comparison when used like: !$a<@s>$ > 0
-if !$a<@s>$ > 0 {
+// NOT negates the entire comparison when used like: !$a$ > 0
+if !$a$ > 0 {
     say "a is not greater than 0";
 }
 
 // Complex logical expression with parentheses
-if ($a<@s>$ > 0 && $b<@s>$ > 0) || $c<@s>$ > 0 {
+if ($a$ > 0 && $b$ > 0) || $c$ > 0 {
     say "Condition satisfied";
 }
+// Unary minus with literals and variables
+var num t = -2;
+if ($x$ + -($y$ * 3)) >= -5 { say "ok"; }
 ```
 
 ## Reserved Names
@@ -523,17 +546,18 @@ on_tick "game:update_timer";
 3. **No Return Values**: Functions compile to a series of Minecraft commands
 
 ### Control Structure Compilation
-1. **If Statements**: Generate `execute if score condition run function namespace:if_function` commands
-2. **Else If Statements**: Handle nested if statements recursively, generating proper conditional chains
-3. **Else Blocks**: Generate `execute unless score condition run function namespace:else_function` commands
-4. **While Loops**: Generate recursive function calls that continue while the condition is true
-5. **Nested Structures**: Automatically handle complex nested if/else and while loop combinations
+1. **If Statements**: Comparisons compile to scoreboard comparisons. `!=` uses equality with inversion. Boolean expressions (`&&`, `||`, `!`) compile via temporary boolean scores and `execute` chaining.
+2. **Else If Statements**: Handled as nested `if` with separate generated helper functions; chains are preserved.
+3. **Else Blocks**: Compiled using inverted conditions with `execute unless` to run the else helper function.
+4. **While Loops**: Generate recursive function calls that continue while the condition is true.
+5. **Scheduled While Loops**: Generate a per-tick scheduled helper, tagging entities to iterate; schedule continues while the condition remains true.
+6. **Nested Structures**: Automatically handle complex nested if/else and while loop combinations.
 
 ### Say Command Compilation
 1. **Simple Text**: `say "message"` becomes `tellraw @a {"text":"message"}`
-2. **With Variables**: `say "Score: $score<@s>$"` becomes `tellraw @a {"text":"Score: ","extra":[{"score":{"name":"@s","objective":"score"}}]}`
-3. **Multiple Variables**: Complex variable substitutions are automatically formatted into proper JSON structure
-4. **Default Target**: All say commands target `@a` (all players) for maximum visibility
+2. **With Variables**: `say "Score: $score<@s>$"` or `say "Score: $score$"` compiles to `tellraw` with a `score` component; `$var$` defaults to `<@s>`.
+3. **Multiple Variables**: Complex variable substitutions are automatically formatted into proper JSON structure.
+4. **Default Target**: All say commands target `@a` (all players) for maximum visibility.
 
 ### Tag Compilation
 1. **Recipe Tags**: `tag recipe "name" "path"` generates appropriate tag files
@@ -599,9 +623,15 @@ Examples: `0`, `42`, `3.14`, `1000`
 // Comparison
 == (EQUAL), != (NOT_EQUAL), > (GREATER), < (LESS), >= (GREATER_EQUAL), <= (LESS_EQUAL)
 
+// Logical
+&& (AND), || (OR), ! (NOT)
+
 // Assignment
 = (ASSIGN)
 
+// Range
+.. (RANGE)
+
 // Execution
 exec (EXEC)
 ```
@@ -623,8 +653,10 @@ exec (EXEC)
 
 #### **Special Tokens**
 ```
-$ (DOLLAR)        - Variable substitution delimiter
-" (QUOTE)         - String literal delimiter
+$ (DOLLAR)        - Variable substitution delimiter; line-start $... as MACRO_LINE
+! (EXCLAMATION)   - Used in $!raw markers
+RAW_CONTENT       - Entire content of a raw block
+" (QUOTE)         - String literal delimiter (supports both " and ' in lexer)
 ```
 
 ### Tag Declaration Tokenization
@@ -1273,10 +1305,10 @@ def _parse_comparison(self) -> Any:
 
 ### Integer-Only Arithmetic and Literal Handling
 
-- Scoreboard arithmetic is integer-only. MDL normalizes literals: `2.0` -> `2`; non-integer literals (e.g., `2.5`) are rejected with a compiler error when used in scoreboard operations.
-- Literal addition/subtraction uses `add`/`remove` and elides `+0`/`-0`.
-- Literal multiplication/division uses `multiply`/`divide` and elides `*1`/`/1`; `*0` sets to 0; `/(-k)` becomes `/|k|` then `*-1`.
-- Mixed expressions lower via temps; operations against other scores use `operation +=, -=, *=, /=`.
+- Scoreboard arithmetic is integer-only. MDL normalizes integer-like literals: `2.0` -> `2`. Non-integer literals (e.g., `2.5`) cause a compile-time error when used in scoreboard math.
+- Literal addition/subtraction uses `scoreboard players add/remove`; elides `+0`/`-0`.
+- Literal multiplication/division uses `scoreboard players multiply/divide`; elides `*1`/`/1`. `*0` sets the temp to zero. Division by zero is a compile-time error.
+- Mixed expressions are lowered via temporary scores to preserve precedence. Score-to-score operations use `scoreboard players operation`.
 
 ### AST Traversal and Code Generation
 

{minecraft_datapack_language-17.0.0 → minecraft_datapack_language-17.0.2}/minecraft_datapack_language/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '17.0.0'
-__version_tuple__ = version_tuple = (17, 0, 0)
+__version__ = version = '17.0.2'
+__version_tuple__ = version_tuple = (17, 0, 2)
 
-__commit_id__ = commit_id = 'g3afc15958'
+__commit_id__ = commit_id = 'g3dcd64bba'

{minecraft_datapack_language-17.0.0 → minecraft_datapack_language-17.0.2}/minecraft_datapack_language.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minecraft-datapack-language
-Version: 17.0.0
+Version: 17.0.2
 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

minecraft_datapack_language-17.0.0/docs/_data/version.yml

@@ -1,3 +0,0 @@
-current: "16.0.30"
-tag: "v16.0.30"
-updated_at: "2025-09-10T07:27:10Z"