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.

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.

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

Creating a Language File

1. Locate the resourcefulbees config folder inside the main config folder.

2. Before we begin the process of adding a language file we need to verify that specific resource and data pack files have been generated:

3. Inside the resourcefulbees folder there should be another folder labeled resources

4. Open this folder and verify there is a file inside called pack.mcmeta

   1. This file is needed for the loading of the language files.

   2. If you do not see this file then reload the mod/pack to generate it.

5. Inside the resources folder we need to add the following nested folders: assets/resourcefulbees/lang

6. The structure should appear as the following image:

7. Inside the lang folder, creating a file called en_us.json will create an English US language file.

8. You can specify a different language using any one of the language codes found here under the Available languages section.

9. Every custom bee added should have language entries similar to the Blaze example below:

   Copy

   {
      "block.resourcefulbees.blaze_honeycomb_block": "Blaze Honeycomb Block",
      "item.resourcefulbees.blaze_honeycomb": "Blaze Honeycomb",
      "item.resourcefulbees.blaze_spawn_egg": "Blaze Bee Spawn Egg",
      "entity.resourcefulbees.blaze_bee": "Blaze Bee"
   }

10. You can either restart the game or use F3+T to reload assets and have the language file take effect.

{
   "block.resourcefulbees.blaze_honeycomb_block": "Blaze Honeycomb Block",
   "item.resourcefulbees.blaze_honeycomb": "Blaze Honeycomb",
   "item.resourcefulbees.blaze_spawn_egg": "Blaze Bee Spawn Egg",
   "entity.resourcefulbees.blaze_bee": "Blaze Bee",
   "block.resourcefulbees.pig_honeycomb_block": "Pig Honeycomb Block",
   "item.resourcefulbees.pig_honeycomb": "Pig Honeycomb",
   "item.resourcefulbees.pig_spawn_egg": "Pig Bee Spawn Egg",
   "entity.resourcefulbees.pig_bee": "Pig Bee"
}

Custom Bee Caveats

Custom Bee Data is the main JSON object comprised of several customization objects which are defined using a "key": { value } syntax.

The "key" names act as identifiers under which the data is registered and used and follow the namespace:path format. The path generally follows a type/version format.

This syntax allows for the customizable options to evolve over time with minimal upkeep required since data mappers can be written to upgrade older API versions to newer ones.

Key Components

Below is a list of the key customization components provided by the mod. Additional components can be created by other mods via our API.

The color customization component handles the Bee Jar and Spawn Egg colors.

Customization Options

spawnEggPrimaryColor

Sets the primary color used on the spawn egg item.

spawnEggSecondaryColor

Sets the secondary color used on the spawn egg item.

jarColor

The color used on the jar when the bee is in the bee jar.

Mutations utilize the recipe system to make them more data pack friendly. One benefit of using the recipe system is that a mutation can be created once and shared among many different bees.

Recipe Type

Every recipe JSON is required to have a type. For mutations the type is resourcefulbees:mutation

Customization Options

input

The item/block/fluid/entity being transformed.

outputs

A list of possible transformation results, which can be an item, block, fluid, or entity.

A unique feature to Resourceful Bees. traits group together:

• Particle Effects

• Damage and Potion Immunities

• Damage Types and Potion Effects

• Special Abilities

• and Auras

Traits enable users to breathe life into infinite variations of bees that can be godly, pesky, helpful, or just downright evil.

Identifier

The root JSON of the trait customization component looks like this:

The identifier of the component is as such:

Customization Options

auraRange

The range within which players would be affected by the aura. This value is the number of blocks.

traits

The list of traits given to the bee.

Customization Options

effect

The ResourceLocation for any registered MobEffect, including modded ones.

strength

The strength of the potion effect.

Customization Options

damageType

Currently, there are only two acceptable choices:

amplifier

The strength of the damage effect.

{
  "damageTypes": [
    {
      "damageType": "explosive",
      "amplifier": 3
    }
  ]
}

The core customization component is responsible for defining four key aspects of nearly every bee imaginable:

• the flower(s) which a bee uses for pollination

