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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minecraft-datapack-language
-Version: 17.0.1
+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.1 → 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.1 → 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.1'
-__version_tuple__ = version_tuple = (17, 0, 1)
+__version__ = version = '17.0.2'
+__version_tuple__ = version_tuple = (17, 0, 2)
 
-__commit_id__ = commit_id = 'g3845dc346'
+__commit_id__ = commit_id = 'g3dcd64bba'

{minecraft_datapack_language-17.0.1 → 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.1
+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.1/docs/_data/version.yml

@@ -1,3 +0,0 @@
-current: "17.0.0"
-tag: "v17.0.0"
-updated_at: "2025-09-10T07:30:26Z"

minecraft_datapack_language-17.0.1/docs/_docs/examples.md

@@ -1,444 +0,0 @@
----
-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!";
-    }
-}
-```
-
-## Counter with Scoped Variables
-
-Demonstrates variables with different scopes:
-
-```mdl
-pack "counter" "Counter example" 82;
-namespace "counter";
-
-var num globalCounter<@a> = 0;
-var num playerCounter<@s> = 0;  // Defaults to player-specific scope
-
-function counter:increment {
-    globalCounter<@a> = $globalCounter<@a>$ + 1;
-    playerCounter<@s> = $playerCounter<@s>$ + 1;
-    say "Global: $globalCounter<@a>$, Player: $playerCounter<@s>$";
-}
-
-function counter:show_all {
-    exec counter:increment<@a>;
-}
-
-on_load counter:increment;
-```
-
-## While Loop Example
-
-A countdown timer using a while loop:
-
-```mdl
-pack "loops" "Loop example" 82;
-namespace "loops";
-
-var num counter<@a> = 0;
-
-function loops:countdown {
-    counter<@a> = 5;
-    while $counter<@a>$ > 0 {
-        say "Countdown: $counter<@a>$";
-        counter<@a> = $counter<@a>$ - 1;
-    }
-    say "Blast off!";
-}
-
-on_load loops:countdown;
-```
-
-## 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;
-```
-
-## Complete Game Example
-
-A complete game with scoring, levels, and timers:
-
-```mdl
-pack "game" "Complete game example" 82;
-namespace "game";
-
-// Variables
-var num score<@s> = 0;  // Defaults to player-specific scope
-var num level<@s> = 1;  // Defaults to player-specific scope
-var num globalTimer<@a> = 0;
-
-// Main game function
-function "start_game" {
-    score<@s> = 0;
-    level<@s> = 1;
-            say "Game started! Level: $level<@s>$, Score: $score<@s>$";
-}
-
-// Level up function
-function "level_up" {
-    if $score<@s>$ >= 100 {
-        level<@s> = level<@s> + 1;
-        score<@s> = score<@s> - 100;
-        say "Level up! New level: $level<@s>$";
-        tellraw @a {"text":"Player leveled up!","color":"gold"};
-    }
-}
-
-// Timer function
-function "update_timer" {
-    globalTimer<global> = globalTimer<global> + 1;
-    if $globalTimer<@a>$ >= 1200 {  // 60 seconds
-        globalTimer<global> = 0;
-        say "Time's up! Final score: $score<@s>$";
-    }
-}
-
-// Add score function
-function "add_score" {
-    score<@s> = score<@s> + 10;
-            say "Score: $score<@s>$";
-    function "game:level_up";
-}
-
-// Hooks
-on_load "game:start_game";
-on_tick "game:update_timer";
-```
-
-## Team-Based System
-
-A system that tracks team scores:
-
-```mdl
-pack "teams" "Team system example" 82;
-namespace "teams";
-
-// Team variables
-var num redScore<@a[team=red]> = 0;
-var num blueScore<@a[team=blue]> = 0;
-var num gameTimer<@a> = 0;
-
-// Initialize teams
-function "init" {
-    redScore<@a[team=red]> = 0;
-    blueScore<@a[team=blue]> = 0;
-    gameTimer<global> = 0;
-    say Team game initialized!;
-}
-
-// Update game
-function "update" {
-    gameTimer<global> = gameTimer<global> + 1;
-    
-    if $gameTimer<@a>$ >= 2400 {  // 2 minutes
-        gameTimer<global> = 0;
-        say "Game over! Red: $redScore<@a[team=red]>$, Blue: $blueScore<@a[team=blue]>$";
-        
-        if $redScore<@a[team=red]>$ > $blueScore<@a[team=blue]>$ {
-            tellraw @a {"text":"Red team wins!","color":"red"};
-        } else if $blueScore<@a[team=blue]>$ > $redScore<@a[team=red]>$ {
-            tellraw @a {"text":"Blue team wins!","color":"blue"};
-        } else {
-            tellraw @a {"text":"It's a tie!","color":"yellow"};
-        }
-    }
-}
-
-// Add points to red team
-function "red_point" {
-    redScore<@a[team=red]> = redScore<@a[team=red]> + 1;
-            say "Red team score: $redScore<@a[team=red]>$";
-}
-
-// Add points to blue team
-function "blue_point" {
-    blueScore<@a[team=blue]> = blueScore<@a[team=blue]> + 1;
-            say "Blue team score: $blueScore<@a[team=blue]>$";
-}
-
-// Hooks
-on_load "teams:init";
-on_tick "teams:update";
-```
-
-## Multi-File Example
-
-Organizing code across multiple files:
-
-**`main.mdl`** (with pack declaration):
-```mdl
-pack "multifile" "Multi-file example" 82;
-namespace "core";
-
-var num playerCount<@a> = 0;
-
-function "init" {
-    playerCount = 0;
-    say Core system initialized!;
-}
-
-on_load "core:init";
-```
-
-**`ui.mdl`** (no pack declaration needed):
-```mdl
-namespace "ui";
-
-function "show_hud" {
-    tellraw @a {"text":"Players: $playerCount<@a>$","color":"green"};
-}
-
-function "update_hud" {
-    function "ui:show_hud<@a>";
-}
-```
-
-**`game.mdl`** (no pack declaration needed):
-```mdl
-namespace "game";
-
-function "start" {
-    say Game started!;
-    function "ui:update_hud";
-}
-```
-
-Build all files together:
-```bash
-mdl build --mdl "main.mdl ui.mdl game.mdl" -o dist
-```
-
-## Explicit Scopes in Conditions
-
-Demonstrates how to use explicit scope selectors in if/while conditions to override declared variable scopes:
-
-```mdl
-pack "scopes" "Explicit scope conditions example" 82;
-namespace "scopes";
-
-// Variables with different scopes
-var num playerScore = 0;                    // Defaults to @s
-var num globalCounter<@a> = 0;                  // Global scope
-var num teamScore<@a[team=red]> = 0;            // Team scope
-
-function "main" {
-    // Test explicit scope overrides in if conditions
-    if "$playerScore<@s>$ > 10" {
-        say "Current player score is high!";
-    }
-    
-    if "$globalCounter<global>$ > 100" {
-        say "Global counter reached milestone!";
-    }
-    
-    if "$teamScore<@a[team=red]>$ > 50" {
-        say "Red team is winning!";
-    }
-    
-    // Check another player's score
-    if "$playerScore<@p[name=Steve]>$ > 5" {
-        say "Steve has a good score!";
-    }
-    
-    // Check if any player has a high score
-    if "$playerScore<@a>$ > 20" {
-        say "Someone has a very high score!";
-    }
-    
-    // Use explicit scopes in while loops too
-    while "$globalCounter<global>$ < 10" {
-        globalCounter<global> = globalCounter<global> + 1;
-        say "Counter: $globalCounter<@a>$";
-    }
-}
-
-// Function to test different scopes
-function "test_scopes" {
-    // Set different values for different scopes
-    playerScore<@s> = 15;                    // Current player
-    globalCounter<global> = 150;             // Global
-    teamScore<@a[team=red]> = 75;           // Red team
-    
-    // Test conditions with explicit scopes
-    if "$playerScore<@s>$ > 10" {
-        say "Player score check passed!";
-    }
-    
-    if "$globalCounter<global>$ > 100" {
-        say "Global counter check passed!";
-    }
-    
-    if "$teamScore<@a[team=red]>$ > 50" {
-        say "Team score check passed!";
-    }
-}
-
-on_load "scopes:main";
-```
-
-**Key Features:**
-- **Override declared scopes**: Use `<@s>`, `<global>`, `<@a[team=red]>` in conditions
-- **Check other entities**: Compare scores across different players/teams
-- **Flexible conditions**: Mix and match scopes as needed
-- **Clear intent**: Explicit scope makes code more readable and debuggable
-
-