Koolsource presents: Grief & Cheat Detector -- Version 0.1

Koolsource Grief and Cheat Detector is a plugin that aims to make server management easier by automatically detecting suspicious activity that might indicate cheating or griefing activity and generating a report. The plugin includes a 'report' feature that allows users to issue a 'grief report' when they have been griefed. Players with permissions can then teleport to the location of these automatically and manually generated reports.

Description continues (long version):

This plugin was built out of the experience of admins on our minecraft server who were looking to automate their activities that lead to the catching of cheaters and griefers where possible. One such activity was following the mining behaviour of players to see if players are mining a suspicious amount of valuable ores quickly (particularly if they are doing so in the dark.) Another more obvious 'activity' is monitoring the chat for suspicious behaviour. The plugin is capable of scanning chat messages for key phrases that might indicate players are 'conspiring' to grief, or bragging about their hacks. We have found this to be particularly useful on our server for detecting people talking about griefing, or even having been griefed.

The most obvious source of detecting griefing is from our players themselves. As such, we have included a /report command that allows players to report griefing. All grief and cheat report locations, automated or otherwise, can be teleported to using the appropriate command.


This is our first version of the plugin, and we are looking for suggestions for other ways to detect griefing or cheating.

Alert admins and store logs of chat messages containing key phrases such as 'i can see through walls' (we have provided a 'default' list of phrases, this keyword/key phrase list can be modified at will) Detects suspicious mining of valuable ores (especially in the dark), stores a log and alerts staff with permissions. Ability to teleport to grief and cheat sites. Players can create reports when they have been griefed. (Stores their location for teleporting to)


A mySQL database. This is required to store grief and cheat reports. Future versions may support SQLite Permissions 3 (if not installed, plugin will default to allowing Ops use of the /show(grief/cheat), /tp(grief/cheat) and /del(cheat/grief) commands. All users will be able to use the /report command.

Configuration File

Quote from Configuration File:

The initial run of the plugin will generate a 'GriefDetector' folder in the 'plugins' folder (if it does not exist.) The plugin will then disable itself to allow the user to add the essential SQL configuration options before running itself again.

SQL Settings:

Input the appropriate SQL values for the SQL username, password, database name and hostname. The plugin will use this database to store grief and cheat reports.

Mining Detection Settings:

Please read: The default settings (examples) can produce a high amount of false-positives on busy servers (eg. sometimes a high amount of valuble ore can be found in a cave in a very short time period), you should tinker with these settings as you see fit, and add as many extra detection rules as you like (for instance, a rule for diamond per 5 minutes [short burst], and another for diamond over an hour). Also, there's nothing stopping you from using a value other than an ore.

The 'mine detection exempt' section allows you to specify world names that the plugin should ignore how much players mine on (such as on creative worlds.) The default configuration file has examples of how to specify which ores the plugin should report suspicious activity for in the 'MINE_LIMITS' and 'MINE_IN_DARK_LIMITS' sections. These may be removed, or altered. 'MINE_LIMITS' concerns mining in any light level, 'MINE_IN_DARK_LIMITS' concerns only those ores mined in absolute darkness (a light level of 0).

'item_id'specifies an ID of an ore to watch for players mining suspicious amounts on. The appopriate value can be found in the 'Dec' column on this webpage:

'amount' specifies how many ores the player should be allowed to mine in the time-frame specified in 'time' before a report is issued, viewable via the /showcheats command.

'time'specifies the time-frame for the amount of ore to be mined. More specifically, after how many minutes the count of the amount of ores of this type should be reset for the player. This value must be greater than 0.

Report Time Limit:

  • Throttles the amount of /report commands can be issued by players to the amount of seconds specified. Default is 1 /report command every 30 seconds.


'/report [message]' - This will create a grief report providing the message entered, along with the player's coordinates at the time of using command (which can be teleported to via the /tpg(rief) command

'/showgriefs [page no.]' (alias: /sg) - Will show a list of automatically generated grief reports, and manually generated reports (using /report) ordered by newest first. A page number can be provided optionally, eg. "/sg 3" would show page 3 of the grief reports.

'/showcheats [page no.]' (alias: /sc) - Will show a list of automatically generated Cheat reports. A page number can be provided optionally, eg. "/sc 4" would show page 4 of the cheat reports.

From the results of /showcheats and /showgriefs, each report begins with an ID number which can be used in the following commands:

'/delgrief [id number]' (alias: /delg) - Removes the report specified in "id number" permanently

'/delcheat [id number]' (alias: /delc) - Removes the report specified in "id number" permanently

'/tpgrief [id number]' (alias: /tpg) - Teleports the the world and coordinates of the grief report specified in "id number"

'/tpcheat [id number]' (alias: /tpc) - Teleports the the world and coordinates of the cheat report specified in "id number"

Keyword Files

The initial run of the plugin generates cheats.txt and griefs.txt in the plugins/GriefDetector folder. These may be modified, so long as each phrase is entered on a new line. Note: These files should not be opened in notepad, which messes up the formatting of the file. For windows users, we recommend wordpad.

Permissions Configuration

Note: This plugin uses Permissions 3. If this plugin is not installed, it will default to operator only.



Future Work

Detecting a player that, for example, breaks considerably more glass than they have placed Flood detection and automatic banning on flood Detection of speed hacks Separate command for showing grief/cheat related chat messages that were caught

Contact Us

IRC: server: channel: #koolsource Website : E-mail: [email protected]

Created by Koolsource

Happy0 ( )
Brad ( )

with some help from:
paperbackdragon ( )

Design input:
John ( )
Deano ( )

Change Log:



  • To post a comment, please or register a new account.
Posts Quoted:
Clear All Quotes

About This Project

  • Project ID
  • Created
    Sep 11, 2011
  • Last Released File
    Feb 11, 2012
  • Total Downloads
  • License



Recent Files