A fully featured and highly optimized naturalist system for RedM servers supporting both VORP Core and RSG Core. Players can study wildlife, complete animal compendiums, hunt legendary creatures, and extract blood samples through a complete and immersive gameplay loop built around progression, daily rewards, and field research.

[SHOWCASE VIDEO]

Features

• Players equip binoculars and observe wild animals in the field. Study progress fills automatically based on proximity and time spent, rewarding careful, patient observation over spam-clicking.
• A full compendium of wildlife is included and ready to configure, deer, elk, bison, bear, puma, wolf, fox, beaver, eagle, hawk, and many more. Every animal has its own entry, image, and reward value.
• 10 Legendary Animal Missions: Once a player has proven themselves in the field, legendary beasts become available, one mission per day per character. Each legendary animal spawns at a random location from a configurable pool, keeping hunts fresh and unpredictable.  
• The compendium is a physical inventory item. Players must buy it from an NPC before they can access the full UI, adding economic purpose and a meaningful entry point into the system.
•  Each day, a set of random animals are marked as bonus targets. Completing them awards double cash, giving experienced players a reason to log in and explore daily.
• Players can sedate animals using tranquilizer ammo and a varmint rifle. Approaching a sedated animal triggers an extraction interaction that rewards blood sample items, common samples from normal animals, rare samples from legendaries. Samples can be sold to NPC vendors for extra income.
• Naturalist NPCs are placed across the map in Valentine, Blackwater, and Rhodes. Each one sells the compendium and buys blood samples. Locations, models, prices, and sold items are all fully configurable.  
• Completing an animal does not automatically pay out. Players open the compendium, review their progress, and manually claim rewards,  making every payout feel intentional and satisfying.
• Choose between native RedM key prompts or sleepless_interact directly from the config file, no script edits needed.  
• Dedicated webhook channels for blood extractions, NPC sales, and legendary mission completions. Full visibility into player activity directly from Discord.
• English and Spanish locale files are included. Easily add new languages by copying a locale file.
• Distance-Based Entity Streaming: NPCs are spawned and tracked using lib.points, so client-side processing only runs near active zones. Players far from vendors have no overhead.
• Server-Authoritative Progression: All study progress, daily bonus state, and legendary mission cooldowns are stored server-side in a persistent database. Nothing is faked on the client, progress survives crashes, reconnects, and server restarts.

Requirements

Framework (one required):

• vorp_core + vorp_inventory ,  for VORP servers
• rsg-core + rsg-inventory , for RSG servers

Always required:

• ox_lib
• oxmysql

Optional:

• sleepless_interact , only needed when Config.InteractionSystem = 'sleepless'

Installation

1. Place the ys_naturalist folder in your resources directory.
2. Run install.sql to create the required database tables and insert default items (VORP).
3. For RSG: add the four item entries from the README into rsg-core/shared/items.lua.
4. Add ensure ys_naturalist to your server.cfg after your framework and inventory resources.
5. Set Config.Framework to 'vorp', 'rsg', or 'auto' in config.lua.