**LS Natur** brings three wilderness systems - **hunting, herbalism and world gathering** - together in one lightweight RedM/VORP resource, tied together by an RDR2-style **Field Journal**. Item-based, **no SQL tables for progress**, fully config-driven, and available in **4 languages**.
video preview:
**Store:** https://lusitano-scripts.tebex.io/
**Discord:** Lusitano Scripts
## Field Journal (NUI) - the centrepiece
A per-character compendium in the style of the RDR2 studies book.
- **Five tabs:** Hunting, Small Fauna, Herbs, Gathering, Statistics.
- **Two states per animal:** *Spotted* (look at it through normal or advanced binoculars) and *Hunted* (killed or skinned, with a Perfect Pelt flag). Spotting an animal you have never hunted still fills in its page.
- **Hunter statistics:** kills, skins, perfect pelts, rare plants, with progress bars per category.
- **Saved per character via KVP** - no SQL table for journal progress, nothing to import, nothing to migrate.
- Opens with `/journal`. The keybind is **optional**: enable `registerKeybind` in the config and pick a key (J is the suggested one).
- **Works standalone.** It does not need LS_evolution or any other Lusitano script.
## Hunting
- Skin and butcher animals into pelts and carcasses.
- **Three quality tiers** (poor / good / perfect) carried on the item.
- Sell at butchers placed through the config.
- Optional **double pay event** for weekends or server events.
- **Custom skinning** flow instead of the vanilla one.
- Butcher locations are exposed through `exports.LS_natur:GetButcherLocations()`, so other resources can reuse them. LS_ranch already does.
## Herbalism
- Herbs and plants placed across the map, each with its own model and blip.
- Fully defined in `config/herbs.lua`: what grows where, what it gives, how often it comes back.
## Gathering
- Configurable world-resource collection, separate from herbs so you can tune the two economies independently.
## Wildlife population control (optional)
Two independent systems you can turn on or leave off:
- **Ambient density boost** - makes the vanilla wildlife denser without spawning anything.
- **Zone-managed spawner** - separate lists for **small** and **large** animals, a target count per species, a global ceiling, and automatic cleanup of what wanders off.
Both are off by default. Turn on only what your server needs.
## Interaction
Interaction runs on **native RedM prompts** through **LS_lib**. No `murphy_interact`, no extra textures, no NUI overlay for a simple prompt. There is a native fallback if you prefer not to use the prompt layer at all.
## Languages
English, Portuguese, Spanish and French, including the whole Field Journal interface. Switch in `config/locale.lua`; the files live in `languages/`.
## Optional: LS_evolution
If you also run **LS_evolution**, hunting and herbalism grant XP and knowledge buffs. If you do not, the integration is skipped silently - nothing breaks, nothing errors.
## Configuration
Everything lives in the `config/` folder, split by system:
| File | What it holds |
|—|—|
| `config/hunting.lua` | Animals, qualities, butchers, rewards, dev commands |
| `config/herbs.lua` | Herb locations, models, blips, respawn |
| `config/gathering.lua` | World resources |
| `config/journal.lua` | Field Journal entries and keybind |
| `config/population.lua` | Density boost and zone spawner |
| `config/integrations.lua` | LS_evolution and other hooks |
| `config/locale.lua` | Language |
The secondary currency is **off by default** (`Config.EnableRolPoints = false`) - turn it on only if your server actually has a third currency configured in vorp_core.
## Installation
1. Install **LS_lib** (free) and start it **before** LS_natur.
2. Drop the `LS_natur` folder into your resources. Keep the exact folder name - the resource has anti-rename protection.
3. Add `ensure LS_natur` to your `server.cfg`, after `ensure LS_lib`.
4. Import `sql/items.sql`. It registers every hunting, herb and gathering item in vorp_inventory with `INSERT IGNORE`, so it will not touch items you already have. Without this step the items do not exist in the database and hunting gives no loot.
## Other Lusitano Scripts releases
- [Lusitano Marketplace - let your players trade]([PAID] Lusitano Marketplace — Player Auction House & Barter (VORP))
- [Lusitano Sell To NPCs - black market selling and haggling]([PAID] LS_SellNpc — Black-Market Selling & NPC Haggling (RedM / VORP))
- [Lusitano Thief - search and robbery system]([PAID] Lusitano Thief — Search & Robbery System (RedM / VORP))
- [Lusitano Ranch - complete ranch and livestock economy](Lusitano_ranch — Complete Ranch & Livestock Economy for RedM (VORP))
## Support
Discord: Lusitano Scripts
The config files, the language files and the README ship open and editable. Only the core logic is escrowed.
| | |
|—|—|
| Code is accessible | No |
| Subscription-based | No |
| Lines (approximately) | 13550 |
| Requirements | oxmysql, vorp_core, vorp_lib, vorp_inventory, LS_lib |
| Support | Yes |