• the base amount of time the bee spends in the hive

• associated lore

• the honeycombs produced, if any

Identifier

The root JSON of the core customization component looks like this:

The identifier of the component is as such:

Customization Options

honeycombVariation

The identifier of the honeycomb variation produced by the bee. More information about honeycomb variation can be found in the section.

flower

Specifies what flower(s) the bee can pollinate. With the use of , the syntax will vary based on the definition. The flower can be defined as a tag, a list of blocks, or a single block. See the examples below for further understanding.

entityFlower

When the flower a bee can pollinate is an entity, entityflower must be used instead. The syntax used remains the same as blocks. See the examples below for further understanding.

maxTimeInHive

The base amount of time a bee spends in a hive. This value is modified based on the hive tier.

lore

Lore is cosmetic text displayed in JEI tooltips when hovering over the bee with the cursor. It can be extremely useful for providing players with hints on how to obtain the bee or it can be useful for memes and credits.

Customization Options

source

The ResourceLocation for any registered MobEffect, including modded ones.

hasEntity

If the damage source is sourced from an entity, this should be marked as true. This allows for the death messages to be displayed correctly in the event the target entity dies.

strength

The strength of the damage effect.

A bee family consists of four key pieces of information necessary for breeding a bee:

• The first parent required

• The second parent required

• The weighting of how likely the child is to be selected among potential candidates

• The chance the child is created if selected

"resourcefulbees:breeding/v1": {
  "parents": [
    {
      "parent1": "diamond",
      "parent2": "coal",
      "weight": 75.0,
      "chance": 0.67
    }
  ]
}

Customization Options

weight

For all possible children these two parents can create how likely is it this one will be picked? Weight affects the result distribution among potential outcomes.

Child 1: 20
Child 2: 10
Child 3: 30
Child 4: 60    
Child 5: 80

Child 1: 10%
Child 2: 5%
Child 3: 15%
Child 4: 30%
Child 5: 40%

"resourcefulbees:breeding/v1": {
  "parents": [
    {
      "parent1": "diamond",
      "parent2": "coal",
      "weight": 75.0
    }
  ]
}

chance

Once this child has been chosen as the result type, what is the chance that it will be created?

"resourcefulbees:breeding/v1": {
  "parents": [
    {
      "parent1": "diamond",
      "parent2": "coal",
      "chance": 0.67
    }
  ]
}

parent1

The ID of the first parent.

"resourcefulbees:breeding/v1": {
  "parents": [
    {
      "parent1": "diamond",
      "parent2": "coal"
    }
  ]
}

parent2

The ID of the second parent.

"resourcefulbees:breeding/v1": {
  "parents": [
    {
      "parent1": "diamond",
      "parent2": "coal"
    }
  ]
}

The layer customization component is responsible for defining key aspects of a specific render layer. There are several aspects of a layer that can be modified:

• Effect

• Pulse Frequency

• Color

• Texture

• Visibility when carrying pollen

Customization Options

color

The color that will be applied to the layers texture, this should not be set if your texture is not made to be colored.

texture

The texture for the layer. Each texture requires two versions to exist: normal and angry. The angry texture should use the same name as the normal texture with the suffix _angry appended to it.

layerEffect

The effect the layer will have. There are 3 options available:

isPollen

When true, this layer will only be visible if the bee is carrying pollen.

pulseFrequency

Used with the GLOW layerEffect to create a flashing effect.

The breeding customization component is responsible for defining relationships between bees. Bees can have many different breeding relationships.

Identifier

The root JSON of the breeding customization component looks like this:

The identifier of the component is as such:

Customization Options

parents

A list of bee pairs that can be used to breed this bee.

feedItem

The item(s) which can be fed to the bee to trigger its love state.

feedReturnItem

Item returned to the player after the feed item has been consumed. Useful for returning container-like items after consuming the contents.

feedAmount

The amount of feed items required to be given to the bee to trigger its love state.

childGrowthDelay

The time in ticks that a baby bee will stay a baby bee.

breedDelay

The time in ticks until the bee's love state can be triggered again.

