NoBlockCreeperPlugin

NoBlockCreeperPlugin is a Minecraft plugin designed for Bukkit servers that prevents Creeper explosions from damaging blocks, while still allowing the explosion effects to occur. This is perfect for servers that want to maintain the visual impact of Creepers without worrying about griefing or world destruction caused by their explosions.

---

Features

• Prevent Block Destruction:

  • Disables the destruction of blocks by Creeper explosions in all worlds, ensuring that your world remains safe from unintended damage.

• Visual Explosion Effect:

  • Optionally shows the visual explosion effect (without damaging blocks), so players still see the explosion's flash and animation.

• Configurable Explosion Power:

  • Adjust the power of the visual explosion (the size of the effect), making it customizable based on server performance or aesthetic preferences.

• Toggleable Grief Prevention:

  • You can toggle the behavior on and off in-game using a command or directly from the configuration file (config.yml).

• Supports All Worlds:

  • Prevents Creeper explosions in all worlds without requiring additional configuration for each world. No extra setup needed!

---

Installation

1. Download the .jar file.
2. Place the .jar file in the plugins/ folder of your Paper server.
3. Restart the server to generate the plugin’s configuration file (config.yml).

---

Configuration (config.yml)

The behavior of NoBlockCreeperPlugin can be fully customized using the config.yml file located in your plugin directory. The available configuration options are:

# NoBlockCreeper Plugin Configuration
# Configure the plugin to adjust creeper explosion behavior.

# Enable or disable the visual explosion effect (true/false).
visualEffect: true  # Set to false to disable the visual explosion effect

# The power of the explosion effect (from 0.0 to 100.0).
# Higher values make the explosion effect bigger.
explosionPower: 4.0  # Adjust to fit your preference (e.g., 0.0 for no visual effect)

# Prevent creeper explosions from destroying blocks (true/false).
# If set to true, creeper explosions will not damage or destroy blocks.
preventCreeperExplosions: true  # Set to true to prevent block destruction by creepers

Options Explained

• visualEffect: When set to true, this option enables a visual explosion effect when a Creeper explodes, even though no blocks will be destroyed. If set to false, no visual explosion will be shown.

• explosionPower: Controls the size and intensity of the visual explosion effect. A value between 0.0 and 100.0 can be set to control how large or small the visual effect should be.

  • 0.0 means no visual effect at all.
  • Higher values will increase the size of the visual explosion, simulating a more powerful blast.

• preventCreeperExplosions: When set to true, this option ensures that Creeper explosions will not destroy or alter blocks in the world. If set to false, Creeper explosions will behave as usual and damage blocks.

---

Commands

The plugin also supports a command to toggle the prevention of Creeper block damage in-game:

Command: /togglecreepergrief

Toggles the prevention of block destruction by Creepers.

• Usage: /togglecreepergrief
• Permissions: By default, this command is available to operators (op), but can be restricted using permissions if needed.

Command Behavior:

• When executed, this command toggles the behavior of Creeper explosions:
  • If preventCreeperExplosions is enabled, the command will disable the feature (allowing Creeper explosions to destroy blocks).
  • If preventCreeperExplosions is disabled, the command will enable the feature (preventing Creeper explosions from destroying blocks).
• The configuration is updated immediately, and a message will notify the player whether the feature is now enabled or disabled.

---

Permissions

You can manage who has access to the /togglecreepergrief command using permissions.

permissions:
  # Allows players to toggle Creeper grief prevention.
  noBlockCreeper.toggle:
    description: Grants access to toggle the prevention of creeper block destruction.
    default: op  # By default, only operators can toggle this setting

• noBlockCreeper.toggle: Grants access to the /togglecreepergrief command to toggle the block destruction prevention.
  • Default: The permission is granted to operators (op) by default. You can modify the permission settings in your server’s permissions manager.

---

Usage Example

1. Once the plugin is installed, type /togglecreepergrief in the game chat.
2. The plugin will toggle the prevention of Creeper block destruction:
   • Enabled: Creeper explosions won't destroy any blocks.
   • Disabled: Creeper explosions will behave normally and damage blocks.
3. A message will confirm whether the feature is enabled or disabled.

---

Support

If you encounter any issues with the plugin or need further customization, feel free to reach out for support or check the plugin's documentation for updates and changes.

---

Enjoy your grief-free Creeper explosions with NoBlockCreeperPlugin!