RunMatchup runs N iterations of a matchup and aggregates results

GetGame returns the game controller

Quest progress operations

notifyPlayersInCombat sends a message to all players in the combat instance

AddLogEntry adds a new entry to the combat log

CheckCombatEnd checks if combat should end and returns the new state

NewInventoryUpdateMessage creates an inventory update from the current character state

NewRoomBasedMessage ... creates a new Websocket message

itoa64 converts int64 to string

CheckLevelUp determines if a character should level up based on their current XP Returns the number of levels gained and the new level Supports gainin

EndCombat finalizes a combat instance with the given result

* Set the new cursor position, as an offset on the input string * * This function: * - Calculates the previous and current

* Set the new cursor position, as an offset on the input string * * This function: * - Calculates the previous and current

AddItem adds an item ID to the room

AllClassConfigs returns configurations for all 6 starter classes

CalculateEnemyGoldReward calculates a gold drop range for an enemy based on level and difficulty. Used as fallback when an enemy's EnemyTrait.GoldDrop

GetInstanceByPlayerID returns the combat instance a player is in

IsPlayerInCombat checks if a player is currently in combat

NewAttribute ...

SkillByID returns the skill with the given ID, or nil

ApplyLevelUp applies all stat changes for leveling up Updates character level, HP, and attributes Returns a LevelUpResult with details for messaging a

EnemyConfigByName returns the enemy config for the given name, or nil

FindItemByName finds an item by partial name match (case-insensitive)

GetCombatEngine returns the combat engine controller

IsBound returns true if this item is bound to a character

NextTurn advances to the next turn, handling round progression

ToEntity converts a YAMLNPC to an NPC entity

checkDuplicateIDs detects duplicate IDs within a single entity type.

getAttributeValue retrieves the value of an attribute by short name

YAML loading functions

CreateCharacter creates a fully equipped character at the specified level. It uses the real leveling system to apply HP and attribute gains.

FindItemByTargetName finds an item by its target name (name-suffix format)

GetDisplayName returns the name shown to players

GetPlayerByID finds a player combatant by their character ID

GetTargetName returns the unique name for targeting commands For instances, this includes the suffix to distinguish between multiple spawns

NewCharacterUpdateMessage creates a character update from the current character state

RegisterModule registers a custom module loader

RemoveItem removes an item ID from the room

RunWithResult executes a script and returns detailed result information

ValidateAttributeSpend checks if spending `amount` points on `attrShort` is allowed. Returns an error message if invalid, or empty string if valid.

* Push an entry and maintain ring buffer size

* Replace input with the new input given * * This function clears all the lines that the current input occupies and * then replaces them with

* Replace input with the new input given * * This function clears all the lines that the current input occupies and * then replaces them with

GetAttributeModifier returns the modifier for an attribute (value - 10) / 2

GetCurrentTurnCombatant returns the combatant whose turn it is

GetInstance returns an NPC instance by ID

IsEnemy returns true if this NPC has enemy behavior

ProcessAttack handles an attack from attacker to target

ResetConversation resets the conversation to the main node

RoomWithCharacterReveals returns a room view with character-specific hidden exits revealed. If the character has no reveals for this room, the origina

With adds a parameter and returns the QueryParams for chaining.

--- Status Effect Management --- applyStatusEffect adds a status effect to a combatant, refreshing if the same skill+stat already exists