LogBlock – Minecraft

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

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 .

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 a.sh a.sql creds.txt en-dev en-insert-1686039050.sql images.tar.gz m.sh output snippet urls.txt 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.