The render customization component is responsible for defining how the bee looks. The data is only used on the client. There are several visual aspects of a bee that can be modified:

• Size

• Model

• Animations

• Textures/Layers

• UI Colors

"resourcefulbees:rendering/v1": {
  "layers": [
    {
      "pulseFrequency": 5.0,
      "color": 52020
    },
    {
      "layerEffect": "GLOW",
      "pulseFrequency": 5.0,
      "color": 65535
    }
  ],
  "model": "resourcefulbees:geo/base.geo.json"
  "texture": "/oreo/oreo_bee",
  "animation": "resourcefulbees:animations/bee.animation.json"
  "ColorData": {
    "spawnEggPrimaryColor": "#442920",
    "spawnEggSecondaryColor": "#e1d9b8",
    "jarColor": "#442920"
  },
  "sizeModifier": 1.25
}

Identifier

The root JSON of the rendering customization component looks like this:

"resourcefulbees:rendering/v1": {
    ...
}

The identifier of the component is as such:

resourcefulbees:rendering/v1

Customization Options

layers

Layers are used to add custom textures on top of the base texture and allow them to have special effects or be enabled by special means.

"resourcefulbees:rendering/v1": {
  "layers": [
    {
      "pulseFrequency": 5.0,
      "color": 52020
    },
    {
      "layerEffect": "GLOW",
      "pulseFrequency": 5.0,
      "color": 65535
    }
  ]
}

ColorData

Color data is used to set the colors for things like jars and spawn eggs.

"resourcefulbees:rendering/v1": {
  "ColorData": {
    "spawnEggPrimaryColor": "#442920",
    "spawnEggSecondaryColor": "#e1d9b8",
    "jarColor": "#442920"
  }
}

model

The location where the GeckoLib geo file is stored.

"resourcefulbees:rendering/v1": {
  "model": "resourcefulbees:geo/base.geo.json"
}

texture

The base texture for the bee. Each texture requires two versions to exist: normal and angry. The angry texture should use the same name as the normal texture with the suffix _angry appended to it.

"resourcefulbees:rendering/v1": {
  "texture": "/oreo/oreo_bee"
}

animation

The location where the GeckoLib animation file is stored.

"resourcefulbees:rendering/v1": {
  "animation": "resourcefulbees:animations/bee.animation.json"
}

sizeModifier

The scale of the bee when rendered in-game.

"resourcefulbees:rendering/v1": {
  "sizeModifier": 1.25
}

{
  "auras": [
    {
      "potionEffect": {
        "effect": "minecraft:instant_health",
        "strength": 2
      },
      "modifier": 3,
      "calmingDisabled": true,
      "aura": "EXPERIENCE",
      "damageEffect": {
        "source": "minecraft:in_fire",
        "hasEntity": false,
        "strength": 0
      }
    }
  ]
}

Customization Options

aura

The Aura Type determines the effect that the aura has on the player. It is a required value for the Aura to load properly.

{
  "auras": [
    {
      "aura": "BURNING"
    }
  ]
}

{
  "auras": [
    {
      "aura": "POTION"
    }
  ]
}

{
  "auras": [
    {
      "aura": "HEALING"
    }
  ]
}

{
  "auras": [
    {
      "aura": "DAMAGING"
    }
  ]
}

{
  "auras": [
    {
      "aura": "EXPERIENCE"
    }
  ]
}

{
  "auras": [
    {
      "aura": "EXPERIENCE_DRAIN"
    }
  ]
}

damageEffect

Used when the aura type is DAMAGING The damage source and strength values are defined in the Damage Effect.

{
  "auras": [
    {
      "aura": "BURNING",
      "damageEffect": {
        "source": "minecraft:in_fire",
        "hasEntity": false,
        "strength": 0
      }
    }
  ]
}

potionEffect

Used when the aura type is POTION The effect and strength values are defined in the Potion Effect.

{
  "auras": [
    {
      "aura": "BURNING",
      "potionEffect": {
        "effect": "minecraft:instant_health",
        "strength": 2
      }
    }
  ]
}

modifier

