[ADMN] GriefDetector v0.2 - Automatically Generated reports about suspicious activity [1060]

Discussion in 'Inactive/Unsupported Plugins' started by KoolSource, Sep 10, 2011.

  1. Offline


    Koolsource presents: Grief & Cheat Detector
    Version 0.2


    BukkitDev page: http://dev.bukkit.org/server-mods/grief-cheat-detector/

    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):
    Show Spoiler

    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 publicly released 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)

    • 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.


    Please read through the configuration and usage information below this section before installing our plugin.

    [ Download link ]

    Show Spoiler

    The initial run of the plugin will generate a 'GriefDetector' folder in the 'plugins' folder (if it does not exist.)

    If you prefer

    SQL Settings:

    The plugin will use a database to store grief and cheat reports.
    • The plugin will default to using SQLite on the first run: this SQLite database will be stored in the plugins/GriefDetector folder as database.db.
    • If you wish to use MySQL instead, set the 'Use-SQLite' to 'no' then Input the appropriate SQL values for the SQL username, password, database name and hostname.
    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: http://www.minecraftwiki.net/wiki/Data_values#Block_IDs_.28Minecraft_Beta.29.

    '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.


    Show Spoiler

    # KoolSource Grief & Cheat Detector
    # Please visit http://www.koolsource.com for more plugin releases, and gaming and web design related services.

    - worldGoesHere
    - otherWorldGoesHere
    Use-SQLite: 'yes'
    sql-username: 'your sql username (only if Use-SQLite: ''no'')'
    sql-db-name: 'your sql database (only if Use-SQLite: ''no'')'
    sql-hostname: 'your sql host name (only if Use-SQLite: ''no'')'
    sql-password: 'your sql password (only if Use-SQLite: ''no'')'
    - item_id: 56
    amount: 12
    time_frame: 30
    - item_id: 14
    amount: 12
    time_frame: 30
    - item_id: 56
    amount: 4
    time_frame: 1
    - item_id: 14
    amount: 10
    time_frame: 5
    - item_id: 15
    amount: 6
    time_frame: 1
    report-time-limit: 30

    • /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 to the world and coordinates of the grief report specified in "id number"
    • /tpcheat [id number] (alias: /tpc) - Teleports to the world and coordinates of the cheat report specified in "id number"

    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.

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

    Show Spoiler








    • 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


    IRC: server: ircd.jcink.com channel: #koolsource
    Website : http://www.koolsource.com
    E-mail: [email protected]
    BukkitDev site: http://dev.bukkit.org/server-mods/grief-cheat-detector/

    Created by Koolsource
    Happy0 ( http://koolsource.com/user/54-happy0/ )
    Brad ( http://koolsource.com/user/6-brad/ )

    with some help from:
    paperbackdragon ( http://koolsource.com/user/122-paperbd/ )

    Design input:
    jchamb2010 ( http://koolsource.com/user/2-john/ )
    Deano ( http://koolsource.com/user/1-deano/ )

    Change Log:

    Version 0.2:
    • Added support for SQLite (previously only MySQL was supported.) The plugin defaults to using SQLite. Current users are encouraged to add the 'Use-SQLite' option to their config file. However, if they do not, the plugin will default to using the MySQL settings. Please refer to the 'Current Default Configuration' section to see how the 'Use-SQLite' option is formatted.
    efstajas and Th3Controller like this.
  2. Offline


    Nice Plugin
    KoolSource likes this.
  3. Offline


    Thanks for the feedback, BenyTheBuffy! As a developer, I am used to being met with silence with anything I publish, so it's nice to hear some feedback. If you have any suggestions, please let us know.

    - Happy0
  4. Offline


    Use the @BenyTheBuff tag if you want to get his attention. And as far as mySQL goes
    Show Spoiler


    Please for god's sake add SQLite or flat file storage.
  5. Offline


  6. Offline


    @captainawesome7 Thanks, I didn't realise you could address people like that. :)

    As far as MySQL goes, the rage face has spoken! We shall add an SQLite option has soon as we can. I should justify our use of MySQL though. Originally (a while ago), we were only developing the plugin for use on our server, and we were toying with the idea of getting an IRCBot to alert staff of new reports, too (as well as some website stuff) - which we did get working to an extent, but didn't pursue much further. I guess in all that madness, we forgot that, y'know... Not everyone should be forced to use MySQL. You're absolutely right.

    - Cheers for the feedback,
  7. Offline


    u should do something like if it was griefed u type /undogrief (Grief number) or something and the thing reported will be undone.
  8. Offline


    In average can this be used to replace x-ray detecting plugins and how much memory does this plugin take?
  9. Offline


    @Th3Controller :
    Our plugin can to a certain extent be used as a replacement for x-ray detecting plugins. However it does not make it impossible to use nor does it directly detect the use of any x-ray mod. Our plugin will let you know if someone is mining in the dark which is a major indicator of x-ray usage. The memory usage of this plugin is not exactly known but we will try to find out how much it uses.

  10. Offline


    Thank you for a quick reply, our server testers are now in my private server to test out the plugin and hoping this will be a good replacement for LogOres which I think is not even working.
    KoolSource likes this.
  11. Offline



    Show Spoiler

    SQLite support added! (it defaults to using SQLite too)

    - Happy0
  12. Offline


    Looks nice, when I put my server back up I'll probs add this plugin
    KoolSource likes this.
  13. Offline


    Does this work for 1.0.1? If not then please update this, I found many grief sites using this plugin on my 1.7 server.
  14. Offline


    We are actually using this on our 1.0.1 server right now and as far as i know there are no major bugs. If you find any though then please let us know and we will get them fixed ASAP.
  15. Offline


    It fails to load on my server :/
  16. Offline


    It's not working for me :(
  17. Offline


    This plugin hasn't been updated since Bukkit build #1060 (Minecraft ß1.7) which was released over two years ago.
    This plugin was phased out when another developer made a similar plugin that worked better than this one. I can't remember the name of the plugin off hand though.


Share This Page