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.