Bump version to 6.0.0-beta-02.

Fixes WORLDGUARD-3174.

.gitignore

@@ -1,11 +1,11 @@
-.classpath
-.project
-.settings
-target
+/.classpath
+/.project
+/.settings
+/target
 
 .DS_Store
-*.iml
-.idea
+/*.iml
+/.idea
 
 /bin
 /dependency-reduced-pom.xml

CHANGELOG.md

@@ -0,0 +1,700 @@
+# Changelog
+
+## 6.0 beta 2
+
+* Added an `-e` parameter to `/rg flag` that sets the flag to an empty value. You can use this to, for example, make it so the `deny-message` flag is empty, meaning that players won't get a message at all.
+* Added a visual smoke effect when an action on a block has been denied.
+* Added `event-handling.interaction-whitelist`, a list of items or blocks that should never be protected. For example, adding `wooden_door` to the list would make it so that doors could be used by anyone regardless if they have permission or not. You may still protect the blocks via other means.
+* Added `event-handling.emit-block-use-at-feet`, a list of items that, when used, will also be considered as the player using that item on the block at the player's feet. The purpose of this setting is, for example, to allow you to (sort of) prevent the use of a mod-added item that does not emit events.
+* Added `-s` to silently turn toggle `/stoplag` and `-i` to show the current state of the setting. (Thanks, [stuntguy3000](https://github.com/stuntguy3000)).
+* Added support for Bukkit [Material](http://jd.bukkit.org/rb/apidocs/org/bukkit/Material.html) names in the blacklist.
+* Fixed [#3167](http://youtrack.sk89q.com/issue/WORLDGUARD-3167): Saplings can be used without permission although it won't place blocks inside the region
+* Fixed [#3168](http://youtrack.sk89q.com/issue/WORLDGUARD-3168): Grown saplings that are partially prevented from placing all of its leaves may not remove the sapling
+* Fixed [#3169](http://youtrack.sk89q.com/issue/WORLDGUARD-3169): Bonemeal usage falls under the USE flag when it should really fall under building
+* Fixed [#3174](http://youtrack.sk89q.com/issue/WORLDGUARD-3174): Boat placement is not properly prevented in a protected region
+* Fixed [#3130](http://youtrack.sk89q.com/issue/WORLDGUARD-3130): Polygonal selections allow unlimited claim volumes with /rg claim
+* Fixed [#3137](http://youtrack.sk89q.com/issue/WORLDGUARD-3137): Claiming infinite regions is possible due to integer overflow
+* Fixed [#3171](http://youtrack.sk89q.com/issue/WORLDGUARD-3171): Can't pickup XP in protected regions without permission
+* Fixed [#3170](http://youtrack.sk89q.com/issue/WORLDGUARD-3170): Boats without a driver can be used to break lily pads
+* Fixed [#3172](http://youtrack.sk89q.com/issue/WORLDGUARD-3172): Players cannot be damaged by mobs in protected regions unless they have permission
+* Fixed [#3152](http://youtrack.sk89q.com/issue/WORLDGUARD-3152): BUILD overrides all other flags, unlike in WG 5
+* Fixed [#3154](http://youtrack.sk89q.com/issue/WORLDGUARD-3154): notify-enterflag doesn't work with horses and other vehicles
+* Fixed [#3166](http://youtrack.sk89q.com/issue/WORLDGUARD-3166): Trees do not grow naturally within protected regions
+
+## 6.0 beta 1
+
+### UUID support
+
+Regions now fully support the use of UUIDs rather than names for storing the owners and members of a region. Commands still accept names, but they are translated into UUIDs in the background. For users who already have existing region data, names will be automatically converted to UUIDs on the first run of WorldGuard.
+
+It is still possible to specify names rather than a UUID by using the `-n` flag with the region membership commands.
+
+### 'Deny by default'
+
+Previously, a pre-determined list of blocks and entities was used to determine whether an action by the player should be blocked. However, this has been reversed so that every action on a block or entity is denied (in a protected region) unless it has been deemed safe (such as, for example, right clicking with steak). Mods are now supported as a result.
+
+The `USE` flag has been repurposed as a general "interaction" flag and covers every left click or right click of a block or entity. It also covers interaction that falls outside clicking.
+
+### Exhaustive protection
+
+More events are now handled in the protection code. For example,
+
+* It is no longer possible to drop sand or gravel into a protected region from outside.
+* It is no longer possible to grief a region by growing a tree into it.
+* The entry and exit flags now handle players sitting on vehicles properly.
+* Piston-moved blocks cannot be pushed into a different protected region.
+* Owners of tamable animals are now considered in protection code.
+
+Even water and lava flow can also be checked, although this requires that it be explicitly enabled in the configuration (flow events are very frequent, so they incur extra CPU cost).
+
+The goal is to provide extremely exhaustive protection.
+
+### Large performance boost for spatial queries
+
+The performance of spatial queries for regions has been substantially increased at least an order of magnitude. Spatial queries are a necessity for the region code to query the list of regions that apply to a location in the world. There should be a negligible difference between 4, 40, and 4000 regions as long as too many regions are not overlapping.
+
+### Background region operations
+
+Region commands are now executed in the background. Notably, saves and loads will not lock up your server while they complete. Additionally, changes to regions are now saved periodically rather than immediately after every change.
+
+### Updated MySQL region support
+
+MySQL support has been completely overhauled. It should now be faster, no longer crash on foreign key index errors, use transactions, and support automatic creation and migration of tables (including support for table prefixes).
+
+### Partial region data saving
+
+For users of MySQL, WorldGuard now only saves changed and deleted regions when saving region data. No longer does WorldGuard have to rewrite the entire region database on each save.
+
+### Improved handling of related flags
+
+Multiple flags that apply to an event are now evaluated together if they are similar. For example, if a player right clicks a bed to sleep in it, both the `USE` and `SLEEP` flag are checked since they are both interaction-related. If one of them is `DENY`, then sleeping is denied (remember, `DENY` overrides `ALLOW`). If one of them is `ALLOW` and the other is not `DENY`, then sleeping is permitted.
+
+Only one "category" of flags needs to evaluate to true to permit an action. `DENY` will not cross categories. For example, if `BUILD` is deny, it will not override `SLEEP`, so if `SLEEP` is set to `ALLOW`, sleeping will be permitted. This is fairly similar to how it worked on WorldGuard 5.
+
+### Flag groups now work properly
+
+While you could always set a group to a flag's value, the functionality was incomplete and did not work most of the time.
+
+Now that groups are supported, you can change a flag so it only applies to a certain group of players. For example, `/rg flag example sleep deny -g members` would deny sleeping for only members of the `example` region.
+
+### Inheritance now works as expected
+
+Previously, a region only inherited flags and other details from its parents if the parent and the child overlapped at the location queried. This is no longer the case and inheritance is now always applied. 
+
+In addition, a new `-g` flag for `/rg define` lets you create a region with no physical area so that you can assign flags and use this region as a "template region."
+
+### Settable deny message
+
+It is now possible to change the message that users get when they are prevented from interacting with blocks or entities. This message is defined as a region flag, so you can set it on the `__global__` region or override it in a specific region. In addition, the tone and color of the default message has been softened, but you are free to change it entirely.
+
+### Blacklist support for data values (and later, variants)
+
+The blacklist was rewritten to support more than just block and item IDs. The immediate result is that you can now use data values, but as those are in the process of being deprecated by Mojang, it also allows support for Minecraft's new block variants in the future.
+
+### Debounced events
+
+Events that tend to reoccur very frequently (such as the ones that occur when you stand on a pressure plate continuously) have been "debounced" to reduce the number of checks that WorldGuard has to perform, reducing the amount of wasted CPU. In addition, the "you don't have permission" message is rate limited so players are not flooded with the message.
+
+### New block place and break flags
+
+A long requested feature was the availability of block place and break flags. These newly added flags work in tandem with the `BUILD` flag but can override `BUILD`. At the moment, it is not possible to allow explicit types of blocks to be placed or broken yet.
+
+### Build permission nodes
+
+A new optional (disabled by default in the configuration) feature is the checking of build permission nodes. For every block, entity, and item, the following permission nodes are checked:
+
+* Block place: `worldguard.build.block.place.<material>`
+* Block break: `worldguard.build.block.remove.<material>`
+* Block interact: `worldguard.build.block.interact.<material>`
+* Entity spawn: `worldguard.build.entity.place.<type>`
+* Entity destroy: `worldguard.build.entity.remove.<type>`
+* Entity interact: `worldguard.build.entity.interact.<type>`
+* Entity damage: `worldguard.build.entity.damage.<type>`
+* Item use: `worldguard.build.item.use.<material>`
+
+In addition, the permissions are also checked in the style of `worldguard.build.block.<material>.<action>`, so `worldguard.build.block.<material>.place` would work too.
+
+The list of usable material names comes from the [Material enumeration in Bukkit](http://jd.bukkit.org/rb/apidocs/org/bukkit/Material.html). For example, the permission for placing the bed block would be `worldguard.build.build.place.bed_block`. Be aware that _Material_ contains both item and block names.
+
+For entity names, see [EntityType](http://jd.bukkit.org/rb/apidocs/org/bukkit/entity/EntityType.html).
+
+### Other changes
+
+* Added a setting to permit "fake players" to bypass protection. Fake players are used by some servers and some mods to allow events to be thrown for mod blocks. WorldGuard considers a player to be a fake player if the name starts with `[` and ends with `]`.
+* Added a check so players can no longer disembark in a region from their tamed animal if they don't have permission to get back on.
+* Added an item pickup flag to go along with the item drop flag.
+* Added a new `//running` command was added to show currently running background tasks.
+* Added a blacklist `on-dispense` event.
+* Added more detailed error messages when parsing the YAML regions file.
+* Added the `-Dworldguard.debug.listener=true` option that can be set on your server's command line to see how WorldGuard processes events, although this will result in a lot of log messages.
+* Added log messages that occur on player join when a player had auto-god mode or auto-amphibious mode.
+* Fixed the heal command so that it now sets a player's health to the maximum rather than 20.
+* Fixed `ProtectedCuboidRegion.getPoints()` returning points in wrong order.
+* Fixed the obsidian generator disable option to also apply to tripwire.
+* Fixed an error with the blocked commands flag.
+* Fixed a connection leak with the MySQL region code.
+* Fixed `/wg reload` sometimes not applying new changes right away.
+* Changed the region removal command so that child regions are no longer removed without warning when removing the parent region.
+* Changed the YAML region data save code to first write the data to a temporary file before replacing the final file.
+* Changed how region data is handled when region support is disabled: it is no longer loaded.
+* Changed sponges to now be disabled by default. However, if you had previously installed WorldGuard, sponges will still be enabled. Sponges are being added in Minecraft and they work differently than in Minecraft Classic (which WorldGuard emulates). In addition, enabling sponge support in WorldGuard incurs extra CPU cost even if no sponges exist in the world.
+* Changed how region data is loaded and saved so failures are now more graceful. If the region data fails to load for a world, then the entire world will be protected by default. In addition, periodic attempts will be made to load the region data in the background.
+* Changed the `FEED` flag to maximize the player's saturation level if the hunger level is raised.
+* Changed the `wg-invincible` and `wg-amphibious` groups feature so that it now must be enabled in the configuration.
+* Removed the ability for WorldGuard to upgrade from a version for Minecraft Alpha.
+
+### API changes
+
+* You can use a new `WorldGuardPlugin.createProtectionQuery()` method to easily check build permissions.
+* The listener classes were moved. Consider them internal -- if you want to make use of the listener somehow, please put in a ticket in our issue tracker.
+* Much of the protection-related handling was previously scattered throughout the code. Now WorldGuard funnels events into an internal event system and then processes protection queries in a more consistent matter. These events are for internal use so it is strongly recommended that you do not use them (they may change without notice drastically). A lot of the protection-related flag handling was moved there.
+* A significant portion of classes under the package of `com.sk89q.worldguard.protection` were changed or removed. However, the basic calls (testing the value of a flag, etc.) should still work, but they may be deprecated. Some of the utility `Domain`-related classes were removed.
+* The old region database (load/save) API was removed and replaced with a new one. The new one no longer needs to pointless store a collection of regions on itself -- it has `collection = load()` and `save(collection)` methods.
+* Previously, there were subclasses of `RegionManager` that implemented different spatial indices. However, now `RegionManager` is a final class and the spatial indices are separate (see the `RegionIndex` interface).
+* A hash table was implemented that caches a list of regions within each loaded chunk. This increases performance of spatial queries substantially.
+* A cache of recent spatial queries now exists (a cache of `ApplicableRegionSets`), but you need to make use of `RegionQuery` to make use of this cache. However, if you need to do a spatial query to modify region data, then the old method is better (get a `RegionManager`, etc.).
+* `ApplicableRegionSet` was converted into an interface. In addition, there are now "virtual" `ApplicableRegionSet` instances that are returned by `RegionQuery` for certain special cases (such as, for example, region support being disabled by the user or region data being unavailable for a world due to an error). A new `isVirtual()` method is available. This is not an issue if you are getting `ApplicableRegionSet` instances from a `RegionManager`.
+* `ApplicableRegionSet` now can accept a pre-sorted collection and its use of a `TreeSet` was removed for performance reasons.
+* `FileNotFoundException` is now properly handled in the YAML region file class. It creates the new file and continues on.
+* Player names are deprecated by Mojang and so they need to be converted into UUIDs. As this will take some time, you should do this conversion in a background task. To check whether a region contains a player, it recommended that `contains(LocalPlayer)` be used because it's possible that the user may be still using names. A new `WorldGuardPlugin.wrapOfflinePlayer()` method was added for this specific purposes.
+* All flags now use `RegionGroup.ALL` as the default region group.
+* `StateFlag.getDefault()` now returns a `State` rather than a `boolean`.
+* The priority R-tree index now uses the R-tree for region intersection queries. Previously, it was only used for single point containment queries.
+* Regions now keep a "dirty" flag and changes it whenever data within the region is changed. When WorldGuard decides to periodically save region data, it may only save changed regions. Calling `save()` on the `RegionManager` is no longer needed as periodical saves happen automatically.
+* The old region data migration API was removed in favor of region store drivers. There is no longer a need to have an implementation for every possible conversion (i.e. YAML -> MySQL, MySQL -> YAML, etc.).
+* `ProtectedRegion.copyFrom()` was added to copy region settings from another region.
+* `@Nullable` annotations were added throughout the code. If you use IntelliJ IDEA, you may notice that it now warns you when a return value may be `null`.
+
+## 5.9
+
+* Added a config option to allow explosion flags to only prevent block damage
+* Added allow-tamed-spawns setting, on by default. This will stop WorldGuard from culling tamed animals.
+* Added config option and flag to prevent soil from drying naturally.
+* Added formatting codes, &k/l/m/n/o and &x (reset).
+* Added snow-fall-blocks option to config to restrict snow fall to certain blocks
+* Allow players to add newlines (\n) via command, not just manually in yml.
+* Allow the console to load/save all region managers with one command.
+* Changed entity report format slightly.
+* Check bypass perms for item-drop flag.
+* Check for entities and projectiles removing items from frames too.
+* Fix being able to use bonemeal to turn tall grass into double plants.
+* Fix number of arguments for migratedb command.
+* Fixed addowner/addmember commands adding command artifacts. Specifically,  "-w <world>" will no longer be added when using it.
+* Fixed milking cows in protected areas due to changes in Bukkit.
+* Fixed ProtectedCuboidRegion::getPoints() returning points in wrong order.
+* Fixed snowman trails being treated as snow fall.
+* Make /rg list default to own regions if the player doesn't have permission otherwise.
+* Protected items in item frames in protected regions.
+* Resolved an issue where explosions of type OTHER_EXPLOSION were ignoring the world  configuration settings.
+* Send item-use blacklist event when right-clicking entities.
+* Transformed the BlockFadeEvent handler into a switch.
+
+## 5.8
+
+* BREAKING CHANGE: This version has been built for versions of Bukkit for MC 1.6.1 and newer. Do not try to use this version of WG on an older Bukkit version.
+* Added support for Minecraft 1.6+. Actual support of new 1.6 additions is dependant on Bukkit. Please use a newer build of Bukkit if, for example, you seem to be unable to add "Horses" to your lists of entities.
+* Added mobs.disable-snowman-trails to disable the trails left by walking snowmen.
+* Added -a flag to /region removeowner and /region removemember to remove all objects.
+* Teleporting is now handled by entry/exit flags. If this is causing people to get entirely stuck inside entry/exit deny regions, set the new setting 'use-player-teleports' to 'false' in your configuration.
+* Updated formatting for region commands, especially /region info.
+* Changed permissions checking for /region commands to be more consistent, checking for region IDs as a sub-node. This means that if some permissions for some region commands no longer work, add '.*' to the end of permission lines for WG in your permission plugin.
+
+## 5.7.5
+
+* Refixed a few issues from 5.7.4.
+
+## 5.7.4
+
+* BREAKING CHANGE: Removed the cyan "**" in front of greeting and farewell messages to allow more customizability. You can re-add them by adding "&c**" to the flag.
+* Fixed an issue enderpearling inside exit/entry deny regions.
+* Added checks to players teleporting in and out of exit/entry regions. 
+* Fix bad matching in blocked and allowed command flags.
+* Fixed heal flag bugs when player max health was increased. 
+* Add fishing to xp blocker.
+* Applied other-explosion flag to entity damage as well.
+* Fixed an issue with interaction that should allow blacklisting item use actions with no block involved (eg fishing rods, potions) 
+* Fix witherskull/fireball settings not being differentiated in one case 
+* Allow cow milking in no-build areas
+* Fix infinite durability breaking items instantly.
+
+## 5.7.3
+
+* Fixed the error caused by Bukkit's change of the TNT minecart API.
+
+## 5.7.2
+
+* Updated to MineCraft 1.5.
+* Added TNT Minecart support. They are handled with the same flags/settings as TNT.
+* Added mining and smelting xp handling to the xp drops flag and setting.
+* Fixed a few edge cases for placing items on region borders.
+* Legacy: Fixed issue with //stack not respecting item metadata.
+
+## 5.7.1
+
+* Added a vine growth config option and flag.
+* Added support for many commands to be used from console. Usage is with -w flag and a world name e.g. /rg addmem <id> <player> -w <worldname> /rg flag <id> <flag> -w <worldname> <flagvalue>
+* Fixed bug that blocks placing plants in flower pots.
+* Fixed permissions check for /rg tp
+* Fixed enderchests not being accessible (they are now part of the USE flag)
+* Fixed an issue with slabs being placable in protected regions. This was also fixed in CraftBukkit but has been left in for users running other versions.
+* Fixed wither skulls being handled with other fireballs, despite having their own settings.
+* Fixed item frames being placable on region borders.
+* Fixed a bug that made explosions more ineffective than they should have been.
+* Fixed bonemeal usage in protected regions.
+* Fixed special minecarts being placable in protected regions.
+* Fixed bugs being placable on region borders.
+* Fixed wolves bypassing pvp flags.
+
+## 5.7
+
+* Fixed thread sync issue with FlagStateManager.
+* Fixed dragon egg region protection not working in certain cases.
+* Added beacon and anvil usage protection in regions.
+* Add mobs.block-enderdragon-portal-creation to stop enderdragons from making portals on death.
+* Fix TNT being lethal in some case when damage was disabled.
+* Fix snowballs and enderpearls being able to knock players back in pvp deny regions.
+* Add subcommand support for allowed and blocked command flags.
+* Add max-players-allowed and max-players-reject-message flags to limit the numbers of players in a region.
+* Fix players being able to plant cocoa beans in protected areas.
+* Add an enderpearl flag to prevent players from teleporting to and from regions.
+* Added mobs.block-other-explosions config setting and other-explosion flag to block explosions caused by uncovered things, such as other plugins. (It doesn't actually have to be a mob)
+* Fix mob damage setting and flag not blocking the DoT wither effect.
+* Ghast fireball flag will not block blaze fireballs from lighting things on fire.
+* Fixed players without region permissions being able to trigger tripwires, use enderchests, use wooden buttons, and put plants in flower pots.
+* Added mobs.block-zombie-door-destruction setting to stop zombies from breaking down doors while difficulty is set to hard.
+
+Thank you to thvortex, Dilandau, tophathacker, and Dark_arc for their contributions this release.
+
+## 5.6.5
+
+* Fixed a regression that caused paintings and item frames to no longer be properly protected.
+
+## 5.6.4
+
+* Added mobs.block-above-ground-slimes to block slimes spawning naturally above ground.
+* Added security.deop-everyone-on-join to de-op all players when they join.
+* Added security.block-in-game-op-command to prevent usage of /op from in-game.
+* Fixed a NullPointerException in PlayerInteract involving water potions and potion blocking.
+* Fixed an issue with snowballs being blocked in regions.
+* Changed dragon eggs to be checked like it is a broken block in regions.
+* Moved developer's WGBukkit class to package com.sk89q.worldguard.bukkit.
+
+## 5.6.3
+
+* Added helper WGBukkit class to get references to WorldGuard from other plugins.
+* Added physics.vine-like-rope-ladders to make ladders work like vines. As long as the top ladder block is present, ladder blocks will hold even if they have no block behind them, like a rope ladder.
+* Fixed NullPointerException in PlayerInteractEvent caused by potion blocking.
+* Fixed mobs.block-{item-frame,painting}-destroy not working.
+
+Thank you to def for testing the above fixes and features.
+
+## 5.6.2
+
+* Fixed potion blocking not working well for splash potions.
+
+## 5.6.1
+
+* Added a mycelium-spread region flag.
+* Added a dynamics.disable-mycelium-spread configuration setting.
+* Added new gameplay.block-potions option. For example: gameplay: block-potions: [invisibility, speed]
+* Fixed a bug in the entity explosion event handler that caused a NullPointerException.
+
+Thank you for gabizou for his contribution in this release.
+
+## 5.6
+
+* Added official support for Minecraft 1.4. Support for 1.3.2 (and below) is still provided in this release.
+* Added support for new and existing explosion types.
+* Added support for blocking withers with the following settings: mobs: block-wither-explosions: false block-wither-block-damage: false block-wither-skull-explosions: false block-wither-skull-block-damage: true
+* Added support for blocking item frames (and their use) in protected regions.
+* Added item frame destruction region flags (if you wish to disable item frame  destruction completely).
+* (Re-)added support for priority R-tree region indexes. This means quicker region lookup, and better support for servers with thousands of regions.
+* Improved /region info output for -g group flags.
+* Allowed removing of -g group flags with /region flag.
+* Allowed /region flag to set group and value at once.
+* Deleting a region flag now also deletes group flag.
+* Fixed detection of attack by projectiles to be more accurate.
+* Fixed support for saving non-string flags in the MySQL region support.
+* Fixed spurious comma in "Flags:" /region info output.
+* Fixed players who are not in god mode not receiving damage in PVP areas from enderpearls.
+* Players will now be told that they are in a no-PvP area if they are in one and attempting to attack someone, or that the player they are attacking is in a no-PvP area, if that is the case instead.
+* Fixed an issue where region.getId() was lowercase'd each pass of a for loop in MySQLDatabase.updatePoly2dPoints().
+* Fixed mob damage from projectiles not being properly blocked in regions where applicable.
+* Changed default region wand to leather (#334).
+
+Thank you to the following individuals for their contribution:
+thvortex, Rutr, Glitchfinder, and DarthAndroid.
+
+## 5.5.4
+
+* Minecraft 1.3 support.
+* Fixed /stack dupe bugs.
+* Added regions.use-creature-spawn-event.
+* Update for Async chat issue.
+* Add use flag to cakes.
+* Report number of plugins loaded in report writer.
+* Updated fireblal item blocking.
+* Fixed permissions for /region reload.
+
+## 5.5.3
+
+* Added game mode flag.
+* Added item drop pickup flag to regions.
+* Added support for fireball item blocking (385).
+* Added configuration option to allow creature spawns from plugins.
+* Added host key check.
+* Added a new line split feature to region greetings.
+* Prevented commands in the allow commands list from being blocked and vice versa.
+
+## 5.5.2
+
+* Added potion-splash flag to block splash potions
+* Add entity-painting-destroy which can be used to prevent entities from destroying paintings (skeletons firing arrows)
+* Added send-chat and receive-chat flags
+* Fixed having regions in multiple worlds with the same name not working with MySQL
+* A cancellable event is now fired if WorldGuard disallows PvP. (for developers!)
+* Made /region setparent check worldguard.region.setparent.own/member.<parent> instead of worldguard.region.setparent.own/member.<child>.
+* Allowed passing #<index> in place of a region ID, where <index> is the index as displayed by /region list.
+* Fixed an error that occured when clearing a non-existant region's parent.
+* Added a -s flag to /region teleport, which sends you to the spawn point instead of the teleport point of a region.
+* Added region/role-based permissions to /region teleport.
+* BREAKING CHANGE: Added a LocationFlag class and made the teleport and spawn flags use it.
+* /region info -s now selects the region being queried.
+* Added /region teleport <id>.
+* Vector flags can now be set to the current location with the value "here" and to a specific position with x,y,z.
+* Made /region info show the region you're in if you don't specify an id explicitly.
+* Prevent block ignition from lightning strikes if lightning is blocked in region. Fixes #1175
+* Correctly check both WEPIF and superperms in WorldGurdPlugin.broadcastNotification()
+* Destroy fire blocks when fire-spread is disallowed
+* Added a construct flag that can be used to restrict block placing/destroying in zones to certain roles.
+* Added FallingSand to list of intensive entities to be removed with /halt-activiy.
+* Replaced all usage of CreatureType by EntityType.
+* Updated to support Bukkit 1.2-R0.3 and newer
+* Made auto-god-mode disabled by default again.
+* Added sign protection check disable.
+* Cleaned up javadoc, deprecated duplicate methods, other cleanup
+* Added a RegionGroupFlag to evey region flag Using the /region flag command with -g, the region group that the region flag applies to can be set.
+
+## 5.5.1
+
+* Fixed attacking with arrows from non-PVP to PVP areas
+* Compatibility with Bukkit 1.1-R5
+* Removed broken suppress-tick-sync-warnings config option. See bukkit.yml's setings.warn-on-overload option instead.
+* Add region and 'can build' information to CommandBook's /whois
+
+Contributions thanks to: NolanSyKinsley
+
+## 5.5
+
+* Removed WorldEdit.jar from the classpath to stop conflicts with Bukkit's plugin loader
+* Now using Bukkit's tagged logging
+* Updated to new event system
+* Flush player flag state cache on world change
+* Improved compatibility with versions of CommandBook without GodComponent and updated pom dep for 2.0
+* Added MySQL region storage method.
+* Made explosions display their animations even when the event was blocked.
+* Added fallback support for those who don't have a version of CommandBook with GodComponent
+* Added LIGHTNING flag to DefaultFlag's flagsList Fixes #1026
+* Removed /god, /heal, /locate, and /stack from WorldGuard to CommandBook. CommandBook is now checked to see whether a player is godded.
+* Removed remaining usages of org.bukkit.util.config.Configuration
+* Removed some unused configuration options
+* Added permission worldguard.region.wand to the region wand
+* Fixed ProtectedRegion.compareTo.
+* Fixed FlatRegionManager.getApplicableRegions to return parent regions as well.
+* Added exp-drops flag to disable experience drops per-region.
+* Fixed some warnings.
+* Updated dependency version for WorldGuard from 5.0 to 5.1-SNAPSHOT.
+* Added support for fireballs shot by players being blocked by the PVP flag.
+* Now using dynamic command registration
+* Split off ender dragon block damage from creeper block damage.
+
+Contributions thanks to: narthollis, DarkArc, Wolvereness, and skeight
+
+## 5.4
+
+* Fixed configuration generation on Windows
+* Fixed intersection calculation for regions
+* Fixed timer and feeding delay for food flags
+* Fixed region managers not being created properly (This caused errors related to CREATURE_SPAWN)
+* Added support for Minecraft 1.0.1 blocks
+* Added support for enchantments and tool damage (worldguard.stack.damaged is the node) with /stack
+* Made being in the wg-invincible group respect the configuration's auto-invincible setting
+* Added per-group region claim limit maximum
+* Added worldguard.region.addowner.unclaimed.* permission for non-economy region 'buying'
+* Checking allowed/blocked commands now occurs earlier to override more plugins
+* Made PVP flag check whether either player is in a pvp deny region for blocking
+
+Contributions thanks to: epuidokas, wizjany, Turtle9598, and DerFlash
+
+## 5.3
+
+* Added new config options and flags to better handle explosions of all types
+* Added config options and flags for snow, ice, mushroom spread, grass spread, and leaf decay
+* Added min and max health flags to clamp the values for the existing healing flags
+* Added hunger flags similar to the existing healing flags
+* Added an option to disable the use of the move event. This can boost performance on large servers but will disable the greeting/farewell and entry/exit flags
+* Added flag to prevent pistons (including those that are outside the region, but would affect blocks inside the region)
+* Added a /wg flushstates [player] command to free players stuck in a region that was exit-deny but no longer exists or the flag was removed
+* Added a config option to disable xp orb dropping
+* Added config option to disable redstone wire obsidian generators
+* Added a vehicle-destroy flag
+* Added enderman protection config and flag
+* Allowed and blocked command flags will now fall back to the global region
+* The worldguard.region.flag.own/member permissions are now worldguard.region.flag.regions.own/member! Please change your permissions accordingly.
+* Made //stack respect max stack sizes unless the player has the worldguard.stack.illegitimate permission
+* Setting invincibility flag to deny will override god mode unless the player has worldguard.god.override-regions
+* The sleep flag will now prevent beds in the nether from exploding if set to deny
+* Existing regions can no longer be accidentally overwritten. Use /region redefine to move an existing region.
+* The info command will now sort players alphabetically
+* Priming TNT by punching it with flint and steal should throw a blacklist event (consistent with old Minecraft versions)
+* The /stoplag command will now remove xp orbs
+* Permissions system will use per-world permissions if the provider supports it
+* Players in vehicles are now subject to entry/exit and greeting/farewell flags
+* Fixed interact blacklist event not logging correctly
+* Fixed heal flag taking effect half a block northeast of the region
+* Fixed a infinite sign dropping bug
+* Fixed players being able to douse fire by punching it in regions they couldn't build it
+* Fixed players being able to eat protected cake
+* Fence gate usage can be blocked with the use flag
+* Fixed chests being unprotected when they should be in 1.8
+* Fixed weather config settings not applying when a world was loaded
+* Fixed explosion handling in certain cases
+* Fixed arrows working in non-pvp zones
+* Fixed buckets working on the border of protected regions in certain cases
+Contributions thanks to:
+wizjany, zml2008, imjake9, Droolio, epuidokas,
+EduardBaer, TomyLobo, and halvors
+
+## 5.2.2
+
+* Changed configuration saving so empty lists will be added to the configuration files.
+
+## 5.2.1
+
+* Add region bounds to /region info
+* Added the ability to add owners/members to the global region for handling guest groups. Now if there's owners or members on the global region, then those  that are not on the list cannot build.
+* Fixed some flag algorithm issues.
+* API: Fixed DefaultDomain.size() not counting players.
+* API: Undeprecated ApplicableRegionSet.allows(StateFlag).
+
+## 5.2
+
+* Gave the ability to use color colors and macros in greeting and farewell messages.
+* Added disable-ice-melting, disable-snow-formation, disable-mushroom-spread, disable-snow-melting, disable-ice-formation.
+* Added paintings to blacklist support.
+* Added default.disable-health-regain.
+* Added auto-invincible-permission setting, which lets you use the permission 'worldguard.auto-invincible' to become invincible on join automatically.
+* Flames won't appear if you are /god'ed now. 
+* Added blocked-cmds region flag to block commands.
+* Added allowed-cmds region flag to whitelist commands.
+* Added entry region flag to block entry. Use entry-group to determine who this affects.
+* Added exit region flag to block exit. Use exit-group to determine who this affects.
+* Made negative healing possible via the healing flag.
+* Changed the configuration header messages to be more helpful to new users.
+* Added a warning about modifying region files by hand.
+* Improved the API for plugin developers.
+
+## 5.1
+
+* A lot of changes.
+
+## 4.0-alpha1
+
+* This release is only to fix WorldGuard for Bukkit. Ignore the 4.0 label. Just move along. Nothing to see.
+
+## 3.2.2
+
+* Changed disable-water-damage to disable-drowning-damage.
+* Fixed suffocation disable option.
+* Fixed fire spread blocking.
+* stopfire and allowfire now work in server console, just like in hMod.
+
+## 3.2.1
+
+* Updated for recent Bukkit ItemStack change.
+
+## 3.2
+
+* Added regions.default.pvp to control default PvP setting.
+* Updated WorldGuard for the newer builds of Bukkit.
+* Fixed creeper explosion blocking.
+* Added redstone support to sponges, removed classic water.
+* Fixed item durability disable for hoes.
+
+
+## 3.1.2
+
+* Increased the priority of WorldGuard's event handling.
+
+## 3.1.1
+
+* Fixed creeper and chest flag conflicting.
+
+## 3.1
+
+* Added ability to disable chest protection. New configuration setting (regions.build.chest-access) and new chest flag.
+* Possibly fixed projectile blocking in no-PvP zones.
+* Added /regionmembership permission that lets people only change the owners and members of regions they own.
+
+## 3.0b2
+
+* Fixed issue where built-in permissions were not (re)loaded.
+* Fixed /god not working for others.
+
+## 3.0b1
+
+* Added parent-child relationships to regions.
+* Added global build flag.
+* Improved flag support.
+* Fixed no-PvP zone messages being sent to the wrong person.
+* Fixed commands so that they work in a recent version of Bukkit.
+* Fixed NullPointerException in explode hook.
+
+## 2.3.1
+
+* Fixed various cast exceptions with the blacklist loggers.
+* Added checks for unchecked exceptions when resolving permissions.
+* Fixed the item durability disable setting changing the damage value on an empty hand.
+
+## 2.3
+
+* /god now works very well.
+* Item (TNT, flint and steel, etc.) blocking should now work.
+* The TNT blocking configuration variable should now work.
+* Re-added /heal (not sure where that went), added /slay.
+* Implemented contact damage disable toggle.
+* Made all player damage disabling configuration parameters work.
+* Fixed teleport-on-suffocation setting.
+* Added /locate <name>, /locate <x> <y> <z>, and /locate that lets you program/change your compass bearing to point to a player's position (not yet live), a position, or back to spawn.
+* Fixed CSVDatabase spitting an error if the owners list was empty.
+
+## 2.2
+
+* Now supports GroupUsers.
+* Added support for blocking creeper explosions.
+* Fixed a bug where a player's groups were not being loaded correctly, causing the blacklist group ignore option to not work.
+
+## 2.1.1
+
+* Fixed fire spread disable preventing flint and steel too.
+* Fixed NullPointerException related to the player item event.
+* Made setup simpler.
+
+## 2.1
+
+* Improved Bukkit support.
+
+## 2.0beta3
+
+* Fixed NullPointerException inside the ignite hook.
+
+## 2.0beta2
+
+* Fixed a NullPointerException in the damage hook.
+
+## 2.0beta1
+
+* Added area protection. Use /region or /rg to define regions.
+
+## 1.8.1
+
+* Fixed NullPointerException.
+
+## 1.8
+
+* Updated for Minecraft beta.
+* Blacklist hooks have CHANGED. The new hooks are work better. on-create has been replaced with on-place (for block placement) and on-use (for item usage, light buckets and lighters). The old on-use is now on-right-click although it currently does nothing.
+* Added coordinates to blacklist file logger.
+* Added suffocation damage prevention.
+
+## 1.7.1
+
+* Updated for v0.2.8.
+
+## 1.7
+
+* Updated for v0.2.6_02 and hMod b129.
+* Added option to prevent water from damaging particular blocks (Redstone wire, Minecart tracks, etc.). See disable-water-damage-blocks.
+* /reload WorldGuard should now reload WorldGuard's configuration.
+* Added wg-invincible and wg-amphibious groups that let you give certain players invincibility or underwater breathing.
+* Added the ability to disable fall, water, lava, and/or fire damage.
+* Water/lava bucket blocking should now be more reliable.
+* Added /stack (alias /;) commands to stack items in your inventory into piles up to 64 items in size. Even unstackable items like signs can be stacked.
+* /god mode should now let you gain health.
+* /god mode should now work more reliably.
+* Caught an error message for when the configuration file does not exist.
+
+## 1.6
+
+* Added spawn protection that prevents damage when a player spawns.
+* Added login protection that prevents damage when a player joins.
+* Added /god. /god can be used on others, provided that the /godother permission is set for the command's user.
+
+## 1.5.1
+
+* Removed the 'java.lang.NoSuchMethodError: Item.setDamage(I)V' error generated.
+
+## 1.5
+
+* Removed the block lag fix.
+* WorldGuard now conditionally loads features so you can use any up-to-date build of hMod and the unsupported features won't break the entire plugin. When WG loads, check the server console for a report of features that are not supported by your version of hMod.
+* Changed some configuration defaults: disable-lava-fire=true simulate-sponge=true item-durability=false
+
+## 1.4.1
+
+* Fixed issue with the block lag fix dropping item stacks of 0 quantity.
+
+## 1.4
+
+* New on-acquire hook. This does both a total inventory check on inventory change and item pick up denial. The item pick up denial is largely thanks to Dinnerbone for fulfilling my request to add a particular hook.
+* Item durability can now be toggled with item-durability. Thanks to Dinnerbone for figuring this out while filfilling my request. The default setting is to fix item durability.
+* New no-physics-gravel and no-physics-sand options allow you to prevent gravel and sand from falling.
+* New allow-portal-anywhere option allows you to create portal blocks anywhere. 
+
+## 1.3
+
+* UPGRADE WARNING: If you are using database logging, you must add a NULL 'comment' VARCHAR field to the table. The line of SQL that you can run for MySQL can be found in blacklist_table.sql.
+* Improved plugin compatibility with the block lag fix. For maximum compatibility, you must now list WorldGuard as the first plugin in server.properties and you cannot reload or enable the plugin while the server is up. This is for bad plugins that unnecessarily use the "critical" priority for its hooks like the LWC. Most plugins don't do that though, so this won't apply for most people.
+* Fixed signs being blank if they were denied via the blacklist.
+* Added on-break event to the blacklist.
+* Added comments and messages. Comments are only for your own use and they are printed with the log and notify actions of the blacklist. The message replaces the message that is shown the user and it is optional.
+* The blacklist notification messages are now more compact and are light grey instead of light purple.
+* The notify, log, and tell actions will now trigger every time for the on-break, on-create, on-drop events rather than wait 3 seconds between events for the same item or block for a player.
+
+## 1.2
+
+* /stopfire and /allowfire disable and enable fire spreading globally.
+* Block lag fix slightly improved in accuracy for item drops.
+* Sponge updated to remove water when the sponge block is set. Sponge radius can now be controlled using the 'sponge-radius' parameter and the default is now set to simulate Classic.
+* Updated for a newer build of "b126," meaning that lava spread control now works well!
+* A new summary of the status of some core protections is now printed on start. Disable this with 'summary-on-start'.
+* Blacklist system has been overhauled. Check README.txt for changed configuration settings!
+* The blacklist's method of preventing notification repeats is now better, instead waiting 3 seconds before notifying again (before it didn't notify again at all unless the user started using another blocked action).
+* To give users the ability to receive notifications, the command to give permission to has been changed to /worldguardnotify, although the old one (that was never mentioned anywhere) still works.
+* Water and lava buckets are now psuedo-blocked using an unreliable method that risks the stability of your server (no other plugin does it better though). Use it as your own risk.
+* Added on item drop and on item use (i.e. chest) events.
+* Chests, signs, and furnaces can now be blocked better with the blacklist system.
+* The event names in the blacklist configuration have changed but the old event names should still work. The new names should make "more sense."
+* A new "ban" action has been added to the blacklist.
+* Action messages have been improved, now longer saying "destroyed" for everything.
+* Logging to file has been completely changed, allowing you to use the date and time and the player's username in the log filename. It no longer rotates log files based on size, however.
+* Logging to database is now supported.
+* Tools can now be destroyed on drop to alleviate the durability cheat. You can do this with either with the blacklist or with the 'item-drop-blacklist' configuration option. The configuration option prints more friendly messages than the 'tell' action of blacklists.
+
+## 1.1.2
+
+* Block lag fix: Snow and glass should no longer drop items.
+* Block lag fix: Block object now reset after hook call.
+
+## 1.1.1
+
+* Fixed redstone wire dropping wood blocks with the block lag fix.
+* The block lag fix now consults other plugins so that ALL protection mechanisms and plugins should work.
+
+## 1.1
+
+* Added block lag fix.
+
+## 1.0
+
+* Initial release.

CHANGELOG.txt

@@ -1,614 +0,0 @@
-5.9
-- Added a config option to allow explosion flags to only prevent block damage
-- Added allow-tamed-spawns setting, on by default. This will stop WorldGuard
-    from culling tamed animals.
-- Added config option and flag to prevent soil from drying naturally.
-- Added formatting codes, &k/l/m/n/o and &x (reset).
-- Added snow-fall-blocks option to config to restrict snow fall to certain blocks
-- Allow players to add newlines (\n) via command, not just manually in yml.
-- Allow the console to load/save all region managers with one command.
-- Changed entity report format slightly.
-- Check bypass perms for item-drop flag.
-- Check for entities and projectiles removing items from frames too.
-- Fix being able to use bonemeal to turn tall grass into double plants.
-- Fix number of arguments for migratedb command.
-- Fixed addowner/addmember commands adding command artifacts. Specifically, 
-    "-w <world>" will no longer be added when using it.
-- Fixed milking cows in protected areas due to changes in Bukkit.
-- Fixed ProtectedCuboidRegion::getPoints() returning points in wrong order.
-- Fixed snowman trails being treated as snow fall.
-- Make /rg list default to own regions if the player doesn't have permission otherwise.
-- Protected items in item frames in protected regions.
-- Resolved an issue where explosions of type OTHER_EXPLOSION were ignoring the world 
-    configuration settings.
-- Send item-use blacklist event when right-clicking entities.
-- Transformed the BlockFadeEvent handler into a switch.
-
-5.8:
-- BREAKING CHANGE: This version has been built for versions of Bukkit for MC 1.6.1 and
-  newer. Do not try to use this version of WG on an older Bukkit version.
-- Added support for Minecraft 1.6+. Actual support of new 1.6 additions is dependant on
-    Bukkit. Please use a newer build of Bukkit if, for example, you seem to be unable to
-    add "Horses" to your lists of entities.
-- Added mobs.disable-snowman-trails to disable the trails left by walking snowmen.
-- Added -a flag to /region removeowner and /region removemember to remove all objects.
-- Teleporting is now handled by entry/exit flags. If this is causing people to get
-    entirely stuck inside entry/exit deny regions, set the new setting
-    'use-player-teleports' to 'false' in your configuration.
-- Updated formatting for region commands, especially /region info.
-- Changed permissions checking for /region commands to be more consistent, checking for
-    region IDs as a sub-node. This means that if some permissions for some region
-    commands no longer work, add '.*' to the end of permission lines for WG in your
-    permission plugin.
-
-5.7.5:
-- Refixed a few issues from 5.7.4.
-
-5.7.4:
-- BREAKING CHANGE: Removed the cyan "**" in front of greeting
-  and farewell messages to allow more customizability. You can
-  re-add them by adding "&c**" to the flag.
-- Fixed an issue enderpearling inside exit/entry deny regions.
-- Added checks to players teleporting in and out of exit/entry regions. 
-- Fix bad matching in blocked and allowed command flags.
-- Fixed heal flag bugs when player max health was increased. 
-- Add fishing to xp blocker.
-- Applied other-explosion flag to entity damage as well.
-- Fixed an issue with interaction that should allow blacklisting item use actions with no block involved (eg fishing rods, potions) 
-- Fix witherskull/fireball settings not being differentiated in one case 
-- Allow cow milking in no-build areas
-- Fix infinite durability breaking items instantly.
-
-5.7.3:
-- Fixed the error caused by Bukkit's change of the TNT minecart API.
-
-5.7.2:
-- Updated to MineCraft 1.5.
-- Added TNT Minecart support. They are handled with the same flags/settings as TNT.
-- Added mining and smelting xp handling to the xp drops flag and setting.
-- Fixed a few edge cases for placing items on region borders.
-- Legacy: Fixed issue with //stack not respecting item metadata.
-
-5.7.1:
-- Added a vine growth config option and flag.
-- Added support for many commands to be used from console.
-  Usage is with -w flag and a world name e.g.
-  /rg addmem <id> <player> -w <worldname>
-  /rg flag <id> <flag> -w <worldname> <flagvalue>
-- Fixed bug that blocks placing plants in flower pots.
-- Fixed permissions check for /rg tp
-- Fixed enderchests not being accessible (they are now part of the USE flag)
-- Fixed an issue with slabs being placable in protected regions. This was
-  also fixed in CraftBukkit but has been left in for users running other versions.
-- Fixed wither skulls being handled with other fireballs, despite having their own settings.
-- Fixed item frames being placable on region borders.
-- Fixed a bug that made explosions more ineffective than they should have been.
-- Fixed bonemeal usage in protected regions.
-- Fixed special minecarts being placable in protected regions.
-- Fixed bugs being placable on region borders.
-- Fixed wolves bypassing pvp flags.
-
-5.7:
-- Fixed thread sync issue with FlagStateManager.
-- Fixed dragon egg region protection not working in certain cases.
-- Added beacon and anvil usage protection in regions.
-- Add mobs.block-enderdragon-portal-creation to stop enderdragons
-    from making portals on death.
-- Fix TNT being lethal in some case when damage was disabled.
-- Fix snowballs and enderpearls being able to knock players back in
-    pvp deny regions.
-- Add subcommand support for allowed and blocked command flags.
-- Add max-players-allowed and max-players-reject-message flags to
-    limit the numbers of players in a region.
-- Fix players being able to plant cocoa beans in protected areas.
-- Add an enderpearl flag to prevent players from teleporting to and
-    from regions.
-- Added mobs.block-other-explosions config setting and other-explosion
-    flag to block explosions caused by uncovered things, such as other
-    plugins. (It doesn't actually have to be a mob)
-- Fix mob damage setting and flag not blocking the DoT wither effect.
-- Ghast fireball flag will not block blaze fireballs from lighting things
-    on fire.
-- Fixed players without region permissions being able to trigger tripwires,
-    use enderchests, use wooden buttons, and put plants in flower pots.
-- Added mobs.block-zombie-door-destruction setting to stop zombies from
-    breaking down doors while difficulty is set to hard.
-
-Thank you to thvortex, Dilandau, tophathacker, and Dark_arc for their contributions this release.
-
-5.6.5:
-- Fixed a regression that caused paintings and item frames to no longer be properly
-    protected.
-
-5.6.4:
-- Added mobs.block-above-ground-slimes to block slimes spawning naturally above ground.
-- Added security.deop-everyone-on-join to de-op all players when they join.
-- Added security.block-in-game-op-command to prevent usage of /op from in-game.
-- Fixed a NullPointerException in PlayerInteract involving water potions and
-    potion blocking.
-- Fixed an issue with snowballs being blocked in regions.
-- Changed dragon eggs to be checked like it is a broken block in regions.
-- Moved developer's WGBukkit class to package com.sk89q.worldguard.bukkit.
-
-5.6.3:
-- Added helper WGBukkit class to get references to WorldGuard from other plugins.
-- Added physics.vine-like-rope-ladders to make ladders work like vines. As long as the
-    top ladder block is present, ladder blocks will hold even if they have no block
-    behind them, like a rope ladder.
-- Fixed NullPointerException in PlayerInteractEvent caused by potion blocking.
-- Fixed mobs.block-{item-frame,painting}-destroy not working.
-
-Thank you to def for testing the above fixes and features.
-
-5.6.2:
-- Fixed potion blocking not working well for splash potions.
-
-5.6.1:
-- Added a mycelium-spread region flag.
-- Added a dynamics.disable-mycelium-spread configuration setting.
-- Added new gameplay.block-potions option. For example:
-    gameplay:
-        block-potions: [invisibility, speed]
-- Fixed a bug in the entity explosion event handler that caused a NullPointerException.
-
-Thank you for gabizou for his contribution in this release.
-
-5.6:
-- Added official support for Minecraft 1.4. Support for 1.3.2 (and below) is still
-    provided in this release.
-- Added support for new and existing explosion types.
-- Added support for blocking withers with the following settings:
-    mobs:
-        block-wither-explosions: false
-        block-wither-block-damage: false
-        block-wither-skull-explosions: false
-        block-wither-skull-block-damage: true
-- Added support for blocking item frames (and their use) in protected regions.
-- Added item frame destruction region flags (if you wish to disable item frame 
-    destruction completely).
-- (Re-)added support for priority R-tree region indexes. This means quicker region lookup,
-    and better support for servers with thousands of regions.
-- Improved /region info output for -g group flags.
-- Allowed removing of -g group flags with /region flag.
-- Allowed /region flag to set group and value at once.
-- Deleting a region flag now also deletes group flag.
-- Fixed detection of attack by projectiles to be more accurate.
-- Fixed support for saving non-string flags in the MySQL region support.
-- Fixed spurious comma in "Flags:" /region info output.
-- Fixed players who are not in god mode not receiving damage in PVP areas from
-    enderpearls.
-- Players will now be told that they are in a no-PvP area if they are in one and
-    attempting to attack someone, or that the player they are attacking is in a
-    no-PvP area, if that is the case instead.
-- Fixed an issue where region.getId() was lowercase'd each pass of a for loop in
-    MySQLDatabase.updatePoly2dPoints().
-- Fixed mob damage from projectiles not being properly blocked in regions where
-    applicable.
-- Changed default region wand to leather (#334).
-
-Thank you to the following individuals for their contribution:
-thvortex, Rutr, Glitchfinder, and DarthAndroid.
-
-5.5.4:
-- Minecraft 1.3 support.
-- Fixed /stack dupe bugs.
-- Added regions.use-creature-spawn-event.
-- Update for Async chat issue.
-- Add use flag to cakes.
-- Report number of plugins loaded in report writer.
-- Updated fireblal item blocking.
-- Fixed permissions for /region reload.
-
-5.5.3:
-- Added game mode flag.
-- Added item drop pickup flag to regions.
-- Added support for fireball item blocking (385).
-- Added configuration option to allow creature spawns from plugins.
-- Added host key check.
-- Added a new line split feature to region greetings.
-- Prevented commands in the allow commands list from being blocked and
-    vice versa.
-
-5.5.2:
-- Added potion-splash flag to block splash potions
-- Add entity-painting-destroy which can be used to prevent entities from destroying
-    paintings (skeletons firing arrows)
-- Added send-chat and receive-chat flags
-- Fixed having regions in multiple worlds with the same name not working with MySQL
-- A cancellable event is now fired if WorldGuard disallows PvP. (for developers!)
-- Made /region setparent check worldguard.region.setparent.own/member.<parent> instead
-    of worldguard.region.setparent.own/member.<child>.
-- Allowed passing #<index> in place of a region ID, where <index> is the index as
-    displayed by /region list.
-- Fixed an error that occured when clearing a non-existant region's parent.
-- Added a -s flag to /region teleport, which sends you to the spawn point instead of the
-    teleport point of a region.
-- Added region/role-based permissions to /region teleport.
-- BREAKING CHANGE: Added a LocationFlag class and made the teleport and spawn flags
-    use it.
-- /region info -s now selects the region being queried.
-- Added /region teleport <id>.
-- Vector flags can now be set to the current location with the value "here" and to a
-    specific position with x,y,z.
-- Made /region info show the region you're in if you don't specify an id explicitly.
-- Prevent block ignition from lightning strikes if lightning is blocked in region. Fixes
-    #1175
-- Correctly check both WEPIF and superperms in WorldGurdPlugin.broadcastNotification()
-- Destroy fire blocks when fire-spread is disallowed
-- Added a construct flag that can be used to restrict block placing/destroying in zones
-    to certain roles.
-- Added FallingSand to list of intensive entities to be removed with /halt-activiy.
-- Replaced all usage of CreatureType by EntityType.
-- Updated to support Bukkit 1.2-R0.3 and newer
-- Made auto-god-mode disabled by default again.
-- Added sign protection check disable.
-- Cleaned up javadoc, deprecated duplicate methods, other cleanup
-- Added a RegionGroupFlag to evey region flag Using the /region flag command with -g,
-    the region group that the region flag applies to can be set.
-
-5.5.1:
-- Fixed attacking with arrows from non-PVP to PVP areas
-- Compatibility with Bukkit 1.1-R5
-- Removed broken suppress-tick-sync-warnings config option. See bukkit.yml's setings.warn-on-overload option instead.
-- Add region and 'can build' information to CommandBook's /whois
-
-Contributions thanks to: NolanSyKinsley
-
-5.5:
-- Removed WorldEdit.jar from the classpath to stop conflicts with Bukkit's plugin loader
-- Now using Bukkit's tagged logging
-- Updated to new event system
-- Flush player flag state cache on world change
-- Improved compatibility with versions of CommandBook without GodComponent and updated pom dep for 2.0
-- Added MySQL region storage method.
-- Made explosions display their animations even when the event was blocked.
-- Added fallback support for those who don't have a version of CommandBook with GodComponent
-- Added LIGHTNING flag to DefaultFlag's flagsList Fixes #1026
-- Removed /god, /heal, /locate, and /stack from WorldGuard to CommandBook. CommandBook is now checked to see whether a player is godded.
-- Removed remaining usages of org.bukkit.util.config.Configuration
-- Removed some unused configuration options
-- Added permission worldguard.region.wand to the region wand
-- Fixed ProtectedRegion.compareTo.
-- Fixed FlatRegionManager.getApplicableRegions to return parent regions as well.
-- Added exp-drops flag to disable experience drops per-region.
-- Fixed some warnings.
-- Updated dependency version for WorldGuard from 5.0 to 5.1-SNAPSHOT.
-- Added support for fireballs shot by players being blocked by the PVP flag.
-- Now using dynamic command registration
-- Split off ender dragon block damage from creeper block damage.
-
-Contributions thanks to: narthollis, DarkArc, Wolvereness, and skeight
-
-5.4:
-- Fixed configuration generation on Windows
-- Fixed intersection calculation for regions
-- Fixed timer and feeding delay for food flags
-- Fixed region managers not being created properly (This caused errors related to CREATURE_SPAWN)
-- Added support for Minecraft 1.0.1 blocks
-- Added support for enchantments and tool damage (worldguard.stack.damaged is the node) with /stack
-- Made being in the wg-invincible group respect the configuration's auto-invincible setting
-- Added per-group region claim limit maximum
-- Added worldguard.region.addowner.unclaimed.* permission for non-economy region 'buying'
-- Checking allowed/blocked commands now occurs earlier to override more plugins
-- Made PVP flag check whether either player is in a pvp deny region for blocking
-
-Contributions thanks to: epuidokas, wizjany, Turtle9598, and DerFlash
-
-5.3:
-- Added new config options and flags to better handle explosions of all types
-- Added config options and flags for snow, ice, mushroom spread, grass spread,
-    and leaf decay
-- Added min and max health flags to clamp the values for the existing healing
-    flags
-- Added hunger flags similar to the existing healing flags
-- Added an option to disable the use of the move event. This can boost
-    performance on large servers but will disable the greeting/farewell
-    and entry/exit flags
-- Added flag to prevent pistons (including those that are outside the
-    region, but would affect blocks inside the region)
-- Added a /wg flushstates [player] command to free players stuck in a
-    region that was exit-deny but no longer exists or the flag was removed
-- Added a config option to disable xp orb dropping
-- Added config option to disable redstone wire obsidian generators
-- Added a vehicle-destroy flag
-- Added enderman protection config and flag
-- Allowed and blocked command flags will now fall back to the global region
-- The worldguard.region.flag.own/member permissions are now
-    worldguard.region.flag.regions.own/member! Please change your permissions
-    accordingly.
-- Made //stack respect max stack sizes unless the player has the
-    worldguard.stack.illegitimate permission
-- Setting invincibility flag to deny will override god mode unless the player
-    has worldguard.god.override-regions
-- The sleep flag will now prevent beds in the nether from
-    exploding if set to deny
-- Existing regions can no longer be accidentally overwritten.
-    Use /region redefine to move an existing region.
-- The info command will now sort players alphabetically
-- Priming TNT by punching it with flint and steal should throw a blacklist
-    event (consistent with old Minecraft versions)
-- The /stoplag command will now remove xp orbs
-- Permissions system will use per-world permissions if the provider supports it
-- Players in vehicles are now subject to entry/exit and greeting/farewell flags
-- Fixed interact blacklist event not logging correctly
-- Fixed heal flag taking effect half a block northeast of the region
-- Fixed a infinite sign dropping bug
-- Fixed players being able to douse fire by punching it in regions they
-    couldn't build it
-- Fixed players being able to eat protected cake
-- Fence gate usage can be blocked with the use flag
-- Fixed chests being unprotected when they should be in 1.8
-- Fixed weather config settings not applying when a world was loaded
-- Fixed explosion handling in certain cases
-- Fixed arrows working in non-pvp zones
-- Fixed buckets working on the border of protected regions in certain cases
-Contributions thanks to:
-wizjany, zml2008, imjake9, Droolio, epuidokas,
-EduardBaer, TomyLobo, and halvors
-
-5.2.2:
-- Changed configuration saving so empty lists will be added to
-    the configuration files.
-
-5.2.1:
-- Add region bounds to /region info
-- Added the ability to add owners/members to the global region for
-    handling guest groups. Now if there's owners or members on the global
-    region, then those  that are not on the list cannot build.
-- Fixed some flag algorithm issues.
-- API: Fixed DefaultDomain.size() not counting players.
-- API: Undeprecated ApplicableRegionSet.allows(StateFlag).
-
-5.2:
-- Gave the ability to use color colors and macros in greeting
-    and farewell messages.
-- Added disable-ice-melting, disable-snow-formation, disable-mushroom-spread,
-    disable-snow-melting, disable-ice-formation.
-- Added paintings to blacklist support.
-- Added default.disable-health-regain.
-- Added auto-invincible-permission setting, which lets you use the permission
-    'worldguard.auto-invincible' to become invincible on join automatically.
-- Flames won't appear if you are /god'ed now. 
-- Added blocked-cmds region flag to block commands.
-- Added allowed-cmds region flag to whitelist commands.
-- Added entry region flag to block entry. Use entry-group to determine who
-    this affects.
-- Added exit region flag to block exit. Use exit-group to determine who
-    this affects.
-- Made negative healing possible via the healing flag.
-- Changed the configuration header messages to be more helpful to new users.
-- Added a warning about modifying region files by hand.
-- Improved the API for plugin developers.
-
-5.1:
-- A lot of changes.
-
-4.0-alpha1:
-- This release is only to fix WorldGuard for Bukkit. Ignore the 4.0
-    label. Just move along. Nothing to see.
-
-3.2.2:
-- Changed disable-water-damage to disable-drowning-damage.
-- Fixed suffocation disable option.
-- Fixed fire spread blocking.
-- stopfire and allowfire now work in server console, just like in hMod.
-
-3.2.1:
-- Updated for recent Bukkit ItemStack change.
-
-3.2:
-- Added regions.default.pvp to control default PvP setting.
-- Updated WorldGuard for the newer builds of Bukkit.
-- Fixed creeper explosion blocking.
-- Added redstone support to sponges, removed classic water.
-- Fixed item durability disable for hoes.
-
-
-3.1.2:
-- Increased the priority of WorldGuard's event handling.
-
-3.1.1:
-- Fixed creeper and chest flag conflicting.
-
-3.1:
-- Added ability to disable chest protection. New configuration setting
-    (regions.build.chest-access) and new chest flag.
-- Possibly fixed projectile blocking in no-PvP zones.
-- Added /regionmembership permission that lets people only change
-    the owners and members of regions they own.
-
-3.0b2:
-- Fixed issue where built-in permissions were not (re)loaded.
-- Fixed /god not working for others.
-
-3.0b1:
-- Added parent-child relationships to regions.
-- Added global build flag.
-- Improved flag support.
-- Fixed no-PvP zone messages being sent to the wrong person.
-- Fixed commands so that they work in a recent version of Bukkit.
-- Fixed NullPointerException in explode hook.
-
-2.3.1:
-- Fixed various cast exceptions with the blacklist loggers.
-- Added checks for unchecked exceptions when resolving permissions.
-- Fixed the item durability disable setting changing the damage value on
-    an empty hand.
-
-2.3:
-- /god now works very well.
-- Item (TNT, flint and steel, etc.) blocking should now work.
-- The TNT blocking configuration variable should now work.
-- Re-added /heal (not sure where that went), added /slay.
-- Implemented contact damage disable toggle.
-- Made all player damage disabling configuration parameters work.
-- Fixed teleport-on-suffocation setting.
-- Added /locate <name>, /locate <x> <y> <z>, and /locate that lets you
-    program/change your compass bearing to point to a player's position
-    (not yet live), a position, or back to spawn.
-- Fixed CSVDatabase spitting an error if the owners list was empty.
-
-2.2:
-- Now supports GroupUsers.
-- Added support for blocking creeper explosions.
-- Fixed a bug where a player's groups were not being loaded correctly,
-    causing the blacklist group ignore option to not work.
-
-2.1.1:
-- Fixed fire spread disable preventing flint and steel too.
-- Fixed NullPointerException related to the player item event.
-- Made setup simpler.
-
-2.1:
-- Improved Bukkit support.
-
-2.0beta3:
-- Fixed NullPointerException inside the ignite hook.
-
-2.0beta2:
-- Fixed a NullPointerException in the damage hook.
-
-2.0beta1:
-- Added area protection. Use /region or /rg to define regions.
-
-1.8.1
-- Fixed NullPointerException.
-
-1.8
-- Updated for Minecraft beta.
-- Blacklist hooks have CHANGED. The new hooks are work better. on-create has
-    been replaced with on-place (for block placement) and on-use
-    (for item usage, light buckets and lighters). The old on-use is now
-    on-right-click although it currently does nothing.
-- Added coordinates to blacklist file logger.
-- Added suffocation damage prevention.
-
-1.7.1
-- Updated for v0.2.8.
-
-1.7
-- Updated for v0.2.6_02 and hMod b129.
-- Added option to prevent water from damaging particular blocks
-    (Redstone wire, Minecart tracks, etc.). See disable-water-damage-blocks.
-- /reload WorldGuard should now reload WorldGuard's configuration.
-- Added wg-invincible and wg-amphibious groups that let you give certain
-    players invincibility or underwater breathing.
-- Added the ability to disable fall, water, lava, and/or fire damage.
-- Water/lava bucket blocking should now be more reliable.
-- Added /stack (alias /;) commands to stack items in your inventory into
-    piles up to 64 items in size. Even unstackable items like signs can be
-    stacked.
-- /god mode should now let you gain health.
-- /god mode should now work more reliably.
-- Caught an error message for when the configuration file does not exist.
-
-1.6
-- Added spawn protection that prevents damage when a player spawns.
-- Added login protection that prevents damage when a player joins.
-- Added /god. /god can be used on others, provided that the /godother
-    permission is set for the command's user.
-
-1.5.1
-- Removed the 'java.lang.NoSuchMethodError: Item.setDamage(I)V' error
-    generated.
-
-1.5
-- Removed the block lag fix.
-- WorldGuard now conditionally loads features so you can use any up-to-date
-    build of hMod and the unsupported features won't break the entire
-    plugin. When WG loads, check the server console for a report of
-    features that are not supported by your version of hMod.
-- Changed some configuration defaults:
-    disable-lava-fire=true
-    simulate-sponge=true
-    item-durability=false
-
-1.4.1
-- Fixed issue with the block lag fix dropping item stacks of 0 quantity.
-
-1.4
-- New on-acquire hook. This does both a total inventory check on inventory
-    change and item pick up denial. The item pick up denial is largely
-    thanks to Dinnerbone for fulfilling my request to add a particular hook.
-- Item durability can now be toggled with item-durability. Thanks to
-    Dinnerbone for figuring this out while filfilling my request. The
-    default setting is to fix item durability.
-- New no-physics-gravel and no-physics-sand options allow you to
-    prevent gravel and sand from falling.
-- New allow-portal-anywhere option allows you to create portal blocks
-    anywhere.
-    
-1.3
-- UPGRADE WARNING: If you are using database logging, you must add a
-    NULL 'comment' VARCHAR field to the table. The line of SQL that you
-    can run for MySQL can be found in blacklist_table.sql.
-- Improved plugin compatibility with the block lag fix. For maximum
-    compatibility, you must now list WorldGuard as the first plugin in
-    server.properties and you cannot reload or enable the plugin
-    while the server is up. This is for bad plugins that unnecessarily
-    use the "critical" priority for its hooks like the LWC. Most plugins
-    don't do that though, so this won't apply for most people.
-- Fixed signs being blank if they were denied via the blacklist.
-- Added on-break event to the blacklist.
-- Added comments and messages. Comments are only for your own use and they
-    are printed with the log and notify actions of the blacklist. The
-    message replaces the message that is shown the user and it is optional.
-- The blacklist notification messages are now more compact and are
-    light grey instead of light purple.
-- The notify, log, and tell actions will now trigger every time for the
-    on-break, on-create, on-drop events rather than wait 3 seconds between
-    events for the same item or block for a player.
-
-1.2
-- /stopfire and /allowfire disable and enable fire spreading globally.
-- Block lag fix slightly improved in accuracy for item drops.
-- Sponge updated to remove water when the sponge block is set. Sponge radius
-    can now be controlled using the 'sponge-radius' parameter and the
-    default is now set to simulate Classic.
-- Updated for a newer build of "b126," meaning that lava spread control
-    now works well!
-- A new summary of the status of some core protections is now printed
-    on start. Disable this with 'summary-on-start'.
-- Blacklist system has been overhauled. Check README.txt for changed
-    configuration settings!
-- The blacklist's method of preventing notification repeats is now better,
-    instead waiting 3 seconds before notifying again (before it didn't
-    notify again at all unless the user started using another blocked
-    action).
-- To give users the ability to receive notifications, the command to give
-    permission to has been changed to /worldguardnotify, although the
-    old one (that was never mentioned anywhere) still works.
-- Water and lava buckets are now psuedo-blocked using an unreliable
-    method that risks the stability of your server (no other plugin
-    does it better though). Use it as your own risk.
-- Added on item drop and on item use (i.e. chest) events.
-- Chests, signs, and furnaces can now be blocked better with the
-    blacklist system.
-- The event names in the blacklist configuration have changed but the old
-    event names should still work. The new names should make "more sense."
-- A new "ban" action has been added to the blacklist.
-- Action messages have been improved, now longer saying "destroyed"
-    for everything.
-- Logging to file has been completely changed, allowing you to use
-    the date and time and the player's username in the log filename. It
-    no longer rotates log files based on size, however.
-- Logging to database is now supported.
-- Tools can now be destroyed on drop to alleviate the durability cheat.
-    You can do this with either with the blacklist or with the
-    'item-drop-blacklist' configuration option. The configuration option
-    prints more friendly messages than the 'tell' action of blacklists.
-
-1.1.2
-- Block lag fix: Snow and glass should no longer drop items.
-- Block lag fix: Block object now reset after hook call.
-
-1.1.1
-- Fixed redstone wire dropping wood blocks with the block lag fix.
-- The block lag fix now consults other plugins so that ALL protection
-    mechanisms and plugins should work.
-
-1.1
-- Added block lag fix.
-
-1.0
-- Initial release.

CONTRIBUTING.md

@@ -1,5 +1,4 @@
-Contributing
-============
+# Contributing
 
 Thank you for your interest in contributing to WorldGuard! We appreciate your 
 effort, but to make sure that the inclusion of your patch is a smooth process, we

INSTALL.md

@@ -0,0 +1,52 @@
+# New User Guide
+
+Thank you for installing WorldGuard! By default, when you first install WorldGuard, most features will be disabled until you enable the ones that you want to use.
+
+## Requirements
+
+You will need to be using [Bukkit](http://dl.bukkit.org/) for your server or one of its derivatives (such as Spigot or Cauldron). If you are using Minecraft Forge, you will have to use Cauldron in order to use WorldGuard.
+
+It is not possible to use WorldGuard with the plain vanilla server from Mojang.
+
+## Installation
+
+Installation is simple!
+
+1. Extract the `WorldGuard.jar` file and put it into your server's `plugins` folder. If the folder does not exist yet, you can create it yourself.
+2. Run the Bukkit server.
+3. Look inside `plugins/WorldGuard` and configure the plugin as necessary. There are also in-game commands.
+
+By default, only "ops" can use WorldGuard commands. If you install a permissions plugin, then you can assign fine grained permissions to your server's trusted users.
+
+## Documentation
+
+To learn how to use WorldGuard, check out [the wiki](http://wiki.sk89q.com/wiki/WorldGuard).
+
+## Frequently Asked Questions
+
+### How do I protect my spawn?
+
+Check out the [region protection tutorial](http://wiki.sk89q.com/wiki/$%7Bproject.name%7D/Regions/Tutorial) on the wiki.
+
+### Players can't do anything!
+
+WorldGuard will typically not block something without also telling the user that he or she does not have permission. Please make sure that it's not another plugin that is preventing players from interacting with the world.
+
+Also, be aware that spawn protection is a feature of vanilla Minecraft and you must disable that in `bukkit.yml`. It only allows ops to do anything in a specified radius around the world's spawn point.
+
+### I made a region but anyone can build in it!
+
+1. If players get a "you can't do that here" message but they are still able to build, it's because another plugin is likely undoing the protection offered by WorldGuard.
+2. If no message is being sent, make sure that there is a region where you think one is. 
+
+### Where can I ask questions?
+
+You can [ask questions on our forum](http://forum.sk89q.com) or visit us on IRC (irc.esper.net #sk89q).
+
+### Where can I file a bug report or request a feature?
+
+Visit our [issue tracker](http://youtrack.sk89q.com/dashboard). It's also used for WorldEdit and our other projects.
+
+### Is WorldGuard open source?
+
+Yes! [View the source code on GitHub](https://github.com/sk89q/worldguard).

LICENSE.txt

@@ -1,6 +1,3 @@
-----------------------------------------------------------------------------
-WorldGuard License
-----------------------------------------------------------------------------
 
                    GNU LESSER GENERAL PUBLIC LICENSE
                        Version 3, 29 June 2007
@@ -169,8 +166,9 @@ permanent authorization for you to choose that version for the
 Library.
 
 ----------------------------------------------------------------------------
-PRTree License
-----------------------------------------------------------------------------
+
+This work includes Robert Olofsson's Priority R-Tree implementation, for which
+its license is reproduced below.
 
 Copyright (c) 2008-2010 Robert Olofsson.
 All rights reserved. 

README.html

@@ -1,232 +0,0 @@
-<!DOCTYPE html>
-<html>
-<head>
-<title>${project.name} ${version}</title>
-<link href="http://fonts.googleapis.com/css?family=Source+Sans+Pro:400,700|Ropa+Sans" rel="stylesheet" type="text/css">
-<style>
-body {
-    margin: 0;
-    padding: 3em 1em;
-    background: #efefef;
-    color: #333;
-    line-height: 1.5;
-}
-#wrapper {
-    width: 600px;
-    margin: auto;
-}
-body, th, td, input {
-    font: 14px 'Source Sans Pro', Arial, sans-serifsans-serif;
-}
-.section {
-	background: #fff;
-	position: relative;
-	padding: 2em 2.4em;
-	margin: 3em auto 4em auto;
-    width: 80%;
-    -webkit-box-shadow: 0 1px 4px rgba(0, 0, 0, 0.1);
-    -moz-box-shadow: 0 1px 4px rgba(0, 0, 0, 0.1);
-    box-shadow: 0 1px 4px rgba(0, 0, 0, 0.1);
-}
-.section:before, .section:after {
-	content: "";
-	position: absolute;
-	z-index: -2;
-}
-.section {
-    -moz-border-radius: 4px;
-    border-radius: 4px;
-}
-.section:before, .section:after {
-	bottom: 15px;
-	left: 10px;
-	width: 50%;
-	height: 20%;
-	max-width: 300px;
-	max-height: 100px;
-    -webkit-box-shadow: 0 15px 10px rgba(0, 0, 0, 0.5);
-    -moz-box-shadow: 0 15px 10px rgba(0, 0, 0, 0.5);
-    box-shadow: 0 15px 10px rgba(0, 0, 0, 0.5);
-    -webkit-transform: rotate(-1deg);
-    -moz-transform: rotate(-1deg);
-    -ms-transform: rotate(-1deg);
-    -o-transform: rotate(-1deg);
-    transform: rotate(-1deg);
-}
-.section:after {
-    right: 10px;
-    left: auto;
-    -webkit-transform: rotate(1deg);
-    -moz-transform: rotate(1deg);
-    -ms-transform: rotate(1deg);
-    -o-transform: rotate(1deg);
-    transform: rotate(1deg);
-}
-a:link, a:visited {
-    color: #0004b2;   
-    text-decoration: none;
-}
-a:hover {
-    color: #ac0000;
-    text-decoration: none;
-    border-bottom: 1px solid #999;
-}
-h1 {
-    font: 2.7em 'Ropa Sans', 'Trebuchet MS', Helvetica, Arial, sans-serif;
-    color: #000;
-    margin: 0 0;
-    padding: 0 0 0.2em 0;
-    font-weight: normal;
-    text-align: center;
-    text-shadow: 2px 2px #FFF;
-}
-h2 {
-    font-size: 1.3em;
-    color: #FFF;
-    margin: -2.5em 0 0.8em 0;
-    float: left;
-    background: #0049FF;
-    padding: 0.4em 0.8em;
-    border-radius: 0.2em;
-    font-weight: normal;
-    text-align: center; 
-}
-h3 {
-    text-transform: uppercase;
-    font-weight: bold;
-}
-h2 + * {
-    clear: both;
-}
-@media (max-width: 650px) {
-    #wrapper {
-        width: 100%;
-    }
-}
-</style>
-</head>
-<body>
-
-<div id="wrapper">
-    <h1>${project.name} ${version}</h1>
-    <div class="section">
-        <h2>Getting Started</h2>
-        <p>
-            Thanks for choosing ${project.name}! When you first install ${project.name},
-            nothing will be enabled, so you will need to switch on the features
-            that you need to use, whenever it is convenient for you.
-        </p>
-        <ul>
-            <li><a href="http://wiki.sk89q.com/wiki/${project.name}/Installation">How do I install ${project.name}?</a></li>
-            <li><a href="http://wiki.sk89q.com/wiki/${project.name}/Upgrading">How do I update ${project.name}?</a></li>
-            <li><a href="http://wiki.sk89q.com/wiki/${project.name}#Usage">How do I use ${project.name}?</a></li>
-        </ul>
-        <p>
-            Need help?
-            <a href="http://wiki.sk89q.com/wiki/${project.name}/Support">See the ways that you can get assistance</a>.
-        </p>
-    </div>
-    <div class="section">
-        <h2>Common Issues</h2>
-        
-        <h3>What are the other files that come with the download?</h3>
-        <p>
-            Inside the folder "contrib" of the download are the following files:
-        </p>
-        <ul>
-            <li>blacklist_table.sql is for using a database with the 
-              <a href="http://wiki.sk89q.com/wiki/${project.name}/Blacklist">blacklist feature</a>.</li>
-            <li>region_storage.sql is for using a database with the
-                <a href="http://wiki.sk89q.com/wiki/${project.name}/Regions">region protection feature</a>.</li>
-            <li>region_storage_update_20110325.sql is for updating your region protection
-                database (if you're using it) if your database was made before March 25, 2011.</li>
-        </ul>
-        
-        <h3>${project.name} doesn't seem to work.</h3>
-        <p>
-            Two common mistakes include forgetting to install WorldEdit
-            (${project.name} needs it), or making
-            a syntax error in one of ${project.name}'s configuration files (this is very
-            fatal unfortunately, and can be caused by a single character typed in the wrong place). Try 
-            <a href="http://wiki.sk89q.com/wiki/${project.name}/Support">asking in IRC</a>
-            to see whether anyone can help you.
-        </p>
-        
-        <h3>How do I protect my spawn, or another area?</h3>
-        <p>
-            Read the <a href="http://wiki.sk89q.com/wiki/${project.name}/Regions/Tutorial">area protection tutorial</a>
-            on our wiki. For more detailed information, be sure to read about
-            <a href="http://wiki.sk89q.com/wiki/WorldGuard/Regions">region protection on the wiki</a>. Note
-            that if you can't build in spawn, don't forget that Minecraft comes with its own
-            limited spawn protection that you have to disable (see below).
-        </p>
-        
-        <h3>I or others don't have permission to build.</h3>
-        <p>
-            Unless you copied configuration files from an older installation of 
-            ${project.name}, your problem is either caused by another plugin, or by not
-            disabling the built-in spawn protection of the Minecraft server.
-        </p>
-        
-        <h3>No one can build in a region I made!</h3>
-        <p>
-            Make sure that:
-        </p>
-        <ul>
-            <li>You didn't change the 'build' flag, because protection is on by default
-                when a new region is made. Setting the build flag to 'deny' means that
-                no one can modify the things inside the region.</li>
-            <li>That you added the player as an owner or member of the region. If you are using
-                a group (g:groupName), you may have to give the group the permission of
-                group.groupName for ${project.name} to recognize it.</li>
-            <li>That you disabled spawn protection. The Minecraft server has an automatic
-                spawn protection feature where only 'ops' can build in a definable
-                radius around spawn (by default, it is 16 blocks). If you are on Minecraft
-                1.4 or newer, edit "spawn-protection" in server.properties; otherwise, modify bukkit.yml
-                and change the spawn-radius setting.</li>
-            <li>That it's not another plugin causing you trouble. The error messages of ${project.name} are of
-                a dark red shade. If the color of the "no permission" message is not
-                that color, it is not ${project.name}.</li>
-        </ul>
-        
-        <h3>Everyone can build in a region I made!</h3>
-        <p>
-            Make sure that:
-        </p>
-        <ul>
-            <li>You didn't change the 'build' flag, because protection is on by default
-                when a new region is made. Setting the build flag to 'allow' means that
-                anyone can modify the things inside the region.</li>
-            <li>That it's not caused by another plugin. If players are getting a dark red
-                permission denied message, but they can still build, another plugin
-                is likely causing the conflict.</li>
-        </ul>
-        
-        <h3>Where do I report bugs or suggest ideas?</h3>
-        <p>
-            Make sure you are using the latest version of ${project.name}, try asking in
-            IRC first (see "Need help?" above) if it's a problem, and if you think you've
-            found a bug or have a great suggestion to provide, please
-            report it to <a href="http://youtrack.sk89q.com/issues/WORLDGUARD">our issue tracker</a>.
-        </p>
-        
-        <p>
-            Still need help?
-            <a href="http://wiki.sk89q.com/wiki/${project.name}/Support">See the ways that you can get assistance</a>.
-        </p>
-    </div>
-    <div class="section">
-        <h2>Contributing</h2>
-        <p>
-            Did you know that ${project.name} is open source? That means that you can
-            read the code and learn from it, as well as modify it and submit back
-            changes to help the community!
-        </p>
-        <ul>
-            <li><a href="https://github.com/sk89q/worldguard">View the source code</a></li>
-            <li><a href="http://wiki.sk89q.com/wiki/${project.name}/Development">More information</a></li>
-        </ul>
-    </div>
-</div>
-</body>
-</html>

README.md

@@ -1,38 +1,46 @@
-![WorldGuard](http://static.sk89q.com/readme/worldguard.png)
-==========
+# ![WorldGuard](http://static.sk89q.com/readme/worldguard-new.png)
 
-WorldGuard is a toolbox of various functions, useful for multiplayer servers, that lets you:
+WorldGuard lets you and players guard areas of land against griefers and undesirables, as well as tweak and disable various gameplay features of Minecraft.
 
-* Protect your server from a number of problems.
-* Block fire spread, lava spread, endermen, and more.
-* Flag areas as "no PVP" or "no TNT."
-* Assign ownership to areas so only selected individuals can build.
-* Use a number of useful commands.
+* Block creeper and wither block damage, falling damage, etc.;
+* Disable fire spread, lava fire spread, ice formation, Endermen picking up blocks, etc.;
+* Blacklist certain items and blocks so they can't be used;
+* Warn moderators when certain items and blocks are used;
+* Protect areas of your world so only certain people can build in them;
+* Set areas where PVP, TNT, mob damage, and other features are disabled;
+* Protect your server from various 'exploits' like magical obsidian creation machines;
+* Disable, or enable, various Minecraft features, like sponges from classic;
+* Add useful commands like an immediate "STOP ALL FIRE SPREAD" command.
+* Enable only features you want! Everything is off by default.
 
-WorldGuard is open source and is available under the GNU General Public License v3.
+WorldGuard is open source and is available under the GNU Lesser
+General Public License v3.
+
+Currently, Bukkit is required to use WorldGuard. You can get a release copy of WorldGuard from the [BukkitDev site](http://dev.bukkit.org/bukkit-plugins/worldguard/).
 
 Compiling
 ---------
 
-The project is written for Java 6 and our build process makes use of [Maven](http://maven.apache.org). Detailed compilation information [can be found on the wiki](http://wiki.sk89q.com/wiki/WorldGuard/Development#Compiling).
+The project is written for Java 6 and our build process makes use of
+[Maven](http://maven.apache.org). Detailed compilation information
+[can be found on the wiki](http://wiki.sk89q.com/wiki/WorldGuard/Development#Compiling).
 
 Dependencies are automatically handled by Maven.
 
 Contributing
 ------------
 
-We happily accept contributions, especially through pull requests on GitHub. Submissions 
-must be licensed under the GNU General Public License v3.
+We happily accept contributions, especially through pull requests on GitHub.
 
 Please read CONTRIBUTING.md for important guidelines to follow.
 
-We recommend following our [mailing list](https://groups.google.com/d/forum/sk-dev-discuss), especially if you have some big ideas that you want to implement.
+Submissions must be licensed under the GNU Lesser General Public License v3.
 
 Links
 -----
 
-* [Mailing list](https://groups.google.com/d/forum/sk-dev-discuss)
+* [Homepage](http://enginehub.org/worldguard)
 * [IRC channel](http://skq.me/irc/irc.esper.net/sk89q/) (#sk89q on irc.esper.net)
 * [Issue tracker](http://youtrack.sk89q.com/issues/WORLDGUARD)
-* [Continuous integration](http://builds.enginehub.org) [![Build Status](https://secure.travis-ci.org/sk89q/worldguard.png)](http://travis-ci.org/sk89q/worldguard)
-* [End-user documentation](http://wiki.sk89q.com/wiki/WorldGuard)
+* [Continuous integration](http://builds.enginehub.org)
+* [End-user documentation](http://wiki.sk89q.com/wiki/WorldGuard)

UPGRADE.md

@@ -0,0 +1,143 @@
+# Upgrading to WorldGuard 6
+
+Version 6 is a __MAJOR UPGRADE__ to WorldGuard so we recommend:
+
+* Making backups of your worlds
+* Making backups of your WorldGuard configuration
+
+(Periodical backups are recommended anyway.)
+
+You can upgrade from any version of WorldGuard 5.
+
+It is __NOT POSSIBLE TO DOWNGRADE__ after upgrading to WorldGuard 6 without loss of data due to the conversion to UUIDs. Do NOT downgrade WorldGuard once you have installed version 6.
+
+If downgrading becomes necessary, please file a ticket on our issue tracker.
+
+If this is a __BETA BUILD__ or __SNAPSHOT BUILD__, then you should re-read this document every new release until after you have upgraded to a final release. Breaking changes may be added until the final release.
+
+You have downloaded version ${project.version}.
+
+## Reporting problems
+
+You can report bugs that you encounter on our [issue tracker](http://youtrack.sk89q.com) and [ask questions on our forum](http://forum.sk89q.com).
+
+## Breaking changes
+
+Be aware of these breaking changes:
+
+* Children regions now inherit from their parent even if there is no overlap.
+* MySQL support now features the ability to migrate tables. If you are using tables without a prefix, then the new migration code should be able to handle your table. However, if you are using a table prefix, you may encounter trouble with migration.
+* Protection is now a lot more exhaustive so it is no longer, for example, possible to fling sand into a region, grow trees into a region, and so on.build
+* The `USE` flag is now much more encompassing so you may find that it blocks things like CraftBook gates (for users of CraftBook). To fix that, you can do `/rg flag REGION_NAME use allow`, but be aware that that will also allow the opening of inventories. To block inventories specifically, use `/rg flag REGION_NAME chest-access deny -g nonmembers`. The `-g nonmembers` makes it so only non-members of the region are unable to use chests, but this is optional.
+* If you want to blacklist only water and lava blocks and not buckets, you can no longer apply `on-place` to water or lava blocks because it will also deny the use of buckets. If you wish to deny the use of just the liquid blocks, use `on-use`. This is because WorldGuard now considers the use of a bucket also the placement of a liquid block.
+* In the rare situation that you are user of the "auto-invincibility" and "auto-no-drowning" groups (`wg-invincible` and `wg-amphibious`), you now have to enable these features in the config (`auto-invincible-group: true` and `auto-no-drowning-group: true`). This is because some permission plugins have been causing severe hang ups whenever it is queried for a player's groups, which, in this case, happens to include when the player joins.
+* Plugins that utilize WorldGuard's API may not work anymore. They may crash with errors.
+
+## Incompatibility issues
+
+* Spigot:
+    * `settings.global-api-cache`, if enabled, will crash WG UUID lookups (fixed in Spigot build #1625)
+* EchoPet
+    * Can't spawn pets ([issue #393](https://github.com/DSH105/EchoPet/issues/393))
+* CraftBook
+    * Unable to use mechanics unless the `USE` flag is explicitly set to `ALLOW` ([CRAFTBOOK-3057](http://youtrack.sk89q.com/issue/CRAFTBOOK-3057))
+    
+
+## Major features
+
+### UUID support
+
+Regions now fully support the use of UUIDs rather than names for storing the owners and members of a region. Commands still accept names, but they are translated into UUIDs in the background. For users who already have existing region data, names will be automatically converted to UUIDs on the first run of WorldGuard.
+
+It is still possible to specify names rather than a UUID by using the `-n` flag with the region membership commands.
+
+### 'Deny by default'
+
+Previously, a pre-determined list of blocks and entities was used to determine whether an action by the player should be blocked. However, this has been reversed so that every action on a block or entity is denied (in a protected region) unless it has been deemed safe (such as, for example, right clicking with steak). Mods are now supported as a result.
+
+The `USE` flag has been repurposed as a general "interaction" flag and covers every left click or right click of a block or entity. It also covers interaction that falls outside clicking.
+
+### Exhaustive protection
+
+More events are now handled in the protection code. For example,
+
+* It is no longer possible to drop sand or gravel into a protected region from outside.
+* It is no longer possible to grief a region by growing a tree into it.
+* The entry and exit flags now handle players sitting on vehicles properly.
+* Piston-moved blocks cannot be pushed into a different protected region.
+* Owners of tamable animals are now considered in protection code.
+
+Even water and lava flow can also be checked, although this requires that it be explicitly enabled in the configuration (flow events are very frequent, so they incur extra CPU cost).
+
+The goal is to provide extremely exhaustive protection.
+
+### Large performance boost for spatial queries
+
+The performance of spatial queries for regions has been substantially increased at least an order of magnitude. Spatial queries are a necessity for the region code to query the list of regions that apply to a location in the world. There should be a negligible difference between 4, 40, and 4000 regions as long as too many regions are not overlapping.
+
+### Background region operations
+
+Region commands are now executed in the background. Notably, saves and loads will not lock up your server while they complete. Additionally, changes to regions are now saved periodically rather than immediately after every change.
+
+### Updated MySQL region support
+
+MySQL support has been completely overhauled. It should now be faster, no longer crash on foreign key index errors, use transactions, and support automatic creation and migration of tables (including support for table prefixes).
+
+### Partial region data saving
+
+For users of MySQL, WorldGuard now only saves changed and deleted regions when saving region data. No longer does WorldGuard have to rewrite the entire region database on each save.
+
+### Improved handling of related flags
+
+Multiple flags that apply to an event are now evaluated together if they are similar. For example, if a player right clicks a bed to sleep in it, both the `USE` and `SLEEP` flag are checked since they are both interaction-related. If one of them is `DENY`, then sleeping is denied (remember, `DENY` overrides `ALLOW`). If one of them is `ALLOW` and the other is not `DENY`, then sleeping is permitted.
+
+### Flag groups now work properly
+
+While you could always set a group to a flag's value, the functionality was incomplete and did not work most of the time.
+
+Now that groups are supported, you can change a flag so it only applies to a certain group of players. For example, `/rg flag example sleep deny -g members` would deny sleeping for only members of the `example` region.
+
+### Inheritance now works as expected
+
+Previously, a region only inherited flags and other details from its parents if the parent and the child overlapped at the location queried. This is no longer the case and inheritance is now always applied. 
+
+In addition, a new `-g` flag for `/rg define` lets you create a region with no physical area so that you can assign flags and use this region as a "template region."
+
+### Settable deny message
+
+It is now possible to change the message that users get when they are prevented from interacting with blocks or entities. This message is defined as a region flag, so you can set it on the `__global__` region or override it in a specific region. In addition, the tone and color of the default message has been softened, but you are free to change it entirely.
+
+### Blacklist support for data values (and later, variants)
+
+The blacklist was rewritten to support more than just block and item IDs. The immediate result is that you can now use data values, but as those are in the process of being deprecated by Mojang, it also allows support for Minecraft's new block variants in the future.
+
+### Debounced events
+
+Events that tend to reoccur very frequently (such as the ones that occur when you stand on a pressure plate continuously) have been "debounced" to reduce the number of checks that WorldGuard has to perform, reducing the amount of wasted CPU. In addition, the "you don't have permission" message is rate limited so players are not flooded with the message.
+
+### New block place and break flags
+
+A long requested feature was the availability of block place and break flags. These newly added flags work in tandem with the `BUILD` flag but can override `BUILD`. At the moment, it is not possible to allow explicit types of blocks to be placed or broken yet.
+
+### Build permission nodes
+
+A new optional (disabled by default in the configuration) feature is the checking of build permission nodes. For every block, entity, and item, the following permission nodes are checked:
+
+* Block place: `worldguard.build.block.place.<material>`
+* Block break: `worldguard.build.block.remove.<material>`
+* Block interact: `worldguard.build.block.interact.<material>`
+* Entity spawn: `worldguard.build.entity.place.<type>`
+* Entity destroy: `worldguard.build.entity.remove.<type>`
+* Entity interact: `worldguard.build.entity.interact.<type>`
+* Entity damage: `worldguard.build.entity.damage.<type>`
+* Item use: `worldguard.build.item.use.<material>`
+
+In addition, the permissions are also checked in the style of `worldguard.build.block.<material>.<action>`, so `worldguard.build.block.<material>.place` would work too.
+
+The list of usable material names comes from the [Material enumeration in Bukkit](http://jd.bukkit.org/rb/apidocs/org/bukkit/Material.html). For example, the permission for placing the bed block would be `worldguard.build.build.place.bed_block`. Be aware that _Material_ contains both item and block names.
+
+For entity names, see [EntityType](http://jd.bukkit.org/rb/apidocs/org/bukkit/entity/EntityType.html).
+
+# Other changes
+
+The rest of the changes can be found in the CHANGELOG file.

config/assembly/default.xml

@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ WorldGuard, a suite of tools for Minecraft
+  ~ Copyright (C) sk89q <http://www.sk89q.com>
+  ~ Copyright (C) WorldGuard team and contributors
+  ~
+  ~ This program is free software: you can redistribute it and/or modify it
+  ~ under the terms of the GNU Lesser General Public License as published by the
+  ~ Free Software Foundation, either version 3 of the License, or
+  ~ (at your option) any later version.
+  ~
+  ~ This program is distributed in the hope that it will be useful, but WITHOUT
+  ~ ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+  ~ FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+  ~ for more details.
+  ~
+  ~ You should have received a copy of the GNU Lesser General Public License
+  ~ along with this program. If not, see <http://www.gnu.org/licenses/>.
+  -->
+
+<assembly
+  xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2 http://maven.apache.org/xsd/assembly-1.1.2.xsd">
+  <includeBaseDirectory>false</includeBaseDirectory>
+  <formats>
+    <format>tar.gz</format>
+    <format>tar.bz2</format>
+    <format>zip</format>
+  </formats>
+  <files>
+    <file>
+      <source>${project.build.directory}/${artifactId}-${project.version}.jar</source>
+      <outputDirectory>/</outputDirectory>
+      <filtered>false</filtered>
+    </file>
+    <file>
+      <source>${project.build.directory}/CHANGELOG.html</source>
+      <outputDirectory>/</outputDirectory>
+      <filtered>true</filtered>
+    </file>
+    <file>
+      <source>${project.build.directory}/INSTALL.html</source>
+      <destName>README.html</destName>
+      <outputDirectory>/</outputDirectory>
+      <filtered>true</filtered>
+    </file>
+    <file>
+      <source>${project.build.directory}/UPGRADE.html</source>
+      <destName>READ_BEFORE_UPGRADING_FROM_V5.html</destName>
+      <outputDirectory>/</outputDirectory>
+      <filtered>true</filtered>
+    </file>
+  </files>
+  <fileSets>
+    <fileSet>
+      <includes>
+        <include>contrib/blacklist_table.sql</include>
+        <include>contrib/region_manual_update_20110325.sql</include>
+      </includes>
+    </fileSet>
+  </fileSets>
+</assembly>

config/checkstyle/header.txt

@@ -0,0 +1,18 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */

config/checkstyle/import-control.xml

@@ -0,0 +1,40 @@
+<!--
+  ~ WorldGuard, a suite of tools for Minecraft
+  ~ Copyright (C) sk89q <http://www.sk89q.com>
+  ~ Copyright (C) WorldGuard team and contributors
+  ~
+  ~ This program is free software: you can redistribute it and/or modify it
+  ~ under the terms of the GNU Lesser General Public License as published by the
+  ~ Free Software Foundation, either version 3 of the License, or
+  ~ (at your option) any later version.
+  ~
+  ~ This program is distributed in the hope that it will be useful, but WITHOUT
+  ~ ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+  ~ FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+  ~ for more details.
+  ~
+  ~ You should have received a copy of the GNU Lesser General Public License
+  ~ along with this program. If not, see <http://www.gnu.org/licenses/>.
+  -->
+
+<!DOCTYPE import-control PUBLIC
+    "-//Puppy Crawl//DTD Import Control 1.1//EN"
+    "http://www.puppycrawl.com/dtds/import_control_1_1.dtd">
+
+<import-control pkg="com.sk89q">
+  <allow pkg="java"/>
+  <allow pkg="javax"/>
+  <allow pkg="org.junit"/>
+  <allow pkg="junit"/>
+  <allow pkg="org.mockito"/>
+  <allow pkg="org.hamcrest"/>
+  <allow pkg="com.sk89q"/>
+  <allow pkg="org.enginehub"/>
+  <allow pkg="org.bukkit"/>
+  <allow pkg="org.yaml.snakeyaml"/>
+  <allow pkg="au.com.bytecode.opencsv"/>
+  <allow pkg="org.khelekore.prtree"/>
+  <allow pkg="com.google.common"/>
+  <allow pkg="com.jolbox.bonecp"/>
+  <allow pkg="org.flywaydb.core"/>
+</import-control>

config/markdown/footer.html

@@ -0,0 +1,3 @@
+</div>
+</body>
+</html>

config/markdown/header.html

@@ -0,0 +1,368 @@
+<!DOCTYPE html>
+<html>
+<head>
+<title>WorldGuard - titleToken</title>
+<style>
+body {
+  margin: 0;
+  padding: 2em 2em 3em 2em;
+  color: #333;
+  font-family: "Helvetica Neue", Helvetica, "Segoe UI", Arial, freesans, sans-serif;
+  font-size: 15px;
+  line-height: 1.5;
+  word-wrap: break-word;
+}
+
+.wrapper {
+  margin: auto;
+  max-width: 750px;
+}
+
+a {
+  background: transparent;
+}
+
+a:active,
+a:hover {
+  outline: 0;
+}
+
+strong {
+  font-weight: bold;
+}
+
+h1 {
+  font-size: 2em;
+  margin: 0 0 0.67em 0;
+}
+
+img {
+  border: 0;
+}
+
+hr {
+  -moz-box-sizing: content-box;
+  box-sizing: content-box;
+  height: 0;
+}
+
+pre {
+  overflow: auto;
+}
+
+code,
+pre {
+  font-family: monospace, monospace;
+  font-size: 1em;
+}
+
+table {
+  border-collapse: collapse;
+  border-spacing: 0;
+}
+
+td,
+th {
+  padding: 0;
+}
+
+* {
+  -moz-box-sizing: border-box;
+  box-sizing: border-box;
+}
+
+a {
+  color: #4183c4;
+  text-decoration: none;
+}
+
+a:hover,
+a:focus,
+a:active {
+  text-decoration: underline;
+}
+
+hr {
+  height: 0;
+  margin: 15px 0;
+  overflow: hidden;
+  background: transparent;
+  border: 0;
+  border-bottom: 1px solid #ddd;
+}
+
+hr:before,
+hr:after {
+  display: table;
+  content: " ";
+}
+
+hr:after {
+  clear: both;
+}
+
+blockquote {
+  margin: 0;
+}
+
+ul,
+ol {
+  padding: 0;
+  margin-top: 0;
+  margin-bottom: 0;
+}
+
+ol ol {
+  list-style-type: lower-roman;
+}
+
+dd {
+  margin-left: 0;
+}
+
+code,
+pre {
+  font-family: Consolas, "Liberation Mono", Menlo, Courier, monospace;
+  font-size: 12px;
+}
+
+pre {
+  margin-top: 0;
+  margin-bottom: 0;
+}
+
+*:first-child {
+  margin-top: 0 !important;
+}
+
+*:last-child {
+  margin-bottom: 0 !important;
+}
+
+.anchor {
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  left: 0;
+  display: block;
+  padding-right: 6px;
+  padding-left: 30px;
+  margin-left: -30px;
+}
+
+.anchor:focus {
+  outline: none;
+}
+
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+  position: relative;
+  margin-top: 1.5em;
+  margin-bottom: 16px;
+  font-weight: bold;
+  line-height: 1.4;
+}
+
+h1 {
+  padding-bottom: 0.3em;
+  font-size: 2.1em;
+  line-height: 1.2;
+  border-bottom: 1px solid #eee;
+}
+
+h2 {
+  padding-bottom: 0.3em;
+  font-size: 1.65em;
+  line-height: 1.225;
+  border-bottom: 1px solid #eee;
+}
+
+h3 {
+  font-size: 1.2em;
+  line-height: 1.43;
+}
+
+h4 {
+  font-size: 1.1em;
+}
+
+h5 {
+  font-size: 1em;
+}
+
+h6 {
+  font-size: 1em;
+  color: #777;
+}
+
+p,
+blockquote,
+ul,
+ol,
+dl,
+table,
+pre {
+  margin-top: 0;
+  margin-bottom: 16px;
+}
+
+hr {
+  height: 4px;
+  padding: 0;
+  margin: 16px 0;
+  background-color: #e7e7e7;
+  border: 0 none;
+}
+
+ul,
+ol {
+  padding-left: 2em;
+}
+
+ol ol,
+ol ul {
+  margin-top: 0;
+  margin-bottom: 0;
+}
+
+li>p {
+  margin-top: 16px;
+}
+
+dl {
+  padding: 0;
+}
+
+dl dt {
+  padding: 0;
+  margin-top: 16px;
+  font-size: 1em;
+  font-style: italic;
+  font-weight: bold;
+}
+
+dl dd {
+  padding: 0 16px;
+  margin-bottom: 16px;
+}
+
+blockquote {
+  padding: 0 15px;
+  color: #777;
+  border-left: 4px solid #ddd;
+}
+
+blockquote>:first-child {
+  margin-top: 0;
+}
+
+blockquote>:last-child {
+  margin-bottom: 0;
+}
+
+table {
+  display: block;
+  width: 100%;
+  overflow: auto;
+  word-break: normal;
+  word-break: keep-all;
+}
+
+table th {
+  font-weight: bold;
+}
+
+table th,
+table td {
+  padding: 6px 13px;
+  border: 1px solid #ddd;
+}
+
+table tr {
+  background-color: #fff;
+  border-top: 1px solid #ccc;
+}
+
+table tr:nth-child(2n) {
+  background-color: #f8f8f8;
+}
+
+img {
+  max-width: 100%;
+  -moz-box-sizing: border-box;
+  box-sizing: border-box;
+}
+
+code {
+  padding: 0;
+  padding-top: 0.2em;
+  padding-bottom: 0.2em;
+  margin: 0;
+  font-size: 85%;
+  background-color: rgba(0,0,0,0.04);
+  border-radius: 3px;
+}
+
+code:before,
+code:after {
+  letter-spacing: -0.2em;
+  content: "\00a0";
+}
+
+pre>code {
+  padding: 0;
+  margin: 0;
+  font-size: 100%;
+  word-break: normal;
+  white-space: pre;
+  background: transparent;
+  border: 0;
+}
+
+.highlight {
+  margin-bottom: 16px;
+}
+
+.highlight pre,
+pre {
+  padding: 16px;
+  overflow: auto;
+  font-size: 85%;
+  line-height: 1.45;
+  background-color: #f7f7f7;
+  border-radius: 3px;
+}
+
+.highlight pre {
+  margin-bottom: 0;
+  word-break: normal;
+}
+
+pre {
+  word-wrap: normal;
+}
+
+pre code {
+  display: inline;
+  max-width: initial;
+  padding: 0;
+  margin: 0;
+  overflow: initial;
+  line-height: inherit;
+  word-wrap: normal;
+  background-color: transparent;
+  border: 0;
+}
+
+pre code:before,
+pre code:after {
+  content: normal;
+}
+</style>
+</head>
+<body>
+<div class="wrapper">

contrib/region_manual_update_20110325.sql

@@ -1,3 +1,11 @@
+--
+-- This file only needs to be run if you are using a very old version
+-- of the region database (before 2011/03/25).
+--
+-- Otherwise, WG knows how to update your tables automatically, as well
+-- as set them up initially.
+--
+
 SET @OLD_UNIQUE_CHECKS=@@UNIQUE_CHECKS, UNIQUE_CHECKS=0;
 SET @OLD_FOREIGN_KEY_CHECKS=@@FOREIGN_KEY_CHECKS, FOREIGN_KEY_CHECKS=0;
 SET @OLD_SQL_MODE=@@SQL_MODE, SQL_MODE='TRADITIONAL';

pom.xml

@@ -2,7 +2,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.sk89q</groupId>
   <artifactId>worldguard</artifactId>
-  <version>5.9.1-SNAPSHOT</version>
+  <version>6.0.0-beta-02</version>
   <packaging>jar</packaging>
   
   <!-- Project information -->
@@ -65,10 +65,6 @@
       <id>sk89q-repo</id>
       <url>http://maven.sk89q.com/repo/</url>
     </repository>
-    <repository>
-      <id>zml-repo</id>
-      <url>http://files.zachsthings.com/repo</url>
-    </repository>
     <repository>
       <id>bukkit-repo</id>
       <url>http://repo.bukkit.org/content/groups/public</url>
@@ -82,12 +78,42 @@
       <version>5.5.8</version>
       <scope>compile</scope>
       <type>jar</type>
+      <exclusions>
+        <exclusion>
+          <groupId>com.zachsthings.libcomponents</groupId>
+          <artifactId>libcomponents-bukkit</artifactId>
+        </exclusion>
+        <exclusion>
+          <groupId>org.bukkit</groupId>
+          <artifactId>bukkit</artifactId>
+        </exclusion>
+      </exclusions>
     </dependency>
-    
+
+    <!-- Used for running CraftBukkit from within your IDE
+         These are runtime-only dependencies -->
+    <dependency>
+      <groupId>org.sk89q.bukkit</groupId>
+      <artifactId>bukkit-classloader-check</artifactId>
+      <version>1.7.9-R0.2</version>
+      <scope>runtime</scope>
+      <type>jar</type>
+      <optional>true</optional>
+    </dependency>
+    <dependency>
+      <groupId>org.bukkit</groupId>
+      <artifactId>craftbukkit</artifactId>
+      <version>1.7.9-R0.2</version>
+      <scope>runtime</scope>
+      <type>jar</type>
+      <optional>true</optional>
+    </dependency>
+    <!-- End runtime only -->
+
     <dependency>
       <groupId>org.bukkit</groupId>
       <artifactId>bukkit</artifactId>
-      <version>1.7.2-R0.3</version>
+      <version>1.7.9-R0.2</version>
       <scope>compile</scope>
       <type>jar</type>
     </dependency>
@@ -107,6 +133,10 @@
           <groupId>org.spout</groupId>
           <artifactId>spoutapi</artifactId>
         </exclusion>
+        <exclusion>
+          <groupId>org.bukkit</groupId>
+          <artifactId>bukkit</artifactId>
+        </exclusion>
       </exclusions>
     </dependency>
     
@@ -116,6 +146,23 @@
       <version>5.0</version>
       <scope>compile</scope>
       <type>jar</type>
+      <optional>true</optional>
+    </dependency>
+
+    <dependency>
+      <groupId>com.google.guava</groupId>
+      <artifactId>guava</artifactId>
+      <version>10.0.1</version> <!-- Bukkit only bundles 10.0.1 -->
+      <scope>compile</scope> <!-- required runtime dependency -->
+      <type>jar</type>
+    </dependency>
+
+    <dependency>
+      <groupId>com.google.code.findbugs</groupId>
+      <artifactId>jsr305</artifactId>
+      <version>1.3.9</version>
+      <scope>compile</scope>
+      <type>jar</type>
     </dependency>
     
     <dependency>
@@ -132,14 +179,47 @@
       <version>2.0</version>
       <scope>compile</scope>
       <type>jar</type>
+      <optional>true</optional>
     </dependency>
-    
+
+    <dependency>
+      <groupId>org.flywaydb</groupId>
+      <artifactId>flyway-core</artifactId>
+      <version>3.0</version>
+      <scope>compile</scope>
+      <type>jar</type>
+      <optional>true</optional>
+    </dependency>
+
+    <dependency>
+      <groupId>com.sk89q</groupId>
+      <artifactId>squirrelid</artifactId>
+      <version>0.1.0</version>
+      <scope>compile</scope>
+      <type>jar</type>
+      <optional>true</optional>
+    </dependency>
+
     <dependency>
       <groupId>junit</groupId>
       <artifactId>junit</artifactId>
-      <version>4.8.1</version>
+      <version>4.11</version>
       <scope>test</scope>
       <type>jar</type>
+      <exclusions>
+        <exclusion>
+          <groupId>org.hamcrest</groupId>
+          <artifactId>hamcrest-core</artifactId>
+        </exclusion>
+      </exclusions>
+    </dependency>
+
+    <dependency>
+      <groupId>org.hamcrest</groupId>
+      <artifactId>hamcrest-library</artifactId>
+      <version>1.2.1</version>
+      <scope>test</scope>
+      <optional>true</optional>
     </dependency>
   </dependencies>
   
@@ -174,9 +254,98 @@
           <include>blacklist.txt</include>
         </includes>
       </resource>
+      <resource>
+        <targetPath>migrations/</targetPath>
+        <filtering>false</filtering>
+        <directory>${basedir}/src/main/resources/migrations/</directory>
+      </resource>
     </resources>
 
     <plugins>
+      <!-- Check style -->
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-checkstyle-plugin</artifactId>
+        <version>2.12</version>
+        <executions>
+          <execution>
+            <id>verify-style</id>
+            <phase>validate</phase>
+            <goals>
+              <goal>check</goal>
+            </goals>
+          </execution>
+        </executions>
+        <configuration>
+          <sourceDirectory>${basedir}/src</sourceDirectory>
+          <consoleOutput>true</consoleOutput>
+          <failsOnError>true</failsOnError>
+          <logViolationsToConsole>true</logViolationsToConsole>
+          <checkstyleRules>
+            <module name="Checker">
+              <!-- Tabs are strictly banned -->
+              <module name="FileTabCharacter"/>
+
+              <module name="TreeWalker">
+                <!-- Important basics -->
+                <!-- <module name="PackageDeclaration"/> Unlikely that we would miss this in a PR -->
+                <module name="OuterTypeFilename"/> <!-- TypeName -> TypeName.java -->
+
+                <!--
+                Control package usage, so people don't insert Bukkit into WE where it shouldn't belong, etc.
+                It is a bit draconian, so update as necessary!
+                -->
+                <module name="ImportControl">
+                  <property name="file" value="${basedir}/config/checkstyle/import-control.xml"/>
+                </module>
+
+                <!-- Code -->
+                <module name="HideUtilityClassConstructor"/> <!-- Utility classes should not have a constructor -->
+                <module name="CovariantEquals"/>
+                <module name="EqualsHashCode"/> <!-- equals() and hashCode() go together -->
+                <module name="NestedTryDepth"> <!-- SHOULD not need to adjust this -->
+                  <property name="max" value="2"/>
+                </module>
+                <module name="SuperFinalize"/> <!-- We don't actually use this -->
+                <module name="JUnitTestCase"/> <!-- Checks tearDown(), setUp() etc. -->
+
+                <!-- Style -->
+                <module name="LeftCurly"> <!-- Left brace never goes on another line -->
+                  <property name="option" value="eol"/>
+                </module> <!-- We don't check right brance -->
+                <module name="DefaultComesLast"/> <!-- default case in switch should be last -->
+                <module name="GenericWhitespace"/>
+
+                <!-- Naming -->
+                <module name="ClassTypeParameterName">
+                  <property name="format" value="^[A-Z][a-zA-Z0-9]*$"/>
+                </module>
+                <module name="LocalFinalVariableName"/>
+                <module name="LocalVariableName">
+                  <property name="format" value="^[a-z_][a-zA-Z0-9]*$"/>
+                </module>
+                <module name="MemberName">
+                  <property name="format" value="^[a-z_][a-zA-Z0-9]*$"/>
+                </module>
+                <module name="MethodName">
+                  <property name="format" value="^[a-z][a-zA-Z0-9]*$"/>
+                </module>
+                <!-- <module name="PackageName"/> Unlikely that we would miss this in a PR -->
+                <module name="ParameterName"/>
+                <!-- <module name="TypeName"/> Unlikely that we would miss this in a PR -->
+              </module>
+
+              <!-- Require the header, something that many people forget and we hate to fix -->
+              <!-- You should configure the header in your IDE -->
+              <module name="Header">
+                <property name="headerFile" value="${basedir}/config/checkstyle/header.txt"/>
+                <property name="fileExtensions" value="java"/>
+              </module>
+            </module>
+          </checkstyleRules>
+        </configuration>
+      </plugin>
+
       <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-compiler-plugin</artifactId>
@@ -220,18 +389,50 @@
                 <includes>
                   <include>net.sf.opencsv:opencsv</include>
                   <include>org.khelekore:prtree</include>
+                  <include>org.flywaydb:flyway-core</include>
+                  <include>com.sk89q:squirrelid</include>
                 </includes>
               </artifactSet>
+              <relocations>
+                <relocation>
+                  <pattern>org.flywaydb</pattern>
+                  <shadedPattern>com.sk89q.worldguard.internal.flywaydb</shadedPattern>
+                </relocation>
+                <relocation>
+                  <pattern>com.sk89q.squirrelid</pattern>
+                  <shadedPattern>com.sk89q.worldguard.util.profile</shadedPattern>
+                </relocation>
+              </relocations>
             </configuration>
           </execution>
         </executions>
       </plugin>
+
+      <plugin>
+        <groupId>com.ruleoftech</groupId>
+        <artifactId>markdown-page-generator-plugin</artifactId>
+        <version>0.4</version>
+        <executions>
+          <execution>
+            <phase>package</phase>
+            <goals>
+              <goal>generate</goal>
+            </goals>
+          </execution>
+        </executions>
+        <configuration>
+          <inputDirectory>${basedir}</inputDirectory>
+          <outputDirectory>${project.build.directory}</outputDirectory>
+          <headerHtmlFile>${project.basedir}/config/markdown/header.html</headerHtmlFile>
+          <footerHtmlFile>${project.basedir}/config/markdown/footer.html</footerHtmlFile>
+        </configuration>
+      </plugin>
       
       <plugin>
         <artifactId>maven-assembly-plugin</artifactId>
         <version>2.2-beta-2</version>
         <configuration>
-          <descriptor>${basedir}/src/main/assembly/default.xml</descriptor>
+          <descriptor>${basedir}/config/assembly/default.xml</descriptor>
         </configuration>
         <executions>
           <execution>

src/main/assembly/default.xml

@@ -1,37 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<assembly
-  xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2"
-  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-  xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2 http://maven.apache.org/xsd/assembly-1.1.2.xsd">
-  <includeBaseDirectory>false</includeBaseDirectory>
-  <formats>
-    <format>tar.gz</format>
-    <format>tar.bz2</format>
-    <format>zip</format>
-  </formats>
-  <files>
-    <file>
-      <source>${project.build.directory}/${artifactId}-${project.version}.jar</source>
-      <destName>WorldGuard.jar</destName>
-      <outputDirectory>/</outputDirectory>
-      <filtered>false</filtered>
-    </file>
-    <file>
-      <source>README.html</source>
-      <outputDirectory>/</outputDirectory>
-      <filtered>true</filtered>
-    </file>
-  </files>
-  <fileSets>
-    <fileSet>
-      <includes>
-        <include>LICENSE.txt</include>
-        <include>NOTICE.txt</include>
-        <include>CHANGELOG.txt</include>
-        <include>contrib/blacklist_table.sql</include>
-        <include>contrib/region_storage.sql</include>
-        <include>contrib/region_storage_update_20110325.sql</include>
-      </includes>
-    </fileSet>
-  </fileSets>
-</assembly>

src/main/java/com/sk89q/worldguard/LocalPlayer.java

@@ -1,36 +1,49 @@
-// $Id$
 /*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
  *
- * You should have received a copy of the GNU General Public License
+ * You should have received a copy of the GNU Lesser General Public License
  * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
+ */
 
 package com.sk89q.worldguard;
 
 import com.sk89q.worldedit.Vector;
+import com.sk89q.worldguard.domains.Association;
+import com.sk89q.worldguard.protection.association.RegionAssociable;
+import com.sk89q.worldguard.protection.regions.ProtectedRegion;
+
+import java.util.UUID;
+
+public abstract class LocalPlayer implements RegionAssociable {
 
-public abstract class LocalPlayer {
     /**
-     * Get a player's name.
+     * Get this player's name.
      * 
      * @return The player's name
      */
     public abstract String getName();
+
+    /**
+     * Get this player's unique ID.
+     *
+     * @return a UUID
+     */
+    public abstract UUID getUniqueId();
     
     /**
-     * Returns true if the player is inside a group.
+     * Returns true if this player is inside a group.
      * 
      * @param group The group to check
      * @return Whether this player is in {@code group}
@@ -38,57 +51,67 @@ public abstract class LocalPlayer {
     public abstract boolean hasGroup(String group);
     
     /**
-     * Get the player's position.
+     * Get this player's position.
      * 
      * @return The player's position
      */
     public abstract Vector getPosition();
     
     /**
-     * Kick the player.
+     * Kick this player.
      * 
      * @param msg The message to kick the player with
      */
     public abstract void kick(String msg);
     
     /**
-     * Ban the player.
+     * Ban this player.
      * 
      * @param msg The message to ban the player with
      */
     public abstract void ban(String msg);
     
     /**
-     * Send the player a message;
+     * Send this player a message.
      * 
      * @param msg The message to send to the player
      */
     public abstract void printRaw(String msg);
     
     /**
-     * Get the player's list of groups.
+     * Get this player's list of groups.
      * 
      * @return The groups this player is in
      */
     public abstract String[] getGroups();
     
     /**
-     * Returns whether a player has permission.
+     * Returns whether this player has permission.
      * 
      * @param perm The permission to check
      * @return Whether this player has {@code perm}
      */
     public abstract boolean hasPermission(String perm);
-    
+
+    @Override
+    public Association getAssociation(ProtectedRegion region) {
+        if (region.isOwner(this)) {
+            return Association.OWNER;
+        } else if (region.isMember(this)) {
+            return Association.MEMBER;
+        } else {
+            return Association.NON_MEMBER;
+        }
+    }
+
     @Override
     public boolean equals(Object obj) {
-
         return obj instanceof LocalPlayer && ((LocalPlayer) obj).getName().equals(getName());
-
     }
     
     @Override
     public int hashCode() {
         return getName().hashCode();
     }
+
 }

src/main/java/com/sk89q/worldguard/blacklist/Blacklist.java

@@ -1,73 +1,66 @@
-// $Id$
 /*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
  *
- * You should have received a copy of the GNU General Public License
+ * You should have received a copy of the GNU Lesser General Public License
  * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
+ */
 
 package com.sk89q.worldguard.blacklist;
 
+import com.google.common.cache.Cache;
+import com.google.common.cache.CacheBuilder;
+import com.google.common.cache.CacheLoader;
+import com.sk89q.worldguard.blacklist.action.Action;
+import com.sk89q.worldguard.blacklist.action.ActionType;
+import com.sk89q.worldguard.blacklist.event.BlacklistEvent;
+import com.sk89q.worldguard.blacklist.event.EventType;
+import com.sk89q.worldguard.blacklist.target.TargetMatcher;
+import com.sk89q.worldguard.blacklist.target.TargetMatcherParseException;
+import com.sk89q.worldguard.blacklist.target.TargetMatcherParser;
+import org.bukkit.ChatColor;
+
 import java.io.BufferedReader;
 import java.io.File;
 import java.io.FileReader;
 import java.io.IOException;
 import java.util.ArrayList;
-import java.util.HashMap;
 import java.util.List;
-import java.util.Map;
+import java.util.concurrent.TimeUnit;
 import java.util.logging.Level;
 import java.util.logging.Logger;
 
-import org.bukkit.ChatColor;
-
-import com.sk89q.worldedit.blocks.ItemType;
-import com.sk89q.worldguard.LocalPlayer;
-import com.sk89q.worldguard.blacklist.events.BlacklistEvent;
-
-/**
- *
- * @author sk89q
- */
 public abstract class Blacklist {
 
-    /**
-     * List of entries by block ID.
-     */
-    private Map<Integer,List<BlacklistEntry>> blacklist
-            = new HashMap<Integer,List<BlacklistEntry>>();
-    /**
-     * Logger.
-     */
-    private BlacklistLogger blacklistLogger = new BlacklistLogger();
-    /**
-     * Last event.
-     */
+    private static final Logger log = Logger.getLogger(Blacklist.class.getCanonicalName());
+
+    private MatcherIndex index = MatcherIndex.getEmptyInstance();
+    private final BlacklistLoggerHandler blacklistLogger = new BlacklistLoggerHandler();
     private BlacklistEvent lastEvent;
-    /**
-     * Used to prevent flooding.
-     */
-    Map<String,BlacklistTrackedEvent> lastAffected =
-            new HashMap<String,BlacklistTrackedEvent>();
-
     private boolean useAsWhitelist;
+    private Cache<String, TrackedEvent> repeatingEventCache = CacheBuilder.newBuilder()
+            .maximumSize(1000)
+            .expireAfterAccess(30, TimeUnit.SECONDS)
+            .build(new CacheLoader<String, TrackedEvent>() {
+                @Override
+                public TrackedEvent load(String s) throws Exception {
+                    return new TrackedEvent();
+                }
+            });
 
-    private final Logger logger;
-
-    public Blacklist(Boolean useAsWhitelist, Logger logger) {
+    public Blacklist(boolean useAsWhitelist) {
         this.useAsWhitelist = useAsWhitelist;
-        this.logger = logger;
     }
 
     /**
@@ -76,17 +69,7 @@ public abstract class Blacklist {
      * @return whether the blacklist is empty
      */
     public boolean isEmpty() {
-        return blacklist.isEmpty();
-    }
-
-    /**
-     * Get the entries for an item or list.
-     *
-     * @param id The item id to get blacklist information for
-     * @return The blacklist entries for {@code id}
-     */
-    public List<BlacklistEntry> getEntries(int id) {
-        return blacklist.get(id);
+        return index.isEmpty();
     }
 
     /**
@@ -95,7 +78,7 @@ public abstract class Blacklist {
      * @return The number of items in the blacklist
      */
     public int getItemCount() {
-        return blacklist.size();
+        return index.size();
     }
 
     /**
@@ -108,11 +91,11 @@ public abstract class Blacklist {
     }
 
     /**
-     * Get the logger.
+     * Get the log.
      *
      * @return The logger used in this blacklist
      */
-    public BlacklistLogger getLogger() {
+    public BlacklistLoggerHandler getLogger() {
         return blacklistLogger;
     }
 
@@ -125,16 +108,20 @@ public abstract class Blacklist {
      * @return Whether the event is allowed
      */
     public boolean check(BlacklistEvent event, boolean forceRepeat, boolean silent) {
-        List<BlacklistEntry> entries = getEntries(event.getType());
+        List<BlacklistEntry> entries = index.getEntries(event.getTarget());
+
         if (entries == null) {
             return true;
         }
+
         boolean ret = true;
+
         for (BlacklistEntry entry : entries) {
             if (!entry.check(useAsWhitelist, event, forceRepeat, silent)) {
                 ret = false;
             }
         }
+
         return ret;
     }
 
@@ -146,8 +133,8 @@ public abstract class Blacklist {
      */
     public void load(File file) throws IOException {
         FileReader input = null;
-        Map<Integer,List<BlacklistEntry>> blacklist =
-                new HashMap<Integer,List<BlacklistEntry>>();
+        MatcherIndex.Builder builder = new MatcherIndex.Builder();
+        TargetMatcherParser targetMatcherParser = new TargetMatcherParser();
 
         try {
             input = new FileReader(file);
@@ -159,7 +146,7 @@ public abstract class Blacklist {
                 line = line.trim();
 
                 // Blank line
-                if (line.length() == 0) {
+                if (line.isEmpty()) {
                     continue;
                 } else if (line.charAt(0) == ';' || line.charAt(0) == '#') {
                     continue;
@@ -170,35 +157,20 @@ public abstract class Blacklist {
                     currentEntries = new ArrayList<BlacklistEntry>();
 
                     for (String item : items) {
-                        int id;
-
                         try {
-                            id = Integer.parseInt(item.trim());
-                        } catch (NumberFormatException e) {
-                            id = getItemID(item.trim());
-                            if (id == 0) {
-                                logger.log(Level.WARNING, "Unknown block name: "
-                                        + item);
-                                break;
-                            }
+                            TargetMatcher matcher = targetMatcherParser.fromInput(item.trim());
+                            BlacklistEntry entry = new BlacklistEntry(this);
+                            builder.add(matcher, entry);
+                            currentEntries.add(entry);
+                        } catch (TargetMatcherParseException e) {
+                            log.log(Level.WARNING, "Could not parse a block/item heading: " + e.getMessage());
                         }
-
-                        BlacklistEntry entry = new BlacklistEntry(this);
-                        if (blacklist.containsKey(id)) {
-                            blacklist.get(id).add(entry);
-                        } else {
-                            List<BlacklistEntry> entries = new ArrayList<BlacklistEntry>();
-                            entries.add(entry);
-                            blacklist.put(id, entries);
-                        }
-                        currentEntries.add(entry);
                     }
                 } else if (currentEntries != null) {
                     String[] parts = line.split("=");
 
                     if (parts.length == 1) {
-                        logger.log(Level.WARNING, "Found option with no value "
-                                + file.getName() + " for '" + line + "'");
+                        log.log(Level.WARNING, "Found option with no value " + file.getName() + " for '" + line + "'");
                         continue;
                     }
 
@@ -207,42 +179,43 @@ public abstract class Blacklist {
                     for (BlacklistEntry entry : currentEntries) {
                         if (parts[0].equalsIgnoreCase("ignore-groups")) {
                             entry.setIgnoreGroups(parts[1].split(","));
+
                         } else if (parts[0].equalsIgnoreCase("ignore-perms")) {
                             entry.setIgnorePermissions(parts[1].split(","));
-                        } else if (parts[0].equalsIgnoreCase("on-break")) {
-                            entry.setBreakActions(parts[1].split(","));
-                        } else if (parts[0].equalsIgnoreCase("on-destroy-with")) {
-                            entry.setDestroyWithActions(parts[1].split(","));
-                        } else if (parts[0].equalsIgnoreCase("on-place")) {
-                            entry.setPlaceActions(parts[1].split(","));
-                        } else if (parts[0].equalsIgnoreCase("on-interact")) {
-                            entry.setInteractActions(parts[1].split(","));
-                        } else if (parts[0].equalsIgnoreCase("on-use")) {
-                            entry.setUseActions(parts[1].split(","));
-                        } else if (parts[0].equalsIgnoreCase("on-drop")) {
-                            entry.setDropActions(parts[1].split(","));
-                        } else if (parts[0].equalsIgnoreCase("on-acquire")) {
-                            entry.setAcquireActions(parts[1].split(","));
+
                         } else if (parts[0].equalsIgnoreCase("message")) {
                             entry.setMessage(parts[1].trim());
+
                         } else if (parts[0].equalsIgnoreCase("comment")) {
                             entry.setComment(parts[1].trim());
+
                         } else {
-                            unknownOption = true;
+                            boolean found = false;
+
+                            for (EventType type : EventType.values()) {
+                                if (type.getRuleName().equalsIgnoreCase(parts[0])) {
+                                    entry.getActions(type.getEventClass()).addAll(parseActions(entry, parts[1]));
+                                    found = true;
+                                    break;
+                                }
+                            }
+
+                            if (!found) {
+                                unknownOption = true;
+                            }
                         }
                     }
 
                     if (unknownOption) {
-                        logger.log(Level.WARNING, "Unknown option '" + parts[0]
-                                + "' in " + file.getName() + " for '" + line + "'");
+                        log.log(Level.WARNING, "Unknown option '" + parts[0] + "' in " + file.getName() + " for '" + line + "'");
                     }
                 } else {
-                    logger.log(Level.WARNING, "Found option with no heading "
+                    log.log(Level.WARNING, "Found option with no heading "
                             + file.getName() + " for '" + line + "'");
                 }
             }
 
-            this.blacklist = blacklist;
+            this.index = builder.build();
         } finally {
             try {
                 if (input != null) {
@@ -253,6 +226,31 @@ public abstract class Blacklist {
         }
     }
 
+    private List<Action> parseActions(BlacklistEntry entry, String raw) {
+        String[] split = raw.split(",");
+        List<Action> actions = new ArrayList<Action>();
+
+        for (String name : split) {
+            name = name.trim();
+
+            boolean found = false;
+
+            for (ActionType type : ActionType.values()) {
+                if (type.getActionName().equalsIgnoreCase(name)) {
+                    actions.add(type.parseInput(this, entry));
+                    found = true;
+                    break;
+                }
+            }
+
+            if (!found) {
+                log.log(Level.WARNING, "Unknown blacklist action: " + name);
+            }
+        }
+
+        return actions;
+    }
+
     /**
      * Get the last event.
      *
@@ -272,10 +270,10 @@ public abstract class Blacklist {
         lastEvent = event;
 
         broadcastNotification(ChatColor.GRAY + "WG: "
-                + ChatColor.LIGHT_PURPLE + event.getPlayer().getName()
+                + ChatColor.LIGHT_PURPLE + event.getCauseName()
                 + ChatColor.GOLD + " (" + event.getDescription() + ") "
                 + ChatColor.WHITE
-                + getFriendlyItemName(event.getType())
+                + event.getTarget().getFriendlyName()
                 + (comment != null ? " (" + comment + ")" : "") + ".");
     }
 
@@ -286,49 +284,8 @@ public abstract class Blacklist {
      */
     public abstract void broadcastNotification(String msg);
 
-    /**
-     * Forget a player.
-     *
-     * @param player The player to forget
-     */
-    public void forgetPlayer(LocalPlayer player) {
-        lastAffected.remove(player.getName());
+    public Cache<String, TrackedEvent> getRepeatingEventCache() {
+        return repeatingEventCache;
     }
 
-    /**
-     * Forget all players.
-     */
-    public void forgetAllPlayers() {
-        lastAffected.clear();
-    }
-
-    /**
-     * Get an item's ID from its name.
-     *
-     * @param name the name of the item to look up
-     * @return the id for name if contained in ItemId, else -1
-     */
-    private static int getItemID(String name) {
-        ItemType type = ItemType.lookup(name);
-        if (type != null) {
-            return type.getID();
-        } else {
-            return -1;
-        }
-    }
-
-    /**
-     * Get an item's friendly name with its ID.
-     *
-     * @param id The id to look up
-     * @return The item's friendly name
-     */
-    private static String getFriendlyItemName(int id) {
-        ItemType type = ItemType.fromID(id);
-        if (type != null) {
-            return type.getName() + " (#" + id + ")";
-        } else {
-            return "#" + id + "";
-        }
-    }
 }

src/main/java/com/sk89q/worldguard/blacklist/BlacklistEntry.java

@@ -1,68 +1,45 @@
-// $Id$
 /*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
  *
- * You should have received a copy of the GNU General Public License
+ * You should have received a copy of the GNU Lesser General Public License
  * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
+ */
 
 package com.sk89q.worldguard.blacklist;
 
+import com.google.common.cache.Cache;
+import com.sk89q.worldguard.LocalPlayer;
+import com.sk89q.worldguard.blacklist.action.Action;
+import com.sk89q.worldguard.blacklist.action.ActionResult;
+import com.sk89q.worldguard.blacklist.event.BlacklistEvent;
+
+import javax.annotation.Nullable;
+import java.util.ArrayList;
 import java.util.Collections;
+import java.util.HashMap;
 import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
 import java.util.Set;
 
-import org.bukkit.ChatColor;
-
-import com.sk89q.worldedit.blocks.ItemType;
-import com.sk89q.worldguard.LocalPlayer;
-import com.sk89q.worldguard.blacklist.events.BlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.BlockBreakBlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.BlockInteractBlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.BlockPlaceBlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.DestroyWithBlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.ItemAcquireBlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.ItemDropBlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.ItemUseBlacklistEvent;
-
-/**
- *
- * @author sk89q
- */
 public class BlacklistEntry {
-    /**
-     * Parent blacklist entry.
-     */
+
     private Blacklist blacklist;
-
-    /**
-     * List of groups to not affect.
-     */
     private Set<String> ignoreGroups;
-
-    /**
-     * List of permissions to not affect.
-     */
     private Set<String> ignorePermissions;
-
-    private String[] breakActions;
-    private String[] destroyWithActions;
-    private String[] placeActions;
-    private String[] interactActions;
-    private String[] useActions;
-    private String[] dropActions;
-    private String[] acquireActions;
+    private Map<Class<? extends BlacklistEvent>, List<Action>> actions = new HashMap<Class<? extends BlacklistEvent>, List<Action>>();
 
     private String message;
     private String comment;
@@ -110,104 +87,6 @@ public class BlacklistEntry {
         this.ignorePermissions = ignorePermissionsSet;
     }
 
-    /**
-     * @return The actions that occur when breaking
-     */
-    public String[] getBreakActions() {
-        return breakActions;
-    }
-
-    /**
-     * @param actions The actions to occur when breaking
-     */
-    public void setBreakActions(String[] actions) {
-        this.breakActions = actions;
-    }
-
-    /**
-     * @return The actions that occur when destroying with a specific item
-     */
-    public String[] getDestroyWithActions() {
-        return destroyWithActions;
-    }
-
-    /**
-     * @param actions The actions to occur when destroying with an item
-     */
-    public void setDestroyWithActions(String[] actions) {
-        this.destroyWithActions = actions;
-    }
-
-    /**
-     * @return The actions that will occur when placing
-     */
-    public String[] getPlaceActions() {
-        return placeActions;
-    }
-
-    /**
-     * @param actions The actions to occur when placing
-     */
-    public void setPlaceActions(String[] actions) {
-        this.placeActions = actions;
-    }
-
-    /**
-     * @return The actions that will occur when interacting
-     */
-    public String[] getInteractActions() {
-        return interactActions;
-    }
-
-    /**
-     * @param actions The actions to occur when interacting
-     */
-    public void setInteractActions(String[] actions) {
-        this.interactActions = actions;
-    }
-
-    /**
-     * @return The actions that will occur when using
-     */
-    public String[] getUseActions() {
-        return useActions;
-    }
-
-    /**
-     * @param actions The actions to occur when using
-     */
-    public void setUseActions(String[] actions) {
-        this.useActions = actions;
-    }
-
-    /**
-     * @return The actions that will occur when dropping
-     */
-    public String[] getDropActions() {
-        return dropActions;
-    }
-
-    /**
-     * @param actions The actions to occur when dropping
-     */
-    public void setDropActions(String[] actions) {
-        this.dropActions = actions;
-    }
-
-    /**
-     * @return The actions that will occur when acquiring
-     */
-    public String[] getAcquireActions() {
-        return acquireActions;
-    }
-
-    /**
-     * @param actions The actions to occur when acquiring
-     */
-    public void setAcquireActions(String[] actions) {
-        this.acquireActions = actions;
-    }
-
     /**
      * @return the message
      */
@@ -242,7 +121,11 @@ public class BlacklistEntry {
      * @param player The player to check
      * @return whether this player should be ignored for blacklist blocking
      */
-    public boolean shouldIgnore(LocalPlayer player) {
+    public boolean shouldIgnore(@Nullable LocalPlayer player) {
+        if (player == null) {
+            return false; // This is the case if the cause is a dispenser, for example
+        }
+
         if (ignoreGroups != null) {
             for (String group : player.getGroups()) {
                 if (ignoreGroups.contains(group.toLowerCase())) {
@@ -265,40 +148,22 @@ public class BlacklistEntry {
     /**
      * Get the associated actions with an event.
      *
-     * @param event The event to check
+     * @param eventCls The event's class
      * @return The actions for the given event
      */
-    private String[] getActions(BlacklistEvent event) {
-        if (event instanceof BlockBreakBlacklistEvent) {
-            return breakActions;
-
-        } else if (event instanceof BlockPlaceBlacklistEvent) {
-            return placeActions;
-
-        } else if (event instanceof BlockInteractBlacklistEvent) {
-            return interactActions;
-
-        } else if (event instanceof DestroyWithBlacklistEvent) {
-            return destroyWithActions;
-
-        } else if (event instanceof ItemAcquireBlacklistEvent) {
-            return acquireActions;
-
-        } else if (event instanceof ItemDropBlacklistEvent) {
-            return dropActions;
-
-        } else if (event instanceof ItemUseBlacklistEvent) {
-            return useActions;
-
-        } else {
-            return null;
+    public List<Action> getActions(Class<? extends BlacklistEvent> eventCls) {
+        List<Action> ret = actions.get(eventCls);
+        if (ret == null) {
+            ret = new ArrayList<Action>();
+            actions.put(eventCls, ret);
         }
+        return ret;
     }
 
     /**
      * Method to handle the event.
      *
-     * @param useAsWhitelist Whether this entry is buing used in a whitelist
+     * @param useAsWhitelist Whether this entry is being used in a whitelist
      * @param event The event to check
      * @param forceRepeat Whether to force repeating notifications even within the delay limit
      * @param silent Whether to prevent notifications from happening
@@ -311,22 +176,20 @@ public class BlacklistEntry {
             return true;
         }
 
-        String name = player.getName();
-        long now = System.currentTimeMillis();
         boolean repeating = false;
+        String eventCacheKey = event.getCauseName();
+        Cache<String, TrackedEvent> repeatingEventCache = blacklist.getRepeatingEventCache();
 
         // Check to see whether this event is being repeated
-        BlacklistTrackedEvent tracked = blacklist.lastAffected.get(name);
-        if (tracked != null) {
-            if (tracked.matches(event, now)) {
-                repeating = true;
-            }
+        TrackedEvent tracked = repeatingEventCache.getUnchecked(eventCacheKey);
+        if (tracked.matches(event)) {
+            repeating = true;
         } else {
-            blacklist.lastAffected.put(name, new BlacklistTrackedEvent(event, now));
+            tracked.setLastEvent(event);
+            tracked.resetTimer();
         }
 
-        String actions[] = getActions(event);
-
+        List<Action> actions = getActions(event.getClass());
 
         boolean ret = !useAsWhitelist;
 
@@ -335,90 +198,25 @@ public class BlacklistEntry {
             return ret;
         }
 
-        for (String action : actions) {
-            // Deny
-            if (action.equalsIgnoreCase("deny")) {
-                if (silent) {
-                    return false;
-                }
-
-                ret = false;
-
-            // Allow
-            } else if (action.equalsIgnoreCase("allow")) {
-                if (silent) {
+        for (Action action : actions) {
+            ActionResult result = action.apply(event, silent, repeating, forceRepeat);
+            switch (result) {
+                case INHERIT:
+                    continue;
+                case ALLOW:
+                    ret = true;
+                    break;
+                case DENY:
+                    ret = false;
+                    break;
+                case ALLOW_OVERRIDE:
                     return true;
-                }
-
-                ret = true;
-
-            // Kick
-            } else if (action.equalsIgnoreCase("kick")) {
-                if (silent) {
-                    continue;
-                }
-
-                if (this.message != null) {
-                    player.kick(String.format(this.message,
-                            getFriendlyItemName(event.getType())));
-                } else {
-                    player.kick("You can't " + event.getDescription() + " "
-                            + getFriendlyItemName(event.getType()));
-                }
-
-            // Ban
-            } else if (action.equalsIgnoreCase("ban")) {
-                if (silent) {
-                    continue;
-                }
-
-                if (this.message != null) {
-                    player.ban("Banned: " + String.format(this.message,
-                            getFriendlyItemName(event.getType())));
-                } else {
-                    player.ban("Banned: You can't "
-                            + event.getDescription() + " "
-                            + getFriendlyItemName(event.getType()));
-                }
-
-            } else if (!silent && (!repeating || forceRepeat)) {
-                // Notify
-                if (action.equalsIgnoreCase("notify")) {
-                    blacklist.notify(event, comment);
-
-                // Log
-                } else if (action.equalsIgnoreCase("log")) {
-                    blacklist.getLogger().logEvent(event, comment);
-
-                // Tell
-                } else if (action.equalsIgnoreCase("tell")) {
-                    if (this.message != null) {
-                        player.printRaw(ChatColor.YELLOW +
-                                String.format(message, getFriendlyItemName(event.getType()))
-                                + ".");
-                    } else {
-                        player.printRaw(ChatColor.YELLOW + "You're not allowed to "
-                                + event.getDescription() + " "
-                                + getFriendlyItemName(event.getType()) + ".");
-                    }
-                }
+                case DENY_OVERRIDE:
+                    return false;
             }
         }
 
         return ret;
     }
 
-    /**
-     * Get an item's friendly name with its ID.
-     *
-     * @param id The id to get a name for
-     */
-    private static String getFriendlyItemName(int id) {
-        ItemType type = ItemType.fromID(id);
-        if (type != null) {
-            return type.getName() + " (#" + id + ")";
-        } else {
-            return "#" + id + "";
-        }
-    }
 }

src/main/java/com/sk89q/worldguard/blacklist/BlacklistLoggerHandler.java

@@ -1,47 +1,44 @@
-// $Id$
 /*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
  *
- * You should have received a copy of the GNU General Public License
+ * You should have received a copy of the GNU Lesser General Public License
  * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
+ */
 
 package com.sk89q.worldguard.blacklist;
 
+import com.sk89q.worldguard.blacklist.event.BlacklistEvent;
+import com.sk89q.worldguard.blacklist.logger.LoggerHandler;
+
 import java.util.HashSet;
 import java.util.Set;
 
-import com.sk89q.worldguard.blacklist.events.BlacklistEvent;
-import com.sk89q.worldguard.blacklist.loggers.BlacklistLoggerHandler;
+public class BlacklistLoggerHandler implements LoggerHandler {
 
-/**
- *
- * @author sk89q
- */
-public class BlacklistLogger implements BlacklistLoggerHandler {
     /**
      * List of logger handlers.
      */
-    private Set<BlacklistLoggerHandler> handlers
-            = new HashSet<BlacklistLoggerHandler>();
+    private Set<LoggerHandler> handlers
+            = new HashSet<LoggerHandler>();
 
     /**
      * Add a handler.
      *
      * @param handler The handler to add
      */
-    public void addHandler(BlacklistLoggerHandler handler) {
+    public void addHandler(LoggerHandler handler) {
         handlers.add(handler);
     }
 
@@ -50,7 +47,7 @@ public class BlacklistLogger implements BlacklistLoggerHandler {
      *
      * @param handler The handler to remove
      */
-    public void removeHandler(BlacklistLoggerHandler handler) {
+    public void removeHandler(LoggerHandler handler) {
         handlers.remove(handler);
     }
 
@@ -66,8 +63,9 @@ public class BlacklistLogger implements BlacklistLoggerHandler {
      *
      * @param event The event to log
      */
+    @Override
     public void logEvent(BlacklistEvent event, String comment) {
-        for (BlacklistLoggerHandler handler : handlers) {
+        for (LoggerHandler handler : handlers) {
             handler.logEvent(event, comment);
         }
     }
@@ -75,9 +73,11 @@ public class BlacklistLogger implements BlacklistLoggerHandler {
     /**
      * Close the connection.
      */
+    @Override
     public void close() {
-        for (BlacklistLoggerHandler handler : handlers) {
+        for (LoggerHandler handler : handlers) {
             handler.close();
         }
     }
+
 }

src/main/java/com/sk89q/worldguard/blacklist/BlacklistTrackedEvent.java

@@ -1,48 +0,0 @@
-// $Id$
-/*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package com.sk89q.worldguard.blacklist;
-
-import com.sk89q.worldguard.blacklist.events.BlacklistEvent;
-
-/**
- *
- * @author sk89q
- */
-public class BlacklistTrackedEvent {
-    private BlacklistEvent event;
-    private long time;
-
-    /**
-     * Construct the object.
-     *
-     * @param event The event tracked
-     * @param time The time at which the event occurred
-     */
-    public BlacklistTrackedEvent(BlacklistEvent event, long time) {
-        this.event = event;
-        this.time = time;
-    }
-
-    public boolean matches(BlacklistEvent other, long now) {
-        return other.getType() == event.getType()
-                && time > now - 3000
-                && other.getClass() == event.getClass();
-    }
-}

src/main/java/com/sk89q/worldguard/blacklist/MatcherIndex.java

@@ -0,0 +1,80 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist;
+
+import com.google.common.collect.HashBasedTable;
+import com.google.common.collect.Table;
+import com.sk89q.worldguard.blacklist.target.Target;
+import com.sk89q.worldguard.blacklist.target.TargetMatcher;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map.Entry;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+
+class MatcherIndex {
+
+    private static final MatcherIndex EMPTY_INSTANCE = new MatcherIndex(HashBasedTable.<Integer, TargetMatcher, BlacklistEntry>create());
+    private final Table<Integer, TargetMatcher, BlacklistEntry> entries;
+
+    private MatcherIndex(Table<Integer, TargetMatcher, BlacklistEntry> entries) {
+        checkNotNull(entries);
+        this.entries = entries;
+    }
+
+    public List<BlacklistEntry> getEntries(Target target) {
+        List<BlacklistEntry> found = new ArrayList<BlacklistEntry>();
+        for (Entry<TargetMatcher, BlacklistEntry> entry : entries.row(target.getTypeId()).entrySet()) {
+            if (entry.getKey().test(target)) {
+                found.add(entry.getValue());
+            }
+        }
+        return found;
+    }
+
+    public int size() {
+        return entries.size();
+    }
+
+    public boolean isEmpty() {
+        return entries.isEmpty();
+    }
+
+    public static MatcherIndex getEmptyInstance() {
+        return EMPTY_INSTANCE;
+    }
+
+    public static class Builder {
+        private final Table<Integer, TargetMatcher, BlacklistEntry> entries = HashBasedTable.create();
+
+        public Builder add(TargetMatcher matcher, BlacklistEntry entry) {
+            checkNotNull(matcher);
+            checkNotNull(entries);
+            entries.put(matcher.getMatchedTypeId(), matcher, entry);
+            return this;
+        }
+
+        public MatcherIndex build() {
+            return new MatcherIndex(entries);
+        }
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/TrackedEvent.java

@@ -0,0 +1,47 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist;
+
+import com.sk89q.worldguard.blacklist.event.BlacklistEvent;
+
+import javax.annotation.Nullable;
+
+class TrackedEvent {
+
+    @Nullable
+    private BlacklistEvent lastEvent;
+    private long time = 0;
+
+    public boolean matches(BlacklistEvent other) {
+        if (lastEvent == null) {
+            return false;
+        }
+        long now = System.currentTimeMillis();
+        return other.getEventType() == lastEvent.getEventType() && time > now - 3000;
+    }
+
+    public void resetTimer() {
+        time = System.currentTimeMillis();
+    }
+
+    public void setLastEvent(@Nullable BlacklistEvent lastEvent) {
+        this.lastEvent = lastEvent;
+    }
+}

src/main/java/com/sk89q/worldguard/blacklist/action/Action.java

@@ -0,0 +1,28 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.action;
+
+import com.sk89q.worldguard.blacklist.event.BlacklistEvent;
+
+public interface Action {
+
+    ActionResult apply(BlacklistEvent event, boolean silent, boolean repeating, boolean forceRepeat);
+
+}

src/main/java/com/sk89q/worldguard/blacklist/action/ActionResult.java

@@ -0,0 +1,30 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.action;
+
+public enum ActionResult {
+
+    INHERIT,
+    DENY,
+    ALLOW,
+    DENY_OVERRIDE,
+    ALLOW_OVERRIDE
+
+}

src/main/java/com/sk89q/worldguard/blacklist/action/ActionType.java

@@ -0,0 +1,81 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.action;
+
+import com.sk89q.worldguard.blacklist.Blacklist;
+import com.sk89q.worldguard.blacklist.BlacklistEntry;
+
+public enum ActionType {
+
+    ALLOW("allow") {
+        @Override
+        public Action parseInput(Blacklist blacklist, BlacklistEntry entry) {
+            return AllowAction.getInstance();
+        }
+    },
+    DENY("deny") {
+        @Override
+        public Action parseInput(Blacklist blacklist, BlacklistEntry entry) {
+            return DenyAction.getInstance();
+        }
+    },
+    BAN("ban") {
+        @Override
+        public Action parseInput(Blacklist blacklist, BlacklistEntry entry) {
+            return new BanAction(entry);
+        }
+    },
+    KICK("kick") {
+        @Override
+        public Action parseInput(Blacklist blacklist, BlacklistEntry entry) {
+            return new KickAction(entry);
+        }
+    },
+    LOG("log") {
+        @Override
+        public Action parseInput(Blacklist blacklist, BlacklistEntry entry) {
+            return new LogAction(blacklist, entry);
+        }
+    },
+    NOTIFY("notify") {
+        @Override
+        public Action parseInput(Blacklist blacklist, BlacklistEntry entry) {
+            return new NotifyAction(blacklist, entry);
+        }
+    },
+    TELL("tell") {
+        @Override
+        public Action parseInput(Blacklist blacklist, BlacklistEntry entry) {
+            return new TellAction(entry);
+        }
+    };
+
+    private final String actionName;
+
+    ActionType(String actionName) {
+        this.actionName = actionName;
+    }
+
+    public abstract Action parseInput(Blacklist blacklist, BlacklistEntry entry);
+
+    public String getActionName() {
+        return actionName;
+    }
+}

src/main/java/com/sk89q/worldguard/blacklist/action/AllowAction.java

@@ -0,0 +1,44 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.action;
+
+import com.sk89q.worldguard.blacklist.event.BlacklistEvent;
+
+public final class AllowAction implements Action {
+
+    private static final AllowAction INSTANCE = new AllowAction();
+
+    private AllowAction() {
+    }
+
+    @Override
+    public ActionResult apply(BlacklistEvent event, boolean silent, boolean repeating, boolean forceRepeat) {
+        if (silent) {
+            return ActionResult.ALLOW_OVERRIDE;
+        }
+
+        return ActionResult.ALLOW;
+    }
+
+    public static AllowAction getInstance() {
+        return INSTANCE;
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/action/BanAction.java

@@ -0,0 +1,55 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.action;
+
+import com.sk89q.worldguard.blacklist.BlacklistEntry;
+import com.sk89q.worldguard.blacklist.event.BlacklistEvent;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+
+public class BanAction implements Action {
+
+    private final BlacklistEntry entry;
+
+    public BanAction(BlacklistEntry entry) {
+        checkNotNull(entry);
+        this.entry = entry;
+    }
+
+    @Override
+    public ActionResult apply(BlacklistEvent event, boolean silent, boolean repeating, boolean forceRepeat) {
+        if (silent) {
+            return ActionResult.INHERIT;
+        }
+
+        if (event.getPlayer() != null) {
+            String message = entry.getMessage();
+
+            if (message != null) {
+                event.getPlayer().ban("Banned: " + String.format(message, event.getTarget().getFriendlyName()));
+            } else {
+                event.getPlayer().ban("Banned: You can't " + event.getDescription() + " " + event.getTarget().getFriendlyName());
+            }
+        }
+
+        return ActionResult.INHERIT;
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/action/DenyAction.java

@@ -0,0 +1,44 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.action;
+
+import com.sk89q.worldguard.blacklist.event.BlacklistEvent;
+
+public final class DenyAction implements Action {
+
+    private static final DenyAction INSTANCE = new DenyAction();
+
+    private DenyAction() {
+    }
+
+    @Override
+    public ActionResult apply(BlacklistEvent event, boolean silent, boolean repeating, boolean forceRepeat) {
+        if (silent) {
+            return ActionResult.DENY_OVERRIDE;
+        }
+
+        return ActionResult.DENY;
+    }
+
+    public static DenyAction getInstance() {
+        return INSTANCE;
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/action/KickAction.java

@@ -0,0 +1,55 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.action;
+
+import com.sk89q.worldguard.blacklist.BlacklistEntry;
+import com.sk89q.worldguard.blacklist.event.BlacklistEvent;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+
+public class KickAction implements Action {
+
+    private final BlacklistEntry entry;
+
+    public KickAction(BlacklistEntry entry) {
+        checkNotNull(entry);
+        this.entry = entry;
+    }
+
+    @Override
+    public ActionResult apply(BlacklistEvent event, boolean silent, boolean repeating, boolean forceRepeat) {
+        if (silent) {
+            return ActionResult.INHERIT;
+        }
+
+        if (event.getPlayer() != null) {
+            String message = entry.getMessage();
+
+            if (message != null) {
+                event.getPlayer().kick(String.format(message, event.getTarget().getFriendlyName()));
+            } else {
+                event.getPlayer().kick("You can't " + event.getDescription() + " " + event.getTarget().getFriendlyName());
+            }
+        }
+
+        return ActionResult.INHERIT;
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/action/LogAction.java

@@ -0,0 +1,51 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.action;
+
+import com.sk89q.worldguard.blacklist.Blacklist;
+import com.sk89q.worldguard.blacklist.BlacklistEntry;
+import com.sk89q.worldguard.blacklist.event.BlacklistEvent;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+
+public class LogAction extends RepeatGuardedAction {
+
+    private final Blacklist blacklist;
+    private final BlacklistEntry entry;
+
+    public LogAction(Blacklist blacklist, BlacklistEntry entry) {
+        checkNotNull(blacklist);
+        checkNotNull(entry);
+        this.blacklist = blacklist;
+        this.entry = entry;
+    }
+
+    @Override
+    protected ActionResult applyNonRepeated(BlacklistEvent event, boolean silent) {
+        if (silent) {
+            return ActionResult.INHERIT;
+        }
+
+        blacklist.getLogger().logEvent(event, entry.getComment());
+
+        return ActionResult.INHERIT;
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/action/NotifyAction.java

@@ -0,0 +1,51 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.action;
+
+import com.sk89q.worldguard.blacklist.Blacklist;
+import com.sk89q.worldguard.blacklist.BlacklistEntry;
+import com.sk89q.worldguard.blacklist.event.BlacklistEvent;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+
+public class NotifyAction extends RepeatGuardedAction {
+
+    private final Blacklist blacklist;
+    private final BlacklistEntry entry;
+
+    public NotifyAction(Blacklist blacklist, BlacklistEntry entry) {
+        checkNotNull(blacklist);
+        checkNotNull(entry);
+        this.blacklist = blacklist;
+        this.entry = entry;
+    }
+
+    @Override
+    protected ActionResult applyNonRepeated(BlacklistEvent event, boolean silent) {
+        if (silent) {
+            return ActionResult.INHERIT;
+        }
+
+        blacklist.notify(event, entry.getComment());
+
+        return ActionResult.INHERIT;
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/action/RepeatGuardedAction.java

@@ -0,0 +1,37 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.action;
+
+import com.sk89q.worldguard.blacklist.event.BlacklistEvent;
+
+public abstract class RepeatGuardedAction implements Action {
+
+    @Override
+    public final ActionResult apply(BlacklistEvent event, boolean silent, boolean repeating, boolean forceRepeat) {
+        if (!repeating || forceRepeat) {
+            return applyNonRepeated(event, silent);
+        }
+
+        return ActionResult.INHERIT;
+    }
+
+    protected abstract ActionResult applyNonRepeated(BlacklistEvent event, boolean silent);
+
+}

src/main/java/com/sk89q/worldguard/blacklist/action/TellAction.java

@@ -0,0 +1,57 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.action;
+
+import com.sk89q.worldguard.blacklist.BlacklistEntry;
+import com.sk89q.worldguard.blacklist.event.BlacklistEvent;
+import org.bukkit.ChatColor;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+
+public class TellAction extends RepeatGuardedAction {
+
+    private final BlacklistEntry entry;
+
+    public TellAction(BlacklistEntry entry) {
+        checkNotNull(entry);
+        this.entry = entry;
+    }
+
+    @Override
+    protected ActionResult applyNonRepeated(BlacklistEvent event, boolean silent) {
+        if (silent) {
+            return ActionResult.INHERIT;
+        }
+
+        String message = entry.getMessage();
+
+        if (event.getPlayer() != null) {
+            if (message != null) {
+                event.getPlayer().printRaw(ChatColor.YELLOW + String.format(message, event.getTarget().getFriendlyName()) + ".");
+            } else {
+                event.getPlayer().printRaw(ChatColor.YELLOW + "You're not allowed to " + event.getDescription() + " " +
+                        event.getTarget().getFriendlyName() + ".");
+            }
+        }
+
+        return ActionResult.INHERIT;
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/event/AbstractBlacklistEvent.java

@@ -0,0 +1,77 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.event;
+
+import com.sk89q.worldedit.Vector;
+import com.sk89q.worldguard.LocalPlayer;
+import com.sk89q.worldguard.blacklist.target.Target;
+
+import javax.annotation.Nullable;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+
+abstract class AbstractBlacklistEvent implements BlacklistEvent {
+
+    @Nullable
+    private final LocalPlayer player;
+    private final Vector position;
+    private final Target target;
+    
+    /**
+     * Construct the object.
+     * 
+     * @param player The player associated with this event
+     * @param position The position the event occurred at
+     * @param target The target of the event
+     */
+    AbstractBlacklistEvent(@Nullable LocalPlayer player, Vector position, Target target) {
+        checkNotNull(position);
+        checkNotNull(target);
+        this.player = player;
+        this.position = position;
+        this.target = target;
+    }
+
+    @Nullable
+    @Override
+    public LocalPlayer getPlayer() {
+        return player;
+    }
+
+    @Override
+    public String getCauseName() {
+        return player != null ? player.getName() : position.toString();
+    }
+
+    @Override
+    public Vector getPosition() {
+        return position;
+    }
+    
+    @Override
+    public Target getTarget() {
+        return target;
+    }
+
+    protected String getPlayerName() {
+        return player == null ? "(unknown)" : player.getName();
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/event/BlacklistEvent.java

@@ -0,0 +1,87 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.event;
+
+import com.sk89q.worldedit.Vector;
+import com.sk89q.worldguard.LocalPlayer;
+import com.sk89q.worldguard.blacklist.target.Target;
+
+import javax.annotation.Nullable;
+
+public interface BlacklistEvent {
+
+    /**
+     * Get the player.
+     *
+     * @return The player associated with this event
+     */
+    @Nullable
+    LocalPlayer getPlayer();
+
+    /**
+     * Get the cause name, which is usually the player name.
+     *
+     * @return the cause name
+     */
+    String getCauseName();
+
+    /**
+     * Get the position.
+     *
+     * @return The position of this event
+     */
+    Vector getPosition();
+
+    /**
+     * Get the position that should be logged.
+     *
+     * @return The position that be logged.
+     */
+    Vector getLoggedPosition();
+
+    /**
+     * Get the item type.
+     *
+     * @return The type associated with this event
+     */
+    Target getTarget();
+
+    /**
+     * Get a short description such as "break" or "destroy with."
+     *
+     * @return The event description
+     */
+    String getDescription();
+
+    /**
+     * Get a message for logger outputs.
+     *
+     * @return A logging message
+     */
+    String getLoggerMessage();
+
+    /**
+     * Get the event type.
+     *
+     * @return the type
+     */
+    EventType getEventType();
+
+}

src/main/java/com/sk89q/worldguard/blacklist/event/BlockBlacklistEvent.java

@@ -0,0 +1,51 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.event;
+
+import com.sk89q.worldedit.Vector;
+import com.sk89q.worldguard.LocalPlayer;
+import com.sk89q.worldguard.blacklist.target.Target;
+
+import javax.annotation.Nullable;
+
+abstract class BlockBlacklistEvent extends AbstractBlacklistEvent {
+
+    /**
+     * Construct the object.
+     *
+     * @param player The player associated with this event
+     * @param position The position the event occurred at
+     * @param target The target of the event
+     */
+    BlockBlacklistEvent(@Nullable LocalPlayer player, Vector position, Target target) {
+        super(player, position, target);
+    }
+
+    @Override
+    public String getLoggerMessage() {
+        return getPlayerName() + " tried to " + getDescription() + " " + getTarget().getFriendlyName();
+    }
+
+    @Override
+    public Vector getLoggedPosition() {
+        return getPosition();
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/event/BlockBreakBlacklistEvent.java

@@ -0,0 +1,51 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.event;
+
+import com.sk89q.worldedit.Vector;
+import com.sk89q.worldguard.LocalPlayer;
+import com.sk89q.worldguard.blacklist.target.Target;
+
+import javax.annotation.Nullable;
+
+public final class BlockBreakBlacklistEvent extends BlockBlacklistEvent {
+
+    /**
+     * Construct the object.
+     *
+     * @param player The player associated with this event
+     * @param position The position the event occurred at
+     * @param target The target of the event
+     */
+    public BlockBreakBlacklistEvent(@Nullable LocalPlayer player, Vector position, Target target) {
+        super(player, position, target);
+    }
+
+    @Override
+    public String getDescription() {
+        return "break";
+    }
+
+    @Override
+    public EventType getEventType() {
+        return EventType.BREAK;
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/event/BlockDispenseBlacklistEvent.java

@@ -0,0 +1,56 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.event;
+
+import com.sk89q.worldedit.Vector;
+import com.sk89q.worldguard.LocalPlayer;
+import com.sk89q.worldguard.blacklist.target.Target;
+
+import javax.annotation.Nullable;
+
+public final class BlockDispenseBlacklistEvent extends BlockBlacklistEvent {
+
+    /**
+     * Construct the object.
+     *
+     * @param player The player associated with this event
+     * @param position The position the event occurred at
+     * @param target The target of the event
+     */
+    public BlockDispenseBlacklistEvent(@Nullable LocalPlayer player, Vector position, Target target) {
+        super(player, position, target);
+    }
+
+    @Override
+    public String getDescription() {
+        return "dispense";
+    }
+
+    @Override
+    public String getLoggerMessage() {
+        return getPosition() + " tried to " + getDescription() + " " + getTarget().getFriendlyName();
+    }
+
+    @Override
+    public EventType getEventType() {
+        return EventType.DISPENSE;
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/event/BlockInteractBlacklistEvent.java

@@ -0,0 +1,51 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.event;
+
+import com.sk89q.worldedit.Vector;
+import com.sk89q.worldguard.LocalPlayer;
+import com.sk89q.worldguard.blacklist.target.Target;
+
+import javax.annotation.Nullable;
+
+public final class BlockInteractBlacklistEvent extends BlockBlacklistEvent {
+
+    /**
+     * Construct the object.
+     *
+     * @param player The player associated with this event
+     * @param position The position the event occurred at
+     * @param target The target of the event
+     */
+    public BlockInteractBlacklistEvent(@Nullable LocalPlayer player, Vector position, Target target) {
+        super(player, position, target);
+    }
+
+    @Override
+    public String getDescription() {
+        return "interact with";
+    }
+
+    @Override
+    public EventType getEventType() {
+        return EventType.INTERACT;
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/event/BlockPlaceBlacklistEvent.java

@@ -0,0 +1,51 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.event;
+
+import com.sk89q.worldedit.Vector;
+import com.sk89q.worldguard.LocalPlayer;
+import com.sk89q.worldguard.blacklist.target.Target;
+
+import javax.annotation.Nullable;
+
+public final class BlockPlaceBlacklistEvent extends BlockBlacklistEvent {
+
+    /**
+     * Construct the object.
+     *
+     * @param player The player associated with this event
+     * @param position The position the event occurred at
+     * @param target The target of the event
+     */
+    public BlockPlaceBlacklistEvent(@Nullable LocalPlayer player, Vector position, Target target) {
+        super(player, position, target);
+    }
+
+    @Override
+    public String getDescription() {
+        return "place";
+    }
+
+    @Override
+    public EventType getEventType() {
+        return EventType.PLACE;
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/event/EventType.java

@@ -0,0 +1,49 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.event;
+
+public enum EventType {
+
+    BREAK(BlockBreakBlacklistEvent.class, "on-break"),
+    PLACE(BlockPlaceBlacklistEvent.class, "on-place"),
+    INTERACT(BlockInteractBlacklistEvent.class, "on-interact"),
+    DISPENSE(BlockDispenseBlacklistEvent.class, "on-dispense"),
+    DESTROY_WITH(ItemDestroyWithBlacklistEvent.class, "on-destroy-with"),
+    ACQUIRE(ItemAcquireBlacklistEvent.class, "on-acquire"),
+    DROP(ItemDropBlacklistEvent.class, "on-drop"),
+    USE(ItemUseBlacklistEvent.class, "on-use");
+
+    private final Class<? extends BlacklistEvent> eventClass;
+    private final String ruleName;
+
+    private EventType(Class<? extends BlacklistEvent> eventClass, String ruleName) {
+        this.eventClass = eventClass;
+        this.ruleName = ruleName;
+    }
+
+    public Class<? extends BlacklistEvent> getEventClass() {
+        return eventClass;
+    }
+
+    public String getRuleName() {
+        return ruleName;
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/event/ItemAcquireBlacklistEvent.java

@@ -0,0 +1,51 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.event;
+
+import com.sk89q.worldedit.Vector;
+import com.sk89q.worldguard.LocalPlayer;
+import com.sk89q.worldguard.blacklist.target.Target;
+
+import javax.annotation.Nullable;
+
+public final class ItemAcquireBlacklistEvent extends ItemBlacklistEvent {
+
+    /**
+     * Construct the object.
+     *
+     * @param player The player associated with this event
+     * @param position The position the event occurred at
+     * @param target The target of the event
+     */
+    public ItemAcquireBlacklistEvent(@Nullable LocalPlayer player, Vector position, Target target) {
+        super(player, position, target);
+    }
+
+    @Override
+    public String getDescription() {
+        return "acquire";
+    }
+
+    @Override
+    public EventType getEventType() {
+        return EventType.ACQUIRE;
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/event/ItemBlacklistEvent.java

@@ -0,0 +1,51 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.event;
+
+import com.sk89q.worldedit.Vector;
+import com.sk89q.worldguard.LocalPlayer;
+import com.sk89q.worldguard.blacklist.target.Target;
+
+import javax.annotation.Nullable;
+
+abstract class ItemBlacklistEvent extends AbstractBlacklistEvent {
+
+    /**
+     * Construct the object.
+     *
+     * @param player The player associated with this event
+     * @param position The position the event occurred at
+     * @param target The target of the event
+     */
+    ItemBlacklistEvent(@Nullable LocalPlayer player, Vector position, Target target) {
+        super(player, position, target);
+    }
+
+    @Override
+    public String getLoggerMessage() {
+        return getPlayerName() + " tried to " + getDescription() + " " + getTarget().getFriendlyName();
+    }
+
+    @Override
+    public Vector getLoggedPosition() {
+        return getPlayer() != null ? getPlayer().getPosition() : getPosition();
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/event/ItemDestroyWithBlacklistEvent.java

@@ -0,0 +1,57 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.event;
+
+import com.sk89q.worldedit.Vector;
+import com.sk89q.worldguard.LocalPlayer;
+import com.sk89q.worldguard.blacklist.target.Target;
+
+import javax.annotation.Nullable;
+
+public final class ItemDestroyWithBlacklistEvent extends ItemBlacklistEvent {
+
+    /**
+     * Construct the object.
+     *
+     * @param player The player associated with this event
+     * @param position The position the event occurred at
+     * @param target The target of the event
+     */
+    public ItemDestroyWithBlacklistEvent(@Nullable LocalPlayer player, Vector position, Target target) {
+        super(player, position, target);
+    }
+
+    @Override
+    public String getDescription() {
+        return "destroy with";
+    }
+
+    @Override
+    public EventType getEventType() {
+        return EventType.DESTROY_WITH;
+    }
+
+    @Override
+    public Vector getLoggedPosition() {
+        // Use the block position instead
+        return getPosition();
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/event/ItemDropBlacklistEvent.java

@@ -0,0 +1,51 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.event;
+
+import com.sk89q.worldedit.Vector;
+import com.sk89q.worldguard.LocalPlayer;
+import com.sk89q.worldguard.blacklist.target.Target;
+
+import javax.annotation.Nullable;
+
+public final class ItemDropBlacklistEvent extends ItemBlacklistEvent {
+
+    /**
+     * Construct the object.
+     *
+     * @param player The player associated with this event
+     * @param position The position the event occurred at
+     * @param target The target of the event
+     */
+    public ItemDropBlacklistEvent(@Nullable LocalPlayer player, Vector position, Target target) {
+        super(player, position, target);
+    }
+
+    @Override
+    public String getDescription() {
+        return "drop";
+    }
+
+    @Override
+    public EventType getEventType() {
+        return EventType.DROP;
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/event/ItemUseBlacklistEvent.java

@@ -0,0 +1,51 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.event;
+
+import com.sk89q.worldedit.Vector;
+import com.sk89q.worldguard.LocalPlayer;
+import com.sk89q.worldguard.blacklist.target.Target;
+
+import javax.annotation.Nullable;
+
+public final class ItemUseBlacklistEvent extends ItemBlacklistEvent {
+
+    /**
+     * Construct the object.
+     *
+     * @param player The player associated with this event
+     * @param position The position the event occurred at
+     * @param target The target of the event
+     */
+    public ItemUseBlacklistEvent(@Nullable LocalPlayer player, Vector position, Target target) {
+        super(player, position, target);
+    }
+
+    @Override
+    public String getDescription() {
+        return "use";
+    }
+
+    @Override
+    public EventType getEventType() {
+        return EventType.USE;
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/events/BlacklistEvent.java

@@ -1,85 +0,0 @@
-// $Id$
-/*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package com.sk89q.worldguard.blacklist.events;
-
-import com.sk89q.worldedit.Vector;
-import com.sk89q.worldguard.LocalPlayer;
-
-/**
- * Represents a blacklist event.
- * 
- * @author sk89q
- */
-public abstract class BlacklistEvent {
-    private Vector pos;
-    private int type;
-    
-    /**
-     * Holds the player that triggered the event.
-     */
-    private LocalPlayer player;
-    
-    /**
-     * Construct the object.
-     * 
-     * @param player The player associated with this event
-     * @param pos The position the event occurred at
-     * @param type The type of item used
-     */
-    public BlacklistEvent(LocalPlayer player, Vector pos, int type) {
-        this.player = player;
-        this.pos = pos;
-        this.type = type;
-    }
-    
-    /**
-     * Get the player.
-     *
-     * @return The player associated with this event
-     */
-    public LocalPlayer getPlayer() {
-        return player;
-    }
-    
-    /**
-     * Get the position.
-     * 
-     * @return The position of this event
-     */
-    public Vector getPosition() {
-        return pos;
-    }
-    
-    /**
-     * Get the item type.
-     * 
-     * @return The type associated with this event
-     */
-    public int getType() {
-        return type;
-    }
-    
-    /**
-     * Get a short description such as "break" or "destroy with."
-     * 
-     * @return The event description
-     */
-    public abstract String getDescription();
-}

src/main/java/com/sk89q/worldguard/blacklist/events/BlockBlacklistEvent.java

@@ -1,29 +0,0 @@
-// $Id$
-/*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package com.sk89q.worldguard.blacklist.events;
-
-import com.sk89q.worldedit.Vector;
-import com.sk89q.worldguard.LocalPlayer;
-
-public abstract class BlockBlacklistEvent extends BlacklistEvent {
-    public BlockBlacklistEvent(LocalPlayer player, Vector pos, int type) {
-        super(player, pos, type);
-    }
-}

src/main/java/com/sk89q/worldguard/blacklist/events/BlockBreakBlacklistEvent.java

@@ -1,34 +0,0 @@
-// $Id$
-/*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package com.sk89q.worldguard.blacklist.events;
-
-import com.sk89q.worldedit.Vector;
-import com.sk89q.worldguard.LocalPlayer;
-
-public class BlockBreakBlacklistEvent extends BlockBlacklistEvent {
-    public BlockBreakBlacklistEvent(LocalPlayer player, Vector pos, int type) {
-        super(player, pos, type);
-    }
-
-    @Override
-    public String getDescription() {
-        return "break";
-    }
-}

src/main/java/com/sk89q/worldguard/blacklist/events/BlockInteractBlacklistEvent.java

@@ -1,34 +0,0 @@
-// $Id$
-/*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package com.sk89q.worldguard.blacklist.events;
-
-import com.sk89q.worldedit.Vector;
-import com.sk89q.worldguard.LocalPlayer;
-
-public class BlockInteractBlacklistEvent extends BlockBlacklistEvent {
-    public BlockInteractBlacklistEvent(LocalPlayer player, Vector pos, int type) {
-        super(player, pos, type);
-    }
-
-    @Override
-    public String getDescription() {
-        return "interact with";
-    }
-}

src/main/java/com/sk89q/worldguard/blacklist/events/BlockPlaceBlacklistEvent.java

@@ -1,34 +0,0 @@
-// $Id$
-/*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package com.sk89q.worldguard.blacklist.events;
-
-import com.sk89q.worldedit.Vector;
-import com.sk89q.worldguard.LocalPlayer;
-
-public class BlockPlaceBlacklistEvent extends BlockBlacklistEvent {
-    public BlockPlaceBlacklistEvent(LocalPlayer player, Vector pos, int type) {
-        super(player, pos, type);
-    }
-
-    @Override
-    public String getDescription() {
-        return "place";
-    }
-}

src/main/java/com/sk89q/worldguard/blacklist/events/DestroyWithBlacklistEvent.java

@@ -1,34 +0,0 @@
-// $Id$
-/*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package com.sk89q.worldguard.blacklist.events;
-
-import com.sk89q.worldedit.Vector;
-import com.sk89q.worldguard.LocalPlayer;
-
-public class DestroyWithBlacklistEvent extends BlacklistEvent {
-    public DestroyWithBlacklistEvent(LocalPlayer player, Vector pos, int type) {
-        super(player, pos, type);
-    }
-
-    @Override
-    public String getDescription() {
-        return "destroy with";
-    }
-}

src/main/java/com/sk89q/worldguard/blacklist/events/ItemAcquireBlacklistEvent.java

@@ -1,34 +0,0 @@
-// $Id$
-/*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package com.sk89q.worldguard.blacklist.events;
-
-import com.sk89q.worldedit.Vector;
-import com.sk89q.worldguard.LocalPlayer;
-
-public class ItemAcquireBlacklistEvent extends ItemBlacklistEvent {
-    public ItemAcquireBlacklistEvent(LocalPlayer player, Vector pos, int type) {
-        super(player, pos, type);
-    }
-
-    @Override
-    public String getDescription() {
-        return "acquire";
-    }
-}

src/main/java/com/sk89q/worldguard/blacklist/events/ItemBlacklistEvent.java

@@ -1,29 +0,0 @@
-// $Id$
-/*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package com.sk89q.worldguard.blacklist.events;
-
-import com.sk89q.worldedit.Vector;
-import com.sk89q.worldguard.LocalPlayer;
-
-public abstract class ItemBlacklistEvent extends BlacklistEvent {
-    public ItemBlacklistEvent(LocalPlayer player, Vector pos, int type) {
-        super(player, pos, type);
-    }
-}

src/main/java/com/sk89q/worldguard/blacklist/events/ItemDropBlacklistEvent.java

@@ -1,34 +0,0 @@
-// $Id$
-/*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package com.sk89q.worldguard.blacklist.events;
-
-import com.sk89q.worldedit.Vector;
-import com.sk89q.worldguard.LocalPlayer;
-
-public class ItemDropBlacklistEvent extends ItemBlacklistEvent {
-    public ItemDropBlacklistEvent(LocalPlayer player, Vector pos, int type) {
-        super(player, pos, type);
-    }
-
-    @Override
-    public String getDescription() {
-        return "drop";
-    }
-}

src/main/java/com/sk89q/worldguard/blacklist/events/ItemUseBlacklistEvent.java

@@ -1,34 +0,0 @@
-// $Id$
-/*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package com.sk89q.worldguard.blacklist.events;
-
-import com.sk89q.worldedit.Vector;
-import com.sk89q.worldguard.LocalPlayer;
-
-public class ItemUseBlacklistEvent extends ItemBlacklistEvent {
-    public ItemUseBlacklistEvent(LocalPlayer player, Vector pos, int type) {
-        super(player, pos, type);
-    }
-
-    @Override
-    public String getDescription() {
-        return "use";
-    }
-}

src/main/java/com/sk89q/worldguard/blacklist/logger/ConsoleHandler.java

@@ -0,0 +1,63 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.logger;
+
+import com.sk89q.worldedit.blocks.ItemType;
+import com.sk89q.worldguard.blacklist.event.BlacklistEvent;
+
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+public class ConsoleHandler implements LoggerHandler {
+
+    private String worldName;
+    private final Logger logger;
+
+    public ConsoleHandler(String worldName, Logger logger) {
+        this.worldName = worldName;
+        this.logger = logger;
+    }
+
+    @Override
+    public void logEvent(BlacklistEvent event, String comment) {
+        logger.log(Level.INFO, "[" + worldName + "] " + event.getLoggerMessage() +
+                (comment != null ? " (" + comment + ")" : ""));
+    }
+
+    /**
+     * Get an item's friendly name with its ID.
+     *
+     * @param id The item id
+     * @return The friendly name of the item
+     */
+    private static String getFriendlyItemName(int id) {
+        ItemType type = ItemType.fromID(id);
+        if (type != null) {
+            return type.getName() + " (#" + id + ")";
+        } else {
+            return "#" + id;
+        }
+    }
+
+    @Override
+    public void close() {
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/logger/DatabaseHandler.java

@@ -0,0 +1,125 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.logger;
+
+import com.sk89q.worldedit.Vector;
+import com.sk89q.worldguard.LocalPlayer;
+import com.sk89q.worldguard.blacklist.event.BlacklistEvent;
+import com.sk89q.worldguard.blacklist.event.EventType;
+
+import javax.annotation.Nullable;
+import java.sql.Connection;
+import java.sql.DriverManager;
+import java.sql.PreparedStatement;
+import java.sql.SQLException;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+public class DatabaseHandler implements LoggerHandler {
+
+    private final String dsn;
+    private final String user;
+    private final String pass;
+    private final String table;
+    private final String worldName;
+    private Connection conn;
+    
+    private final Logger logger;
+
+    /**
+     * Construct the object.
+     *
+     * @param dsn The DSN for the connection
+     * @param user The username to connect with
+     * @param pass The password to connect with
+     * @param table The table to log to
+     * @param worldName The name of the world to log
+     * @param logger The logger to log errors to
+     */
+    public DatabaseHandler(String dsn, String user, String pass, String table, String worldName, Logger logger) {
+        this.dsn = dsn;
+        this.user = user;
+        this.pass = pass;
+        this.table = table;
+        this.worldName = worldName;
+        this.logger = logger;
+    }
+
+    /**
+     * Gets the database connection.
+     *
+     * @return The database connection
+     * @throws SQLException when the connection cannot be created
+     */
+    private Connection getConnection() throws SQLException {
+        if (conn == null || conn.isClosed()) {
+            conn = DriverManager.getConnection(dsn, user, pass);
+        }
+        return conn;
+    }
+
+    /**
+     * Log an event to the database.
+     *
+     * @param eventType The event type to log
+     * @param player The player associated with the event
+     * @param pos The location of the event
+     * @param item The item used
+     * @param comment The comment associated with the event
+     */
+    private void logEvent(EventType eventType, @Nullable LocalPlayer player, Vector pos, int item, String comment) {
+        try {
+            Connection conn = getConnection();
+            PreparedStatement stmt = conn.prepareStatement(
+                    "INSERT INTO " + table
+                      + "(event, world, player, x, y, z, item, time, comment) VALUES "
+                      + "(?, ?, ?, ?, ?, ?, ?, ?, ?)");
+            stmt.setString(1, eventType.name());
+            stmt.setString(2, worldName);
+            stmt.setString(3, player != null ? player.getName() : "");
+            stmt.setInt(4, pos.getBlockX());
+            stmt.setInt(5, pos.getBlockY());
+            stmt.setInt(6, pos.getBlockZ());
+            stmt.setInt(7, item);
+            stmt.setInt(8, (int)(System.currentTimeMillis() / 1000));
+            stmt.setString(9, comment);
+            stmt.executeUpdate();
+        } catch (SQLException e) {
+            logger.log(Level.SEVERE, "Failed to log blacklist event to database: " + e.getMessage());
+        }
+    }
+
+    @Override
+    public void logEvent(BlacklistEvent event, String comment) {
+        logEvent(event.getEventType(), event.getPlayer(), event.getLoggedPosition(), event.getTarget().getTypeId(), comment);
+    }
+
+    @Override
+    public void close() {
+        try {
+            if (conn != null && !conn.isClosed()) {
+                conn.close();
+            }
+        } catch (SQLException ignore) {
+
+        }
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/logger/FileHandler.java

@@ -1,23 +1,29 @@
-// $Id$
 /*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
  *
- * You should have received a copy of the GNU General Public License
+ * You should have received a copy of the GNU Lesser General Public License
  * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
+ */
 
-package com.sk89q.worldguard.blacklist.loggers;
+package com.sk89q.worldguard.blacklist.logger;
+
+import com.sk89q.worldedit.Vector;
+import com.sk89q.worldedit.blocks.ItemType;
+import com.sk89q.worldguard.LocalPlayer;
+import com.sk89q.worldguard.blacklist.event.BlacklistEvent;
+import com.sk89q.worldguard.blacklist.target.Target;
 
 import java.io.BufferedWriter;
 import java.io.File;
@@ -35,54 +41,26 @@ import java.util.logging.Logger;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 
-import com.sk89q.worldedit.Vector;
-import com.sk89q.worldedit.blocks.ItemType;
-import com.sk89q.worldguard.LocalPlayer;
-import com.sk89q.worldguard.blacklist.events.BlacklistEvent;
+public class FileHandler implements LoggerHandler {
 
-/**
- *
- * @author sk89q
- */
-public class FileLoggerHandler implements BlacklistLoggerHandler {
-    /**
-     * Regex for patterns in the path.
-     */
     private static Pattern pattern = Pattern.compile("%.");
-    /**
-     * Date format.
-     */
-    private static SimpleDateFormat dateFormat =
-            new SimpleDateFormat("yyyyy-MM-dd HH:mm:ss");
+    private static SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
 
-    /**
-     * Number of files to keep open at a time.
-     */
     private int cacheSize = 10;
-    /**
-     * Path pattern.
-     */
     private String pathPattern;
-    /**
-     * World name.
-     */
     private String worldName;
-    /**
-     * Cache of writers.
-     */
-    private TreeMap<String,FileLoggerWriter> writers =
-            new TreeMap<String,FileLoggerWriter>();
+    private TreeMap<String,LogFileWriter> writers = new TreeMap<String,LogFileWriter>();
     
     private final Logger logger;
 
     /**
      * Construct the object.
      *
-     * @param pathPattern The pattern for the logflie path
+     * @param pathPattern The pattern for the log file path
      * @param worldName The name of the world
      * @param logger The logger used to log errors
      */
-    public FileLoggerHandler(String pathPattern, String worldName, Logger logger) {
+    public FileHandler(String pathPattern, String worldName, Logger logger) {
         this.pathPattern = pathPattern;
         this.worldName = worldName;
         this.logger = logger;
@@ -96,7 +74,7 @@ public class FileLoggerHandler implements BlacklistLoggerHandler {
      * @param worldName The name of the associated world
      * @param logger The logger to log errors with
      */
-    public FileLoggerHandler(String pathPattern, int cacheSize, String worldName, Logger logger) {
+    public FileHandler(String pathPattern, int cacheSize, String worldName, Logger logger) {
         if (cacheSize < 1) {
             throw new IllegalArgumentException("Cache size cannot be less than 1");
         }
@@ -109,7 +87,7 @@ public class FileLoggerHandler implements BlacklistLoggerHandler {
     /**
      * Build the path.
      *
-     * @param playerName The name of the playername
+     * @param playerName The name of the player
      * @return The path for the logfile
      */
     private String buildPath(String playerName) {
@@ -178,7 +156,7 @@ public class FileLoggerHandler implements BlacklistLoggerHandler {
             String line = "[" + date + "] " + player.getName() + ": " + message
                     + (comment != null ? " (" + comment + ")" : "") + "\r\n";
 
-            FileLoggerWriter writer = writers.get(path);
+            LogFileWriter writer = writers.get(path);
 
             // Writer already exists!
             if (writer != null) {
@@ -204,17 +182,17 @@ public class FileLoggerHandler implements BlacklistLoggerHandler {
             BufferedWriter out = new BufferedWriter(stream);
             out.write(line);
             out.flush();
-            writer = new FileLoggerWriter(path, out);
+            writer = new LogFileWriter(path, out);
             writers.put(path, writer);
 
             // Check to make sure our cache doesn't get too big!
             if (writers.size() > cacheSize) {
-                Iterator<Map.Entry<String,FileLoggerWriter>> it =
+                Iterator<Map.Entry<String,LogFileWriter>> it =
                         writers.entrySet().iterator();
 
                 // Remove some entries
                 for (; it.hasNext(); ) {
-                    Map.Entry<String,FileLoggerWriter> entry = it.next();
+                    Map.Entry<String,LogFileWriter> entry = it.next();
                     try {
                         entry.getValue().getWriter().close();
                     } catch (IOException ignore) {
@@ -244,18 +222,13 @@ public class FileLoggerHandler implements BlacklistLoggerHandler {
         return "@" + pos.getBlockX() + "," + pos.getBlockY() + "," + pos.getBlockZ();
     }
 
-    private void logEvent(BlacklistEvent event, String text, int id, Vector pos, String comment) {
-        log(event.getPlayer(), "Tried to " + text + " " + getFriendlyItemName(id)
-                + " " + getCoordinates(pos), comment);
+    private void logEvent(BlacklistEvent event, String text, Target target, Vector pos, String comment) {
+        log(event.getPlayer(), "Tried to " + text + " " + target.getFriendlyName() + " " + getCoordinates(pos), comment);
     }
 
-    /**
-     * Log an event.
-     *
-     * @param event The event to log
-     */
+    @Override
     public void logEvent(BlacklistEvent event, String comment) {
-        logEvent(event, event.getDescription(), event.getType(), event.getPosition(), comment);
+        logEvent(event, event.getDescription(), event.getTarget(), event.getPosition(), comment);
     }
 
     /**
@@ -273,11 +246,9 @@ public class FileLoggerHandler implements BlacklistLoggerHandler {
         }
     }
 
-    /**
-     * Close handles.
-     */
+    @Override
     public void close() {
-        for (Map.Entry<String,FileLoggerWriter> entry : writers.entrySet()) {
+        for (Map.Entry<String,LogFileWriter> entry : writers.entrySet()) {
             try {
                 entry.getValue().getWriter().close();
             } catch (IOException ignore) {
@@ -286,4 +257,5 @@ public class FileLoggerHandler implements BlacklistLoggerHandler {
 
         writers.clear();
     }
+
 }

src/main/java/com/sk89q/worldguard/blacklist/logger/LogFileWriter.java

@@ -1,42 +1,31 @@
-// $Id$
 /*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
  *
- * You should have received a copy of the GNU General Public License
+ * You should have received a copy of the GNU Lesser General Public License
  * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
+ */
 
-package com.sk89q.worldguard.blacklist.loggers;
+package com.sk89q.worldguard.blacklist.logger;
 
+import javax.annotation.Nullable;
 import java.io.BufferedWriter;
 
-/**
- *
- * @author sk89q
- */
-public class FileLoggerWriter implements Comparable<FileLoggerWriter> {
-    /**
-     * Path.
-     */
+public class LogFileWriter implements Comparable<LogFileWriter> {
+
     public String path;
-    /**
-     * Writer.
-     */
     private BufferedWriter writer;
-    /**
-     * Last use.
-     */
     private long lastUse;
 
     /**
@@ -45,7 +34,7 @@ public class FileLoggerWriter implements Comparable<FileLoggerWriter> {
      * @param path The path to write to
      * @param writer The writer for the file
      */
-    public FileLoggerWriter(String path, BufferedWriter writer) {
+    public LogFileWriter(String path, BufferedWriter writer) {
         this.path = path;
         this.writer = writer;
         lastUse = System.currentTimeMillis();
@@ -81,8 +70,11 @@ public class FileLoggerWriter implements Comparable<FileLoggerWriter> {
         lastUse = System.currentTimeMillis();
     }
 
-    public int compareTo(FileLoggerWriter other) {
-        if (lastUse > other.lastUse) {
+    @Override
+    public int compareTo(@Nullable LogFileWriter other) {
+        if (other == null) {
+            return 1;
+        } else if (lastUse > other.lastUse) {
             return 1;
         } else if (lastUse < other.lastUse) {
             return -1;
@@ -90,4 +82,5 @@ public class FileLoggerWriter implements Comparable<FileLoggerWriter> {
             return 0;
         }
     }
+
 }

src/main/java/com/sk89q/worldguard/blacklist/logger/LoggerHandler.java

@@ -0,0 +1,42 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.logger;
+
+import com.sk89q.worldguard.blacklist.event.BlacklistEvent;
+
+/**
+ * Interface for loggers for the blacklist.
+ */
+public interface LoggerHandler {
+
+    /**
+     * Log an event.
+     *
+     * @param event The event
+     * @param comment The comment to log with the event
+     */
+    public void logEvent(BlacklistEvent event, String comment);
+
+    /**
+     * Close the logger.
+     */
+    public void close();
+
+}

src/main/java/com/sk89q/worldguard/blacklist/loggers/BlacklistLoggerHandler.java

@@ -1,42 +0,0 @@
-// $Id$
-/*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package com.sk89q.worldguard.blacklist.loggers;
-
-import com.sk89q.worldguard.blacklist.events.BlacklistEvent;
-
-/**
- * Interface for loggers for the blacklist.
- *
- * @author sk89q
- */
-public interface BlacklistLoggerHandler {
-    /**
-     * Log an event.
-     *
-     * @param event
-     * @param comment
-     */
-    public void logEvent(BlacklistEvent event, String comment);
-
-    /**
-     * Close the logger.
-     */
-    public void close();
-}

src/main/java/com/sk89q/worldguard/blacklist/loggers/ConsoleLoggerHandler.java

@@ -1,128 +0,0 @@
-// $Id$
-/*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package com.sk89q.worldguard.blacklist.loggers;
-
-import java.util.logging.Level;
-import java.util.logging.Logger;
-
-import com.sk89q.worldedit.blocks.ItemType;
-import com.sk89q.worldguard.blacklist.events.BlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.BlockBreakBlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.BlockInteractBlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.BlockPlaceBlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.DestroyWithBlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.ItemAcquireBlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.ItemDropBlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.ItemUseBlacklistEvent;
-
-/**
- *
- * @author sk89q
- */
-public class ConsoleLoggerHandler implements BlacklistLoggerHandler {
-
-
-    private String worldName;
-	
-    private final Logger logger;
-
-    public ConsoleLoggerHandler(String worldName, Logger logger) {
-        this.worldName = worldName;
-	    this.logger = logger;
-    }
-
-    public void logEvent(BlacklistEvent event, String comment) {
-        // Block break
-        if (event instanceof BlockBreakBlacklistEvent) {
-            BlockBreakBlacklistEvent evt = (BlockBreakBlacklistEvent)event;
-            logger.log(Level.INFO, "[" + worldName + "] " + event.getPlayer().getName()
-                    + " tried to break " + getFriendlyItemName(evt.getType())
-                    + (comment != null ? " (" + comment + ")" : ""));
-
-        // Block place
-        } else if (event instanceof BlockPlaceBlacklistEvent) {
-            BlockPlaceBlacklistEvent evt = (BlockPlaceBlacklistEvent)event;
-            logger.log(Level.INFO, "[" + worldName + "] " + event.getPlayer().getName()
-                    + " tried to place " + getFriendlyItemName(evt.getType())
-                    + (comment != null ? " (" + comment + ")" : ""));
-
-        // Block interact
-        } else if (event instanceof BlockInteractBlacklistEvent) {
-            BlockInteractBlacklistEvent evt = (BlockInteractBlacklistEvent)event;
-            logger.log(Level.INFO, "[" + worldName + "] " + event.getPlayer().getName()
-                    + " tried to interact with " + getFriendlyItemName(evt.getType())
-                    + (comment != null ? " (" + comment + ")" : ""));
-
-        // Destroy with
-        } else if (event instanceof DestroyWithBlacklistEvent) {
-            DestroyWithBlacklistEvent evt = (DestroyWithBlacklistEvent)event;
-            logger.log(Level.INFO, "[" + worldName + "] " + event.getPlayer().getName()
-                    + " tried to destroy with " + getFriendlyItemName(evt.getType())
-                    + (comment != null ? " (" + comment + ")" : ""));
-
-        // Acquire
-        } else if (event instanceof ItemAcquireBlacklistEvent) {
-            ItemAcquireBlacklistEvent evt = (ItemAcquireBlacklistEvent)event;
-            logger.log(Level.INFO, "[" + worldName + "] " + event.getPlayer().getName()
-                    + " tried to acquire " + getFriendlyItemName(evt.getType())
-                    + (comment != null ? " (" + comment + ")" : ""));
-
-        // Drop
-        } else if (event instanceof ItemDropBlacklistEvent) {
-            ItemDropBlacklistEvent evt = (ItemDropBlacklistEvent)event;
-            logger.log(Level.INFO, "[" + worldName + "] " + event.getPlayer().getName()
-                    + " tried to drop " + getFriendlyItemName(evt.getType())
-                    + (comment != null ? " (" + comment + ")" : ""));
-
-        // Use
-        } else if (event instanceof ItemUseBlacklistEvent) {
-            ItemUseBlacklistEvent evt = (ItemUseBlacklistEvent)event;
-            logger.log(Level.INFO, "[" + worldName + "] " + event.getPlayer().getName()
-                    + " tried to use " + getFriendlyItemName(evt.getType())
-                    + (comment != null ? " (" + comment + ")" : ""));
-
-        // Unknown
-        } else {
-            logger.log(Level.INFO, "[" + worldName + "] " + event.getPlayer().getName()
-                    + " caught unknown event: " + event.getClass().getCanonicalName());
-        }
-    }
-
-    /**
-     * Get an item's friendly name with its ID.
-     *
-     * @param id The item id
-     * @return The friendly name of the item
-     */
-    private static String getFriendlyItemName(int id) {
-        ItemType type = ItemType.fromID(id);
-        if (type != null) {
-            return type.getName() + " (#" + id + ")";
-        } else {
-            return "#" + id;
-        }
-    }
-
-    /**
-     * Close the connection.
-     */
-    public void close() {
-    }
-}

src/main/java/com/sk89q/worldguard/blacklist/loggers/DatabaseLoggerHandler.java

@@ -1,205 +0,0 @@
-// $Id$
-/*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package com.sk89q.worldguard.blacklist.loggers;
-
-import java.sql.Connection;
-import java.sql.DriverManager;
-import java.sql.PreparedStatement;
-import java.sql.SQLException;
-import java.util.logging.Level;
-import java.util.logging.Logger;
-
-import com.sk89q.worldedit.Vector;
-import com.sk89q.worldguard.LocalPlayer;
-import com.sk89q.worldguard.blacklist.events.BlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.BlockBreakBlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.BlockPlaceBlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.BlockInteractBlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.DestroyWithBlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.ItemAcquireBlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.ItemDropBlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.ItemUseBlacklistEvent;
-
-/**
- *
- * @author sk89q
- */
-public class DatabaseLoggerHandler implements BlacklistLoggerHandler {
-
-    /**
-     * DSN.
-     */
-    private final String dsn;
-    /**
-     * Username.
-     */
-    private final String user;
-    /**
-     * Password.
-     */
-    private final String pass;
-    /**
-     * Table.
-     */
-    private final String table;
-    /**
-     * World name.
-     */
-    private final String worldName;
-    /**
-     * Database connection.
-     */
-    private Connection conn;
-    
-    private final Logger logger;
-
-    /**
-     * Construct the object.
-     *
-     * @param dsn The DSN for the connection
-     * @param user The username to connect with
-     * @param pass The password to connect with
-     * @param table The table to log to
-     * @param worldName The name of the world to log
-     * @param logger The logger to log errors to
-     */
-    public DatabaseLoggerHandler(String dsn, String user, String pass, String table, String worldName, Logger logger) {
-        this.dsn = dsn;
-        this.user = user;
-        this.pass = pass;
-        this.table = table;
-        this.worldName = worldName;
-        this.logger = logger;
-    }
-
-    /**
-     * Gets the database connection.
-     *
-     * @return The database connection
-     * @throws SQLException when the connection cannot be created
-     */
-    private Connection getConnection() throws SQLException {
-        if (conn == null || conn.isClosed()) {
-            conn = DriverManager.getConnection(dsn, user, pass);
-        }
-        return conn;
-    }
-
-    /**
-     * Log an event to the database.
-     *
-     * @param event The event to log
-     * @param player The player associated with the event
-     * @param pos The location of the event
-     * @param item The item used
-     * @param comment The comment associated with the event
-     */
-    private void logEvent(String event, LocalPlayer player, Vector pos, int item,
-            String comment) {
-        try {
-            Connection conn = getConnection();
-            PreparedStatement stmt = conn.prepareStatement(
-                    "INSERT INTO " + table
-                  + "(event, world, player, x, y, z, item, time, comment) VALUES "
-                  + "(?, ?, ?, ?, ?, ?, ?, ?, ?)");
-            stmt.setString(1, event);
-            stmt.setString(2, worldName);
-            stmt.setString(3, player.getName());
-            stmt.setInt(4, pos.getBlockX());
-            stmt.setInt(5, pos.getBlockY());
-            stmt.setInt(6, pos.getBlockZ());
-            stmt.setInt(7, item);
-            stmt.setInt(8, (int)(System.currentTimeMillis() / 1000));
-            stmt.setString(9, comment);
-            stmt.executeUpdate();
-        } catch (SQLException e) {
-            logger.log(Level.SEVERE, "Failed to log blacklist event to database: "
-                    + e.getMessage());
-        }
-    }
-
-    /**
-     * Log an event.
-     *
-     * @param event The event to log
-     */
-    public void logEvent(BlacklistEvent event, String comment) {
-        // Block break
-        if (event instanceof BlockBreakBlacklistEvent) {
-            BlockBreakBlacklistEvent evt = (BlockBreakBlacklistEvent)event;
-            logEvent("BREAK", evt.getPlayer(), evt.getPosition(),
-                    evt.getType(), comment);
-
-        // Block place
-        } else if (event instanceof BlockPlaceBlacklistEvent) {
-            BlockPlaceBlacklistEvent evt = (BlockPlaceBlacklistEvent)event;
-            logEvent("PLACE", evt.getPlayer(), evt.getPosition(),
-                    evt.getType(), comment);
-
-        // Block interact
-        } else if (event instanceof BlockInteractBlacklistEvent) {
-            BlockInteractBlacklistEvent evt = (BlockInteractBlacklistEvent)event;
-            logEvent("INTERACT", evt.getPlayer(), evt.getPosition(),
-                    evt.getType(), comment);
-
-        // Destroy with
-        } else if (event instanceof DestroyWithBlacklistEvent) {
-            DestroyWithBlacklistEvent evt = (DestroyWithBlacklistEvent)event;
-            logEvent("DESTROY_WITH", evt.getPlayer(), evt.getPosition(),
-                    evt.getType(), comment);
-
-        // Acquire
-        } else if (event instanceof ItemAcquireBlacklistEvent) {
-            ItemAcquireBlacklistEvent evt = (ItemAcquireBlacklistEvent)event;
-            logEvent("ACQUIRE", evt.getPlayer(), evt.getPlayer().getPosition(),
-                    evt.getType(), comment);
-
-        // Drop
-        } else if (event instanceof ItemDropBlacklistEvent) {
-            ItemDropBlacklistEvent evt = (ItemDropBlacklistEvent)event;
-            logEvent("DROP", evt.getPlayer(), evt.getPlayer().getPosition(),
-                    evt.getType(), comment);
-
-        // Use
-        } else if (event instanceof ItemUseBlacklistEvent) {
-            ItemUseBlacklistEvent evt = (ItemUseBlacklistEvent)event;
-            logEvent("USE", evt.getPlayer(), evt.getPlayer().getPosition(),
-                    evt.getType(), comment);
-
-        // Unknown
-        } else {
-            logEvent("UNKNOWN", event.getPlayer(), event.getPlayer().getPosition(),
-                    -1, comment);
-        }
-    }
-
-    /**
-     * Close the connection.
-     */
-    public void close() {
-        try {
-            if (conn != null && !conn.isClosed()) {
-                conn.close();
-            }
-        } catch (SQLException ignore) {
-
-        }
-    }
-}

src/main/java/com/sk89q/worldguard/blacklist/target/DataMask.java

@@ -0,0 +1,28 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.target;
+
+import com.google.common.base.Predicate;
+
+/**
+ * Tests a data value.
+ */
+public interface DataMask extends Predicate<Short> {
+}

src/main/java/com/sk89q/worldguard/blacklist/target/DataValueRangeMatcher.java

@@ -0,0 +1,51 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.target;
+
+import com.google.common.base.Predicate;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+
+public class DataValueRangeMatcher implements TargetMatcher {
+
+    private final int typeId;
+    private final Predicate<Short> dataMatcher;
+
+    public DataValueRangeMatcher(int typeId, Predicate<Short> dataMatcher) {
+        checkNotNull(dataMatcher);
+        this.typeId = typeId;
+        this.dataMatcher = dataMatcher;
+    }
+
+    @Override
+    public int getMatchedTypeId() {
+        return typeId;
+    }
+
+    @Override
+    public boolean test(Target target) {
+        return typeId == target.getTypeId() && isDataInRange(target.getData());
+    }
+
+    private boolean isDataInRange(short data) {
+        return dataMatcher.apply(data);
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/target/MaterialTarget.java

@@ -0,0 +1,54 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.target;
+
+import com.sk89q.worldedit.blocks.ItemType;
+
+public class MaterialTarget implements Target {
+
+    private int id;
+    private short data;
+
+    public MaterialTarget(int id, short data) {
+        this.id = id;
+        this.data = data;
+    }
+
+    @Override
+    public int getTypeId() {
+        return id;
+    }
+
+    @Override
+    public short getData() {
+        return data;
+    }
+
+    @Override
+    public String getFriendlyName() {
+        ItemType type = ItemType.fromID(id);
+        if (type != null) {
+            return type.getName() + " (#" + id + ":" + data + ")";
+        } else {
+            return "#" + id + ":" + data;
+        }
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/target/RangeMask.java

@@ -0,0 +1,40 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.target;
+
+import com.google.common.collect.Range;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+
+public class RangeMask implements DataMask {
+
+    private final Range<Short> range;
+
+    public RangeMask(Range<Short> range) {
+        checkNotNull(range);
+        this.range = range;
+    }
+
+    @Override
+    public boolean apply(Short data) {
+        return range.contains(data);
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/target/Target.java

@@ -0,0 +1,48 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.target;
+
+/**
+ * A target is something that can have events attached to it.
+ */
+public interface Target {
+
+    /**
+     * Get the type ID.
+     *
+     * @return the type ID
+     */
+    int getTypeId();
+
+    /**
+     * Get the data value.
+     *
+     * @return the data value
+     */
+    short getData();
+
+    /**
+     * Get a friendly name to be printed.
+     *
+     * @return a friendly name
+     */
+    String getFriendlyName();
+
+}

src/main/java/com/sk89q/worldguard/blacklist/target/TargetMatcher.java

@@ -0,0 +1,42 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.target;
+
+/**
+ * Matches a {@link Target}.
+ */
+public interface TargetMatcher {
+
+    /**
+     * Get the matched type ID, which is merely used for indexing.
+     *
+     * @return the type ID
+     */
+    int getMatchedTypeId();
+
+    /**
+     * Return whether the given target is matched by this matcher.
+     *
+     * @param target the target
+     * @return true if matched
+     */
+    boolean test(Target target);
+
+}

src/main/java/com/sk89q/worldguard/blacklist/target/TargetMatcherParseException.java

@@ -0,0 +1,30 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.target;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+
+public class TargetMatcherParseException extends Exception {
+
+    public TargetMatcherParseException(String message) {
+        super(checkNotNull(message));
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/target/TargetMatcherParser.java

@@ -0,0 +1,123 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.target;
+
+import com.google.common.base.Predicate;
+import com.google.common.base.Predicates;
+import com.google.common.collect.Ranges;
+import com.sk89q.worldedit.blocks.ItemType;
+import com.sk89q.worldguard.util.Enums;
+import org.bukkit.Material;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
+public class TargetMatcherParser {
+
+    private static final Pattern DATA_VALUE_PATTERN = Pattern.compile("^([^:]+):([^:]+)$");
+    private static final Pattern LESS_THAN_PATTERN = Pattern.compile("^<=\\s*([0-9]+)$");
+    private static final Pattern GREATER_THAN_PATTERN = Pattern.compile("^>=\\s*([0-9]+)$");
+    private static final Pattern RANGE_PATTERN = Pattern.compile("^([0-9]+)\\s*-\\s*([0-9]+)$");
+
+    public TargetMatcher fromInput(String input) throws TargetMatcherParseException {
+        Matcher matcher = DATA_VALUE_PATTERN.matcher(input.trim());
+        if (matcher.matches()) {
+            return new DataValueRangeMatcher(parseType(matcher.group(1)), parseDataValueRanges(matcher.group(2)));
+        } else {
+            return new WildcardDataMatcher(parseType(input));
+        }
+    }
+
+    private int parseType(String input) throws TargetMatcherParseException {
+        input = input.trim();
+
+        try {
+            return Integer.parseInt(input);
+        } catch (NumberFormatException e) {
+            int id = getItemID(input);
+            if (id != 0) {
+                return id;
+            }
+            
+            Material material = Enums.findFuzzyByValue(Material.class, input);
+            if (material != null) {
+                return material.getId();
+            }
+
+            throw new TargetMatcherParseException("Unknown block or item name: " + input);
+        }
+    }
+
+    private Predicate<Short> parseDataValueRanges(String input) throws TargetMatcherParseException {
+        List<Predicate<Short>> predicates = new ArrayList<Predicate<Short>>();
+
+        for (String part : input.split(";")) {
+            predicates.add(parseRange(part));
+        }
+
+        return Predicates.or(predicates);
+    }
+
+    private Predicate<Short> parseRange(String input) throws TargetMatcherParseException {
+        input = input.trim();
+
+        Matcher matcher;
+
+        matcher = LESS_THAN_PATTERN.matcher(input);
+        if (matcher.matches()) {
+            return Ranges.atMost(Short.parseShort(matcher.group(1)));
+        }
+
+        matcher = GREATER_THAN_PATTERN.matcher(input);
+        if (matcher.matches()) {
+            return Ranges.atLeast(Short.parseShort(matcher.group(1)));
+        }
+
+        matcher = RANGE_PATTERN.matcher(input);
+        if (matcher.matches()) {
+            return Ranges.closed(Short.parseShort(matcher.group(1)), Short.parseShort(matcher.group(2)));
+        }
+
+        try {
+            short s = Short.parseShort(input);
+            return Ranges.closed(s, s);
+        } catch (NumberFormatException e) {
+            throw new TargetMatcherParseException("Unknown data value range: " + input);
+        }
+    }
+
+    /**
+     * Get an item's ID from its name.
+     *
+     * @param name the name of the item to look up
+     * @return the id for name if contained in ItemId, else -1
+     */
+    private static int getItemID(String name) {
+        ItemType type = ItemType.lookup(name);
+        if (type != null) {
+            return type.getID();
+        } else {
+            return -1;
+        }
+    }
+
+}

src/main/java/com/sk89q/worldguard/blacklist/target/WildcardDataMatcher.java

@@ -0,0 +1,40 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.blacklist.target;
+
+public class WildcardDataMatcher implements TargetMatcher {
+
+    private final int typeId;
+
+    public WildcardDataMatcher(int typeId) {
+        this.typeId = typeId;
+    }
+
+    @Override
+    public int getMatchedTypeId() {
+        return typeId;
+    }
+
+    @Override
+    public boolean test(Target target) {
+        return target.getTypeId() == typeId;
+    }
+
+}

src/main/java/com/sk89q/worldguard/bukkit/BukkitBlacklist.java

@@ -1,31 +1,34 @@
-// $Id$
 /*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
  *
- * You should have received a copy of the GNU General Public License
+ * You should have received a copy of the GNU Lesser General Public License
  * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
+ */
 
 package com.sk89q.worldguard.bukkit;
 
 import com.sk89q.worldguard.blacklist.Blacklist;
 
-public class BukkitBlacklist extends Blacklist {
+import java.util.logging.Logger;
+
+class BukkitBlacklist extends Blacklist {
+
     private WorldGuardPlugin plugin;
     
     public BukkitBlacklist(Boolean useAsWhitelist, WorldGuardPlugin plugin) {
-        super(useAsWhitelist, plugin.getLogger());
+        super(useAsWhitelist);
         this.plugin = plugin;
     }
     
@@ -33,4 +36,5 @@ public class BukkitBlacklist extends Blacklist {
     public void broadcastNotification(String msg) {
         plugin.broadcastNotification(msg);
     }
+
 }

src/main/java/com/sk89q/worldguard/bukkit/BukkitOfflinePlayer.java

@@ -0,0 +1,78 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.bukkit;
+
+import com.sk89q.worldedit.Vector;
+import com.sk89q.worldguard.LocalPlayer;
+import org.bukkit.OfflinePlayer;
+
+import java.util.UUID;
+
+class BukkitOfflinePlayer extends LocalPlayer {
+
+    private final OfflinePlayer player;
+
+    BukkitOfflinePlayer(OfflinePlayer offlinePlayer) {
+        this.player = offlinePlayer;
+    }
+
+    @Override
+    public String getName() {
+        return player.getName();
+    }
+
+    @Override
+    public UUID getUniqueId() {
+        return player.getUniqueId();
+    }
+
+    @Override
+    public boolean hasGroup(String group) {
+        return false;
+    }
+
+    @Override
+    public Vector getPosition() {
+        return Vector.ZERO;
+    }
+
+    @Override
+    public void kick(String msg) {
+    }
+
+    @Override
+    public void ban(String msg) {
+    }
+
+    @Override
+    public void printRaw(String msg) {
+    }
+
+    @Override
+    public String[] getGroups() {
+        return new String[0];
+    }
+
+    @Override
+    public boolean hasPermission(String perm) {
+        return false;
+    }
+
+}

src/main/java/com/sk89q/worldguard/bukkit/BukkitPlayer.java

@@ -1,21 +1,21 @@
-// $Id$
 /*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
  *
- * You should have received a copy of the GNU General Public License
+ * You should have received a copy of the GNU Lesser General Public License
  * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
+ */
 
 package com.sk89q.worldguard.bukkit;
 
@@ -25,18 +25,40 @@ import org.bukkit.entity.Player;
 import com.sk89q.worldedit.Vector;
 import com.sk89q.worldguard.LocalPlayer;
 
+import java.util.UUID;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+
 public class BukkitPlayer extends LocalPlayer {
-    private Player player;
-    private WorldGuardPlugin plugin;
-    
+
+    private final WorldGuardPlugin plugin;
+    private final Player player;
+    private final String name;
+    private final boolean silenced;
+
     public BukkitPlayer(WorldGuardPlugin plugin, Player player) {
+        this(plugin, player, false);
+    }
+
+    BukkitPlayer(WorldGuardPlugin plugin, Player player, boolean silenced) {
+        checkNotNull(plugin);
+        checkNotNull(player);
+
         this.plugin = plugin;
         this.player = player;
+        // getName() takes longer than before in newer versions of Minecraft
+        this.name = player.getName();
+        this.silenced = silenced;
     }
 
     @Override
     public String getName() {
-        return player.getName();
+        return name;
+    }
+
+    @Override
+    public UUID getUniqueId() {
+        return player.getUniqueId();
     }
 
     @Override
@@ -52,13 +74,17 @@ public class BukkitPlayer extends LocalPlayer {
 
     @Override
     public void kick(String msg) {
-        player.kickPlayer(msg);
+        if (!silenced) {
+            player.kickPlayer(msg);
+        }
     }
 
     @Override
     public void ban(String msg) {
-        player.setBanned(true);
-        player.kickPlayer(msg);
+        if (!silenced) {
+            player.setBanned(true);
+            player.kickPlayer(msg);
+        }
     }
 
     @Override
@@ -68,11 +94,18 @@ public class BukkitPlayer extends LocalPlayer {
 
     @Override
     public void printRaw(String msg) {
-        player.sendMessage(msg);
+        if (!silenced) {
+            player.sendMessage(msg);
+        }
     }
 
     @Override
     public boolean hasPermission(String perm) {
         return plugin.hasPermission(player, perm);
     }
+
+    public Player getPlayer() {
+        return player;
+    }
+
 }

src/main/java/com/sk89q/worldguard/bukkit/BukkitUtil.java

@@ -1,21 +1,21 @@
-// $Id$
 /*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
  *
- * You should have received a copy of the GNU General Public License
+ * You should have received a copy of the GNU Lesser General Public License
  * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
+ */
 
 package com.sk89q.worldguard.bukkit;
 
@@ -24,22 +24,28 @@ import com.sk89q.worldedit.Vector;
 import com.sk89q.worldedit.blocks.BlockID;
 import com.sk89q.worldedit.blocks.BlockType;
 import com.sk89q.worldedit.blocks.ItemID;
+import com.sk89q.worldguard.blacklist.target.MaterialTarget;
+import com.sk89q.worldguard.blacklist.target.Target;
 import org.bukkit.ChatColor;
 import org.bukkit.Location;
+import org.bukkit.Material;
 import org.bukkit.Server;
 import org.bukkit.World;
 import org.bukkit.block.Block;
 import org.bukkit.entity.Entity;
-import org.bukkit.entity.LivingEntity;
-import org.bukkit.entity.Tameable;
 import org.bukkit.entity.ExperienceOrb;
 import org.bukkit.entity.FallingBlock;
 import org.bukkit.entity.Item;
-import org.bukkit.entity.TNTPrimed;
+import org.bukkit.entity.LivingEntity;
 import org.bukkit.entity.Player;
+import org.bukkit.entity.TNTPrimed;
+import org.bukkit.entity.Tameable;
 import org.bukkit.inventory.ItemStack;
+
 import java.util.List;
 
+import static com.google.common.base.Preconditions.checkNotNull;
+
 public class BukkitUtil {
 
     private BukkitUtil()  {
@@ -294,4 +300,54 @@ public class BukkitUtil {
 
         return null;
     }
+
+    /**
+     * Get a blacklist target for the given block.
+     *
+     * @param block the block
+     * @return a target
+     */
+    public static Target createTarget(Block block) {
+        checkNotNull(block);
+        return new MaterialTarget(block.getTypeId(), block.getData());
+    }
+
+    /**
+     * Get a blacklist target for the given block.
+     *
+     * @param block the block
+     * @param material a fallback material
+     * @return a target
+     */
+    public static Target createTarget(Block block, Material material) {
+        checkNotNull(material);
+        if (block.getType() == material) {
+            return new MaterialTarget(block.getTypeId(), block.getData());
+        } else {
+            return new MaterialTarget(material.getId(), (short) 0);
+        }
+    }
+
+    /**
+     * Get a blacklist target for the given item.
+     *
+     * @param item the item
+     * @return a target
+     */
+    public static Target createTarget(ItemStack item) {
+        checkNotNull(item);
+        return new MaterialTarget(item.getTypeId(), item.getDurability());
+    }
+
+    /**
+     * Get a blacklist target for the given material.
+     *
+     * @param material the material
+     * @return a target
+     */
+    public static Target createTarget(Material material) {
+        checkNotNull(material);
+        return new MaterialTarget(material.getId(), (short) 0);
+    }
+
 }

src/main/java/com/sk89q/worldguard/bukkit/ConfigurationManager.java

@@ -1,29 +1,35 @@
-// $Id$
 /*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
  *
- * You should have received a copy of the GNU General Public License
+ * You should have received a copy of the GNU Lesser General Public License
  * along with this program. If not, see <http://www.gnu.org/licenses/>.
  */
+
 package com.sk89q.worldguard.bukkit;
 
+import com.google.common.collect.ImmutableMap;
 import com.sk89q.commandbook.CommandBook;
 import com.sk89q.commandbook.GodComponent;
 import com.sk89q.util.yaml.YAMLFormat;
 import com.sk89q.util.yaml.YAMLProcessor;
 import com.sk89q.worldguard.LocalPlayer;
-import com.sk89q.worldguard.blacklist.Blacklist;
+import com.sk89q.worldguard.protection.managers.storage.file.DirectoryYamlDriver;
+import com.sk89q.worldguard.protection.managers.storage.DriverType;
+import com.sk89q.worldguard.protection.managers.storage.RegionDriver;
+import com.sk89q.worldguard.protection.managers.storage.sql.SQLDriver;
+import com.sk89q.worldguard.util.sql.DataSourceConfig;
 import org.bukkit.World;
 import org.bukkit.entity.Player;
 
@@ -35,6 +41,7 @@ import java.util.Map;
 import java.util.Set;
 import java.util.concurrent.ConcurrentHashMap;
 import java.util.concurrent.ConcurrentMap;
+import java.util.logging.Logger;
 
 /**
  * Represents the global configuration and also delegates configuration
@@ -45,6 +52,8 @@ import java.util.concurrent.ConcurrentMap;
  */
 public class ConfigurationManager {
 
+    private static final Logger log = Logger.getLogger(ConfigurationManager.class.getCanonicalName());
+
     private static final String CONFIG_HEADER = "#\r\n" +
             "# WorldGuard's main configuration file\r\n" +
             "#\r\n" +
@@ -66,30 +75,11 @@ public class ConfigurationManager {
             "# - Lines starting with # are comments and so they are ignored.\r\n" +
             "#\r\n";
 
-    /**
-     * Reference to the plugin.
-     */
     private WorldGuardPlugin plugin;
-
-    /**
-     * Holds configurations for different worlds.
-     */
     private ConcurrentMap<String, WorldConfiguration> worlds;
-
-    /**
-     * The global configuration for use when loading worlds
-     */
     private YAMLProcessor config;
-
-    /**
-     * List of people with god mode.
-     */
     @Deprecated
     private Set<String> hasGodMode = new HashSet<String>();
-
-    /**
-     * List of people who can breathe underwater.
-     */
     private Set<String> hasAmphibious = new HashSet<String>();
 
     private boolean hasCommandBookGodMode = false;
@@ -97,20 +87,22 @@ public class ConfigurationManager {
     public boolean useRegionsScheduler;
     public boolean useRegionsCreatureSpawnEvent;
     public boolean activityHaltToggle = false;
-    public boolean autoGodMode;
+    public boolean useGodPermission;
+    public boolean useGodGroup;
+    public boolean useAmphibiousGroup;
     public boolean usePlayerMove;
     public boolean usePlayerTeleports;
     public boolean deopOnJoin;
     public boolean blockInGameOp;
+    public boolean migrateRegionsToUuid;
+    public boolean keepUnresolvedNames;
     public Map<String, String> hostKeys = new HashMap<String, String>();
 
     /**
      * Region Storage Configuration method, and config values
      */
-    public boolean useSqlDatabase = false;
-    public String sqlDsn;
-    public String sqlUsername;
-    public String sqlPassword;
+    public RegionDriver selectedRegionStoreDriver;
+    public Map<DriverType, RegionDriver> regionStoreDriverMap;
 
     /**
      * Construct the object.
@@ -122,6 +114,25 @@ public class ConfigurationManager {
         this.worlds = new ConcurrentHashMap<String, WorldConfiguration>();
     }
 
+    /**
+     * Get the folder for storing data files and configuration.
+     *
+     * @return the data folder
+     */
+    public File getDataFolder() {
+        return plugin.getDataFolder();
+    }
+
+    /**
+     * Get the folder for storing data files and configuration for each
+     * world.
+     *
+     * @return the data folder
+     */
+    public File getWorldsDataFolder() {
+        return new File(getDataFolder(), "worlds");
+    }
+
     /**
      * Load the configuration.
      */
@@ -135,14 +146,18 @@ public class ConfigurationManager {
         try {
             config.load();
         } catch (IOException e) {
-            plugin.getLogger().severe("Error reading configuration for global config: ");
+            log.severe("Error reading configuration for global config: ");
             e.printStackTrace();
         }
 
         config.removeProperty("suppress-tick-sync-warnings");
         useRegionsScheduler = config.getBoolean("regions.use-scheduler", true);
+        migrateRegionsToUuid = config.getBoolean("regions.uuid-migration.perform-on-next-start", true);
+        keepUnresolvedNames = config.getBoolean("regions.uuid-migration.keep-names-that-lack-uuids", true);
         useRegionsCreatureSpawnEvent = config.getBoolean("regions.use-creature-spawn-event", true);
-        autoGodMode = config.getBoolean("auto-invincible", config.getBoolean("auto-invincible-permission", false));
+        useGodPermission = config.getBoolean("auto-invincible", config.getBoolean("auto-invincible-permission", false));
+        useGodGroup = config.getBoolean("auto-invincible-group", false);
+        useAmphibiousGroup = config.getBoolean("auto-no-drowning-group", false);
         config.removeProperty("auto-invincible-permission");
         usePlayerMove = config.getBoolean("use-player-move-event", true);
         usePlayerTeleports = config.getBoolean("use-player-teleports", true);
@@ -162,12 +177,25 @@ public class ConfigurationManager {
             }
         }
 
-        useSqlDatabase = config.getBoolean(
-                "regions.sql.use", false);
+        // ====================================================================
+        // Region store drivers
+        // ====================================================================
 
-        sqlDsn = config.getString("regions.sql.dsn", "jdbc:mysql://localhost/worldguard");
-        sqlUsername = config.getString("regions.sql.username", "worldguard");
-        sqlPassword = config.getString("regions.sql.password", "worldguard");
+        boolean useSqlDatabase = config.getBoolean("regions.sql.use", false);
+        String sqlDsn = config.getString("regions.sql.dsn", "jdbc:mysql://localhost/worldguard");
+        String sqlUsername = config.getString("regions.sql.username", "worldguard");
+        String sqlPassword = config.getString("regions.sql.password", "worldguard");
+        String sqlTablePrefix = config.getString("regions.sql.table-prefix", "");
+
+        DataSourceConfig dataSourceConfig = new DataSourceConfig(sqlDsn, sqlUsername, sqlPassword, sqlTablePrefix);
+        SQLDriver sqlDriver = new SQLDriver(dataSourceConfig);
+        DirectoryYamlDriver yamlDriver = new DirectoryYamlDriver(getWorldsDataFolder(), "regions.yml");
+
+        this.regionStoreDriverMap = ImmutableMap.<DriverType, RegionDriver>builder()
+                .put(DriverType.MYSQL, sqlDriver)
+                .put(DriverType.YAML, yamlDriver)
+                .build();
+        this.selectedRegionStoreDriver = useSqlDatabase ? sqlDriver : yamlDriver;
 
         // Load configurations for each world
         for (World world : plugin.getServer().getWorlds()) {
@@ -175,10 +203,6 @@ public class ConfigurationManager {
         }
 
         config.setHeader(CONFIG_HEADER);
-
-        if (!config.save()) {
-            plugin.getLogger().severe("Error saving configuration!");
-        }
     }
 
     /**
@@ -188,6 +212,13 @@ public class ConfigurationManager {
         worlds.clear();
     }
 
+    public void disableUuidMigration() {
+        config.setProperty("regions.uuid-migration.perform-on-next-start", false);
+        if (!config.save()) {
+            log.severe("Error saving configuration!");
+        }
+    }
+
     /**
      * Get the configuration for a world.
      *
@@ -216,16 +247,6 @@ public class ConfigurationManager {
      * @param player The player to forget about
      */
     public void forgetPlayer(LocalPlayer player) {
-        for (Map.Entry<String, WorldConfiguration> entry
-                : worlds.entrySet()) {
-
-            // The blacklist needs to forget players
-            Blacklist bl = entry.getValue().getBlacklist();
-            if (bl != null) {
-                bl.forgetPlayer(player);
-            }
-        }
-
         hasGodMode.remove(player.getName());
         hasAmphibious.remove(player.getName());
     }

src/main/java/com/sk89q/worldguard/bukkit/LegacyWorldGuardMigration.java

@@ -1,154 +0,0 @@
-// $Id$
-/*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package com.sk89q.worldguard.bukkit;
-
-import java.io.File;
-import java.io.FileInputStream;
-import java.io.FileNotFoundException;
-import java.io.FileOutputStream;
-import java.io.IOException;
-import java.io.InputStream;
-import java.io.OutputStream;
-import org.bukkit.World;
-
-import com.sk89q.worldguard.protection.databases.ProtectionDatabaseException;
-import com.sk89q.worldguard.protection.databases.CSVDatabase;
-import com.sk89q.worldguard.protection.managers.RegionManager;
-
-/**
- * Utility methods for porting from legacy versions.
- * 
- * @author sk89q
- */
-public class LegacyWorldGuardMigration {
-    
-    /**
-     * Port over the blacklist.
-     * 
-     * @param plugin The plugin instance
-     */
-    public static void migrateBlacklist(WorldGuardPlugin plugin) {
-        World mainWorld = plugin.getServer().getWorlds().get(0);
-        String mainWorldName = mainWorld.getName();
-        String newPath = "worlds/" + mainWorldName + "/blacklist.txt";
-        
-        File oldFile = new File(plugin.getDataFolder(), "blacklist.txt");
-        File newFile = new File(plugin.getDataFolder(), newPath);
-        
-        if (!newFile.exists() && oldFile.exists()) {
-            plugin.getLogger().warning("WorldGuard will now update your blacklist "
-                    + "from an older version of WorldGuard.");
-            
-            // Need to make root directories
-            newFile.getParentFile().mkdirs();
-            
-            if (copyFile(oldFile, newFile)) {
-                oldFile.renameTo(new File(plugin.getDataFolder(),
-                        "blacklist.txt.old"));
-            } else {
-                plugin.getLogger().warning("blacklist.txt has been converted " +
-                        "for the main world at " + newPath + "");
-                plugin.getLogger().warning("Your other worlds currently have no " +
-                		"blacklist defined!");
-            }
-            
-        }
-    }
-
-    /**
-     * Migrate region settings.
-     * 
-     * @param plugin The plugin instance
-     */
-    public static void migrateRegions(WorldGuardPlugin plugin) {
-        try {
-            File oldDatabase = new File(plugin.getDataFolder(), "regions.txt");
-            if (!oldDatabase.exists()) return;
-            
-            plugin.getLogger().info("The regions database has changed in 5.x. "
-                    + "Your old regions database will be converted to the new format "
-                    + "and set as your primary world's database.");
-
-            World w = plugin.getServer().getWorlds().get(0);
-            RegionManager mgr = plugin.getGlobalRegionManager().get(w);
-
-            // First load up the old database using the CSV loader
-            CSVDatabase db = new CSVDatabase(oldDatabase, plugin.getLogger());
-            db.load();
-            
-            // Then save the new database
-            mgr.setRegions(db.getRegions());
-            mgr.save();
-            
-            oldDatabase.renameTo(new File(plugin.getDataFolder(), "regions.txt.old"));
-
-            plugin.getLogger().info("Regions database converted!");
-        } catch (ProtectionDatabaseException e) {
-            plugin.getLogger().warning("Failed to load regions: "
-                    + e.getMessage());
-        }
-    }
-
-    /**
-     * Copies a file.
-     * 
-     * @param from The source file
-     * @param to The destination file
-     * @return true if successful
-     */
-    private static boolean copyFile(File from, File to) {
-        InputStream in = null;
-        OutputStream out = null;
-        
-        try {
-            in = new FileInputStream(from);
-            out = new FileOutputStream(to);
-
-            byte[] buf = new byte[1024];
-            int len;
-            while ((len = in.read(buf)) > 0) {
-                out.write(buf, 0, len);
-            }
-            
-            in.close();
-            out.close();
-            
-            return true;
-        } catch (FileNotFoundException ignore) {
-        } catch (IOException ignore) {
-        } finally {
-            if (in != null) {
-                try {
-                    in.close();
-                } catch (IOException ignore) {
-                }
-            }
-            
-            if (out != null) {
-                try {
-                    out.close();
-                } catch (IOException ignore) {
-                }
-            }
-        }
-        
-        return false;
-    }
-}

src/main/java/com/sk89q/worldguard/bukkit/ProtectionQuery.java

@@ -0,0 +1,153 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.bukkit;
+
+import com.sk89q.worldguard.bukkit.cause.Cause;
+import com.sk89q.worldguard.bukkit.event.block.BreakBlockEvent;
+import com.sk89q.worldguard.bukkit.event.block.PlaceBlockEvent;
+import com.sk89q.worldguard.bukkit.event.block.UseBlockEvent;
+import com.sk89q.worldguard.bukkit.event.entity.DamageEntityEvent;
+import com.sk89q.worldguard.bukkit.event.entity.SpawnEntityEvent;
+import com.sk89q.worldguard.bukkit.event.entity.UseEntityEvent;
+import org.bukkit.Location;
+import org.bukkit.Material;
+import org.bukkit.block.Block;
+import org.bukkit.entity.Entity;
+import org.bukkit.entity.EntityType;
+
+import javax.annotation.Nullable;
+
+import static com.sk89q.worldguard.bukkit.event.DelegateEvents.setSilent;
+import static com.sk89q.worldguard.bukkit.util.Events.fireAndTestCancel;
+
+/**
+ * A helper class to query whether a block or entity is protected by
+ * WorldGuard.
+ */
+public class ProtectionQuery {
+
+    /**
+     * Test whether a block can be placed at a given location.
+     *
+     * <p>The cause does not have to be a player. It can be {@code null}
+     * if the cause is not known, although the checks will executed
+     * assuming that the actor is a non-member of all regions.</p>
+     *
+     * @param cause the cause, which can be a block, an entity, or a player, or {@code null} if unknown
+     * @param location the location of the block
+     * @param newMaterial the new material
+     * @return true if the action is permitted
+     */
+    public boolean testBlockPlace(@Nullable Object cause, Location location, Material newMaterial) {
+        return !fireAndTestCancel(setSilent(new PlaceBlockEvent(null, Cause.create(cause), location, newMaterial)));
+    }
+
+    /**
+     * Test whether a block can be broken.
+     *
+     * <p>The cause does not have to be a player. It can be {@code null}
+     * if the cause is not known, although the checks will executed
+     * assuming that the actor is a non-member of all regions.</p>
+     *
+     * @param cause the cause, which can be a block, an entity, or a player, or {@code null} if unknown
+     * @param block the block broken
+     * @return true if the action is permitted
+     */
+    public boolean testBlockBreak(@Nullable Object cause, Block block) {
+        return !fireAndTestCancel(setSilent(new BreakBlockEvent(null, Cause.create(cause), block)));
+    }
+
+    /**
+     * Test whether a block can be interacted with.
+     *
+     * <p>The cause does not have to be a player. It can be {@code null}
+     * if the cause is not known, although the checks will executed
+     * assuming that the actor is a non-member of all regions.</p>
+     *
+     * @param cause the cause, which can be a block, an entity, or a player, or {@code null} if unknown
+     * @param block the block that is interacted with
+     * @return true if the action is permitted
+     */
+    public boolean testBlockInteract(@Nullable Object cause, Block block) {
+        return !fireAndTestCancel(setSilent(new UseBlockEvent(null, Cause.create(cause), block)));
+    }
+
+    /**
+     * Test whether an entity can be placed.
+     *
+     * <p>The cause does not have to be a player. It can be {@code null}
+     * if the cause is not known, although the checks will executed
+     * assuming that the actor is a non-member of all regions.</p>
+     *
+     * @param cause the cause, which can be a block, an entity, or a player, or {@code null} if unknown
+     * @param location the location that the entity will be spawned at
+     * @param type the type that is to be spawned
+     * @return true if the action is permitted
+     */
+    public boolean testEntityPlace(@Nullable Object cause, Location location, EntityType type) {
+        return !fireAndTestCancel(setSilent(new SpawnEntityEvent(null, Cause.create(cause), location, type)));
+    }
+
+    /**
+     * Test whether an entity can be destroyed.
+     *
+     * <p>The cause does not have to be a player. It can be {@code null}
+     * if the cause is not known, although the checks will executed
+     * assuming that the actor is a non-member of all regions.</p>
+     *
+     * @param cause the cause, which can be a block, an entity, or a player, or {@code null} if unknown
+     * @param entity the entity broken
+     * @return true if the action is permitted
+     */
+    public boolean testEntityDestroy(@Nullable Object cause, Entity entity) {
+        return !fireAndTestCancel(setSilent(new SpawnEntityEvent(null, Cause.create(cause), entity)));
+    }
+
+    /**
+     * Test whether an entity can be interacted with.
+     *
+     * <p>The cause does not have to be a player. It can be {@code null}
+     * if the cause is not known, although the checks will executed
+     * assuming that the actor is a non-member of all regions.</p>
+     *
+     * @param cause the cause, which can be a block, an entity, or a player, or {@code null} if unknown
+     * @param entity the entity interacted with
+     * @return true if the action is permitted
+     */
+    public boolean testEntityInteract(@Nullable Object cause, Entity entity) {
+        return !fireAndTestCancel(setSilent(new UseEntityEvent(null, Cause.create(cause), entity)));
+    }
+
+    /**
+     * Test whether an entity can be damaged.
+     *
+     * <p>The cause does not have to be a player. It can be {@code null}
+     * if the cause is not known, although the checks will executed
+     * assuming that the actor is a non-member of all regions.</p>
+     *
+     * @param cause the cause, which can be a block, an entity, or a player, or {@code null} if unknown
+     * @param entity the entity damaged
+     * @return true if the action is permitted
+     */
+    public boolean testEntityDamage(@Nullable Object cause, Entity entity) {
+        return !fireAndTestCancel(setSilent(new DamageEntityEvent(null, Cause.create(cause), entity)));
+    }
+
+}

src/main/java/com/sk89q/worldguard/bukkit/QueryCache.java

@@ -0,0 +1,117 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.bukkit;
+
+import com.sk89q.worldguard.protection.ApplicableRegionSet;
+import com.sk89q.worldguard.protection.RegionResultSet;
+import com.sk89q.worldguard.protection.managers.RegionManager;
+import org.bukkit.Location;
+import org.bukkit.World;
+
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.ConcurrentMap;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+
+/**
+ * Keeps a cache of {@link RegionResultSet}s. The contents of the cache
+ * must be externally invalidated occasionally (and frequently).
+ *
+ * <p>This class is fully concurrent.</p>
+ */
+class QueryCache {
+
+    private final ConcurrentMap<CacheKey, ApplicableRegionSet> cache = new ConcurrentHashMap<CacheKey, ApplicableRegionSet>(16, 0.75f, 2);
+
+    /**
+     * Get from the cache a {@code ApplicableRegionSet} if an entry exists;
+     * otherwise, query the given manager for a result and cache it.
+     *
+     * @param manager the region manager
+     * @param location the location
+     * @return a result
+     */
+    public ApplicableRegionSet queryContains(RegionManager manager, Location location) {
+        checkNotNull(manager);
+        checkNotNull(location);
+
+        CacheKey key = new CacheKey(location);
+        ApplicableRegionSet result = cache.get(key);
+        if (result == null) {
+            result = manager.getApplicableRegions(location);
+            cache.put(key, result);
+        }
+
+        return result;
+    }
+
+    /**
+     * Invalidate the cache and clear its contents.
+     */
+    public void invalidateAll() {
+        cache.clear();
+    }
+
+    /**
+     * Key object for the map.
+     */
+    private static class CacheKey {
+        private final World world;
+        private final int x;
+        private final int y;
+        private final int z;
+        private final int hashCode;
+
+        private CacheKey(Location location) {
+            this.world = location.getWorld();
+            this.x = location.getBlockX();
+            this.y = location.getBlockY();
+            this.z = location.getBlockZ();
+
+            // Pre-compute hash code
+            int result = world.hashCode();
+            result = 31 * result + x;
+            result = 31 * result + y;
+            result = 31 * result + z;
+            this.hashCode = result;
+        }
+
+        @Override
+        public boolean equals(Object o) {
+            if (this == o) return true;
+            if (o == null || getClass() != o.getClass()) return false;
+
+            CacheKey cacheKey = (CacheKey) o;
+
+            if (x != cacheKey.x) return false;
+            if (y != cacheKey.y) return false;
+            if (z != cacheKey.z) return false;
+            if (!world.equals(cacheKey.world)) return false;
+
+            return true;
+        }
+
+        @Override
+        public int hashCode() {
+            return hashCode;
+        }
+    }
+
+}

src/main/java/com/sk89q/worldguard/bukkit/RegionContainer.java

@@ -0,0 +1,311 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.bukkit;
+
+import com.sk89q.worldedit.Vector2D;
+import com.sk89q.worldguard.protection.managers.RegionContainerImpl;
+import com.sk89q.worldguard.protection.managers.RegionManager;
+import com.sk89q.worldguard.protection.managers.migration.Migration;
+import com.sk89q.worldguard.protection.managers.migration.MigrationException;
+import com.sk89q.worldguard.protection.managers.migration.UUIDMigration;
+import com.sk89q.worldguard.protection.managers.storage.RegionDriver;
+import org.bukkit.Bukkit;
+import org.bukkit.Chunk;
+import org.bukkit.World;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.Listener;
+import org.bukkit.event.world.ChunkLoadEvent;
+import org.bukkit.event.world.ChunkUnloadEvent;
+import org.bukkit.event.world.WorldLoadEvent;
+import org.bukkit.event.world.WorldUnloadEvent;
+
+import javax.annotation.Nullable;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import java.util.Set;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+
+/**
+ * A region container creates {@link RegionManager}s for loaded worlds, which
+ * allows access to the region data of a world. Generally, only data is
+ * loaded for worlds that are loaded in the server.
+ *
+ * <p>This class is thread safe and its contents can be accessed from
+ * multiple concurrent threads.</p>
+ *
+ * <p>An instance of this class can be retrieved using
+ * {@link WorldGuardPlugin#getRegionContainer()}.</p>
+ */
+public class RegionContainer {
+
+    private static final Logger log = Logger.getLogger(RegionContainer.class.getCanonicalName());
+
+    /**
+     * Invalidation frequency in ticks.
+     */
+    private static final int CACHE_INVALIDATION_INTERVAL = 2;
+
+    private final Object lock = new Object();
+    private final WorldGuardPlugin plugin;
+    private final QueryCache cache = new QueryCache();
+    private RegionContainerImpl container;
+
+    /**
+     * Create a new instance.
+     *
+     * @param plugin the plugin
+     */
+    RegionContainer(WorldGuardPlugin plugin) {
+        this.plugin = plugin;
+    }
+
+    /**
+     * Initialize the region container.
+     */
+    void initialize() {
+        ConfigurationManager config = plugin.getGlobalStateManager();
+        container = new RegionContainerImpl(config.selectedRegionStoreDriver);
+
+        // Migrate to UUIDs
+        autoMigrate();
+
+        loadWorlds();
+
+        Bukkit.getPluginManager().registerEvents(new Listener() {
+            @EventHandler
+            public void onWorldLoad(WorldLoadEvent event) {
+                load(event.getWorld());
+            }
+
+            @EventHandler
+            public void onWorldUnload(WorldUnloadEvent event) {
+                unload(event.getWorld());
+            }
+
+            @EventHandler
+            public void onChunkLoad(ChunkLoadEvent event) {
+                RegionManager manager = get(event.getWorld());
+                if (manager != null) {
+                    Chunk chunk = event.getChunk();
+                    manager.loadChunk(new Vector2D(chunk.getX(), chunk.getZ()));
+                }
+            }
+
+            @EventHandler
+            public void onChunkUnload(ChunkUnloadEvent event) {
+                RegionManager manager = get(event.getWorld());
+                if (manager != null) {
+                    Chunk chunk = event.getChunk();
+                    manager.unloadChunk(new Vector2D(chunk.getX(), chunk.getZ()));
+                }
+            }
+        }, plugin);
+
+        Bukkit.getScheduler().scheduleSyncRepeatingTask(plugin, new Runnable() {
+            @Override
+            public void run() {
+                cache.invalidateAll();
+            }
+        }, CACHE_INVALIDATION_INTERVAL, CACHE_INVALIDATION_INTERVAL);
+    }
+
+    /**
+     * Save data and unload.
+     */
+    void unload() {
+        synchronized (lock) {
+            container.unloadAll();
+        }
+    }
+
+    /**
+     * Get the region store driver.
+     *
+     * @return the driver
+     */
+    public RegionDriver getDriver() {
+        return container.getDriver();
+    }
+
+    /**
+     * Try loading the region managers for all currently loaded worlds.
+     */
+    private void loadWorlds() {
+        synchronized (lock) {
+            for (World world : Bukkit.getServer().getWorlds()) {
+                load(world);
+            }
+        }
+    }
+
+    /**
+     * Reload the region container.
+     *
+     * <p>This method may block until the data for all loaded worlds has been
+     * unloaded and new data has been loaded.</p>
+     */
+    public void reload() {
+        synchronized (lock) {
+            unload();
+            loadWorlds();
+        }
+    }
+
+    /**
+     * Load the region data for a world if it has not been loaded already.
+     *
+     * @param world the world
+     * @return a region manager, either returned from the cache or newly loaded
+     */
+    @Nullable
+    private RegionManager load(World world) {
+        checkNotNull(world);
+
+        WorldConfiguration config = plugin.getGlobalStateManager().get(world);
+        if (!config.useRegions) {
+            return null;
+        }
+
+        RegionManager manager;
+
+        synchronized (lock) {
+            manager = container.load(world.getName());
+
+            if (manager != null) {
+                // Bias the region data for loaded chunks
+                List<Vector2D> positions = new ArrayList<Vector2D>();
+                for (Chunk chunk : world.getLoadedChunks()) {
+                    positions.add(new Vector2D(chunk.getX(), chunk.getZ()));
+                }
+                manager.loadChunks(positions);
+            }
+        }
+
+        return manager;
+    }
+
+    /**
+     * Unload the region data for a world.
+     *
+     * @param world a world
+     */
+    void unload(World world) {
+        checkNotNull(world);
+
+        synchronized (lock) {
+            container.unload(world.getName());
+        }
+    }
+
+    /**
+     * Get the region manager for a world if one exists.
+     *
+     * <p>If you wish to make queries and performance is more important
+     * than accuracy, use {@link #createQuery()} instead.</p>
+     *
+     * <p>This method may return {@code null} if region data for the given
+     * world has not been loaded, has failed to load, or support for regions
+     * has been disabled.</p>
+     *
+     * @param world the world
+     * @return a region manager, or {@code null} if one is not available
+     */
+    @Nullable
+    public RegionManager get(World world) {
+        return container.get(world.getName());
+    }
+
+    /**
+     * Get an immutable list of loaded {@link RegionManager}s.
+     *
+     * @return a list of managers
+     */
+    public List<RegionManager> getLoaded() {
+        return Collections.unmodifiableList(container.getLoaded());
+    }
+
+    /**
+     * Get the a set of region managers that are failing to save.
+     *
+     * @return a set of region managers
+     */
+    public Set<RegionManager> getSaveFailures() {
+        return container.getSaveFailures();
+    }
+
+    /**
+     * Create a new region query.
+     *
+     * @return a new query
+     */
+    public RegionQuery createQuery() {
+        return new RegionQuery(plugin, cache);
+    }
+
+    /**
+     * Execute a migration and block any loading of region data during
+     * the migration.
+     *
+     * @param migration the migration
+     * @throws MigrationException thrown by the migration on error
+     */
+    public void migrate(Migration migration) throws MigrationException {
+        checkNotNull(migration);
+
+        synchronized (lock) {
+            try {
+                log.info("Unloading and saving region data that is currently loaded...");
+                unload();
+                migration.migrate();
+            } finally {
+                log.info("Loading region data for loaded worlds...");
+                loadWorlds();
+            }
+        }
+    }
+
+    /**
+     * Execute auto-migration.
+     */
+    private void autoMigrate() {
+        ConfigurationManager config = plugin.getGlobalStateManager();
+
+        if (config.migrateRegionsToUuid) {
+            RegionDriver driver = getDriver();
+            UUIDMigration migrator = new UUIDMigration(driver, plugin.getProfileService());
+            migrator.setKeepUnresolvedNames(config.keepUnresolvedNames);
+            try {
+                migrate(migrator);
+
+                log.info("Regions saved after UUID migration! This won't happen again unless " +
+                        "you change the relevant configuration option in WorldGuard's config.");
+
+                config.disableUuidMigration();
+            } catch (MigrationException e) {
+                log.log(Level.WARNING, "Failed to execute the migration", e);
+            }
+        }
+    }
+
+}

src/main/java/com/sk89q/worldguard/bukkit/RegionQuery.java

@@ -0,0 +1,373 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.bukkit;
+
+import com.sk89q.worldguard.LocalPlayer;
+import com.sk89q.worldguard.protection.ApplicableRegionSet;
+import com.sk89q.worldguard.protection.FailedLoadRegionSet;
+import com.sk89q.worldguard.protection.GlobalRegionManager;
+import com.sk89q.worldguard.protection.PermissiveRegionSet;
+import com.sk89q.worldguard.protection.RegionResultSet;
+import com.sk89q.worldguard.protection.association.RegionAssociable;
+import com.sk89q.worldguard.protection.flags.DefaultFlag;
+import com.sk89q.worldguard.protection.flags.Flag;
+import com.sk89q.worldguard.protection.flags.StateFlag;
+import com.sk89q.worldguard.protection.flags.StateFlag.State;
+import com.sk89q.worldguard.protection.managers.RegionManager;
+import org.bukkit.Location;
+import org.bukkit.World;
+import org.bukkit.entity.Player;
+
+import javax.annotation.Nullable;
+import java.util.Collection;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+
+/**
+ * This object allows easy spatial queries involving region data for the
+ * purpose of implementing protection / region flag checks.
+ *
+ * <p>Results may be cached for brief amounts of time. If you want to get
+ * data for the purposes of changing it, use of this class is not recommended.
+ * Some of the return values of the methods may be simulated to reduce
+ * boilerplate code related to implementing protection, meaning that false
+ * data is returned.</p>
+ */
+public class RegionQuery {
+
+    private final WorldGuardPlugin plugin;
+    private final ConfigurationManager config;
+    @SuppressWarnings("deprecation")
+    private final GlobalRegionManager globalManager;
+    private final QueryCache cache;
+
+    /**
+     * Create a new instance.
+     *
+     * @param plugin the plugin
+     * @param cache the query cache
+     */
+    RegionQuery(WorldGuardPlugin plugin, QueryCache cache) {
+        checkNotNull(plugin);
+        checkNotNull(cache);
+
+        this.plugin = plugin;
+        this.config = plugin.getGlobalStateManager();
+        this.cache = cache;
+        //noinspection deprecation
+        this.globalManager = plugin.getGlobalRegionManager();
+    }
+
+    /**
+     * Query for regions containing the given location.
+     *
+     * <p>An instance of {@link RegionResultSet} will always be returned,
+     * even if regions are disabled or region data failed to load. An
+     * appropriate "virtual" set will be returned in such a case
+     * (for example, if regions are disabled, the returned set
+     * would permit all activities).</p>
+     *
+     * @param location the location
+     * @return a region set
+     */
+    public ApplicableRegionSet getApplicableRegions(Location location) {
+        checkNotNull(location);
+
+        World world = location.getWorld();
+        WorldConfiguration worldConfig = config.get(world);
+
+        if (!worldConfig.useRegions) {
+            return PermissiveRegionSet.getInstance();
+        }
+
+        RegionManager manager = globalManager.get(location.getWorld());
+        if (manager != null) {
+            return cache.queryContains(manager, location);
+        } else {
+            return FailedLoadRegionSet.getInstance();
+        }
+    }
+
+    /**
+     * Returns true if the BUILD flag allows the action in the location, but it
+     * can be overridden by a list of other flags. The BUILD flag will not
+     * override the other flags, but the other flags can override BUILD. If
+     * neither BUILD or any of the flags permit the action, then false will
+     * be returned.
+     *
+     * <p>Use this method when checking flags that are related to build
+     * protection. For example, lighting fire in a region should not be
+     * permitted unless the player is a member of the region or the
+     * LIGHTER flag allows it. However, the LIGHTER flag should be able
+     * to allow lighting fires even if BUILD is set to DENY.</p>
+     *
+     * <p>How this method works (BUILD can be overridden by other flags but
+     * not the other way around) is inconsistent, but it's required for
+     * legacy reasons.</p>
+     *
+     * <p>This method does not check the region bypass permission. That must
+     * be done by the calling code.</p>
+     *
+     * @param location the location
+     * @param player an optional player, which would be used to determine the region group to apply
+     * @param flag the flag
+     * @return true if the result was {@code ALLOW}
+     * @see RegionResultSet#queryValue(RegionAssociable, Flag)
+     */
+    public boolean testBuild(Location location, Player player, StateFlag... flag) {
+        if (flag.length == 0) {
+            return testState(location, player, DefaultFlag.BUILD);
+        }
+
+        return StateFlag.test(StateFlag.combine(
+                StateFlag.denyToNone(queryState(location, player, DefaultFlag.BUILD)),
+                queryState(location, player, flag)));
+    }
+
+    /**
+     * Returns true if the BUILD flag allows the action in the location, but it
+     * can be overridden by a list of other flags. The BUILD flag will not
+     * override the other flags, but the other flags can override BUILD. If
+     * neither BUILD or any of the flags permit the action, then false will
+     * be returned.
+     *
+     * <p>Use this method when checking flags that are related to build
+     * protection. For example, lighting fire in a region should not be
+     * permitted unless the player is a member of the region or the
+     * LIGHTER flag allows it. However, the LIGHTER flag should be able
+     * to allow lighting fires even if BUILD is set to DENY.</p>
+     *
+     * <p>How this method works (BUILD can be overridden by other flags but
+     * not the other way around) is inconsistent, but it's required for
+     * legacy reasons.</p>
+     *
+     * <p>This method does not check the region bypass permission. That must
+     * be done by the calling code.</p>
+     *
+     * @param location the location
+     * @param associable an optional associable
+     * @param flag the flag
+     * @return true if the result was {@code ALLOW}
+     * @see RegionResultSet#queryValue(RegionAssociable, Flag)
+     */
+    public boolean testBuild(Location location, RegionAssociable associable, StateFlag... flag) {
+        if (flag.length == 0) {
+            return testState(location, associable, DefaultFlag.BUILD);
+        }
+
+        return StateFlag.test(StateFlag.combine(
+                StateFlag.denyToNone(queryState(location, associable, DefaultFlag.BUILD)),
+                queryState(location, associable, flag)));
+    }
+
+    /**
+     * Test whether the (effective) value for a list of state flags equals
+     * {@code ALLOW}.
+     *
+     * <p>{@code player} can be non-null to satisfy region group requirements,
+     * otherwise it will be assumed that the caller that is not a member of any
+     * regions. (Flags on a region can be changed so that they only apply
+     * to certain users.) The player argument is required if the
+     * {@link DefaultFlag#BUILD} flag is in the list of flags.</p>
+     *
+     * <p>This method does not check the region bypass permission. That must
+     * be done by the calling code.</p>
+     *
+     * @param location the location
+     * @param player an optional player, which would be used to determine the region group to apply
+     * @param flag the flag
+     * @return true if the result was {@code ALLOW}
+     * @see RegionResultSet#queryValue(RegionAssociable, Flag)
+     */
+    public boolean testState(Location location, @Nullable Player player, StateFlag... flag) {
+        return StateFlag.test(queryState(location, player, flag));
+    }
+
+    /**
+     * Test whether the (effective) value for a list of state flags equals
+     * {@code ALLOW}.
+     *
+     * <p>{@code player} can be non-null to satisfy region group requirements,
+     * otherwise it will be assumed that the caller that is not a member of any
+     * regions. (Flags on a region can be changed so that they only apply
+     * to certain users.) The player argument is required if the
+     * {@link DefaultFlag#BUILD} flag is in the list of flags.</p>
+     *
+     * <p>This method does not check the region bypass permission. That must
+     * be done by the calling code.</p>
+     *
+     * @param location the location
+     * @param associable an optional associable
+     * @param flag the flag
+     * @return true if the result was {@code ALLOW}
+     * @see RegionResultSet#queryValue(RegionAssociable, Flag)
+     */
+    public boolean testState(Location location, @Nullable RegionAssociable associable, StateFlag... flag) {
+        return StateFlag.test(queryState(location, associable, flag));
+    }
+
+    /**
+     * Get the (effective) value for a list of state flags. The rules of
+     * states is observed here; that is, {@code DENY} overrides {@code ALLOW},
+     * and {@code ALLOW} overrides {@code NONE}. One flag may override another.
+     *
+     * <p>{@code player} can be non-null to satisfy region group requirements,
+     * otherwise it will be assumed that the caller that is not a member of any
+     * regions. (Flags on a region can be changed so that they only apply
+     * to certain users.) The player argument is required if the
+     * {@link DefaultFlag#BUILD} flag is in the list of flags.</p>
+     *
+     * @param location the location
+     * @param player an optional player, which would be used to determine the region groups that apply
+     * @param flags a list of flags to check
+     * @return a state
+     * @see RegionResultSet#queryState(RegionAssociable, StateFlag...)
+     */
+    @Nullable
+    public State queryState(Location location, @Nullable Player player, StateFlag... flags) {
+        LocalPlayer localPlayer = player != null ? plugin.wrapPlayer(player) : null;
+        return getApplicableRegions(location).queryState(localPlayer, flags);
+    }
+
+    /**
+     * Get the (effective) value for a list of state flags. The rules of
+     * states is observed here; that is, {@code DENY} overrides {@code ALLOW},
+     * and {@code ALLOW} overrides {@code NONE}. One flag may override another.
+     *
+     * <p>{@code player} can be non-null to satisfy region group requirements,
+     * otherwise it will be assumed that the caller that is not a member of any
+     * regions. (Flags on a region can be changed so that they only apply
+     * to certain users.) The player argument is required if the
+     * {@link DefaultFlag#BUILD} flag is in the list of flags.</p>
+     *
+     * @param location the location
+     * @param associable an optional associable
+     * @param flags a list of flags to check
+     * @return a state
+     * @see RegionResultSet#queryState(RegionAssociable, StateFlag...)
+     */
+    @Nullable
+    public State queryState(Location location, @Nullable RegionAssociable associable, StateFlag... flags) {
+        return getApplicableRegions(location).queryState(associable, flags);
+    }
+
+    /**
+     * Get the effective value for a flag. If there are multiple values
+     * (for example, multiple overlapping regions with
+     * the same priority may have the same flag set), then the selected
+     * (or "winning") value will depend on the flag type.
+     *
+     * <p>Only some flag types actually have a strategy for picking the
+     * "best value." For most types, the actual value that is chosen to be
+     * returned is undefined (it could be any value). As of writing, the only
+     * type of flag that actually has a strategy for picking a value is the
+     * {@link StateFlag}.</p>
+     *
+     * <p>{@code player} can be non-null to satisfy region group requirements,
+     * otherwise it will be assumed that the caller that is not a member of any
+     * regions. (Flags on a region can be changed so that they only apply
+     * to certain users.) The player argument is required if the
+     * {@link DefaultFlag#BUILD} flag is the flag being queried.</p>
+     *
+     * @param location the location
+     * @param player an optional player, which would be used to determine the region group to apply
+     * @param flag the flag
+     * @return a value, which could be {@code null}
+     * @see RegionResultSet#queryValue(RegionAssociable, Flag)
+     */
+    @Nullable
+    public <V> V queryValue(Location location, @Nullable Player player, Flag<V> flag) {
+        LocalPlayer localPlayer = player != null ? plugin.wrapPlayer(player) : null;
+        return getApplicableRegions(location).queryValue(localPlayer, flag);
+    }
+
+    /**
+     * Get the effective value for a flag. If there are multiple values
+     * (for example, multiple overlapping regions with
+     * the same priority may have the same flag set), then the selected
+     * (or "winning") value will depend on the flag type.
+     *
+     * <p>Only some flag types actually have a strategy for picking the
+     * "best value." For most types, the actual value that is chosen to be
+     * returned is undefined (it could be any value). As of writing, the only
+     * type of flag that actually has a strategy for picking a value is the
+     * {@link StateFlag}.</p>
+     *
+     * <p>{@code player} can be non-null to satisfy region group requirements,
+     * otherwise it will be assumed that the caller that is not a member of any
+     * regions. (Flags on a region can be changed so that they only apply
+     * to certain users.) The player argument is required if the
+     * {@link DefaultFlag#BUILD} flag is the flag being queried.</p>
+     *
+     * @param location the location
+     * @param associable an optional associable
+     * @param flag the flag
+     * @return a value, which could be {@code null}
+     * @see RegionResultSet#queryValue(RegionAssociable, Flag)
+     */
+    @Nullable
+    public <V> V queryValue(Location location, @Nullable RegionAssociable associable, Flag<V> flag) {
+        return getApplicableRegions(location).queryValue(associable, flag);
+    }
+
+    /**
+     * Get the effective values for a flag, returning a collection of all
+     * values. It is up to the caller to determine which value, if any,
+     * from the collection will be used.
+     *
+     * <p>{@code player} can be non-null to satisfy region group requirements,
+     * otherwise it will be assumed that the caller that is not a member of any
+     * regions. (Flags on a region can be changed so that they only apply
+     * to certain users.) The player argument is required if the
+     * {@link DefaultFlag#BUILD} flag is the flag being queried.</p>
+     *
+     * @param location the location
+     * @param player an optional player, which would be used to determine the region group to apply
+     * @param flag the flag
+     * @return a collection of values
+     * @see RegionResultSet#queryAllValues(RegionAssociable, Flag)
+     */
+    public <V> Collection<V> queryAllValues(Location location, @Nullable Player player, Flag<V> flag) {
+        LocalPlayer localPlayer = player != null ? plugin.wrapPlayer(player) : null;
+        return getApplicableRegions(location).queryAllValues(localPlayer, flag);
+    }
+
+    /**
+     * Get the effective values for a flag, returning a collection of all
+     * values. It is up to the caller to determine which value, if any,
+     * from the collection will be used.
+     *
+     * <p>{@code player} can be non-null to satisfy region group requirements,
+     * otherwise it will be assumed that the caller that is not a member of any
+     * regions. (Flags on a region can be changed so that they only apply
+     * to certain users.) The player argument is required if the
+     * {@link DefaultFlag#BUILD} flag is the flag being queried.</p>
+     *
+     * @param location the location
+     * @param associable an optional associable
+     * @param flag the flag
+     * @return a collection of values
+     * @see RegionResultSet#queryAllValues(RegionAssociable, Flag)
+     */
+    public <V> Collection<V> queryAllValues(Location location, @Nullable RegionAssociable associable, Flag<V> flag) {
+        return getApplicableRegions(location).queryAllValues(associable, flag);
+    }
+
+}

src/main/java/com/sk89q/worldguard/bukkit/WGBukkit.java

@@ -1,20 +1,21 @@
-// $Id$
 /*
- * This file is a part of WorldGuard.
- * Copyright (c) sk89q <http://www.sk89q.com>
- * Copyright (c) the WorldGuard team and contributors
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
  *
- * This program is free software: you can redistribute it and/or modify it under the
- * terms of the GNU Lesser General Public License as published by the Free Software
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * This program is distributed in the hope that it will be useful, but WITHOUT ANY
- * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
- * GNU General Public License for more details.
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
  *
- * You should have received a copy of the GNU Lesser General Public License along with
- * this program. If not, see <http://www.gnu.org/licenses/>.
-*/
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
 
 package com.sk89q.worldguard.bukkit;
 

src/main/java/com/sk89q/worldguard/bukkit/WorldConfiguration.java

@@ -1,24 +1,42 @@
-// $Id$
 /*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
  *
- * You should have received a copy of the GNU General Public License
+ * You should have received a copy of the GNU Lesser General Public License
  * along with this program. If not, see <http://www.gnu.org/licenses/>.
  */
 
 package com.sk89q.worldguard.bukkit;
 
+import com.sk89q.util.yaml.YAMLFormat;
+import com.sk89q.util.yaml.YAMLProcessor;
+import com.sk89q.worldguard.blacklist.Blacklist;
+import com.sk89q.worldguard.blacklist.BlacklistLoggerHandler;
+import com.sk89q.worldguard.blacklist.logger.ConsoleHandler;
+import com.sk89q.worldguard.blacklist.logger.DatabaseHandler;
+import com.sk89q.worldguard.blacklist.logger.FileHandler;
+import com.sk89q.worldguard.blacklist.target.TargetMatcherParseException;
+import com.sk89q.worldguard.blacklist.target.TargetMatcherParser;
+import com.sk89q.worldguard.bukkit.commands.CommandUtils;
+import com.sk89q.worldguard.bukkit.util.TargetMatcherSet;
+import com.sk89q.worldguard.chest.ChestProtection;
+import com.sk89q.worldguard.chest.SignChestProtection;
+import org.bukkit.block.Block;
+import org.bukkit.entity.EntityType;
+import org.bukkit.entity.Player;
+import org.bukkit.potion.PotionEffectType;
+
 import java.io.File;
 import java.io.FileNotFoundException;
 import java.io.IOException;
@@ -29,21 +47,7 @@ import java.util.List;
 import java.util.Map;
 import java.util.Set;
 import java.util.logging.Level;
-
-import org.bukkit.block.Block;
-import org.bukkit.entity.EntityType;
-import org.bukkit.entity.Player;
-import org.bukkit.potion.PotionEffectType;
-
-import com.sk89q.util.yaml.YAMLFormat;
-import com.sk89q.util.yaml.YAMLProcessor;
-import com.sk89q.worldguard.blacklist.Blacklist;
-import com.sk89q.worldguard.blacklist.BlacklistLogger;
-import com.sk89q.worldguard.blacklist.loggers.ConsoleLoggerHandler;
-import com.sk89q.worldguard.blacklist.loggers.DatabaseLoggerHandler;
-import com.sk89q.worldguard.blacklist.loggers.FileLoggerHandler;
-import com.sk89q.worldguard.chest.ChestProtection;
-import com.sk89q.worldguard.chest.SignChestProtection;
+import java.util.logging.Logger;
 
 /**
  * Holds the configuration for individual worlds.
@@ -53,6 +57,9 @@ import com.sk89q.worldguard.chest.SignChestProtection;
  */
 public class WorldConfiguration {
 
+    private static final Logger log = Logger.getLogger(WorldConfiguration.class.getCanonicalName());
+    private static final TargetMatcherParser matcherParser = new TargetMatcherParser();
+
     public static final String CONFIG_HEADER = "#\r\n" +
             "# WorldGuard's world configuration file\r\n" +
             "#\r\n" +
@@ -77,6 +84,8 @@ public class WorldConfiguration {
     /* Configuration data start */
     public boolean summaryOnStart;
     public boolean opPermissions;
+    public boolean buildPermissions;
+    public String buildPermissionDenyMessage = "";
     public boolean fireSpreadDisableToggle;
     public boolean itemDurability;
     public boolean simulateSponge;
@@ -128,6 +137,7 @@ public class WorldConfiguration {
     public boolean disableMobDamage;
     public boolean useRegions;
     public boolean highFreqFlags;
+    public boolean checkLiquidFlow;
     public int regionWand;
     public Set<EntityType> blockCreatureSpawn;
     public boolean allowTamedSpawns;
@@ -166,13 +176,16 @@ public class WorldConfiguration {
     public boolean disableSoilDehydration;
     public Set<Integer> allowedSnowFallOver;
     public boolean regionInvinciblityRemovesMobs;
+    public boolean fakePlayerBuildOverride;
     public boolean explosionFlagCancellation;
     public boolean disableDeathMessages;
     public boolean disableObsidianGenerators;
+    public boolean strictEntitySpawn;
+    public TargetMatcherSet allowAllInteract;
+    public TargetMatcherSet blockUseAtFeet;
 
     private Map<String, Integer> maxRegionCounts;
 
-
     /* Configuration data end */
 
     /**
@@ -198,7 +211,7 @@ public class WorldConfiguration {
         loadConfiguration();
 
         if (summaryOnStart) {
-            plugin.getLogger().info("Loaded configuration for world '" + worldName + "'");
+            log.info("Loaded configuration for world '" + worldName + "'");
         }
     }
 
@@ -257,6 +270,26 @@ public class WorldConfiguration {
         return res;
     }
 
+    private TargetMatcherSet getTargetMatchers(String node) {
+        TargetMatcherSet set = new TargetMatcherSet();
+        List<String> inputs = parentConfig.getStringList(node, null);
+
+        if (inputs == null || inputs.size() == 0) {
+            parentConfig.setProperty(node, new ArrayList<String>());
+            return set;
+        }
+
+        for (String input : inputs) {
+            try {
+                set.add(matcherParser.fromInput(input));
+            } catch (TargetMatcherParseException e) {
+                log.warning("Failed to parse the block / item type specified as '" + input + "'");
+            }
+        }
+
+        return set;
+    }
+
     private List<String> getStringList(String node, List<String> def) {
         List<String> res = parentConfig.getStringList(node, def);
 
@@ -301,13 +334,21 @@ public class WorldConfiguration {
         try {
             config.load();
         } catch (IOException e) {
-            plugin.getLogger().severe("Error reading configuration for world " + worldName + ": ");
+            log.severe("Error reading configuration for world " + worldName + ": ");
             e.printStackTrace();
         }
 
         summaryOnStart = getBoolean("summary-on-start", true);
         opPermissions = getBoolean("op-permissions", true);
 
+        buildPermissions = getBoolean("build-permission-nodes.enable", false);
+        buildPermissionDenyMessage = CommandUtils.replaceColorMacros(
+                getString("build-permission-nodes.deny-message", "&eSorry, but you are not permitted to do that here."));
+
+        strictEntitySpawn = getBoolean("event-handling.block-entity-spawns-with-untraceable-cause", false);
+        allowAllInteract = getTargetMatchers("event-handling.interaction-whitelist");
+        blockUseAtFeet = getTargetMatchers("event-handling.emit-block-use-at-feet");
+
         itemDurability = getBoolean("protection.item-durability", true);
         removeInfiniteStacks = getBoolean("protection.remove-infinite-stacks", false);
         disableExpDrops = getBoolean("protection.disable-xp-orb-drops", false);
@@ -318,14 +359,14 @@ public class WorldConfiguration {
             PotionEffectType effect = PotionEffectType.getByName(potionName);
 
             if (effect == null) {
-                plugin.getLogger().warning("Unknown potion effect type '" + potionName + "'");
+                log.warning("Unknown potion effect type '" + potionName + "'");
             } else {
                 blockPotions.add(effect);
             }
         }
         blockPotionsAlways = getBoolean("gameplay.block-potions-overly-reliably", false);
 
-        simulateSponge = getBoolean("simulation.sponge.enable", true);
+        simulateSponge = getBoolean("simulation.sponge.enable", false);
         spongeRadius = Math.max(1, getInt("simulation.sponge.radius", 3)) - 1;
         redstoneSponges = getBoolean("simulation.sponge.redstone", false);
 
@@ -411,8 +452,10 @@ public class WorldConfiguration {
 
         useRegions = getBoolean("regions.enable", true);
         regionInvinciblityRemovesMobs = getBoolean("regions.invincibility-removes-mobs", false);
+        fakePlayerBuildOverride = getBoolean("regions.fake-player-build-override", true);
         explosionFlagCancellation = getBoolean("regions.explosion-flags-block-entity-damage", true);
         highFreqFlags = getBoolean("regions.high-frequency-flags", false);
+        checkLiquidFlow = getBoolean("regions.protect-against-liquid-flow", false);
         regionWand = getInt("regions.wand", 334);
         maxClaimVolume = getInt("regions.max-claim-volume", 30000);
         claimOnlyInsideExistingRegions = getBoolean("regions.claim-only-inside-existing-regions", false);
@@ -439,9 +482,9 @@ public class WorldConfiguration {
             EntityType creature = EntityType.fromName(creatureName);
 
             if (creature == null) {
-                plugin.getLogger().warning("Unknown mob type '" + creatureName + "'");
+                log.warning("Unknown mob type '" + creatureName + "'");
             } else if (!creature.isAlive()) {
-                plugin.getLogger().warning("Entity type '" + creatureName + "' is not a creature");
+                log.warning("Entity type '" + creatureName + "' is not a creature");
             } else {
                 blockCreatureSpawn.add(creature);
             }
@@ -482,53 +525,53 @@ public class WorldConfiguration {
             } else {
                 this.blacklist = blist;
                 if (summaryOnStart) {
-                    plugin.getLogger().log(Level.INFO, "Blacklist loaded.");
+                    log.log(Level.INFO, "Blacklist loaded.");
                 }
 
-                BlacklistLogger blacklistLogger = blist.getLogger();
+                BlacklistLoggerHandler blacklistLogger = blist.getLogger();
 
                 if (logDatabase) {
-                    blacklistLogger.addHandler(new DatabaseLoggerHandler(dsn, user, pass, table, worldName, plugin.getLogger()));
+                    blacklistLogger.addHandler(new DatabaseHandler(dsn, user, pass, table, worldName, log));
                 }
 
                 if (logConsole) {
-                    blacklistLogger.addHandler(new ConsoleLoggerHandler(worldName, plugin.getLogger()));
+                    blacklistLogger.addHandler(new ConsoleHandler(worldName, log));
                 }
 
                 if (logFile) {
-                    FileLoggerHandler handler =
-                            new FileLoggerHandler(logFilePattern, logFileCacheSize, worldName, plugin.getLogger());
+                    FileHandler handler =
+                            new FileHandler(logFilePattern, logFileCacheSize, worldName, log);
                     blacklistLogger.addHandler(handler);
                 }
             }
         } catch (FileNotFoundException e) {
-            plugin.getLogger().log(Level.WARNING, "WorldGuard blacklist does not exist.");
+            log.log(Level.WARNING, "WorldGuard blacklist does not exist.");
         } catch (IOException e) {
-            plugin.getLogger().log(Level.WARNING, "Could not load WorldGuard blacklist: "
+            log.log(Level.WARNING, "Could not load WorldGuard blacklist: "
                     + e.getMessage());
         }
 
         // Print an overview of settings
         if (summaryOnStart) {
-            plugin.getLogger().log(Level.INFO, blockTNTExplosions
+            log.log(Level.INFO, blockTNTExplosions
                     ? "(" + worldName + ") TNT ignition is blocked."
                     : "(" + worldName + ") TNT ignition is PERMITTED.");
-            plugin.getLogger().log(Level.INFO, blockLighter
+            log.log(Level.INFO, blockLighter
                     ? "(" + worldName + ") Lighters are blocked."
                     : "(" + worldName + ") Lighters are PERMITTED.");
-            plugin.getLogger().log(Level.INFO, preventLavaFire
+            log.log(Level.INFO, preventLavaFire
                     ? "(" + worldName + ") Lava fire is blocked."
                     : "(" + worldName + ") Lava fire is PERMITTED.");
 
             if (disableFireSpread) {
-                plugin.getLogger().log(Level.INFO, "(" + worldName + ") All fire spread is disabled.");
+                log.log(Level.INFO, "(" + worldName + ") All fire spread is disabled.");
             } else {
                 if (disableFireSpreadBlocks.size() > 0) {
-                    plugin.getLogger().log(Level.INFO, "(" + worldName
+                    log.log(Level.INFO, "(" + worldName
                             + ") Fire spread is limited to "
                             + disableFireSpreadBlocks.size() + " block types.");
                 } else {
-                    plugin.getLogger().log(Level.INFO, "(" + worldName
+                    log.log(Level.INFO, "(" + worldName
                             + ") Fire spread is UNRESTRICTED.");
                 }
             }

src/main/java/com/sk89q/worldguard/bukkit/WorldGuardHangingListener.java

@@ -1,216 +0,0 @@
-// $Id$
-/*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
- *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
-
-package com.sk89q.worldguard.bukkit;
-
-import static com.sk89q.worldguard.bukkit.BukkitUtil.toVector;
-
-import org.bukkit.ChatColor;
-import org.bukkit.World;
-import org.bukkit.block.Block;
-import org.bukkit.entity.Creeper;
-import org.bukkit.entity.Entity;
-import org.bukkit.entity.Hanging;
-import org.bukkit.entity.ItemFrame;
-import org.bukkit.entity.LivingEntity;
-import org.bukkit.entity.Painting;
-import org.bukkit.entity.Player;
-import org.bukkit.entity.Projectile;
-import org.bukkit.event.EventHandler;
-import org.bukkit.event.EventPriority;
-import org.bukkit.event.Listener;
-import org.bukkit.event.hanging.HangingBreakByEntityEvent;
-import org.bukkit.event.hanging.HangingBreakEvent;
-import org.bukkit.event.hanging.HangingBreakEvent.RemoveCause;
-import org.bukkit.event.hanging.HangingPlaceEvent;
-import org.bukkit.event.player.PlayerInteractEntityEvent;
-import org.bukkit.projectiles.ProjectileSource;
-
-import com.sk89q.worldedit.blocks.ItemID;
-import com.sk89q.worldguard.blacklist.events.BlockBreakBlacklistEvent;
-import com.sk89q.worldguard.blacklist.events.ItemUseBlacklistEvent;
-import com.sk89q.worldguard.protection.flags.DefaultFlag;
-
-/**
- * Listener for painting related events.
- *
- * @author BangL <henno.rickowski@gmail.com>
- */
-public class WorldGuardHangingListener implements Listener {
-
-    private WorldGuardPlugin plugin;
-
-    /**
-     * Construct the object;
-     *
-     * @param plugin The plugin instance
-     */
-    public WorldGuardHangingListener(WorldGuardPlugin plugin) {
-        this.plugin = plugin;
-    }
-
-    /**
-     * Register events.
-     */
-    public void registerEvents() {
-        plugin.getServer().getPluginManager().registerEvents(this, plugin);
-    }
-
-    @EventHandler(priority = EventPriority.HIGH, ignoreCancelled = true)
-    public void onHangingingBreak(HangingBreakEvent event) {
-        Hanging hanging = event.getEntity();
-        World world = hanging.getWorld();
-        ConfigurationManager cfg = plugin.getGlobalStateManager();
-        WorldConfiguration wcfg = cfg.get(world);
-
-        if (event instanceof HangingBreakByEntityEvent) {
-            HangingBreakByEntityEvent entityEvent = (HangingBreakByEntityEvent) event;
-            Entity removerEntity = entityEvent.getRemover();
-            if (removerEntity instanceof Projectile) {
-                Projectile projectile = (Projectile) removerEntity;
-                ProjectileSource remover = projectile.getShooter(); 
-                removerEntity = (remover instanceof LivingEntity ? (LivingEntity) remover : null);
-            }
-
-            if (removerEntity instanceof Player) {
-                Player player = (Player) removerEntity;
-
-                if (wcfg.getBlacklist() != null) {
-                    if (hanging instanceof Painting
-                            && !wcfg.getBlacklist().check(
-                                new BlockBreakBlacklistEvent(plugin.wrapPlayer(player),
-                                        toVector(player.getLocation()), ItemID.PAINTING), false, false)) {
-                        event.setCancelled(true);
-                        return;
-                    } else if (hanging instanceof ItemFrame
-                            && !wcfg.getBlacklist().check(
-                                new BlockBreakBlacklistEvent(plugin.wrapPlayer(player),
-                                        toVector(player.getLocation()), ItemID.ITEM_FRAME), false, false)) {
-                        event.setCancelled(true);
-                        return;
-                    }
-                }
-
-                if (wcfg.useRegions) {
-                    if (!plugin.getGlobalRegionManager().canBuild(player, hanging.getLocation())) {
-                        player.sendMessage(ChatColor.DARK_RED + "You don't have permission for this area.");
-                        event.setCancelled(true);
-                        return;
-                    }
-                }
-            } else {
-                if (removerEntity instanceof Creeper) {
-                    if (wcfg.blockCreeperBlockDamage || wcfg.blockCreeperExplosions) {
-                        event.setCancelled(true);
-                        return;
-                    }
-                    if (wcfg.useRegions && !plugin.getGlobalRegionManager().allows(DefaultFlag.CREEPER_EXPLOSION, hanging.getLocation())) {
-                        event.setCancelled(true);
-                        return;
-                    }
-                }
-
-                // this now covers dispensers as well, if removerEntity is null above,
-                // due to a non-LivingEntity ProjectileSource
-                if (hanging instanceof Painting
-                        && (wcfg.blockEntityPaintingDestroy
-                        || (wcfg.useRegions
-                        && !plugin.getGlobalRegionManager().allows(DefaultFlag.ENTITY_PAINTING_DESTROY, hanging.getLocation())))) {
-                    event.setCancelled(true);
-                } else if (hanging instanceof ItemFrame
-                        && (wcfg.blockEntityItemFrameDestroy
-                        || (wcfg.useRegions
-                        && !plugin.getGlobalRegionManager().allows(DefaultFlag.ENTITY_ITEM_FRAME_DESTROY, hanging.getLocation())))) {
-                    event.setCancelled(true);
-                }
-            }
-        } else {
-            // Explosions from mobs are not covered by HangingBreakByEntity
-            if (hanging instanceof Painting && wcfg.blockEntityPaintingDestroy
-                    && event.getCause() == RemoveCause.EXPLOSION) {
-                event.setCancelled(true);
-            } else if (hanging instanceof ItemFrame && wcfg.blockEntityItemFrameDestroy
-                    && event.getCause() == RemoveCause.EXPLOSION) {
-                event.setCancelled(true);
-            }
-        }
-    }
-
-    @EventHandler(priority = EventPriority.HIGH, ignoreCancelled = true)
-    public void onHangingPlace(HangingPlaceEvent event) {
-        Block placedOn = event.getBlock();
-        Player player = event.getPlayer();
-        World world = placedOn.getWorld();
-
-        ConfigurationManager cfg = plugin.getGlobalStateManager();
-        WorldConfiguration wcfg = cfg.get(world);
-
-        if (wcfg.getBlacklist() != null) {
-
-            if (event.getEntity() instanceof Painting
-                    && !wcfg.getBlacklist().check(
-                        new ItemUseBlacklistEvent(plugin.wrapPlayer(player),
-                                toVector(player.getLocation()), ItemID.PAINTING), false, false)) {
-                event.setCancelled(true);
-                return;
-            } else if (event.getEntity() instanceof ItemFrame
-                    && !wcfg.getBlacklist().check(
-                        new ItemUseBlacklistEvent(plugin.wrapPlayer(player),
-                                toVector(player.getLocation()), ItemID.ITEM_FRAME), false, false)) {
-                event.setCancelled(true);
-                return;
-            }
-        }
-
-        if (wcfg.useRegions) {
-            if (!plugin.getGlobalRegionManager().canBuild(player, placedOn.getRelative(event.getBlockFace()))) {
-                player.sendMessage(ChatColor.DARK_RED + "You don't have permission for this area.");
-                event.setCancelled(true);
-                return;
-            }
-        }
-    }
-
-    @EventHandler(priority = EventPriority.HIGH, ignoreCancelled = true)
-    public void onEntityInteract(PlayerInteractEntityEvent event) {
-        Player player = event.getPlayer();
-        Entity entity = event.getRightClicked();
-
-        ConfigurationManager cfg = plugin.getGlobalStateManager();
-        WorldConfiguration wcfg = cfg.get(entity.getWorld());
-
-        if (wcfg.useRegions && (entity instanceof ItemFrame || entity instanceof Painting)) {
-            if (!plugin.getGlobalRegionManager().canBuild(player, entity.getLocation())) {
-                player.sendMessage(ChatColor.DARK_RED + "You don't have permission for this area.");
-                event.setCancelled(true);
-                return;
-            }
-
-//            if (entity instanceof ItemFrame
-//                    && ((!plugin.getGlobalRegionManager().allows(
-//                            DefaultFlag.ENTITY_ITEM_FRAME_DESTROY, entity.getLocation())))) {
-//                event.setCancelled(true);
-//            } else if (entity instanceof Painting
-//                    && ((!plugin.getGlobalRegionManager().allows(
-//                            DefaultFlag.ENTITY_PAINTING_DESTROY, entity.getLocation())))) {
-//                event.setCancelled(true);
-//            }
-        }
-    }
-}

src/main/java/com/sk89q/worldguard/bukkit/WorldGuardPlugin.java

@@ -1,39 +1,83 @@
-// $Id$
 /*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
  *
- * You should have received a copy of the GNU General Public License
+ * You should have received a copy of the GNU Lesser General Public License
  * along with this program. If not, see <http://www.gnu.org/licenses/>.
  */
 
 package com.sk89q.worldguard.bukkit;
 
-import java.io.File;
-import java.io.FileNotFoundException;
-import java.io.FileOutputStream;
-import java.io.IOException;
-import java.io.InputStream;
-import java.util.ArrayList;
-import java.util.Arrays;
-import java.util.Iterator;
-import java.util.List;
-import java.util.Set;
-import java.util.jar.JarFile;
-import java.util.zip.ZipEntry;
-
+import com.google.common.util.concurrent.Futures;
+import com.google.common.util.concurrent.ListeningExecutorService;
+import com.google.common.util.concurrent.MoreExecutors;
+import com.sk89q.bukkit.util.CommandsManagerRegistration;
+import com.sk89q.minecraft.util.commands.CommandException;
+import com.sk89q.minecraft.util.commands.CommandPermissionsException;
+import com.sk89q.minecraft.util.commands.CommandUsageException;
+import com.sk89q.minecraft.util.commands.CommandsManager;
+import com.sk89q.minecraft.util.commands.MissingNestedCommandException;
+import com.sk89q.minecraft.util.commands.SimpleInjector;
+import com.sk89q.minecraft.util.commands.WrappedCommandException;
+import com.sk89q.squirrelid.cache.HashMapCache;
+import com.sk89q.squirrelid.cache.ProfileCache;
+import com.sk89q.squirrelid.cache.SQLiteCache;
+import com.sk89q.squirrelid.resolver.BukkitPlayerService;
+import com.sk89q.squirrelid.resolver.CacheForwardingService;
+import com.sk89q.squirrelid.resolver.CombinedProfileService;
+import com.sk89q.squirrelid.resolver.HttpRepositoryService;
+import com.sk89q.squirrelid.resolver.ProfileService;
+import com.sk89q.wepif.PermissionsResolverManager;
+import com.sk89q.worldedit.bukkit.WorldEditPlugin;
+import com.sk89q.worldguard.LocalPlayer;
+import com.sk89q.worldguard.bukkit.commands.GeneralCommands;
+import com.sk89q.worldguard.bukkit.commands.ProtectionCommands;
+import com.sk89q.worldguard.bukkit.commands.ToggleCommands;
+import com.sk89q.worldguard.bukkit.event.player.ProcessPlayerEvent;
+import com.sk89q.worldguard.bukkit.listener.BlacklistListener;
+import com.sk89q.worldguard.bukkit.listener.BlockedPotionsListener;
+import com.sk89q.worldguard.bukkit.listener.BuildPermissionListener;
+import com.sk89q.worldguard.bukkit.listener.ChestProtectionListener;
+import com.sk89q.worldguard.bukkit.listener.DebuggingListener;
+import com.sk89q.worldguard.bukkit.listener.EventAbstractionListener;
+import com.sk89q.worldguard.bukkit.listener.FlagStateManager;
+import com.sk89q.worldguard.bukkit.listener.PlayerModesListener;
+import com.sk89q.worldguard.bukkit.listener.RegionFlagsListener;
+import com.sk89q.worldguard.bukkit.listener.RegionProtectionListener;
+import com.sk89q.worldguard.bukkit.listener.WorldGuardBlockListener;
+import com.sk89q.worldguard.bukkit.listener.WorldGuardCommandBookListener;
+import com.sk89q.worldguard.bukkit.listener.WorldGuardEntityListener;
+import com.sk89q.worldguard.bukkit.listener.WorldGuardHangingListener;
+import com.sk89q.worldguard.bukkit.listener.WorldGuardPlayerListener;
+import com.sk89q.worldguard.bukkit.listener.WorldGuardServerListener;
+import com.sk89q.worldguard.bukkit.listener.WorldGuardVehicleListener;
+import com.sk89q.worldguard.bukkit.listener.WorldGuardWeatherListener;
+import com.sk89q.worldguard.bukkit.listener.WorldGuardWorldListener;
+import com.sk89q.worldguard.bukkit.util.Events;
+import com.sk89q.worldguard.protection.GlobalRegionManager;
+import com.sk89q.worldguard.protection.managers.RegionManager;
+import com.sk89q.worldguard.protection.managers.storage.StorageException;
+import com.sk89q.worldguard.protection.util.UnresolvedNamesException;
+import com.sk89q.worldguard.util.FatalConfigurationLoadingException;
+import com.sk89q.worldguard.util.concurrent.EvenMoreExecutors;
+import com.sk89q.worldguard.util.logging.RecordMessagePrefixer;
+import com.sk89q.worldguard.util.task.SimpleSupervisor;
+import com.sk89q.worldguard.util.task.Supervisor;
+import com.sk89q.worldguard.util.task.Task;
 import org.bukkit.ChatColor;
 import org.bukkit.Location;
+import org.bukkit.OfflinePlayer;
 import org.bukkit.World;
 import org.bukkit.World.Environment;
 import org.bukkit.block.Block;
@@ -45,66 +89,49 @@ import org.bukkit.permissions.Permissible;
 import org.bukkit.plugin.Plugin;
 import org.bukkit.plugin.java.JavaPlugin;
 
-import com.sk89q.bukkit.util.CommandsManagerRegistration;
-import com.sk89q.minecraft.util.commands.CommandException;
-import com.sk89q.minecraft.util.commands.CommandPermissionsException;
-import com.sk89q.minecraft.util.commands.CommandUsageException;
-import com.sk89q.minecraft.util.commands.CommandsManager;
-import com.sk89q.minecraft.util.commands.MissingNestedCommandException;
-import com.sk89q.minecraft.util.commands.SimpleInjector;
-import com.sk89q.minecraft.util.commands.WrappedCommandException;
-import com.sk89q.wepif.PermissionsResolverManager;
-import com.sk89q.worldedit.bukkit.WorldEditPlugin;
-import com.sk89q.worldguard.LocalPlayer;
-import com.sk89q.worldguard.bukkit.commands.GeneralCommands;
-import com.sk89q.worldguard.bukkit.commands.ProtectionCommands;
-import com.sk89q.worldguard.bukkit.commands.ToggleCommands;
-import com.sk89q.worldguard.protection.GlobalRegionManager;
-import com.sk89q.worldguard.protection.managers.RegionManager;
-import com.sk89q.worldguard.util.FatalConfigurationLoadingException;
+import javax.annotation.Nullable;
+import java.io.File;
+import java.io.FileNotFoundException;
+import java.io.FileOutputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Iterator;
+import java.util.List;
+import java.util.Set;
+import java.util.concurrent.CancellationException;
+import java.util.concurrent.ExecutionException;
+import java.util.concurrent.RejectedExecutionException;
+import java.util.concurrent.TimeUnit;
+import java.util.jar.JarFile;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+import java.util.zip.ZipEntry;
 
 /**
  * The main class for WorldGuard as a Bukkit plugin.
- *
- * @author sk89q
  */
 public class WorldGuardPlugin extends JavaPlugin {
 
-    /**
-     * Current instance of this plugin.
-     */
+    private static final Logger log = Logger.getLogger(WorldGuardPlugin.class.getCanonicalName());
+
     private static WorldGuardPlugin inst;
-
-    /**
-     * Manager for commands. This automatically handles nested commands,
-     * permissions checking, and a number of other fancy command things.
-     * We just set it up and register commands against it.
-     */
     private final CommandsManager<CommandSender> commands;
-
-    /**
-     * Handles the region databases for all worlds.
-     */
-    private final GlobalRegionManager globalRegionManager;
-
-    /**
-     * Handles all configuration.
-     */
-    private final ConfigurationManager configuration;
-
-    /**
-     * Used for scheduling flags.
-     */
+    private final ConfigurationManager configuration = new ConfigurationManager(this);
+    private final RegionContainer regionContainer = new RegionContainer(this);
+    private final GlobalRegionManager globalRegionManager = new GlobalRegionManager(this, regionContainer);
     private FlagStateManager flagStateManager;
+    private final Supervisor supervisor = new SimpleSupervisor();
+    private ListeningExecutorService executorService;
+    private ProfileService profileService;
+    private ProfileCache profileCache;
 
     /**
      * Construct objects. Actual loading occurs when the plugin is enabled, so
      * this merely instantiates the objects.
      */
     public WorldGuardPlugin() {
-        configuration = new ConfigurationManager(this);
-        globalRegionManager = new GlobalRegionManager(this);
-
         final WorldGuardPlugin plugin = inst = this;
         commands = new CommandsManager<CommandSender>() {
             @Override
@@ -128,6 +155,11 @@ public class WorldGuardPlugin extends JavaPlugin {
     @Override
     @SuppressWarnings("deprecation")
     public void onEnable() {
+        configureLogger();
+
+        getDataFolder().mkdirs(); // Need to create the plugins/WorldGuard folder
+
+        executorService = MoreExecutors.listeningDecorator(EvenMoreExecutors.newBoundedCachedThreadPool(0, 1, 20));
 
         // Set the proper command injector
         commands.setInjector(new SimpleInjector(this));
@@ -146,26 +178,43 @@ public class WorldGuardPlugin extends JavaPlugin {
             }
         }, 0L);
 
-        // Need to create the plugins/WorldGuard folder
-        getDataFolder().mkdirs();
+        File cacheDir = new File(getDataFolder(), "cache");
+        cacheDir.mkdirs();
+        try {
+            profileCache = new SQLiteCache(new File(cacheDir, "profiles.sqlite"));
+        } catch (IOException e) {
+            log.log(Level.WARNING, "Failed to initialize SQLite profile cache");
+            profileCache = new HashMapCache();
+        }
+
+        profileService = new CacheForwardingService(
+                new CombinedProfileService(
+                        BukkitPlayerService.getInstance(),
+                        HttpRepositoryService.forMinecraft()),
+                profileCache);
 
         PermissionsResolverManager.initialize(this);
 
-        // This must be done before configuration is loaded
-        LegacyWorldGuardMigration.migrateBlacklist(this);
-
         try {
             // Load the configuration
             configuration.load();
-            globalRegionManager.preload();
         } catch (FatalConfigurationLoadingException e) {
-            e.printStackTrace();
+            log.log(Level.WARNING, "Encountered fatal error while loading configuration", e);
             getServer().shutdown();
+            log.log(Level.WARNING, "\n" +
+                    "******************************************************\n" +
+                    "* Failed to load WorldGuard configuration!\n" +
+                    "* \n" +
+                    "* Shutting down the server just in case...\n" +
+                    "* \n" +
+                    "* The error should be printed above this message. If you can't\n" +
+                    "* figure out the problem, ask us on our forums:\n" +
+                    "* http://forum.enginehub.org\n" +
+                    "******************************************************\n");
         }
 
-        // Migrate regions after the regions were loaded because
-        // the migration code reuses the loaded region managers
-        LegacyWorldGuardMigration.migrateRegions(this);
+        log.info("Loading region data...");
+        regionContainer.initialize();
 
         flagStateManager = new FlagStateManager(this);
 
@@ -182,6 +231,20 @@ public class WorldGuardPlugin extends JavaPlugin {
         (new WorldGuardVehicleListener(this)).registerEvents();
         (new WorldGuardServerListener(this)).registerEvents();
         (new WorldGuardHangingListener(this)).registerEvents();
+
+        // Modules
+        (new BlacklistListener(this)).registerEvents();
+        (new ChestProtectionListener(this)).registerEvents();
+        (new RegionProtectionListener(this)).registerEvents();
+        (new RegionFlagsListener(this)).registerEvents();
+        (new BlockedPotionsListener(this)).registerEvents();
+        (new EventAbstractionListener(this)).registerEvents();
+        (new PlayerModesListener(this)).registerEvents();
+        (new BuildPermissionListener(this)).registerEvents();
+        if ("true".equalsIgnoreCase(System.getProperty("worldguard.debug.listener"))) {
+            (new DebuggingListener(this, log)).registerEvents();
+        }
+
         configuration.updateCommandBookGodMode();
 
         if (getServer().getPluginManager().isPluginEnabled("CommandBook")) {
@@ -195,33 +258,44 @@ public class WorldGuardPlugin extends JavaPlugin {
         }
         worldListener.registerEvents();
 
-        if (!configuration.hasCommandBookGodMode()) {
-            // Check god mode for existing players, if any
-            for (Player player : getServer().getOnlinePlayers()) {
-                if (inGroup(player, "wg-invincible") ||
-                        (configuration.autoGodMode && hasPermission(player, "worldguard.auto-invincible"))) {
-                    configuration.enableGodMode(player);
-                }
-            }
+        for (Player player : getServer().getOnlinePlayers()) {
+            ProcessPlayerEvent event = new ProcessPlayerEvent(player);
+            Events.fire(event);
         }
     }
 
-    /**
-     * Called on plugin disable.
-     */
     @Override
     public void onDisable() {
-        globalRegionManager.unload();
+        executorService.shutdown();
+
+        try {
+            log.log(Level.INFO, "Shutting down executor and waiting for any pending tasks...");
+
+            List<Task<?>> tasks = supervisor.getTasks();
+            if (!tasks.isEmpty()) {
+                StringBuilder builder = new StringBuilder("Known tasks:");
+                for (Task<?> task : tasks) {
+                    builder.append("\n");
+                    builder.append(task.getName());
+                }
+                log.log(Level.INFO, builder.toString());
+            }
+
+            Futures.successfulAsList(tasks).get();
+            executorService.awaitTermination(Integer.MAX_VALUE, TimeUnit.DAYS);
+        } catch (InterruptedException e) {
+            Thread.currentThread().interrupt();
+        } catch (ExecutionException e) {
+            log.log(Level.WARNING, "Some tasks failed while waiting for remaining tasks to finish", e);
+        }
+
+        regionContainer.unload();
         configuration.unload();
         this.getServer().getScheduler().cancelTasks(this);
     }
 
-    /**
-     * Handle a command.
-     */
     @Override
-    public boolean onCommand(CommandSender sender, Command cmd, String label,
-            String[] args) {
+    public boolean onCommand(CommandSender sender, Command cmd, String label, String[] args) {
         try {
             commands.execute(cmd.getName(), args, sender, sender);
         } catch (CommandPermissionsException e) {
@@ -232,12 +306,7 @@ public class WorldGuardPlugin extends JavaPlugin {
             sender.sendMessage(ChatColor.RED + e.getMessage());
             sender.sendMessage(ChatColor.RED + e.getUsage());
         } catch (WrappedCommandException e) {
-            if (e.getCause() instanceof NumberFormatException) {
-                sender.sendMessage(ChatColor.RED + "Number expected, string received instead.");
-            } else {
-                sender.sendMessage(ChatColor.RED + "An error has occurred. See console.");
-                e.printStackTrace();
-            }
+            sender.sendMessage(ChatColor.RED + convertThrowable(e.getCause()));
         } catch (CommandException e) {
             sender.sendMessage(ChatColor.RED + e.getMessage());
         }
@@ -245,15 +314,54 @@ public class WorldGuardPlugin extends JavaPlugin {
         return true;
     }
 
+    /**
+     * Convert the throwable into a somewhat friendly message.
+     *
+     * @param throwable the throwable
+     * @return a message
+     */
+    public String convertThrowable(@Nullable Throwable throwable) {
+        if (throwable instanceof NumberFormatException) {
+            return "Number expected, string received instead.";
+        } else if (throwable instanceof StorageException) {
+            log.log(Level.WARNING, "Error loading/saving regions", throwable);
+            return "Region data could not be loaded/saved: " + throwable.getMessage();
+        } else if (throwable instanceof RejectedExecutionException) {
+            return "There are currently too many tasks queued to add yours. Use /wg running to list queued and running tasks.";
+        } else if (throwable instanceof CancellationException) {
+            return "WorldGuard: Task was cancelled";
+        } else if (throwable instanceof InterruptedException) {
+            return "WorldGuard: Task was interrupted";
+        } else if (throwable instanceof UnresolvedNamesException) {
+            return throwable.getMessage();
+        } else if (throwable instanceof CommandException) {
+            return throwable.getMessage();
+        } else {
+            log.log(Level.WARNING, "WorldGuard encountered an unexpected error", throwable);
+            return "WorldGuard: An unexpected error occurred! Please see the server console.";
+        }
+    }
+
     /**
      * Get the GlobalRegionManager.
      *
-     * @return The plugin's global region manager
+     * @return the plugin's global region manager
+     * @deprecated use {@link #getRegionContainer()}
      */
+    @Deprecated
     public GlobalRegionManager getGlobalRegionManager() {
         return globalRegionManager;
     }
 
+    /**
+     * Get the object that manages region data.
+     *
+     * @return the region container
+     */
+    public RegionContainer getRegionContainer() {
+        return regionContainer;
+    }
+
     /**
      * Get the WorldGuard Configuration.
      *
@@ -283,6 +391,43 @@ public class WorldGuardPlugin extends JavaPlugin {
         return configuration;
     }
 
+    /**
+     * Get the supervisor.
+     *
+     * @return the supervisor
+     */
+    public Supervisor getSupervisor() {
+        return supervisor;
+    }
+
+    /**
+     * Get the global executor service for internal usage (please use your
+     * own executor service).
+     *
+     * @return the global executor service
+     */
+    public ListeningExecutorService getExecutorService() {
+        return executorService;
+    }
+
+    /**
+     * Get the profile lookup service.
+     *
+     * @return the profile lookup service
+     */
+    public ProfileService getProfileService() {
+        return profileService;
+    }
+
+    /**
+     * Get the profile cache.
+     *
+     * @return the profile cache
+     */
+    public ProfileCache getProfileCache() {
+        return profileCache;
+    }
+
     /**
      * Check whether a player is in a group.
      * This calls the corresponding method in PermissionsResolverManager
@@ -708,6 +853,47 @@ public class WorldGuardPlugin extends JavaPlugin {
         return new BukkitPlayer(this, player);
     }
 
+    /**
+     * Wrap a player as a LocalPlayer.
+     *
+     * @param player The player to wrap
+     * @param silenced True to silence messages
+     * @return The wrapped player
+     */
+    public LocalPlayer wrapPlayer(Player player, boolean silenced) {
+        return new BukkitPlayer(this, player, silenced);
+    }
+
+    /**
+     * Wrap a player as a LocalPlayer.
+     *
+     * <p>This implementation is incomplete -- permissions cannot be checked.</p>
+     *
+     * @param player The player to wrap
+     * @return The wrapped player
+     */
+    public LocalPlayer wrapOfflinePlayer(OfflinePlayer player) {
+        return new BukkitOfflinePlayer(player);
+    }
+
+    /**
+     * Return a protection query helper object that can be used by another
+     * plugin to test whether WorldGuard permits an action at a particular
+     * place.
+     *
+     * @return an instance
+     */
+    public ProtectionQuery createProtectionQuery() {
+        return new ProtectionQuery();
+    }
+
+    /**
+     * Configure WorldGuard's loggers.
+     */
+    private void configureLogger() {
+        RecordMessagePrefixer.register(Logger.getLogger("com.sk89q.worldguard"), "[WorldGuard] ");
+    }
+
     /**
      * Create a default configuration file from the .jar.
      *
@@ -735,7 +921,7 @@ public class WorldGuardPlugin extends JavaPlugin {
                 if (copy == null) throw new FileNotFoundException();
                 input = file.getInputStream(copy);
             } catch (IOException e) {
-                getLogger().severe("Unable to read default configuration: " + defaultName);
+                log.severe("Unable to read default configuration: " + defaultName);
             }
 
         if (input != null) {
@@ -749,7 +935,7 @@ public class WorldGuardPlugin extends JavaPlugin {
                     output.write(buf, 0, length);
                 }
 
-                getLogger().info("Default configuration file written: "
+                log.info("Default configuration file written: "
                         + actual.getAbsolutePath());
             } catch (IOException e) {
                 e.printStackTrace();
@@ -787,7 +973,7 @@ public class WorldGuardPlugin extends JavaPlugin {
                 player.sendMessage(msg);
             }
         }
-        getLogger().info(msg);
+        log.info(msg);
     }
 
     /**
@@ -871,4 +1057,5 @@ public class WorldGuardPlugin extends JavaPlugin {
 
         return message;
     }
+
 }

src/main/java/com/sk89q/worldguard/bukkit/WorldGuardVehicleListener.java

@@ -1,96 +0,0 @@
-// $Id$
-/*
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
- * All rights reserved.
-*/
-package com.sk89q.worldguard.bukkit;
-
-import static com.sk89q.worldguard.bukkit.BukkitUtil.toVector;
-
-import org.bukkit.ChatColor;
-import org.bukkit.World;
-import org.bukkit.entity.Entity;
-import org.bukkit.entity.Player;
-import org.bukkit.entity.Vehicle;
-import org.bukkit.event.EventHandler;
-import org.bukkit.event.Listener;
-import org.bukkit.event.vehicle.VehicleDestroyEvent;
-import org.bukkit.event.vehicle.VehicleMoveEvent;
-import com.sk89q.worldedit.Vector;
-import com.sk89q.worldguard.LocalPlayer;
-import com.sk89q.worldguard.protection.ApplicableRegionSet;
-import com.sk89q.worldguard.protection.flags.DefaultFlag;
-import com.sk89q.worldguard.protection.managers.RegionManager;
-
-public class WorldGuardVehicleListener implements Listener {
-
-    private WorldGuardPlugin plugin;
-
-    /**
-     * Construct the object;
-     *
-     * @param plugin
-     */
-    public WorldGuardVehicleListener(WorldGuardPlugin plugin) {
-        this.plugin = plugin;
-    }
-
-    /**
-     * Register events.
-     */
-    public void registerEvents() {
-        plugin.getServer().getPluginManager().registerEvents(this, plugin);
-    }
-
-    @EventHandler
-    public void onVehicleDestroy(VehicleDestroyEvent event) {
-        Vehicle vehicle = event.getVehicle();
-        Entity destroyer = event.getAttacker();
-
-        if (!(destroyer instanceof Player)) return; // don't care
-        Player player = (Player) destroyer;
-        World world = vehicle.getWorld();
-
-        ConfigurationManager cfg = plugin.getGlobalStateManager();
-        WorldConfiguration wcfg = cfg.get(world);
-
-        if (wcfg.useRegions) {
-            Vector pt = toVector(vehicle.getLocation());
-            RegionManager mgr = plugin.getGlobalRegionManager().get(world);
-            ApplicableRegionSet set = mgr.getApplicableRegions(pt);
-            LocalPlayer localPlayer = plugin.wrapPlayer(player);
-
-            if (!plugin.getGlobalRegionManager().hasBypass(player, world)
-                    && !set.canBuild(localPlayer)
-                    && !set.allows(DefaultFlag.DESTROY_VEHICLE, localPlayer)) {
-                player.sendMessage(ChatColor.DARK_RED + "You don't have permission to destroy vehicles here.");
-                event.setCancelled(true);
-                return;
-            }
-        }
-    }
-
-    @EventHandler
-    public void onVehicleMove(VehicleMoveEvent event) {
-        Vehicle vehicle = event.getVehicle();
-        if (vehicle.getPassenger() == null
-                || !(vehicle.getPassenger() instanceof Player)) return;
-        Player player = (Player) vehicle.getPassenger();
-        World world = vehicle.getWorld();
-        ConfigurationManager cfg = plugin.getGlobalStateManager();
-        WorldConfiguration wcfg = cfg.get(world);
-
-        if (wcfg.useRegions) {
-            // Did we move a block?
-            if (event.getFrom().getBlockX() != event.getTo().getBlockX()
-                    || event.getFrom().getBlockY() != event.getTo().getBlockY()
-                    || event.getFrom().getBlockZ() != event.getTo().getBlockZ()) {
-                boolean result = WorldGuardPlayerListener.checkMove(plugin, player, event.getFrom(), event.getTo());
-                if (result) {
-                    vehicle.setVelocity(new org.bukkit.util.Vector(0,0,0));
-                    vehicle.teleport(event.getFrom());
-                }
-            }
-        }
-    }
-}

src/main/java/com/sk89q/worldguard/bukkit/cause/Cause.java

@@ -0,0 +1,243 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.bukkit.cause;
+
+import com.google.common.base.Joiner;
+import com.sk89q.worldguard.bukkit.util.WGMetadata;
+import org.bukkit.block.Block;
+import org.bukkit.entity.Entity;
+import org.bukkit.entity.EntityType;
+import org.bukkit.entity.Player;
+import org.bukkit.entity.Projectile;
+import org.bukkit.entity.TNTPrimed;
+import org.bukkit.entity.Tameable;
+import org.bukkit.entity.Vehicle;
+import org.bukkit.metadata.Metadatable;
+
+import javax.annotation.Nullable;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+
+/**
+ * An instance of this object describes the actors that played a role in
+ * causing an event, with the ability to describe a situation where one actor
+ * controls several other actors to create the event.
+ *
+ * <p>For example, if a player fires an arrow that hits an item frame, the player
+ * is the initiator, while the arrow is merely controlled by the player to
+ * hit the item frame.</p>
+ */
+public class Cause {
+
+    private static final String CAUSE_KEY = "worldguard.cause";
+    private static final Cause UNKNOWN = new Cause(Collections.emptyList());
+
+    private final List<Object> causes;
+
+    /**
+     * Create a new instance.
+     *
+     * @param causes a list of causes
+     */
+    private Cause(List<Object> causes) {
+        checkNotNull(causes);
+        this.causes = causes;
+    }
+
+    /**
+     * Return whether a cause is known. This method will return true if
+     * the list of causes is empty or the list of causes only contains
+     * objects that really are not root causes (i.e primed TNT).
+     *
+     * @return true if known
+     */
+    public boolean isKnown() {
+        if (causes.isEmpty()) {
+            return false;
+        }
+
+        boolean found = false;
+        for (Object object : causes) {
+            if (!(object instanceof TNTPrimed) && !(object instanceof Vehicle)) {
+                found = true;
+                break;
+            }
+        }
+
+        return found;
+    }
+
+    @Nullable
+    public Object getRootCause() {
+        if (!causes.isEmpty()) {
+            return causes.get(0);
+        }
+
+        return null;
+    }
+
+    @Nullable
+    public Player getFirstPlayer() {
+        for (Object object : causes) {
+            if (object instanceof Player) {
+                return (Player) object;
+            }
+        }
+
+        return null;
+    }
+
+    @Nullable
+    public Entity getFirstEntity() {
+        for (Object object : causes) {
+            if (object instanceof Entity) {
+                return (Entity) object;
+            }
+        }
+
+        return null;
+    }
+
+    @Nullable
+    public Block getFirstBlock() {
+        for (Object object : causes) {
+            if (object instanceof Block) {
+                return (Block) object;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * Find the first type matching one in the given array.
+     *
+     * @param types an array of types
+     * @return a found type or null
+     */
+    @Nullable
+    public EntityType find(EntityType... types) {
+        for (Object object : causes) {
+            if (object instanceof Entity) {
+                for (EntityType type : types) {
+                    if (((Entity) object).getType() == type) {
+                        return type;
+                    }
+                }
+            }
+        }
+
+        return null;
+    }
+
+    @Override
+    public String toString() {
+        return Joiner.on(" | ").join(causes);
+    }
+
+    /**
+     * Expand an cause object.
+     *
+     * @param list the list to add elements to
+     * @param element an array of objects
+     */
+    private static void expand(List<Object> list, @Nullable Object ... element) {
+        if (element != null) {
+            for (Object o : element) {
+                if (o == null) {
+                    continue;
+                }
+
+                if (o instanceof TNTPrimed) {
+                    expand(list, ((TNTPrimed) o).getSource());
+                } else if (o instanceof Projectile) {
+                    expand(list, ((Projectile) o).getShooter());
+                } else if (o instanceof Vehicle) {
+                    expand(list, ((Vehicle) o).getPassenger());
+                } else if (o instanceof Tameable) {
+                    expand(list, ((Tameable) o).getOwner());
+                }
+
+                // Add manually tracked parent causes
+                Object source = o;
+                int index = list.size();
+                while (source instanceof Metadatable && !(source instanceof Block)) {
+                    source = WGMetadata.getIfPresent((Metadatable) source, CAUSE_KEY, Object.class);
+                    if (source != null) {
+                        list.add(index, source);
+                    }
+                }
+
+                list.add(o);
+            }
+        }
+    }
+
+    /**
+     * Create a new instance with the given objects as the cause,
+     * where the first-most object is the initial initiator and those
+     * following it are controlled by the previous entry.
+     *
+     * @param cause an array of causing objects
+     * @return a cause
+     */
+    public static Cause create(@Nullable Object ... cause) {
+        if (cause != null) {
+            List<Object> causes = new ArrayList<Object>(cause.length);
+            expand(causes, cause);
+            return new Cause(causes);
+        } else {
+            return UNKNOWN;
+        }
+    }
+
+    /**
+     * Create a new instance that indicates that the cause is not known.
+     *
+     * @return a cause
+     */
+    public static Cause unknown() {
+        return UNKNOWN;
+    }
+
+    /**
+     * Add a parent cause to a {@code Metadatable} object.
+     *
+     * <p>Note that {@code target} cannot be an instance of
+     * {@link Block} because {@link #create(Object...)} will not bother
+     * checking for such data on blocks (because it is relatively costly
+     * to do so).</p>
+     *
+     * @param target the target
+     * @param parent the parent cause
+     * @throws IllegalArgumentException thrown if {@code target} is an instance of {@link Block}
+     */
+    public static void trackParentCause(Metadatable target, Object parent) {
+        if (target instanceof Block) {
+            throw new IllegalArgumentException("Can't track causes on Blocks because Cause doesn't check block metadata");
+        }
+
+        WGMetadata.put(target, CAUSE_KEY, parent);
+    }
+
+}

src/main/java/com/sk89q/worldguard/bukkit/commands/AsyncCommandHelper.java

@@ -0,0 +1,135 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.bukkit.commands;
+
+import com.google.common.util.concurrent.Futures;
+import com.google.common.util.concurrent.ListenableFuture;
+import com.sk89q.worldguard.util.task.FutureForwardingTask;
+import com.sk89q.worldguard.bukkit.WorldGuardPlugin;
+import org.bukkit.World;
+import org.bukkit.command.CommandSender;
+
+import javax.annotation.Nullable;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+
+public class AsyncCommandHelper {
+
+    private final ListenableFuture<?> future;
+    private final WorldGuardPlugin plugin;
+    private final CommandSender sender;
+    @Nullable
+    private Object[] formatArgs;
+
+    private AsyncCommandHelper(ListenableFuture<?> future, WorldGuardPlugin plugin, CommandSender sender) {
+        checkNotNull(future);
+        checkNotNull(plugin);
+        checkNotNull(sender);
+
+        this.future = future;
+        this.plugin = plugin;
+        this.sender = sender;
+    }
+
+    public AsyncCommandHelper formatUsing(Object... args) {
+        this.formatArgs = args;
+        return this;
+    }
+
+    private String format(String message) {
+        if (formatArgs != null) {
+            return String.format(message, formatArgs);
+        } else {
+            return message;
+        }
+    }
+
+    public AsyncCommandHelper registerWithSupervisor(String description) {
+        plugin.getSupervisor().monitor(
+                FutureForwardingTask.create(
+                        future, format(description), sender));
+        return this;
+    }
+
+    public AsyncCommandHelper sendMessageAfterDelay(String message) {
+        FutureProgressListener.addProgressListener(future, sender, format(message));
+        return this;
+    }
+
+    public AsyncCommandHelper thenRespondWith(String success, String failure) {
+        // Send a response message
+        Futures.addCallback(
+                future,
+                new MessageFutureCallback.Builder(plugin, sender)
+                        .onSuccess(format(success))
+                        .onFailure(format(failure))
+                        .build());
+        return this;
+    }
+
+    public AsyncCommandHelper thenTellErrorsOnly(String failure) {
+        // Send a response message
+        Futures.addCallback(
+                future,
+                new MessageFutureCallback.Builder(plugin, sender)
+                        .onFailure(format(failure))
+                        .build());
+        return this;
+    }
+
+    public AsyncCommandHelper forRegionDataLoad(World world, boolean silent) {
+        checkNotNull(world);
+
+        formatUsing(world.getName());
+        registerWithSupervisor("Loading region data for '%s'");
+        if (silent) {
+            thenTellErrorsOnly("Failed to load regions '%s'");
+        } else {
+            sendMessageAfterDelay("(Please wait... loading the region data for '%s')");
+            thenRespondWith(
+                    "Loaded region data for '%s'",
+                    "Failed to load regions '%s'");
+        }
+
+        return this;
+    }
+
+    public AsyncCommandHelper forRegionDataSave(World world, boolean silent) {
+        checkNotNull(world);
+
+        formatUsing(world.getName());
+        registerWithSupervisor("Saving region data for '%s'");
+        if (silent) {
+            thenTellErrorsOnly("Failed to save regions '%s'");
+        } else {
+            sendMessageAfterDelay("(Please wait... saving the region data for '%s')");
+            thenRespondWith(
+                    "Saved region data for '%s'",
+                    "Failed to load regions '%s'");
+        }
+
+        return this;
+    }
+
+    public static AsyncCommandHelper wrap(ListenableFuture<?> future, WorldGuardPlugin plugin, CommandSender sender) {
+        return new AsyncCommandHelper(future, plugin, sender);
+    }
+
+}

src/main/java/com/sk89q/worldguard/bukkit/commands/CommandUtils.java

@@ -0,0 +1,146 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.bukkit.commands;
+
+import com.google.common.base.Function;
+import org.bukkit.ChatColor;
+import org.bukkit.command.BlockCommandSender;
+import org.bukkit.command.CommandSender;
+import org.bukkit.command.ConsoleCommandSender;
+import org.bukkit.entity.Player;
+
+import javax.annotation.Nullable;
+
+/**
+ * Command-related utility methods.
+ */
+public final class CommandUtils {
+
+    private CommandUtils() {
+    }
+
+    /**
+     * Replace color macros in a string.
+     *
+     * @param str the string
+     * @return the new string
+     */
+    public static String replaceColorMacros(String str) {
+        // TODO: Make this more efficient
+
+        str = str.replace("`r", ChatColor.RED.toString());
+        str = str.replace("`R", ChatColor.DARK_RED.toString());
+
+        str = str.replace("`y", ChatColor.YELLOW.toString());
+        str = str.replace("`Y", ChatColor.GOLD.toString());
+
+        str = str.replace("`g", ChatColor.GREEN.toString());
+        str = str.replace("`G", ChatColor.DARK_GREEN.toString());
+
+        str = str.replace("`c", ChatColor.AQUA.toString());
+        str = str.replace("`C", ChatColor.DARK_AQUA.toString());
+
+        str = str.replace("`b", ChatColor.BLUE.toString());
+        str = str.replace("`B", ChatColor.DARK_BLUE.toString());
+
+        str = str.replace("`p", ChatColor.LIGHT_PURPLE.toString());
+        str = str.replace("`P", ChatColor.DARK_PURPLE.toString());
+
+        str = str.replace("`0", ChatColor.BLACK.toString());
+        str = str.replace("`1", ChatColor.DARK_GRAY.toString());
+        str = str.replace("`2", ChatColor.GRAY.toString());
+        str = str.replace("`w", ChatColor.WHITE.toString());
+
+        str = str.replace("`k", ChatColor.MAGIC.toString());
+
+        str = str.replace("`l", ChatColor.BOLD.toString());
+        str = str.replace("`m", ChatColor.STRIKETHROUGH.toString());
+        str = str.replace("`n", ChatColor.UNDERLINE.toString());
+        str = str.replace("`o", ChatColor.ITALIC.toString());
+
+        str = str.replace("`x", ChatColor.RESET.toString());
+
+        // MC classic
+
+        str = str.replace("&c", ChatColor.RED.toString());
+        str = str.replace("&4", ChatColor.DARK_RED.toString());
+
+        str = str.replace("&e", ChatColor.YELLOW.toString());
+        str = str.replace("&6", ChatColor.GOLD.toString());
+
+        str = str.replace("&a", ChatColor.GREEN.toString());
+        str = str.replace("&2", ChatColor.DARK_GREEN.toString());
+
+        str = str.replace("&b", ChatColor.AQUA.toString());
+        str = str.replace("&3", ChatColor.DARK_AQUA.toString());
+
+        str = str.replace("&9", ChatColor.BLUE.toString());
+        str = str.replace("&1", ChatColor.DARK_BLUE.toString());
+
+        str = str.replace("&d", ChatColor.LIGHT_PURPLE.toString());
+        str = str.replace("&5", ChatColor.DARK_PURPLE.toString());
+
+        str = str.replace("&0", ChatColor.BLACK.toString());
+        str = str.replace("&8", ChatColor.DARK_GRAY.toString());
+        str = str.replace("&7", ChatColor.GRAY.toString());
+        str = str.replace("&f", ChatColor.WHITE.toString());
+
+        return str;
+    }
+
+
+    /**
+     * Get the name of the given owner object.
+     *
+     * @param owner the owner object
+     * @return a name
+     */
+    public static String getOwnerName(@Nullable Object owner) {
+        if (owner == null) {
+            return "?";
+        } else if (owner instanceof Player) {
+            return ((Player) owner).getName();
+        } else if (owner instanceof ConsoleCommandSender) {
+            return "*CONSOLE*";
+        } else if (owner instanceof BlockCommandSender) {
+            return ((BlockCommandSender) owner).getBlock().getLocation().toString();
+        } else {
+            return "?";
+        }
+    }
+
+    /**
+     * Return a function that accepts a string to send a message to the
+     * given sender.
+     *
+     * @param sender the sender
+     * @return a function
+     */
+    public static Function<String, ?> messageFunction(final CommandSender sender) {
+        return new Function<String, Object>() {
+            @Override
+            public Object apply(@Nullable String s) {
+                sender.sendMessage(s);
+                return null;
+            }
+        };
+    }
+
+}

src/main/java/com/sk89q/worldguard/bukkit/commands/FutureProgressListener.java

@@ -0,0 +1,55 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.bukkit.commands;
+
+import com.google.common.util.concurrent.ListenableFuture;
+import com.google.common.util.concurrent.MoreExecutors;
+import org.bukkit.ChatColor;
+import org.bukkit.command.CommandSender;
+
+import java.util.Timer;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+
+public class FutureProgressListener implements Runnable {
+
+    private static final Timer timer = new Timer();
+    private static final int MESSAGE_DELAY = 1000;
+
+    private final MessageTimerTask task;
+
+    public FutureProgressListener(CommandSender sender, String message) {
+        checkNotNull(sender);
+        checkNotNull(message);
+
+        task = new MessageTimerTask(sender, ChatColor.GRAY + message);
+        timer.schedule(task, MESSAGE_DELAY);
+    }
+
+    @Override
+    public void run() {
+        task.cancel();
+    }
+
+    public static void addProgressListener(ListenableFuture<?> future, CommandSender sender, String message) {
+        future.addListener(new FutureProgressListener(sender, message), MoreExecutors.sameThreadExecutor());
+    }
+
+}

src/main/java/com/sk89q/worldguard/bukkit/commands/GeneralCommands.java

@@ -1,21 +1,21 @@
-// $Id$
 /*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
  *
- * You should have received a copy of the GNU General Public License
+ * You should have received a copy of the GNU Lesser General Public License
  * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
+ */
 
 package com.sk89q.worldguard.bukkit.commands;
 
@@ -150,7 +150,7 @@ public class GeneralCommands {
         }
 
         for (Player player : targets) {
-            player.setHealth(20);
+            player.setHealth(player.getMaxHealth());
             player.setFoodLevel(20);
             
             // Tell the user

src/main/java/com/sk89q/worldguard/bukkit/commands/MessageFutureCallback.java

@@ -0,0 +1,103 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.bukkit.commands;
+
+import com.google.common.util.concurrent.FutureCallback;
+import com.sk89q.worldguard.bukkit.WorldGuardPlugin;
+import org.bukkit.ChatColor;
+import org.bukkit.command.CommandSender;
+
+import javax.annotation.Nullable;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+
+public class MessageFutureCallback<V> implements FutureCallback<V> {
+
+    private final WorldGuardPlugin plugin;
+    private final CommandSender sender;
+    @Nullable
+    private final String success;
+    @Nullable
+    private final String failure;
+
+    private MessageFutureCallback(WorldGuardPlugin plugin, CommandSender sender, @Nullable String success, @Nullable String failure) {
+        this.plugin = plugin;
+        this.sender = sender;
+        this.success = success;
+        this.failure = failure;
+    }
+
+    @Override
+    public void onSuccess(@Nullable V v) {
+        if (success != null) {
+            sender.sendMessage(ChatColor.YELLOW + success);
+        }
+    }
+
+    @Override
+    public void onFailure(@Nullable Throwable throwable) {
+        String failure = this.failure != null ? this.failure : "An error occurred";
+        sender.sendMessage(ChatColor.RED + failure + ": " + plugin.convertThrowable(throwable));
+    }
+
+    public static class Builder {
+        private final WorldGuardPlugin plugin;
+        private final CommandSender sender;
+        @Nullable
+        private String success;
+        @Nullable
+        private String failure;
+
+        public Builder(WorldGuardPlugin plugin, CommandSender sender) {
+            checkNotNull(plugin);
+            checkNotNull(sender);
+
+            this.plugin = plugin;
+            this.sender = sender;
+        }
+
+        public Builder onSuccess(@Nullable String message) {
+            this.success = message;
+            return this;
+        }
+
+        public Builder onFailure(@Nullable String message) {
+            this.failure = message;
+            return this;
+        }
+
+        public <V> MessageFutureCallback<V> build() {
+            return new MessageFutureCallback<V>(plugin, sender, success, failure);
+        }
+    }
+
+    public static <V> MessageFutureCallback<V> createRegionLoadCallback(WorldGuardPlugin plugin, CommandSender sender) {
+        return new Builder(plugin, sender)
+                .onSuccess("Successfully load the region data.")
+                .build();
+    }
+
+    public static <V> MessageFutureCallback<V> createRegionSaveCallback(WorldGuardPlugin plugin, CommandSender sender) {
+        return new Builder(plugin, sender)
+                .onSuccess("Successfully saved the region data.")
+                .build();
+    }
+
+}

src/main/java/com/sk89q/worldguard/bukkit/commands/MessageTimerTask.java

@@ -0,0 +1,46 @@
+/*
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.sk89q.worldguard.bukkit.commands;
+
+import org.bukkit.command.CommandSender;
+
+import java.util.TimerTask;
+
+import static com.google.common.base.Preconditions.checkNotNull;
+
+public class MessageTimerTask extends TimerTask {
+
+    private final CommandSender sender;
+    private final String message;
+
+    MessageTimerTask(CommandSender sender, String message) {
+        checkNotNull(sender);
+        checkNotNull(message);
+
+        this.sender = sender;
+        this.message = message;
+    }
+
+    @Override
+    public void run() {
+        sender.sendMessage(message);
+    }
+
+}

src/main/java/com/sk89q/worldguard/bukkit/commands/ProtectionCommands.java

@@ -1,24 +1,26 @@
-// $Id$
 /*
- * WorldGuard
- * Copyright (C) 2010 sk89q <http://www.sk89q.com>
+ * WorldGuard, a suite of tools for Minecraft
+ * Copyright (C) sk89q <http://www.sk89q.com>
+ * Copyright (C) WorldGuard team and contributors
  *
- * This program is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
  *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+ * for more details.
  *
- * You should have received a copy of the GNU General Public License
+ * You should have received a copy of the GNU Lesser General Public License
  * along with this program. If not, see <http://www.gnu.org/licenses/>.
-*/
+ */
 
 package com.sk89q.worldguard.bukkit.commands;
 
+import com.sk89q.worldguard.bukkit.commands.region.MemberCommands;
+import com.sk89q.worldguard.bukkit.commands.region.RegionCommands;
 import org.bukkit.command.CommandSender;
 
 import com.sk89q.minecraft.util.commands.Command;
@@ -35,7 +37,7 @@ public class ProtectionCommands {
     }
 
     @Command(aliases = {"region", "regions", "rg"}, desc = "Region management commands")
-    @NestedCommand({RegionCommands.class, RegionMemberCommands.class})
+    @NestedCommand({RegionCommands.class, MemberCommands.class})
     public void region(CommandContext args, CommandSender sender) {}
 
     @Command(aliases = {"worldguard", "wg"}, desc = "WorldGuard commands")