AreaGuardAreaGuard 2.2 for MC 1.2.5 (CraftBukkit 1.2.5-R2.0). Why AreaGuard? Server administrates himself - users work for tokens, then they claim areas to themself (there is configurable minimal limits to avoid trolling). Very lightweight and small (for faster loading) code. As simply as possible, yet still powerfull (it protects from everything, even non-owner passive mobs killing, and has all important functions). Get rid of thousands of unneeded stuff and focus on comfortable gameplay and administration. What this plugin provides? Area protections, defined by two points chosen by user. Users claim areas in cost of (configurable; server admin choose one method): special tokens bought for exp (to avoid losing areas exp-funds at death). [DEFAULT] special tokens bought for Vault money. Vault money (instead of buying it via tokens system). Optional Vault permissions support. Very detailed areas information, including information about specific area or listing of player's own areas. Support for Overworld, Nether and The End. Multiworld support. Protection from areas overlapping alongside with protection from too small areas (to avoid trolling with them) - all via configurable limits. Well-formated messages, with short commands, to speed up and make usage of this plugin more comfortable. Detailed help, both plugin built-in and bukkit help entries. No limits for the size of areas, also admin areas are free of charge. Lightweight, well-organised algorithm. Provide protection without high requirements. Includes protection for mobs, minecarts, redstone mechanisms and farmlands. Provide fire, flint and steel, explosions, paintings, fluids, pistons, fire charge, splash potions, natural ignition and growth protection. Protects non-player's own fire from being extinguished. Prevents Endermans from griefing. Ability to control mob spawning in areas and each area PVP settings. Very precisely tested to avoid unhandled exceptions. Really fast loading and response for commands. Well-organised file structure, each player's areas are in their own file. Only one config file, without thousands of unneeded options. Configuration file updates automatically on plugin update. PluginMetrics support (can be turned off). Selection and information tool are both configurable. Download [here] BukkitDev page? [here] Forum? [here] Tutorials? [here] Commands: Player /ag info - displays information about the area, in which player is standing. /ag info area_name - displays information about the area area_name. /ag list - lists areas owned by player. /ag guests area_name - displays guests of the area area_name. /ag addguest area_name guest guest2 ... - adds guests guest, guest2, ... to the area area_name. /ag delguest area_name guest guest2 ... - removes guests guest, guest2, ... from the area area_name. /ag rename area_name new_area_name - renames area area_name to new_area_name. /ag gift player area_name - gives area area_name to player player. /ag usable area_name - toggles area area_name usable flag (enables/disables minecarts and mechanisms usage by other players). /ag expand value - expands selection, in the direction player's looking at, by value blocks (use negative value to reduce selection). Proper directions are: north, south, west, east, up, down. /ag expand value where - expands selection, in the where direction, by value blocks (use negative value to reduce selection). /ag gather - buys (for exp) tokens in amount sufficient to pay for currently selected area (and automatically buys one token more, if rounding function tries to mess the transaction up). /ag earn amount - buys amount of tokens for the cost of experience points. /ag funds - displays information about tokens amount, which player possess. /ag give player amount - gives amount of tokens to the player player. /ag cost - displays cost of protecting area, which is currently selected by right and left-clicking opposite corners with wooden shovel. /ag buy area_name guest guest_1 guest_2 ... - buys protection, named area_name, for area, which is currently selected by right and left-clicking opposite corners with wooden shovel. Optionally adds guests guest, guest_1, guest_2, ... to guest list of the new area. /ag sell area_name - removes protection called area_name and pays back tokens spent for it. /ag extend area_name - resizes protection, called area_name to the area, which is currently selected by right and left-clicking opposite corners with wooden shovel. This command charges or pays back proper amount of tokens, depends on size of the new area in relation to the old one. /ag help - displays in-game AreaGuard help. /ag cmdshelp - displays in-game AreaGuard, commands-related, help. /ag tokhelp - displays in-game AreaGuard, tokens-commands-related help. Operator-only /ag ophelp - displays in-game AreaGuard operator's help. /ag tokophelp - displays in-game AreaGuard, tokens-related, operator's help. /ag info area_name player - displays information about the area area_name owned by player. /ag list player - lists areas owned by player player. /ag guests player area_name - displays guests of the area area_name, owned by player. /ag add area_name guest guest_1 guest_2 ... - adds protection, named area_name, for area, which is currently selected by right and left-clicking opposite corners with wooden shovel. Optionally adds guests guest, guest_1, guest_2, ... to guest list of the new area. /ag resize area_name - resizes protection, called area_name to the area, which is currently selected by right and left-clicking opposite corners with wooden shovel. /ag del player area_name - removes protection owned by player and called area_name. /ag donate player amount - donates player player with amount of tokens. /ag pvp area_name player - toggles area area_name, owned by player, PVP flag (enables/disables PVP in that area). /ag takeover player area_name - changes owner of protection called area_name and owned by player to command sender. /ag funds player - displays information about tokens amount, which player player possess. /ag levy player amount - decreases player player tokens amount by amount. Config.txt syntax Minimal area width. Minimal area length. Minimal area height. Minimal area cost. Amount of tokens granted for one experience point. Amount of exp needed to increase level by 1, or 0 for standard Minecraft level behaviour (default). If ignition other than caused by flint and steel or fire charge is denied? (1 = true, 0 = false, default 1) If explosions are globally denied? (1 = true, 0 = false, default 1) If PVP, monster spawning and monster damage are denied in areas? (1 = true, 0 = false, default 0) If PVP is denied outside of areas (if not, it just don't affect server.properties settings)? (1 = true, 0 = false, default 0) [use it when you want to allow PVP in server.properties, and deny outside of areas, allowing it only in chosen "PVP arenas"] Maximal area width (0 = unlimited). Maximal area length (0 = unlimited). Maximal area height (0 = unlimited). Maximal area cost (0 = unlimited). If enchanting should charge player (1 = yes, 0 = no, default 1). Amount of tokens earned for one economy coin (0 = indirect Vault economy disabled, more than 0 = indirect Vault economy enabled; default 0). Cost of protecting one block (0 = direct Vault economy integration disabled, more than 0 = tokens system disabled and replaced by buying protection for money, default 0)? If Vault permissions are enabled (1 = yes, 0 = no, default 0). If AreaGuard is denied from sending usage statistics via PluginMetrics (1 = yes, 0 = no, default 0). Selection tool item ID (default 269 = wooden shovel). Information tool item ID (default 287 = string). Changelog? [here] (sorry for changelog not present here, but the forum script yelled at me that the post is too long ) Optional permission nodes: areaguard.info - grants access to informational commands (/ag info, /ag list, /ag guests, /ag funds, /ag help,/ag cmdshelp, /ag tokhelp). areaguard.player - grants access to all player commands. areaguard.op - grants access to all operator-only commands. Note about spawn protection in lastest CraftBukkit, which omits protection plugins settings (a brief instruction about how to get rid of it)New CraftBukkit added protection for small area around the spawn. Unfortunatelly, it blocks any actions without checking what protection plugins think about it. The easiest way to get rid of this problem is to disable it and set up normal spawn protection via protection plugin (for example AreaGuard). So, the solution to disable that strange CraftBukkit behaviour is to open bukkit.yml file and set //spawn-radius// option in //settings// group to 0. It should look like this: Code: settings: spawn-radius: 0 Remember: that double space before "spawn-radius" is necessary! PluginMetrics? [click on the image to see more statistics] PluginMetrics license note? [here] Data storage syntaxEach of listed below directories contains files named after player nicknames. Each file contains data about specific player. Type of data in file is determined by file's parent directory (for example: accounts directory contais files with tokens data, etc.). AreaGuard/accountsThis directory contais files with tokens data. The syntax is: Amount of tokens owned by player (int). AreaGuard/areasThis directory contais files with areas data. The syntax is: Smaller X coordinate (int). Smaller Y coordinate (int). Smaller Z coordinate (int). Bigger X coordinate (int). Bigger Y coordinate (int). Bigger Z coordinate (int). Area name (String). Area owner name (String). Name of the world, area is defined in (String). First guest name (String). Second guest name (String). (...) Last guest name (String). # The "#" sign on the end of guests list is necessary list terminator. Even when there is no guests in area, there have to be "#" sign after the area's world name. If there is more than one area owned by player, each lines, beginning with smaller X coordinate and terminated by "#" sign, describes one of such areas. AreaGuard/flagsThis directory contais files with flags data. The syntax is: Area name (String). If non-owner's (neither guest or operator) mechanisms usage (this refers also to Minecarts usage) in area is allowed (0 or 1, 0 means "no", 1 means "yes"). If PVP in area is allowed (0 or 1, 0 means "no", 1 means "yes"). If there is more than one area owned by player, each three lines (beginning with area name) describes one of such areas. Which plugins are the best addition to this one? LogBlock or CoreProtect (logging players actions). LWC (protection against thefts). TradeCraft-AE (chest shops based on REAL money (items, not artificial digital money)) motd (player-to-player teleportation requests, MOTD and time votes) CraftBukkitUpToDate (plugin, which helps you to keep your server/plugins up to date) Plans for AreaGuard 2.3? Minimalistic API (advanced enough for making extensions for AreaGuard, but made without additional code ballast). Translations support.