HyBindItem

HyBindItem adds player UUID item binding to your Hytale server.
Once an item is bound, only the owner can keep/use it. If a non-owner obtains the item (pickup, chest transfers, trading, etc.), the plugin enforces ownership and prevents theft.

✅ Features

🔒 Binding & Ownership

Bind items to a player UUID (owner-only usage/possession).
Anti-rebind protection: already bound items cannot be rebound by other players.
Works through inventory + container transactions, not just ground pickup.

🛡️ Anti-Steal Enforcement

If a non-owner gets a bound item, it is immediately enforced:

removed from their inventory (or reverted via rollback when possible)
returned to the owner (pending-return system), or dropped near the non-owner depending on server flow
protects against chest transfers, shift-click moves, hotbar swaps, and similar edge cases

🔁 Reliable Return System (Full Inventory Safe)

If the owner’s inventory is full when the item should return:

the item is kept in a pending return queue
the plugin will automatically retry returning it
owner receives a notification:
- 1× immediately: Tried to return your bounded item, but your inventory is full.
- then every 5 seconds: 2× notifications, up to 10 rounds
- once space exists → item returns and notifications stop

🔔 Notifications

Owner can be notified when someone tries to take their bound item:
- "{player} tried to take your {item}."

📋 Bind List

/bindlist — shows how many bound items you have and lists their names
/bindlist <playername> — admin listing for a specific player

💬 Commands

/binditem — Bind the item in your hand to your UUID (owner-only).
/bindinfo — Shows who the held item is bound to.
/unbinditem — Unbind the held item (owner only, optional admin override).
/bindlist — List your bound items.
/bindlist <playername> — List bound items for another player (admin).

🔑 Permissions

hybinditem.command.binditem
hybinditem.command.bindinfo
hybinditem.command.unbinditem
hybinditem.unbind.override (optional admin override)
hybinditem.command.bindlist
hybinditem.command.bindlist.admin

⚙️ Data / Storage

Persistent bind data is stored in:
- mods/HyBindItem/bound_items.json5
Pending returns are stored in:
- mods/HyBindItem/pending_returns.json5

🧩 Notes

Designed for survival / RPG / economy servers where ownership and theft prevention matters.
Recommended: keep debug: false unless you’re diagnosing an issue.