The modifier value is used with the HEALING, EXPERIENCE, and EXPERIENCE_DRAIN aura types.

{
  "auras": [
    {
      "aura": "BURNING",
      "modifier": 3
    }
  ]
}

calmingDisabled

The aura can be disabled by the "calming" status effect when this value is set to true.

{
  "auras": [
    {
      "aura": "BURNING",
      "calmingDisabled": true
    }
  ]
}

Customization Options

type

A mutation can be one of four different types:

Item | Block | Fluid | Entity

The type object is used for defining the Mutation Type, associated data, and the likelihood of obtaining, when used as an output option.

{
  "type": "item",
  "item": {
    "id": "minecraft:nether_star"
  }
}

{
  "type": "item",
  "item": {
    "id": "minecraft:nether_star"
  },
  "chance": 0.5
}

Output 1: 20
Output 2: 10
Output 3: 30
Output 4: 60    
Output 5: 80

Output 1: 10%
Output 2: 5%
Output 3: 15%
Output 4: 30%
Output 5: 40%

{
  "type": "item",
  "item": {
    "id": "minecraft:nether_star"
  },
  "weight": 69
}

{
  "type": "block",
  "block": {
    "id": "minecraft:diamond_block"
  }
}

{
  "type": "block",
  "block": {
    "id": "minecraft:diamond_block"
  },
  "chance": 0.5
}

Output 1: 20
Output 2: 10
Output 3: 30
Output 4: 60    
Output 5: 80

Output 1: 10%
Output 2: 5%
Output 3: 15%
Output 4: 30%
Output 5: 40%

{
  "type": "block",
  "block": {
    "id": "minecraft:diamond_block"
  },
  "weight": 69
}

{
  "type": "fluid",
  "fluid": {
    "id": "minecraft:water"
  }
}

{
  "type": "fluid",
  "fluid": {
    "id": "minecraft:water"
  },
  "chance": 0.5
}

Output 1: 20
Output 2: 10
Output 3: 30
Output 4: 60    
Output 5: 80

Output 1: 10%
Output 2: 5%
Output 3: 15%
Output 4: 30%
Output 5: 40%

{
  "type": "fluid",
  "fluid": {
    "id": "minecraft:water"
  },
  "weight": 69
}

{
  "type": "entity",
  "entity": {
    "id": "minecraft:cow"
  }
}

{
  "type": "entity",
  "entity": {
    "id": "minecraft:cow"
  },
  "chance": 0.5
}

Output 1: 20
Output 2: 10
Output 3: 30
Output 4: 60    
Output 5: 80

Output 1: 10%
Output 2: 5%
Output 3: 15%
Output 4: 30%
Output 5: 40%

{
  "type": "entity",
  "entity": {
    "id": "minecraft:cow"
  },
  "weight": 69
}

Mutations are the repurposing of a vanilla mechanic: pollination effect. When a bee pollinates a flower and is returning to a hive, any flower it flies over has a chance to be fertilized (have a growth tick applied to it). It can do this up to 10 times before it needs to visit a hive to reset the counter.

Mutations reuse the vanilla mechanic by allowing bees to transform one object into another. The bee would simply fly over a target item|block|fluid|entity and the target would be transformed into different item|block|fluid|entity.

The mutation customization component simply contains the recipe ID for the mutations which the bee can perform and the mutation limit.

Identifier

The root JSON of the mutation customization component looks like this:

The identifier of the component is as such:

Customization Options

count

The number of mutations that can be performed before the bee needs to visit a hive to reset the counter.

mutation

The ID for the mutation recipe. The format is that of a .

The combat customization component is responsible for defining a bee's survival ability and hostility:

• Is the bee passive?

• Does it lose its stinger after attacking?

• Does it inflict poison?

• Can it take damage?

• General attributes of the entity such as:

  • Max health

  • Armor

  • Attack damage

  • Knockback

  • Any registered attribute vanilla or modded can be customized

