SimpleBombs [1.13 - 1.20.1]

SimpleBombs is a easy to use and set-up bombs plugin. It is a very light, simple and highly configurable to fit what your server needs.

_________________________________________________

# DEPENDENCIES

Make sure you have required plugins installed for the plugin to work properly.

• WorldGuard - required;
• WorldEdit - required;
• HolographicDisplays or DecentHolograms - required ;
• Vault - optional (for auto-sell feature).
_________________________________________________

# FEATURES

These are some of the features that this plugin provides.

• Fortune levels (increase the amount of blocks gained from explosion);
• Configurable bomb radius;
• Configurable bomb explosion and throw sounds;
• Configurable bomb explosion countdown display;
• Built-in placeholders;
• Customizable explosion effects;
• Permission requirements to use the bombs;
• Option to add glowing effects to the item;
• Customizable detonation time;
• Option to destroy or ignore liquids;
• Option to deal damage to entities;
• WorldGuard support;
• Automatic item selling on explosion.

If you want to use SimpleBombs in a WorldGuard region, set simple-bombs-explode flag to allow.

Ex. /wg flag BombsArea simple-bombs-explode allow
_________________________________________________

# COMMANDS & PERMISIONS

RELOAD CONFIGURATION
Command: /simplebombs reload
Permission: simplebombs.command.reload

GIVE PLAYER A BOMB
Command: /simplebombs give <player> [amount]
Permission: simplebombs.command.give

OPEN BOMB LIST
Command: /simplebombs gui
Permission: simplebombs.command.gui
_________________________________________________

# CONFIGURATION

Configuration is pretty simple and easy to understand.
For more detailed explanation, visit Github wiki page:
Configuration · M0diis/SimpleBombs Wiki (github.com)

config-reloaded: '&aReloaded the config!'
explosion-message: '&aYou have set a tier %tier% prison bomb off!'
no-permission-command: '&aYou do not have the right permission for this command.'
no-permission-bomb: '&aYou do not have the right permission for this bomb.'
bomb-received: '&aYou have received a tier &2%tier% &aprison bomb (x%amount%).'
invalid-player: '&aPlayer was not found.'
invalid-bomb-id: '&aThis bomb ID is not valid.'
usage: |
  &a /bomb give <player> <bombID> [amount] &8- &7give a player a bomb.
  &a /bomb reload &8- &7reload the config.
bombs:
  1: # ID
    name: '&aBomb &f&l1'
    material: FIRE_CHARGE
    glowing: true
    lore:
      - '&cRight click this to throw it!'
      - '&aThis bomb has radius of &2%radius%&a blocks.'
    # Additionally, you can use these placeholders:
    # %radius% - The radius of the bomb.
    # %amount% - The amount of the bomb.
    # %fortune% - The fortune level of the bomb.
    # %damage% - The damage of the bomb.
    fortune: 1 # How many times the drops will be doubled. (1 = normal, 2 = double, 3 = triple, etc.)
    radius: 3 # Item drops increases by 2.5 for every broken block.
    permission: 'simplebombs.tier.1' # Without this permission, the player won't be able to use this bomb.
    detonation-time: 1 # Time before detonation.
    detonation-text: '&c&l! %time%' # What will be shown above the bomb before it explodes.
    throw-strength: 1.5
    effect: 'EXPLOSION_LARGE' # Particle list: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html
    sound: # Sound list: https://www.digminecraft.com/lists/sound_list_pc.php
      throw: 'ENTITY_ARROW_SHOOT'
      explode: 'ENTITY_GENERIC_EXPLODE'
    destroy-liquids: true
    smelt: 
      enable: true
      whitelist: true
      blocks: 
      - 'IRON_ORE'
    entity-damage: 0 # Hearts of damage.
    destroy:
      # If true, only items in the whitelist will be destroyed.
      # If false, all items NOT in the list will be destroyed.
      whitelist: true
      blocks:
        - 'STONE'
        - 'COBBLESTONE'
  2:
    name: '&aBomb &f&l2'
    material: FIRE_CHARGE
    glowing: true
    lore:
      - '&cRight click this to throw it.'
    fortune: 2
    radius: 2
    permission: 'simplebombs.tier.2'
    detonation-time: 2
    detonation-text: '&c&l! %time%'
    throw-strength: 2
    effect: 'EXPLOSION_LARGE'
    sound: 
      throw: 'ENTITY_ARROW_SHOOT'
      explode: 'ENTITY_GENERIC_EXPLODE'
    destroy-liquids: true
    smelt: 
      enable: true
      whitelist: true
      blocks: 
      - 'IRON_ORE'
    entity-damage: 0
    custom:
      explosion-type: 'SCATTER' # Scatter will spread the explosion in a circle.
      bomb-type: 3 # The bomb type that will be used.
      amount: 3 # The amount of bomb-type bombs that will spawn.
  3:
    name: '&aScatter Bomb &f&l2'
    material: FIRE_CHARGE
    glowing: true
    lore:
      - '&cRight click this to throw it.'
    fortune: 1
    radius: 2
    permission: 'simplebombs.tier.3'
    detonation-time: 2
    detonation-text: '&c&l! %time%'
    throw-strength: 1
    effect: 'EXPLOSION_LARGE'
    sound: 
      throw: 'ENTITY_ARROW_SHOOT'
      explode: 'ENTITY_GENERIC_EXPLODE'
    destroy-liquids: true
    smelt: 
      enable: true
      whitelist: true
      blocks: 
      - 'IRON_ORE'
    entity-damage: 1

_________________________________________________

# API

For more detailed explanation, visit Github wiki page:
API · M0diis/SimpleBombs Wiki (github.com)

There are currently two events that are fired upon certain actions.

BombExplodeEvent
Event is called when bomb explodes.

// Cancellable
@EventHandler
public void onBombExplodeEvent(BombExplodeEvent event)
{
    Bomb bomb = event.getEventJob(); // You can get the bomb properties from the Bomb class.
    Player player = event.getPlayer(); // Player who threw the bomb.
    Location loc = event.getExplodeLoc(); // The location where bomb exploded.
}

BombThrowEvent
Event is called when player throws a bomb.

// Cancellable
@EventHandler
public void onBombThrowEvent(BombThrowEvent event)
{
    Bomb bomb = event.getEventJob(); // You can get the bomb properties from the Bomb class.
    Player player = event.getPlayer(); // Player who threw the bomb.
    ItemStack item = event.getItem(); // The item representation of the bomb.
}

_________________________________________________

# MY OTHER PLUGINS

• CoreCord - CoreProtect integration for Discord.
• ExtraEnchants - Simple additional enchantments for your server.
• AntiAnvilRename - Prevent players from renaming certain items using anvils.
• VenturaCalendar - In-game calendar with customizable events and much more.
• OnlinePlayersGUI - Online players in a GUI. Filter by conditions, placeholders.

Resources from M0dii - all plugins.
_________________________________________________

Please leave a positive review if the plugin works as intended, if you have an issue contact me on discord provided or open an issue on github.

Buy me some coffee: