> ## Documentation Index
> Fetch the complete documentation index at: https://lationscripts.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Weed - Changelog

> A chronological log of every release, feature addition, and bug fix

<Update label="4.4.0" description="Jul 14, 2026">
  * **Player stats menu**
    * Added a `/weedstats` command that opens a clean menu showing your level, XP progress to the next level, and lifetime stats (plants harvested, bud produced, joints rolled, weed bagged, farms searched).
  * **Production overview chart**
    * The overview graph now tracks three lines - plants harvested, joints rolled, and weed bagged - each its own color, with a clickable legend to show/hide any of them.
    * Added to both the Lab Management overview (per-lab) and the Admin panel overview (whole server).
  * **Seed return on harvest**
    * New admin option to reward a strain's seeds when a mature plant is harvested - gated by a minimum plant health, with a configurable chance and min/max seed amount.
    * Players and lab workers are configured separately. Found under Planting → Seed Return.
  * **Fertilizer menu hotkeys**
    * The fertilizer selection menu now auto-assigns number keys (1-9) to each fertilizer, so you can pick one by keyboard instead of only clicking.
  * **Interaction distance**
    * Added an open-source interaction distance value in `client/utils/interact.lua` (default raised to `2.0`) that applies across ox\_target, qb-target, and interact - raise it if targets like a ped behind a counter are hard to reach.
  * **Joint usable toggle**
    * Disabling a strain's joint now actually stops it registering as a usable item, instead of registering it and silently doing nothing on use. The panel now notes that enabling/disabling requires a resource restart.
  * **Packager heading fix**
    * Fixed lab packagers turning sideways between actions. They now stay put at their table and face it correctly the whole time they work.
  * **Lab workers & metadata**
    * Lab workers now drain a watering can / fertilizer's durability as expected and only consume it once empty, instead of consuming the whole item every action. Applies when item metadata is enabled. ⚠️ Only works with `ox_inventory` & `jaksam_inventory`.
</Update>

<Update label="4.3.0" description="Jun 22, 2026">
  * **Supply shop metadata fix**
    * Fixed watering cans, plant revive kits, and fertilizer bought from the supply shop spawning without durability when the corresponding Setup → Metadata flags are enabled. Purchases now pass item metadata as expected.
  * **Plant blip visibility fix**
    * Fixed an error causing plant map blips showing for multiple player(s) when someone else planted.
  * **Plant spacing**
    * Added configurable minimum distance between plants; configurable in Admin → Planting → Placement.
  * **Max DUIs**
    * Added configurable cap on nearby plant DUIs. When set, only the closest X plants show a DUI overlay. Configurable in Admin → Setup → General under DUI Overlay.
  * **Harvest pot return**
    * Added configurable chance to return the plant pot when harvesting. Separate settings for player harvests and lab botanist worker harvests. Configurable in Admin → Planting → Harvest.
  * **Joint stress relief**
    * Added configurable stress relief when smoking joints. Per-strain enable and reduction amount in Admin → Joints → Effects.
</Update>

<Update label="4.2.0" description="Jun 18, 2026">
  * **Streaming fix (broken map, reload required)**
    * Fixed map and texture streaming issues in weed labs (broken map on exit & inside), especially at a low texture budget. Plant overlays now use significantly less memory and clean up was improved on exit. All testing and resolutions were performed at an extended texture budget of 0. I do recommend keeping it at approx. \~25% for more stable FiveM client behavior overall, but unrelated to this resource specifically.
  * **Added Lab Marketplace export**
    * You can open the lab marketplace UI anyway or anywhere you want via the use of the new export: `exports.lation_weed:openLabMarketplace()`
  * **New Seed Dealer options**
    * You can now set a "custom" payment method at the seed dealer. You can also assign an "Active Dealers" value, which means you can have 1, 2 or more dealers spawn around the map during each cycle.
  * **Require lab owner be online**
    * You can now optionally require the owner of a lab be online in order for players to perform raids. This option only affects civilians (players) and does not impact police raids.
  * **Page persistence**
    * Stores the active admin page and list selection for strains, soils, fertilizers, farms, and joints in localStorage so reopening the panel returns admins to where they left off.
  * **Lab coordinate tools (admin)**
    * When adding or editing lab locations, the admin panel now has quick coordinate actions in a capsule icon group: capture your current position, copy entrance coords to the clipboard, or teleport to the lab. These are available in the lab editor and on each row in the labs list (between edit and delete).
  * **Farm level requirement**
    * Weed farms can now require a minimum player level to search plants, similar to planting strains. Default is level 1 (no lock). Set higher in Admin → Farms → Required Level to gate farms behind progression.
</Update>

<Update label="4.1.0" description="Jun 16, 2026">
  * **Admin Panel "Joints" page**
    * The accordion option for the "Speed" effect was bugged. If enabled, it wouldn't expand to show the input options. This layout has been changed to always show all options, and just enable or disable input fields conditionally based on whether the effect is enabled or not.
  * **Item metadata toggles**
    * Botanist workers now apply bud purity metadata on harvest when **Buds** is enabled, matching player harvest. **Joints** and **Bagged** toggles now control pass-through on roll/bag separately (they previously ignored those settings and used **Buds** instead). Packager workers use the same logic when auto-packaging from lab stashes.
  * **Shop and dealer blips**
    * Supply shop and seed dealer blips were always visible on the mini-map at any distance. They now use short range only, matching plants, farms, and labs.
  * **Placed table props**
    * Placed weed tables could float above the ground after confirming placement or on reload. Spawn now snaps to the ground with `PlaceObjectOnGroundProperly`, matching how plant props are handled.
  * **Weed table item and v3 database upgrades**
    * The weed table item could do nothing from inventory (especially after enabling tables in Admin or upgrading from v3), or fail to place due to old v3 database schema. Usable-item registration now waits for config to load and updates when admin settings are saved. Startup migrates existing `lation_weed_tables` to add `AUTO_INCREMENT`.
  * **Lab payment accounts**
    * Labs now support separate payment methods for shop purchases, wallet deposits, withdrawals, and sell refunds. Each can be set to bank, cash, or a custom item in Admin → Labs → Money.
</Update>

<Update label="4.0.0" description="Jun 15, 2026">
  v4 released!
</Update>