Skip to main content




All snippets of this documentation can be edited, and you can preview the resulting data pack. If you want to quickly see what Sandstone can offer, there is no need to install anything. Just edit the snippets, and see the results in live.

If you want to use Sandstone to create data packs, a local installation will be necessary.

The first step is to install Node.js.

I recommend installing a third-party package manager such as pnpm, as the included one in Node is slow & takes up lots of space.

You will then need a code editor: I personally recommend Visual Studio Code.

Create an empty folder named "Sandstone Projects": it will contain all your future Sandstone projects. Inside this folder, open a terminal then run the following commands:

pnpm i -g sandstone-cli
sand create <my-project>

Replace <my-project> with your project's name. It will only be the name of the project folder, not the name of the data pack.

Example: sand create my-first-sandstone-project

Answer the different questions. Congratulations, you created your first Sandstone project!

To build the data pack, run the following command:

sand build

The downside of build is that it only builds your data pack once. To build then rebuild on each change, run watch instead:

sand watch