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 Jul 31, 2015Hello,
Thank you for sending me to the same page. I've looked it over 100's of times followed it to a tee. Because I cant communicate the problem to you clearly i made a small video to show You the Problem I'm Having. I mane a new world with just your plugin and the other Required plugins. Then i show you all the Config Files too.. Please look it over and tell me what is wrong?
Reminder: the Issue is I'm making a prison and I only want people from each Rank to only be allowed to rent from their rank...
https://www.youtube.com/watch?v=jMEYvMBnMPM
-
View User Profile
-
Send Message
Posted Jul 31, 2015It has taken its time (more as 5 months), but finally the moment is there: AreaShop v2.2.0 is released. I know a lot of people have been waiting for a couple of features in this release (landlords for example), and I have been giving out more dev-builds out as ever before. Check the changelog here.
Because nothing is ever 100% bug-free and feature complete you can make tickets to indicate both of these situations to me, click here. All tickets have been moved to GitHub, where I find they are more easy to manage and organize and all my TODO list entries have been made into tickets.
-
View User Profile
-
Send Message
Posted Jul 31, 2015@felixlechat62
The schematic restore functionality of AreaShop might already work for that, not entirely sure how Quickshop saves its data and handles missing chests and signs though. Please let me know if that works.
Because I expect that an actual integration is necessary I made a feature request ticket. To confirm, is this plugin the one you are using? (there is another which looks outdated).
-
View User Profile
-
Send Message
Posted Jul 31, 2015hi, you can add compatibility with "quickshop" plugin for destroy all shop in region at end time rent ??
-
View User Profile
-
Send Message
Posted Jul 30, 2015@EnderdragonDotDe
That might indeed do the trick, will think about that when implementing something to prevent the inactive time kicking in.
@jobronies
You can use the 'eventCommandProfiles' section to do this. In the 'after' node of 'rented' you could place a command to teleport the player to the cell ('sudo %player% as tp %region%'), and then a command to set their home ('sudo %player% sethome home'). The 'sudo' part is a command from Essentials, this is required because the commands are ran from console.
Instead of setting their home you might also simply promote the '/as tp <region>' command, by default players will already be able to use this for their regions (and any friends they add can also teleport to the region). This can be changed by permissions.
@ArmyStich
First of all it is good to read the information on this page, and checkout the example.
One thing to note is that region group names have nothing at all to do with limit group names. The way you link them is by specifying the region groups in a 'groups:' section inside the limit group (see the example page).
A second thing is that you will need an blocking limit group for each rank you want. This group has the same selectors as the normal one (worlds and groups thing), but has limits of 0 as total, rents and buys. You can assign these blocking groups to everyone by applying them to the 'default rank', and then give the appropriate rank the non-blocking groups.
If you need help with a specific setup then let me know. I will try to add a typical prison-like setup example to the examples page soon.
@XXLuigiMario
Make sure that when using '/as info region <region>' or left-clicking the sign it indicates that the region will restore at unrent/sell. That is the way to check if a region is correctly setup for saving/restoring. Make sure you have restoring enabled in the config.yml file AND default.yml file. Yes this is confusing, the config.yml settings is already removed for the next release.
Making a schematic with McEdit or WorldEdit should not be required, AreaShop should correctly save it when renting a region with your config.yml setup. If you still have trouble after checking the above tips then please let me know.
@funkay91
I'm actually trying to work towards a release, already moved all tickets to Github and organised the work that is left. I'm planning on resolving the tickets marked with the 'v2.2.0' milestone, and then releasing it (only 1 ticket left). All feature request made by people, or ideas by myself are also on the Github issues page now.
The last week I already did some coding to implement last things and fix things, as you can see in the commit history. I have even written most of the changelog already, so it should get close now, still cannot give you an exact date though since I'm busy with my new job.
-
View User Profile
-
Send Message
Posted Jul 29, 2015Hello nlthijs48
Do you have news for the new version of Aera Shop ? I hope you still wan't to devellop the new version. I hop you have time to. Also i would like to say another time : Thanks a lot for this plug-in.
-
View User Profile
-
Send Message
Posted Jul 29, 2015@Ironic8b49
No, I made the regions with no blocks in them :/
-
View User Profile
-
Send Message
Posted Jul 29, 2015@XXLuigiMario
when you add the region, the region must be empty or the blocks you want in it. Could this be your problem?
-
View User Profile
-
Send Message
Posted Jul 28, 2015Hello,
I've got a bunch of regions set up, and I made it so it saves a schematic when they are rented and load when they get unrented, but for some reason they don't save... So I went to McEdit and made an empty of schematic of the size of the region and placed it with the correct name in the schematics folder, but after placing some blocks and unrenting it it wouldn't remove them.
This is my config: http://pastebin.com/4f0a13ZK
By the way, I do have "enableSchematics: true".
Any idea why it isn't working?
Thanks for sharing.
-
View User Profile
-
Send Message
Posted Jul 26, 2015Hello again,
So i have groups setup and i gave each rank a different group in my permissions file IE: areashop.limits.a areashop.limits.b ECT... so when people try to rent something it says they r in default still even though they hold a rank that that that permission node. Ive been over every CONFIG file and have no idea what i did wrong.
this is in my permissions file:
A:
options:
suffix: ' &f[&4A&f] '
permissions:
- areashop.limits.a
inheritance:
- default
this is in the group file:
a:
name: a
priority: 100
regions:
- A409
- A405
- A406
- A407
this is in the config file:
limitGroups:
default:
total: 1
rents: 1
buys: 0
a:
total: 1
rents: 1
buys: 0
worlds:
- world
PS:
what I'm trying to achieve is people with the rank of A can rent A CELLS and people with the rank of B can rent B cells but no go in A and rent a cell. Also is it possible to auto unrent a cell if they rank up to a new rank like from A to B where their cell in A gets unrented because they ranked up?
-
View User Profile
-
Send Message
Posted Jul 25, 2015Is there a way to have essentials homes set at peoples "Areashop" or prison cell when they rent one, and delete it when they rankup or if the time expires or rents a new cell?
-
View User Profile
-
Send Message
Posted Jul 25, 2015@nlthijs48
You could also add the command "/as region nosell PLOT" This would stop the autosell if admins want to save a plot.
And thanks for your work!
-
View User Profile
-
Send Message
Posted Jul 24, 2015@EnderdragonDotDe
That would only solve the problem partially, because often you would want to cancel the inactive timer when someone is already offline, and possibly close to the set limit. So then this method would fail. You solution would however fix things like no timeout for VIPs. So I might consider still implementing this feature.
@IlPoeta05
The thing with chest access is incorrect in the video, check this FAQ entry for the correct flags. I have asked the video author for an annotation to fix this, but I think he forgot about it.
What you are trying to get done with the rental times is not currently possible (without doing weird stuff with eventcommandprofiles), and I think there is a better way to solve it. You could simply set the rental time to less than 3 days (1 day for example), then set 'maxRentTime' to 3 days, and keep maxExtends at -1. This would make sure that the player would never be able to have the region rented longer as 3 days, and that when the region is at 2 days or less that he could extend it by 1 extra day. So that should be the solution for your situation (make sure you understand maxExtends and maxRentTime, those are different things and you might be understanding the first one incorrectly).
@chikken001
The plan is to work toward this functionality, but I can already say you that it might take a while. This is because these kind of things are complicated, and you as a server owner should be able to limit this in a lot of ways (max created regions, places they can be created, max size, etc). For the upcoming version I already implemented the first steps for this kind of functionality, namely that you can assign a landlord to a region. This landlord will get all profit, and can set the price, duration, teleport location, etc.
-
View User Profile
-
Send Message
Posted Jul 23, 2015Hi, nice work with this plugin.
I would like to know if you could implement a new feature who add the ability to a player to create there own region by paying a price according to the size of the region. With some options like overlap other region or not, etc.
In the same time i would like to let owner sell or buy there region. Actualy only op can add rent/buy, change duration of rent or price, etc. So I would have a permission like "areashop.createrent.own".
With that, this plugin would be perfect for me.
-
View User Profile
-
Send Message
Posted Jul 23, 2015I have a problem with this plugin...
I would like to create some prison cells for my prison server. Signs for rent work really good and i have no problems with signs. I have follow the first video tutorial that u posted and the author of the video put in the rent ed regions the flags: Chest-Access: Deny Use: Deny Priority: 1
I have also make this but when someone rent a cell he can't open chests inside and if i put chest-access: allow, all users can open the chests...
I have the principal region: global The region that contains all the cells: Cells And the region for the rent cells: Cell1, Cell2, Cell3 etc..
My question is: which flags, priority and what flags do i put on the config and info the regions to allow users to don't open the chests of other players and open them chests only if they rent the region?
Another question is on the maxEstends... My rented cells during 3 days so i would, if for example the rent expire in 1 day, that if the player extend the rent it will go to a max of 3 days, not more than 3 days. How can i do, considering that if i put -1 to maxEstends players could extend the rent for how many times they want, and if i put 0 they can't extend the rent..?
-
View User Profile
-
Send Message
Posted Jul 20, 2015If somebody buys a region the plugin sets a value(donotsell) to true in the yml of the region, if the player has the "dontreset" permission. For example:
PLOT.yml:
-
View User Profile
-
Send Message
Posted Jul 20, 2015@EnderdragonDotDe
I don't exactly get your suggestion, do you want to be able to set a permission for a region and then only when a player has that specific permission they can buy/rent the region? I specifically don't get what you mean with the 'save it in the <regionl>.yml file'-part.
-
View User Profile
-
Send Message
Posted Jul 20, 2015@nlthijs48
Idea: If somebody buys a region check for permission. If there is a permission save it in the <region>.yml file(or add a value).
-
View User Profile
-
Send Message
Posted Jul 20, 2015@TNTUP
I don't know about any bugs with '/as addfriend', it is hard to say anything useful about it when I have this little information. If you have a clear case where a friend got removed then let me know.
Your config looks fine, nothing out of the ordinary.
@HypnoticParadox
Setting up a region to use with AreaShop is explained on this page, remember that AreaShop is for selling/renting regions and has nothing to do with items. If you want players to be able to use the regions as item shops, then you need to use something like the trade signs of Essentials or the ChestShop plugin.
@c0wg0d
To get the username of the renting/buying player you can use %player% (all variables described here can be used), a variable for date/time is not there yet indeed. I added that to my TODO list. If you have rental regions then you could use the %until% or %untilshort% tags for now, those give the date that the rent runs out (long or short version), which are save to consider unique.
@PowerHustlers
The limit system is explained in more detail on this page. If you have any questions after seeing the example on that page then just send me a message.
@JackCross14
Please send me the log file of your server (the 'latest.log' file inside the logs folder), that should indicate what is going wrong (probably one of the dependencies is incorrect).
@EnderdragonDotDe
I initially wanted to add a bypass permissions, but that does not work since I cannot get permissions from an offline player.
As you know you can set the mentioned setting in default.yml, this also means you can use this setting in groups and individual regions. If you make a group which has this setting set to -1, then you can simply assign this group to any regions that you want to turn off this inactiveSell feature. Let me know if you need help setting this up. So a blacklist would not add much to the existing system.
-
View User Profile
-
Send Message
Posted Jul 18, 2015Could you please add a region blacklist for "inactiveTimeUntilSell" ?