gfx-weed

A comprehensive weed farming, processing, and selling system for FiveM. Players can plant seeds, grow plants with a genetics system, water and fertilize them, harvest buds or seeds, roll joints on processing tables, and sell joints to NPCs on the street.

Info

Dependencies

• Framework: es_extended (ESX) or qb-core (QBCore)
• Database: oxmysql, ghmattimysql, or mysql-async
• Inventory: One of: qb-inventory, ox_inventory, qs-inventory, ps-inventory, codem-inventory, gfx-inventory, esx_inventoryhud
• Discord Bot Token (optional, for player avatar fetching)

Installation

1. Import SQL

Import the planted_weeds.sql file into your database:

CREATE TABLE IF NOT EXISTS `planted_weeds` (
  `id` varchar(50) DEFAULT NULL,
  `grower` varchar(50) DEFAULT NULL,
  `coords` longtext DEFAULT NULL,
  `plantTime` int(11) DEFAULT NULL,
  `stage` int(11) DEFAULT 1,
  `health` float DEFAULT 100,
  `water` float DEFAULT 100,
  `ground` float DEFAULT 100,
  `quality` float DEFAULT 100,
  `drying` float DEFAULT 100,
  `growth` float DEFAULT 100,
  `genetics` varchar(50) DEFAULT NULL
) ENGINE=InnoDB DEFAULT CHARSET=latin1 COLLATE=latin1_swedish_ci;

2. Copy Files

Copy the gfx-weed folder into your server's resources directory.

3. server.cfg

ensure gfx-weed

4. Add Items to Your Inventory

Make sure the following items exist in your inventory system:

Configuration

Client Config (config/client_config.lua)

Server Config (config/server_config.lua)

Locale (config/locale.lua)

Exports

No exports are created by this script.

Events

Client Events

gfx-weed:plant:place

Triggered by the server when a player uses a seed item. Starts the plant placement preview on the client.

-- Triggered server -> client automatically when seed item is used
-- Parameters:
--   itemData (table) - The item data from inventory, may contain itemData.info.genetics

gfx-weed:sync:syncWeed

Synchronizes plant data from the server to the client for nearby plants.

-- Triggered server -> client
-- Parameters:
--   data (table) - Table of weed data keyed by plant ID

gfx-weed:sync:addWeed

Notifies all clients that a new plant has been placed.

-- Triggered server -> all clients
-- Parameters:
--   weed (table) - Full weed data { id, coords, stage, growth, health, water, ground, quality, drying, genetics, plantTime }

gfx-weed:sync:deleteWeed

Notifies all clients that a plant has been removed (harvested, destroyed, or burned).

-- Triggered server -> all clients
-- Parameters:
--   id (string) - The plant ID to remove

gfx-weed:client:openTable

Opens a processing table interaction. Can be triggered locally or from another script.

-- Parameters:
--   id (number) - The table ID from Config.Tables
TriggerEvent("gfx-weed:client:openTable", tableId)

Server Events

gfx-weed:server:syncWeed

Client requests plant data sync from the server for a set of plant IDs.

-- Triggered client -> server
-- Parameters:
--   requestList (table) - Table of plant IDs mapped to true, e.g. { ["abc123"] = true }

Commands

Features

Planting System

• Use the seed item to enter placement mode with a ghost preview object
• The preview shows green (valid) or red (invalid) placement based on ground material
• Ground material type determines initial ground quality (configurable via MaterialQualities)
• Plants cannot be placed too close to existing plants (proximity check)
• Planting triggers a gardening animation before the plant is created

Growth & Genetics System

• Plants grow through 6 stages, each with a different prop model
• Growth is affected by genetics, ground quality, and a configurable growth multiplier
• Genetics are a 6-character string using genes: G (Growth Rate), Y (Yield), H (Hardiness), W (Water Intake), X (Null)
• When multiple plants are close together (within 1 unit), genetics crossbreed using a weighted probability system
• Seeds planted from harvested seeds carry the parent plant's genetics

Plant Care

• Watering: Click the watering can when interacting with a plant. Requires a water item. Adds 70-80 water. Animated with particle effects
• Fertilizing: Click the fertilizer bucket. Requires a fertilizer item. Adds 15-25 ground quality. Animated with particle effects
• Trimming/Harvesting: Click the trimmer tool
  • If the plant is at stage 3-5, you can harvest seeds (amount based on quality)
  • If the plant is at stage 6 with 85%+ growth, you can harvest buds (yield based on quality, health, growth, drying, and genetics)

Plant Health

• Water drops over time based on water intake genetics
• If water falls below 30, health decreases (mitigated by hardiness genetics)
• If water stays above 65, quality and health improve
• Plants can be destroyed by nearby fires (fire proximity detection)

NUI Interface

• Real-time plant status display when looking at a plant (growth, health, water, ground quality, stage, genetics, age)
• Interactive camera system for plant and table interactions
• Configurable color theme
• Dot indicator when looking at NPCs for selling

Processing Tables

• Pre-configured table locations with weed processing props
• Interactive drag-and-drop system: place a bud on rolling paper, right-click to roll, drag joint into backpack
• Rolling a joint consumes 1 bud + 1 rolling paper, produces 1 joint
• Tables auto-spawn/despawn based on player proximity

Selling System

• Aim at NPCs on the street while having joints in inventory
• Press the interact key to approach the NPC and initiate a sale
• NPC purchase chance is based on ped model (configured in PedChances)
• If the NPC model is not in the list, cops are alerted instead
• Selling plays walk-up and handshake animations with a cinematic camera
• Configurable joint price

Database Persistence

• All planted weed data is stored in the planted_weeds database table
• Plant state is periodically saved to the database (every ~100 seconds)
• Plants persist across server restarts

Framework Compatibility

• Auto-detects ESX or QBCore framework
• Auto-detects inventory system from 7 supported inventories
• Auto-detects SQL library from 3 supported options
• Custom notification support via config override

Troubleshooting