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.
Is preventing building/destroying outside of own cuboids in plans for v2.3?
And I've next suggestion - limiting numer of cuboids/blocks, which a player can protect, set by permissons or at least in config file.
@praftor
Thanks. :)
Y... I'm a bit afraid about writing arguments in < and >, because typical users may have troubles with understanding it. :(
/ag expand changes area size and position to match the selection, so users only have to select the new area and run this command. It returns proper amount of money and checks if user have enough. :)
Tool is toggleable. :) You can change 20. configuration file line to change selection tool and 21. configuration file line to change information tool. :)
@IIIeeCode
You are welcome! I love your plugin and i've always been looking for one that works like this. As well as improving on the error messages, instead of /ag command, perhaps in my case /ag usable <areaname> ? :)
For the /ag expand i only suggested them to /ag sell and /ag buy again, since /ag expand doesn't seem too user-friendly. I suggest something like /ag edit <areaname> and they select the new expanded area, depending on the net difference of blocks, return them the $ or deduct money, of course with error validation if not enough $.
Also, can you make the tool toggable? Ever since i installed areaguard, my users are unable to use the wooden shovel entirely. Maybe /ag tool :)
@praftor
Wow, thanks. :D I added it in "Tutorials" section here and in BukkitForums AreaGuard post.
Btw. when typing /ag usable you just forgot to type area name. :) That command should be /ag usable droophouse. :)
Made a video to teach basic commands for my server users, You may use it to help your new plugin users for now. http://www.youtube.com/watch?v=9bq1hf6pcUM&list=UUrMMOtSCHvgNO3m3LAag5Mw&index=1&feature=plcp
@IIIeeCode I'm using WG priorities for a long time and I don't experience lags caused by this.
"I'll think of it, maybe I'll can add some option to choose worlds on which building outside of areas are globally denied." That's exactly what I asked, good stuff.
@HurricanePL
I can't make only 2 priorities, because it will be limit, and i want to avoid internal limits (unchangable by admins). I also can't make unlimited priorities, because it will cause lags, like in WorldGuard. :(
I'll think of it, maybe I'll can add some option to choose worlds on which building outside of areas is globally denied. Or maybe I'll make an addition for it, using upcoming AreaGuard 2.3 API.
What about something like cuboids hierarchy then? For example admin creates huge 'weak' cuboid and players can make their own 'stronger' cuboids inside of that 'weak', so they can build only in their 'strong' cuboids.
Collecting resoruces - There can be another world, intended only to gain stuff, where protections don't work at all.
@HurricanePL
It is, but BukkitDev Stuff have to approve it :( Each uploaded file have to wait until somebody checks it.
Currently it's impossible, because in that case players won't be able to gather resources necessary to survive. And making special checks, to exclude such situations, would affect performance. :(
Is it possible to prevent players placing and destroying blocks outside of their AG regions?
BTW. Download link isn't updated.
Announcement: AreaGuard 2.2 for CraftBukkit 1.2.5-R2.0 is out :) Changelog:
@HurricanePL Sorry that I reply to you in English, but it's for other people to be able to understand, because you asked important questions. :) I'll also reply to you in Polish in PM.
[Przepraszam, że odpisuję Ci po angielsku, ale to po to, żeby inni mogli zrozumieć, bo zadałeś ważne pytania. :) Odpiszę Ci też po polsku w PM.]
1. The AreaGuard 2.2 release will be published today (probably in less than hour). I'm sure that I'll do it on time, so I can finally announce it's release date. :) The only one unfinished feature is permissions, but I've already hooked them and I only need to make few conditional statements in code, so it's the matter of minutes. :)
2. I guess that WorldGuard region will deny non-allowed users from making changes, even if they are allowed by AreaGuard and vice versa. So, it should be possible to use both, the only problem is that one have to remember to don't make overlapping areas from different plugins, because it will be hard to predict who have rights to build. But there won't be any dangerous problems or something.
AreaGuard 2.2 have new option to change tools used for selection and taking area information, so tools also won't cause any conflicts.
Thanks. :)
Two questions: 1. When will the 2.2 release? 2. What is the case with coexistence with WorldGuard by sk89q? What will happen if the WorldGuard region tries to cover AreaGuard region? And vice versa.
BTW. Nice to see Polish creating pretty nice plugin, good luck!
Announcement: I postponed API to AreaGuard 2.3 release, because I wasn't sure how it should finally look like (cause I want to make it perfect, as everything) and it was blocking AreaGuard 2.2 release. Thanks to this, I can now focus directly on adding Valut money and permissions support.
<<reply 694581="">>
If you are talking about having more than one protected area - yes. You can make free areas or buy them like normal players (I use first for spawn and other server buildings and second when I play on survival on my server).
as an admin, can I have multiple protected area with this plugin?
@ChargedStatic
I checked and there is no bug. It should take 112 exp. This is equal to the total experience of about 6,5-level player.
Experience in Minecraft is not linear, every next level costs more. You probably bought it as higher-level player and it tooks less levels because higher level = more exp per level. For example if you made a 25x25x25 selection and use /ag gather or /ag earn:
If you want, you can change level calculation to linear with AreaGuard - just set amount of exp needed for achieving next level in 6th line of config.txt file ("6. Amount of exp needed to increase level by 1, or 0 for standard Minecraft level behaviour (default).").
I personally have it set to 10 on my server and it is quiet ok :) (it makes Minecraft less Tibia-like, and makes using AreaGuard easier)
Announcement: I created a forum. I'm not sure if it's necessary, but maybe somebody will find it useful.
[
FORUM]
@GrimblyGorn
I theoretically can, I forgot that this word is not used so often in that context, but I don't have any influence on already existing config files (without affecting the performance with more advanced updater, like this overloaded Bukkit config API).
PS. I checked it and it's a bit odd
^^
but still correct, so maybe I'll let it stay and it will look a bit quaint ;) How do you think?@ChargedStatic
Give me a while and I'll check it.
@IIIeeCode
Hi, i tested your plugin on my server and i created a 25x25x25 area. I was using the default config and everything. When i typed /ap gather it only took away 3 levels rather than 10 and i was able to create the area.