Features
🧰 Features
💗 Girlfriend Companion System
🔹 Dynamic NPC companions with relationship progression 🔹 Custom dialogue based on romance levels 🔹 Personalized homes, inventories, and behaviors 🔹 State-aware interaction system that pauses NPC AI during conversations 🔹 Girlfriend faces the player naturally when the interaction menu opens
🚶♀️ Follow & Wander Logic
🔹 Girlfriends can follow the player on foot or horse 🔹 Intelligent mounting/dismounting synced with player actions 🔹 Automatically returns to ambient wandering when not following 🔹 Idle wandering/scenario tasks now temporarily suspend while menus are open 🔹 Seamless resume of normal AI behavior after interaction ends
🏡 Home Assignment
🔹 Players can set a girlfriend’s home location 🔹 Auto-spawn logic ensures she appears nearby at login 🔹 Includes bell prompt to "call" her outside if home
🎁 Gift & Reward System
🔹 Custom gift preferences with relationship impact 🔹 Cooldown & reward tracking to prevent abuse 🔹 Surprise gift delivery based on romance level & random chance
🍲 Meal Requests
🔹 Once bonded, girlfriends can cook meals for the player 🔹 Configurable cooldowns and randomized meal selection 🔹 Inventory reward system using VORP item integration
💬 Interaction Menu
🔹 Context menu with dialogue, gift, status, and custom options 🔹 Romance and friendship stats available through UI 🔹 Unlocks special features like moving homes and inventory access 🔹 Menu system now triggers companion “conversation mode” 🔹 NPC remains still until the player closes the menu
🐎 Horse Companion Support
🔹 Each girlfriend can spawn her own horse 🔹 Includes follow logic, despawn conditions, and mount sync
📦 Inventory System
🔹 Dedicated shared stash per girlfriend 🔹 Fully VORP-integrated with vorp_inventory 🔹 Supports item limits, and live sync
💀 Hunger & Death Logic
🔹 Background hunger system requiring food in stash 🔹 Configurable interval, food types, and failure threshold 🔹 Can knock out or kill the NPC if unfed
🛡️ Safety & Logging
🔹 Robust error handling and edge case prevention 🔹 Discord webhook logs for gifts, meals, and surprises 🔹 Player name, ID, items given, and timestamps included 🔹 Improved cleanup logic preventing server errors when players disconnect 🔹 Removes task-spam to prevent netGameEvent overflow crashes
⚙️ Fully Configurable
🔹 All relationship values, gift logic, home checks in config.lua
🔹 Easy to define new girlfriends, behaviors, gifts, and meals
🔌 VORP Integrated
🔹 Configurable behavior pause/resume rules during interaction mode
Last updated