BONK icon

BONK -----

A fun plugin that lets you send mobs and players flying with a satisfying BONK!

Download Now
6.7 KB .jar


BONK
[​IMG] [​IMG]
[​IMG] [​IMG]​

A simple Spigot 1.20+ plugin that provides a unique item, the BONK, which knocks back entities and optionally deals configurable damage. The BONK is designed for server administrators or players with special permissions to push mobs, players, or animals around in a fun and efficient way.

[​IMG] Features [​IMG] ​
  • Unique Bonk Item: Only the specially created Bonk Item can knock back entities.
  • Custom Knockback Strength: Configurable in config.yml.
  • Custom Damage: Set damage amount (including zero damage) in config.yml.
  • Item Type Customization: Change the default Bonk item to any item type you prefer.
  • Permission Protected: Only players with the correct permission can obtain the Bonk Item.
[​IMG] Why use BONK? [​IMG] ​
The BONK plugin is perfect for situations where:​

  • You need to discipline or manage players.​
  • Mobs are becoming a nuisance.​
  • You want to herd animals back into pens.​
  • You want to have fun and lightly push things around without dealing excessive damage.​

[​IMG] Installation [​IMG] ​
  • Download the .jar file from the releases section or build it from the source code.
  • Place the .jar file in your server's plugins folder.
  • Start or reload your server.
  • A config.yml file will be automatically generated. Adjust the settings as needed.
  • Reload the plugin with /bonk reload.
[​IMG] Configuration [​IMG]
The config.yml file allows you to modify the Bonk Stick's behavior and change the in-game messages:
​
Code (Text):

general:
  Name: "BONK"
  Lore: "Not a normal stick"
  bonk-item: "STICK" # Valid values: Any material name from the Material enum in Spigot
  knockback-strength: 1.0 # Strength of knockback (default: 1.0)
  damage: 0.0 # Amount of damage (default: 0.0)

messages:
  notplayer: "This command can only be used by players."
  nopermission: "You do not have permission to use this command."
  bonkreceive: "You have received the Bonk Stick!"
  reload: "BONK plugin configuration reloaded successfully!"
 
​


[​IMG] Commands [​IMG] ​
  • /bonk: Gives the player the unique Bonk Stick. Requires the bonk.get permission.
  • bonk reload: Reloads the plugin's config.
[​IMG] Permissions [​IMG] ​
  • bonk.get: Allows a player to use the /bonk command to receive the Bonk Item. By default, only operators (op) have this permission.
  • bonk.reload: Allows reloading of the BONK plugin configuration.
[​IMG] Usage [​IMG] ​
  • Use the /bonk command to receive the Bonk Stick.
  • Right-click or left-click an entity (e.g., mob, player, or animal) to knock it back with the configured strength.
  • The configured damage will also be applied (if set in the config).

[​IMG] Planned Features [​IMG] ​
  • Optional visual effects when using the BONK
  • Optional sound effect when using the BONK
  • Optional custom texture for the BONK
​

[​IMG] Contributing [​IMG]
Feel free to open issues, fork the plugin repository, and submit pull requests for any improvements or bug fixes. Contributions are always welcome!​


[​IMG] License [​IMG]
This project is licensed under the MIT License - see the LICENSE file for details.​
View on SpigotMC
Resource Information
Author:
----------
Total Downloads: 43
First Release: Sep 24, 2024
Last Update: Sep 24, 2024
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings
Ask Questions / Get Support