SuperLuckyBlock [1.13.2 - 1.17] - The LuckyBlock Plugin That Gives You FULL Control! 4.3.1

NOTE: Minecraft versions 1.8-1.11 are no longer supported! If you still want to use SuperLuckyBlock on 1.8 you can download it from the version history tab or click here to download it.

NOTE 2: Support for 1.12 will be dropped soon. Old versions will stay available for those that plan on continuing to use 1.12.

SuperLuckyBlock now has a wiki(Still WIP)! You can find information on getting started and the default configuration. More information will be added soon! https://wiki.sickskillz.org/


Spoiler: Need Support?


SuperLuckyBlock is a luckyblock plugin that gives you FULL control over its features.
You are able to create your own surprises, create your own custom luckyblocks, create your own wands, modify almost every single part of the plugin, and much more!
You are able to use SuperLuckyBlock in any way you want!


Custom Surprises
Exclusive to SuperLuckyBlock: create your own surprises and modify them to your own likings.
Spawn mobs, drop items, create buildings, execute commands, or all of these at once!

Custom LuckyBlocks
SuperLuckyBlocks allows you to create your own CUSTOM luckyblocks.
You are able to set the skin of the skull, require permission, create custom surprises, and more!
You are able to use these as lootbox, a donation perk, or just a block that is craftable.


Wands
Wands are special weapons which all do different, special things. They can shoot entities, spawn lightning, or even heal the player. Because the feature is relatively new(added in 3.0.0), there are only 6 wands at the moment. What these wands do can be found in the spoiler below:

Spoiler: Available Wands

Custom Wands
Do you not like the built-in wands or are there any missing wands? SuperLuckyBlock allows you to create your own wands that can do the following things:
- Throw blocks
- Spawn entities
- Execute commands

Custom Skull Textures
SuperLuckyBlock allows you to use skin textures from websites like https://minecraft-heads.com/ by using their texture URL(example: http://textures.minecraft.net/textu...fc999a0cb127ca2f9705af1554a86fef131112b9c11ac). You can also use a player's skin.


Chance Based Surprises
Surprises in SuperLuckyBlock aren't just randomly selected, they use a chance system so you can decide which surprises are rarer than the other ones!
Don't want to see everyone walking around with a pretty strong lucky sword? No problem! Just lower the chance and it should be solved!

LuckyActions
Only getting luckyblocks from crafting would be boring, right?
That's why SuperLuckyBlock contains a system named LuckyActions!


LuckyActions gives your players a configurable chance to get a luckyblock while performing certain actions in the game.
This makes being active on your server more fun and rewarding.
Currently, supported actions are:
- Mining
- Other actions will be added later!

Custom Messages
SuperLuckyBlock allows you to add a message to each surprise, including custom surprises!

Crafting Recipe
LuckyMining isn't the only way to get luckyblocks.
You are able to enable and customize a crafting recipe, so your players are able to craft the luckyblocks.


Shop
SuperLuckyblock allows you to buy or sell Luckyblocks using a GUI. You can set any price you want.



PlaceholderAPI support
PlaceholderAPI can be used to display information of SuperLuckyBlock and the player data collected.
More info can be found in the compatibility section.

Full control
SuperLuckyBlock allows you to change and manage a lot of things.
You can disable luckyblocks in a specific world, you can set permissions, change the skull skin, customize the sound and particles on break, and a lot more.


Premium support
I always try to reply within 24 hours and reported bugs will be solved as fast as possible.
If you have any questions, suggestions, or found any bugs, don't hesitate to contact me!


Survival
In my opinion, luckyblocks make survival way more fun. Players like testing their luck.
Will they get a lucky sword, or maybe an explosion? It makes their experience a bit more unique and fun.

Lucky Skywars
You can give your skywars minigame a unique twist by adding luckyblocks to it.
I recommend adding some extra custom surprises like buildings so it's even more fun!

Prison
With the use of sponge mode, you can use sponges in your prison mines to make mining a lot more interesting, fun, and rewarding for your players!

Other Minigames
You can use SuperLuckyBlock with any minigame that allows you to break blocks as long as it saves your map or rolls it back.

Lootboxes
You know, those boxes most popular servers use? Not that unique right?
What if you give your players luckyblocks as a reward?
They can use them anywhere they want and get a nice (or not so nice) surprise.

