MoreBees
A comprehensive Minecraft plugin that adds custom bee types, advanced beehive mechanics, and powerful bee management tools.

✨ Features
Custom Bee Types

• Multiple bee variants: Redstone, Emerald, Diamond, Gold, Iron bees, and what you create!
• Unique behaviors: Each bee type has specific food preferences and flower requirements
• Custom models: Support for ModelEngine integration with custom 3D models
• Breeding system: Cross-breed different bee types to create new variants
• Mutation mechanics: Bees can mutate when flying over specific blocks

Advanced Beehive System

• Upgradeable beehives: Three upgrade levels with different capacities and multipliers
• Visual upgrade displays: See your upgrades as 3D items on beehives
• Custom honey production: Each bee type produces unique honey and resources
• Automatic resource conversion: Honey can be converted to blocks and resources

️ Bee Management Tools

• Bee Jar : Capture and transport individual bees
• Bee Box : Store up to 10 bees in a portable container
• Easy release system: Right-click to release bees, sneak+right-click to release all

Installation

1. Download the latest release from GitHub Releases or SpigotMC.
2. Place the JAR file in your server's plugins/ folder
3. Restart your server
4. Configure the plugin using the generated config files

Requirements

• Minecraft: 1.21+
• Server Software: Paper, Purpur, or other Paper-based servers
• Java: 17+

Soft Dependencies

• ModelEngine: For custom 3D bee models
• ItemsAdder: Custom item integration
• Oraxen: Custom item integration
• Nexo: Custom item integration

⚙️ Configuration
Main Configuration (config.yml)
Breeding Configuration (breeds.yml)
Upgrade Configuration (upgrades.yml)

Code (YAML):

upgrades:
  - id : level-1
    max-bees : 3
    production-multiplier : 1.5
    produce-blocks : false
    item:
      material : COPPER_INGOT
      name : Level 1 Upgrade

Commands
Command Permission Description
/morebees morebees.command.help Show help menu
/morebees reload morebees.command.reload Reload configuration
/morebees egg <player> <beetype> [amount] morebees.command.egg Give bee spawn eggs
/morebees spawn <beetype> [baby] morebees.command.spawn Spawn a bee
/morebees honey <player> <beetype> <block> [amount] morebees.command.honey Give honey items
/morebees tool <player> <tool> morebees.command.tool Give bee tools
/morebees upgrade <player> <upgrade> morebees.command.upgrade Give beehive upgrades
Aliases: /bees, /mb, /bee

How to Use
Getting Started

1. Spawn bees using /morebees egg <player> <beetype>
2. Feed bees with their preferred foods to breed them
3. Place beehives and let bees populate them
4. Upgrade beehives by right-clicking with upgrade items
5. Harvest honey using shears when beehives are full

Bee Management

• Capture bees: Right-click with a Bee Jar or Bee Box
• Release bees: Right-click to release, sneak+right-click to release all
• Breed bees: Feed two adult bees to make them breed
• Create mutations: Let bees with nectar fly over specific blocks

Beehive Upgrades

• Apply upgrades: Right-click beehive with upgrade item
• Remove upgrades: Sneak+right-click to retrieve upgrade
• Visual feedback: Upgrades appear as 3D items on beehives

Recipes Usage: How It Works
All custom recipes in this plugin are powered by RecipesAPI — a lightweight and flexible library purpose-built to simplify and centralize the crafting system in Minecraft.

This API was developed in-house to streamline how recipes are created, registered, and managed. It supports two ways to define recipes:

• YAML files – perfect for server owners and developers who prefer clean, file-based configuration.
• Java code – ideal for dynamic recipe generation or advanced programmatic control.

With RecipesAPI, you can:

• Easily add, modify, or remove recipes without dealing with low-level Minecraft internals.
• Automatically validate crafting inputs and prevent invalid crafts.
• Use custom items, tags, and even advanced conditions in your recipes.

For full documentation, visit the GitHub Wiki. It includes everything you need — from YAML format examples to Java integration guides — to get started and make the most of RecipesAPI.

Performance Optimization: Spiral Search Algorithm
Our custom bee AI uses an optimized spiral search algorithm that reduces block scanning by up to 90%.

View Interactive Demo

Key Benefits:

• ⚡ 10x faster than traditional cube scanning
• Early termination when target found
• Scales perfectly with multiple bees
• ️ TPS-friendly for production servers

ModelEngine Integration
When ModelEngine is installed:

• Custom 3D models replace default bee textures
• Animated bees with flying animations
• Automatic scaling for baby bees

️ API for Developers
MoreBees provides a comprehensive API for developers:

Code (Java):

// Get the BeeManager[/B]
[B ]
BeeManager beeManager = BeePlugin. getPlugin ( ). getManager (BeeManager. class ) ;
// or use the ServiceManager from spigot
// Spawn a custom bee
beeManager. spawnBee (location, beeType, SpawnReason. CUSTOM, false, false ) ;
// Get bee type from entity
Optional <BeeType > beeType = beeManager. getBeeTypeFromEntity (bee ) ;

Debug Mode
Enable debug logging in config.yml:
License
This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• RecipesAPI - Recipe management system
• Structura - Configuration framework
• ModelEngine - 3D model support

Made with ❤️ by Traqueur_