NPC Customers
The NPC Customer system adds life to your businesses by simulating customer foot traffic when players are on duty.
Basic Configuration
Config.NPCCustomers = {
Enabled = true,
SpawnInterval = {min = 120000, max = 300000},
MaxConcurrentNPCs = 2,
RequestTimeout = 60000,
WalkSpeed = 1.0,
}- Enabled: Toggles the entire NPC customer system.
- SpawnInterval: The range of time (in ms) between NPC arrivals.
- MaxConcurrentNPCs: The maximum number of NPCs allowed at a business simultaneously.
- RequestTimeout: How long an NPC will wait for their order before leaving (ms).
Visuals & Behavior
- PedModels: A list of ped models that can be randomly chosen for NPCs.
- WaitingScenarios: Animation scenarios NPCs will use while waiting for service.
Reviews & Feedback
NPCs will leave reviews based on whether their request was successfully fulfilled within the timeout:
- Positive Reviews: High ratings and friendly comments when served quickly.
- Negative Reviews: Low ratings and complaints when ignored or served slowly.
UI & Notifications
- 3D Text: Displays the NPC's request and a countdown timer above their head.
- Dynamic Colors: The timer changes color as it approaches zero (Green -> Yellow -> Red).
- Arrival Notifications: Notifies staff when a new NPC customer arrives.