Soulbound

Soulbound

Soulbound binds items to a player and can mark them untradeable when picked up or interacted with.

Files

• Settings only: modules/soulbound/settings.yml

• Bundled resources on GitHub

Commands and permissions

• soulbound soul — divinity.soulbound.cmd.soul
• soulbound untradeable — divinity.soulbound.cmd.untradeable
• soulbound reload — divinity.admin

Configuration and example

bind-to-player decides which events apply binding. interact.blocked-commands protects the item from market/auction commands. drop-on-death is false in the bundled defaults.

Administrator notes

• interact.blocked-commands covers only named commands. Test trading GUIs, auctions, mail, hoppers, containers, item frames, death, and plugins that move items directly.
• Choose binding triggers deliberately; pickup or click binding can permanently bind items earlier than players expect.
• Test drop-on-death, keep-inventory, cross-world death, disconnects, and bypass permissions.
• Do not grant soulbound or untradeable bypass nodes broadly, and use disposable copies when changing ownership rules.

settings.yml — bundled binding behavior

item-requirements:
  soulbound:
    enabled: true
    name: Soulbound
  untradeable:
    enabled: true
    name: Trade State
bind-to-player:
  on-item-drop: true
  on-item-pickup: true
  on-item-click: true
  on-item-interact: true
interact:
  allow-drop: true
  drop-on-death: false
  blocked-commands:
    - 'market'
    - 'auc'
    - 'ah'

See Modules and Commands and Permissions.