CustomSurprises:
  Example:
    Name : Example
    Chance : 100.0
    Permission:
      Enabled : false
    Commands:
      Enabled : false
    Items:
      Enabled : false
    Entities:
      Enabled : false
    Building:
      Enabled : false
    Blocks:
      Enabled : false
    Messages:
      Enabled : false
    Script:
      Enabled : true
      Script : "example.lua"
 

--[[
Example script that can run untrusted.

The following variables are available to lua scripts. All of these variables are exact copies of their Java classes from Spigot:
- player - The player that broke the luckyblock. Documentation: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/Player.html
- loc - The location of the broken luckyblock. Documentation: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Location.html
- world - The world the luckyblock was broken in. Documentation: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/World.html
- scheduler - The bukkit scheduler which can be used to, for example, delay tasks: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/scheduler/BukkitRunnable.html
- All material enum values are available as global variables, prefixed with MATERIAL_. (For example, you can use MATERIAL_IRON_BOOTS to use the IRON_BOOTS Material). Materials: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
- All effect enum values are available as global variables, prefixed with EFFECT_. Usage is the same as the material values. Effects: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Effect.html
- All sound enum values are available as global variables, prefixed with SOUND_. Usage is the same as the material values. Sounds: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
- All enchantment values are available as global variables, prefixed with ENCHANTMENT_. Usage is the same as the material values. Enchantments: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/enchantments/Enchantment.html

SuperLuckyBlock also provides a utils class, which allows you to do the following things:
- utils:createItemStack(material, amount) - Allows you to create a new ItemStack. Docs: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/inventory/ItemStack.html
- utils:colorText(text) - Converts values like &3 to their respective colors.
- utils:createEnchantment(name) - Creates an Enchantment object with the specified enchantment. Enchantments: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/enchantments/Enchantment.html

Methods on these variables can be called in 2 ways:
- player:setFireTicks(100)
- player.setFireTicks(player, 100)

As you can see, calling a method with a dot requires you to pass the variable(in this case player) alongside the other arguments. You don't have to do that when using the semicolon.

If you are missing access to any classes/methods, feel free to contact me and I will look into adding support for it.
]]

local name = player:getName()

if string.find(name, "i") ~= nil then
    local itemStack = utils:createItemStack(MATERIAL_DIAMOND_SWORD, 1)
    local itemMeta = itemStack:getItemMeta()

    itemMeta:setDisplayName(utils:colorText("&2&lSome &3&lRandom &4&lSword"))
    itemMeta:addEnchant(utils:createEnchantment("KNOCKBACK"), math.random(1, 10), true)
    itemStack:setItemMeta(itemMeta)
    world:dropItemNaturally(loc, itemStack)
else
    local fireTicks = math.random(100, 500)

    player:setFireTicks(fireTicks)
    player:chat("I'm on fire for " .. fireTicks .. " ticks!")
end
 

--[[
Example script that can only be ran in trusted mode.

The same methods as specified in example.lua are available in trusted mode. In addition to that, scripts that run in trusted mode have access to the following features:
- All Java and Spigot classes (Luajava library)
- Any file reading or writing
- The IO library
- The OS library
- Loading other scripts
- Creating coroutines

Luajava provides two important functions that make trusted mode so powerful, but also dangerous:
- luajava.bindClass("fully.qualified.class.name") - Example: luajava.bindClass("org.bukkit.Bukkit"). Allows you to call static methods, access static fields and enum values
- luajava.newInstance("fully.qualified.class.name") - Example luajava.newInstance("org.bukkit.inventory.ItemStack"). Creates a new instance of the specified class. Allows the methods of that class to be used.
]]

local bukkit = luajava.bindClass("org.bukkit.Bukkit")
local server = bukkit:getServer()
local itemstack = luajava.newInstance("org.bukkit.inventory.ItemStack", MATERIAL_DIAMOND_BLOCK, 4)

player:chat("Hello! Welcome to " .. server:getName())
world:dropItemNaturally(player:getLocation(), itemstack)

