🐝 Beekeeping & Brewing

A comprehensive beekeeping and brewing system for RedM/VORP.

✨ Features Overview

🐝 Beekeeping

Placeable beehives
Honey and wax harvesting
Bee sting mechanics with hat protection
Maintenance system (health & feeding)
Wild Bees: Random spawns, configurable in config
Random bear spawns
Drunk effect from mead

🍺 Brewing System

Time-based quality system
7 different recipes
3 categories (Alcohol, Juices, Medicine)
Owner system with optional theft
Visual steam effects

📥 Installation

Fresh Installation

Copy mulderdev_beekeeping to your resources folder
Add ensure mulderdev_beekeeping to your server.cfg
Execute sql_install.sql in your database
Restart server

Update from V1.x

ALTER TABLE brewing_barrels ADD COLUMN recipe_key VARCHAR(50) DEFAULT NULL;

🎮 Usage - Beekeeping

Step 1: Get a Beehive

You need the item bee_box (Beehive Kit) in your inventory.

Where do I get the kit?

The server admin must make the item available in a shop or from an NPC.

Step 2: Place the Beehive

Use the bee_box from your inventory
A preview model appears in front of you
Move to adjust the position
Press [G] to place the hive

Placement Tips

Choose flat ground
Cannot be placed inside buildings
Keep distance from other beehives

Step 3: Wear Beekeeper Hat (recommended!)

Before harvesting honey, you should wear a beekeeper hat!

Item	Function
`clothing_beekeeper_hat`	Protects from bee stings

Without hat:

100% chance to get stung
You take damage
Possible stumbling

With hat:

Complete protection from stings
Message: "Your hat protected you!"

Step 4: Harvest Honey

Go to the beehive
Press [G] → "Harvest Honey"
Wait for the animation

Harvest Results:

Item	Amount	Chance
Honeycomb (`honeycomb`)	1-3	100%
Wax (`wax`)	1-2	100% (configurable)

Cooldown

After each harvest, you must wait 1 minute before harvesting again.

Step 5: Maintain the Beehive

Your beehive has two status values you need to maintain:

🏥 Health

Condition	Effect
100%	Full harvest
50%	Reduced harvest
0%	Beehive broken! No harvest possible

Repairing:

Required item: wood
Go to the beehive
Select "Repair"
Health increases by 50%

🍯 Food

Condition	Effect
100%	Normal harvest
High	+50% harvest bonus!
0%	Reduced harvest

Feeding:

Required item: sugar_water
Go to the beehive
Select "Feed"
Food level increases

Picking Up the Beehive

You can pick up your beehive at any time:

Go to the hive
Select "Pickup"
The hive returns to your inventory

🍺 Usage - Brewing System

Step 1: Get a Brewing Barrel

You need the item empty_barrel in your inventory.

Step 2: Place the Brewing Barrel

Use the empty_barrel from your inventory
A preview model appears
Press [G] to place

Ownership

You are automatically the owner of the barrel. Only you can brew in it!

Step 3: Choose a Recipe

Go to the brewing barrel
Press [G] → "Open Brewing Menu"
The brewing interface opens

In the interface:

Choose a category (Alcohol 🍺, Juices 🧃, Medicine 💊)
Choose a recipe
Check if you have all ingredients
Click "Brew"

Available Recipes

🍺 Alcohol

Recipe	Time	Product	Amount	Ingredients
Mead	1 min	`mead_bottle`	5	3x Honeycomb, 2x Water, 1x Yeast
Beer	2 min	`beer_bottle`	6	4x Wheat, 3x Water, 1x Yeast
Whiskey	5 min	`whiskey_bottle`	2	5x Corn, 2x Water, 2x Yeast

🧃 Juices

Recipe	Time	Product	Amount	Ingredients
Apple Juice	1 min	`apple_juice`	4	5x Apples, 1x Water
Berry Juice	1 min	`berry_juice`	3	8x Berries, 1x Water, 1x Honeycomb