Fun
Of course, you can use luckyblocks just for fun.
You could play with your friends, create maps or staircases with luckyblocks and do a luckyblock race or just see who is the luckiest. Everything is possible!




Why should I choose SuperLuckyBlock?
SuperLuckyBlock provides you a lot of features and customization that you usually don't see in other luckyblock plugins. New features are also constantly being added.

Will SuperLuckyBlock cause any lag?
No, I try to keep the performance as good as possible and will try to fix any performance issues.
No one likes a laggy server.

I hate surprise X, am I able to disable it?
Yes, all surprises can be disabled by setting their chance to 0.

Could you implement surprise X?
I will be able to implement most ideas when suggested.
Please contact me so we can talk about it and work it out.

Players get too many luckyblocks from LuckyMining. How can I solve this?
Try to lower the chance in the LuckyMining section.
You can also try to enable the timeout or set the timeout time to a higher value.

Is there a developer API available for SuperLuckyBlock?
Yes, there is! You can find it on https://github.com/SickSkillz/SuperLuckyAPI



Requirements
Minecraft 1.12 or higher is required.
Java 8 or higher is required.
Other plugins listed below are optional.

PlaceholderAPI
SuperLuckyBlock contains one placeholder at the moment:
%superluckyblock_luckyblocksbroken% - allows you to display the number of blocks broken.

Vault
SuperLuckyBlock supports the buying and selling of luckyblocks via signs.
You will need Vault and an economy plugin(you can just use essentials if you don't know one).

You can create the signs by entering the following:

Spoiler: Sign Layout

WorldEdit
WorldEdit is required to spawn buildings when using custom building surprises.


<> = required, [] = optional
/slb convert - Converts old configurations in the /convert and old luckyblock files in the /convert/luckyblocks directory.
/slb debug - Creates a debug report.
/slb give <luckyblock name> <player> [amount] - Gives the specified luckyblock to the specified player.
/slb giveall <luckyblock name> [amount] - Give a luckyblock to all players currently online.
/slb givewand <wand name> - Gives the specified wand to a player.
/slb help - Displays this page.
/slb reload - Reloads the configuration. Might not reload all options, so please restart your server if this happens.
/slb shop <luckyblock name> - Open the shop for the specified luckyblock.


- superluckyblock.help - gives you permissions to use /slb help
- superluckyblock.convert - gives you permission to use /slb convert
- superluckyblock.give - gives you permission to use /slb give
- superluckyblock.giveall - gives you permission to use /slb giveall
- superluckyblock.givewand - gives you permission to use /slb givewand
- superluckyblock.reload- gives you permission to use /slb reload
- superluckyblock.notify - Notifies a user when an update is available.
- superluckyblock.shop- gives you permission to use /slb shop
- superluckyblock.debug - gives you permission to use /slb debug


You can find the default configurations on this wiki page: https://wiki.sickskillz.org/en/default_config
You can check them to see all the features SuperLuckyBlock has to offer.



If you have any questions, want to report a bug, tell your suggestion, or anything like that, feel free to contact me in the following ways.

Discord Server: https://discord.gg/MW9EFbe

Bug reports in reviews will be ignored!


I also want to thank @mmuziek for helping me implement the skull textures from a URL feature and @Choco for his great Update Checker which is way better than the one I created before using his one.



By purchasing this plugin you agree to the following terms:
1. Sharing, redistributing, or reselling this plugin in any way is not allowed.
2. All code is copyright of SickSkillz, the author of the plugin.
3. I am not responsible for any damage done to your server, including, but not limited to, lost items, damage to worlds, and corrupted files. This plugin contains some destructive surprises that may kill your players or destroy your world. You should look over the configuration before using the plugin.
4. I am not responsible for any bugs that may cause the plugin to not work as expected.
5. All purchases are final and no refunds will be given, except in special cases(e.g. double payments).
6. Opening a PayPal dispute will result in an immediate termination of access to the plugin and the usage of it, no matter the result of the dispute.
7. Support for any Minecraft version may be dropped at any time. Older versions of the plugin are available for unsupported Minecraft versions, but support will not be provided.
8. The terms of service may be changed at any time, without notification.

Breaking any of the terms may result in a loss of access to the plugin or the usage of it.