minecraft-datapack-language 16.0.27__tar.gz → 16.0.28__tar.gz

{minecraft_datapack_language-16.0.27 → minecraft_datapack_language-16.0.28}/PKG-INFO

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

@@ -0,0 +1,3 @@
+current: "16.0.27"
+tag: "v16.0.27"
+updated_at: "2025-09-10T07:14:19Z"

{minecraft_datapack_language-16.0.27 → minecraft_datapack_language-16.0.28}/docs/_docs/language-reference.md

@@ -11,9 +11,9 @@ MDL is a simple, scope-aware language that compiles to Minecraft datapack `.mcfu
 ## Core Language Design
 
 ### Philosophy
-- **Explicit scoping**: Every variable operation specifies its scope with `<>` brackets
-- **Clear reading vs writing**: Use `$variable<scope>$` for reading, `variable<scope>` for writing
-- **No scope inheritance**: Each operation uses its own explicitly defined scope
+- **Explicit scoping**: Variables support explicit `<scope>`; if omitted, `@s` (current player) is assumed
+- **Clear reading vs writing**: Use `$variable<scope>$` or `$variable$` for reading, and `variable<scope>` or `variable` for writing
+- **No scope inheritance**: Each operation uses its own explicitly defined scope (or defaults to `@s` when omitted)
 - **Default scope**: When no scope specified, always use `@s` (current player)
 - **No return values**: All functions are void - they execute commands and modify state
 - **No quotes needed**: Use `$variable<scope>$` syntax directly instead of string literals
@@ -63,16 +63,17 @@ tag structure "custom_house" "structures/custom_house.json";
 
 ### Variable Declaration
 ```mdl
-// Declare variables with explicit scope
+// Declare variables (scope optional; defaults to @s)
 var num player_score<@a> = 0;                    // Global scope - accessible by all players
 var num player_health<@s> = 20;                  // Player-specific scope
+var num player_health = 20;                      // Same as player_health<@s> = 20
 var num team_score<@a[team=red]> = 0;            // Team scope
 var num entity_data<@e[type=armor_stand,tag=mdl_server,limit=1]> = 0; // Custom entity scope
 ```
 
 ### Variable Assignment
 ```mdl
-// Always specify scope for assignments
+// Scope optional; defaults to @s for both reads and writes when omitted
 player_score<@s> = $player_score<@s>$ + 1;       // Add 1 to current player's score
 player_health<@a> = $player_health<@s>$;         // Read from @s, write to @a
 team_score<@a[team=red]> = 5;                   // Set red team score to 5
@@ -83,13 +84,15 @@ player_score = 0;                                // Same as player_score<@s> = 0
 
 ### Variable Substitution
 ```mdl
-// Use $variable<scope>$ syntax anywhere in the code
+// Use $variable<scope>$ or $variable$ anywhere in the code
+// $variable$ defaults to <@s>
 tellraw @s {"text":"You have ","extra":[{"score":{"name":"@s","objective":"player_score"}}," points"]};
+tellraw @s {"text":"You have ","extra":[{"score":{"name":"@s","objective":"player_score"}}," points"]}; // $player_score$
 execute if score @s player_score matches 10.. run game:celebrate;
 
 // In conditions
-if $player_score<@s>$ > 10 {
-    player_score<@s> = 0;
+if $player_score$ > 10 {
+    player_score = 0;                             // defaults to <@s>
 }
 ```
 
@@ -241,8 +244,8 @@ $summon minecraft:cow ~ ~ ~ {CustomName:'{"text":"$(name)"}'}
 
 ### Core Scope Rules
 
-1. **Variable Writing**: Use `variable<scope>` for assignments and declarations
-2. **Variable Reading**: Use `$variable<scope>$` for reading values
+1. **Variable Writing**: Use `variable<scope>` for assignments and declarations; `variable` defaults to `<@s>`
+2. **Variable Reading**: Use `$variable<scope>$` for reading values; `$variable$` defaults to `<@s>`
 3. **Function Execution**: Use `exec` keyword to run any function (with or without scope)
 4. **No Inheritance**: Functions do not inherit scope from their caller
 5. **Default Scope**: When no scope specified, always use `@s` (current player)
@@ -272,6 +275,7 @@ var num global_counter<@a> = 0;
 global_counter<@s> = 5;                         // Set current player's counter to 5
 global_counter<@a> = $global_counter<@a>$ + 1;  // Increment global counter
 global_counter = 10;                            // Same as global_counter<@s> = 10 (defaults to @s)
+say "Player has $global_counter$ points";      // $global_counter$ defaults to <@s>
 
 // Function calls
 exec game:increment;                            // Execute function
@@ -693,6 +697,17 @@ Tokenized as:
 5. `RANGLE` (`>`)
 6. `DOLLAR` (`$`)
 
+#### **Shorthand (Default Scope)**
+```
+$player_score$
+```
+Tokenized as:
+1. `DOLLAR` (`$`)
+2. `IDENTIFIER` (`player_score`)
+3. `DOLLAR` (`$`)
+
+Note: When the scope is omitted, the parser defaults it to `<@s>` during AST construction.
+
 #### **Complex Substitution**
 ```
 $team_score<@a[team=red]>$

{minecraft_datapack_language-16.0.27 → minecraft_datapack_language-16.0.28}/minecraft_datapack_language/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '16.0.27'
-__version_tuple__ = version_tuple = (16, 0, 27)
+__version__ = version = '16.0.28'
+__version_tuple__ = version_tuple = (16, 0, 28)
 
-__commit_id__ = commit_id = 'gc8af8bfe9'
+__commit_id__ = commit_id = 'ge7a572b95'

{minecraft_datapack_language-16.0.27 → minecraft_datapack_language-16.0.28}/minecraft_datapack_language.egg-info/PKG-INFO

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

@@ -1,3 +0,0 @@
-current: "16.0.26"
-tag: "v16.0.26"
-updated_at: "2025-09-10T07:06:46Z"