Configuration Reference

Reference for the current oxide-weed config layout. All config files live in shared/ and can be edited freely — they are never encrypted.

Settings Live In The Database

The config files below are factory defaults. The first time the resource starts, every setting is copied into your database (an oxide_settings table, created automatically). From then on, the database is the source of truth: admins change settings in game with /weed settings (see Admin), changes apply immediately without a restart, and they survive restarts.

What that means in practice:

• Editing a config file after the first start does nothing for settings already in the database — change them in /weed settings instead, or use the menu's "reset to default" button to pull a file value back in.
• New settings added by a resource update are picked up from the files automatically on the next start.
• To start completely fresh from the files, delete this resource's rows from the oxide_settings table and restart.

This reference documents what each setting does — the same descriptions appear in the in-game editor.

Config File Map

General Settings

File: shared/config.lua

Dirty Money

Scientist services use Config.DirtyMoney.

Plant Settings

Default water sources:

• watering_can: metadata source, fillAmount = 25, metaKey = 'water_level', metaCost = 10
• water: item source, amount = 1, fillAmount = 25

Fertilizer defaults:

• item: fertilizer
• amount: 1
• fill amount: 35

Harvest defaults:

• return pot: true
• pot item: plant_pot

Watering Can

Processing

Labels

Placement Zones

Config.ZoneMode decides how map areas control where players may plant and place equipment:

Config.SafeZones and Config.AllowedZones are separate lists and both are kept no matter which mode is active, so you can set up both and switch between them without redrawing anything. Each zone has a name, a list of points outlining the area, and a minZ/maxZ height band. A Legion Square example ships in SafeZones — replace or remove it as you like.

Item Usage Whitelist

Config.UsageWhitelist restricts who may use individual items. It ships empty, which means every item is usable by anyone. Each rule looks like this:

{ item = 'weed_table', jobs = { 'police' }, gangs = { 'ballas' }, minRank = 2, dutyOnly = false }

• Items with no rule stay usable by everyone.
• A rule passes if the job list matches or the gang list matches.
• Leaving both lists empty allows any job or gang — minRank and dutyOnly are still checked.
• minRank is the numeric grade level; 0 means any rank.
• dutyOnly applies to jobs only. Gangs have no duty state, so it's ignored on the gang side.
• Job and gang names are matched ignoring capitalisation.

Rules key on the literal item name, so if you rename an item elsewhere in the config its rule stops applying.

Police Alerts

Config.Dispatch makes growing carry a risk of being reported to police. It ships off (alert chance 0), so nothing changes until you turn it on.

When a player starts a stage the server rolls once. On a hit, a dispatch call goes out at the plant's or table's location — not the player's, so a suspect can't fake or move it.

The four stages you can tune separately are Plant, Harvest, Dry and Brick press. Planting catches a grow as it's being set up; harvesting catches the payoff. A common setup is a low master chance with planting turned off, so only an established grow gets reported.

Wild plant harvesting never alerts — it's a public, outdoor activity and the plants aren't anybody's operation.

What "chance" means in practice. It's rolled per stage started, not per harvest finished. A player who starts, cancels, and restarts rolls twice — but the site cooldown means only the first can actually alert. A rejected placement (blocked by a placement zone) never rolls at all.

What you need installed

Alerts go through whatever dispatch resource you run. Most are supported, including ps-dispatch, qs_dispatch, cd_dispatch, lb-tablet and the common MDTs. You don't strictly need one — with no dispatch resource installed, players with the alert job get a notification and a map blip instead.

If nobody with the alert job is online, the alert is discarded. That's intentional: there is no queue of stale calls waiting for the first officer to log in.

Animations

Default placement and removal animation:

• dict: weapons@first_person@aim_rng@generic@projectile@sticky_bomb@
• name: plant_floor
• duration: 1000ms

Config.SceneAnims sets the looping working animation other players see while someone is inside a private scene (brick press, drying rack, freeze dryer, crossbreeding) — without it the ped would stand frozen. Set a scene's entry to false to disable that animation.

Plants

File: shared/config/plants.lua

Current default plant type:

• cannabis_seed

Key defaults:

• item: cannabis_seed
• required extra item: plant_pot
• bud model: bkr_prop_weed_bud_01b
• yield: weed_bud, 3-8

Stage times:

• stage 1: 60 * 60
• stage 2: 60 * 60
• stage 3: 60 * 60
• stage 4: 60 * 500

Strains

File: shared/config/strains.lua

Base strains currently shipped:

• generic
• og_kush
• purple_haze
• sour_diesel
• blue_dream
• northern_lights
• white_widow
• girl_scout
• granddaddy_purple
• amnesia_haze

