Skip to content

v2.6.0 - Multi-Framework Career Simulation

Latest

Choose a tag to compare

@DaemonAlex DaemonAlex released this 07 Feb 08:58

What is DPS City Worker?

A full career simulation where players maintain city infrastructure -- starting as Probationary Laborers and working up to Foremen managing entire grid sectors. Infrastructure decays over time, and neglected sectors trigger rolling blackouts that affect the whole server.


Features

22 Task Types Across 6 Categories

  • Maintenance - Pipe repair, hydrant service, water pump fixes
  • Road - Pothole repair, sign replacement, traffic control setup
  • Electrical - Streetlight repair, electrical boxes, transformer maintenance
  • Cleanup - Graffiti removal, trash pickup, hazmat cleanup
  • Utility - Meter reading routes, cable installation, utility locating
  • Sewer - Manhole inspection, storm drain clearing

5-Rank Career Progression

Rank Title Pay Multiplier
1 Probationary Laborer 1.0x
2 Junior Technician 1.2x
3 Senior Technician 1.5x
4 Specialist 1.8x
5 Foreman 2.5x + Control Room

Sector Health & Blackouts

  • 3 city sectors (Legion Square, Mirror Park, Sandy Shores) decay over time
  • Sectors hitting 0% health trigger rolling blackouts
  • Foremen monitor sector health from the Control Room NUI dashboard

Emergency Events

  • Water main breaks, gas leaks, downed power lines, fallen trees
  • Random chance every 10 minutes during active play
  • 2x pay and 1.5x XP bonus for emergency response

Item Scavenging

  • 40% chance per task to find materials (copper, plastic, metalscrap, electronics, steel)
  • Weighted rarity system -- common to very rare drops

Additional Systems

  • Weather-triggered events (storm drains during rain, emergencies during storms)
  • Teamwork bonus (10% per nearby worker, max 30%)
  • Traffic control with placeable cones, barriers, and signs
  • Category-specific task animations and spawn locations
  • Particle effects for water leaks, sparks, gas, and hazmat
  • Anti-exploit cooldown (2s between task completions)

Framework & Compatibility

Auto-detects your setup -- no manual configuration needed:

System Supported
Framework QBCore, QBox (qbx_core), ESX
Target ox_target, qb-target
Inventory ox_inventory, qs-inventory, codem-inventory
Fuel ox_fuel, LegacyFuel, ps-fuel, cdn-fuel, qs-fuelstations
Notifications ox_lib, QBCore, ESX

Dependencies


Installation

  1. Drop dps-cityworker into your resources folder
  2. Run sql/cityworker.sql in your database
  3. Add ensure dps-cityworker to your server.cfg

Exports

Server

  • GetSectorHealth(sectorId) / GetAllSectorHealth()
  • TriggerBlackout(sectorId) / RepairSector(coords, amount)
  • GetPlayerSeniority(source)

Client

  • IsPlayerOnDuty() / GetNearestWorkZone()

Commands

Command Access Description
/workstatus All Check your rank and stats
/controlroom Rank 5+ Open the Grid Control dashboard
/reportdamage [type] All Report infrastructure damage
/setsectorhealth [id] [%] Admin Force set sector health