AreaShop
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Usage and configuration: ►Download (releases) ►Commands and Permissions
____ ►Basic regions setup_ ►Advanced regions setup_ ►Configuration files
Advanced features: ►Save/restore region blocks_ ►Change the language_ ►Limitgroups
Troubleshooting: ►Frequently Asked Questions_ ►Common errors
Support: ►Ask question / request feature / report bug_ ►Planned features_ ►Open bugs
Development: ►Changelog_ ►Compiling_ ►Modules, packages and classes overview
Connections: ►GitHub_ ►Spigot Resources_
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
This plugin is for giving players the option to rent or buy a region. It could be used to let them rent a jail in your Prison server or maybe a shop in the market of the Survival server. The player interacts with signs, making it easy to use. It also has a lot of commands to check the status of all regions, manage the renting and buying of a region and also features for admins. Also the plugin is capable of saving the region and restoring it later, this is very flexible and can be set general and per region, check the config for more information.
All features in a list:
- Rent and sell regions to players + Players can resell their bought regions to other players
- Signs for easy interacting and current status
- Change the language of the plugin or use of of the already provided language files (check here for supported languages, these are already packed with the plugin, just change the language setting in the config).
- Automatically let the plugin restore the region with schematics
- Change which commands players can use with permissions
- Customize the plugin by changing the config
- Automatically place the region name on the sign if it is placed inside a region
- Teleport to rent/buy regions and optionally set the teleport location (teleporting is safe and within the region)
- Adding friends to regions (which also can teleport then)
- Automatic unrent/sell for regions of which the owner is offline for a certain time
- Warning to players when their rent is about to run out (at login and while they are online)
- Group system to set options for a couple of regions instead of all of them.
- All heavy tasks are spread over time (each tick a part is executed until done), so the plugin should not cause any lag.
- Rent/buy limits can be different per permission node (player group), world or group of regions (possible situation: Normal players can buy 1 market region in survival + 1 build region in survival and 2 plots in creative, while VIPs have double limits for all those), check this example.
- Supports name changes because of saving player info by UUID, for more details check the FAQ entry: What happens when a player changes his name?
You need to have WorldEdit, WorldGuard and Vault installed on your server, WorldGuard is used for creating and managing regions, WorldEdit for the saving and restoring the blocks in regions and Vault is used to let players pay for the regions.
Preview
For a preview join 'mc.go-craft.com' and go to the Survival server, the shops around the spawn use AreaShop.
Tutorial & Feature overview (AreaShop V2.0.1)
Made by Koz4Christ
Prison cell setup tutorial (AreaShop V2.1.0)
Made by PerkulatorTime
Old video for AreaShop v1.0: Tutorial by VariationVault
Requirements and installing
Requirements:
- Server software: Bukkit 1.7.9 or higher, Spigot 1.7.9+ or higher
- Java 7 or higher (latest recommended)
- WorldGuard 5.9 or higher (6.0+ recommended)
- WorldEdit 5.6.3 or higher (6.0+ recommended)
- Vault 1.4.1 or higher
- An economy plugin supported by Vault (check the Vault page for a list of supported plugins)
When you have installed AreaShop, have correct server software and all required plugins installed (and the correct versions of them) you can startup your server. After that you can edit the config.yml and default.yml file of AreaShop to your liking and after that you use '/as reload' to reload the configs. Then you can start by setting up regions and adding them to AreaShop.
Notification for new versions
To enable email notifications for new versions of this plugin follow these steps:
- Login to dev.bukkit.org
- Go to the 'Subscriptions' tab Link
- Tick the checkbox for 'File updates'
- Confirm your choice
Metrics
This plugin utilizes Hidendra's plugin metrics system, which means that the following information is collected and sent to mcstats.org:
A unique identifier, the server's version of Java, whether the server is in offline or online mode, the plugin's version, the server's version, the OS version/name and architecture, the core count for the CPU, the number of players online, the Metrics version.
This information will give me an indication about how much the plugin is used and encourages me to continue development. Opting out of this service can be done by setting 'sendStats' in the config of this plugin to 'false', if you want to disable Metrics for any plugin go to plugins/Plugin Metrics/config.yml and change 'opt-out' to 'true'. Check graphs of the statistics at this page: mcstats.org/plugin/AreaShop
Do you want to translate AreaShop?
Help translating the plugin into different languages and to keep the translations up to date. Go to this page for more information. Translating goes through the Transifex website and is very easy, sending files back and forth is not needed, you can translate lines online and whenever you want. Every line you translate will be saved, no need to do it all at once (this also allows for easy collaboration).

