LogBlock

From Nitradopedia EN
Revision as of 13:06, 21 May 2015 by Cranken (talk | contribs) (Parameters)
Jump to: navigation, search
LogBlock
Pluginlogo-LogBlock.png
Servermod: Bukkit‎
Category: AntiGrief
Developer: DiddiZ
Developer Website: Dev-Bukkit
Description: Ermöglicht es Griefing rückgängig zu machen
Features: Bietet viele Konfigurationsmöglichkeiten
Download: Link

LogBlock is a tool which allows you to keep track of almost everything on your server, while also giving you the ability to rollback (revert) or redo changes made by users and natural occurrences such as liquid flow or leaf decay. Additionally, LogBlock is able to log and rollback chest contents, sign text and more!

Installation

With the Nitrado-Webinterface

If you aren't in the webinterface already, go to "My Services->Gameserver->Webinterface Login"
Then you have to navigate to "Minecraft->Plugins->Avaible Plugins->LogBlock.jar->Install"
Done!

Without the Nitrado-Webinterface

Go to the DevBukkit project site and download the plugin which uses your server version.
Now you have to upload the plugin to the plugins folder in your server folder. You can do this by using the FTP server which is explained here.
Done!

Configuration

Config.yml

loggedWorlds:
 - world
 - nether

Names of the worlds you wish to have logged. Ensure you use the exact name as specified in server.properties, including path.

version: '1.40'

This doesn't mean anything to the end-user (but don't delete it!). It is simply the version the config was created under and won't always update when there is a LogBlock update. Don't worry if it's not the same value as the version of LogBlock you're running.

MySQL

Navigate to "File Management->MySQL DB"

host: localhost

Address or the MySQL server. "DB Hostname:" in your Webinterface.

port: 3306

Port of the MySQL server.

user: username

The MySQL username. "DB Username:" in your Webinterface.

password: pass

Password for the MySQL user. "DB Passwort:" in your Webinterface.

database: minecraft

The database that LogBlock should use. It must be an existing database as LogBlock isn't able to create one. "DB Name:" in your Webinterface.

Logging

logCreeperExplosionsAsPlayerWhoTriggeredThese: false

Logs creeper explosions under the name of the player who triggered the exploosion. If this is set to true, you must use /lb [...] player <playername> instead of /lb [...] player Creeper.

logKillsLevel: PLAYERS

There are three log levels:

1) PLAYERS - Only players who killed another player

2) MONSTERS - Players and monsters

3) ANIMALS - Logs every kill

logEnvironmentalKills

Set this to true to log kills not directly caused by other entities. Examples include burning to death, falling, and suffocation.

hiddenPlayers: []

The players listed there won't get logged. Not recommended to use!

hiddenBlocks: - 0

These blocks are ignored for logging. Not recommended, except you don't use rollbacks. Air (0) must be there.

logPlayerInfo: false

Set to true to log player online time, time of first and last login, and IP address of last login.

Rollback

replaceAnyway:
- 8 //Water
- 9 //Water
- 10 //Lava
- 11 //Lava
- 51 //Fire

By default, these are blocks that are considered to spread naturally. These are blocks that will be replaced at rollback.

dontRollback:
- 10 //Lava
- 11 //Lava
- 46 //TNT
- 51 //Fire

By default, these are blocks that are considered harmful and shouldn't be spawned again. Upon rollback, if they were destroyed, they won't be placed back in the world.

Lookup

defaultDist: 20
defaultTime: 30 minutes

Default values for parameters area and time.

toolblockID: 7 //Bedrock
toolID: 270 //Wood pickaxe

ID's for items to be given to player when tools are summoned. Ensure toolblockID is the ID of a block and toolID is the ID of an item.

toolQuery: area 0 all sum none limit 15 desc
toolBlockQuery: area 0 all sum none limit 15 desc

Queries to be performed upon use of tool. For information on forming these, see below in the params part.

Usage

Permission-Nodes

logblock.lookup

