Changelog

• Cross-framework support via o-link - QBCore, QBX, and ESX are all supported with zero configuration. Framework is auto-detected at runtime.
• o-link bridge layer - bridge/_loader.lua exposes the olink global plus shared FormatNumber / FormatMoney helpers used by every server module.

• NUI Updated - NUI style has been updated along with polishing out previously incomplete features.
• Server modules split for clarity - server/credit.lua, server/security.lua, server/business.lua, server/interest.lua, server/scheduler.lua, and server/compat.lua are now standalone modules (previously folded into fewer files).
• Config split into five files - config/config.lua, config/accounts.lua, config/loans.lua, config/interest.lua, config/fees.lua are loaded as shared_scripts for cleaner separation of banking, tier, loan, interest, and fee settings.
• provides { 'qb-banking' } is now declared in fxmanifest.lua so legacy resources requesting qb-banking resolve to oxide-banking.
• Inventory access standardized on o-link.inventory - bank card inventory checks and item metadata reads now go through the bridge regardless of the active inventory resource.
• ATM and branch interaction routed through o-link.target when Config.UseTarget = true, with proximity fallback when false.

Re-run sql/install.sql on existing installations. All statements use IF NOT EXISTS and are safe to re-run — existing data is not touched.

• NPC street selling system with ox_target integration for ambient pedestrians
• Vue 3 sell panel UI with product selection, variant grouping, quantity controls, and price slider
• Pricing pipeline engine with 5 modifier types: grade multiplier, score multiplier, variant multiplier, trait bonus, metadata bonus
• Negotiation system with accept, counter-offer (95% fair price, 60s expiry), and reject outcomes
• Gang NPC robbery mechanic with configurable item loss and cash percentage
• Police dispatch system with independent trigger chance on any interaction
• Dirty money system with account and item payout modes
• Progression bridge for XP awards and level requirements via exports on source drug resources
• Graceful degradation when source drug resources (oxide-weed, oxide-meth) are not running
• Weed drug type with 6 sellable items, score-based pricing, 7 trait bonuses, and generation metadata bonus
• Meth drug type with 11 variant-specific items, grade-based pricing, and variant multipliers
• NPC blacklist for cops, paramedics, military, rangers, and security models
• Gang model list for Families, Ballas, Lost MC, Mexican gangs, Salvadorians, and Koreans
• Cinematic camera system with wall-collision raycast during NPC interactions
• NPC walk-to-player behavior with distance monitoring and timeout safety
• Rate limiting on all server callbacks (3-5 second windows)
• Player and NPC cooldown systems to prevent spam
• Server-side transaction validation with rollback on partial item removal failure
• Localization support via ox_lib locale system (locales/en.json)

• Full meth production pipeline: cook, crystallize, break, bag
• Interactive temperature minigame with 6 cycling key controls and optimal range scoring
• 4 base ingredients: hydrogen peroxide, ammonia, hydrochloric acid, sodium benzoate
• 10-additive chemistry system with pour and drag interactions
• 10 named variants (Glass, Blue Sky, Purple Haze, Lean Crystal, Green Rush, Dirty Sprite, Street Mix, Rocket Fuel, Club Special, Ice) with unique items and value multipliers
• Purity scoring system with temperature-based base score, additive modifiers, and level-based penalties
• 5 purity grades: Pure, High, Mid, Low, Dirty
• Crystallizer equipment with 18 drying slots (2 columns x 9 stacked) and 5-minute crystallization time
• Breaking system with 4-stage visual tray progression and variant-specific shard output (3-6 per tray)
• Bagging system with scale weight mechanics (0.3-1.0g shards, 1.0g target, 0.8g minimum seal)
• 10-level progression system with XP rewards for all production activities
• Shared drugs_progression table compatible with other Oxide drug resources
• Gas mask usable item for cooking protection
• Interactive cooking manual NUI with full production guide
• Meth table and crystallizer placeable equipment
• Equipment ownership enforcement with Config.RequireOwnership
• Safe zone polygon system blocking equipment placement
• Admin commands: /methkit, /meth_sellkit, /methstats
• Server exports: GetPlayerLevel, GetPlayerProgression, AddXP, AddSold
• Rate limiting on all server callbacks and events
• Session locking to prevent concurrent production activities
• Full localization support via locales/en.json
• Routing bucket support for instanced gameplay
• Database persistence for equipment, drying slots, and progression

