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).
Are you sure the signs are working when you have just added them? Does left-clicking them give you information about the region? It seems really weird to me that they get lost after a server restart, AreaShop will only remove signs if an OP breaks them or you use the '/as delsign' command.
Please send me your config files so that I can check if there is something wrong there.
In reply to Forge_User_92925729:
I have 144 propertys which users can rent. They all are inside a region called spawn. I set the priority of spawn to -1, so that the propertys have higher priorities (0). But users that rent the property still cant build on their propertys! What am I doing wrong? I have the newest version of all plugins installed.
In reply to Forge_User_27594088:
In reply to Forge_User_92925729:
Whenever i enter a region i get &G[AreaShop] and its not coloured like it used to be? Does anybody have any idea why?
Which version of WorldGuard are you using? Try updating it to the latest one if you are not sure, because there are a couple older WorldGuard versions that have problems with the colors. Also update WorldEdit, since WorldGuard works best if that is also up-to-date.
In transifex it says the plugin has been 100% trasnlated into Spanish. Will you add Spanish in the next update please? Thank you for the awesome plugin!
Yes each update I will get the latest translations from Transifex. You can however already start using it by simply downloading the file (need to be logged in to Transifex), putting it in the 'lang' folder of AreaShop and setting the 'language' setting in the 'config.yml' file to the name of the file you downloaded. AreaShop should automatically convert the file and start using it after you restart the server or use '/as reload'.
Let me know if you have any questions about it.
Oh great, i didnt know i could download it! Definitely will do! Cant wait to more updates of this awesome plugin!
Is it possible to remove the chat notifications when you go near a region. Is there anyway where in the config to turn it off. It can be a little spammy if you're walking past a row of houses.
https://github.com/NLthijs48/AreaShop/wiki/Frequently-Asked-Questions#how-to-disable-the-greeting-messages-that-areashop-regions-have
Hey, is there a way to change the landlord of a region automatically at the creation of the as region (as "for sale"), but not the same for all regions ?
There are cities on my server and only majors sell regions. I would like the money to go on a special account for the city, so that they don't become rich themselves. But I don't want the money of several cities to be mixed.
If you let players add regions themselves, and they have the 'areashop.createbuy.owner' (or similar) permission they should automatically become the landlord of the region. That would pay the money to the player though and not to a city account.
The easiest way might be to let them add their region to a group named after the city, then set the landlord for that group. It might be cool if AreaShop supported some way of automatically adding regions to a group based on location or other criteria, but that is not a thing yet.
Thank you, the group option might be the solution. But I don't get it, in the wiki it says "When you create a group with the build-in commands a
groups.yml
file will appear, this contains the created groups. Settings specified in a group of thegroups.yml
file will affect all regions that are added to that group."I used "/as groupadd test ..." with success on 2 regions (I can see them in /as groupinfo test") but this file doesn't appear. How do I change a group's setting ?
After adding regions to a group use '/as reload' or shutdown your server, then the file will be saved.
Oh right I was too hasty, sorry
I created the account "Testville" in iConomy.
I tried the configs
test:
name: test
priority: 0
general:
landlordName: 'Testville'
and
test:
name: test
priority: 0
landlordName: 'Testville'
in groups.yml. I added the region in the group "test". But the landlord is nobody and the money is only removed from the account of the buyer. Testville doesn't earn any money. What did I do wrong ?
I found the problem, the landlordName was ignored and AreaShop currently only checks 'landlord'. So you can fill in a UUID there and then it works, the account 'Testville' is not sold though, so it does not have a UUID. You could simply use the one for 'Economy'.
One tip, '/as info region <region>' will tell you the landlord if one is set correctly.
For the next AreaShop version this problem has been fixed.
Thank you :)