Grants user access to /lb lookup (Users can't use their tools without this node!)

logblock.rollback

Grants user access to /lb rollback

logblock.clearlog

Grants user access to /lb clearlog

logblock.hide

Grants user access to /lb hide (This hides all new edits by the user from the log [their edits won't get added to the queue]!)

logblock.tp

Grants user access to /lb tp

logblock.me

Grants user access to /lb me

logblock.ignoreRestrictions

Grants user access to override all rollback and lookup restrictions

logblock.spawnTools

Grants user access to spawn tools with /lb

logblock.tools.toolblock

Enables access to the "toolblock" tool

logblock.tools.tool

Enables access to the "tool" lookup tool

logblock.*

This grants all nodes up. Only give this to people you absolutely trust! For information on each node please see above

Commands

/lb help

Prints help information.

/lb params

Prints a full list of parameters.

/lb commands

Prints a full list of commands.

/lb permissions

Prints a list of the LogBlock permissions assigned to you.

/lb tool

Gives the player the lookup tool which is specified in the configuration. Additionally, the 'command imitation' of the tool is also specified in the configuration. This is not usable from console.

/lb tool <on|off>

Sets the enabled state of the lookup tool respective of parameter specified. This is not usable from console.

/lb tool <params>

Sets the 'command imitation' of the tool to the specified params. These only affect you and are reset upon server reload or restart. This is not usable from console.

/lb toolblock (or tb)

Gives the player the lookup toolblock which is specified in the configuration. Additionally, the 'command imitation' of the tool is also specified in the configuration. This is not usable from console.

/lb toolblock (or tb) <on|off>

Sets the enabled state of the lookup toolblock respective of parameter specified. This is not usable from console.

/lb toolblock (or tb) <params>

Sets the 'command imitation' of the toolblock to the specified params. These only affect you and are reset upon server reload or restart. This is not usable from console.

/lb savequeue

Forces all changes currently waiting in the queue to save to the database (this is still done async [on its own thread]). This may be useful for rollbacks after forest fires.

/lb writelogfile <params>

Writes result of query using params specified to a log file located at /plugins/LogBlock/log/*.log where * is replaced with a friendly title. Additionally prints location of file to the user.

/lb [lookup] <params>

Prints result of query using params specified. The use of lookup in this command is not required.

/lb page <number>

Prints information contained on the page specified in the arguments from the last lookup.

/lb <prev/next>

Prints information contained on the previous or next page from the from the last lookup.

/lb tp <number>

Teleports the player to the location of a block change in the last lookup or rollback error. In order to teleport to results, the param coords is required to have been used in the last lookup or rollback. This is not usable from console.

/lb tp <params>

Teleports the player to the location of the last recorded result of parameters supplied. Ex: /lb tp player jamietech teleports you to the location of the last recorded result by player jamietech. This is not usable from console.

/lb rollback (or rb, undo) <params>

Rolls back block changes, chest changes (if recorded), sign changes (if recorded) of the specified parameters. Will also print information about rollback after it is complete unless silent parameter is used.

/lb redo <params>

Redoes block changes, chest changes (if recorded), sign changes (if recorded) of the specified parameters in backwards order. Will also print information about redo after it is complete unless silent parameter is used.

/lb clearlog <params>

Deletes the log regarding the specified parameters. Cannot be undone unless dumpDeletedLog is enabled and the dump is imported. It's highly recommended to perform a lookup first and then use /lb clearlog last to avoid deleting the wrong log.

/lb hide

Toggles the players hidden status. No actions from a hidden player will be logged from the point they are hidden t the point they are un-hidden. Be careful. This is not usable from console.

/lb me

Shows you a 'statistical' view of your block changes. Shorthand for /lb player <you> sum blocks

Parameters

Location

area <radius>

To only search for near block changes. The area has a square shape. If no radius is specified, the default radius will be used (lookup.defaultDist). A radius of 0 stands for a single block and is used for tool queries.

sel | selection

To search only inside the current WorldEdit selection. Works only for cuboid selections.

loc [x]:[y]:[z] | location [x]:[y]:[z] (v1.51+)

Specify a single block. You can use colons or spaces to seperate, like loc 45 -12 64 or loc -123:265:70 You can combine loc and area to get the area around a set of coordinates, as long as loc is specified first

world [worldname]

Selects the world. Required for console commands. Allows to look up in a specific world. Default is the current world.
Type
What to search for. Can not be combined. The default for lookups is both and the default for rollbacks is all

all

Looks up all blocks (including actions) and chestaccess and mechanism interactions

created, destroyed, both

To search only for block creations/breaks or both Without any type given, it will search for created and destroyed blocks.

kills

Looks up only kills assuming it is enabled in the config

killer [name1] {<name2>}, victim [name1] {<name2>}

To search only for kills where the given player was the killer/victim. Use !name to search for all players except the given.

weapon [material]

Search for kills by weapon, seems to be broken

chestaccess

To search only for chestaccesses

chat

Search chat only. You can use the params player, since, before and search.

search | match

Search the chat history for some words. Refers to http://dev.mysql.com/doc/refman/5.0/en/fulltext-boolean.html.

Example: /lb chat player diddiz search home or /lb chat player diddiz search tree home Will search for all messages by player diddiz containing the words tree OR home. /lb chat player diddiz search +tree +home Same as previous, but both words have to appear. /lb chat player diddiz search tree -home Find all with tree but without home.
Time

since [timespec] | time [timespec]

To search only for block changes newer than the specified time. Accepted syntax’s are: LB time format: 4 minutes, 5 hours, 6 days BB time format: 4m5h6d, 5d40m, 7m DateTime: 12:00:00, 22.05.2011, 22.05.2011 12:00:00 (for a date without a time 0 am is assumed, for a time without date the current date)

before [timespec]

To search only for block changes older than specified time. Same format like since param. You can use since and before together to define a time span. Filter

player [name1] {<name2>}

To search for one or more players, also environment players like Fire or LavaFlow Use !name to search for all players except name If you specify a partial name, LogBlock will try to guess who you mean from the players currently on the server. Use "name" to override this (e.g. to search for "Fire" while the player "Firefly" is online)

block [material1] {<material2>} | type [material1] {<material2>}

To search only for certain block type Use !material1 to search for all blocks except material1
Results

limit [count]

How many rows to show. Default is 15.

sum [n<one>|b<locks>|p<layers>]

To sum up the result. none is default. none means all single block changes are listed, block means to group by block types and players to group by players.

asc, desc

Set the order of displayed log ascending/descending.

coords

Displays also block coordinates. Only affects look up and writelogfile commands. This parameter is required to use the /lb tp command.
Other

silent

No questions and displayed messages are reduces to a minimum.

last

Stands for all parameters of the last command. It’s possible to extend it and to overwrite, e.g: /lb player diddiz Displays blockchanges from of diddiz /lb last area Displays blockchanges of player diddiz within default radius /lb rollback last Rolls back blockchanges of player diddiz within default radius.