💊 Medicine

Recipe	Time	Product	Amount	Ingredients
Herbal Tonic	3 min	`herbal_tonic`	2	4x Herbs, 2x Water, 1x Honeycomb
Stamina Brew	4 min	`stamina_potion`	2	3x Ginseng, 2x Herbs, 2x Water

Step 4: Wait for Fermentation

After starting:

An animation plays
Steam rises from the barrel
The barrel shows "Brewing: [Recipe Name]"
A timer shows the remaining time

Real-Time Display

The UI shows you live how long it will take!

Step 5: Collect at the Right Time!

This is the most important feature! Quality depends on when you collect:

Fermentation complete
    ↓
0-1 minutes → Normal (1.0x yield)
    ↓
1-2 minutes → Fine (1.5x yield) ⭐
    ↓
2-3 minutes → Excellent (2.0x yield) ⭐⭐
    ↓
After 5 minutes → OVERCOOKED! (0.5x yield) ❌

Example with Mead (Base: 5 bottles):

Collection Time	Quality	Yield
Immediately (0-1 min)	Normal	5 bottles
1-2 minutes	Fine	7 bottles
2-3 minutes	Excellent	10 bottles
After 5 min	Overcooked	2 bottles

Caution: Overcooked!

Don't wait too long! After 5 minutes, your brew becomes overcooked and you lose half the yield!

Step 6: Collect

Go to the finished barrel
The barrel shows "READY" and the current quality tier
Press [G] → "Collect"
The bottles are added to your inventory

Quality is also shown in inventory:

"Mead" → Normal quality
"Mead (Fine)" → Fine quality
"Mead (Excellent)" → Excellent quality

🔒 Owner System & Theft

Owner Rights

Only the owner can brew at their barrel
Other players see: "This is not your barrel"

Theft (optional)

If Config.Brewing.TheftEnabled = true:

Other players can try to steal finished products
50% success chance
On success: Thief receives the products
On failure: The owner is notified!

🐝 Wild Bees (New!)

The ecosystem has become more alive! From now on, you can encounter natural beehives in the wilderness.

🌳 How do I find Wild Bees?

Wild bees are shy, but their nests can be found by attentive adventurers:

Listen carefully: When you are near a nest, you can hear the buzzing of the bees.
Search in forests: They prefer dense forests and often hang from trees.

🍯 What can I do?

When you have found a wild nest, you have the following option:

Steal Honey: Try to get some honey (High risk of bee stings!).

Tip

Always take a Beekeeper Hat with you! Wild bees are more aggressive and stings cause more damage.

:::

🐻 Random Events

Bear Spawns

While you're near your beehives, a bear may spawn!

Setting	Value
Spawn Chance	10%
Spawn Distance	20-30 meters
Model	`A_C_Bear_01`

The bear is aggressive and will attack! Be prepared.

Mead Drunkenness

When you drink mead:

You become drunk for 60 seconds
The screen sways
Message: "Whoa... that mead is strong!"

⚙️ Full Configuration

General Settings

Config.DevMode = false  -- Debug mode
Config.Locale = "en"    -- "de" or "en"

Beekeeping

Config.Beekeeping = {
    HarvestCooldown = 1,      -- Minutes between harvests
    MinHoney = 1,             -- Minimum honey yield
    MaxHoney = 3,             -- Maximum honey yield
    StingChance = 100,        -- Sting chance without hat (%)
    StingDamage = 10,         -- Damage per sting
    RequiredItem = "bee_box", -- Item to place
    BearChance = 10,          -- Bear spawn chance (%)
    
    -- Wax
    WaxChance = 100,          -- Chance for wax
    WaxMin = 1,
    WaxMax = 2,
    
    -- Maintenance
    Maintenance = {
        DegradeRate = 10,         -- Degradation per harvest
        RepairItem = "wood",      -- Item to repair
        RepairAmount = 50,        -- Repair value
    },
    
    -- Feeding  
    Feeding = {
        FoodItem = "sugar_water", -- Food item
        BoostMultiplier = 0.5,    -- Bonus when fully fed
        FoodConsumption = 20,     -- Consumption per harvest
    },

    -- Wild Bees
    WildBees = {
        Enabled = true,           -- Enable/Disable
        -- Further configurations in config.lua
    },
}

