๐งโ๐พ NPC Schema
Describes non-player characters in the game โ their roles, behaviors, and interactions.
โ Field Rules & Accepted Values
| Field | Type | Required | Notes |
|---|---|---|---|
| id | string | โ Yes | Must be unique |
| name | string | โ Yes | In-game display |
| sprite | string | โ Yes | Path to image/sprite |
| levels | number[] | โ Yes | Level IDs where NPC appears |
| role | enum | โ No | Predefined behavior types |
| interactable | boolean | โ No | Default is true |
| interactionLimit | number | โ No | Max interaction count |
| behavior | string | โ No | e.g., 'give_quest_on_talk', 'unlock_item' |
| spawnIf | object | โ No | Appears only if conditions met |
| dialogId | string | โ No | For connecting to dialog later |
| sound | object | โ No | Optional FX triggers |
| quests | string[] | โ No | Quest IDs this NPC provides |
| itemsForSale | string[] | โ No | If vendor, what items they sell |