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).
@nlthijs48
You are awesome!
@scuroK
I will try to get an update online on this site next week, I'm working on the plugin right now and it is going good. One important thing to test is the conversion from the previous versions and besides that if all the commands and other things work. If you (or someone else) is interested in testing the plugin please contact me by a private message.
When will the new version be ready?
@nlthijs48
Awesome!
@EnderdragonDotDe
Removing all members/owners is currently not possible with the plugin, i'm going to add that for the next update. So currently it only adds/removes the buyer/renter of the region, all other members and owners will stay untouched. I think I will add a configurable list of commands that will be run when a region event happens (creating, deleting, renting, buying, etc.), and with that of course also placeholders to add the region name etc. That would fix your problem and also open some other possibilities for other users of the plugin.
About your addition to the automatic unrenting feature, I think an easier way to do it is just adding a bypass permission, anyone with this permission will not have his region auto-unrented/sold.
EDIT: Running a list of commands when an event happens is added to the plugin and will be released next update. The plugin is releasable in the current state, but I would like to add a couple more things (customizable signs for example) before it will be uploaded to this page.
yes exactly that, remove everyone from the region, members and owners.
And a small addition for this idea: "Automatically selling/unrenting regions when the owner is inactive for a configurable time period " Add the possibility to whitelist owners, which stops the selling/renting.
@EnderdragonDotDe
I don't exactly understand what you are trying to do. Do you want to remove all members/owners from a region? And what do you want to use it for? If I know that I can try to find a solution or add it to the plugin.
Is it possible to use /rg removemmeber PLOTNAME -a in the config? This doesn't work:
flagsForRent: owners: -%player% members: -a
This is a fantastic and unbelievably lite running plugin. Great work! We are now featuring it as our shop plugin on Medieval Lords over the Towny Shop Plot system!
@SDDJ
Okey then my guess of the Essentials mail system was right :) Executing a configurable list commands is a good suggestion, I could also add that for when the other events happen (buying, selling, renting, unrenting, creating and deleting of regions). And for the notifications you then can exactly decide what should happen (send mail, shoot fireworks, teleport the player, etc...). I'm going to work on that!
@ryanthemagi
I was already thinking about how to expand the possibilities for how you can set the land-limits. I'm thinking about implementing permission based limits as you suggested, limits globally (as already in the plugin) and per region group (groups are already implemented for the next update, you can add regions to a group and then they will inherit all settings that are not set on the region itself from the group, and otherwise from the global settings). Good to hear that users of the plugin want this feature, then I know that I need to get this in the plugin fast.
@wonderdude73
1. Player to player selling is on the list of planned features, but it will involve quite a bit of work so it could take some time to implement. The plugin is originally not designed for this purpose so some internals have to change to get it working correctly, but I will certainly work on it because it is an important feature to add.
2. Checking for inactivity of the owner of the region and then autoselling is a good suggestion. I think someone else already suggested it but i forgot to add it to the list, I will do that now. The only thing that could give me trouble with implementing is detecting the last time a player was online, because I'm not sure if I can get that from Bukkit itself, I need to check that when I'm back home.
My holiday was great! I'm flying back to home soon, but it is a long journey so don't expect anything yet the next couple of days (recovering from jetlag and unpacking everything).
TLDR: Questions answered, back in business in 3 days, probably an update a week after that.
Amazing plugin!
I have another 2 suggestions for you.
1. the most important, allow players to sell their property to other players. This would be huge for economy!
and 2. Have an autosell feature. It gets tedious having to do a scout of 4 entire cities all the time to see who left the server and we need to make it manually available again. make a config option to autosell the property after x amount of minutes.
Ps. Hope you have a nice holiday :)
Wonderful plugin! May I suggest a way to create a permission based system for allowing players to buy/rent more than one piece of land? I want to create "deeds" that would allow players to increase the maximum number of plots they can buy, but it appears that cannot be done in the current version.
@nlthijs48
That's great! And yep, I was referring to the Essentials mail system. In my case, that's what I would use, but I suppose an alternative would be to run a configurable command (allowing a few variables like %name% and %timeleft% or things of the sort) to run as part of the alert system, if you think that might work better :)
Can't wait for the next update, thanks!
@nlthijs48
Awesome can't wait!! works superb :)
@SDDJ
Nice that you are using the plugin and that you like it :)
Adding some more warnings for expiring rents is a good suggestion, I'm going to add that to the list of planned features. Currently you already get a notification if you are online when your rent expires, but with the schematics restoring, which has been added to the plugin later, it is already to late to safe your items. So an earlier warning is indeed a nice thing to add.
A warning some (configurable) time before the rent ends is easy to add. With the email you probably mean the Essentials emails? That would mean the plugin needs to require Essentials or dynamically detect it and only send the emails if Essentials is present. That is possible but I doubt that much servers use the email functionality of Essentials at all (at least my server does not). I will still consider adding the emails though.
Subscribe to the file notifications to recieve an email when an update has been released and then check the changelog for this feature.
I have been using this plugin for a few weeks now and it's been working great! Throughout those weeks, there's only one feature I would like to see added. Sometimes, players forget to check up on their shops and extend their rent, which ultimately leads to the shops being removed, often at the expense of sizable quantities of fairly valuable items. What I propose is a way to "warn" the players every so often when their shop(s) are about to expire. This could happen in several ways:
The first: - Send the player a message every X minutes while they are online if their shop is going to expire within a configured time (e.g. one day) (should also be able to be turned off until a rent action, involving that shop region is done, to prevent spam)
The second: - Send a mail to the player who's shop will expire in the configured amount of time.
The third: - Use both of those methods for karate chop action.. er.. effectiveness.
But yeah, this is a great plugin, thanks! :)
@farkros
Cool that you like the plugin, that is nice to hear. Limiting the rent time is on the list of planned features and I will add when I get back home, should be easy to add it.
When I'm back home I plan on releasing an update fast, I will add most things from the list and finish up some other things and then it is ready to go. After that I will start on making the chat more awesome with hover effects and letting it do things when you click certain parts (e.g. opening region info when you click the name of the region).
@nlthijs48
Works great on spigot 1.7.10 Feature request I'd like to be able to set the maximum number of days their allowed to buy or rent, so it gives other players a fare chance at renting/buying the shop or building.
@nlthijs48
I just want to take a minute and thank you, this plugin is awesome and does everything I was looking for in a rentable/buyable/sellable plugin, I searched for hours trying to find a rentable plugin but their all abandoned like none of them exist anymore! I actually had given up,I was on my last search and stumbled apon areashops, I thank you so much!!
@Struggle4Freedom
No, there is no german file created by me, but with the instructions on the Languages page you can create your own one. You can just translate the strings you want and leave the things used for admin commands the same.
Maybe another user of the plugin already translated the plugin and wants to share the file.
@andrivard4
I'm currently on a holiday, but after that it wil be updated soon (when i'm back i stil have 3 weeks until college continues). What is exactly the reason you want it to be updated? Because it should work fine on the latest version of Bukkit, but I understand new features are always nice :)