Each strain defines:

• label
• baseQuality
• requiredLevel
• traits

Genetics

File: shared/config/genetics.lua

Trait order:

• potency
• flavor
• yield
• resilience
• growth_speed
• thc
• cbd
• aroma
• density
• frost

Key defaults:

Quality weights:

• potency: 0.20
• thc: 0.18
• density: 0.13
• frost: 0.13
• flavor: 0.13
• aroma: 0.13
• cbd: 0.10

Drying

File: shared/config/drying.lua

Weed table drying defaults:

Heater defaults:

Heater Snap Points

Config.Drying.heater.snapOffsets defines where heaters snap onto a drying rack. Each entry can take either form:

-- Offset only (heater inherits the rack's rotation)
vec3(1.408, 0.0, -0.001),

-- Offset + rotation delta (added on top of the rack's rotation)
{ offset = vec3(1.408, 0.0, -0.001), rotation = vec3(0.0, 0.0, 90.0) },

The rotation field is a delta in degrees added to the rack's rotation, so heaters stay correctly oriented regardless of how the rack itself is placed. Use this when a custom drying rack model needs heaters to face a specific direction at each snap point. While the heater is locked to a snap point, scroll-wheel rotation has no effect — move off the snap to rotate manually.

Equipment

File: shared/config/equipment.lua

Weed Table

• item: weed_table
• equipment type: weed_table
• includes bagging and packaging recipes

Default bagging recipe:

• pruned_weed_bud x1
• baggy x1
• output weed_1g x1

Default packaging recipes:

• weed_1g x3 -> weed_eighth x1
• weed_eighth x2 -> weed_quarter x1
• weed_quarter x2 -> weed_half x1
• weed_half x2 -> weed_ounce x1

Storage Tote

Water Containers

Progression-gated equipment

Brick Press

Default press settings:

• input item: dried_weed_bud
• input amount: 10
• output item: weed_brick
• XP reward: 20
• animation duration: 9000ms

Lamps

File: shared/config/lamps.lua

Default lamp:

• item: grow_lamp
• model: xm_prop_base_tripod_lampb
• growth multiplier: 1.5

Freeze Dryer

File: shared/config/freezedryer.lua

Derived capacity:

• total trays: 18
• max slots: 144

Drying Rack

File: shared/config/dryingrack.lua

Derived capacity:

• total capacity: 32

Progression

File: shared/config/progression.lua

XP reward defaults:

Rolling (3 XP) and smoking (5 XP) are built in. Selling XP is configured in oxide-drugselling, not here.

Level thresholds:

• 1: 0
• 2: 100
• 3: 300
• 4: 650
• 5: 1200
• 6: 2000
• 7: 3200
• 8: 5000
• 9: 7500
• 10: 11000

Smoking

File: shared/config/smoking.lua

Core defaults:

Rolling items:

• rolling_papers -> joint
• cigarillo_wraps -> blunt

Both require:

• weed_1g
• lighter

Controls:

Needs-effect toggles:

Effect scales:

Screen effects:

• timecycle: spectator6
• timecycle strength: 0.66
• camera shake: DRUNK_SHAKE
• amplitude: 2.5
• drunk clipset: MOVE_M@DRUNK@SLIGHTLYDRUNK

Store

File: shared/config/store.lua

Core defaults:

Blip defaults:

• enabled: true
• sprite: 628
• color: 2
• scale: 0.5
• label: store_blip

Default categories:

• essentials
• processing
• equipment
• custom

Config.Store.customItems is an extension hook for additional products.

Scientist

File: shared/config/scientist.lua

Core defaults:

Lab report:

• price: 500
• required level: 2

Cloning:

• required level: 4
• options:
  • 5 for 2500
  • 10 for 4000
  • 25 for 7500

Blip defaults:

• enabled: false
• sprite: 499
• color: 2
• scale: 0.7
• label: scientist_blip

Wild Plants

File: shared/config/wildplants.lua

Yield defaults:

• weed_bud
• amount: 1-4

Shipped default zones:

• buen_vino_rd (10 plants)
• route_68 (20 plants)

Each zone defines:

• name
• plants
• points
• minZ / maxZ (the zone's vertical band — older configs with a thickness value are converted automatically)

To add a zone, open the Wild Plants section of /weed settings, add a spawn zone entry, give it a name and a plant count, and press the shape button to draw the outline directly in the world — a fly-around editor lets you place, nudge, and preview the points. Plants pick random spots inside the outline. Placement zones (blocked areas and allowed areas) are drawn the same way from their own section.

Next Steps