-
-
Notifications
You must be signed in to change notification settings - Fork 31
Bee Data
Listed below are all possible options for Bee Data and what is required.
A bee's type and name are used interchangeably. This information is determined based on the name of the .json file containing the bee's data. This value is automatically obtained and required.
Note: Bee names must be entered in the snake_case format.
The color value for the bee is a required value. This value can be expressed in multiple ways but is encoded in the .json as a string. It can be expressed as a hexadecimal value with, or without, preceding tags, an integer value, or a named color from the available list found here. The color value is used to determine the bee's "overlay" color, its comb color, and its comb block color.
Below are some examples of color usage.
"color": "#ff00ff"
"color": "#fff"
"color": "ff00ff"
"color": "0xff00ff"
"color": "white"
Note: When a special bee type is used, such as creeper, the bee's overlay does not render and thus the color has no effect. However, the color value is still required because it is used for the comb and comb block.
The flower value is used to determine what flower the bee should use for pollen/nectar gathering. We provide a few different options for the flower value and may provide more in the future. Currently, the options available for a flower include three separate tags or a block ID as seen below.
"flower": "all" <-------- This lets the bee use all available flowers including modded flowers.
"flower": "tall" <-------- This lets the bee use only flowers with the tag "tall" such as the rose bush.
"flower": "small" <------- This lets the bee use only flowers with the tag "small" such as the poppy.
"flower": "minecraft:poppy"
This final example lets the bee use only a predefined flower, including modded flowers. This value is not locked only to flowers, however. ANY block in the game including modded can be used here. Note: Flowers are not a comma-separated list. You get to choose either ONE flower, all flowers, tall flowers, or small flowers.
The main output value is what determines the primary output when running the bee's honeycomb through the centrifuge. This value can be anything you want to give to the player so long as it is an item in game. This includes any item from another mod. This output can also have an optional weighting value provided that determines the chance of getting the item.
Here are some examples:
"mainOutput": "minecraft:blaze_rod" <---- This would make the centrifuge provide blaze rods
"mainOutput": "theoneprobe:probe" <---- This would make the centrifuge provide probes from The One Probe
"mainOutput": "minecraft:nether_star" <---- This would make the centrifuge provide nether stars
"mainOutput": "minecraft:barrier" <---- This would make the centrifuge provide barrier blocks
The secondary output is an optional value for the bee. You can have the centrifuge output a "waste" item or any other item for the secondary output. This value follows the same rules as shown for the main output. If no value is supplied then the default value of "Beeswax" is provided instead. This value can also have a custom defined weighting.
Here is an example of it's usage:
"secondaryOutput" : "minecraft:redstone_lamp"
The bottle output is an optional value for the bee. This output is intended to allow bees to provide a different bottled ingredient such as "Dragons Breath", however, like the other two outputs this value can be set to anything. This value defaults to "Honey Bottle" if not used. This value can also have a custom defined weighting.
Here is an example of it's usage:
"bottleOutput" : "minecraft:dragon_breath"
This value is optionally required. This value must be either "true" or "false" depending on if you want the bee to spawn in world or not. If the value is true then you must include the spawnable biomes in the biome list field as will be seen in the next section.
This value is optionally required. This value is comma-separated and used in combination with the "spawn in world" value. This value can be expressed in a variety of ways and as such this value is used to determine the dimension a bee may spawn in as well. It is much easier to show examples of it's usage.
Note: You can use either biome type tags or specific biomes, you cannot use both simultaneously.
This example will let the bee spawn in any nether biome.
"spawnInWorld": true,
"biomeList": "tag:nether"This example will let the bee spawn in any overworld biome.
"spawnInWorld": true,
"biomeList": "tag:overworld"This example will let the bee spawn in any mountain or hills biome.
"spawnInWorld": true,
"biomeList": "TAG:Mountain, HILLS"This example will let the bee spawn in plains, frozen river, or beach biomes only.
"spawnInWorld": true,
"biomeList": "minecraft:plains,minecraft:frozen_river,minecraft:beach"Note: Take notice that letter casing and spaces have no impact on the bee's ability to spawn. However, when using a biome type tag, the prefix "tag:" must be included.
This value is optional. This value is used to determine the amount of time in ticks the bee must spend in the hive before it generates a honeycomb. This value is represented as an integer value. The minimum value allowed is 600 ticks with no maximum. This value defaults to 2400 ticks, like the vanilla bee, if not set.
"maxTimeInHive": 1000 <------ This means the bee will have to stay in the hive for 1000 ticks before generating a honeycomb.
Parent 1 and Parent 2 are two separate values. They are optional, however, when used, they must be used together with "breedable". Parent 1 and Parent 2 are used for determining what bees must mate to create this child bee. The "breedable" value is a true/false flag to tell the mod that "this bee is breedable and here are it's parents".
Here is an example of its usage:
In this example the bee can be bred when a "Diamond" and "Emerald" bee mate.
"breedable": true,
"parent1": "diamond",
"parent2": "Emerald"In this example the bee can be bred when "my_super_cool_bee" mates with "my_other_super_cool_bee".
"breedable": true,
"parent1": "my_super_cool_bee",
"parent2": "my_other_super_cool_bee"Note: A bee must have two different parents. No two bees can have the same two parents.
This value is an optional value. This value is used when establishing a bee's breeding rules. This value is represented as a "double". The value should be between 0.00 -> 1.00. This value determines the weighting that the child bee has when breeding. The default for this value is 0.33.
Using the above here are additional breeding examples:
This example the bee has a 50% chance to spawn when a Gold and Lapis bee mate.
"breedable": true,
"parent1": "Gold",
"parent2": "Lapis",
"breedWeight": 0.5This example the bee has a 15% chance to spawn when a Wither and Blaze bee mate.
"breedable": true,
"parent1": "Wither",
"parent2": "Blaze",
"breedWeight": 0.15There are three different weight values that can be set for the centrifuge outputs. These correspond with the three different centrifuge outputs available. There is the mainOutputWeight, the secondaryOutputWeight, and the bottleOutputWeight. These values are optional and can be used to determine the chance an item has to be output from the centrifuge recipe. Like the breed weight above they are two-digit decimal numbers between 0.00 -> 1.00.
Here is an example:
"mainOutput": "minecraft:diamond",
"mainOutputWeight": 0.40,
"secondaryOutput": "minecraft:nether_star",
"secondaryOutputWeight": 0.02,
"bottleOutput": "minecraft:experience_bottle",
"bottleOutputWeight": 0.70In the example above, the bee's honeycomb when used in the centrifuge will have a 40% chance to output a diamond, a 2% chance to output a nether star as the secondary output, and a 70% chance to output bottles of enchanting.
Note: The default value for Main Output is 1.0. The default value for Secondary output is 0.20. The default value for Bottle Output is 0.25.
Block Mutation is an optional feature for bees. It is the modded version of vanilla pollination effects. Rather than a bee potentially applying a growth tick to a flower it flies over, a bee can instead "mutate" a block into another block. The baseBlock represents the block or blocks to be mutated and the mutationBlock represents the final form. For example a bee could mutate simple stone blocks into coal ore blocks. The baseBlock has the option of accepting tags, however the mutationBlock does not.
Example:
In this example the bee will mutate a stone block into a coal ore block.
"baseBlock": "minecraft:stone",
"mutationBlock": "minecraft:coal_ore"In this example the bee will mutate any block tagged as stone into a coal ore block.
"baseBlock": "tag:forge:stone",
"mutationBlock": "minecraft:coal_ore"In this example the bee will mutate a coal block into a bedrock block.
"baseBlock": "minecraft:coal_block",
"mutationBlock": "minecraft:bedrock"Note: Base Block and Mutation Blocks are not limited to just Minecraft blocks. Any block from any mod can be used as long as it has a resource location in the form of "namespace:id".
There are various optional traits available for bees and potentially more to come. Traits affect bees in a variety of ways from changing its base texture to changing what type of damage it does when it attacks. Below is the list of available bee traits and what they do as well as their .json syntax.
Syntax: "enderBee": true Effect: Bee will have enderman particle effects and periodically teleport up to 4 blocks from its current location.
Syntax: "netherBee": true Effect: Bee does not take damage from fire.
Syntax: "creeperBee": true Effect: Bee will have the Creeper texture and will have a random sized explosion when attacking a player.
Syntax: "skeletonBee": true Effect: Bee will have a skeleton texture.
Syntax: "zomBee": true Effect: Bee will have a zombie texture and causes hunger when attacking the player.
Syntax: "pigmanBee": true Effect: Bee will have a zombie pigman texture and causes mining fatigue when attacking the player.
Syntax: "witherBee": true Effect: Bee will have a wither skeleton texture and causes wither when attacking the player. Wither bee is not affected by wither.
Syntax: "blazeBee": true Effect: Bee will set player on fire when attacking. Bee also randomly sets itself on fire. And bee does not take damage from fire.