ESCROW
OPEN SOURCE
Introduction
Valenor Pets is a comprehensive pet ownership system for RedM servers. Players visit a pet shop NPC to browse and purchase from over 32 animal models — spanning dog breeds, cats, birds, and wild animals like wolves, bears, and foxes. Each owned pet persists across sessions, accumulates XP through daily care, levels up through 9 ranks, and maintains individual hunger, hygiene, health, and disease stats that require active attention. An in-world radial target menu drives all interactions, and an attack system lets combat-capable animals defend their owner. Supports both VORP and RSG frameworks via automatic detection.
What It Offers
32+ Pet Models Across Four Categories
The shop contains dogs (American Foxhound, Collie, Husky, Lab, and more), cats, birds (Owl, Parrot, Crow, Raven, Sparrow, and more), and wild animals (Fox, Wolf, Black Bear, Raccoon, Bullfrog, Snapping Turtle, and more) — each with unique visuals and species-specific behaviors.
Themed Vue 3 NUI Shop
Players browse pets through a polished Vue 3 + Tailwind interface with live category tabs, text search, and a rotating 3D preview camera. Each pet card shows breed, type, price, and a unique illustration.
Metabolism & Care System
Hunger, hygiene, health, and disease values decay on configurable ticks. Neglected pets become sick and take damage. Owners must feed, bathe, and interact with their pets regularly to keep them in good condition.
XP & Level Progression
Every care interaction rewards XP. Pets advance through 9 experience levels with configurable thresholds, and level is displayed on the pet stats panel so players can track their companion’s growth.
Follow & Shoulder Companion
Active pets follow their owner through the world. Small animals — birds and critters — can ride on the player’s shoulder as a persistent companion during travel.
Attack Behavior
Combat-capable pets (dogs, wolves, foxes, bears) can be directed to attack a selected target from the radial target menu. The attack selection system shows valid targets and confirms before engaging.
In-World Radial Target Menu
Holding the interaction key near an active pet opens a radial menu with contextual actions: Feed, Bath, Pet, Follow, Animations, and Attack. The menu updates dynamically based on the pet’s species and current state.
Per-Species Vocalizations
Each animal class has its own named sound set — dog barks, wolf howls, cat alerts, bird calls, and more — played contextually during interactions and idle moments with configurable delays and fallback handling.
Kennel Interaction
Players interact with kennel props placed in the world to store or recall their active pet. The kennel prop list and interaction distance are fully configurable in the shared config.
Auto-Revive System
When a pet’s health reaches zero it enters a downed state. A server-side timer automatically revives it after a configurable delay, preventing permanent pet loss from normal gameplay damage.
Full Persistence via oxmysql
A dedicated v_pets database table stores ownership, display name, model hash, category, and all metadata per character. Data is fetched on login and written on every meaningful state change.
VORP & RSG Framework Bridge
A clean bridge layer auto-detects vorp_core or rsg-core at runtime. Money deduction, item checks, notifications, and player identity all route through the bridge — no manual framework selection needed.
| | |
|—|—|
| Code is accessible | Yes |
| Subscription-based | No |
| Lines (approximately) | 5000+ |
| Requirements | oxmysql, vorp_core or rsg-core |
| Support | Yes |
