MinersTNT v1

Showcase :

Screenshot :

The Miner’s TNT Plugin is a feature-rich Minecraft plugin designed to offer players a new and exciting way to mine specific materials quickly and efficiently while integrating with Vault for an economy system. Below is an overview of what the plugin does:

Key Features of the Miner's TNT Plugin:

1. Customized Explosive Block:

   • Introduces a new TNT variant called Miner's TNT.
   • Specifically targets and destroys only certain block types, such as:
     • Deepslate
     • Andesite
     • Granite
     • Gravel
     • Tuff
     • Stone
   • Leaves other block types unaffected, providing a controlled mining experience.

2. Vault Economy Integration:

   • Charges players an in-game currency (integrated with the Vault API) to purchase Miner's TNT.
   • Checks player balance before a transaction and deducts the appropriate cost.
   • Configurable pricing for Miner's TNT through the plugin's configuration.

3. Custom Miner's TNT Item:

   • A unique TNT item with a custom name and lore.
   • Comes with a glowing effect (fake enchantment) for quick identification in the player's inventory.

4. Explosion Radius and Height:

   • Configurable explosion parameters (radius and height) to allow server administrators precise control over the scale of Miner's TNT explosions.

5. Custom TNT Mechanics:

   • Tracks TNT placement, ignition, and detonation to differentiate Miner's TNT from regular TNT.
   • A seamless metadata-based tracking system ensures accurate identification of Miner's TNT blocks during their lifecycle.

6. User-Friendly Commands:

   • /minerstnt:
     • Allows players to purchase Miner's TNT if they have sufficient in-game currency.
     • Provides a helpful message about the successful purchase or lack of sufficient funds.
   • /minerstntreload:
     • Reloads the plugin's configuration without requiring a server restart.
     • Requires proper permissions (minerstnt.reload).

7. Smart Block Destruction Logic:

   • Implements an optimized block-checking algorithm to ensure only allowed blocks within the explosion radius and height are destroyed.
   • Prevents unnecessary environmental damage to sensitive areas on the server.

8. Failsafe Listener System:

   • Handles events such as block placement, TNT priming, explosion adjustments, and more.
   • Ensures that standard TNT mechanics are not interfered with while providing custom behavior for Miner's TNT.

9. Dynamic Configuration:

   • Automatic generation of a config.yml file.
   • Server admins can adjust values for key parameters like explosion radius, allowed block list, and the cost of buying Miner's TNT.

10. Comprehensive Logging:

    • Logs important actions and interactions (e.g., TNT ignition and explosion) to simplify debugging for server owners.
    • Differentiates between normal TNT and Miner's TNT events in the logs.

Technical Details:

• Economy Support:

  • Built-in support for the Vault economy system is required.
  • If Vault is not found on the server, the plugin disables itself for compatibility purposes.

• Compatibility:

  • Works seamlessly with all Minecraft blocks and entities while retaining a lightweight design.
  • Maintains standard server performance by executing efficient block and entity handling operations.

• Permission Handling:

  • Certain commands and features are gated behind permissions:
    • minerstnt.reload (Config reload command).

How It Enhances Gameplay:

This plugin is an excellent addition to Minecraft servers striving for enhanced gameplay mechanics. It enables efficient and controlled mining while amplifying the economy's role. Additionally, it minimizes environmental destruction by focusing on selected materials, making it suitable for survival, RPG, and mining-focused servers.