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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minecraft-datapack-language
-Version: 16.0.26
+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.26 → 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.26 → 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.26'
-__version_tuple__ = version_tuple = (16, 0, 26)
+__version__ = version = '16.0.28'
+__version_tuple__ = version_tuple = (16, 0, 28)
 
-__commit_id__ = commit_id = 'g9a52e12bd'
+__commit_id__ = commit_id = 'ge7a572b95'

{minecraft_datapack_language-16.0.26 → minecraft_datapack_language-16.0.28}/minecraft_datapack_language/mdl_compiler.py

@@ -463,10 +463,15 @@ class MDLCompiler:
         current_pos = 0
         
         for var in variables:
-            var_pattern = f"${var.name}{var.scope}$"
-            var_pos = message.find(var_pattern, current_pos)
-            
-            if var_pos != -1:
+            # Support both $name<scope>$ and $name$ forms; parser already defaults scope to <@s>
+            with_scope = f"${var.name}{var.scope}$"
+            no_scope = f"${var.name}$"
+            pos_with = message.find(with_scope, current_pos)
+            pos_no = message.find(no_scope, current_pos)
+            # Choose the earliest valid occurrence >= current_pos
+            candidates = [p for p in [pos_with, pos_no] if p != -1]
+            if candidates:
+                var_pos = min(candidates)
                 if var_pos > current_pos:
                     text_before = message[current_pos:var_pos]
                     parts.append(f'{{"text":"{text_before}"}}')
@@ -475,7 +480,11 @@ class MDLCompiler:
                 scope = self._resolve_scope(var.scope)
                 parts.append(f'{{"score":{{"name":"{scope}","objective":"{objective}"}}}}')
                 
-                current_pos = var_pos + len(var_pattern)
+                # Advance past whichever token we matched
+                if var_pos == pos_with:
+                    current_pos = var_pos + len(with_scope)
+                else:
+                    current_pos = var_pos + len(no_scope)
         
         if current_pos < len(message):
             text_after = message[current_pos:]

{minecraft_datapack_language-16.0.26 → minecraft_datapack_language-16.0.28}/minecraft_datapack_language/mdl_parser.py

@@ -181,14 +181,17 @@ class MDLParser:
                        "Use: recipe, loot_table, advancement, item_modifier, predicate, or structure")
     
     def _parse_variable_declaration(self) -> VariableDeclaration:
-        """Parse variable declaration: var num name<scope> = value;"""
+        """Parse variable declaration: var num name<scope?> = value; defaults to <@s>."""
         self._expect(TokenType.VAR, "Expected 'var' keyword")
         
         self._expect(TokenType.NUM, "Expected 'num' keyword")
         
         name = self._expect_identifier("Expected variable name")
-        
-        scope = self._parse_scope_selector()
+        # Optional scope selector; default to <@s>
+        if self._peek().type == TokenType.LANGLE:
+            scope = self._parse_scope_selector()
+        else:
+            scope = "<@s>"
         
         self._expect(TokenType.ASSIGN, "Expected '=' after variable declaration")
         
@@ -204,10 +207,14 @@ class MDLParser:
         )
     
     def _parse_variable_assignment(self) -> VariableAssignment:
-        """Parse variable assignment: name<scope> = value;"""
+        """Parse variable assignment: name<scope?> = value; defaults to <@s>."""
         name = self._expect_identifier("Expected variable name")
         
-        scope = self._parse_scope_selector()
+        # Optional scope selector; default to <@s>
+        if self._peek().type == TokenType.LANGLE:
+            scope = self._parse_scope_selector()
+        else:
+            scope = "<@s>"
         
         self._expect(TokenType.ASSIGN, "Expected '=' after variable name")
         
@@ -423,17 +430,12 @@ class MDLParser:
         
         # Extract variables from the message content
         variables = []
-        # Simple regex-like extraction of $variable<scope>$ patterns
+        # Support both $var<scope>$ and $var$
         import re
-        var_pattern = r'\$([a-zA-Z_][a-zA-Z0-9_]*<[^>]+>)\$'
-        matches = re.findall(var_pattern, message)
-        
-        for match in matches:
-            # Parse the variable name and scope from the match
-            if '<' in match and '>' in match:
-                name = match[:match.index('<')]
-                scope = match[match.index('<'):match.index('>')+1]
-                variables.append(VariableSubstitution(name=name, scope=scope))
+        for m in re.finditer(r'\$([a-zA-Z_][a-zA-Z0-9_]*)(<[^>]+>)?\$', message):
+            name = m.group(1)
+            scope = m.group(2) if m.group(2) else "<@s>"
+            variables.append(VariableSubstitution(name=name, scope=scope))
         
         self._expect(TokenType.QUOTE, "Expected closing quote for say message")
         self._expect(TokenType.SEMICOLON, "Expected semicolon after say command")
