gm_oxy

Overview

gm_oxy is a GTA V FiveM/QBX resource that provides oxy delivery runs. Players can start a delivery run from a configured NPC, receive oxy pills, and complete randomized delivery stops to earn money and item rewards.

Features

• NPC interaction to start oxy delivery runs
• Randomized delivery route and multiple drop-off points
• Delivery zone markers with optional waypoint support
• Item reward system with rarity-based drops
• Money reward on each delivery
• Optional black money laundering mechanic during deliveries
• Run cooldowns per player and global cooldown support
• Admin commands to reset cooldowns and cancel active runs

Requirements

• qbx_core
• ox_lib
• ox_target
• ox_inventory
• sleepless_waypoints (optional, only if Config.Waypoint is set to sleepless_waypoints)

Installation

1. Place the gm_oxy folder inside your server resources directory.
2. Add ensure gm_oxy to your server configuration file (server.cfg).
3. Ensure your server has the required dependencies running.

How It Works

1. Player interacts with the start NPC.
2. The player pays Config.StartCost and receives oxy pills.
3. The server selects a random set of delivery locations and tracks the active run.
4. The player travels to each delivery point and delivers one oxy pill.
5. On delivery, the player receives money and a random reward item.
6. When all deliveries are complete, the run ends.

Configuration

config/shared.lua

Important settings:

• Config.StartCost — Cash required to begin a run
• Config.OxyItem — Item name used for oxy pills
• Config.MinPills / Config.MaxPills — Number of deliveries per run
• Config.MaxDeliveryDistance — Server-side distance validation for completed deliveries
• Config.Waypoint — Use sleepless_waypoints to enable waypoint creation
• Config.DeliveryBlip — Blip appearance for delivery points
• Config.DeliveryLocations — Predefined delivery point coordinates
• Config.DeliveryNPC — Optional delivery NPC spawning settings
• Config.Messages — Notification text displayed to players

config/server.lua

Important settings:

• Config.NPC — Start NPC model, location, and blip settings
• Config.RewardItems — Item rewards, counts, and rarity chances
• Config.MoneyPerDelivery — Cash reward range per delivery
• Config.MoneyLaundering — Optional black money conversion settings
• Config.StartRunWebhook and Config.CompleteDeliveryWebhook — Webhook URLs for logging events

Admin Commands

• resetoxycooldown <id> — Reset a player's oxy run cooldown
• resetglobalcooldown — Reset the global oxy run cooldown
• canceloxyrun <id> — Cancel a player's active oxy run

Notes

• The resource uses exports.qbx_core for player data and notifications.
• Delivery NPC spawning is optional; the run still works if NPC spawn fails.
• The client syncs active run state when the player loads or when the resource starts.