Dungeon Instance

Manifest entry used to persist dungeon instance configuration, including room configurations, entry costs, party size limits, and performance multipliers.

Configuration

dungeon_instance — Map

Configuration for the dungeon instance.

Properties

Unique identifier for this dungeon. name — String

Display name of the dungeon. artifact

"> Unified artifact storing dungeon and player statistics (completions, best times). runtimeArtifact

"> Artifact storing active instance data for the current run. partyLobbyArtifact

"> Artifact storing lobby information for party synchronization. roomConfigurations

"> Available room configurations for this dungeon. Each config defines a set of rooms and a spawn point. templateWorld — String

Name of the template world folder used as a base for instances. quests

"> Quests associated with the dungeon. onStart

"> Triggers executed when the dungeon starts. onEnd

"> Triggers executed when the dungeon ends. criteria

"> Criteria required for a player to be eligible for entry. modifiers

"> Modifiers applied to the dungeon instance. entryCostMode — Enum

Mode defining who pays the entry cost. LEADER (only leader pays), GROUP (everyone pays). entryCosts

"> Items required to enter the dungeon. missingItemsMessage

"> Message shown when items are missing. Supports {MissingQuantity}, {ItemName}, {PlayerName}. cooldownSeconds — Int?

Cooldown in seconds after completion. Null = no cooldown. startCooldownSeconds — Int

Countdown in the lobby before players are teleported. minPartySize — Int

Minimum players required to start the dungeon. Must be ≥ 1. maxPartySize — Int

Maximum players per party. Must be ≥ 1. maxSimultaneousInstances — Int

Maximum number of instances of this dungeon that can run simultaneously. Must be ≥ 1. enableScoreboard — Boolean

Enable visibility of the dungeon scoreboard. damageMultiplier — Double

Global damage multiplier for all mobs in this dungeon instance (BTC-CORE only). aggroMultiplier — Double

Aggro range multiplier for all mobs in this dungeon instance (BTC-CORE only). categoryPriority — Int

Priority order when displayed in a category global menu. Lower values appear first.

Example

dungeon_instance:
  id: "ancient_temple"
  name: "Ancient Temple"
  templateWorld: "dungeon_temple"
  roomConfigurations:
    - "temple_layout"
  minPartySize: 1
  maxPartySize: 4
  maxSimultaneousInstances: 3
  cooldownSeconds: 300
  startCooldownSeconds: 10
  entryCostMode: GROUP
  entryCosts:
    - DIAMOND
    - GOLD_INGOT {2}
  enableScoreboard: true
  categoryPriority: 0

Configuration​

Example​

Configuration

Example