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, persistent corpse looting (CORPSE), and customizable physical loot bags (BAG mode).

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 with customizable cooldowns and break attempt limits.

2. Interactive Loot Bags (BAG Mode — 🆕)

• Physical 3D Loot Containers: Defeated monsters spawn physical loot bags or chest containers instead of cluttering the floor or disappearing.
• Packaged Default Bag & Custom Models: Comes pre-packaged with a custom 3D model with dedicated textures and UI icons, or bind any registered Hytale chest, crate, or furniture block.
• Dynamic Container Audio: Opening and closing bag containers automatically plays sound effects matching the container block/item type (e.g. Scarak hive chests, wooden chests, barrels).
• Realistic Drop Physics & Raycasting: Spawns with a natural pop-up jump impulse, using ground raycasting and model bounds to settle cleanly on slopes and terrain without floating.
• Scale Customization (--scale): Scale any bag or container model up or down per entity (e.g. giant treasure chests for dungeon bosses, compact pouches for goblins).
• Restricted Access & Persistence: Only players who dealt qualifying damage can see and interact with their loot bag. Bag access persists seamlessly across player disconnects and reconnects.

3. Corpse Looting (CORPSE Mode)

• 3D Fallen Mob Corpses: Defeated enemies remain as lootable 3D corpses in the world with expanded interaction bounding boxes.
• Selective Reticle Prompt: The "Press [F] to loot" reticle prompt is filtered exclusively to players who contributed to the fight and have pending rewards.

4. Anti-Leech Damage Thresholds & Blacklists

• Damage Threshold Requirement: Require players to deal a minimum percentage of damage (e.g., 10%) to qualify for drops, preventing AFK leeching and kill-stealing.
• Entity Blacklist: Easily exclude specific entities from instanced drops using /il blacklist add to let them drop vanilla loot.

5. 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!

6. Player-Friendly & Non-Intrusive

• Administrators can toggle collection messages server-wide using /il config system --chat=<on|off> to prevent chat clutter.
• Low overhead, asynchronous saving, and fully persistent across server restarts and chunk unloads.

Commands & Permissions

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

General & Administration Commands

Modular Configuration (/il config)

• /il config: Displays the complete configuration overview.
• /il config lootmode [corpse|drop|bag]: Switch active mob loot delivery mode.
• /il config threshold [on|off] [--percent=<val>]: Toggle anti-leech damage threshold or configure minimum damage percentage (e.g. --percent=10).
• /il config timeout <minutes>: Set combat inactivity timeout (default: 5m).
• /il config expiration <minutes>: Set corpse/bag loot expiration time (default: 10m).
• /il config protection [--mode=<alert|on|off>] [--time=<mins>] [--attempts=<count>]: Configure chest break protection policy, cooldown window, and warning attempts.
• /il config system [--loot=<on|off>] [--chest=<on|off>] [--chat=<on|off>]: Toggle mob combat loot, chest instancing, and server-wide pickup chat alerts.

Bag Model Customization (/il dropbag)

• /il dropbag: Displays the default bag model, scale factor, and active entity mappings.
• /il dropbag add [--target | --entity <name>] [--item <id>] [--scale <float>]: Assign a custom container model and scale factor to a mob type (supports looking at the mob with --target!).
• /il dropbag remove [--target | --entity <name>] [--item <id>]: Remove a custom bag mapping.
• /il dropbag setdefault --item <id> [--scale <float>]: Set the global fallback container model and scale.
• /il dropbag list: View all configured container mappings.

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

What's Coming

We have exciting plans for the future of InstancedLoot:

• 🔹 Drop Combat Mode (DROP): Direct ground item drops with personal visibility and pickup protection.
• 🔹 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 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!