minecraft-datapack-language 17.0.11__py3-none-any.whl → 17.0.12__py3-none-any.whl

minecraft_datapack_language/_embedded/docs/_data/version.yml

@@ -1,3 +1,3 @@
-current: "17.0.9"
-tag: "v17.0.9"
-updated_at: "2025-09-10T08:38:33Z"
+current: "17.0.10"
+tag: "v17.0.10"
+updated_at: "2025-09-10T23:56:34Z"

minecraft_datapack_language/_embedded/docs/_docs/cli-reference.md

@@ -124,16 +124,24 @@ mdl new adventure_map
 mdl new projects/survival_plus
 ```
 
-**What it creates:**
-The new command generates a minimal project structure with:
+**What it creates (by default):**
+The new command generates a project structure with:
 - `README.md` - Quick start with build instructions
 - `main.mdl` - Hello world (pack, namespace, simple function, on_load)
+- `docs/` - A literal copy of the MDL documentation for offline/local browsing
+- `serve_docs.sh` and `serve_docs.ps1` - Convenience scripts to serve docs locally
 
-**Generated project structure:**
+**Generated project structure (default):**
 ```
 my_awesome_pack/
 ├── README.md
-└── main.mdl
+├── main.mdl
+├── docs/
+│   ├── index.md
+│   ├── _config.yml
+│   └── ...
+├── serve_docs.sh
+└── serve_docs.ps1
 ```
 
 **Template content includes:**
@@ -167,6 +175,46 @@ my_awesome_pack/
 | Option | Description | Example |
 |--------|-------------|---------|
 | `<project_name>` | Name of the new project to create | `mdl new my_pack` |
+| `--pack-name <name>` | Override datapack name used in `pack.mcmeta` | `--pack-name Adventure` |
+| `--pack-format <num>` | Pack format number (defaults to modern value) | `--pack-format 82` |
+| `--output <dir>` | Directory to create the project in | `--output ./projects` |
+| `--exclude-local-docs` | Do not copy the MDL docs into `docs/` | `--exclude-local-docs` |
+
+By default, `mdl new` includes a full `docs/` folder in your project so new users have local docs offline. Use `--exclude-local-docs` to skip this step.
+
+Serve the docs quickly with the generated scripts:
+
+```bash
+# Bash/Git Bash
+./serve_docs.sh
+
+# PowerShell
+./serve_docs.ps1
+```
+
+Both scripts prefer Jekyll (if `bundle` and a `Gemfile` are present), otherwise they fall back to a simple Python web server.
+
+You can also serve docs via the CLI:
+
+```bash
+mdl docs serve --dir docs --port 8000
+```
+
+This starts a local web server for the `docs/` directory.
+
+## Completion Command
+
+Install shell autocompletion so you can type `mdl bui<Tab>` and get `build`:
+
+```bash
+mdl completion install           # auto-detects your shell
+mdl completion install bash      # explicit shell
+mdl completion uninstall zsh     # remove
+mdl completion print fish        # print script for manual use/CI
+mdl completion doctor            # basic diagnostics
+```
+
+Supported shells: Bash (incl. Git Bash), Zsh, Fish, and PowerShell.
 
 ## Error Handling
 

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.11'
-__version_tuple__ = version_tuple = (17, 0, 11)
+__version__ = version = '17.0.12'
+__version_tuple__ = version_tuple = (17, 0, 12)
 
 __commit_id__ = commit_id = None

{minecraft_datapack_language-17.0.11.dist-info → minecraft_datapack_language-17.0.12.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minecraft-datapack-language
-Version: 17.0.11
+Version: 17.0.12
 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.11.dist-info → minecraft_datapack_language-17.0.12.dist-info}/RECORD

@@ -1,5 +1,5 @@
 minecraft_datapack_language/__init__.py,sha256=0KVXBE4ScRaRUrf83aA2tVB-y8A_jplyaxVvtHH6Uw0,1199
-minecraft_datapack_language/_version.py,sha256=8ckCnInAFi-5Xj8S-SCDDxMtN9E-SVkv2R6UOjGlqfA,708
+minecraft_datapack_language/_version.py,sha256=Na0c13EH4pNVBGzO7cGMn_hnIJYj2hp5GRQbBpTRUYk,708
 minecraft_datapack_language/ast_nodes.py,sha256=L5izavSeXDr766vsfRvJrcnflXNJyXcy0WSfyJPq2ZA,4484
 minecraft_datapack_language/cli.py,sha256=S5Lbv7c5U3osy1S-pYoRH8J5fu2KaTTWCoo2YcKhDaI,22610
 minecraft_datapack_language/dir_map.py,sha256=HmxFkuvWGkzHF8o_GFb4BpuMCRc6QMw8UbmcAI8JVdY,1788
@@ -17,8 +17,8 @@ minecraft_datapack_language/_embedded/docs/_config.yml,sha256=wx1F7KonP5t0fvF8ow
 minecraft_datapack_language/_embedded/docs/docs.md,sha256=odOG-EryTrvQFaAEbcqEbtqmPVR1xzQQf5Yc0S0zwFY,4042
 minecraft_datapack_language/_embedded/docs/downloads.md,sha256=Lp4ShcqCuDoGypswm5sGYORCOYVwGDmVLEz-5NyKndQ,10250
 minecraft_datapack_language/_embedded/docs/index.md,sha256=lyUqzvaeQhTZdir_6lpEMExWBUFlLcti7KoJVzQ_57Q,9855
-minecraft_datapack_language/_embedded/docs/_data/version.yml,sha256=a9WxWdWcGBQW-to67rk2Jcp4u38YMoIrWEI067b2HOI,68
-minecraft_datapack_language/_embedded/docs/_docs/cli-reference.md,sha256=BX-4klR7eBWpVa2du1OHJo4XzZffRl7e1ROOQJ8JobE,10230
+minecraft_datapack_language/_embedded/docs/_data/version.yml,sha256=DDmR8TgMb5RDCkwdjH2XPY8qWBnLIz7xICCVa6XviW0,70
+minecraft_datapack_language/_embedded/docs/_docs/cli-reference.md,sha256=yrZW8pp6T124XCUKuG-59S5YDY0WevaIQ7SwfXQ_Irw,11922
 minecraft_datapack_language/_embedded/docs/_docs/contributing.md,sha256=Qs-AHky6G9P4L0siMg3l9dAO8I8AzSGW-htEaM_C-Gg,9434
 minecraft_datapack_language/_embedded/docs/_docs/docs-hub.md,sha256=b0oyaoYkEeKOjG2bRWm4MUnrd03tznKPcECIkhS1sUw,7464
 minecraft_datapack_language/_embedded/docs/_docs/documentation.md,sha256=zVpFf5X-fLAd7QDOK5x4Nk546vgJr7dw5XGyXCrUw5w,4074
@@ -48,9 +48,9 @@ minecraft_datapack_language/completions/mdl.bash,sha256=mlRdQ1PwoFwl7Fw5j7u0mhsN
 minecraft_datapack_language/completions/mdl.fish,sha256=ReWjaqUwjQni-hUZfVQG2CsI5fE7uJpoywiKrQhtcFw,1923
 minecraft_datapack_language/completions/mdl.ps1,sha256=b2A1sFCtY23sv1-LILhPu0lphnZqzVjl__AtvCUMWtU,1744
 minecraft_datapack_language/completions/mdl.zsh,sha256=Pdx6yuSFaK2-UIsriVoJJacuWnw2f9DOWrVhPJLBAwo,633
-minecraft_datapack_language-17.0.11.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-minecraft_datapack_language-17.0.11.dist-info/METADATA,sha256=YUKQ2ZRJQ8Juh1DTJHUe6UYjDFaFSbofTOBW6v7Ehko,8418
-minecraft_datapack_language-17.0.11.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-minecraft_datapack_language-17.0.11.dist-info/entry_points.txt,sha256=c6vjBeCiyQflvPHBRyBk2nJCSfYt3Oc7Sc9V87ySi_U,108
-minecraft_datapack_language-17.0.11.dist-info/top_level.txt,sha256=ADtFI476tbKLLxEAA-aJQAfg53MA3k_DOb0KTFiggfw,28
-minecraft_datapack_language-17.0.11.dist-info/RECORD,,
+minecraft_datapack_language-17.0.12.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+minecraft_datapack_language-17.0.12.dist-info/METADATA,sha256=PhapTzt91Pa30EkUz0SYKIrU8xq3O1oPk6tT4mCN1is,8418
+minecraft_datapack_language-17.0.12.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+minecraft_datapack_language-17.0.12.dist-info/entry_points.txt,sha256=c6vjBeCiyQflvPHBRyBk2nJCSfYt3Oc7Sc9V87ySi_U,108
+minecraft_datapack_language-17.0.12.dist-info/top_level.txt,sha256=ADtFI476tbKLLxEAA-aJQAfg53MA3k_DOb0KTFiggfw,28
+minecraft_datapack_language-17.0.12.dist-info/RECORD,,