ShulkerScript Language

ShulkerScript is a simple, easy-to-use scripting language for Minecraft datapacks. It is designed to be easy to learn and use, while still being powerful enough to create complex scripts, while not being hindered by Minecraft command limitations.

Usage

Add the following to your dependencies in Cargo.toml:

[dependencies]
shulkerscript-lang = { git = "https://github.com/moritz-hoelting/shulkerscript-lang" }

Features

Functions

#[load]
fn load() {
    /say Loaded!
    hello();
}

fn hello() {
    /say Hello, world!
}

Execute blocks

as("@a") { // execute as all players
    /say Hello, 
    /say world!
}

Chained execute blocks are also supported:

as("@a"), at("@s") { // execute as all players at the executing entity
    /setblock ~ ~ ~ minecraft:diamond_block
}

Conditionals

if("@s[tag=foo]" && "block ~ ~-1 ~ minecraft:stone") { // if the executing entity has the tag "foo" and is standing on stone
    /tag @s remove foo
    /say Hello, foo!
} else {
    /say Hello, world!
}

Unlike in mcfunction files, the actions in the conditional blocks are atomic, meaning that once the condition is fullfilled the actions are executed even after the condition is no longer fullfilled (in this case the "foo" tag has been removed).

Lua scripting

run lua() {
    -- Lua code goes here
    return "Hello, Lua!";
};

Full Grammar

The full grammar can be found here.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

Note that this repository only contains the parser and transpiler to a secondary representation. The compilation to a Minecraft datapack is located in the shulkerbox repository. Please indicate if pull requests for this repository require pull requests for the shulkerbox repository