Kartik Scripts

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.

On this page