SimpleBombs [1.13 - 1.20.1] icon

SimpleBombs [1.13 - 1.20.1] -----

Simple, configurable and easy to use bombs for prison and other various types of servers.



[​IMG]
[​IMG]



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)

Code (YAML):

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.

Code (Java):
// 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.
Code (Java):
// 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:

[​IMG]
Resource Information
Author:
----------
Total Downloads: 1,226
First Release: Mar 10, 2022
Last Update: Aug 4, 2023
Category: ---------------
All-Time Rating:
4 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings