Tool Guard icon

Tool Guard -----

Plugin that notifies when a tool or armor is about to break



1.png

A review of the resource is appreciated :)

This is my first plugin named ToolGuard this plugin provides a notification system for tools and weapons (and any item that has durability and can be equipped by the user), alerting players about the durability status of their items.

3.png

If you use this plugin and want to put your server here, join our discord and notify us.
2.png
Durability Monitoring:

Sends notifications to players when the durability of their tools and weapons falls below a defined threshold.
Custom Settings:

Administrators can define which tools are monitored and set specific notification thresholds in the configuration file.

Notification Messages:

Alert messages are customized to include the object name and percentage of durability remaining.

Notification Sounds:

Ability to play a specific sound when a durability notification is sent (configurable in the configuration file).


Code (Text):
#############################
#
#████████╗░█████╗░░█████╗░██╗░░░░░░██████╗░██╗░░░██╗░█████╗░██████╗░██████╗░
#╚══██╔══╝██╔══██╗██╔══██╗██║░░░░░██╔════╝░██║░░░██║██╔══██╗██╔══██╗██╔══██╗
#░░░██║░░░██║░░██║██║░░██║██║░░░░░██║░░██╗░██║░░░██║███████║██████╔╝██║░░██║
#░░░██║░░░██║░░██║██║░░██║██║░░░░░██║░░╚██╗██║░░░██║██╔══██║██╔══██╗██║░░██║
#░░░██║░░░╚█████╔╝╚█████╔╝███████╗╚██████╔╝╚██████╔╝██║░░██║██║░░██║██████╔╝
#░░░╚═╝░░░░╚════╝░░╚════╝░╚══════╝░╚═════╝░░╚═════╝░╚═╝░░╚═╝╚═╝░░╚═╝╚═════╝░
# Author: zcrys
# Support: https://discord.gg/RSUCmCfeyc
#
# #############################

# Notification message that will be shown in the chat when a tool is about to break.
# You can use the following variables:
#   %item% - Will be replaced by the name of the tool.
#   %percentage% - Will be replaced by the remaining durability percentage of the tool.
# Example: If you have a diamond shovel with 10% durability left, the message will be:
# [ToolGuard] Your Diamond Shovel is at 10% durability.
Notification: "&7[&bToolGuard&7] &cYour %item% is at %percentage%% durability!"
# How often (SECONDS) will the notification be sent to the user?
cooldown: 60  # Seconds

# Sound that will play when the tool is near breaking.
# Possible values: Names of Minecraft sounds, for example "LEVEL_UP" (for 1.8) or "ENTITY_PLAYER_LEVELUP" (for newer versions).
# If you use a version newer than 1.8, be sure to use the appropriate sound names.
# You can find Minecraft sound names here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
sound: "LEVEL_UP"

# Volume of the sound that will play when the notification is triggered. The value should be between 0.0 (silent) and 1.0 (max volume).
# Default value: 1.0
sound_volume: 1.0

# Pitch of the sound that will play when the notification is triggered. The value should be between 0.5 (low pitch) and 2.0 (high pitch).
# Default value: 1.0
sound_pitch: 1.0

# Enable or disable the notification sound.
# true - A sound will play when the tool is near breaking.
# false - The sound will be disabled; only the notification message will be sent without sound.
sound_enabled: true

# Section of messages that will be displayed in the chat or console.
messages:
  # This message is shown when the plugin configuration has been successfully reloaded.
  reload_success: "&7[&bToolGuard&7] &aConfiguration successfully reloaded."
 
  # This message is shown when a player tries to use the /toolguardreload command without the necessary permissions.
  permission_reload: "&cYou do not have permission to run this command."
 
  # This message is shown if the material specified in the configuration is invalid or unsupported.
  invalid_material: "&cThe material %material% is not valid or is unsupported."

# Tool configuration: Here you can define the remaining durability percentage at which
# the notification will be sent. You can also enable or disable notifications for each individual tool.
# The 'notification_threshold' key represents the remaining durability percentage.
# If the tool's durability falls below this value, a notification will be sent.

# 1.21.1 Materials https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
# 1.8 Materials https://www.minecraftinfo.com/idnamelist
tools:
  # Example configuration for a Diamond Pickaxe:
  DIAMOND_PICKAXE:
    enabled: true  # true means notifications are enabled for this item. false disables them.
    notification_threshold: 20.0
    console: "fly %player%"    # Notification when durability falls below 20%.

  # Example configuration for an Iron Pickaxe:
  IRON_PICKAXE:
    enabled: true
    notification_threshold: 15.0  # Notification when durability falls below 15%.
    console: "give %player% diamond"

  # You can add more tools here. Make sure the name matches the exact Minecraft material names.
  # Example:
  # GOLDEN_AXE:
  #   enabled: true
  #   notification_threshold: 30.0  # Notification when durability falls below 30%.

  # Valid material names (some examples): DIAMOND_PICKAXE, IRON_SHOVEL, GOLDEN_AXE, WOODEN_SWORD.
  # If you are using a newer version, make sure the material names match your specific version of Minecraft.
 
Commands:
/toolguardreload

Do you have any ideas for implementing the plugin?
comment it by discord


VIDEO EXAMPLE








It is very simple to configure this plugin so you don't need much information (everything you need to know is in the configuration file).

4.png
https://discord.gg/RSUCmCfeyc
If you have any problem with the plugin or find any bug you can report it on my discord server (I will attend you myself).
Resource Information
Author:
----------
Total Downloads: 59
First Release: Sep 24, 2024
Last Update: Sep 24, 2024
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings