minecraft-datapack-language 15.4.21__py3-none-any.whl → 15.4.22__py3-none-any.whl

minecraft_datapack_language/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '15.4.21'
-__version_tuple__ = version_tuple = (15, 4, 21)
+__version__ = version = '15.4.22'
+__version_tuple__ = version_tuple = (15, 4, 22)
 
 __commit_id__ = commit_id = None

minecraft_datapack_language/cli_help.py

@@ -142,6 +142,32 @@ def show_build_help():
     print(f"5. Build multiple files in a directory:")
     print(f"   {color.code('mdl build --mdl examples/ -o output --verbose')}")
     print()
+
+    # Advanced Features
+    print_section("Advanced Features")
+    print()
+    print(color.info("MDL supports advanced features including explicit scopes in conditions:"))
+    print()
+    print(f"  {color.code('// Variables with different scopes')}")
+    print(f"  {color.code('var num playerScore = 0;                    // Defaults to @s')}")
+    print(f"  {color.code('var num globalCounter scope<global> = 0;    // Global scope')}")
+    print(f"  {color.code('var num teamScore scope<@a[team=red]> = 0;  // Team scope')}")
+    print()
+    print(f"  {color.code('// Use explicit scopes in conditions')}")
+    print(f"  {color.code('if \"$playerScore<@s>$ > 10\" {{')}")
+    print(f"  {color.code('    say \"Current player score is high!\";')}")
+    print(f"  {color.code('}')}")
+    print()
+    print(f"  {color.code('if \"$globalCounter<global>$ > 100\" {{')}")
+    print(f"  {color.code('    say \"Global counter reached milestone!\";')}")
+    print(f"  {color.code('}')}")
+    print()
+    print(f"  {color.code('if \"$teamScore<@a[team=red]>$ > 50\" {{')}")
+    print(f"  {color.code('    say \"Red team is winning!\";')}")
+    print(f"  {color.code('}')}")
+    print()
+    print(color.info("This allows you to check variables across different scopes without changing their declared scope."))
+    print()
     
     # Output Structure
     print_section("Output Structure")

