GriefLog
We are discussing plans for Sponge and GlowStone support. Please be patient :)
If you are using WorldEdit 6.0 or later please use the 5.2.2 version. If you are using WorldEdit 5.x.y please use version 5.2.3-worldedit, thank you.
Wiki | The GriefLog wiki is filled with information about GriefLog. We have some information below, but the wiki is much more descriptive. |
Download | Latest build that is approved by bukkit. |
Development Downloads | This build is not approved by bukkit, but it is the most recent, development build. If bukkit updates and GriefLog is not compatible, this is a good place to look for an update. |
GriefLog Source | You can find the latest GriefLog source code here at GitHub. However, if you would rather not just compile it, we recommend downloading the latest Dev Download. (Information Above) |
Permissions | You can use these permission nodes to allow other users to do certain things. |
Description
How many times has someone on your server told you that someone griefed there house, but they don't know who did it? Well, this is a great way to fix that. GriefLog will log every event that happens within your server. It will also separate the log files into worlds. So now you can prove that it was in fact a griefer. Now, you don't need to actually go into the log files, you can take out your GriefLog tool and left click on a block, it will bring up the information. You can also simply use a command to roll back the grief. More information is below.
Usage
So what exactly does GriefLog log? What can it do to help me? Well, GriefLog will log just about anything. It then saves it to a file called GriefLog.txt which can be found in "<YourServerDirectory>/logs/<world>/grieflog.txt." It is the same on every operating system. Here is a list of exactly GriefLog will log:
- When a player joins the server
- When a player breaks a block
- When a player places a block
- When a player uses a command
- When a player changes the world they are in (e.g. Entering the nether)
- When a player leaves the server
- If a player's game mode changes
- If a block is ignited
- If a bucket is emptied
- If an Enderman takes or places a block
- If a Zombie breaks down a door
- If there is any kind of explosion
All of this is logged to a very simple layout. You can choose a block with the GriefLog tool, Use the Search command, or look through the GriefLog.txt files.
Commands
We have many different commands to try and make the plugin as simple as possible to use.
- /glog - This will show you the version of GriefLog you are running.
- /glog tool - This will provide you with the GriefLog tool. You can set the tool in the config.yml
- /glog rollback <options> - to use roll backs, please read the section on our wiki here.
- /glog search <options> - You can search certain events. The options are the same used on the rollbacks.
- /glog page <page_number> - This will let you go through the other pages of your most recent search.
- /glog help - This will bring up the same information you see right here but within your Minecraft Client.
- /glog undo <id> - This will undo the rollback associated with the ID. Do not provide an ID to undo the most recent rollback.
- /glog report - This will report a grief. It will alert the admins of a report when they log in.
- /glog report view - Admins can view information of a grief report. It shows the location of the report, and the reporter.
Need Help?
We are here for you! Feel free to leave a comment, or better leave a ticket. **IMPORTANT**If you are willing to leave the IP address of your server within your ticket, pm, or comment, BlackWolf will be able to enter your server and will have the permission to use the /glog command to see what version you are running. You can disable this feature in the config.yml.
Did you find a bug?
If you find bugs in my plugin feel free to post a comment on this page, send us a pm, or add a ticket. Important: Check your inbox regularly to see if I replied!
Donate
If you want to donate some money because of my awesome work (:P) you can click the donate button on the right on the top of this page. Anything would be appreciated, but you don't have to if you don't want to or can't :)
Metrics
GriefLog creates debug logs, since 5.2.0, in the plugin directory in case there is a problem. You can disable this in the configuration file with the option debug-logging. When you set this to false it will not log any debug information. This information is only used by me to find out more about a bug you might encounter. It will log things like how long it takes to search a file, what is being searched for and if there are any problems when searching, for instance a data type that has been corrupted that can cause the search to fail.
External connections
Since version 5.2.3 GriefLog uses an external service to get the UUID from his name. This has to be done because the search tries to find the UUID of the player you search for in the logs instead of his name. This is because when 1.8 gets here you can change your name, but you can't change your UUID. But to make sure that searching doesn't get more complicated I needed a way to let you guys search for a players name while GriefLog searches for his UUID. For that I currently use an external service until Bukkit will provide one for me, or if they don't I'll keep using this one.
Hello and thanks for this plugin, but i have a little bug in the Java console caused by GriefLog.
Error log :
______________
______________
My config.yml file :
- - - - - - - - - - -
- - - - - - - - - - -
@Evanito
Thanks for telling me that, i'll fix as soon as i know how xD Could you give me that error, i assume you get an error in the console. And add it as a ticket this time :P
Also thanks for the idea, i'll add that :)
I have creeper explosions disabled in essentials config. Whenever a creep explodes, grieflog spams console. Fix?
Can I ask if you can add a config option for, i dunno, simple logging? Im not talking about the files format, but when you use the block logging tool (default: fire) could you set it to be more simple and omit certain things? Like have each action only take one line instead of 2-3 in chat? I would thank you soo much as that is the only downside i see in your plugin :)
EDIT: So instead of: 7-8-2012 14-10-22 [BLOCK_PLACE] By: Thedude13542 GM: 1 What: GRASS on Pos: -160, 74, 256 in: TerraSX You see: 7-8-2012 14:10:22 Thedude13542 placed grass (in GM: 1)
And maybe have a config to show/hide the gamemode or just show the default, hulking log.
@Evanito
no, i removed that a while ago, but i forgot to remove that in the config, you can just delete that line.
Wait, I just need a confirmation, does worldedit logging work? I dont think it does.
@Robey555
Simple to fix, turn the blockprotection off, i have a full bug fix for it in the next release, but till than you will have to turn that off, if you do use it, you should try worldguard or something like that to protect your stuff while this bug is still there.
greetz blackwolf12333
Same. And I need more help but i sent you a message on Skype. Thanks.
i am having that issue too
Really like this mod! It's simple and gets the job done, however I've just updated to your recent file, and whenever I break a block (with any or no items held) it says "Searching for matching results...". This seems to happen regardless of whether I'm an op or not. Is this a bug? If not, is there any way to stop this from happening?
@Evanito
I will, that's the base of my plugin:P so yeah that will stay, i might add the ability to change to mysql if someone prefers it, than he will just set that in the config, in the future.
I just wanna say I love this plugin and only use it for its simplicity and that it does not need a database! Please keep the text file!
Firs log system with rollback on it which DOES NOT require MySQL!
@royvandijk06
It should not matter which version you use, because they all create the file in the same way, so no matter what that error will keep popping up, but i have it fixed in the next release, just have to get one thing done before i can release it...
I have the same problem as Tedoss still at 4.0, i use 3.8 now...
@blackwolf12333
Just a comment...
@royvandijk06
What are you trying to tell me now? And it doesn't matter if you don't have WorldEdit, than you just can't use that option...
I never use rollback, I also dont have Worldedit. I use backups...
@Wannab007
I am working on a version that will give you the ability to rollback within a wordedit selection, and i will try to add rolling back a given amount of time too maybe, don't know yet how difficult that will be. I am trying to fix one thing now, and when that's done i will upload the new version.
you are right, the logs are indeed getting very big, that's why i don't save everything to one file, but it moves a file when it has reached a specified size, in the config you can set the size. but database support might be something i could add to, but not yet, sorry.(btw databases take up large amounts of space too)
Hope this info helps a bit, greetz blackwolf12333
i havent tried the plugin but i dont think there are enough plugins that offer block logging and rollback functionality.
i would try this one but i would rather database support, ive used core protect and it uses flat files and they tend to get out of hand and take up massive amounts of space on large servers
also i think a more comprehensive rollback is needed, as in add the ability to rollback a specific player for x amount of time, or rollback everything the player has done if no arguments are used, and maybe a confirmation to do the rollback if that already isnt in there
ive been looking for a big brother replacement for a while now and cant find anything that i like as much, but thanks for keep this one up to date