Dungeon Loot Chest

Entry for defining loot chests in dungeon instances. Chests are placed and filled with random loot when the instance world is generated. Supports BLOCK mode (real server-side containers or virtual client-side blocks) and NPC mode (right-click any entity near the location to open the chest).

Configuration

dungeon_loot_chest — Map

Configuration for the dungeon loot chest.

Properties

dungeonInstance

"> The dungeon instance this chest belongs to. location — WorldLocation

Location of the chest (or NPC anchor point) in the instance world. Supports World Location content editor. placementType — Enum

BLOCK: place a block at the location. NPC: intercept right-click on any entity within 3 blocks of the location. storageItem — Item

Engine Item representing the block (supports CraftEngine custom blocks). BLOCK mode only. containerTitle — String

Custom title for the storage container (MiniMessage format). lootTable

"> List of possible loot items.

LootItem

item

The item to drop. dropChance — Double

Chance to appear (0-100%). minAmount — Int

Minimum quantity. maxAmount — Int

Maximum quantity. slot — Int

Specific slot (0-26) or -1 for random.

placementDelay — Int

Delay in seconds before placing/registering the chest after world load. replaceExisting — Boolean

Whether to replace any existing block at the location. BLOCK mode only. clientSide — Boolean

If true, the chest is client-side only (virtual block, no server container). BLOCK mode only. interactionMode — Enum

LOOT: open a virtual inventory with loot. ACTIONS: execute onInteract triggers instead. onInteract

"> Triggers executed when clicked (only for ACTIONS interaction mode). disappearAfterInteract — Boolean

If true, the virtual chest disappears for the player after interaction. manualMode — Boolean

When enabled, the chest is NOT auto-placed during world generation. Use loot_chest_trigger to activate it manually.

NPC Mode

When placementType: NPC, no block is placed. Instead, any entity within 3 blocks of the configured location will open this chest when right-clicked. This is ideal for:

• Reward NPCs that double as chests
• Boss corpses that drop loot
• Hidden chests disguised as decorative entities

Manual Mode

When manualMode: true, the chest is not auto-placed. Use a loot_chest_trigger action to activate it at runtime. Useful for:

• Reward rooms unlocked after defeating a boss
• Secret chests revealed by puzzles
• Conditional loot drops

See Loot Chest Trigger for the trigger action.

Example

dungeon_loot_chest:
  id: "boss_reward_chest"
  name: "Boss Reward"
  dungeonInstance: "ancient_temple"
  location:
    x: 15
    y: 65
    z: 15
    world: "dungeon_template"
  placementType: BLOCK
  storageItem: CHEST
  containerTitle: "<gold>Boss Rewards</gold>"
  lootTable:
    - item: DIAMOND_SWORD
      dropChance: 80
      minAmount: 1
      maxAmount: 1
      slot: 13
    - item: GOLDEN_APPLE
      dropChance: 50
      minAmount: 1
      maxAmount: 3