HyBindItem

Adds item binding by player UUID to your Hytale server. Once an item is bound, only the owner can use it.

File Details

HyBindItem-0.0.6.jar

  • R
  • Feb 15, 2026
  • 134.81 KB
  • 41
  • Early Access

File Name

HyBindItem-0.0.6.jar

Supported Versions

  • Early Access

🛠️ Fixes & Improvements

  • Bound item theft prevention (ground + containers): Non-owners can no longer keep bound items, including the “second try” edge case (hotbar/view containers + transactions).
  • Chest/Container security: Taking/moving someone else’s bound item from chests is blocked, with rollback + safety purge.
  • Duplication fix: Fixed scenarios where bound items could duplicate under certain inventory transaction flows.
  • Pending return reliability: Fixed cases where a bound item would not return to its owner after freeing inventory space (especially when the owner was full at the time of seizure).
  • Strict return verification: Pending returns are only cleared after the item is confirmed inside the owner’s real inventory (hotbar + main inventory), not UI/Combined view containers.

⚙️ Config & Runtime

  • 🔔 Owner steal-attempt notification: Owner receives a toast:
    "{player} tried to take your {item}."
  • 🔁 Inventory-full return notify loop (as requested):
    • 1× immediately: Tried to return your bounded item, but your inventory is full.
    • then every 5 seconds: 2× toast, up to 10 rounds
    • once space is available → item returns and notifications stop
  • 📋 /bindlist + /bindlist <playername>
    • prints bound item count + item names to chat

New config keys

  • notifyOwnerOnStealAttempt
  • notifyOwnerOnReturnInventoryFull
  • returnInventoryFullNotifyIntervalMs
  • returnInventoryFullNotifyMaxRounds
  • returnInventoryFullNotifyRepeatCount

New message keys

  • ownerStealAttempt
  • pendingReturnInventoryFull

📦 Files Changed

  • src/main/java/com/hybinditem/HyBindItemPlugin.java
  • src/main/java/com/hybinditem/BoundItemInventoryListener.java
  • src/main/java/com/hybinditem/commands/BindListCommand.java (new)
  • mods/HyBindItem/config/HyBindItem.json5 (new keys)
  • mods/HyBindItem/config/messages.json5 (new keys)
  • (+ minor utility adjustments as needed in the project)

🧩 Notes

  • 🧱 Player-inventory “view” detection was tightened (hotbar cap=9, main inv cap=36) to eliminate inconsistent “first try fails, second try succeeds” behavior.
  • 🧪 Pending return logic is now resilient to patchline differences in inventory APIs (prevents false “returned” states).
  • 💬 Recommendation: keep debug: false and enable only when diagnosing issues.