NPCs & Interaction

World NPCs โ€” merchants, the forge, the arena-entrance quest-giver โ€” plus the interaction plumbing that opens their panels. Most NPC interaction is client-side; the NPC visual is just a scene object.

Interaction plumbing

  • INPCInteractable โ€” the interface an interactable NPC implements (PromptText + Interact()). Implemented by ForgeNPC, QuestGiver, and QuestInteractableTarget.
  • NPCInteractionManager โ€” routes the local player's interact input to the nearest interactable.
  • NpcController โ€” attachable to any NPC root: idle breathing bob, slow patrol between auto-generated waypoints, and child VFX. NpcType = Enemy / Friendly / Environmental. No dependency on Mirror, CharacterStats, or Health, so it works on networked or local-only NPCs.
  • RodBillboard / Billboard โ€” world-space "Press E" prompts that face the camera.

Named NPCs

NPCRole
ForgeNPCHub forge โ€” press E to open ForgeCraftingPanel (Smithing/Mining/Alchemy). Client-side only. See Gathering & Professions.
HangmanNPC + HangmanDialogueUIArena-entrance NPC with a dialogue panel; placed via BCE โ–ถ Hub Setup โ–ถ 9. Gateway into the arena/combat flow.
QuestGiverOffers QuestDefinitions โ€” press E to open the quest dialogue (accept / turn in). Server-authoritative proximity gate. See Quests & Quest Forge.
QuestInteractableTargetA "press E" world object that satisfies an InteractWithObject quest objective (e.g. examine a grave). See Quests & Quest Forge.

Quest NPCs

Quest givers and interactables are a distinct interaction family added 2026-07-26, driven by the Mirror-networked quest runtime rather than opening a client panel. A QuestGiver shows a floating marker and a "Press E to discuss <quest>" prompt; accepting routes through the server. Full detail โ€” objective hooks, markers, rewards, and the in-testing persistence gap โ€” lives in Quests & Quest Forge.

โ„น๏ธ NPC visuals vs. authority

An NPC's model and interaction are client-side; anything that mutates game state (crafting writes, travel) still goes through the server API or ZoneManager. Friendly NPCs are not enemies โ€” see Enemies, Waves & Bosses for hostile creatures.


Related: Quests & Quest Forge ยท Gathering & Professions ยท Waypoints, Portals & Travel ยท Editor Tooling