SuperLuckyBlock Pro - Custom Surprises, Lucky Mining and more!

[Dannyj]

You can buy it at:
SpigotMC(6 USD): https://www.spigotmc.org/resources/...custom-surprises-lucky-mining-and-more.48837/

MCM(6 USD): https://www.mc-market.org/resources/5454/

Spoiler: Need support?

The fastest way to get help is by joining my discord support server. It’s the easiest way to contact me and I am able to be active on discord: https://discord.gg/nR2k3WF

You can also submit suggestions, report bugs or help with the development of this plugin!

About
SuperLuckyBlock is a luckyblock plugin with 74 surprises(version 1.35). With this plugin, players don't have to install the mod anymore! But that is not the only thing... SuperLuckyBlock has a lot of features which are configurable to! You have complete control over the features. The luckyblocks even look like the mod, but they are skulls instead of a block so they will be smaller.

NOTE: These surprises are NOT the same as the mod!

Features

• Multiworld support.
• Unlimited custom surprises!
• Disable worlds.
• Broadcast on break.
• PlaceholderAPI support.
• Buy or sell luckyblocks via signs.
• Built-in break ban system.
• Change the skull owner.
• Multiple ways to get luckyblocks.
• Chance to get a luckyblock while mining.
• Customizable crafting recipe (Default: http://prnt.sc/et75zi).
  
• Customizable Particles on break.
• Customizable Sound on break.
• Highly customizable.
• An update checker.
• Native 1.13 support (separate jar).
• Fast support.
• And much more!

2.0.0-ALPHA Info & Features
I am currently busy with reworking parts of the plugin. Because of the changes I am going to make I will change the plugin version to 2.0.0. While I am reworking the plugin I will be releasing alpha versions for you to test. Please report bugs you find at the bugtracker.

Upcoming features

• Commands rework
• A lot of surprises
• LuckyFountains
• More advanced surprises
• Some minor improvements
• And possibly more!

NOTE: Do not use alpha versions on production servers! I have not fully tested them and they may contain bugs!

1.13 Information
I have added full native support for MineCraft version 1.13 in 2.0.0-ALPHA-3.
The 1.13 version should be stable enough now. I haven’t got reports of bugs on 1.13 for a while.
Please note that this support may break as the current spigot 1.13 build is still in the extreme caution wave.
Please report any problems or bugs bugs on the bugtracker.

Showcase Video
You can find a video showing the features of version 1.02 in the spoiler(Pretty old but is still relevant. The plugin has much more features now) .

Spoiler: Videos

Surprises

Spoiler: Surprises

NOT UP TO DATE!

• Drop dirt, cobblestone and wool blocks (configurable amount).
• spawn an explosion with random power.
• Drop food (type and amount configurable)
• Drop obsidian with a configurable amount.
• Drop all wooden, stone, iron, gold or diamond tools.
• Drop enchantment table with configurable amount of lapis blocks.
• Spawn flying TNT.
• Spawn flying skeletons.
• Spawn 3 lava blocks in a row.
• Spawn a falling gold block.
• Spawn a falling iron block.
• Spawn 3 primed TNTs in a row.
• Trap the player in a obsidian cage with water in it.
• Spawn a lava hole beneath the player.
• Spawn zombies, give blindness and set time to night(night time can be disabled).
• Drop a configurable amount of golden apples
• Drop a configurable amount of TNT blocks.
• Drop a minecart with a configurable amount of rails.
• Drop a crafting table, a furnace and a chest.
• Drop a configurable amount of slime blocks.
• Spawn a redstone block and some TNT falling on it.
• Spawn a falling diamond block.
• Spawn 5 diamonds, iron, gold and emeralds.
• Spawn an enderdragon.
• Spawn a wither.
• Launch the player in the air(this will kill the player as it’s too high).
• Drop a lucky bow.
• Drop a lucky sword.
• Drop a lucky pickaxe.
• Spawn a villager tower and drop some emeralds.
• Drop a configurable amount of rotten flesh.
• Spawn a witch.
• Spawn a flying witch.
• Spawn a ghast.
• Spawn a giant zombie.
• Spawn a ghast riding a giant zombie.
• Spawn a lightning creeper.
• Drop a configurable amount of enderpearls.
• Drop a configurable amount of enderchests.
• Trap the player in a slime castle.
• Drop a nether star.
• Spawn flying XP bottles.
• Trap the player in a stone cage(without water).
• Drop a configurable amount of dirt.
• Drop a configurable amount of sticks.
• Trap the player in a cobblestone castle.
• Drop a configurable amount of wood.
• Drop a configurable amount of apples.
• Drop a configurable amount of bookshelf blocks.
• Drop a configurable amount of redstone.
• Drop a configurable amount of redstone blocks.
• Drop a configurable amount of ghast tears.
• Drop a crafting table.
• Drop a furnace.
• Spawn a giant slime.
• Spawn a giant magma cube.
• Drop sugar canes.
• Drop soul sand.
• Create your own custom surprises(modes: command, item, entity and building).

Older versions
Because of API changes some surprises will be disabled on 1.8 and 1.9.
These surprises are:

• FallingTNT
• Husk
• Stray
• PolarBear
• Guardian
• ElderGuardian
• GoldBlock
• IronBlock
• DiamondBlock

On 1.8, particles on break and on luckymining will also be disabled.

Commands
- /slb help - shows the help page
- /slb give <amount> [player] - gives yourself or a player the amount of luckyblocks specified
- /slb ban <player> - bans a player from breaking luckyblocks
- /slb unban <player> - allows a player to break luckyblocks again
- /slb giveall <amount> - Give all players in the server the specified amount of luckyblocks.
- /slb uploadreport - creates a report with useful server information and uploads this to pastebin. This helps me with fixing issues.
- /slb level - See your current level and EXP.
- /slb addexp - Give someone EXP.


Permissions
- superluckyblock.help - gives you permissions to use /slb help
- superluckyblock.give - gives you permission to use /slb give
- superluckyblock.ban - gives you permission to use /slb ban
- superluckyblock.unban - gives you permission to use /slb unban
- superluckyblock.giveall - gives you permission to use /slb giveall
- superluckyblock.uploadreport - gives you permission to use /slb uploadreport
- superluckyblock.createsign - gives you the permission to create signs starting with [SLB]
- superluckyblock.luckymining - allows luckymining when LuckyMining.EnablePermission is enabled in the config.
- superluckyblock.level - Gives access to /slb level.
- superluckyblock.addexp - Gives access to /slb addexp.
- superluckyblock.notify - Notifies a user when an update is available.


Configuration
Default config

###################################################
#                                                 #
#  SuperLuckyBlock-Pro By SickSkillz at SpigotMC  #
#                Config Version: v1               #
#                                                 #
###################################################

Surprises:
  Enabled:
    # When a surprise is set to true, it is enabled. If not, it will be skipped.
    # When a surprise is disabled the plugin will take a new surprise.
    RandomBlocks: true
    Explosion: true
    Food: true
    Obsidian: true
    EnchantmentItems: true
    FlyingTNT: true
    FlyingSkeletons: true
    Lava: true
    GoldBlock: true
    IronBlock: true
    PrimedTNT: true
    ObsidianCage: true
    LavaHole: true
    Zombies: true
    GoldenApples: true
    TNTItem: true
    MineCart: true
    UsefulBlocks: true
    SlimeBlocks: true
    FallingTNT: true
    DiamondBlock: true
    Materials: true
    EnderDragon: true
    Wither: true
    Launch: true
    LuckyBow: true
    LuckySword: true
    LuckyPickaxe: true
    VillagerTower: true
    RottenFlesh: true
    Witch: true
    Ghast: true
    GiantZombie: true
    GhastArmoredGiant: true
    LightningCreeper: true
    Lightning: true
    EnderPearls: true
    EnderChests: true
    NetherStar: true
    FlyingXPBottles: true
    Blaze: true
    StoneCage: true
    Dirt: true
    Stick: true
    Wood: true
    Apples: true
    Bookshelfs: true
    RedstoneDust: true
    RedstoneBlocks: true
    GhastTear: true
    CraftingTable: true
    Furnace: true
    GiantSlime: true
    GiantMagma: true
    SugarCanes: true
    SoulSand: true
    Pistons: true
    StickyPistons: true
    TamedWolf: true
    TamedOcelot: true
    Husk: true
    Stray: true
    PolarBear: true
    Tools:
      WoodenTools: true
      StoneTools: true
      GoldTools: true
      IronTools: true
      DiamondTools: true
    CustomSurprises: true

# A custom surprise has 3 valid modes: command, item, entity and building. Other values will cause errors!
# You can an unlimited amount of surprises! If you need help with creating don't hesitate to contact me!
# When adding a surprise you can create a new key by typing CustomSurpriseX where X is the surprise number.
# Please note the spacing(DON'T use tab!).
# Make sure you increase the number for every new surprise, also make sure you don't skip numbers.
# Don't remove CustomSurprise1! Disable Surprises.CustomSurprises if you don't want to use them!
CustomSurprises:
  # Command example. Make sure you use those values when using the command mode!
  CustomSurprise1:
    Mode: command
    Permission: 'superluckyblock.group.vip'
    Commands:
    - 'give %player% minecraft:dirt 32'
    - 'tell %player% &e%player%, looks like you got some dirt!'
  # Item example. Make sure you use those values when using the item mode!
  # You can find the valid values for Item here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
  CustomSurprise2:
    Mode: item
    Item: ARROW
    Amount: 20
  # Entity example. Make sure you use those values when using the entity mode!
  # You can find the valid values for Entity here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html
  CustomSurprise3:
    Mode: entity
    Entities:
    - COW
    - PIG
    - SHEEP
  # This surprise will not be triggered unless you install WorldEdit and create the schematic file.
  # I recommend to remove this surprise, as it's just an example.
  # Schematics should be saved in plugins/SuperLuckyBlock-Pro/schematics
  # Location accepts the following values: player and block
  # When you select player, it will spawn the building at the player's location.
  # When you select block, it will spawn it at the block's location.
  CustomSurprise4:
    Mode: building
    Schematic: example.schematic
    Location: player

SurpriseSettings:
  Explosion:
    MinExplosionPower: 2
    MaxExplosionPower: 6
  EnchantmentItems:
    DropLapisBlock: true
    DropAmount: 16
  Obsidian:
    DropAmount: 16
  RandomBlocks:
    DropAmount: 32
  GoldenApples:
    DropAmount: 4
  TNTItems:
    DropAmount: 12
  MineCart-Rails:
    DropAmount: 32
  SlimeBlocks:
    DropAmount: 16
  RottenFlesh:
    DropAmount: 16
  Dirt:
    DropAmount: 16
  Wood:
    DropAmount: 16
  Apples:
    DropAmount: 12
  Bookshelfs:
    DropAmount: 16
  RedstoneDust:
    DropAmount: 24
  RedstoneBlocks:
    DropAmount: 4
  GhastTear:
    DropAmount: 1
  CraftingTable:
    DropAmount: 1
  Furnace:
    DropAmount: 1
  Sticks:
    DropAmount: 4
  SugarCanes:
    DropAmount: 4
  SoulSand:
    DropAmount: 6
  Pistons:
    DropAmount: 4
  StickyPistons:
    DropAmount: 4
  Zombies:
    SetNight: false
  Food:
    FoodType: COOKED_BEEF
    DropAmount: 4
  GiantSlime:
    Size: 14
  GiantMagma:
    Size: 14
  Husk:
    SpawnAmount: 1
  Stray:
    SpawnAmount: 1
  PolarBear:
    SpawnAmount: 1
  Tools:
    Enabled:
      # These count as different surprises.
      # True = enabled, false = disabled and next will be chosen.
      WoodenTools: true
      StoneTools: true
      GoldTools: true
      IronTools: true
      DiamondTools: true

PluginSettings:
  MessagePrefix: "&e&lSLB >> &f"
  # Use sponge blocks instead off skulls. If enabled HeadOwner will be ignored.
  SpongeMode: false
  HeadOwner: 'Luck'
  DisplayName: '&e&lLucky Block'
  BroadcastOnBreak:
    # When enabled, it will broadcast a message on every luckyblock break.
    Enabled: false
    # The message which will broadcast.
    # %player% will be replaced with the user which broke the block.
    Message: '%player% broke a LuckyBlock!'
  CraftingRecipe:
    # When disabled, you will not be able to craft the luckyblock.
    Enabled: true
    # Here you can set the crafting recipe. 1 is at the top left and 3 is at the top right.
    # 7 is down left and 9 down right.
    Slot1: GOLD_INGOT
    Slot2: GOLD_INGOT
    Slot3: GOLD_INGOT
    Slot4: GOLD_INGOT
    Slot5: DROPPER
    Slot6: GOLD_INGOT
    Slot7: GOLD_INGOT
    Slot8: GOLD_INGOT
    Slot9: GOLD_INGOT
  # When user breaks a luckyblock in the specified world, it will not give any surprise.
  DisabledWorlds:
  - Example1
  - Example2

  # Settings for the ban system.
  BanList:
    #Send the user message specified below when the user tries to break a block and is banned.
    MessageOnBreak: true
    Message: '&c&lYou are not allowed to break luckyblocks as you are on the ban list!'
    # Prevents breaking when banned.
    PreventBreak: true

  # Particle settings
  Particles:
    Enabled: true
    # Effect names can be found here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html
    ParticleEffect: FLAME
    # The amount of particles.
    ParticleAmount: 200
  # Sound settings
  Sounds:
    Enabled: true
    # Sound names can be found here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
    Sound: BLOCK_NOTE_PLING
  # Some other settings
  Other:
    # Prevents breaking by water and lava.
    PreventBreakingByWater: true
    # Drop the luckyblock when you right click on it while placed.
    DropOnRightClick: false

BlockBreakProt:
  # If you enable this, specified blocks can't be exploded by ANYTHING.
  EnableExplodeProt: false
  # Block list: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
  # Format: (block name):(data value)
  # If you don't know the data value enter 0.
  ProtectedBlocks:
  - STONE:6 # Polished Andesite
  - STONE:4 # Polished Diorite

LuckyMining:
  # When enabled you have a chance of getting a luckyblock when mining.
  Enabled: true
  # The chance of getting a luckyblock
  Chance: 5.0
  # When true, player require the permission superluckyblock.luckymining to get lucky blocks while mining.
  EnablePermission: false
  SendMessage:
    Enabled: true
    Message: 'You got a luckyblock from mining!'
  SpawnParticles:
    Enabled: true
    ParticleEffect: FLAME
    ParticleAmount: 200
  Sound:
    Enabled: true
    Sound: BLOCK_NOTE_PLING
  # Timeout specifies how long a user has to wait in seconds before having a chance to get another lucky block while mining
  Timeout:
    Enabled: true
    Time: 60
  # You only have a chance of getting a luckyblock when breaking the following blocks
  BlockNames:
  - STONE
  - GOLD_ORE
  - IRON_ORE
  - COAL_ORE
  - DIAMOND_ORE
  - REDSTONE_ORE

# All options related to buying and selling luckyblocks.
# NOTE: You will need vault and an economy plugin for this!
# This plugin doesn't provide economy!
Economy:
  # More options will be added soon.
  Buy:
    BuyPrice: 100
  Sell:
    SellPrice: 50

Messages:
  # Please note that all messages start with the PluginSettings.MessagePrefix except the HelpMessage.
  BreakBan: "%player% has been banned from breaking luckyblocks."
  BreakUnban: "%player% has been unbanned from breaking luckyblocks."
  UnbanError: "%target% is not banned or is not a player!"
  AlreadyBanned: '%target% is already banned!'
  ConfigReloaded: 'The config has been reloaded!'
  AmountNotSpecified: 'You need to specify the amount of luckyblocks.'
  NoInteger: 'The amount must be a number.'
  PlayerNotSpecified: 'You need to specify the player you want to give the luckyblock.'
  1LBReceived: 'You received a luckyblock.'
  PlayerGave1LB: '%sender% gave you a luckyblock.'
  GiveallBroadcast: '%sender% gave everyone in the server %amount% luckyblocks!'
  MultipleLBReceived: 'You received %amount% luckyblocks.'
  PlayerNotFound: 'Player %target% not found. Make sure this player is online!'
  NoPermission: "You don't have permission to use this command."
  WrongUsage: 'Wrong command usage! Use /slb help for help.'
  TooManyArguments: 'Too many arguments! Usage: /slb give <amount> [player]'
  LevelUp: "You are now level %newlevel%!"
  HelpMessage:
  - "&cBecause you didn't specify a command this help page is shown."
  - '&e&lSuperLuckyBlock Commands'
  - '&e<> = required [] = optional'
  - '&f/slb help - Shows this help page.'
  - '&f/slb give <amount> [player] - Gives you or a player a luckyblock.'
  - '&f/slb ban <name> - stops a player from breaking luckyblocks.'
  - '&f/slb unban <name> - Let a player break luckyblocks again.'
  - '&f/slb giveall <amount> - Give all players in the server the amount of luckyblocks.'
  - '&f/slb reload - Reload the config.'
  - '&f/slb uploadreport - Uploads a report with useful server information to pastebin.'
  - '&f/slb level - See your current level and EXP.'
  - '&f/slb addexp <player> <amount> - Give a player the EXP you specify.'

Startup:
  # Check if a new update is available on startup
  CheckUpdate: true

# Do not touch this, it will reset your config if you change it!
ConfigVersion: 1.31

PlaceholderAPI
Starting from version 1.04 SuperLuckyBlock supports PlaceholderAPI.
You can currently use the following placeholders:
- %superluckyblock_luckyblocksbroken% - Displays how many luckyblocks the player has broken(https://prnt.sc/h7uzxk).

Economy
Starting from version 1.05 SuperLuckyBlock supports 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).

Supported signs:

Spoiler: Signs

Buy
Line 1: [SLB]
Line 2: buy
Line 3 and 4 can be left empty, you can also write notes on these lines.

Sell
Line 1: [SLB]
Line 2: sell
Line 3 and 4 can be left empty, you can also write notes on these lines.

WorldEdit
Starting from version 1.19, SuperLuckyBlock needs worldedit if you want to add custom building surprises.

Servers using this plugin
- LegendsForge.net
- More to come...

If you want you server here please send me a DM.

Reviews/vouches

Reporting bugs
You can report bugs at my bugtracker.
You need a github account for this.

Suggestions
Suggestions are always welcome!
If you have one, you can report it at my bugtracker.

FAQ
Q: Does your plugin support Java 7?
A: No and it will never do. If you still use Java 7, please upgrade your Java version or ask your host to do it because it isn't supported anymore.

Q: Does your plugin support MineCraft 1.8 or 1.9?
A: 1.8 and 1.9 support has been added. If one of those versions is detected incompatible features will be disabled.

Q: Does your plugin support MineCraft 1.13?
A: Yes, support has been added in version 2.0.0-ALPHA-3. It has it's own jar because of the changes required.

Q: I have a problem with feature X.
A: Please send me a PM, join my discord or ask in the discussion for help.

Please only report bugs and suggest features on my discord server, in the bugtracker(prefered) or in PM! Bug reports in reviews will be ignored!
​

TOS
1. You are not allowed to share, redistribute or resell this plugin.
2. You may only use this plugin on your server, giving it to other servers isn't allowed.
3. You are allowed to decompile and modify this plugin as long as you follows the other TOS rules.
4. I am not responsible for any damage done to your world, players losing items etc. This plugin contains some destructive and/or killing surprises and you should disable these before using the plugin.
5. All purchases are final and no refunds will be given. Chargebacks/disputes will result in losing access to the plugin and future updates of it.


If you need some support you can always send me a PM or join my discord and I'll be happy to help!

You can buy it at:
SpigotMC(6 USD): https://www.spigotmc.org/resources/...custom-surprises-lucky-mining-and-more.48837/

MCM(6 USD): https://www.mc-market.org/resources/5454/