ZUtils

This is a plugin meant for server administrators and owners, who seek a plugin that will store warnings, show the ping of a player in milliseconds, deal damage as a punishment through a command and the ability to clear chat!

Please note that this plugin has not been tested on any version prior to 1.12! If the plugin does work on any of the older versions, I would love to hear from you!

Dependencies:
You need Essentials installed in order to run this plugin!

Features:
The main features, which are listed bellow in italics, can be toggled in the config.
The features will be shown in screenshots at the end of this post

Screenshots

• Warnings!
  • The warnings will be stored in a file under the UUID of the player warned. This makes it so that you can view the warnings of a player, even if they were to change their in-game name!
  • Warnings can be removed using a command, this goes for all warnings or player specific warnings
  • Warnings will also be removed from a player by banning the player from the server! This works with essentials tempban and ban command.
  • Warnings are saved as strings which are the reason given by the staff member warning a player, these can later be viewed by staff members.
  • If a player recieves x amount of warnings, they will be kicked from the server with their warning as the reason. This can be configured in the config!
• Damage!
  • You can deal damage, as a punishment, to a player using a command.
• Ping!
  • You can get your own ping or the ping of another user. This will be shown in milliseconds.
• ChatClear!
  • You can have the chat cleared by using a command! You can define the amount of lines to insert, using the config!
• Clickable Commands!

Commands:

Optional arguments: []
Required arguments: <>

• /zutils : Shows the version of the plugin.
• /zutils help : Shows the help menu of the plugin.
• /zutils reload : Reloads the warning- and config file.
• /warn <player> <reason> : Logs a warning for a player and lets that player know they've been warned.
• /getwarnings <player> : Shows the amount of warnings a player has, '-r' can be added at the end to show reasons.
• /removewarning <player> [ID] : removes a specific, or the latest warning from a player.
• /clearallwarnings <player | allwarningslogged> : clears ALL warnings for a player, or every warning ever logged.
• /getping [player] : Shows the ping of a player or yourself, in ms.
• /damage <player> [amount] : Deals damage to a player.
• /clearchat : Sends 300 blank lines into chat which clears the chat completely. The amount of blank lines can be changed in the config.
• /preventplace <deny | allow> <player> [world] : Allows or denies a player their build permission in a world.

Permissions:

• zutils.dodamage : Allows the user to do damage to a player with a command
• zutils.doping : Allows the user to display their current ping to the server
  
• zutils.doping.others : Allows the user to diplay the ping of another player
  
• zutils.zwarn.* : Grants the user every ZWarn permission
  
• zutils.zwarn.givewarning : Allows the user to warn a player
  
• zutils.zwarn.clearwarningsall : Allows the user to clear all warnings
  
• zutils.zwarn.removewarning : Allows the user to remove a warning from a player
  
• zutils.zwarn.getwarnings : Allows the user to display warnings of a player
  
• zutils.clearchat.bypass : Allows the user to bypass a chatclear
  
• zutils.clearchat.clear : Allows the user to clear the chat
  
• zutils.admin : Allows the user to access every command
• zutils.preventplace : Allows the user to prevent other players from breaking or placing any block.
• zutils.preventplace.bypass : Allows the user to bypass the build restrictions

#Config file for ZUtils.
#If you think that this file needs anything please contact me through discord @ https://discord.gg/Puetces

######Modules######
ZWarn: true
Damage: false
Getping: true
ChatClear: false
fakeop: true
preventplace: true


######ZWARN######

merge-zwarn-permissions: true
#If this is set to true, the permission 'zutils.zwarn.givewarning'
#will give permission to the following commands:
#  /getwarnings <player>
#    Default permission: 'zutils.zwarn.getwarnings'
#  /removewarning <player>
#    Default permission: 'zutils.zwarn.removewarning'
#  /warn <player> <reason>
#    Default permission: 'zutils.zwarn.givewarning'

autokick-user: false
#Auto kick user after x amount of warnings
autokick-warning-limit: 15
#The amount of warnings a player needs before being kicked


######CHATCLEAR######

lines-to-send: 300
#The amount of lines the player will send to the player!
clear-for-staff: false
#Should the plugin clear chat for staff?
log-clears: true
#Should the plugin log the chat clear?

######BLOCKPREVENTION######

worlds:
#If more worlds are needed, just add to the list
#Names of the world category can be changed as well
  redstoneworld: world
  factions: world