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.