v0.3.7

Full Changelog: v0.3.6...v0.3.7

v0.3.6

What's Changed

• Release v0.1.0 with MCS syntax diagnostics and autocomplete features by @SpyC0der77 in #14
• Update project configuration and documentation by @SpyC0der77 in #15

Full Changelog: v0.3.5...v0.3.6

v0.3.5

Summary

• Added contributor guide, release checklist, and scripts/check_release_versions.py
• CI now builds/packages the VS Code extension, checks release version alignment, and pins highlighter job action SHAs
• Published VS Code extension: Minecraft Script Language Support
• Fixed contributor docs (example compile path, build template version paths)

Install

pip install git+https://github.com/SpyC0der77/Minecraft-Script.git@v0.3.5
npm install -g minecraft-script@0.3.5

v0.3.4

What's changed

Configuration alignment

config set default_output_path now creates the directory if it does not exist, matching compile behavior. Paths that exist but are files still error.

CI

Added GitHub Actions workflow that runs pytest on Python 3.10 and 3.12, including compile tests for all examples in examples/.

Tests

• Added config path validation tests
• Added parametrized compile tests for all example .mcs files

Install

npm install -g minecraft-script@0.3.4

Or via pip:

pip install git+https://github.com/SpyC0der77/Minecraft-Script.git@v0.3.4

v0.3.3

What's changed

Declare Python dependencies in package metadata

pyproject.toml now lists pybars3>=0.9.7 as a runtime dependency, so pip install git+https://github.com/SpyC0der77/Minecraft-Script.git@v0.3.3 installs everything needed without a separate requirements.txt step.

Documentation housekeeping

• Marked data types documentation complete in todo.md
• Updated install docs to reference @v0.3.3

Install

npm install -g minecraft-script@0.3.3

Or via pip:

pip install git+https://github.com/SpyC0der77/Minecraft-Script.git@v0.3.3

v0.3.2

What's changed

Compile output path auto-creation

compile now creates the output directory (and any missing parent directories) when it doesn't exist yet. You no longer need to create the folder before compiling.

mcs compile examples/starter_datapack.mcs "My Pack" build_test/my_pack

Note: config set default_output_path still requires the path to exist when saving the setting.

Installation documentation

• README now documents GitHub-based Python install as the primary pip path (PyPI is not available for this fork)
• npm remains the recommended install method
• AGENTS.md updated with deployment guidance for contributors

Install

npm (recommended)

npm install -g minecraft-script@0.3.2

Python (from GitHub)

pip install git+https://github.com/SpyC0der77/Minecraft-Script.git@v0.3.2

Full changelog: v0.3.1...v0.3.2

v0.3.1

Overview

v0.3.1 is the first release under active maintenance of this fork. It adds multi-version Minecraft support, a VS Code extension, an npm CLI wrapper, imports, scoreboard events, text components, and a full test suite.

Install

npm (recommended)

npm install -g minecraft-script@0.3.1

Requires Python 3 and Git. Postinstall pulls the Python package from this repo.

Python (from GitHub)

pip install git+https://github.com/SpyC0der77/Minecraft-Script.git@v0.3.1

What's new since v0.2.2

CLI and distribution

• npm wrapper — install globally with npm install -g minecraft-script; use mcs or minecraft-script on your PATH
• GitHub-based Python install — no PyPI dependency; pip installs directly from tagged releases
• Config improvements — config set default_output_path, verbose option, and config default to reset settings
• Cross-platform path handling — improved support on Windows, macOS, and Linux

Minecraft version support

• Version profiles from 1.21.2 through 26.1 with config set minecraft_version <version>
• Handlebars-based command templates per version
• Breaking-changes acknowledgment when switching versions

Language features

• Imports — split code across multiple .mcs files
• Scoreboard event functions — function name() on "minecraft.mined:..." syntax
• Text components — text() builder with colors, formatting, click/hover events
• Version profile orchestration — compiler adapts datapack layout and commands per game version

VS Code extension (highlighter/)

• Syntax highlighting for .mcs files
• Hover help for keywords, builtins, selectors, and text component methods
• Command linting, hover, and autocompletion inside command("...") strings via Spyglass
• Selectable Minecraft version for command validation

Documentation and examples

• Completed syntax documentation (conditionals, loops, operations, entity selection)
• Data types reference (strings, numbers, booleans, lists, functions, text components)
• Built-in functions reference with click event details
• New example scripts (imports, scoreboard events, raycast, rich text, clickable items)
• Contributor guide for adding new Minecraft versions

Quality

• Test suite with compile, import, and version profile coverage
• Compiler fixes for kill function storage cleanup, entity selectors, and Handlebars escaping
• macOS terminal color and platform support fixes

Usage

mcs compile path/to/file.mcs
mcs debug path/to/file.mcs
mcs help

See the README and documentation for full details.