Skip to content

Features and Configuration

Jump to bottom
Charles Gantt edited this page Sep 8, 2026 · 1 revision

Features and configuration

Player settings showing the effective death mode, XP behavior, defaults, and choice availability

Mode Retained slots
Vanilla No additional protection.
Keep Equipment Worn armor, offhand, selected hotbar slot.
Keep Gear + Hotbar Worn armor, offhand, nine hotbar slots.
Keep Everything Full inventory, hotbar, worn armor and offhand.

Four inventory retention modes plus the world-default choice

Equipment mode protects the held stack regardless of type. Spare tools, armor and shields in main inventory are ordinary inventory. Native keep-on-death items retain their protection. Excluded vanishing items disappear; retained items follow native Keep Inventory behavior. Ender Chests are untouched.

Keep XP preserves levels and progress. Vanilla XP clears experience and releases seven points per previous level, capped at 100. Inventory and XP choices are independent.

XP loss is applied just after respawn. Recoverable orbs are released once at the original death location only after the loss is verified. If that chunk is unloaded, the reward waits for it for up to five minutes from death; the XP loss still applies. Keep XP creates no extra orbs. Settings selected at death apply to that death.

Independent Keep XP, Lose XP, and world-default choices

World controls

Key Default
enabled on
allowPlayerChoice on
allowEquipment on
allowHotbar on
allowEverything on
allowKeepXp on
defaultMode equipment
defaultKeepXp off

World restrictions win. A disabled mode becomes Vanilla; disabled Keep XP becomes Vanilla XP. Mode switches control mode availability, not individual slot filters. An explicit personal choice otherwise overrides the corresponding world default. Defaults remain live for players without overrides. Turning off player selection preserves assigned modes/XP. Admins can set a player's locked value independently. Resetting mode/XP to defaults preserves that lock.

Admin controls for enabling Soulbound Inventory and player self-selection

Worldwide mode and XP availability controls

Default-mode and online-player management controls

Selecting an online player for a mode, XP, or personal-lock assignment

World and player settings persist through death, logout, dimension travel, world reload and server restart. Admin assignment targets online players, with their settings retained while offline.

Console

asi:soulbound_help
asi:soulbound_status
asi:soulbound_set defaultMode hotbar
asi:soulbound_set allowEverything off
asi:soulbound_set allowPlayerChoice off
asi:soulbound_player "Player Name" mode equipment
asi:soulbound_player "Player Name" keepXp on
asi:soulbound_player "Player Name" locked on
asi:soulbound_player "Player Name" mode default
asi:soulbound_set enabled off

Use no slash in the BDS console; operators add / in game. Native commands work with cheats off. Booleans accept on, off, true, false. Modes accept vanilla, equipment, hotbar, everything. default clears a player's mode/XP override. Player selectors including @a are supported. Members, blocks and NPC dialogue cannot change admin settings. Successful writes persist and are logged with an actor.

The optional legacy scriptevent andys_soulbound_inventory:config endpoint accepts JSON: {"action":"set","key":"allowKeepXp","value":false}. Actions: status, help, set, player; player assignment includes exact online player name, key and value. Use native commands for the cheats-off configuration path.

Clone this wiki locally