This repository demonstrates a basic MCreator plugin structure.
Demonstrated features:
- Custom procedural/output procedure block
- Custom procedure category
- Custom global trigger
- Custom templates
- Generator for given features for 1.14.4 and 1.15.2
- Localized texts
Other plugin features not demonstrated:
- Custom JSON advancement triggers and categories
- AI task blocks and categories
- Full generator plugin
- Data lists
- APIs - eg. Minecraft Link
- Variables
- UI Themes
- Java plugin (see DemoJavaPlugin for this feature)
- ...
For features not demonstrated in this plugin, you can check the built-in plugins in <install dir>/plugins folder of your MCreator installation for the reference.
https://mcreator.net/wiki/section/mcreator-plugins
WARNING: The plugin structure might and will change in the future so keep your eye on this repository for changes on the format if you are a plugin dev.
In order for the plugin to work, make new file called gradle.properties with the following contents:
mcreator_path=<path to MCreator core Gradle project directory>
This demo plugin comes with some Gradle tasks to help you with the development of your plugin.
runMCreatorWithPlugin: Run MCreator with the plugin loaded
There is also IntelliJ IDEA run configuration for this task provided in the repository.
Make sure to enable Java plugins in MCreator preferences, or the plugin will not be loaded.
We highly recommend to test your plugin by running MCreator's unit tests with your plugin loaded.
This Gradle project does this for you, you just need to run the test task.
There is also IntelliJ IDEA run configuration for this task provided in the repository.
To export the plugin, run jar task and find the plugin zip file in build/libs.
To install exported plugin in MCreator, put the plugin ZIP file into <user home>/.mcreator/plugins or install them from MCreator's preferences window and relaunch MCreator.
All files outside the src/main/resources folder are not part of the plugin structure but are there for the purpose of Intellij IDEA IDE support
for better plugin development, documentation purposes and similar.