Releases: DeamonScripts/dps-cityworker
Releases · DeamonScripts/dps-cityworker
v2.6.0 - Multi-Framework Career Simulation
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
- Drop
dps-cityworkerinto your resources folder - Run
sql/cityworker.sqlin your database - Add
ensure dps-cityworkerto yourserver.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 |