Installation

Supported Inventories

Inventory	Status
ox_inventory	Supported
tgiann-inventory	Supported
jaksam_inventory	Supported
qs-inventory	Supported
qs-inventory-pro	Supported
qb-inventory	Supported
ps-inventory	Supported
lj-inventory	Supported
codem-inventory	Supported

Recommendation

We heavily recommend using ox_inventory — it's the best inventory system available and more importantly, it's completely free and open source! You won't be missing out on any features in our scripts if you use a different inventory, this is simply a recommendation.

Dependencies

Ensure the following dependencies are installed and running on your server before starting:

Dependency	Required	Notes
Framework	Yes	qb-core / qbx_core / es_extended
ox_lib	Yes
oxmysql	Yes
Target System	Yes	ox_target / qb-target / qtarget
Inventory	Yes	Any of the supported inventories listed above

TIP

Framework, target system, and inventory are all automatically detected — no configuration needed. Any required database tables are also created automatically on first start.

1 Add the Resource

1. Download the latest version of sd-beekeeping from the CFX Portal
2. Extract it into your server's resources directory
3. Ensure the resource is started in your server.cfg (or resources.cfg, in case you load resources differently). Simply ensuring the sub-folder (i.e. ensure [sd]) will work too, provided dependencies are started in a separate sub-folder before. Here's an example:

ensure oxmysql
ensure ox_lib
ensure qb-core
ensure ox_target

ensure sd-beekeeping

2 Add Items

Register 11 items in your inventory system. Item names use hyphens (e.g., bee-hive, not bee_hive).

ox_inventory

['bee-hive'] = {
    label = 'Bee Hive',
    weight = 1000,
    stack = false,
    close = true,
    description = 'A placeable bee hive for honey production.',
    consume = 0,
    server = {
        export = 'sd-beekeeping.useBee-hive',
    },
},
['bee-house'] = {
    label = 'Bee House',
    weight = 1000,
    stack = false,
    close = true,
    description = 'A placeable bee house for capturing wild bees.',
    consume = 0,
    server = {
        export = 'sd-beekeeping.useBee-house',
    },
},
['bee-queen'] = {
    label = 'Bee Queen',
    weight = 1000,
    stack = false,
    close = true,
    description = 'A queen bee, essential for hive production.',
},
['bee-worker'] = {
    label = 'Worker Bee',
    weight = 1000,
    stack = true,
    close = true,
    description = 'Worker bees that increase hive production.',
},
['bee-honey'] = {
    label = 'Bee Honey',
    weight = 1000,
    stack = true,
    close = true,
    description = 'Basic honey produced outside honey zones.',
},
['chiliad-honey'] = {
    label = 'Chiliad Honey',
    weight = 1000,
    stack = true,
    close = true,
    description = 'Honey harvested from the Mount Chiliad region.',
},
['green-hills-honey'] = {
    label = 'Green Hills Honey',
    weight = 1000,
    stack = true,
    close = true,
    description = 'Honey from the Vinewood Hills countryside.',
},
['alamo-honey'] = {
    label = 'Alamo Honey',
    weight = 1000,
    stack = true,
    close = true,
    description = 'Desert flora honey from the Alamo Sea region.',
},
['bee-wax'] = {
    label = 'Bee Wax',
    weight = 500,
    stack = true,
    close = true,
    description = 'Natural beeswax, a byproduct of honey harvesting.',
},
['bee-smoker'] = {
    label = 'Bee Smoker',
    weight = 1000,
    stack = false,
    close = true,
    description = 'A tool used to calm aggressive bees.',
},
['thymol'] = {
    label = 'Thymol',
    weight = 500,
    stack = true,
    close = true,
    description = 'A treatment used to cure infected bee hives.',
},

qb-core / qbx_core

