Shulkerscript
shulkerscript.hoelting.dev
- Windows
- macOS
- Linux
- Web
- Browser extension
What Shulkerscript is
Shulkerscript is a free, open-source scripting language and command-line tool for creating Minecraft data packs. Its programming-style syntax extends beyond .mcfunction files, allowing one source file to produce multiple function files callable from Minecraft or other Shulkerscript files. The language supports functions, imports, tags, conditionals, execute blocks, groupings, literal commands and embedded Lua. Functions marked #[tick] can run every tick, while #[load] functions run when a data pack loads. The CLI compiles projects into a dist directory, watches files for automatic rebuilds and can create ZIP archives. An online playground works in a browser, and an optional Visual Studio Code extension provides syntax highlighting and snippets. Installation guidance covers Windows, Linux and macOS, with GitHub releases, cargo-binstall or Rust and Cargo builds. The documentation labels the playground and Lua integration as works in progress.
Who it suits
Shulkerscript suits Minecraft data-pack creators who want a programming-language workflow, generated function files and command-line project builds. It also fits users preferring browser experimentation or Visual Studio Code integration.
Good to know, and what to watch
- Free and open source
- Generates multiple function files from one source
- CLI watches files and builds projects
- Browser playground requires no installation
- Supports ZIP distribution of compiled projects
- Playground is marked work in progress
- Lua integration is marked work in progress
- Missing required annotations produce no .mcfunction files
- Installation from source requires Rust and Cargo
The verdict
Shulkerscript adds structured language features and build tooling to Minecraft data-pack development. Its annotation requirement and work-in-progress areas are important considerations when planning projects.
What the maker publishes
- Availability
- The guide offers installation from GitHub releases, installation with cargo-binstall, or building from source with Rust and Cargo. source
- Build and distribution
- The CLI can build projects into a `dist` directory, watch for file changes, and create a ZIP archive of a compiled project. source
- CLI installation
- The CLI can be installed with a quickinstall script, cargo-binstall, a GitHub release, or by building from source with Rust and Cargo. source
- Compilation
- The Shulkerscript CLI compiles project files into a `dist` directory and can watch for file changes to rebuild automatically. source
- Compiler
- The project says it is written in Rust and describes fast compile times and a small binary size. source
- Contributing
- The project invites contributions to its CLI and compiler repositories on GitHub. source
- Distribution
- The CLI can create a ZIP archive of a compiled project with `shulkerscript build --zip`. source
- Editor integration
- An optional official Visual Studio Code extension provides syntax highlighting and snippets. source
- Editor integration
- The official Visual Studio Code extension provides syntax highlighting and snippets for Shulkerscript files. source
- Functions
- A single source file can generate multiple function files that can be called from Minecraft or other Shulkerscript files. source
- Functions
- A single source file can generate multiple function files that can be called from Minecraft or other Shulkerscript files. source
- Install platforms
- The installation guide provides instructions for Windows, Linux, and macOS. source
- Language features
- The language supports functions, imports, tags, conditionals, execute blocks, groupings, literal commands, and embedded Lua code. source
- Language features
- The language supports functions, imports, tags, conditional statements, execute blocks, and Lua code embedded in scripts. source
- Lua integration status
- The documentation labels its Lua Integration reference as work in progress. source
- Minecraft-specific behavior
- Functions annotated with `#[tick]` can run every tick, and functions annotated with `#[load]` can run when a data pack is loaded. source
- Output limitation
- The syntax guide says at least one function must be annotated with `tick`, `load`, or `deobfuscate`, or no `.mcfunction` files will be generated. source
- Packaging limit
- At least one function must have a `tick`, `load`, or `deobfuscate` annotation for `.mcfunction` files to be generated. source
- Playground
- An online playground lets users try Shulkerscript in a browser without installing it. source
- Playground
- An online playground lets users try Shulkerscript in a browser without installing the CLI. source
- Project maturity
- The documentation labels the playground and Lua integration as work in progress. source
- Project setup
- Running `shulkerscript init` creates a project containing a `src` directory, `pack.toml`, and other starter files. source
- Purpose
- Shulkerscript is a scripting language and CLI for creating Minecraft data packs. source
- Purpose
- Shulkerscript is a language for writing Minecraft datapacks, with syntax similar to other programming languages and features beyond `.mcfunction` files. source
Checked against the maker's pages on 7 Oct 2026.