• 3D Printer System - Placeable 3D printers with ghost-prop placement preview, DUI status screen, and blueprint loading via USB drives
• Blueprint System - 60+ weapon blueprints across pistols, SMGs, rifles, shotguns, snipers, and machine guns with per-part filament costs and print times
• Part Printing - Print individual weapon components (slides, barrels, receivers, stocks, magazines, chassis, etc.) with real-time progress tracking and collection
• Printer Upgrades - 5 upgrade categories (Nozzle, Storage Drive, Cooling Fan, Build Plate, Power Supply) with up to 3 tiers each, PSU requirements, and level gates
• Weapon Assembly - Placeable weapon benches for assembling printed parts into finished weapons with crafting animations and 3D weapon preview
• Quality System - 5-tier quality grading (Poor, Decent, Standard, Quality, Superior) based on player level, build plate upgrades, and experience bonuses
• Weapon Durability - Shot-based degradation, escalating jam chances at low durability, unjam animations, and weapon destruction at 0%
• 10-Level Progression - XP from loading USBs, completing prints, and assembling weapons with tiered weapon and upgrade unlocks
• Experience Bonuses - Accumulated prints and assemblies grant progressive speed and quality bonuses up to a configurable maximum
• USB Malfunction - Configurable chance for USB loading to fail, reduced by player level and cooling fan upgrades
• Bad Luck Protection - Configurable chance and penalty for failed print attempts
• Placeable Tables - General-purpose placeable tables with ownership and per-player limits
• Floating Labels - Toggle-able floating info labels above printers and benches showing status, progress, and upgrade info
• Camera System - Smooth camera transitions when interacting with printers and benches
• Safe Zones - Configurable polygon zones where equipment placement is blocked
• Ownership System - Configurable owner-only pickup for all placed equipment
• Per-Player Limits - Configurable maximum count of printers, benches, and tables per player
• Rate Limiting - Server-side rate limiting on all player actions
• Admin Commands - Full suite of admin commands for testing: /printer_kit, /bench_kit, /upgrade_kit, /give_parts, /givewepblueprint, /wp_setlevel, /wp_setxp, /wp_info, /wp_testkit, /table_kit
• Custom Props - 30 custom streamed props for weapon parts and 3D printer model
• Database Persistence - All placed printers, benches, tables, and active prints persist across server restarts

• Initial release of the animal control gig job
• 4 job types: aggressive animal, stray capture, wildlife removal, and deceased pickup
• 55 preconfigured events across the city (13 aggressive, 15 stray, 5 wildlife, 22 deceased)
• Tranquilizer dart gun system with inventory-managed weapon and limited ammo per call (5 darts)
• Bait placement system with ghost preview, scent particle effects, and player retreat mechanics
• Stealth detection system with configurable native crouch detection or random chance fallback
• Animal behavior AI: aggressive combat targeting, stray flee/approach cycles, wildlife waypoint patrols, deceased ragdoll states
• Animal state machine: ALIVE, SEDATED, CAPTURED, LOADED, DEAD with transition logic
• Sedation wake-up timer (30 seconds) requiring re-tranquilization
• Escape radius detection per job type with complaint penalties
• Animal kill detection with fine ($150) and complaint
• Reporting NPC system with civilian models, reaction animations, and thank-you gestures on job completion
• World NPC flee behavior around aggressive animals and wildlife
• Shelter delivery system for live animal transport to Config.ShelterDeliveryPoint
• Deceased remains collection with body bag prop and carry animation
• Call dispatch system with configurable intervals (15-45s) and 30-second response window
• 5-tier progression system (Volunteer, Handler, Senior Handler, Field Supervisor, Chief Officer) with persistent database tracking
• 2-player crew co-op system with shared calls, vehicle sharing, and 15% co-op pay bonus
• Payment system with base pay, distance bonus, speed bonus, level multiplier, streak bonus, tips, gas fees, and taxes
• Complaint system with animal escape, animal kill, vehicle destruction, and death penalties; 30-minute timeout after 3 strikes
• Server-authoritative mission timers calculated from base time plus distance
• NUI frontend with mission timer, incoming call notification, shift menu with cinematic camera, shift summary screen, and tutorial tooltips
• 3D floating waypoint system (hold H to show) with distance-based scaling
• Dual menu style support: NUI (cinematic camera, crew headshots) and Bridge.Menu (lightweight context menu)
• Phone integration via community_bridge for shift emails and notifications
• Safety zones around animal scenes with speed zone tiers for NPC traffic
• Admin builder tool (/animalcontrolbuilder) for creating office locations and job events
• Tutorial commands (/animalcontroltutorials toggle, /animalcontroltutorialreset reset)
• 17 contextual tutorial tooltips for new player onboarding
• Database table animalcontroljob_progression for persistent progression
• Dart weapon damage restriction (only affects active job animals while on shift)
• Animal model registry with 14 animal types including dogs, cats, coyotes, mountain lions, panthers, and deer
• English locale (locales/en.json)