Brewing System

Config.Brewing = {
    RequiredItem = "empty_barrel",  -- Item to place
    
    -- Owner System
    OwnerOnly = true,               -- Only owner can brew
    TheftEnabled = true,            -- Allow theft?
    TheftSuccessChance = 50,        -- Success probability
    TheftNotifyOwner = true,        -- Notify owner?
    
    -- Quality System
    Quality = {
        Enabled = true,
        TimeBased = true,           -- Time or random based
        Tiers = {
            { name = "Normal", multiplier = 1.0, minTime = 0, maxTime = 1 },
            { name = "Fine", multiplier = 1.5, minTime = 1, maxTime = 2 },
            { name = "Excellent", multiplier = 2.0, minTime = 2, maxTime = 3 },
        },
        OvercookPenalty = true,
        OvercookTime = 5,           -- Minutes until overcooked
    },
}

Adding Custom Recipes

Config.Brewing.Recipes["your_recipe"] = {
    category = "alcohol",           -- alcohol, juice, medicine
    time = 3,                       -- Fermentation time in minutes
    product = "your_product_item",  -- Item that gets created
    amount = 5,                     -- Base amount
    ingredients = {
        { item = "item1", count = 2 },
        { item = "item2", count = 1 },
    }
}

Don't forget to add the localization too:

Config.Locales["en"].Recipes["your_recipe"] = { 
    label = "Your Recipe", 
    description = "Description here" 
}

🔧 Required Items

These items should be in your database (via sql_install.sql):

Item	Label	Type
`bee_box`	Beehive Kit	Usable
`honeycomb`	Honeycomb	Standard
`wax`	Wax	Standard
`clothing_beekeeper_hat`	Beekeeper Hat	Usable
`empty_barrel`	Empty Barrel	Usable
`mead_bottle`	Mead	Standard
`beer_bottle`	Beer	Standard
`whiskey_bottle`	Whiskey	Standard
`apple_juice`	Apple Juice	Standard
`berry_juice`	Berry Juice	Standard
`herbal_tonic`	Herbal Tonic	Standard
`stamina_potion`	Stamina Brew	Standard
Ingredients	Various	Standard

📋 Requirements

VORP Core
VORP Inventory
oxmysql

✨ Features Overview​

🐝 Beekeeping​

🍺 Brewing System​

📥 Installation​

Fresh Installation​

Update from V1.x​

🎮 Usage - Beekeeping​

Step 1: Get a Beehive​

Step 2: Place the Beehive​

Step 3: Wear Beekeeper Hat (recommended!)​

Step 4: Harvest Honey​

Step 5: Maintain the Beehive​

🏥 Health​

🍯 Food​

Picking Up the Beehive​

🍺 Usage - Brewing System​

Step 1: Get a Brewing Barrel​

Step 2: Place the Brewing Barrel​

Step 3: Choose a Recipe​

Available Recipes​

🍺 Alcohol​

🧃 Juices​

💊 Medicine​

Step 4: Wait for Fermentation​

Step 5: Collect at the Right Time!​

Step 6: Collect​

🔒 Owner System & Theft​

Owner Rights​

Theft (optional)​

🐝 Wild Bees (New!)​

🌳 How do I find Wild Bees?​

🍯 What can I do?​

🐻 Random Events​

Bear Spawns​

Mead Drunkenness​

⚙️ Full Configuration​

General Settings​

Beekeeping​

Brewing System​

Adding Custom Recipes​

🔧 Required Items​

📋 Requirements​