> For the complete documentation index, see [llms.txt](https://atiysus-organization.gitbook.io/aty-scripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://atiysus-organization.gitbook.io/aty-scripts/restaurant-creator/features/orders-kds-pos-and-npc-customers.md).

# Orders, KDS, POS & NPC Customers

#### The order pipeline

```
Customer orders (NPC / kiosk / POS)
   → Order appears on the KDS + Order Board
   → Staff claims it → in-world guides point to the required stations
   → Prepare & assemble → serve → payment + tip
```

#### Surfaces

| Surface                      | Description                                               |
| ---------------------------- | --------------------------------------------------------- |
| **KDS (Kitchen Display)**    | Live ticket board — claim, prepare and mark orders ready. |
| **POS**                      | Charge customers, take payments and tips.                 |
| **Order Board (DUI)**        | Prop-mounted screen showing live orders.                  |
| **Self-Service Kiosk (DUI)** | Customer-facing ordering.                                 |
| **Menu Display (DUI)**       | Prop-mounted menu.                                        |

#### Claimed-order guides

When a staff member **claims** an order, floating in-world guides point to exactly which stations are needed (grill, fryer, prep board…), with a marker ring on the floor. These are separate from the tutorial overlay so they never conflict.

#### AI customers

Toggle with `Config.EnableNPC`. When a restaurant is **Open**, NPC peds arrive, queue, order, and pay — with patience timers and dynamic pricing.

| Setting                              | Meaning                                                  |
| ------------------------------------ | -------------------------------------------------------- |
| `Config.MaxNPCQueue`                 | Max NPCs queued at once.                                 |
| `Config.NPCTimeout`                  | How long an NPC waits before leaving (ms).               |
| `Config.NPCSpawnMinWait` / `MaxWait` | Seconds between new arrivals.                            |
| `Config.NPCMaxItemPrice`             | Hard price ceiling an NPC pays for any single item.      |
| `Config.NPCPriceMultiplierCap`       | Caps price relative to ingredient cost (anti-inflation). |
| `Config.NPCPeds`                     | Ped models used for customers.                           |

{% hint style="info" %}
A new order also plays a chime and (during onboarding) shows a contextual tip pointing you to the KDS.
{% endhint %}
