Dungeon Give Key

Added in v2.0.1.

Description

Gives the targeted player a copy of one of the dungeon's configured access keys, chosen by its position in the dungeon's AccessKeys.KeyItems list. The keys come from the dungeon the target is in, not the caster's. Needs an entity target, so give the line a targeter such as @trigger.

The list is resolved per difficulty: without difficulty, the mechanic uses the key list of the difficulty the target's instance is running at (a level with its own AccessKeys.KeyItems uses that, otherwise the dungeon-wide list). Set difficulty to hand out another level's key, for example the HARD key at the end of an EASY run.

Anything that does not fit in the player's inventory is discarded rather than dropped, so keys are silently lost when the inventory is full.

Attributes

Attribute Aliases Description Default
index i Zero based position of the key in the dungeon's access key list. 0
amount a Stack size to give. Clamped to a minimum of 1. 1
difficulty d Name of the difficulty level whose key list to use. the instance's current difficulty

Examples

Skills:
- dungeongivekey{index=0;amount=1} @trigger ~onDungeonComplete

Gives the finishing player one copy of the dungeon's first configured access key.

Skills:
- dungeongivekey{difficulty=HARD} @trigger ~onDungeonComplete

Gives the finishing player the first key configured under Difficulty.Levels.HARD.AccessKeys.KeyItems, so clearing the current difficulty unlocks the next one.

Aliases

  • dgivekey
Updated Sep 18, 2026