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.
@blackwolf12333
Done. But where is the GriefLog plugin log?
@Scienziatogm
Could you try using the latest development build (use at own risk!). It has some debugging stuff added so that I can debug problems like this easier.
You'll also have to edit your config.yml and set debug to true
@blackwolf12333
When I use the tool to search something.
@hooners
Thanks.
You are not the first to ask, but I personally don't like SQL in general and secondly don't know how to use it :P
@CraftPimp
Yes it does, the latest upload which says it is for 1.7.2-R0.3 is actually just 1.7.9 :)
@Scienziatogm
I actually wanted the GriefLog logs. But one question, did these errors occur when you tried to search with the tool or when you tried to roll something back?
@blackwolf12333
https://mega.co.nz/#!YYRwiZSa!1BHb3EXy9m8bsjn9IfC7nYrQwaxTx9lKXhuy_NO3Yk4
Does this work with 1.7.9?
Awesome plugin!!!!!!!!!! Absolutely perfect and I hope you continue to maintain it. One question - and maybe i missed it. Do you have database capability yet for logging? for better performance? Not major, but would love to be able to dump all activity into mysql and then have access for custom queries, etc. Thanks! Keep it up!! Rollback function has already saved a TON of grief already in just a week.
@Scienziatogm
Can you get me your log files in a zip file? I can't find out what's wrong here without the data that is being searched. Also could you provide the location where you searched: x y z coordinates?
I have these errors:
@Zauber55
I'll have a look at it tomorrow afternoon :)
Edit: I looked at it, can't duplicate it here, could you provide the full error? This is just a small part that doesn't tell me enough about it :/ I have a theory on why you get this error though, just haven't been able to check it because I need a second player for that.
Hello blackwolf,
Your plugin is a life saver. But I am having some errors for the past days. I use lwc and openinv plugins maybe they are related because it says inventory, any ideas?
Error: 14:54:42 CONSOLE: java.lang.ArrayIndexOutOfBoundsException: 2 14:54:42 CONSOLE: Source) [?:?] 14:54:42 CONSOLE: Source) [?:1.7.0] 14:54:42 CONSOLE: Source) [?:1.7.0] 14:54:44 CONSOLE: ERROR]: Could not pass event InventoryOpenEvent to GriefLog v5.1.0 14:54:44 CONSOLE: java.lang.ArrayIndexOutOfBoundsException: 2
@Minken008
Could you make a ticket for that? I'll have a look at it, but can't promise anything.
Edit: I just checked, this is a bug, I hope I'll fix it tomorrow, otherwise it will be next week I'm afraid.
Edit2: I fixed it, fix is in the latest development build :)
I have a suggestion: add in config file so you can ignore a certain world. One of my worlds are really custom and protected by worldguard. I would like to have GriefLog to ignore everything that happens in that world.
Hopefully that would get rid of the message below.
Thanks, Minken
Thank you guys! I changed the tool and it worked. Seems like sometimes it's just laggy and it'll take a bit to pop up or I'll have to try a few times, but I got it. :)
@ladyyura909
You have to left click if you want to know what happened to the block that you are clicking, you have to right click a block if you want to know what happened at the location where you then place the tool block. That is why you can't use for instance a sword as tool because you can't place it anywhere.
@Jaynabelle
Are you sure that you use the right tool? You have to use /glog tool to get it otherwise grieflog won't recognise it as tool. Logging and searching hasn't been broken for at least 3 craftbukkit releases, so I don't see a reason why it would now. If you're console spams errors you should create a ticket though and provide the grieflog log and the error so I can debug it :)
@Jaynabelle I changed my tool to sponge, try changing it to sponge or bedrock. Did you left click or right click the area? i find that i have to do both, sometimes a right click says nothing but then i left click and then theres the information.
Hello! When I use the glog tool ( water ) [ I'm on bukkit 1.7.2 ], no information about the block pops up or anything. It's like nothing happens? The logs are being stored and whatnot, but it's just when I use the water tool - which would making looking through the logs A LOT simpler, nothing happens. Am I missing something?
@blackwolf12333
Thanks for seeing what you can do about the chests!
When giving permissions, how do I give normal players only the ability to report? I tried giving just the - grieflog.report permission but that didn't work, and I need people to be able to report so I gave everybody the wild card then tried writing in like - -grieflog.tool but it doesn't work and will still give them the tool. Any help?