-
View User Profile
-
Send Message
Posted Dec 10, 2014@TNTUP
Ah, I did not even think about schematic creation when writing my last message, that is indeed a big lag causer if it happens for a big region. What exactly did not happen before? If you had schematics set up in an older version of AreaShop it would do exactly the same. Is the problem you have that if you place a normal sign that has nothing to do with AreaShop that it lags? I don't think AreaShop would cause lag for things like that, could be another plugin doing that. The timings report is showing very high numbers for signChangeEvent for AreaShop because you accidentally added some big regions, which cause schematic creation and that takes a second or two. If you create a report with while only placing normal signs then I think AreaShop should have a very low numer there.
-
View User Profile
-
Send Message
Posted Dec 9, 2014@nlthijs48
Well, must be something I did because placing signs in a big region does indeed lag (schematic creation) that idk how to prevent it, before it didn't happened (maybe old release of AS?) that should even not ignoring if no region specified on the sign, should I send you the config how where I did wrong?
-
View User Profile
-
Send Message
Posted Dec 9, 2014@Ironic8b49
Yeah I see that the new Vault is released, the 1.4.1 version already works with the Spigot 1.8 build though. So are you just trying to notify me that the new version is out or is there some kind of problem with it?
@ForbiddenGlory
What exactly are you having trouble with? Am I right that you want a big region and then small regions inside of that which are registered as buy or rent in AreaShop? The important part is to set these small regions to priority 1 or the big one to priority -1, that way the AreaShop regions will work correctly. It is hard to help you if I don't exactly know what you want or need help with, so if you still can't figure it out then please describe what you want and what is already working.
@TNTUP
So you want to blacklist regions because sometimes you place a sign outside of a regions which causes AreaShop to accidentally add one of the big regions? The global region will never be used by AreaShop unless explicitly specified on the sign. That is because the WorldGuard methods that return regions at a certain location do not include the global one. Actually excluding regions from being used is not possible currently, it would be something to look into though.
If you don't specify the region on the signs then AreaShop is going to ask all regions at that spot from WorldGuard and then checking to see which one is best to use (highest priority and childs instead of parent regions). That could cause lag if you have a lot of regions or if WorldGuard is slow. If however a sign is placed that is not meant for AreaShop (the first line does not match the config setting) then it will do nothing and should not cause any lag at all. Do you use flatfile or SQL for saving the WorldGuard regions? Someone else had major lag spikes when doing something in AreaShop because WorldGuard took a long time to react because of an SQL setup.
I don't think the high number at the signchangeevent mattert too much, it will only be like that when you are adding regions (which I assume you don't do every minute). But if I can do anything to improve the performance of AreaShop then of course I will do so.
-
View User Profile
-
Send Message
Posted Dec 9, 2014Can we blacklist region names that shouldn<t be buy-able? [buy] signs autodetects where the sign is placed, thus resetting ownes and members in city regions. Like disallowing global, <cityregion>A, b...
Uh why timings shows http://timings.aikar.co/?url=9446595 658% pct tick for SignChangeListener::onSignChange(SignChangeEvent)? I dont think thats the lag cause theres dynmap too but idk how to find the culprit
-
View User Profile
-
Send Message
Posted Dec 8, 2014Could you please walk me through how to create a shop where u can put chest and signs with the over lapping regions, thats where im stuck on :(
-
View User Profile
-
Send Message
Posted Dec 8, 2014@tk11
Vault 1.5.0 was released today and maker says it's fully updated for Bukkit 1.8
-
View User Profile
-
Send Message
Posted Dec 8, 2014@tk11
Nice that you got it working correctly.
@Ironic8b49
It is indeed in the video, but you can't remember everything from that after watching it one time, that is why the comment section here is available :)
-
View User Profile
-
Send Message
Posted Dec 8, 2014@nlthijs48
that's what I missed to set the teleportIntoRegion to false, thanks! would of fixed earlier but had major issue with spawn took me forever to figure it out.
-
View User Profile
-
Send Message
Posted Dec 8, 2014@nlthijs48
thanks to the simple fix, after reading your reply I remember seeing that in a setup video or reading it. When you get busy things get forgotten.
-
View User Profile
-
Send Message
Posted Dec 8, 2014@nlthijs48
Okay, that worked. I am migrating from CB 1.7.9 to Spigot 1.8 and added a number of plugins to the Spigot build that I am using on CB but things started breaking, so I decided to take everything out and make sure plugins run one at a time. I started by getting the good versions of WG and WE to work, and then added Vault. I tried adding AreaShop and then another plugin that depends on Vault, but it would not find it. I was not realizing that it needed an eco plugin for it to even activate. I put the new Essentials and Gringotts back in and AreaShop works fine now.
Thanks
-
View User Profile
-
Send Message
Posted Dec 8, 2014@tk11
I currently run Vault 1.4.1 myself and have no trouble at all with it. Do you also have an economy plugin installed that provides the economy to Vault? That is needed because Vault only connects the economy providing plugins with the economy using plugins, acting as a consistent interface for plugins to connect. For example I'm using EssentialsEco as the economy provider (for Spigot you need to use the Essentials and EssentialsEco versions that they provide, and not the ones on BukkitDev).
-
View User Profile
-
Send Message
Posted Dec 8, 2014You say that this works with Spigot 1.8. Is there a version of Vault that works? I cannot seem to get Vault working on Spigot; every plugin (including AreaShop) that depends on it will not load because it says Vault is not loaded or found. I have tried with 1.4.1 and 1.5.0.
-
View User Profile
-
Send Message
Posted Dec 7, 2014@Ironic8b49
There is an easy solution for your problem, you can simply change the tag that AreaShop should look for to register buy regions. In the config.yml file there is a 'signTags' section, here you can change the line with [buy] to something else (could use [abuy] or something). Then after a restart/reload or use of the '/as reload' command AreaShop will not interfere with the Essentials signs anymore.
If you have any other questions feel free to ask.
-
View User Profile
-
Send Message
Posted Dec 7, 2014Been running Areashop for a few weeks now, today I noticed when I was trying to make a buy sign for Essentials Areashop took over on how the sign was filled out. How do I fix this issue? to make that sign I removed Areashop plugin started up server and made sign then replaced Areashop plugin. I'm not using the buy sign in Areashop yet, but was planning on using it in the future. I'm running Areashop 2.0.2, Essentials 2x and Spigot 1.8.
-
View User Profile
-
Send Message
Posted Dec 7, 2014@ForbiddenGlory
If you send me the details of your server (ip/hostname) so that I'm able to join then I can help you (use a private message if it should not be public). I can't join now though, because I'm going to sleep soon. I'm available tomorrow between 15:00 and 21:00 GMT+1, so then I could try and help you. Maybe it is also handy to send me your Skype name, then we can talk to eachother tomorrow (and know when we are both online).
-
View User Profile
-
Send Message
Posted Dec 7, 2014Can you please come on my server and help me out with the setting up, ive been trying for like an hour and still done get it! Thanks
-
View User Profile
-
Send Message
Posted Dec 7, 2014@SeeingBlue
Actually creating their own regions (within certain boundaries) and selling/renting them to other players is not possible yet. The thing that is added in the last update though is the reselling of regions. So if a player bought a region (that is setup by an admin), then he can use '/as resell <price> [region]' to start reselling this region to another player. That would change the sign to something that looks like the [For Sale] sign, but then with [Resale] on the first line (configurable of course like the other sign layouts). Then when another player decides to buy this region (by command or right-clicking the sign) it will transfer the money from the buyer to the original owner and changes the owner to the new player.
The reason why the system to let players create their own regions and signs is not added yet is simple: It is a lot of work and quite complicated. Not that I'm lazy or something (check the massive changelog of the previous update), but it really is a lot of work. One other concern is that this is really advanced use of the plugin, and probably 90% of the users would never touch it.
Some of the things that should be implemented to support this:
And then I'm probably still forgetting a lot of things. Another point of concern is that all these things will add complexity to the plugin and probably also a lot of extra config options. So it should be well thought out to keep it easy to use for server owners that don't need these features. Quite a long story about this, but I hope it is a bit more clear why this is taking time and needs a lot of work. But I agree that this would be unique for the plugin and a good 'selling' point.
@Sinuce
Yep the warning system is implemented. Warning on login when the players has a region with a leftover rent time below a certain threshold is in there (default.yml -> 'rent.warningOnLoginTime'), and also a system that sends warnings at specific 'rent leftover' times when the player is online (config.yml -> 'expirationWarningProfiles'). You probably already found those things, but others might not have :)
-
View User Profile
-
Send Message
Posted Dec 7, 2014Nice, there's a Warning System in the new update as well :)
-
View User Profile
-
Send Message
Posted Dec 7, 2014@nlthijs48
Hello friend. No time no see. According to what I am reading, players still are unable to create and sell their own regions. They must be created by admins, then players can buy/sell them, but are unable to set the price, they'll only get back a percentage of what they paid?
Man this community is really in need of a full fledged plugin that allows users to create, sell, & rent their own creations. You're plugin would be top dog if it could do this. There is nothing else out there right now.
-
View User Profile
-
Send Message
Posted Dec 7, 2014@AllTimeAmy
Het gebied dat je hebt aangemaakt met WorldGuard word deze ook weergegeven in de lijst als je '/region list' doet? (Kan meerdere pagina's hebben). Als hij niet in deze lijst staat dan is er iets fout gegaan bij het aanmaken van het gebied, probeer het dan opnieuw met '/region define <naam>'.
Kijk ook even in de log bestanden van je server of er errors zijn bij het opstarten van de server of later bij het gebruiken van AreaShop. Check ook of WorldGuard, WorldEdit en Vault correct worden geladen.
Als je nog problemen hebt stuur dan even weer een bericht, ik zou eventueel ook je server kunnen joinen om even te helpen (stuur dan even je ip in een prive bericht).