AreaGuard
AreaGuard
AreaGuard 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.
Commands
Config.txt syntax
Optional permission nodes
Changelog
Data storage syntax
Forum
Tutorials
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:
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
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.
Could you please change all instances of the word "maximal" to "maximum" :)
Announcement: AreaGuard 2.1 for CraftBukkit 1.2.5-R1.0 is out :) Changelog:
Announcement: I need a little break, before finishing AreaGuard 2.1 and 2.2, and I made a new logo (this time - vector one) :)
@nomercy4you
But setting coordinates via giving numbers in arguments, rather than by clicking blocks with wooden shovel is more difficult for typical user. And the plugin is mainly adressed for user-side protection, so it should be simply for players.
I know that it's difficult when one point is in the air. Theoretically I can add command to set position to the block under player, but:
//
pos1", "//
pos2" and click (or, if they don't have WorldEdit, they can make dirt pillar very fast in creative mode).I mean, that "shovel-clicking" kind of selection is the easiest for normal, inexperienced user. I know, that in some cases using numbers is easier, but it's rather uncommon - that's why helping yourself with WorldEdit, in that specific cases, is better than expanding plugin by adding rarely used commands to it.
So... to be honest, I don't see now, why this feature is important. I don't say no for ever :O , but for now I have no idea for what it could be used (excluding some rare usage). Please, if you could provide more details why it can be usefull, I will consider adding it.
But, I will probably be checking API stuff in near future, and that feature will be very easy to add as extension for AreaGuard. I think, it's the best solution to avoid increasing plugin size and providing that functionality to those, who need it. So... give me some time and I will probably make it as an extension.
I really like your plugin, but selecting the region is a pain in the ass :) Maybe you could add commands to set first and second point directly (/ag set 1 243 4343 -54 for Setting first point to234/4343/-54 Coords). And/Or like WorldEdit commands:
Would be very cool :)
It doesn't matter when the XP comes from, so - yes.
Cost of 1 token depends on administrator settings in config.txt file. On my server user gets 157 tokens for 1 exp This value is equal to about 25x25x25 cuboid for 10'th level (with standard Minecraft level equation). This is also the default setting if you don't change anything in config.txt
Can this system use Bottle o' enchating or other sources of XP than mobs? and how much costs 1 token?
@tedjansen
Killing monsters in Minecraft 1.8pre1 and higher is rewarded with not only items drop, but also drop of experience orbs, which, after collecting them, increase player's experience points amount.
But how to get it?
@tedjansen
Y... xp = exp xD I mean experience points :)
I got Minecraft 40 XP but how to get EXP?
@noahdutch
Theoretically that's not a problem, but - adding additional option used only by a part of community is a unnecessary balast of code for the others.
I'd rather take a look how to allow plugins developers to use AreaGuard functions in their plugins (I mean if it's possible to create an API, which won't slow down the plugin like normal API's) - and then it probably will be possible to made as a small addition plugin.
@tedjansen
:O It's impossible, maybe you are talking about rounding down function, which disallows you from buing only 1 token, because you have to spend at least one experience point to buy anything (so you have to buy at least amount of tokens equal to the value of one experience point - it's made to prevent players form buying free tokens when given amount is lower than token factor).
Valut have nothing to do with that, it's not implemented yet, because on survival servers exp is the most cheat-resistant solution (xrays and other shit don't affect it) - that's why I made experience economy first.
Do you mean vault? I have 40 XP and when i try to buy 1 token it says that i dont have enough!
Do you think you could integrate this plugin with marriage, so that 2 married people are allowed to share their tokens for an area of land?
@DerPavlov
To be honest - yes and no. There is something like API, but it works differently. I didn't make any API on purpose, because it will slow down the plugin, and I came up with more external solution :) AreaGuard have flatfile data storage, which do areas save at any in-memory data change. So, you can just safely grab information from AreaGuard data directory. It can't be non-up-to-date (I don't think it's possible to aim perfectly, with some event, beetween area creation and AreaGuard data save (which takes place even before user get confirmation message about creating an area)).
There is information about AreaGuard's data storage syntax: Data storage syntax.
You just have to read areas directory and search if some area contains such coordinates :)
Does this plugin have an API where I can request if a block at a certain location is protected?
Announcement: AreaGuard 2.0 for CraftBukkit 1.2.5-R1.0 is out :) Changelog:
@trungtoto
It's now avaiable. Sorry for the delay.
We had to wait few hours, I couldn't do anything to speed it up. AreaGuard 1.9 was already uploaded when you were asking me for it's download link, but, as all plugins on BukkitDev, it needed approval of moderator.
I always delete old versions to prevent people from using outdated versions, because otherwise a lot of people download it even when the new is already avaiable (really, I noticed it when looking on statistics o.O). That's why there were temporarily no dowload link (before BukkitDev moderator have accepted AreaGuard 1.9).
Next time, I will wait with deleting previous versions until new one will be accepted. Sorry :( I thought it will be done faster.
how do i download this mod ... there is no link to any download
Announcement: AreaGuard 1.9, which I posted a while ago, is the first release, which includes all features, which I treat as "critically important". It protects everything (even Splash Potions or Fire Charge) and can be used as 100% safe area protection plugin now.
Now I will focus on adding translations support, Valut money support and permissions support (through Valut). It's very easy, so I will finish it as fast as I can :)