Creating A Custom Bee
Resourceful Bees more modern, codec-driven API, enables pack developers and players to create custom bees varying in degree of complexity easily. Bee creation can feel overwhelming at first, but luckily for creators, a vast majority of available customization options are optional and most options have some kind of default value available, with vanilla-matching values provided where necessary.
When the default value for an available option is desired, it is acceptable to omit the entry from the JSON.
Fundamental Overview
At the most basic, high-level view, the creation of a custom bee requires a minimal number of key components to come to life. Below we will highlight the absolute bare minimum required to make a bee as well as additional customizations:
Minimum Requirements
Simply placing a properly structured JSON file in the right location will create a bee. However, the bee may not have the right appearance, create honeycombs, spawn, breed, etc without some additional context.
Additional Customizations
In addition to the bee JSON, a player or pack developer may want to provide custom textures, translations, models, animations, traits, mutations, honeys and honeycombs, various recipes, and more:
Custom textures, models, and animations will all affect the appearance of the bee.
Translations make any text associated with the bee display in the proper language.
Honeys and honeycombs can be created independently from bees so that more than one bee can utilize a honey or honeycomb.
Traits and mutations can also be created independently so as to be reusable.
Various supporting recipes can be created for blocks such as the centrifuge, solidifier, flow hive, breeder, etc.
File Structure
Traits, bees, honeys, and honeycombs are all customized in the resourcefulbees
config folder. They can also be customized via the datapack data folder as well. The datapack location is useful for supporting mods which may want to add their own custom bees when loaded alongside Resourceful Bees, however the config folder is a better location for pack developers and players due to the caveats associated with how bees, honeys, and combs are registered to the game.
The bee_traits
folder is where all custom traits should go.
<pack instance>/config/resourcefulbees/bee_traits
Language Files
Language files allow text displayed in game to be displayed in various languages. Not providing an entry in a language file will cause names to appear something like this:
item.resourcefulbees.blaze_honeycomb
For new mod installs, run the game at least once so all necessary config files and folders can be generated
Creating a Language File
Locate the
resourcefulbees
config folder inside the main config folder.Before we begin the process of adding a language file we need to verify that specific resource and data pack files have been generated:
Inside the
resourcefulbees
folder there should be another folder labeledresources
Open this folder and verify there is a file inside called
pack.mcmeta
This file is needed for the loading of the language files.
If you do not see this file then reload the mod/pack to generate it.
Inside the
resources
folder we need to add the following nested folders:assets/resourcefulbees/lang
The structure should appear as the following image:
Inside the
lang
folder, creating a file calleden_us.json
will create an English US language file.You can specify a different language using any one of the language codes found here under the Available languages section.
Every custom bee added should have language entries similar to the Blaze example below:
You can either restart the game or use F3+T to reload assets and have the language file take effect.
You do not need multiple language files. You only need one with new lines added for each custom bee:
Custom Bee Caveats
Last updated