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 Jan 12, 2015Hello again! I wonder when using schematics it looks like this as a part of default profile:
default: created: save: '%type%-%region%' restore: ''
Is it possible to create a profile, and lets say the schematics is only used in rented Creative world plots? And plots in survivalworld, like rented shops are not using schematics?
Ive tried with %world% tag in front, where the name of the world is added instead of the tag, but that didnt work so well, like it would be something like this: %world%-%type%-%region%
Or maybee make profile for groups? Something like that?
EDIT
Yeah, just had to get the plugin sink in a little bit... Added this to a group in groups.yml
general: schematicProfile: 'creative'
That solved it. Gonna do this with preset prices and everything. Thanks again for an awesome plugin. Hope this is the next generation of plugins where much is left over to the serveradmins. =)
-
View User Profile
-
Send Message
Posted Jan 12, 2015Yes, that pastebin example saved the day. Thanks alot for a great plugin! Must be the most solid shop/rent/buy/pimp plugin ever made! =)
-
View User Profile
-
Send Message
Posted Jan 12, 2015@LaughNgamez
It is indeed as you describe in your first paragraph, if you set the 'sell values' (price of the region you mean i guess) to $1 then players can buy regions for just $1, so then buying it from someone else for more is a bit weird (unless some stuff inside the region is included). So I don't think that is the solution.
But I have some good news for you, I just uploaded V2.1.4 of AreaShop which fixes the problem so that is way better than some workaround. The files here at BukkitDev are still awaiting approval, so you might have to wait for some time stil (or visit Github/Spigot).
Have a good day and good luck with your server :)
@Demonicom79
Do you mean the 'limitGroups' section of the config file? It is mostly documented inside the config file itself (check that here), but because an example might help you more I made one. Check this pastebin for an example that should include every situation you might want, simply use the methods you want to use.
If you have any questions about it just ask.
-
View User Profile
-
Send Message
Posted Jan 12, 2015This is a great plugin. But I wonder how to setup the groups and world section for each group. Cant find an example anywhere. And I cant see this is selfexplained either. Someone can post an example?
-
View User Profile
-
Send Message
Posted Jan 12, 2015@nlthijs48
Thanks for such a response, so what I'm getting from this is that; say a plot has a sell value of $10 and the owner goes to resell for $5, then the buyer goes with $8 it will say he doesn't have enough but he actually will? Then say another buyer comes along with $11 it will say it charges $10 when actually it only charges the resell price of $5?
On my server I only have it so players can resell plots, not sell them right out. In this case it should be fine to set all the sell values to $1 and then that should fix the issue as long as the buyer has more than $1?
If not could you please release a build which fixes this?
Thank you for being so active with this plugin!
-
View User Profile
-
Send Message
Posted Jan 12, 2015@LaughNgamez
I looked in the code to see if I could find something, and I did. The price the owner sets when using the '/as resell' command will be saved correctly and displayed on the sign. But when somebody tries to buy it there goes something wrong, it will check if the buyer has enough money to pay for the 'real' price, and then if he has that the resellprice will be actually paid. So the actual money the buyer pays and the money the receives are correct, but the messages the players get can be confusing. If the resell price is lower than the normal price the buyer will be rejected incorrectly when he has a balance between these two numbers, incorrectly indicating he needs the amount of money for the actual price. If the resell price is higher than the normal price and then buyer has a balance between these two then he will get a rather non-descriptive message indicating something went wrong with paying (should be simply saying that he does not have enough money).
I have fixed these bugs for the upcoming version, so then the messages should all be correct. But because the actual correct amount of money is transferred when buying, it is not really critical to directly release an update (it will be soon though).
EDIT: I also found out that '/as info region' (or left-clicking on the sign) does not display anything about the region that it is in resell mode, I will also change that to display the resellprice.
-
View User Profile
-
Send Message
Posted Jan 11, 2015So I'm having an issue with this plugin, an owner of a region goes to resell it and sets the price, the problem is the region is being sold for the default price, not the price the reseller set. How can this be fixed? Thanks in advance.
-
View User Profile
-
Send Message
Posted Jan 11, 2015@Yoshun91
The '/as find' command indeed always teleports you to the same one (until that one is sold), that is because it will return the first one it finds. Making this random is a good suggestion, I will add that to my TODO list. This is something really small to add, so it will highly likely be in the next version.
@DiamondDan1
You are probably having trouble with the alias '/as' which is normally used for AreaShop, other plugins sometimes have the same one. But the actual main command for AreaShop is '/areashop', so that one should still work. In the rare case that even that one is conflicting you can use ''/areashop:as', that is a way to let the '/as' command execute explicitly for the AreaShop plugin.
So you can simply use '/areashop' to solve your problem, but that is a bit long so you can also define an extra alias for this command. You can do this with the 'commands.yml' file that is located in the root folder of your Bukkit server. You can change the aliases section to the following in that file to add a command:
The above part adds the '/shop' command that redirects to '/areashop', so now you can also use '/shop' to access all AreaShop commands. You will have to restart your server after you changed that file. Hopefully that fixes your problem, just let me know if it worked.
@Locorunner21
Thanks man!
-
View User Profile
-
Send Message
Posted Jan 10, 2015Finally a Region market pluggin that works for 1.8
This works very well! I'm very grateful. Keep up the great work!
-
View User Profile
-
Send Message
Posted Jan 10, 2015Hello, I was wondering If I could create custom commands for this plugin. It is interfering with the plugin AutoPickup and saying what the autopickup plugin says, "Your inventory has been smelted." I can't move forward into the cells on my prison server until I figure out how to create a custom command. I have purchased a thing called premium support on my server hosting company's website which means that they can come in and make a few quick config changes, but I have never created a message on dev.bukkit.org, so I just created an account like 5 minutes ago just to see if someone could help me out on here. Thank you. This is urgent btw. My server is in need of these cells quickly
-
View User Profile
-
Send Message
Posted Jan 10, 2015Hi !
Your mod is really awesome ! I just have a little request : /as find rent always teleport a player on a same free area. It is possible to teleport randomly on a free plot rather than always the same ?
Thanks a lot :D
-
View User Profile
-
Send Message
Posted Jan 9, 2015@PowerofGermany
I answered you in the private message where you have also sent this.
@afaik4711
Okey nice
@jwpwnz
Yes you can turn it off, open the config.yml file, scroll to the 'flagProfiles' section, change all lines starting with 'greeting:' to the following:
After that you need to restart the server or use '/as reload' and then you need to update the region flags with '/as updaterents' and '/as updatebuys'. That should get rid of all greeting messages.
If you have any other questions just leave a comment :)
-
View User Profile
-
Send Message
Posted Jan 9, 2015Is there a way to turn this message off its extremely annoying i looked in the config didn't see anything when ppl go in and out of regions it says This region can be rented for blabla and it spams the screen any way to disable it?
-
View User Profile
-
Send Message
Posted Jan 8, 2015@nlthijs48
Yes, you understood me right and i found my mistake, thank you.
In the config I forgot to set the flagProfile of the value "forsale" to 'owners' while the other values already were set so 'owners'
This is awesome. Thank you thank you :D
-
View User Profile
-
Send Message
Posted Jan 8, 2015@nlthijs48
The default group has this permissions:
- areashop.help - areashop.buy - areashop.sellown - areashop.resell - areashop.stopresell - areashop.me - areashop.find - areashop.addriend - areashop.delfriend - areashop.info
If i add this permissions to the default group I can't do anything. I have do add the op-permission areashop.createbuy to be able to sell regions. But when I add this permission I can sell every region and I can't destroy the signs placed myself.
-
View User Profile
-
Send Message
Posted Jan 8, 2015@KsenMih
Glad you guys appreciate the version for WorldGuard 5.9, I already thought a bunch of people were unable to update to WorldGuard 6 because of other plugins etc.
@afaik4711
Using shift+rightclick or using '/as sell' should both clear the members tag (the sign just executes the exact same command). By default AreaShop never touches the 'owners' flag, but you can add that to the config if you want. Open config.yml, scroll to the 'flagProfiles' section, add this line to each state (forrent, rented, forsale, etc) to remove all owners:
That should fix your problem if I understood you correctly, if you can't get it to work just private message me or open a ticket.
-
View User Profile
-
Send Message
Posted Jan 8, 2015Hey.
Thank you again for making it compatible with WG5.9!
I have a question:
Is there a command to clear a region of members and owners and to sell the region again.
I know there is the shift+rightklick, but this doesn't remove the owners and members. Or maybe i'm to stupid to use it :P
-
View User Profile
-
Send Message
Posted Jan 8, 2015Thank you very much for making AreaShop compatible with WorldGuard 5.9 !
-
View User Profile
-
Send Message
Posted Jan 8, 2015Sure :)
-
View User Profile
-
Send Message
Posted Jan 8, 2015@PowerofGermany
By default players will only have the 'areashop.sellown' permissions, which allows them to sell regions they own. Only if you gave them the 'areashop.sell' or 'areashop.*' permission then they would be able to sell other regions (check the permissions page). So what kind of permissions did you give the players? AreaShop for example has just one permission to allow adding regions to it, which allows them to add all regions they want (quite dangerous, global can be added...). Maybe you can send me the permissions file you have then I can see you try to give them the correct permissions.