# You can create an unlimited amount of custom surprises. See the examples below for information on how to do this.
CustomSurprises:
  Example :
    # Name used in broadcasts, titles, actionbars etc.
    Name : "Example"
    # Set to 0.0 to completely disable a surprise.
    Chance : 0.0
    Permission :
      # When enabled, only players with the specified permission will be able to get this surprise.
      Enabled : false
      Permission : "superluckyblock.custom.permission"
    # Commands that will be executed. DO NOT include the slash(/).
    Commands:
      Enabled : true
      Commands :
       - 'give %player% minecraft:dirt 2'
        - 'give %player% minecraft:cobblestone 4'
    # Items that will be dropped by this surprise.
    Items:
      Enabled : true
      # Each surprise can have an unlimited amount of items. Make sure to follow the examples below.
      Items:
        EmptyBucket :
          # Valid material names: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
          Material : "BUCKET"
          # The amount of times this item will be dropped.
          Amount : 3
          # Set to "none" to disable.
          DisplayName : "none"
          # Enchantments that will be applied to the item. There are no enchantment level restrictions.
          Enchantments:
            Enabled : false
            # The enchantment name is the vanilla name, all in lowercase and spaces replace by a _. Example: sweeping_edge:2
            Enchantments :
             - "ENCHANTMENT:level"
        Coal:
          Material : "COAL"
          Amount : 1
          # Set to "none" to disable.
          DisplayName : "&4&lSpecial Coal"
          Enchantments:
            Enabled : true
            Enchantments :
             - "sharpness:2"
              - "unbreaking:1"
    # Entities that will be spawned by this surprise.
    Entities:
      Enabled : true
      # Each surprise can have an unlimited amount of entities. Make sure to follow the examples below.
      Entities:
        Pig :
          # Valid entity names: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html
          Entity : "PIG"
          # The amount of times this entity will be spawned.
          Amount : 1
          # Set to "none" to disable.
          Name : "none"
          # Potion effects that will be applied to the entity after it has been spawned.
          PotionEffects:
            Enabled : false
            # Valid potion types: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionEffectType.html
            # Duration is the effect duration in seconds.
            PotionEffects :
             - "POTION_TYPE:level:duration"
        InvisibleSheep:
          Entity : "SHEEP"
          Amount : 3
          Name : "Invisible Sheep"
          PotionEffects:
            Enabled : true
            PotionEffects :
             - "INVISIBILITY:1:60"
    # Pastes a schematic. This feature will only work if WorldEdit is installed.
    Building:
      Enabled : false
      # Name of the schematic that should be spawned
      Schematic : example.schem
      # When true, air blocks will not be pasted.
      IgnoreAir : false
      # Values:
      # player - paste the center of the schematic at the player's location
      # block - paste the center of the  schematic at the luckyblock's location
      Location : block
    Blocks:
      Enabled : true
      # The height the blocks will fall from. Make sure that this is higher than the amount of blocks specified in FallingBlocks.
      FallHeight : 15
      # The delay in ticks before the next falling block in the list will spawn. Should be at least one.
      # 20 ticks = 1 second
      FallDelay : 10
      # The block at the top will be the first to fall.
      # Valid material names: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
      FallingBlocks :
       - "IRON_BLOCK"
        - "GOLD_BLOCK"
        - "EMERALD_BLOCK"
        - "DIAMOND_BLOCK"
    # Message that will be sent to the player. Completely remove if you don't want this in your surprise.
    Messages:
      Enabled : true
      Messages :
       - "Enjoy the test surprise!"
        - "&aYou can even send multiple messages!"

HeadOwner : block:ITEM_NAME

CustomSurprises:
  CustomSurprise1:
    Chance : 100
    # A list of Entities that will be spawned when this surprise is ran.
    # You can find the valid values here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html
    # You can also spawn armorstands with armor by using ARMOR_STAND!HELMET!CHESTPLATE!LEGGINGS!BOOTS!WEAPON.
    # Example: ARMOR_STAND!DIAMOND_HELMET!GOLDEN_CHESTPLATE!IRON_LEGGINGS!LEATHER_BOOTS!STONE_SWORD
    # WEAPON can be left empty if you don't want to use it.
    Entities :
   - ARMOR_STAND!DIAMOND_HELMET!GOLDEN_CHESTPLATE!IRON_LEGGINGS!LEATHER_BOOTS!STONE_SWORD

# If you want to enchant an item, use the following format(please note that you CAN'T specify an amount!):
# {ITEM}!{enchantment_name}-{LEVEL}
# The enchantment name is the vanilla name, all in lowercase and spaces replace by a _.
   Items :
   - DIAMOND_SWORD!unbreaking-2!sharpness-1

SLB >> The schematic in custom surprise 'CustomSurprises.CustomSurprise2' does not exist. Please make sure you configured it the right way

    # A list of items that will be dropped when this surprise is ran.
    # If you want to drop the item multiple times, use the following format:
    # {ITEM}:{AMOUNT}
    # You can find the valid values here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
    Items :
   - BUCKET:2
    - COAL:6

  Lore:
    - "This is line one"
    - "&aLook! You can use colors!"
    - "This is my favorite line, wait it's not..."

