SetContext sets a context variable for dialog rendering

UpdateInstance updates an instance using a callback

UpdateInteraction updates the last interaction time

* Advances the `offset` as required in order to accompany the prompt * additions to the input.

* Advances the `offset` as required in order to accompany the prompt * additions to the input.

* Apply prompts to the given input

* Apply prompts to the given input

convertQuestLogToEntries converts quest progress to quest log entries for messages

findMerchantInRoom finds a merchant NPC in the given room

isCardinalDirection checks if an exit name is a cardinal direction

luaValueToGo converts a Lua value to a Go value

normalizeClassID maps class ID aliases to canonical IDs used in skill definitions. e.g. "wizard" → "mage" (the entity class is ClassWizard with ID "wi

processNPCTurns handles NPC turns in combat until it's a player's turn

* Push an entry and maintain ring buffer size

runCustomMatchup runs a matchup with custom weapon/armor stats

sanitizeFilename ensures the filename is safe and prevents path traversal

AddCharacter ,,,

AvailableSkills returns skills unlocked at the given class and level

FindAllTemplates returns all NPCs marked as templates

FindInstanceByNameInRoom finds an instance by name in a room

GetCombatInstance returns the combat instance a player is in

GetCurrentNode returns the current dialog node for a conversation

GetItemIDs returns a copy of the item IDs in the room

GetNPCAIAction determines what action an NPC should take

GetXPForNextLevel returns how much more XP is needed to reach the next level Returns 0 if already at max level (50)

GetXPProgress returns the percentage progress to next level (0-100) Returns 100 if at max level

Reward granting

HasCollectedCopyItem checks if the character has already collected a CopyOnPickup item

HasVisited returns true if the player has visited a specific dialog node

IsNPCInCombat checks if an NPC is currently in combat

NewDialogEndMessage creates a message indicating the conversation has ended

NewMessage ... creates a new message

NewSQLiteFactory returns a SQLite-backed repository factory.

QueuePlayerAction queues an action for a player's next auto-attack turn

RemoveInstance removes a combat instance completely

SetAutoAttackTarget sets the persistent auto-attack target for a player

SpawnFromTemplate creates a new NPC instance from a template The instance is returned but NOT persisted (memory-only)

StarterItemTemplateByName returns the starter item template with the given name, or nil if not found.

SystemCharacterTemplatePresets returns a hardcoded list of templates that can be seeded into the database. These are intended as "starter defaults" an

cleanupCombatInstance cleans up after combat ends, processes rewards, and notifies players

* Clears the current prompt * * This function will erase all the lines that display the current prompt * and move the cursor in the beginning

* Clears the current prompt * * This function will erase all the lines that display the current prompt * and move the cursor in the beginning

clearRestingState removes the resting flag from a character.

containsIgnoreCase checks if s contains substr (case-insensitive)

doAutoAttack performs the default auto-attack for a player

formatAttrValue converts an attribute value to string. Handles numeric types as well as string values (Creator UI stores numbers as strings).

--- Attribute and Status Effect Helpers --- getAttrMod returns the attribute modifier for a combatant based on attribute name