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 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.

  • Avatar of LallierQc LallierQc Feb 26, 2014 at 23:18 UTC - 0 likes

    @stutiguias: Go

    well he never answers. sry its ok but why cant we see all the perms? like soulbound.items.keep_on_death there should more commands like taht.. their not written anywhere..

  • Avatar of stutiguias stutiguias Feb 26, 2014 at 22:34 UTC - 0 likes

    @LallierQc: Go

    wtf... why me ??? ask the author...

    Anyone can write code a computer can understand, but professional developers write code *humans* can understand.

    Anti-if

  • Avatar of LallierQc LallierQc Feb 26, 2014 at 22:29 UTC - 0 likes

    @stutiguias: Go

    plz help. the delete on drop thingy doesnt even work -_- even on 2 non ops. anddefault rank

  • Avatar of LallierQc LallierQc Feb 26, 2014 at 03:18 UTC - 0 likes

    I found the best idea ! Make your soulbound thingy lores in essentials kits compatible with essentials {USERNAME} Tag ! Using stuff like if LoreContains() blabla and i suck in coding. but i hope you understand. because if i put like in my lores &6Soulbound and &5&o{USERNAME} when i do the kit it does look like it works its exactly the same but it actually doenst work :(

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
10,692
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