• Modern glassmorphism chat UI
• Proximity-based roleplay messaging (/me, /do, /whisper, /shout)
• Job-specific radio channels
• Private messaging system
• Customizable settings (position, opacity, colors, density)
• Command autocomplete with suggestions
• Emoji picker
• FiveM chat API compatibility layer

• Vue 3 + Vite + Tailwind frontend with delivery HUD, shift menu, waypoint overlay, and shift summary screen
• Three order types: Standard (1.0x), Priority (1.5x), and Catering (3.0x) with level-gated access
• 5-tier progression system (Trainee, Driver, Reliable, Senior, Veteran) with persistent database tracking
• Random event system: Customer Not Home (8%), Rush Order (10%), Wrong Address (5%)
• Customer reaction system with 4 tiers (Excellent, Good, Poor, Bad) based on delivery performance
• Pizza box prop with carry animation, vehicle storage interaction, and automatic attach/detach on vehicle enter/exit
• Delivery timer system with distance-based time limits and 15% late penalty
• 3D floating waypoint overlay (hold H) with distance scaling and distance text
• Daily streak bonus system (up to 7 consecutive days, $10/day)
• Complaint and suspension system (3 complaints triggers 30-minute timeout)
• Lump-sum shift payout with gas fee (5%) and tax (10%) deductions
• Tips paid instantly as cash, base earnings deposited to bank on clock-out
• Vehicle damage charge system based on body health at clock-out
• Uniform system with separate male/female outfit configurations
• NUI shift menu with cinematic camera and sway animation per location
• Bridge.Menu fallback context menu for servers preferring simplicity
• Shift summary delivered via NUI popup or SMS (configurable)
• Phone integration for shift event notifications via community_bridge phone bridge
• Tutorial system with 8 contextual tooltips and KVP persistence
• Player commands: /pizzatutorials (toggle), /pizzatutorialreset (reset progress)
• Admin coordinate builder: /pizzacreate, /pizzavehicle, /pizzadeliv, /pizzaexport, /pizzacancel
• Server-side anti-teleport validation based on delivery distance
• Rate limiting on all server callbacks and events
• Automatic cleanup on disconnect, character unload, death, and resource restart
• 3 pre-configured shop locations: Downtown, Del Perro, and Mission Row
• Localization support via locales/en.json

• Initial release of the roadside assistance gig job
• 4 service types: fuel help, wheel change, battery replacement, and vehicle towing
• 40 preconfigured events across all job types (10 fuel, 10 wheel, 10 battery, 10 towing)
• Call dispatch system with configurable intervals (15-45s) and 30-second response window
• 5-tier progression system (Trainee, Mechanic, Senior Technician, Team Lead, Master Technician) with persistent database tracking
• 2-player crew co-op system with shared calls, vehicle sharing, and 15% co-op pay bonus
• Safety cone system with 3 placeable cones, ghost preview placement, tiered speed zones, and per-cone pay bonus
• Props system with jack, spare wheel, jerry can, and battery — truck-mounted with third-eye take/return interactions
• Stranded NPC behavior with exit animations, proximity-based animation cycling, and impatient reactions
• Breakdown visual effects: hazard lights, cosmetic damage, engine smoke, flat tires
• Payment system with base pay, distance bonus, speed bonus, cone bonus, level multiplier, streak bonus, tips, gas fees, and taxes
• Complaint system with vehicle destruction and death penalties, 30-minute timeout after 3 strikes, complaint decay per completed job
• NUI frontend with mission timer, incoming call notification, shift menu with cinematic camera, shift summary screen, and tutorial tooltips
• 3D floating waypoint system (hold H to show) with distance-based scaling
• Dual menu style support: NUI (cinematic camera, crew headshots) and Bridge.Menu (lightweight context menu)
• Phone integration via community_bridge for shift emails and notifications
• Admin builder tool (/roadsidebuilder) for creating tow yard locations and job events
• Tutorial commands (/roadsidetutorials toggle, /roadsidetutorialreset reset)
• Database table roadsideassistancejob_progression for persistent progression
• English locale (locales/en.json)

