💣 ProBombs – Advanced Bombs v2.0

ProBombs is the most advanced explosives plugin ever created for Spigot. It completely replaces standard TNT mechanics with a modular, competitive framework designed for Factions, Prison, Survival, and Roleplay.

Every feature is built for performance, with lag-free timers, crash-safe data persistence, and deep integration with modern server standards.

💣 1. The Explosives Engine

Create unlimited custom bomb types with unique behaviors.

Types & Triggers

• ⏱️ Timed Charges: Tick-rate independent timers that stay accurate even during server lag.
• 📡 Remote Detonation: Detonate specific bombs using a linked Remote Detonator (encrypted by UUID).
• 👁️ Proximity Mines: Trigger when enemies enter the radius (can be configured to ignore the owner).
• 🔴 Tripwires: Project invisible laser beams up to 16 blocks; crossing the beam triggers the bomb.
• ⛏️ Mining Charges: Specialized bombs for Prison servers (see below).
• 🎭 Fake Bombs: Create "dud" bombs that play a sound or reveal a troll message instead of exploding.

Advanced Explosion Logic

• Chain Reactions: Explosions can propagate to nearby bombs with a configurable delay.
• Shrapnel System: Bombs can launch physical projectiles (Arrows, Fireballs) on detonation.
• Debuff Effects: Apply any Potion Effect (Blindness, Wither, Levitation) to victims.
• Directional Placement: Custom heads support realistic 16-point rotation on placement.

🔥 Smart Holograms

Real-time visual feedback floating above every bomb.

• Visual Timer Bars: Dynamic progress bars (e.g., ████░░░░) that change color (Green->Yellow->Red) as they deplete.
• Status Indicators: Text blinks "RIGHT CLICK TO ARM" when idle, and switches to "ARMED" when active.
• Stealth Integration: Hacked Jammers can "mask" holograms, hiding the timer from defenders.

⚒️ 2. Mining & Prison System

Turn explosions into a grinding mechanic.

• Auto-Smelt & Fortune: Fully respects vanilla enchantment logic on the tool used to place the bomb.
• Custom Loot Tables: Define drops with exact chances (e.g., 0.001% for a Rare Key).
• Junk Filter: Automatically delete useless blocks (Cobblestone, Diorite) to keep inventories clean.
• Source Limits: Loot that drops only from specific source blocks (e.g., Emeralds only from Deepslate).
• Custom Item Support: Drops can be Oraxen, ItemsAdder, or Nexo items, with full texture support.

🏗️ 3. Block Regeneration (Crash-Safe)

Allow explosions in safe zones without permanent damage.

• Smart Restoration: Blocks regenerate over time with visual particles and sounds.
• Container Support: Chests, Barrels, and Shulkers are restored with their contents intact.
• Anti-Dupe: Automatically clears dropped items in the regen zone to prevent duplication exploits.
• Persistence: Active regeneration zones are saved to disk (regen_zones.yml), so they continue restoring even after a server crash/restart.
• Matryoshka Logic: Hierarchy checks (Global -> World -> Region -> Bomb Config) for maximum control.

📡 4. Electronic Warfare (Jammers & Hacking)

A tactical layer for Factions and Base Defense.

• Signal Jammers: Placeable blocks that create an interference field.
  • Jam Remote Signals: Attackers cannot use detonators inside the radius.
  • Disable Sensors: Proximity Mines and Tripwires fail to trigger.
  • Slow Down Timers: Bomb timers can run up to 90% slower inside a Jammer field.
• Hacking Tablet: A tool to bypass Jammer security.
• Grid Decryption: A visual puzzle minigame required to disable a Jammer.

✂️ 5. Interactive Defusal

Defusing is a skill.

• Wire Cutting: Cut the correct wire color to disarm (cutting the wrong one = instant boom).
• Code Sequence: Memorize and repeat a randomized color pattern.
• Defusal Kits: Configure tools with different success rates and tech levels.
• Failure Actions: Explode, speed up timer, or applying penalties on fail.

🛠️ 6. Administration & Config

Forget config files. Manage everything in-game with professional-grade tools.

🖥️ Admin Dashboard (/bombs admin)

A centralized control panel for server owners details.

• Real-Time Stats: View "Active Bombs" in real-time.
• Quick Reload: Instantly reload configurations without server restart.
• One-Click Management: Access Settings, Recipes, and Component lists instantly.

✨ In-Game Bomb Editor

Create new bomb types from scratch without touching bombs.yml.

• Live Preview: See exactly what your bomb item looks like as you edit it.
• Session-Based: Edits are saved in a temporary session until you click "Save & Apply".
• Comprehensive Control: Edit Name, Lore, Fuse Time, Explosion Power, Particles, Sounds, and Custom Custom Model Data.

🎨 Visual Recipe Editor

• Drag-and-Drop: Simply drag items from your inventory into the 3x3 grid to define the recipe.
• Smart Detection: automatically detects if you dropped an ItemsAdder, Oraxen, or Nexo item and saves specific ID.
• Instant Toggle: Enable/Disable recipe with a single click.

🛠️ Other config features

• Localization: 100% translatable via messages.yml.
• NBT Security: All items use NBT tags (PersistentDataContainer) to prevent players from renaming plain items to create fake bombs.

🔌 7. Integrations

• 🛡️ WorldGuard

  
  

  Control exactly where bombs can be used. ProBombs respects standard WorldGuard flags:

  • TNT & OTHER_EXPLOSION: If denied, bombs will not explode (or will fail safely).
  • BUILD: If denied, players cannot place bombs.
  • BLOCK_BREAK: Controls whether explosions destroy blocks.
  • Bypass Rule: You can define a list of allowed-regions in config.yml to force-allow bombs in specific arenas, overriding the global flags.

  📦 Custom Items (Oraxen / ItemsAdder / Nexo)

  
  

  Native support for custom textures and models without any extra config.

  • Usage: Use the format PLUGIN:item_id in any drop table or recipe.
  • Examples:
    • ITEMSADDER:my_namespace:ruby_sword
    • ORAXEN:obsidian_shard
    • NEXO:explosive_compound

  📊 PlaceholderAPI

  
  

  Display real-time statistics in logic, scoreboards, or chat.

  • %probombs_active_bombs%: Total active bombs on the server.
  • %probombs_player_bombs%: Bombs placed by the viewer.
  • %probombs_jammers_active%: Total active signal jammers.
  • %probombs_jammer_nearest_distance%: Distance to the closest Jammer (perfect for HUDs).
  • %probombs_jammer_nearest_tier%: Tier level of the closest Jammer.

  🔑 LuckPerms

  
  

  Granular permission nodes for every action (see list below).

  
  

💻 Developer API

ProBombs offers a powerful API for developers to hook into the explosives system.

Methods (ProBombs.getApi())

Events (com.kaosbit.proBombs.api.events)

🔐 Permissions Reference

Granular control over every feature.

Basic Permissions

Admin Permissions

Specific Permissions

• probombs.bomb.<id>: Allow using a specific bomb ID (e.g., probombs.bomb.c4_standard).
• probombs.tool.<id>: Allow using a specific tool ID.