๐งโ๐พ 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 |