Bukkit

Configuration

Libelula Logger is a ready-to-use plugin, you really don't need to change anything on the configuration. Anyway, you probably want to adjust the event registering behavior to your server gameplay. Due to this I made the plugin completely flexible and configurable. All settings can be changed from console or gameplay commands, and also be done by editing the config.yml file.

The headings listed below are keys in db-engine section of the configuration file:

database-directory

The name of the database storage directory. (string, pathname)

Default: ./database (path is relative to LibelulaLogger plugin directory)

Possible Values: Any valid writable path.

max-disk-db-size-mb

Sets maximum amount of disk space will be used for store events, when it is full the oldest records are deleted. (Integer)

Default: 1024 (Which means 1GB. Enough for recording about 61.44 million of events)

Possible Values: Any integer greater than zero.

max-events-in-ram

Sets maximum amount of events in ram. This is a performance-fine-tuning parameter and you should not modify it unless you know exactly what you're doing. (Integer)

Default: 1024

Possible Values: Any integer greater than 512

The headings listed below are keys in log-policy section of the configuration file:

only-modified-blocks

If it is true the plugin will only register broken blocks when they were put by a player. You can save a lot of disk space, but if there are constructions made before the plugin installation, they blocks removal events will not be taken into account. (boolean)

Default: False

Possible Values: (True, False)

ignored-worlds

A comma-separated list of the worlds which will be ignored by the plugin. Not really necessary, believe me, this plugin can handle all worlds in your server. (List of String, Worldname)

Default: [] (empty)

Possible Values: Any worldname.

ignored-materials

A comma-separated list of the materials which will be ignored by the plugin. Not really necessary, believe me, this plugin can handle all events of your server and some pixelart uses all materials. (List of String, Material Name/ID)

Default: [] (empty)

Possible Values: Any valid material Name or ID, example: [31:1, GRASS, DIRT]

ignored-players

A comma-separated list of the player which will be ignored by the plugin. It's not a good idea to use this list, it can convert trusted players into distrusts ones. (List of String, Player Names]

Default: [] (empty)

Possible Values: Any valid playername.

worldguard-regions-policy

Requires WorldGuard plugin. It sets the registration policy for World Guard regions. (string, fixed values list)

Default: EVER

Possible Values: EVER, NEVER, DIFFERS

EVER - Records any changes made into WorldGuard defined area.

NEVER - Never records changes made into WorldGuard defined areas,

DIFFERS - Changes made into WorldGuard defined area are only register if the player is not a owner/member of the area.

Logging to text files Configuration

signs.active

Indicates whether the signs should be also recorded in text files.

Default: True

Possible Values: (True, False)

signs.ignore-empty

Indicates whether the empty signs should be not recorded in text files.

Default: True

Possible Values: (True, False)

target-log

Indicates the destination files for sign which are recorded in text files.

Default: INTERNAL

Possible Values: INTERNAL, EXTERNAL, BOTH

INTERNAL: Logs signs events in your server.log file. EXTERNAL: Logs sings events in your configured external-log-filename file. BOTH: Logs signs events in both, server.log file and configured external-log-filename file at the same time.

external-log-filename

The name of the file where the EXTERNAL logs for signs events will be written. (string, pathname)

Default: ./signs.log (path is relative to LibelulaLogger plugin directory)

Possible Values: Any valid writable path.