Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

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.