Soulbind

The Soulbind enchantment links eligible EliteMobs loot to its recipient. Personal drops belong to their recipient; group loot binds the awarded item to the winner of its Need / Greed vote.

How Soulbind Works

With Soulbind enabled, players cannot pick up items bound to someone else unless they have the bypass permission. Unbound items pass this check. Players can move bound items through chests, but the ownership check still applies when they equip them.

This is so players don't accidentally clog up each other's chests with unmovable items.

Visual Indicators

EliteMobs can show a recipient-name hologram above drops created through its loot-display path. Manually dropping an item does not automatically create this display. The hologram:

• Appears about 3 seconds after the drop at 20 TPS
• Follows the item if it moves
• Lasts about 5 minutes at 20 TPS or until the item entity is removed
• Helps players quickly identify which items belong to them

Ownership Validation

Soulbound items are linked to the player's unique ID (UUID). Only the original owner of the item can use it. This prevents players from sharing powerful items, maintaining game balance and progression.

Unbinding Items

Player Unbinding

Players can remove soulbind from an item by using an Unbind Scroll:

1. Use the /em unbind command to open the unbind menu (requires permission: elitemobs.unbind.command)
2. Place the soulbound elite item in the menu
3. Place an Unbind Scroll in the menu
4. Confirm the unbinding process
5. The unbound item will return to your inventory or drop if your inventory is full

The menu checks whether you may use the Unbind Scroll. Its equipment input accepts damageable EliteMobs gear and does not separately enforce the gear's owner. Do not rely on the unbind menu as an ownership protection boundary.

Note: The /em unbind command may teleport you to the Adventurer's Guild hub instead of immediately opening the menu, depending on your server configuration.

Admin Unbinding

Server administrators can force-unbind the item they are holding using the /em unbind force command (requires permission: elitemobs.unbind.force). This bypasses the scroll requirement and the ownership check.

/em unbind force all uses the same permission and removes Soulbind from every bound item in your inventory, including its old prestige tag, then refreshes the lore. Disabling Soulbind enforcement alone does not remove existing item tags or ownership text.

The elitemobs.soulbind.bypass permission skips the ordinary ownership check. Elite Item Scrolls have a separate owner check: a bound scroll can only be spent by its recorded owner, even with this permission or with Soulbind disabled. Unbind the scroll to remove that restriction.

Configuration

Like all enchantments, it can be disabled in the enchantments folder (soulbind.yml, set isEnabled to false), though this is strongly not recommended.

soulbind.yml also carries two display keys:

Key	Default	Purpose
loreStrings	&7Soulbound to &f$player	Lore line added to bound items
hologramString	$player&f's	Text of the floating owner hologram above dropped items

Both accept $player (display name) and $playerName (raw name). Normal item-lore generation uses noSoulbindLore from ItemSettings.yml when the recorded owner is offline. This fallback text does not remove the item's owner tag or bypass its UUID check.

Effects of disabling Soulbind

Disabling Soulbind allows players to trade and use gear that would otherwise be restricted to its recipient. This changes the supply of gear and the balance of your economy. The separate skill-based gear restriction still applies when enabled; disabling Soulbind does not itself let a low-skill player use high-level equipment.