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 May 2, 2015@Androkai
ok in my config file all i have in there is this
plugin-channel: world_info inform-player: false encoding: UTF-8
Yet in the config file part of this page it has a lot more. so i copied it into the config file
And it now works, dont know why the config files didn;t have what it was meant to have. been trying to figure this out for 2 days now lol
Thank you very much for getting back to me and thanks for a good looking region shop plugin :)
(also i've set the regions up ie shop1 shop2 eg eg i have one of them that is in the boundaries that i set out for the region. but the other 3 are not in the region i defined. one is in the next 16blocks besides it where the main Market region is, the others are like a few blocks outside of the region. i don't get what is going on.
-
View User Profile
-
Send Message
Posted May 2, 2015@Fioletowy
The command /areashop (not /arenashop) should work...
Alternatively you can add this to your command.yml:
Then you can use also /smth and /arenashop for using AreaShop.
-
View User Profile
-
Send Message
Posted May 2, 2015There is any way to change /as to /arenashop or smth like that? Because ASkyBlock plugin is using /as so commands from AreaShop are not working.
-
View User Profile
-
Send Message
Posted May 1, 2015@nlthijs48
ok in my config file all i have in there is this
plugin-channel: world_info inform-player: false encoding: UTF-8
Yet in the config file part of this page it has a lot more. so i copied it into the config file
And it now works, dont know why the config files didn;t have what it was meant to have. been trying to figure this out for 2 days now lol
Thank you very much for getting back to me and thanks for a good looking region shop plugin :)
(also i've set the regions up ie shop1 shop2 eg eg i have one of them that is in the boundaries that i set out for the region. but the other 3 are not in the region i defined. one is in the next 16blocks besides it where the main Market region is, the others are like a few blocks outside of the region. i don't get what is going on.
-
View User Profile
-
Send Message
Posted May 1, 2015@McKenzie87
The latest version should work for Bukkit/Spigot 1.7.9 or higher, so yes it is compatible. If you already added a region to AreaShop with the command '/as add', then you cannot use the [rent] sign again, because the region is already added (it should say that in chat if you try it). If you want to add a sign to an existing AreaShop region then you can use '[as]' on the first line and the region name on the second line.
If making a sign does not trigger any message at all from AreaShop, then I suggest you check the config.yml file. In the 'signTags' section is defined which word you should write on the first line of a sign to trigger AreaShop, make sure that you use that ingame (by default [rent] should be correct).
If the help menu is showing correctly then the plugin should work fine, but it might be wise to still check your log file to see if there are any errors about AreaShop.
-
View User Profile
-
Send Message
Posted May 1, 2015Hi there.
I was just wondering if Areashop was 1.7.10 compatible. The /as help menu comes up and i can use the /as add rent [name] and it says it's been created. But when it do
[rent] Shop1 (name of the region) 1 d 100
the sign just acts like the normal mc way. It doesn't change. I've watched both videos on here and done what they both say. but it doesn;t work. Ive also uninstalled it and reinstalled it. and the version is the current one. and yes im using all the plugins that are needed for this to work.
Many thanks
McKenzie87
-
View User Profile
-
Send Message
Posted May 1, 2015@Androkai
Thanks for the pull request, I accepted and merged it. I probably looked over those lines more than 10 times, luckily you found the problem :) Apparently Eclipse simply assumes a certain Java version sometimes, because I have made a bunch of successful builds already to test the support for all WorldGuard/WorldEdit versions.
I will update the README on GitHub with instructions for others later, maybe I have some time for that this weekend.
-
View User Profile
-
Send Message
Posted Apr 30, 2015It works! *YES!*
Fixed a typo in pom.xml and now it works. You have a pull request (my first one I ever made).
-
View User Profile
-
Send Message
Posted Apr 30, 2015@nlthijs48
I compile it on a linux-debian-server without any interface so it`s a little bit more difficult but I work on it. Let you know if I could bring it work :)
-
View User Profile
-
Send Message
Posted Apr 30, 2015@Androkai
Make sure you have Java jdk 7 installed. Assuming you are using Eclipse as IDE, you can do rightclick on the "areashop-parent" module, then click Maven > Update Project. Now it shows a small progress thing at the bottom right, wait until that is done. Then use rightclick on that module again, and click Run as > Maven Install. That should work correctly.
I also had and have the "javacTask: source release 1.7 requires target release 1.7" sometimes, but the update thing I described above fixed that for me.
I already tried all of the suggestions in the link about downloading files (found that link myself a couple hours ago), but none of them seem to do the job correctly. The problem is that I want to download a file, and then immediately use it as dependency. But if the file is not downloaded yet, then it will fail the build before even starting. And since all of those suggestions use a task in the build process itself, none of those ever get executed. I'll try to look around a bit more for a solution for that, hopefully I can find something for that.
At least thanks for trying to compile it, while there is not documentation for it yet.
-
View User Profile
-
Send Message
Posted Apr 30, 2015@nlthijs48
It starts compilation now but always die at AreaShop-part, here´s my full log: <log>
I googled between a bit about maven downloading files, maybe it helps: <klick>
-
View User Profile
-
Send Message
Posted Apr 30, 2015@Androkai
I still need to update the compiling instructions in the README on GitHub, this is definitely something I should mention in there.
All dependencies can be automatically downloaded by Maven, except Vault. Vault does not have a repository, so instead you need to download Vault V1.4.1 manually. Place that jar file in the "/Dependencies" folder with the name "Vault.jar" (Dependencies folder is at the same level as AreaShop, WorldGuard 5, etc). Still after that it will warn you that using a dependency like this is not recommended, but at that point you can ignore it and it should build correctly.
I'm still searching for a way to let Maven automatically download this file, but I did not find a working solution for this yet.
Let me know if you got it working.
-
View User Profile
-
Send Message
Posted Apr 30, 2015It`s my first time working with maven but I get this error:
Can you give me a hint?
-
View User Profile
-
Send Message
Posted Apr 30, 2015@nlthijs48
Sounds good, thx for your continuous work on the project :)
-
View User Profile
-
Send Message
Posted Apr 28, 2015General message:
I have changed the project setup of AreaShop to a Maven project. This allows other people to build AreaShop themself easier, and also got AreaShop back to 1 jar file for all WorldEdit and WorldGuard versions again. The current version on GitHub already dynamically loads classes to support WorldGuard 5/6 and WorldEdit 5/6 depending on which version you have installed on your server. This way you can always take advantage of the highest available version, and downloading AreaShop is simplified because you do not have to worry about which version you have to use anymore.
This is a major step towards the next release of AreaShop, but it will still take some time because I'm very busy with my study at the university. Things left to do:
You can always follow the commit log on GitHub to see the progress.
-
View User Profile
-
Send Message
Posted Apr 26, 2015@LuckOfEvil
I have an adding an API on my TODO list, however I don't know when I will actually be able to add it. You can however already hook into AreaShop and get all data about the registered regions and such (no guarantees that all methods stay the same version-to-version though, but mostly pretty stable). The only thing that is missing are (cancellable) events, which you could solve for your own server by adding commands to the 'eventCommandProfiles' section in the config file.
Are you interested in developing a plugin that extends AreaShop in some way and do you want to release it to the public? Or do you want to make something for your own server to change AreaShop in a way you need for your own server? If it is the latter then you can simply clone AreaShop from GitHub, change whatever you want, and then compile it and use it on your server.
If you have any specific questions about how to do things with AreaShop just send me a message.
I'm currently reworking the plugin to a Maven project, so that I can support WorldGuard 5.9 and 6 and also WorldEdit 5 and 6 with just 1 jar file. I'm almost done with setting this up, so I will commit these changes to Github soon. This was one of the things on my list that I wanted to get done for sure before releasing a next update.
-
View User Profile
-
Send Message
Posted Apr 26, 2015Can you add an developer API to your plugin, please?
-
View User Profile
-
Send Message
Posted Apr 25, 2015@Evergamer2014
V1.2.1 has the issue that all regions that are in another world as 'world', 'world_nether', or 'world_the_end' will be removed from AreaShop after a restart. So I assume you have your regions in a world loaded by for example Multiverse. The problem is that AreaShop loads before Multiverse does, and therefore the world the regions are in are not loaded, and therefore AreaShop deletes the regions.
All versions after that have a fix for this problem, but since you are using 1.7.2 you cannot use those. You can download a fixed version with the link below, this one is not on BukkitDev since I made this one after newer versions were already out.
AreaShop V1.2.2 (Multiverse fix)
If this does not solve your problem then we will have to look further.
-
View User Profile
-
Send Message
Posted Apr 25, 2015-
View User Profile
-
Send Message
Posted Apr 25, 2015@surechoice
In the config.yml file you can change the lines in the 'signTags' section to what you want. Use '/as reload' after you changed it to reload the config.