['bee-hive']          = { name = 'bee-hive',          label = 'Bee Hive',          weight = 1000, type = 'item', image = 'bee-hive.png',          unique = true,  useable = true,  shouldClose = true, description = 'A placeable bee hive' },
['bee-house']         = { name = 'bee-house',         label = 'Bee House',         weight = 1000, type = 'item', image = 'bee-house.png',         unique = true,  useable = true,  shouldClose = true, description = 'A placeable bee house' },
['bee-queen']         = { name = 'bee-queen',         label = 'Bee Queen',         weight = 1000, type = 'item', image = 'bee-queen.png',         unique = true,  useable = true,  shouldClose = true, description = 'A queen bee' },
['bee-worker']        = { name = 'bee-worker',        label = 'Worker Bee',        weight = 1000, type = 'item', image = 'bee-worker.png',        unique = false, useable = true,  shouldClose = true, description = 'Worker bees' },
['bee-honey']         = { name = 'bee-honey',         label = 'Bee Honey',         weight = 1000, type = 'item', image = 'bee-honey.png',         unique = false, useable = true,  shouldClose = true, description = 'Basic honey' },
['chiliad-honey']     = { name = 'chiliad-honey',     label = 'Chiliad Honey',     weight = 1000, type = 'item', image = 'chiliad-honey.png',     unique = false, useable = true,  shouldClose = true, description = 'Chiliad region honey' },
['green-hills-honey'] = { name = 'green-hills-honey', label = 'Green Hills Honey', weight = 1000, type = 'item', image = 'green-hills-honey.png', unique = false, useable = true,  shouldClose = true, description = 'Green Hills honey' },
['alamo-honey']       = { name = 'alamo-honey',       label = 'Alamo Honey',       weight = 1000, type = 'item', image = 'alamo-honey.png',       unique = false, useable = true,  shouldClose = true, description = 'Alamo Sea honey' },
['bee-wax']           = { name = 'bee-wax',           label = 'Bee Wax',           weight = 500,  type = 'item', image = 'bee-wax.png',           unique = false, useable = false, shouldClose = true, description = 'Natural beeswax' },
['bee-smoker']        = { name = 'bee-smoker',        label = 'Bee Smoker',        weight = 1000, type = 'item', image = 'bee-smoker.png',        unique = true,  useable = true,  shouldClose = true, description = 'Calms aggressive bees' },
['thymol']            = { name = 'thymol',            label = 'Thymol',            weight = 500,  type = 'item', image = 'thymol.png',            unique = false, useable = true,  shouldClose = true, description = 'Hive infection treatment' },

ESX

INSERT INTO `items` (`name`, `label`, `weight`) VALUES
  ('bee-hive', 'Bee Hive', 1000),
  ('bee-house', 'Bee House', 1000),
  ('bee-queen', 'Bee Queen', 1000),
  ('bee-worker', 'Worker Bee', 1000),
  ('bee-honey', 'Bee Honey', 1000),
  ('chiliad-honey', 'Chiliad Honey', 1000),
  ('green-hills-honey', 'Green Hills Honey', 1000),
  ('alamo-honey', 'Alamo Honey', 1000),
  ('bee-wax', 'Bee Wax', 500),
  ('bee-smoker', 'Bee Smoker', 1000),
  ('thymol', 'Thymol', 500);

3 Add Item Images

Copy the item images from sd-beekeeping/images/ to your inventory's image folder. You can also download them directly from the container below.

Beekeeping Item Images11 images

bee-hive.png

bee-house.png

bee-queen.png

bee-worker.png

bee-honey.png

chiliad-honey.png

green-hills-honey.png

alamo-honey.png

bee-wax.png

bee-smoker.png

thymol.png

4 Start the Resource

To load the resource, you can either:

• Restart your server entirely, or
• Run the following commands in your server console (F8 or txAdmin live console):

refresh
ensure sd-beekeeping

Database Table

The sd_beekeeping table stores all facility data and is created automatically on first start:

Column	Type	Purpose
id	int(11)	Auto-increment primary key
hive_type	varchar(50)	hive or house
coords	varchar(255)	JSON position {x, y, z, h}
options	longtext	Validation and rotation data
data	longtext	Hive state (queens, workers, honey, wax, etc.)
citizenid	varchar(255)	Owner identifier
collaborators	JSON	Array of collaborator objects
durability	int	0–100 health percentage

Manual SQL (only if the table was not auto-created):

CREATE TABLE IF NOT EXISTS `sd_beekeeping` (
  `id` INT(11) NOT NULL AUTO_INCREMENT,
  `hive_type` VARCHAR(50) NOT NULL,
  `coords` VARCHAR(255) NOT NULL,
  `options` LONGTEXT DEFAULT NULL,
  `data` LONGTEXT DEFAULT NULL,
  `citizenid` VARCHAR(255) NOT NULL,
  `collaborators` JSON DEFAULT NULL,
  `durability` INT NOT NULL DEFAULT 100,
  PRIMARY KEY (`id`)
);

Configuration

Configure the resource to fit your server's needs. See the Configuration page for detailed explanations of each setting, or edit the config files directly in the resource's configs/ folder.