Welcome to the official Minecraft Legends documentation repository! Here, you'll find everything you need to understand the game's data structure and create your own mods. Whether you're a seasoned modder or just getting started, this documentation is designed to provide clear guidance.
We’re constantly expanding our documentation, so stay tuned for updates. Currently, you can explore the various behaviors that define entities in Minecraft Legends.
In Minecraft Legends, gameplay revolves around entities — from Piglins attacking the overworld to allays gathering resources. Entities can be thought of as objects with behavior, whether or not they have a visual representation. These entities are configured using JSON files, which are divided between Behavior Packs (defining logic) and Resource Packs (defining visuals and assets).
For a detailed explanation of entities, check out the Entities Documentation.
Event Triggers breathe life into entities by enabling them to react to gameplay events. Whether it's triggering animations, playing audio, or spawning particles, event triggers are responsible for all of these in-game interactions.
Blockbench is a free, powerful tool for creating models and animations for Minecraft. We’ve developed a specialized Minecraft Legends plugin for Blockbench that allows seamless export of models and animations into JSON format for use in Minecraft Legends Resource Packs. To learn more about using this plugin and how to integrate models into the game, visit our Blockbench Documentation.
Minecraft Legends’ world is procedurally generated, making every adventure unique. The World Placement system is at the heart of this process, controlling how biomes and features are distributed. This system determines the placement of blocks across the voxel-based world.
Villages and enemy bases play crucial roles in Minecraft Legends’ campaign mode. They are procedurally generated using the deck system, which leverages a card-drawing mechanism to create a dynamic set of structures. Learn more on the Village Generation page.
The Geology Service lets us add special geology textures and features into the game world. This system enables terrain generation that goes beyond standard voxel terrain and adds distinct features.
Special types of barrier blocks are used to create collision systems for various structures in Minecraft Legends, helping to control entity movement and interactions.
Our custom scripting language, BSharp, built on JavaScript, handles the bulk of campaign mode logic. BSharp provides modders with powerful tools for scripting in-game mechanics. For details, see the BSharp Reference Sheet.
NOTE: The Wolverine tool itself has yet to be released, but for those curious they may access the documentation in the meanwhile.
Wolverine is a versatile structure conversion tool for converting structures between Minecraft (Bedrock and Java) and Minecraft Lengeds. Taking .nbt, .mcstructure, or .schematic files made in Minecraft as input, this tool will create Minecraft Legends formatted structures to be used by creators in making their own Packs!
We hope you find this documentation helpful and encourage you to explore the additional resources listed throughout. Stay tuned for further updates, and don’t hesitate to contribute!