Loot Chest Trigger - BornToCraft STUDIO

Action entry that manually triggers a specific loot chest at runtime. Used in combination with DungeonLootChestEntry when manualMode: true.

Trigger Modes

Mode	Behavior
`ONCE`	Chest spawns once per session. Subsequent triggers are ignored (default).
`REPEATABLE`	Chest can be triggered multiple times.
`CONDITIONAL`	Chest only triggers if `triggerCriteria` are met (evaluated per activation).

Configuration

loot_chest_trigger

Map

required

Configuration for the loot chest trigger action.

Show Properties

chestEntry

Ref<DungeonLootChestEntry>

The loot chest entry to activate. Must have manualMode: true.

triggerMode

Enum

default:"ONCE"

ONCE, REPEATABLE, or CONDITIONAL.

triggerCriteria

List<Criteria>

Criteria checked when triggerMode is CONDITIONAL. All must pass.

triggerSound

String

Sound played when the chest is triggered (e.g., ENTITY_ENDERMAN_TELEPORT). Empty = no sound.

triggerDelay

Int

default:"0"

Delay in ticks before the chest appears after triggering.

triggerParticle

String

Particle effect shown at the chest location when triggered (e.g., PORTAL). Empty = none.

broadcastMessage

String

Message broadcast to all online players when this chest is triggered. Supports {player} and {chest}.

Example

# The chest definition (manualMode = true)
dungeon_loot_chest:
  id: "secret_treasure"
  dungeonInstance: "ancient_temple"
  location: {x: 50, y: 70, z: 30, world: "dungeon_temple"}
  manualMode: true
  lootTable:
    - item: NETHERITE_INGOT
      dropChance: 50

# The trigger — fired when boss dies (via onEnd/onEnter triggers)
action:
  type: loot_chest_trigger
  id: "boss_treasure_trigger"
  chestEntry: "secret_treasure"
  triggerMode: ONCE
  triggerSound: "ENTITY_ENDERMAN_TELEPORT"
  triggerParticle: "PORTAL"
  broadcastMessage: "<gold>{player} unlocked the secret treasure!"

​Trigger Modes

​Configuration

​Example

Trigger Modes

Configuration

Example