• Full cannabis cultivation system with 4-stage plant growth
• 10-trait genetics system with weighted quality calculation
• Plant gender mechanics with male/female determination at growth stage 2
• Crossbreeding system combining pollen and seeds to produce hybrid strains
• Strain registry with procedural name generation (1600+ unique names)
• Drying rack system with 14 slots per weed table
• Freeze dryer with 18 trays and 144 total slots (requires level 7)
• Heater system to accelerate drying (up to 3 per rack, 1.5x multiplier each)
• Trimming with scissors producing pruned buds and cannabis leaves
• Bagging via drag-and-drop NUI at the weed table
• Tiered packaging: 1g, eighth, quarter, half, ounce
• Joint and blunt rolling with trait-based smoking effects
• NPC street selling with price negotiation, counter-offers, and risk mechanics
• Wild plant foraging in configurable polygon zones with respawn timers
• Supply store NPC (The Germinator) with categorized inventory
• Scientist NPC (Best Buds Laboratories) for lab reports and seed cloning
• 10-level progression system with XP rewards for all activities
• Water container and watering can equipment for efficient hydration
• Storage tote with stash inventory access
• Growing manual item with comprehensive NUI guide
• Admin commands for testing and management
• Full localization support via locales/en.json
• Rate limiting on all server callbacks and events
• Ownership enforcement for placed items
• Routing bucket support for instanced gameplay

• Landscaping/mowing gig job with 10 hand-built yards across Los Santos
• 5-tier progression system (Trainee → Foreman) with increasing pay, speed, and tip chances
• Company van + mower vehicle system with roof rack attachment
• Mower blade toggle with speed limiting, particle effects, and 3D positional audio (xsound)
• Obstacle hazard system with mower damage and on-foot pickup
• Yard timer with speed bonus and expiry penalty
• Complaint/suspension system for vehicle destruction and death on shift
• 2-player crew co-op with invite system and bonus pay
• Visual yard editor (freecam) for building new yards in-game
• Coordinate builder admin commands for locations and yards
• Floating 3D waypoint markers above assigned yards
• Phone integration for shift updates via SMS/email (Community Bridge)
• Multi-framework support via Community Bridge (QBCore, ESX, QBox, etc.)

• Removed statistics/transaction history menus from oxide-menu (use NUI dashboard instead)
• Debug print statements now properly gated behind Config.Debug flag
• Cleaned up LoadBusinesses and LoadMachines startup logging

• Unused server callbacks: isOwner, getBusinessDashboard, getBusinessTransactionHistory
• Unused server functions: SyncMachineToNearby, RemoveMachineFromNearby, GetTotalStockCount
• Unused client helper: UpdateMenuItem
• Hardcoded debug print statements in dashboard NUI callback

• Transaction history in NUI now correctly shows NPC sales with same styling as player sales
• Combined "Player Sales" and "NPC Sales" filters into single "Sales" filter for immersion

• Dynamic black market dealer system with single dealer instance
• Reputation-based progression (5 tiers: Unknown, Street, Connected, Trusted, Inner Circle)
• Buy/sell shop with tier-locked inventory
• Police surrender/arrest mechanics
• Hit squad retaliation on dealer death
• Pager-based dealer discovery
• Server-side secured loot drops
• Proximity-based blip discovery
• Dealer relocation every 45 minutes