Dungeon Loot Chest

Dungeon Loot Chest

ManifestoFornecido por Dungeon

Entry for defining loot chests in dungeon instances. Chests are placed in the world of the run; the loot of a chest is rolled once, the first time a player opens it.

Campos

Campo	Tipo	Padrão	Descrição
dungeonInstance	Ref<DungeonInstanceEntry>	—	The dungeon instance this chest belongs to
location	WorldLocation	—	Location of the chest in the instance world. The yaw turns the chest: it faces back toward the direction the yaw looks at. WorldLocation (6) Campo Tipo Padrão Descrição world String — — x Int 0 — y Int 0 — z Int 0 — yaw Float 0 — pitch Float 0 —
placementType	ChestPlacementType	BLOCK	BLOCK: place a block at the location. NPC: the chest opens when the Npc Anchor entity is right-clicked.
storageItem	Item	—	Engine Item representing the block (CraftEngine and Nexo custom blocks supported). BLOCK mode only.
containerTitle	String	—	Custom title for the storage container (MiniMessage, leave empty for default)
lootTable	List<LootItem>	empty	List of possible loot items LootItem (5) Campo Tipo Padrão Descrição item Item — The item to drop dropChance Double 50.0 Chance to appear in the chest (0-100%). When the table is WEIGHTED it is the weight of the item instead. minAmount Int 1 Minimum quantity maxAmount Int 1 Maximum quantity slot Int -1 Specific slot in the chest (0-26), or -1 for random slot
placementDelay	Int	2	Delay in seconds before placing/registering the chest (allows world loading)
replaceExisting	Boolean	true	Replace any existing block at the location (BLOCK mode only)
clientSide	Boolean	false	The block exists only on the screens of the run's players: nothing is placed in the world. Ignored in NPC mode.
interactionMode	DungeonChestManager.ChestInteractionMode	—	Interaction mode: LOOT (virtual inventory) or ACTIONS (execute triggers)Valores:LOOTACTIONS
onInteract	List<Ref<TriggerableEntry>>	empty	Triggers executed on click (ACTIONS mode only)
disappearAfterInteract	Boolean	true	If true, the chest disappears once it is closed (once the last player looks away from a shared chest)
manualMode	Boolean	false	If true, the chest is NOT auto-placed. Use a Loot Chest Trigger action to spawn it on demand. Exception: a chest named by a CHEST marker of a generated room template is always placed at its marker, whatever this option says (the marker is where you asked for it).
visibility	ChestVisibility	AUTO	AUTO (default): PER_PLAYER when Client Side is on, SHARED otherwise, as before this option existed. PER_PLAYER: every player of the run opens an inventory of their own, rolled once for them. SHARED: one inventory for the whole run.
onDisappear	OnDisappear	DROP_AT_CHEST	What happens to the items left in the chest when it disappears. DROP_AT_CHEST: they fall at the chest. GIVE_TO_PLAYER: they go to the player who closed it, and what does not fit falls at their feet.
npcAnchor	Ref<EntityInstanceEntry>	—	NPC mode: the entity instance that opens this chest when a player of the run right-clicks it. Without it, a chest placed by an older page still opens when an entity within 2 blocks of its location is right-clicked (deprecated: set the anchor).
lootSelection	LootSelection	INDEPENDENT	INDEPENDENT: every loot item rolls its own chance. WEIGHTED: 'Weighted Picks' distinct items are drawn, the chance of an item being its weight.
weightedPicks	Int	3	Number of loot items drawn when the loot selection is WEIGHTED.
lootTableRef	Ref<DungeonLootTableEntry>	—	A 'Dungeon Loot Table' shared with other chests and mobs. When set, it replaces the Loot Table, Loot Selection and Weighted Picks of this chest (they are then ignored). Empty = this chest's own lines.
additionalLocations	List<WorldLocation>	empty	More places for this chest: the entry puts one chest at Location, then one at each of these. Every chest is independent: it rolls its own loot, has its own opening and vanishes on its own. A Loot Chest Trigger that names this entry makes all of them appear. Ignored in a generated dungeon (the chest stands at its marker). WorldLocation (6) Campo Tipo Padrão Descrição world String — — x Int 0 — y Int 0 — z Int 0 — yaw Float 0 — pitch Float 0 —

How to use it

Place a chest for one dungeon. Capture location with the content editor while standing in the template world. Chests are placed placementDelay seconds (at least 1) after the run world is ready.

Field	What to know
placementType	BLOCK places a block. NPC places nothing: the chest opens when a player of the run right-clicks the entity of npcAnchor.
npcAnchor	The entity instance that opens the chest in NPC mode (for example a Dungeon NPC Instance). Without it, an old page still opens the chest when an entity within 2 blocks of location is right-clicked, which is deprecated: set the anchor.
storageItem	The block of the chest: a vanilla container, or a CraftEngine or Nexo custom block. BLOCK mode only.
clientSide	The block exists only on the screens of the run's players: nothing is placed in the world. Ignored in NPC mode.
visibility	AUTO is PER_PLAYER when clientSide is on, SHARED otherwise. PER_PLAYER: each player of the run opens an inventory of their own, rolled once for them. SHARED: one inventory for the whole run.
lootTable, lootSelection, weightedPicks	With INDEPENDENT every item rolls its own dropChance (0 to 100). With WEIGHTED, weightedPicks distinct items are drawn and dropChance is the weight. Each item has a quantity range and an optional slot (0 to 26, -1 for random). The roll is made once and the same inventory is shown again when reopened.
interactionMode	LOOT opens the chest, ACTIONS runs onInteract instead.
disappearAfterInteract, onDisappear	The chest disappears when it is closed (for a shared chest, when the last player looks away). DROP_AT_CHEST drops what is left at the chest, GIVE_TO_PLAYER gives it to the player who closed it and drops what does not fit at their feet.
manualMode	The chest is not placed at run start. Fire a Loot Chest Trigger to place it. A chest named by a CHEST marker of a generated room is always placed at its marker.

The chest faces back toward the yaw of location. It opens with an animation. In a generated dungeon the position and yaw of the marker replace location. A chest that is open at a reload is closed and put back, with its content kept. At the end of a run the open chests are settled first: the items left are dropped or given according to onDisappear.

Shared table and several chests

Field	What to know
lootTableRef	A Dungeon Loot Table. When set, it replaces the lootTable, lootSelection and weightedPicks of this chest completely: they are ignored, never mixed. If the entry is missing, a warning is logged and the chest keeps its own lines.
additionalLocations	More places for the same entry: one chest at location, then one at each position listed here (capture them with the content editor, like location). Each chest is independent: it rolls its own loot, opens on its own and disappears on its own. A Loot Chest Trigger that names the entry places all of them. In a generated dungeon additionalLocations is ignored: the chest stands at its marker.