Instanced Dungeons Kits Addon [Minecraft 26.x]

DungeonKit Plugin – NeonCrest Games

📦 Overview 📦

DungeonKit — Complete kit system with in‑run upgrades and rewards for instanced dungeons

  • 🎒 Save & reuse kits
  • 🖱️ Kit selection GUI
  • ⚔️ In‑run upgrade stations
  • 🎁 Completion rewards
  • 🔗 Trigger block bindings
  • 🗺️ Per‑dungeon control
  • 🔄 Live reload configs
  • 💰 Vault economy support

🔧 Installation 🔧

  • Install Instanced Dungeon (same server version).
  • Place DungeonKit.jar into /plugins/.
  • Restart your server.
  • Optional: Install Vault + economy plugin for money rewards.

🎮 Commands 🎮

  • /dkitsave <kitname> — Save current inventory as kit
  • /dkitgive <kitname> — Apply/give kit
  • /dkitmenu — Open kit selection GUI
  • /dkitupgrade <buttonId> — Upgrade random enchanted item
  • /dkitreward <rewardKey> — Claim completion reward
  • /dkittrigger <kitname|upgrade> — Bind block as trigger
  • /dkitreload — Reload kits config
  • /dungeonreload — Reload dungeons config

🧩 Permissions 🧩

  • dungeonkits.admin — Access all admin commands (default: op)
  • dungeonkit.player — Open kit menu (default: all players)

⚙️ Setup ⚙️

Enable dungeons (dungeons.yml):

dungeons:
  amphitheatre:
    enabled: true
  gladiator_pit:
    enabled: false

Define rewards (rewards.yml):

rewards:
  default:
    type: MONEY
    amount: 500
  hardmode:
    type: ITEM
    item: NETHERITE_INGOT
    qty: 1
  bossclear:
    type: COMMAND
    cmd: "give %player% diamond 3"

Bind trigger blocks:

  • /dkittrigger <kitname> — right‑click block to give kit
  • /dkittrigger upgrade — right‑click block to upgrade item

PATCH NOTES

  • DungeonKit v1.1 — Patch Notes

    Kit System

    • Armor now auto-equips into the correct slots (helmet/chestplate/leggings/boots) instead of landing in the main inventory.
    • Kits now save your inventory, armor, and offhand separately, so they restore correctly every time.
    • Kit triggers no longer break your loadout when toggled repeatedly.
    • Safety fallback: if a player’s saved kit was removed or renamed, they now get the first available kit instead of an empty inventory.

    Reward System

    • Rewards now actually pay out — money, items, and commands all work.
    • One reward can now include multiple prizes at once (money + items + commands).
    • Notice to the players when rewards are issued.
    • /dkitreload now reloads rewards.yml (previously it didn’t, so reward edits wouldn’t apply).

    Other Fixes

    • Numeric dungeon IDs (like 1) are now detected correctly.
    • Removed the unused dungeonreload command. (use /dkitreload)