Plugin
Creating a plugin
Plugins consist of a Javascript file. To create a plugin, create a new Javascript file named [plugin-id].js
. Inside this file, use the method Plugin.register to initialize the plugin, as seen in the example.
NOTE: the plugin ID must be the same as the file name minus extension.
Plugin.register('plugin_id', {
title: 'Plugin Name',
author: 'Your Name',
icon: 'icon',
description: 'Your Description',
version: '1.0.0',
variant: 'both',
onload() {
}
});
title: String
Plugin title as shown in the store in Blockbenchauthor: String
Author name or namesdescription: String
Plugin description for the store in Blockbenchabout: String
Longer Plugin description or instructions, can be unfolded in the storeicon: String
Blockbench icon string, see Blockbench#iconsversion: String
Version number for your plugin using semvervariant: String
Variant of Blockbench which supports your plugin. Can bedesktop
,web
orboth
min_version: String
Minimum compatible Blockbench versiononload()
Runs whenever the plugin is loaded or after a reloadonunload()
Runs whenever the plugin unloadsoninstall()
Runs when the player installs the pluginonuninstall()
Runs when the player uninstalls the plugin
If you want to declare variables that can be used anywhere within the plugin, you can wrap your whole within a self-invoking function and create variables like this:
(function() {
var plugin_variable_1;
Plugin.register('plugin_id', {
onload() {
plugin_variable_1 = 'foo';
},
...
});
})();
To test your plugin, you can load it from the plugin menu using the button in the title bar, or you can simply drag and drop it into Blockbench. Use the Plugin menu or press Ctrl/Cmd + J to reload it.
Submitting your plugin
For testing or internal use you can load the plugin from the file. If you think your plugin can be useful for a larger group of users, you can submit it to the blockbench-plugins repository.
To submit a plugin, fork the repository and add your plugin to the /plugins folder. Then add your plugin to the plugins.json file using the same ID and metadata as in your plugin file. When you are done, create a pull request and wait for it to be merged. Use the same process to submit updates and changes to your plugin.