开源软件名称（OpenSource Name）：

开源软件地址(OpenSource Url)：

开源编程语言(OpenSource Language)：

开源软件介绍(OpenSource Introduction)：

Notice

Mojang has deprecated the bedrock scripting API in favour of the GameTest API. This repository has been archived as a a result.

minecraft-addon-toolchain

Helps with some common tasks when building a minecraft mod for Bedrock edition:

• builds .mcpack and .mcaddon packages
• installs the mod into Minecraft for Windows 10's development folders
• watches for file changes and reinstalls as necessary
• has extension points to do transpilation

Prerequisites

Scripting in Minecraft is currently only officially supported on Windows 10 Bedrock Edition Beta, however there have been reports that users have been able to use alternative launchers to get scripting working on other platforms, and although the toolchain attempts to support Linux, Mac OS and Android, they are currently untested and support for these platforms is limited. (I am happy to take PRs to improve the experience)

Getting the Bedrock Edition Beta

Mojang provides instructions on how to get into the Beta program here: How to get into Minecraft betas

Getting Started

Ensure you have a package.json file present in your development directory, if you do not, you can create a minimal valid package with the following contents:

{
	"private": true
}

install the package (It's not currently available on NPM, you'll have to use the Github repository)

npm install --save-dev minecraft-addon-toolchain

This will automatically install gulp vNext (4.0.0)

Create a gulpfile.js gulp configuration

use the following as a template for your gulpfile.js, replacing <youraddonname> with the name of your mod, which will be used on the filesystem to identify your mod

const MinecraftAddonBuilder = require("minecraft-addon-toolchain/v1");

const builder = new MinecraftAddonBuilder(<youraddonname>);
module.exports = modBuilder.configureEverythingForMe();

The MinecraftAddonBuilder object can be used to create your own tasks, but the default tasks configured by configureEverythingForMe() should be sufficient for simple addons.

Next, update your package.json with appropriate scripts, here are some useful scripts

  "scripts": {
    "build": "gulp build",
    "installaddon": "gulp install",
    "rebuild": "gulp rebuild",
    "watch": "gulp watch"
  },

• use npm run build to create the directory structure for a .mcaddon
• use npm run installaddon to install the addon into Minecraft for Windows 10
• use npm run rebuild to clean the build directory and rebuild it
• use npm run watch to:
  • build the project
  • deploy it to to Minecraft for Windows 10
  • monitor for changes on the filesystem
    • automatically rebuilds and deploys the project.

Conventions

These scripts will assume a certain directory structure by default. These can be overridden by altering properties on the MinecraftModBuilder object in your gulpfile.js.

an example of changing the build directory would look something like this:

const MinecraftAddonBuilder = require("minecraft-addon-toolchain/v1");

const builder = new MinecraftAddonBuilder(<youraddonname>);
builder.bundleDir = "./bundle";
builder.packageDir = "./package";

Using plugins

We provide the following plugins.

Because plugins insert themselves into the toolchain, their order is dependent. Refer to their individual read me files for installation and usage.