Bukkit

This plugin logs all players’ names to a sign block(Tracking Point) that come within a preset number of blocks (set by the player) of where the sign(Tracking Point) is located.

To use this plugin all the player has to do is put down a sign block anywhere and add it to the list of existing tracking points(that get updated by the plugin, update time set by the server admin). Therefor if the player just wants to know who visited them when there were offline, or maybe a player was griefing their work, with this plugin the player will know who was there.

Every time the sever logs all players within the given number of blocks for that sign blocks(Tracking Point) being updated, there names will be added to that Tracking Point, players are added going by order of who was closest to the given sign on the update.

Versions Note

• This page is for the plugin version CraftWanderer-1.0
• If you are using CraftWandererAlpha v0.3.0 For Bukkit 1.7.2 or lower go to: Old versions page
• Older versions of this plugin below 1.0 are not supported anymore.

Note:

• This plugin doesn’t display what players were there before the sign was added.
• This plug should be used with other anti griefing tools to stop the sign from being destroyed.
• This plugin is still a working in progress, and this is just a basic working release of the plugin.
• To display all players that are on the sign, you need to right click the sign.

Plugin Setup:

1. Drag and drop the plugin into the bucket plugin folder and reload the server.
2. This plugin creates a directory called ‘CWanderer’ and creates a file called CWandererConfig.xml.
3. More information in the xml file, open in xml viewer.
4. This plugin doesn’t use any databases!

Admin Usage:

1. When the plugin is first loaded it's set to automatically update the signs that are in the update list in the CraftWanderer.xml file (As there are no signs in that list nothing is updated).
2. You can stop the plugin from updating by running the command ‘/cw-track tracking false’, and to enable again just run ‘/cw-track tracking true’.
3. If you want to change the delay between every update, form the server command line run '/cw-set Time Integer' the integer is in seconds.
4. The CWandererConfig.xml is also used to save the locations and data of the signs that a player has added, if at anytime the CWandererConfig.xml is deleted just reload the plugin and the file will be recreated with the default setting, all signs that were saved to the CraftWanderer.xml file will lost when the file was deleted.
5. Bukkit server logging, the plugin will only log on the server command line on start up or if an error has occurred.

Plugin Setting Options

This section lists the plugin options that can be changed.

Tracking

This option can be true or false, and determines if the plugin is tracking players or not.

• Use: '/cw-track tracking false'

Dynmap

This option can be true or false, and determines if all the tracking data is displayed on the dynmap or not.

• Use: '/cw-track dynmap false'

Known issue with the dynmap, when you add/remove a tracking point the map becomes frozen! the workaround is to reload the the map on your browser(Looking into it:/).

Versions: dynmap-2.0.0-alpha-1 with dynmap-api-1.9.2

TimeDelay

This option is an integer value in seconds, it's used for the delay between the plugin tracking the player.

• Use: '/cw-set time 10' To set the time delay to ten seconds.

The plugin is designed to change the TimeDelay if the update process takes longer then 1% of the allowed time TimeDelay set by the admin. so if the TimeDelay is set to one second, the update time should be less then 10ms, if the update is taken 50ms the update time will be changed to five seconds. If the update time is taken less then 1% of the changed allowed time the plugin will change the delay as close to the TimeDelay set by the admin as possible.

This is help if the server is overloaded with other plugins/players!

RemoveDelay

This option is an integer value in hours, it's used for the amount of time the plugin keeps the tracking data for a tracking point.

• Use: '/cw-set remove 30' To set the time delay to 30 hours.

RelogDelay

This option is an integer value in seconds, it's used as a delay between a player is relogged to a tracking point.

• Use: '/cw-set remove 10' When a player is logged to a tracking point, they can't be relogged to the same tracking point for another ten seconds.

RelogBlocks

This option is an integer value in blocks, it's used for the allowed amount of block the play can move with out getting relogged to the tracking point.

• Use: '/cw-set blocks 5' When a player is logged to a tracking point there allowed to move 5 blocks x or z without getting relogged to the same tracking point.

PlayerCount

This option is an integer value, it's used for the max amount of times a played can be logged to a tracking point.

• Use: '/cw-set blocks 3' The player will only be logged to the tracking point three times, with the oldest getting removed after every new log.

BackupRunner

This option is an integer value in hours, it's used to sync the file system with the data in memory.

• Use: '/cw-set backup 3' This will save all the data in memory to the XML file, this also happens on reload as well.

User Usage:

1. Put down a sign block and set the first line to [CWaunderer] or leave the sign empty.
2. Enter '/cw-add 10' or '/cw-add 10 signName' in the chat. (Log ever player within 10 blocks of the sign).

• '/cw-add 10' The default name for the tracking point will be 'ThePlayerName_SignNumber'.
• '/cw-add 10 signName' The name for the tracking point will be 'signName'.

1. Right click the sign with a empty hand.
2. To delete the sign, just remove the sign.

• When the sign is removed from the world it's added to the players lost tracking points list, the player can still re-add the tracking point by using the command '/cw-lost signName'.
• Only when the plugin syncs the data in memory with the filesystem is the tracking point deleted.

1. For help with any command use 'TheCommand help' e.g.(/cw-status help) for the full list of options with commands.

Suggested to be added (If needed!)

• Mysql support (Save data in database not in XML file).
• Memory manager (Don't load the data of a tracking point into memory if not in use).

If you think any of the above would be useful in this plugin please say so in the comments below!

Disclaimer

This plugin is still in a early development, use at your own risk, i don't accept any responsibility within the miss use of this plugin*. By running this plugin on your server and allowing players to use this plugin on your server, you accept full responsibility for this plugin.

Plugin Dev

• If you are using the plugin and have idea where it could be improved, just let me know by a PM:)
• This plugin is using MCStats!
• The MCStats collects basic information about the server the plugin is running on.
• If you think this plugin needs a plugin tutorial, please let me know in the comments below.
• If you like this plugin why not try my other plugin Customizable Rock Paper Scissors Lizard Spock