SinceDungeon-NBTChest

An addon for the SinceDungeon plugin that adds two powerful custom dungeon actions:

• NBT_LOOT_CHEST — loot chests that preserve full item NBT (enchantments, attributes, custom model data, persistent data) and support random preset pools.
• PARALLEL — run any number of dungeon sub-actions simultaneously, completing only when all of them finish.

Both actions register themselves through SinceDungeon's public API, so they appear in the dungeon editor alongside the built-in actions.

---

Features

• Full-NBT loot chests — items are serialized with Paper's ItemStack#serializeAsBytes(), so nothing is lost.
• Random preset pools — list multiple presets and one is chosen at random.
• Per-player or shared mode — each player can draw their own random loot, or everyone shares one chest.
• Optional key requirement — gate chests behind a required dungeon key ID.
• ️ Time limits & penalties — supported per action.
• PARALLEL action — combine SPAWN_WAVE, NBT_LOOT_CHEST, and any other registered action into a single parallel objective.
• In-game editors — visual GUIs for both loot presets and parallel presets, no YAML editing required.

---

Requirements

| Requirement | Version |
|-------------|---------|
| Server | Paper 1.21+ |
| Java | 21 |
| SinceDungeon| Installed and loaded before this addon |

---

Installation

1. Download the latest SinceDungeon-NBTChest-x.x.x.jar.
2. Make sure SinceDungeon is already installed in your plugins/ folder.
3. Drop this addon's JAR into plugins/.
4. Restart the server.

On startup you should see:

[SinceDungeon-NBTChest] SinceDungeon-NBTChest enabled. Actions: NBT_LOOT_CHEST, PARALLEL

---

Commands

| Command | Description |
|---------|-------------|
| /sdnbt create <name> | Create a new loot preset (opens the editor GUI) |
| /sdnbt edit <name> | Edit an existing loot preset |
| /sdnbt list | List all loot presets |
| /sdnbt delete <name> | Delete a loot preset |
| /sdnbt info <name> | Show details about a preset |
| /sdnbt reload | Reload presets.yml |
| /lapparallel | Open the Parallel preset editor |
| /lapparallel reload | Reload parallel_presets.yml |

Permission

| Node | Default | Grants |
|------|---------|--------|
| sincedungeon.nbtchest.admin | op | Access to all /sdnbt and /lapparallel commands |

---

Creating a Loot Preset

1. Run /sdnbt create epic_chest.
2. A 54-slot editor opens — place any items you want (with full NBT) freely.
3. Close the inventory to save. Empty editors are not saved.

Presets are stored in:

plugins/SinceDungeon-NBTChest/presets.yml

---

Using NBT_LOOT_CHEST in a Dungeon

Add it to your dungeon YAML like any other action.

Single preset (backwards-compatible):

type: "NBT_LOOT_CHEST"
preset: "epic_chest"
location: "0,64,0"

Random preset pool:

type: "NBT_LOOT_CHEST"
presets: "epic_chest,rare_chest,common_chest"
location: "0,64,0"
per_player: true        # each player draws independently
required_key: "NONE"    # or a key ID

NBT_LOOT_CHEST parameters

| Key | Default | Description |
|-----|---------|-------------|
| location | 0,64,0 | Chest location as x,y,z (dungeon-relative) |
| presets | [my_preset] | One preset name per line; one is picked at random |
| preset | — | Single preset (alternative to presets) |
| per_player | true | true: each player draws independently · false: shared chest |
| required_key | NONE | Key ID required to open, or NONE |
| time_limit | -1 | Seconds before time penalty (-1 = no limit) |
| time_penalty | 1 | Points deducted per second overtime |

Note: Players must take all items before the chest counts as completed.

---

Using the PARALLEL Action

The PARALLEL action runs every sub-action of a parallel preset at the same time and completes when all of them finish.

1. Build a parallel preset

/lapparallel

• Create a preset, then add sub-actions (e.g. SPAWN_WAVE, NBT_LOOT_CHEST).
• Each sub-action's fields can be edited in the GUI.
• PARALLEL itself cannot be nested (recursion is blocked).

Presets are stored in:

plugins/SinceDungeon-NBTChest/parallel_presets.yml

2. Reference it in a dungeon

challenge:
  type: "PARALLEL"
  preset: "wave_and_loot"
  start_message: "<red>Survive the wave AND loot the chest!"

PARALLEL parameters

| Key | Default | Description |
|-----|---------|-------------|
| preset | "" | Name of the parallel preset to run |
| time_limit | -1 | Seconds before time penalty (-1 = no limit) |
| time_penalty | 1 | Points deducted per second overtime |

---

License

APACHE-2.0-license.

Author

• LAPDK66