Settings:
  HeadOwner: "template_please_change"
  DisplayName: '&e&lTemplate Block'
  Lore:
    - "Line"
    - "Another line"
    - "&aLine with &bcolors"
  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: IRON_INGOT
    Slot2: IRON_INGOT
    Slot3: IRON_INGOT
    Slot4: IRON_INGOT
    Slot5: DROPPER
    Slot6: IRON_INGOT
    Slot7: IRON_INGOT
    Slot8: IRON_INGOT
    Slot9: IRON_INGOT
  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
  Sounds:
    Enabled: true
    # Sound names can be found here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
    # For 1.9 and 1.8 they can be found here: http://docs.codelanx.com/Bukkit/1.8/org/bukkit/Sound.html
    Sound: BLOCK_NOTE_PLING
 
Surprises:
  Chances:
    # When a chance is set to 0, the surprise will be disabled.
    # The chance can be any number you want. The total of the chances DON'T have to be 100.
    Apples: 100
    Blaze: 100
    Bookshelfs: 100
    Buckets: 100
    CraftingTable: 100
    DiamondBlock: 100
    DiamondTools: 100
    Dirt: 100
    ElderGuardian: 100
    EmeraldBlock: 100
    EnchantmentItems: 100
    EnderChests: 100
    EnderDragon: 100
    EnderPearls: 100
    Explosion: 100
    FallingTNT: 100
    FlyingSkeletons: 100
    FlyingTNT: 100
    FlyingXPBottles: 100
    Food: 100
    Furnace: 100
    Ghast: 100
    GhastArmoredGiant: 100
    GhastTear: 100
    GiantMagma: 100
    GiantSlime: 100
    GiantZombie: 100
    GoldBlock: 100
    GoldenApples: 100
    GoldTools: 100
    Guardian: 100
    Husk: 100
    IronBlock: 100
    IronTools: 100
    Launch: 100
    Lava: 100
    LavaHole: 100
    Lightning: 100
    LightningCreeper: 100
    LuckyBow: 100
    LuckyPickaxe: 100
    LuckySword: 100
    Materials: 100
    MineCart: 100
    NetherStar: 100
    Obsidian: 100
    ObsidianCage: 100
    Pistons: 100
    PolarBear: 100
    PrimedTNT: 100
    RandomBlocks: 100
    RedstoneBlocks: 100
    RedstoneDust: 100
    RottenFlesh: 100
    SlimeBlocks: 100
    SoulSand: 100
    Stick: 100
    StickyPistons: 100
    StoneCage: 100
    StoneTools: 100
    Stray: 100
    SugarCanes: 100
    TamedOcelot: 100
    TamedWolf: 100
    TNTItems: 100
    UsefulBlocks: 100
    VillagerTower: 100
    Witch: 100
    Wither: 100
    Wood: 100
    WoodenTools: 100
    Zombies: 100
    KnockbackStick: 100
    UselessSword: 100
    CustomSurprises: 100
 
CustomSurprises:
  # CustomSurprise example with all modes used, except a building surprise.
  # For the building surprise see CustomSurprise2
  # This surprise is not enabled.
  CustomSurprise1:
    # Chance works the same as for normal surprises.
    Chance: 100
    # A custom permission required to get this surprise
    Permission: "superluckyblock.custom.permission"
    # A list of commands that will be executed when this surprise is ran.
    Commands:
    - 'give %player% minecraft:dirt 2'
    - 'give %player% minecraft:cobblestone 4'
    # A list of items that will be dropped when this surprise is ran.
    #You can find the valid values here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
    Items:
    - 'BUCKET'
    - 'COAL'
    # A list of entitites that will be spawned when this surprise is ran.
    # You can find the valid values here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html
    Entities:
    - 'PIG'
    - 'SHEEP'
    # A message that will be sent after the surprise ran.
    # PluginSettings.MessagePrefix will be used in front of it.
    Message: "Enjoy the test surprise!"

  # This surprise will not be triggered unless you install WorldEdit and create the schematic file.
  # I recommend to remove or edit this surprise, as it's just an example.
  # Schematics should be saved in plugins/SuperLuckyBlock-Pro/schematics
  CustomSurprise2:
    Chance: 100
    # Name of the schematic that should be spawned
    Schematic: dirthouse.schematic
    # Location accepts the following values: player and block. This field is REQUIRED for building surprises.
    # 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.
    Location: player

  CustomSurprise3:
    # The luckyblock will be changed into this block after the surprise is ran. If this option is removed the luckyblock will become AIR.
    # You can find the valid values here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
    Block: DIRT
    Permission: "this.is.another.permission"
   

# 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