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 Nov 25, 2014@nlthijs48
Thanks, that is what I was looking for. I have been playing with the tellraw.
Also, pushing to the repo is good for consistency and redundancy, especially if you lose your local drive. I got in the habit of pushing every time I finished making a reasonable change to my projects.
-
View User Profile
-
Send Message
Posted Nov 24, 2014I think I made quite an interesting commit to the repository of AreaShop, the reselling feature has been added! So that is out of the way and now the release is getting closer. Something I recently changed: I'm committing and pushing to the repository every time now, instead of only at updates I release here.
I'm also trying to get some more translators so that AreaShop can have more fully updated languages included into it. Do you want to help? Go to this page and read the section below the 'Option #2' header. 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 Nov 24, 2014@tk11
To introduce an extra step for selling/unrenting a region you could change the command that will get executed when you click the sign. If you change it to just a tell message to the user "Use '/as unrent %region%' to confirm that you want to unrent this region" Then the user cannot accidentally unrent the region anymore. You could improve this by sending a message with the '/tellraw' command that contains a word you can click to unrent the region. So then the flow becomes like this:
Complete tellraw command following the example above: /tellraw %player% {"text":"","extra":[{"text":"Click "},{"text":"here","bold":"true","clickEvent":{"action":"run_command","value":"/areashop unrent %region%"},"hoverEvent":{"action":"show_text","value":{"text":"","extra":[{"text":"Click to unrent %region%","color":"white"}]}}},{"text":" to confirm that you want to stop renting %region%"}]}
One flaw with this example is that the current renter of the region will always receive the tellraw message, and not the player that actually clicked the sign (there is no variable for that currently).
Hopefully that helps you to get something you want, if you need any more help with it just send me a message.
@Ironic8b49
After you changed the timeformat settings in the config you need to update all signs to let them show the new format. This happens when the state of the region changes (somebody rents it for example) or when you use the '/as updaterents' command. So if you use that command then all signs will be updated and should show the new timeformat.
-
View User Profile
-
Send Message
Posted Nov 23, 2014I have been trying to change the format of the time and it will not change after I replace timeformatsign to 'MM-dd KK:mm a' and timeformatchat to 'MMMMMMMMMMMMMMMMM dd yyyy KK:mm a' any help woould be nice
-
View User Profile
-
Send Message
Posted Nov 23, 2014Is there a way to prompt the player to confirm the sale or unrenting of a region? My plots reset, and I will probably save the schematic as it sells or unrents just in case it is an accident, but it would be nice to warn them on the way out to make sure they really want to do so.
Thanks
-
View User Profile
-
Send Message
Posted Nov 23, 2014@Onewingseraphim
I indeed tagged the wrong guy, fixed it now :)
-
View User Profile
-
Send Message
Posted Nov 23, 2014@nlthijs48
Might want to check your comment I think your first one was a reply to "luckybowers" not me haha. xD
-
View User Profile
-
Send Message
Posted Nov 23, 2014@luckybowers
By default it should be exactly like that, normally regions do only allow players that are member or owner of the region to build there. And AreaShop normally adds the player that bought/rented the region to the members list. First you should check with '/region info <name>' on the shop region to see if the 'build' flag has been set (it should not be). As second you want to check if you have any other regions at the same spot as the shop region (rightclick with leather on a block in the shop). If you for example have a big region around all shops then you need to make sure the shops have a higher priority then the big region (use '/region setpriority <region> <number>' or add a 'priority: 1' line to the 'forrent', 'rented', 'forsale' and 'sold' sections of the 'flagProfiles' section in the config of AreaShop, then it will automatically set the priority to 1 when somebody rents/buys a region. or you could use '/as updaterents' and '/as updatebuys' to update the regions).
Let me know if you solved the problem, otherwise you could maybe send the ip of your server to me in a PM and then I could help you that way.
@Onewingseraphim
:D
-
View User Profile
-
Send Message
Posted Nov 23, 2014@nlthijs48
Thank you very much! And quick response time! :D
-
View User Profile
-
Send Message
Posted Nov 22, 2014@nlthijs48
now how do i make it so only owners of the shop can build in the shops, and not everyone else? is it something to do with flags?
Please Someone HELP, i really want to open my server
-
View User Profile
-
Send Message
Posted Nov 22, 2014@luckybowers
Are you sure you added those WorldGuard regions to AreaShop? Did you follow the instructions on the 'Setting up regions & signs' page? If you execute the command '/as info all', does it list any regions?
-
View User Profile
-
Send Message
Posted Nov 22, 2014The region your specified does not exist
I have defined regions for each of my shops, however when i try to create the sign to enable people to rent, it always says "The region your specified does not exist. Please someone help as player shops are something that i really want on my server when I open
-
View User Profile
-
Send Message
Posted Nov 22, 2014@Onewingseraphim
Yes, you can make use of the 'eventCommandProfiles' section of the config. Here you can add a command to the 'before' section inside the 'unrented' section. You could use a command like 'tp %player% 0 128 0' to teleport the previous owner of the region to spawn (change to coordinates to your actual spawn). Or if you don't have a delay on the '/spawn' command then you could use the line 'spawn %player%' to teleport them to spawn (the /spawn command is from Essentials).
If you have any other questions just leave a message.
-
View User Profile
-
Send Message
Posted Nov 22, 2014Is there a way to force a player out of a region once they un-rent or rent is up?
-
View User Profile
-
Send Message
Posted Nov 18, 2014Thank you nlthijs48! I haven't been active lately, and saw you had found the fix to my problem! I'll go update WorldGuard right away! Thanks once again- Dark.
-
View User Profile
-
Send Message
Posted Nov 14, 2014@Ironic8b49
The changelog that comes with v2.0.2 describes the changes in comparison to v2.0.1, the only important thing is the switch to WorldGuard 6. So for now you can just stick with v2.0.1 if you want, but for future update you will need WorldGuard 6 anyway so if you want to keep it up-to-date then you need to update it sometime.
-
View User Profile
-
Send Message
Posted Nov 14, 2014@nlthijs48
Thanks for the quick response. I download v2.0.2 and noticed I need WorldGuard 6.0 which I am only running WorldGuard 5.9. I took the chance and updated to WorldGuard 6.0 Beta 2 the warnings about possible crash and losing WorldGurad data and map make one not want to try it. Well the update went smooth with no issus so now I play on setting up AreaShop v2.0.2
-
View User Profile
-
Send Message
Posted Nov 14, 2014@Ironic8b49
Yes you can let players place Essentials sign within the shop, that is exactly how I use the plugin myself. Be sure you enable saving/restoring from schematics, because otherwise these signs will stay after the rent of the region runs out (or got sold) and then the next owner will not be able to destroy the signs because they belong to another player (Essentials will only let the player that made the sign remove it). Check the Schematics page to see which config values you have to change to enable the restore functionality.
If you have any other questions just leave another comment.
-
View User Profile
-
Send Message
Posted Nov 14, 2014I'm thinking of installing this plugin on my server, just got one question, can the trade sign from essentials be placed within a shop?
-
View User Profile
-
Send Message
Posted Nov 13, 2014@Hangjai
The plugin will automatically read the 'rents' file and convert it to the new format, nothing special you have to do with that. You should however make a backup of your worlds before updating. The changelog of v2.0.1 specifies this information, and also lists the changes.
Basically the old 'rents', 'buys' a config.yml will be moved to the #old folder as backup and then new config.yml and default.yml files will appear plus a 'regions' folder that contains one file per registered region. After you upgraded be sure to check the config.yml and default.yml files and set the options as you like.
If you have any trouble with upgrading just ask.