"resourcefulbees:combat/v1": {
  "removeStingerOnAttack": false,
  "inflictsPoison": false,
  "attributes": {
    "generic.attack_damage": 0,
    "generic.max_health": 2,
    "generic.armor": 5,
    "generic.armor_toughness": 10,
    "generic.attack_knockback": 3
  }
}

Identifier

The root JSON of the combat customization component looks like this:

"resourcefulbees:combat/v1": {
    ...
}

The identifier of the component is as such:

resourcefulbees:combat/v1

Customization Options

isPassive

When true, the bee will not attack entities back.

"resourcefulbees:combat/v1": {
  "isPassive": true
}

removeStingerOnAttack

When true, the bees stinger will be removed on attack. If a bees stinger is removed, it has a chance of randomly dying a bit after the stinger was removed.

"resourcefulbees:combat/v1": {
  "removeStingerOnAttack": false
}

inflictsPoison

When true, the targeted entity will be inflicted with poison when attacked.

"resourcefulbees:combat/v1": {
  "inflictsPoison": false
}

isInvulnerable

When true, the bee will not take any damage.

"resourcefulbees:combat/v1": {
  "attributes": {
    "generic.attack_damage": 0,
    "generic.max_health": 2,
    "generic.armor": 5,
    "generic.armor_toughness": 10,
    "generic.attack_knockback": 3
  }
}

attributes

A map of attributes and their values. The keys are the Attribute ID's and the values are the attribute value.

"generic.max_health": 10,
"generic.flying_speed": 0.6,
"generic.movement_speed": 0.3,
"generic.attack_damage": 1,
"generic.follow_range": 48,
"generic.armor": 0,
"generic.armor_toughness": 0,
"generic.attack_knockback": 0

"resourcefulbees:combat/v1": {
  "attributes": {
    "generic.attack_damage": 0,
    "generic.max_health": 2,
    "generic.armor": 5,
    "generic.armor_toughness": 10,
    "generic.attack_knockback": 3
  }
}

The villager trade customization component is reused across several JSON files within Resourceful Bees. It is responsible for defining the costs and rewards of certain trade items depending on which file it is used in. Not including a villager trade customization component prevents the associated items from being added to the pool of trades.

Below are the JSON files which can have a villager trade customization component and the trades they create.

{
  "resourcefulbees:block/v1": {
    "color": "rainbow",
    "honeyBlockItem": "resourcefulbees:rainbow_honey_block",
    "honeyBlock": "resourcefulbees:rainbow_honey_block",
    "tradeData": {}
  }
}

"resourcefulbees:trade/v1": {
  "amount": {
    "min": 1,
    "max": 1
  },
  "secondaryItem": "minecraft:coal_block",
  "secondaryItemCost": {
    "min": 4,
    "max": 8
  },
  "priceMultiplier": 0.4,
  "maxTrades": 2,
  "xp": 8
}

Identifier

The root JSON of the villager trade customization component looks like this:

"resourcefulbees:trade/v1": {
    ...
}

The identifier of the component is as such:

resourcefulbees:trade/v1

{
  "resourcefulbees:block/v1": {
    "tradeData": {}    <---- Identifier
  }
}

Customization Options

amount

The max amount of filled bee jars that can potentially be received in a single trade.

"resourcefulbees:trade/v1": {
  "amount": {
    "min": 1,
    "max": 1
  }
}

secondaryItem

The item needed, when the trade requires a secondary item, in addition to golden flowers.

"resourcefulbees:trade/v1": {
  "secondaryItem": "minecraft:coal_block"
}

secondaryItemCost

The max base cost for the secondary item.

"resourcefulbees:trade/v1": {
  "secondaryItem": "minecraft:coal_block",
  "secondaryItemCost": {
    "min": 4,
    "max": 8
  }
}

priceMultiplier

When demand goes up, so does the price. Use this value to scale the price increase.

"resourcefulbees:trade/v1": {
  "priceMultiplier": 0.4
}

maxTrades

The max number of trades that can be performed before a restock is needed.

"resourcefulbees:trade/v1": {
  "maxTrades": 2
}

xp

The XP awarded each trade.

"resourcefulbees:trade/v1": {
  "xp": 8
}