InstancedLoot

InstancedLoot for Hytale

Never lose dungeon loot again! Per-player personal loot instances for world chests and defeated enemies.

---

What is InstancedLoot?

Inspired by the iconic Minecraft mod Lootr (who is also actively developing a version for Hytale!), InstancedLoot brings the essential per-player loot experience to Hytale servers.

In multiplayer RPGs and open-world survival servers, exploration should be rewarding for everyone. Too often, the first player to rush into a dungeon empties every chest and hoards all the boss drops, leaving latecomers and party members with nothing but cobwebs.

InstancedLoot completely redefines exploration and combat in Hytale:

• Every player gets their own individual loot roll upon opening natural world containers and dungeon chests.
• Chests stay intact for future adventurers thanks to customizable grief/break protection.
• Combat rewards are distributed fairly among players who fought the battle, with configurable damage thresholds and corpse looting (with Drop & Bag modes coming soon!).

---

Key Features

1. Per-Player Instanced Chests

• Personal Container Inventories: When a player opens a natural dungeon or world chest, a private loot session is rolled and saved specifically for them.
• Natural vs Player-Placed Detection: The plugin automatically distinguishes naturally generated chests from storage placed by players (which behaves as normal shared storage).
• ✨ Unopened Sparkle Indicator: Subtle visual sparkle particles appear over containers that still hold unopened loot for the viewing player.
• 🛡️ Chest Break Protection: Prevents players from breaking communal dungeon chests (alert, on, off), ensuring structures and loot instances remain available for all server members.

2. Dynamic Combat Loot

• 🪦 Corpse Mode (Live in v0.5.1): Defeated enemies leave an interactable corpse in the world. Eligible players can interact with it to loot their personal rewards.
• 🎯 Anti-Leech Damage Threshold: Require players to deal a minimum percentage of damage (e.g., 10%) to qualify for drops, preventing AFK leeching and kill-stealing.
• ** More Modes Coming:** Additional Drop and Bag distribution modes are planned in the roadmap below!

3. Custom Droplists & Data-Driven Tables

• Easily create custom loot tables in simple JSON files located in droplists/customs/.
• Assign custom drop tables to any container in-game using:

  /il convert --droplist=my_dungeon_loot

• Full tab-completion support for all vanilla and custom droplists!

4. Player-Friendly & Non-Intrusive

• Players can toggle collection messages on or off using /il info --chat=<on|off> to prevent chat clutter during heavy combat.
• Low overhead, asynchronous saving, and fully persistent across server restarts and chunk unloads.

---

Commands & Permissions

All commands are grouped under /instancedloot (or alias /il):

Command	Description	Permission
/il info [--chat=<on|off>]	View plugin status or toggle personal loot chat notifications	All Players
/il convert [--droplist=<name>] [--off]	Convert targeted chest, assign a custom droplist, or revert instancing	hytale:Admin
/il config	View server configuration dashboard	hytale:Admin
/il config system [flags...]	Toggle combat loot, chests, and break protection	hytale:Admin
/il config mode [corpse|drop|bag]	Set mob loot distribution mode	hytale:Admin
/il config threshold [on|off|percent]	Configure damage contribution requirement	hytale:Admin
/il config timeout <minutes>	Set combat inactivity timeout (default: 5m)	hytale:Admin
/il config expiration <minutes>	Set corpse loot expiration time (default: 10m)	hytale:Admin
/il combat [prune]	Monitor active combat sessions or clean expired records	hytale:Admin
/il blacklist <add|remove|list>	Exclude specific entities from instanced drops	hytale:Admin
/il flush	Force immediate disk sync for all loot states	hytale:Admin

💡 Flexible syntax: All subcommands and flags accept on, true, 1 or off, false, 0.

---

What's Coming

We have exciting plans for the future of InstancedLoot:

• 🔹 Combat Loot Modes (Drop & Bag): World item drops with personal visibility/pickup protection, and physical loot bags upon enemy defeat.
• 🔹 Party Loot Sharing: Cooperative loot distribution (round-robin, shared drops, or party bonuses) for adventuring teams.
• 🔹 Periodic Chest Refills & Resets: Configurable reset timers for natural dungeon chests on persistent MMO worlds.
• 🔹 World Boss Reward Caches: Dynamic reward vaults spawned upon world boss defeat, with tiered loot based on damage dealt.
• 🔹 In-Game GUI Loot Editor: Visual interface to inspect chest contents, test drop rates, and edit droplists in real-time.
• 🔹 Biome & Tag-Based Filters: Advanced rules to apply droplists or blacklist behaviors based on entity tags and world biomes.

---

📦 Modpack & Server Permissions

• Can I include InstancedLoot in my modpack?
  Yes! You are completely free to include InstancedLoot in any public or private modpack without needing explicit permission.
• Can I run this on a public or commercial server?
  Yes! InstancedLoot is designed from the ground up for multiplayer servers.

---

❤️ Inspiration & Credits

InstancedLoot is inspired by the legendary Minecraft mod Lootr by Noobanidus. Lootr revolutionized multiplayer exploration and dungeon crawling in Minecraft, and their team is currently developing a version for Hytale as well!