
Highlights

GrandRP-style investment flow (Daily + Long-Term)

Configurable NPCs + blips + interaction range

HUD timer with AFK pause + red AFK state

Exploit-safe logic & clean server validation

Persistent saving with optimized JSON storage
Included Features

Daily Investments (Time-Based)
• Free to start – costs only playtime (GrandRP-style).
• 1x per day (config + server enforced).
• Runs while the player is online, with an on-screen HUD timer.
• AFK handling: timer pauses + turns red in AFK mode, resumes automatically on movement.

Long-Term Investments (Deposit-Based)
• Start with a deposit (cash).
• Choose plans with defined hours and profit values.
• Server-side validation prevents plan spoofing.
• Configurable limits (e.g. max active long-term investments).

NPC Interaction
• Multiple NPC locations supported (Config.NPCs).
• Clean interaction prompt: [E] at hip height.
• Name tag + head marker above the NPC for visibility.
• Optional map blips with custom labels.

NUI + HUD (Modern UI)
• NUI opens instantly (no “nothing happens” delay).
• HUD shows remaining time and payout preview.
• AFK state is visually indicated with a red timer.
• Fully localized UI texts (DE/EN).
Configuration & Locales

config.lua
• Daily plans (duration, payout, 1x/day rules).
• Long-term plans (deposit, hours, profit).
• NPC positions, blips, marker settings, interaction distance.
• AFK settings (idle time, check interval, thresholds).
• HUD on/off + HUD position.

Locales (DE/EN)
All UI + server notifications are localized in one place.
Switch language via Config.Language (German / English included).
Storage & Requirements

Data Storage (JSON)
• Persistent state is saved in data/storage.json.
• Optimized saving logic to keep server performance stable.
• Designed to survive restarts and keep player investment history.

Dependencies
• ESX (es_extended) version supported.
• QBCore (qb-core) version included.
• No database required (JSON only).
(Pick the version that matches your framework.)
Installation
- Upload the resource folder to your server resources directory.
- Add to server.cfg: ensure vicexstudios_investments (or the QB resource name if separated).
- Configure config.lua: NPC locations, plans, AFK timing, HUD position, language.
- Restart the server.
- Go to the investment NPC and press [E] to open the menu.

GrandRP-Style Tip
Daily investments are intentionally free and balanced by time + AFK pause. Adjust daily payout values to match your server economy.
Performance & Support

Optimized
Designed for stable server performance with clean client/server separation and optimized persistent storage.

Support
Need help with setup or customization? Contact ViceX Studios support via Discord.
© ViceX Studios • Premium FiveM Resources