Lootbox
12/17/15 - NOTE: A re-work in the process. A working version is currently privately available and is waiting on public release. Please note that, on the outside, it will be less dynamic than the current version and quite a bit buggier. Unfortunately, this does tend to happen with code re-writes. Please stay tuned as the project is turned over to BETA and updates will be released accordingly. More to come this following week...
12/29/15 The re-work is near completion! Expect a release on New Years' Eve
1/1/2016: Happy New Years! Enjoy the update.
Lootbox
About
Lootboxes, mystery crates, loot chests, loot boxes, loot crates, whatever you call them! Reward your players for finding them & their keys (configurable) for epic loot!
Lootbox is like opening a chest, but it's in your inventory! You can configure it so that you can have multiple lootboxes that may or may not require keys to open. When they are opened, they can execute commands from the console and/or give items to the player. This will probably be the best drop party gift you could give your players or one of the most desired quest items! The possibilities are endless!
Lootboxes are, by default, chests with a special name and lore. They can be opened either by themselves or by a key (tripwire hook) as determined by the config.yml. They can be used in the following and more: Quests, treasure chests, drop party items, trade, donations! But really, the possibilities are endless.
Youtube Tutorial
https://www.youtube.com/watch?v=uZrnOAiY6-I
Commands
- /lootbox help <admin> - Displays the in-game help page.
- /lootbox open - Have the lootbox in slot 1 and key in slot 2. Then use this command to open.
- /lootbox reload - Reloads the config.yml
- /lootbox give <username> <key/lootbox> <UUID of lootbox/key> - Gives a player a specified key/lootbox.
- /lootbox preview - Previews with a virtual inventory what is inside a lootbox.
- /lootbox info - See a list of keys/lootboxes that can be used on the key/lootbox in hand.
- /lootbox list <keys/lootboxes> <e> - Lists all keys/lootboxes on the server. Add an 'e' on the end to see an expanded list.
Nodes
- /lootbox help - lootbox.help
- /lootbox open - lootbox.open
- /lootbox help admin - lootbox.admin.help
- /lootbox reload - lootbox.admin.reload
- /lootbox give - lootbox.admin.give
- /lootbox preview - lootbox.preview
- /lootbox list <keys/lootboxes> <e> - lootbox.list
- /lootbox info - lootbox.info
Configuration
Example config.yml: http://pastebin.com/H0sZhuA3
EID List:
- Names are case-sensitive
The chat options should be self explanatory.
Suggested Plugins
- http://dev.bukkit.org/bukkit-plugins/otherdrops/ - Set a drop to the lootbox name and lore and now mobs can drop lootboxes! Remember, the lore and name are case-sensitive!
- http://dev.bukkit.org/bukkit-plugins/treasurechest/ - Put lootboxes in these stationary treasure chests for better rewards!
- http://dev.bukkit.org/bukkit-plugins/event/ - Host drop parties and events where you give away lootboxes!
- http://dev.bukkit.org/bukkit-plugins/quester/ - Give lootboxes to players for completing quests!
- http://dev.bukkit.org/bukkit-plugins/loot-crates/ - An alternative, similar plugin.
Final Notes
Make sure that players have enough room are online and have room in their inventory when using the /lootbox give command. If they aren't online it won't be given to them and if their inventory is full it will drop at their feet, prime time for others to steal it. Please notify me about suggestions or bugs through the comments/tickets! Any comments are welcomed. :)
I have a question. Does this require any other plugins, because whenever i drop it into my plugins and start up my server no folder is created, also in the console there is no [LootBox] plugin being 'activated'
Thank You.
@nelbrenn
Alright, here's the fix:
1) Shut down your server (temporarily)
2) Delete the old Lootbox.jar file
3) Download & Install Lootbox v1.3 (http://dev.bukkit.org/bukkit-plugins/lootbox/files/6-lootbox-v1-3/)
4) Replace the old config.yml with this: http://pastebin.com/ZAGnJ7zD
5) Start up the server
You were missing 3 essential options from the config.yml and were using an outdated version :)
@TheOatBaron
I Typed in /lootbox give Nelbrenn lootbox Common_Crate Gave me this error: http://imgur.com/dCq74D5 Pastebin of Config.yml: http://pastebin.com/Sgit5N85
@nelbrenn
Internal error? Huh.
Could you please post a copy of your Lootbox config.yml to pastebin.com and link it here? Also, what did you type for the command?
As a side note to everybody, Lootbox v1.4 will be coming out mid August along with the tutorial video! It will be a usability update so that it's easier for you guys to set up crates and permissions. I will also be implementing Discern (Currently: http://dev.bukkit.org/bukkit-plugins/discern/) as a part of Lootbox (See the Lootbox Editor commands below). Planned features:
/lootbox list permissions - Lists all the commands and associated permission nodes so you don't have to waste time referencing back to this page!
/lootbox list keys - Lists all keys configured and the associated permission node.
/lootbox list lootboxes - Lists all lootboxes configured and the associated permission node.
/lootbox editor name <name> - Give an item a name.
/lootbox editor lore <lore info> - Add a line of lore to an item
/lootbox editor chance <0-99> - Give an item a chance of happening
/lootbox info - Obtain the name, lore, ID, and EIDs of an item to be used in manual configuration. (If you want it before the 1.4 update see Discern: http://dev.bukkit.org/bukkit-plugins/discern/)
/lootbox create - Transforms your inventory into a lootbox, the chest item must be in the lower left-hand corner of your screen.
/lootbox loaddefaultconfig - Loads the default configuration, use with caution, it will overwrite any current Lootbox config.yml
A default config will also now be supplied when the config is first created (this won't affect any current configs!) so you may learn a little faster.
It's a lot to do! :P
Hello,
When i try to give myself a crate, it gives me an error code:
Internal Error has occured.
Do you know why? Thank You, Nelbrenn
@LtCookieMobster
:)
Thank-you. By the way this is a wonderful plugin you've made :)
@BandyPvP
Can you please link a copy of your Lootbox config.yml? Use http://pastebin.com/ please. It varies based on what permission you give it, it is: lootbox.use.lootbox.<permission>
@LtCookieMobster
If you put the /lootbox give ... command into the Votifier listener it would be automatic...
@TheOatBaron No I want it to be automatic. I don't want to give it to them as a reward manually. It's a pain.
What permission do i give un oped player so they can open crates?
Ok, making the tutorial video tonight. Please forgive my noobity, there was so much to cover and I have never done this before :P
@ArkticWulf
Refer to the 'Configuration' section. The config.yml is located in serverfolder\plugins\Lootbox
When i started up the plugin the only thing in the config is some chat stuff where is the config so i can edit crates
@LtCookieMobster
Use Votifier (http://dev.bukkit.org/bukkit-plugins/votifier/) and choose a listner that allows you to use a command and player name when a player votes. Then use the '/lootbox give <voter name> lootbox <lootbox name>' command to give them a lootbox.
How do you make it so that if you vote on a server page that you get a lootbox as a reward?
@broluigi
Set the lootbox permission, if you go by the 1.3 configuration, it would be the following permissions:
@broluigi
Set the drop to a chest/tripwire hook (or whatever default you have for a lootbox/key) and make the name and lore EXACTLY (case & color) the same as the lootbox/key name and lore. If you need more help, feel free to reply.
how can i use otherdrops to make common keys and loot boxes spawn?
how do i make it so players need permissions to open certain boxes?
@MineStomp
I just added things to the config, not making it simplier. I will be creating a tutorial though.
@TheOatBaron
can you give me a direct downlaod for 1.3 i can't use the 1.21 config it's too confusing?