Soulbound

Logo

Banner

"Soulbound items for your RPG servers!"

Latest version is: v1.1.9


About

Soulbound is a plugin that makes it possible to have Soulbound items. Whenever an item is soulbinded, players cannot transfer the item to other players.

Features

  • Bind items to a certain player
  • Does not override existing lore!
  • Flag items as "Bind on Pickup".

Soulbound Item

  • Prevent Soulbound items from being dropped (Configurable)
  • Prevent Soulbound items from being dropped on death (Configurable)
  • Keep Soulbound items after a death (Configurable)
  • Prevent Soulbound items from being stored inside containers (Chests, furnaces, dispensers etc) (Configurable)
  • "Bind on Equip" (For armor) or "Bind on Use" (For tools, using a pickaxe once will bind it)
  • Is supported by Loot! Works perfectly together.
  • Added support for EpicBossRecoded! See it in action here!
  • Added support for LoreLocks! See it in action here!
  • Added support for MythicDrops!

Ideas for the future / Todo

  • Mobs can drop (certain) items as "Bind on Pickup" (Hook into Likeaboss)

Commands

  • /soulbound - General info
  • /soulbound [help] - Help information
  • /soulbound [reload] - Reload settings
  • /bind [player] <inventory> - Binds the item in hand to the player, or an entire inventory
  • /bindonpickup - Marks the item as Bind on Pickup
  • /bindonequip - Marks the item as Bind on Equip
  • /bindonuse - Marks the item as Bind on Use
  • /unbind - Unbinds the item

Permissions

  • 'soulbound.commands.bind' - Grants acces to /bind command. Default for OPs
  • 'soulbound.commands.bindonpickup' - Grants acces to /bindonpickup command. Default for OPs
  • 'soulbound.commands.unbind' - Grants acces to /unbind command. Default for OPs
  • 'soulbound.commands.reload' - Grants acces to /soulbound reload command. Default for OPs
  • 'soulbound.items.keep_on_death' - Users with this permission will keep their Soulbound items after dying. Default to false
  • 'soulbound.items.delete_on_death' - Users with this permission will have their Soulbound items deleted on death. Default to false
  • 'soulbound.updatecheck' - Users with this permission node will get notified when a new update is available. Default for OPs
  • 'soulbound.pickup.bypass' - Users with this permission will be able to pickup Soulbound items that do not belong to them. Default to false

Installation requirements

  • Craftbukkit 1.7.5-R0.1

Installation instructions

  • Download Soulbound.jar
  • Drag and drop it in to your /plugins/ folder
  • [Optional] Give players permissions.
  • Start the server once to generate a config.yml file
  • Setup you config file
  • You're ready to go!


Stats collection and data gathering

  • This plugin utilises Hidendra's plugin metrics system. Opting out of this service can be done by editing plugins/Plugin Metrics/config.yml and changing opt-out to true. The following information is collected and sent to mcstats.org.
    • A unique identifier
    • The server's version of Java
    • Whether the server is in offline or online mode
    • The plugin's version
    • The server's version
    • The OS version/name and architecture
    • The core count for the CPU
    • The number of players online
    • The Metrics version
  • This plugin also utilizes Updater to check BukkitDev if there are updates present.


Developer?

Want to use Soulbound's API? Check this page for more information.

Donations

If you'd like to support my work, a donation of any amount would be greatly welcomed! <3
There's a button at the top right of this page to do so.

Quote from TfT_02:

Development builds of this project can be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff. Use them at your own risk.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of TfT_02 TfT_02 Apr 12, 2014 at 17:39 UTC - 1 like

    @dragondeatth: Go

    I've added support for generic kit plugins in the latest version of Soulbound, just add all the items from the kits to items.yml and they will get Soulbound after using the /kit command.

  • Avatar of dragondeatth dragondeatth Apr 12, 2014 at 16:08 UTC - 0 likes

    Is it possible for you to add support for Essentials kits? So all kits would be soulbound? :D

    Owner of Scarwood Reach | www.scarwood.net

  • Avatar of Shahblox Shahblox Apr 09, 2014 at 22:29 UTC - 1 like

    Could is be possible to make the config all change the way the lore looks. Like I want to change it from "Soulbound (playername)" to something else. Please add this :)

    http://i.imgur.com/IT8AdKf.png

  • Avatar of Shahblox Shahblox Mar 30, 2014 at 23:19 UTC - 0 likes

    @kowagatte: Go

    So basically the items can only be tagged by the commands?

  • Avatar of kowagatte kowagatte Mar 30, 2014 at 22:54 UTC - 0 likes

    @Shahblox: Go

    I'm not to sure if its possible to make usernames be bound to them using custom join items but. You should be able to set it so they can never lose it as well so having their name on it wouldn't be important since it would be attached to them.

    BFAK:90810452,4ae930c7d2923d8ba02f2b367196d9e1929076350862e20e9c6e812182e6f155

  • Avatar of kowagatte kowagatte Mar 30, 2014 at 05:03 UTC - 0 likes

    @XarlyAlways: Go

    Custom join items should already have a function like that in the config files. that is if you are saying to make the custom join items undropable or transferable.

  • Avatar of XarlyAlways XarlyAlways Mar 28, 2014 at 16:34 UTC - 0 likes

    Is there a way to use this with "Custom Join Items"? So they can not drop/store the menu items.

    Please tell me and thanks <3

    Nice plugin!

  • Avatar of TeeePeee TeeePeee Mar 06, 2014 at 03:29 UTC - 0 likes

    It would be great if you could make a method in your main class that retrieves an item from the config. Something like:

    public static ItemStack getSoulboundItem(FileConfiguration config, String path, Player playerToBindTo);

    This way, by you specifying certain meta on Soulbound items, it would be very easy for external plugins to grab an ItemStack out of the config with the Soulbound property. It should return the default item found at the path in the config but allow it to be Soulbound to a player.

  • Avatar of TfT_02 TfT_02 Feb 28, 2014 at 09:08 UTC - 0 likes

    @LallierQc: Go

    Added the two missing permission nodes to the plugin description.

  • Avatar of TfT_02 TfT_02 Feb 27, 2014 at 08:17 UTC - 0 likes

    I will try to add some more documentation soon.

Facts

Date created
Mar 09, 2013
Categories
Last update
Apr 13, 2014
Development stage
Release
License
GNU General Public License version 3 (GPLv3)
Curse link
Soulbound
Downloads
11,599
Recent files
  • R: v1.1.9 for 1.7.4 Apr 13, 2014
  • R: v1.1.8 for CB 1.7.2-R0.3 Apr 11, 2014
  • R: v1.1.7 for 1.6.4 Oct 21, 2013
  • R: v1.1.4 for CB 1.5.2-R0.1 Jun 01, 2013
  • R: v1.1.3 for 1.5.1 Mar 31, 2013

Authors

Relationships

Optional dependency
DiabloDrops
EpicBoss Gold Edition
LoreLocks
MythicDrops