{minecraft_datapack_language-15.4.21.dist-info → minecraft_datapack_language-15.4.22.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minecraft-datapack-language
-Version: 15.4.21
+Version: 15.4.22
 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
@@ -477,6 +477,90 @@ This will create a datapack with:
 
 ---
 
+## 🎯 **Explicit Scope System**
+
+MDL features a powerful **explicit scope system** that makes variable access clear and unambiguous. Each variable access must specify its scope, eliminating hidden state and making code more readable.
+
+### **Variable Declaration Scopes**
+
+```mdl
+// Player-specific variable (defaults to @s in execution context)
+var num playerScore = 0;
+
+// Server-wide variable (stored on server armor stand)
+var num globalCounter scope<global> = 0;
+
+// Team-specific variable
+var num teamScore scope<@a[team=red]> = 0;
+
+// Custom entity variable
+var num entityData scope<@e[type=armor_stand,tag=special,limit=1]> = 0;
+```
+
+### **Variable Access with Explicit Scopes**
+
+```mdl
+// Each variable access must specify the scope
+playerScore<@s> = 42;                    // Player scope
+globalCounter<global> = 100;             // Global scope
+teamScore<@a[team=red]> = 5;            // Team scope
+entityData<@e[type=armor_stand,tag=special,limit=1]> = 10; // Custom entity
+```
+
+### **Explicit Scopes in Conditions**
+
+**NEW!** MDL now supports explicit scope selectors in if/while conditions, allowing you to override declared variable scopes:
+
+```mdl
+function "check_scores" {
+    // Check current player's score
+    if "$playerScore<@s>$ > 10" {
+        say "Your score is high!";
+    }
+    
+    // Check global counter
+    if "$globalCounter<global>$ > 100" {
+        say "Global milestone reached!";
+    }
+    
+    // Check another player's score
+    if "$playerScore<@p[name=Steve]>$ > 20" {
+        say "Steve has a good score!";
+    }
+    
+    // Check team score
+    if "$teamScore<@a[team=red]>$ > 50" {
+        say "Red team is winning!";
+    }
+    
+    // Use explicit scopes in while loops too
+    while "$globalCounter<global>$ < 10" {
+        globalCounter<global> = globalCounter<global> + 1;
+        say "Counter: $globalCounter$";
+    }
+}
+```
+
+**Benefits:**
+- **Override declared scopes**: Use different scopes than what was declared
+- **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
+
+### **Scope Mapping**
+
+MDL maps scopes to Minecraft selectors:
+
+| MDL Scope | Minecraft Selector | Description |
+|-----------|-------------------|-------------|
+| `scope<global>` | `@e[type=armor_stand,tag=mdl_server,limit=1]` | Server-wide storage |
+| `scope<@s>` | `@s` | Current player |
+| `scope<@a>` | `@a` | All players |
+| `scope<@a[team=red]>` | `@a[team=red]` | Red team players |
+| `scope<@e[type=armor_stand,tag=something,limit=1]>` | `@e[type=armor_stand,tag=something,limit=1]` | Custom entity |
+
+---
+
 ## 🎯 **Advanced Multi-File Examples with Namespaces**
 
 ### **Modern Namespace System**

{minecraft_datapack_language-15.4.21.dist-info → minecraft_datapack_language-15.4.22.dist-info}/RECORD

@@ -1,11 +1,11 @@
 minecraft_datapack_language/__init__.py,sha256=i-qCchbe5b2Fshgc6yCU9mddOLs2UBt9SAcLqfUIrT0,606
-minecraft_datapack_language/_version.py,sha256=UOCaFCMuBKEzZuLZKqrQpMf_Fgz3oXnIRu-he6qYSek,708
+minecraft_datapack_language/_version.py,sha256=I5Cwge3f4scENDCmJvK0lfCv7rpZtkezUcsloKsVRQo,708
 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=u0XIOH_zTARPC6dvWf-411OqrF7RjT7Z9Hkp6hTeZsI,47990
 minecraft_datapack_language/cli_check.py,sha256=bPq9gHsxQ1CIiftkrAtRCifWkVAyjp5c8Oay2NNQ1qs,6277
 minecraft_datapack_language/cli_colors.py,sha256=Hr8awY966bGSnVdXL3WnmRhSP1wH56vTQKGt5z-kIQM,7878
-minecraft_datapack_language/cli_help.py,sha256=170MePwG9dV9IowG02SwiRT04fbrEo8FBuREZNwDhXY,20051
+minecraft_datapack_language/cli_help.py,sha256=Rc-v9E2kctsdN_lMunqdKuZ8EZ8rcZIjBCOPrXLBQeE,21363
 minecraft_datapack_language/cli_new.py,sha256=_pj5EeXESAG00C80_os9jONIXAMcsu2eoR8xVJWDw6g,9347
 minecraft_datapack_language/cli_utils.py,sha256=qzba7BRHFK9AliSgSLGtxA0p2_Y-Rm20ysDzLLz_KD4,10632
 minecraft_datapack_language/dir_map.py,sha256=HmxFkuvWGkzHF8o_GFb4BpuMCRc6QMw8UbmcAI8JVdY,1788
@@ -17,9 +17,9 @@ minecraft_datapack_language/mdl_linter.py,sha256=z85xoAglENurCh30bR7kEHZ_JeMxcYa
 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=Aq0HAGlXqj9BUTEjaEilpvzEW0EtZYYMMwOqG9db6dE,684
-minecraft_datapack_language-15.4.21.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-minecraft_datapack_language-15.4.21.dist-info/METADATA,sha256=mgbuo3_xIVmGi54rRh0IGeS1Oh4aLfbAjtM2b87KUEI,35230
-minecraft_datapack_language-15.4.21.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-minecraft_datapack_language-15.4.21.dist-info/entry_points.txt,sha256=c6vjBeCiyQflvPHBRyBk2nJCSfYt3Oc7Sc9V87ySi_U,108
-minecraft_datapack_language-15.4.21.dist-info/top_level.txt,sha256=ADtFI476tbKLLxEAA-aJQAfg53MA3k_DOb0KTFiggfw,28
-minecraft_datapack_language-15.4.21.dist-info/RECORD,,
+minecraft_datapack_language-15.4.22.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+minecraft_datapack_language-15.4.22.dist-info/METADATA,sha256=elLshh43YF1-sNZck0fCVtlNNckjMrLWalSD4X4etYE,37917
+minecraft_datapack_language-15.4.22.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+minecraft_datapack_language-15.4.22.dist-info/entry_points.txt,sha256=c6vjBeCiyQflvPHBRyBk2nJCSfYt3Oc7Sc9V87ySi_U,108
+minecraft_datapack_language-15.4.22.dist-info/top_level.txt,sha256=ADtFI476tbKLLxEAA-aJQAfg53MA3k_DOb0KTFiggfw,28
+minecraft_datapack_language-15.4.22.dist-info/RECORD,,