SIMPLIX IT · SCRIPT DOCUMENTATION

BEEKEEPING &
BREWING.

V4.0.0 · REDM / VORP

A complete beekeeping and brewing system for RedM/VORP: placeable beehives, bee queens, flower fields with honey bonuses, time-based brewing mechanics, and a hive upgrade system. This page walks you through installing the script and tuning it to your server via config.lua.

Dependencies

VORP Core
VORP Inventory
oxmysql

Installation — Fresh Install

Upload mulderdev_beekeeping to your resources directory.
Add ensure mulderdev_beekeeping to your server.cfg.
Open sql.sql and run Section A in your database.
Restart the server.

Update from an Older Version to V4.0.0

Upload the new files (overwrite existing ones).
Open sql.sql and run Section B.
Review the new Config.Security, Config.Limits, and Config.HiveUpgrades sections in config.lua.
Restart the server.

Note: Existing beehives will end up with has_queen = 0 (inactive). Players need to install a queen once to reactivate their hives. Only sql.sql is used in V4.0.0 — old files such as sql_install.sql, sql_migration.sql, and sql_update.sql are no longer needed.

Commands

Command	Who	Description
`/bkreload`	Admin	Forces a full prop reload for all connected players without a server restart. Requires the ace permission `command.bkreload`.
`/resetplacement`	Player	Resets a stuck placement mode.

To grant /bkreload to admins, add this to your server.cfg:

add_ace group.admin command.bkreload allow

Config Reference — General & Security

Setting	Description
`Config.Locale`	Language: `"en"` or `"de"`
`Config.DevMode`	Debug output in the F8 console
`Config.Security.ValidateConfig`	Print startup warnings for broken config values
`Config.Security.RequireOwnership`	Only owners can repair, feed, or pick up their own hives and barrels
`Config.Security.ServerDistanceChecks`	Server verifies player distance before sensitive actions
`Config.Security.InteractionDistance`	Maximum distance for hive/barrel actions
`Config.Security.PlacementDistance`	Maximum distance between player and placement coordinates
`Config.Limits.MaxHivesPerPlayer`	Maximum placed hives per character (`0` = unlimited)
`Config.Limits.MaxBarrelsPerPlayer`	Maximum placed barrels per character (`0` = unlimited)

Config Reference — Hive Upgrades

Setting	Description
`Config.HiveUpgrades.Enabled`	Enables/disables the whole upgrade system
`Config.HiveUpgrades.MaxLevel`	Default max level for upgrades (default: `3`)
`Config.HiveUpgrades.frame`	Reinforced Frame — reduces hive health loss when harvesting
`Config.HiveUpgrades.net`	Protective Net — lowers sting chance
`Config.HiveUpgrades.brood`	Large Brood Box — increases honey yield
`Config.HiveUpgrades.feeder`	Feeder Chamber — reduces food consumption

Each upgrade has Enabled, Effects (bonus values per level), and Costs (required items per level). Default costs use existing items such as wood, wax, honeycomb, and sugar_water — adjust them to fit your server economy.

Config Reference — Beekeeping & Flower Fields

Setting	Description
`Config.Beekeeping.Prop`	Prop model for placed hives
`Config.Beekeeping.HarvestCooldown`	Minutes between harvests
`Config.Beekeeping.MinHoney` / `MaxHoney`	Base honey yield range (multipliers apply on top)
`Config.Beekeeping.StingChance`	Sting chance in %
`Config.Beekeeping.QueenItem`	Item name for the Bee Queen (default: `bee_queen`)
`Config.Beekeeping.QueenLifetime`	Queen lifetime in hours (default: `24`, `0` = never expires)
`Config.FlowerFields.Enabled`	Enables/disables the flower field system
`Config.FlowerFields.ShowProximityInUI`	Shows a proximity bar in the hive menu
`Config.FlowerFields.BestMultiplier`	Honey multiplier inside a field (default: `2.0`)
`Config.FlowerFields.DefaultMultiplier`	Multiplier with no field nearby (default: `1.0`)
`Config.FlowerFields.FalloffDistance`	Meters beyond the radius until the default multiplier applies (default: `150`)
`Config.FlowerFields.Fields`	List of fields — each with `x`, `y`, `z`, `radius`, `label`

Adding Flower Fields

In config.lua under Config.FlowerFields.Fields:

Fields = {
    { x = 1591.5, y = 2140.4, z = 318.5, radius = 80, label = "Wildflower Meadow" },
    { x = 1264.0, y = 528.0,  z = 88.0,  radius = 60, label = "Sunflower Field" },
    -- Add more fields here...
}

Tip: Use Spooner or a coordinate grabber to find the center of a field in-world.

Config Reference — Wild Hives & Brewing

Setting	Description
`Config.WildHives.Enabled`	Enables/disables wild beehives
`Config.WildHives.Prop`	Prop model (default: `s_hornetnest_01x`)
`Config.WildHives.HarvestCooldown`	Minutes between harvests per player (default: `30`)
`Config.WildHives.StingChance`	Sting chance in % (default: `50`)
`Config.WildHives.QueenChance`	Chance in % to catch a queen while harvesting (default: `15`)
`Config.WildHives.Locations`	List of spawn coordinates
`Config.Brewing.OwnerOnly`	Only the barrel owner can brew
`Config.Brewing.TheftEnabled`	Allows other players to steal finished brews
`Config.Brewing.TheftSuccessChance`	Theft success probability in %
`Config.Brewing.Quality.TimeBased`	`true` = quality depends on collection timing
`Config.Brewing.Quality.OvercookTime`	Minutes after ready before the brew becomes overcooked (default: `5`)

Adding Wild Hive Locations

In config.lua under Config.WildHives.Locations:

Locations = {
    { x = -2312.17, y = -2056.77, z = 82.70, h = 333.54 },
    { x = 1264.82,  y = 528.86,   z = 88.18, h = 235.07 },
    -- Add more locations here...
}

Tip: The Z coordinate should be exact for hanging nest props — no ground placement is applied.

BEEKEEPING &BREWING.