@@ -441,23 +443,23 @@ class MDLParser:
         return SayCommand(message=message, variables=variables)
     
     def _parse_variable_substitution(self) -> VariableSubstitution:
-        """Parse variable substitution: $variable<scope>$"""
+        """Parse variable substitution: $variable<scope?>$; defaults to <@s>."""
         self._expect(TokenType.DOLLAR, "Expected '$' to start variable substitution")
         
         name = self._expect_identifier("Expected variable name")
         
-        # For variable substitutions, use LANGLE/RANGLE
-        self._expect(TokenType.LANGLE, "Expected '<' for scope selector")
-        
-        # Parse the selector content
-        selector_content = ""
-        while not self._is_at_end() and self._peek().type != TokenType.RANGLE:
-            selector_content += self._peek().value
-            self._advance()
-        
-        self._expect(TokenType.RANGLE, "Expected '>' to close scope selector")
-        
-        scope = f"<{selector_content}>"
+        # Optional scope selector; if absent, default to <@s>
+        if self._peek().type == TokenType.LANGLE:
+            # Parse the selector content
+            self._advance()  # consume '<'
+            selector_content = ""
+            while not self._is_at_end() and self._peek().type != TokenType.RANGLE:
+                selector_content += self._peek().value
+                self._advance()
+            self._expect(TokenType.RANGLE, "Expected '>' to close scope selector")
+            scope = f"<{selector_content}>"
+        else:
+            scope = "<@s>"
         
         self._expect(TokenType.DOLLAR, "Expected '$' to end variable substitution")
         

{minecraft_datapack_language-16.0.26 → 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.26
+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.26 → minecraft_datapack_language-16.0.28}/tests/test_codegen_naming_and_logic.py

@@ -18,9 +18,9 @@ def test_generated_if_function_names_unique_per_parent():
     src = (
         'pack "ns" "desc" 82;\n'
         'namespace "ns";\n'
-        'var num a<@s> = 0;\n'
-        'function ns:f1 { if $a<@s>$ > 1 { say "hi"; } }\n'
-        'function ns:f2 { if $a<@s>$ > 1 { say "hi2"; } }\n'
+        'var num a = 0;\n'  # default to <@s>
+        'function ns:f1 { if $a$ > 1 { say "hi"; } }\n'
+        'function ns:f2 { if $a$ > 1 { say "hi2"; } }\n'
     )
     out, tmp = compile_source(src)
     func_dir = out / 'data' / 'ns' / 'function'
@@ -39,8 +39,8 @@ def test_while_loop_generates_recursive_function_and_condition():
     src = (
         'pack "ns" "desc" 82;\n'
         'namespace "ns";\n'
-        'var num c<@s> = 0;\n'
-        'function ns:loop { while $c<@s>$ < 3 { c<@s> = $c<@s>$ + 1; } }\n'
+        'var num c = 0;\n'
+        'function ns:loop { while $c$ < 3 { c = $c$ + 1; } }\n'
     )
     out, tmp = compile_source(src)
     func_dir = out / 'data' / 'ns' / 'function'
@@ -58,9 +58,9 @@ def test_complex_expression_temp_operations_present():
     src = (
         'pack "ns" "desc" 82;\n'
         'namespace "ns";\n'
-        'var num x<@s> = 2;\n'
-        'var num y<@s> = 3;\n'
-        'function ns:math { x<@s> = ($x<@s>$ + 5) * ($y<@s>$ - 1) / 2; }\n'
+        'var num x = 2;\n'
+        'var num y = 3;\n'
+        'function ns:math { x = ($x$ + 5) * ($y$ - 1) / 2; }\n'
     )
     out, tmp = compile_source(src)
     func_dir = out / 'data' / 'ns' / 'function'
@@ -79,8 +79,8 @@ def test_else_branch_written_separately():
     src = (
         'pack "ns" "desc" 82;\n'
         'namespace "ns";\n'
-        'var num a<@s> = 0;\n'
-        'function ns:f { if $a<@s>$ > 1 { say "high"; } else { say "low"; } }\n'
+        'var num a = 0;\n'
+        'function ns:f { if $a$ > 1 { say "high"; } else { say "low"; } }\n'
     )
     out, tmp = compile_source(src)
     func_dir = out / 'data' / 'ns' / 'function'

minecraft_datapack_language-16.0.26/docs/_data/version.yml

@@ -1,3 +0,0 @@
-current: "16.0.25"
-tag: "v16.0.25"
-updated_at: "2025-09-10T07:02:50Z"