# btc-herbs — Native Herb Harvesting for RedM
## 🌿 What it is
btc-herbs uses **RDR2's native composites**
instead of a static prop with a floating marker and a custom menu. The game
itself raises the **original plant** — model, wind sway, native prompt, native
picking animation. Exactly the singleplayer experience, except **your server**
decides what the player gets.
| Common scripts | btc-herbs |
|---|---|
| Static prop + floating marker | Native plant, native prompt, native animation |
| Progress bar or NUI menu | Indistinguishable from the base game |
---
## 📊 What comes ready
### **53 herbs** · **7,452 spawn points** · **the whole map**
The entire game's flora — frozen north, forests, plains, swamp, desert,
riverbanks — each herb spawning exactly where it does in RDR2.
---
## 🔒 Security & performance
- **100% server-authoritative** — cooldown, reward roll and inventory checks
all run server-side. Native loot is suppressed.
- **Distance anti-exploit** — out-of-range requests are refused and reported to
your Discord webhook.
- **Item-by-item inventory validation** — no duplication; if it doesn't fit,
the cooldown isn't applied.
-
**Distance-based spawn/despawn** — only nearby herbs exist client-side.
-
**Zero database** — cooldowns live in memory.
---
## 🛠️ One-line configuration
```lua
Config.PlantCooldown = 60 -- minutes
Config.GlobalPlantCooldown = true -- true = global · false = per player
```
Rewards support multiple items per herb, each with its own chance — add a rare
drop in one line in `config/plants.lua`.
---
## 🧠 Pick or eat — extensible without touching the core
Like in singleplayer, the player can **pull** the plant (item to inventory) or
**eat** it on the spot (no item, just the animation). Two open files
(`client/open.lua`, `server/open.lua`) ship with ready hooks — `onHerbEaten`,
`onHerbPicked`, `modifyRewardChance`, `canEat` — to plug in your own
metabolism, buffs or job perks without touching the protected code.
---
## 🔔 Native notifications
All notifications are **native RDR3**, via btc-core's `Core.notify` — no
generic FiveM toasts. Swappable with a single function rewrite in
`config.lua`.
---
## 📦 What you need
| Requirement | Note |
|---|---|
| **[btc-core](https://betiucia-scripts-shop.tebex.io/)** | Our framework bridge — **required** |
⚠️ The script delivers the items but does **not** create them — register the
53 items in your framework (full list in the README).
Runs through btc-core on **RSG** and **VORP**. Translations (`pt-br`, `eng`)
included, open file.
---
## 🔓 Escrow — what stays open
- ✅ `config/config.lua`, `config/plants.lua`, `config/coords.lua`
- ✅ `locale.lua`
- ✅ `client/open.lua` and `server/open.lua` — pick/eat hooks and effects
---
## ❓ FAQ
**Props or native models?**
Native models — the same `COMPOSITE_LOOTABLE_*_DEF` plants from singleplayer.
**Can players duplicate items or harvest from far away?**
No — all logic runs server-side; out-of-range attempts are blocked and logged.
**Do I need a database or ox_lib?**
No to both. Cooldowns are in memory; notifications use btc-core's `Core.notify`.
**Per-player or global cooldowns?**
Your choice, one config line.
---
### **btc-herbs**
**The entire flora of Red Dead Redemption 2, harvestable, secure, and on your server.**