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).
Is this plugin ever going to be updated??
Hey,
Is there also a German file?
mfg Struggle
@ThePuppySlayer
You probably have an overlapping region that has building turned off or has a higher priority. You can manually check if this is the problem by setting the priority of the rentregion to something higher. If then the renter can build without a problem, you can simply add the line 'priority: 1' (or possibly a higher nunber) to the sections 'flagsForRent' and 'flagsRented' in the config of AreaShop (same indentation as 'greeting' and 'members' line).
Then the plugin applys this priority everytime someone rents/unrents the region so then it is fixed for all rent regions and then you don't have to manually set the priority for all rent regions.
Hopefully this fixes your problem. I'm on a holiday until 9 august, so I can't speak to you on Skype for now, but after that I can add you on Skype (if you send me your skype username in a PM now then I will try to contact you right after my holiday)
Greetings, NLThijs48
Hello whenever i create a region a player rents it. But they cannot build in it what do i do? Also if i could get contact with the lead dev on skype?
Sorry, had to do some other things today. Wish you nice holidays, see you later :)
@Androkai
Strange that it does not give a message when you break a sign, the only way it could do that would be if there is an error I think... Today I could join your server to help you, tomorrow I will be on a holiday.
@Guble
Okeey, to donate you can use the Donate button at the top of this page.
@nlthijs48
Thanks for the prompt response. I'm glad to hear the feature is planned. Also, thanks for pointing out the flags in the config.yml. I must've been half asleep at the time, as I didn't realize I could scroll to see more options lol.
I look forward to your updates, as they'll help a lot with the server I'll be opening in the fall. Do you have a page that takes donations? I'd love to support your work :)
@nlthijs48
No message and the region still exist so if I put another sign at the same position and cast /as updatebuys the text is back.
Edit: I will create a little video then testing all this tomorrow. I will send you a link to this
@Androkai
Okey, you do not recieve a message in the chat from the plugin that the buy/rent has been removed?
@nlthijs48
With "deregister" I mean the sign which the plugin don't forget if I put them of (survivalmode with my own hands) after buying the region.
Good to know about greetings, I will test tomorrow, thx
@Androkai
Ah okey, but I don't think it is smart to already use version 6 of WorldEdit, a week ago the developer said on Twitter he was 70% done. So using version 5.6.3 is better for now.
With 'it don't deregister' you mean the greeting of the region does not go away? Because that will be fixed for the next version (Check comment of ZimBeller and my reaction). If you don't want greetings at all then just change the line with greeting in it to: greeting: '' in the sections 'flagsForRent', 'flagsRented', 'flagsForSale' and 'flagsSold' from the config.yml, then it resets the greeting to nothing all the time and it won't show up.
Hopefully this fixes your problem, greetings, NLThijs48
@nlthijs48
I call version 6.0.0 of WorldEdit and 5.9.1 of WorldGuard "latest" version ;) Maybe it miss some old api-functionalities at the moment. If I have time tomorrow I will test this with stable build. I also use Craftbukkit 1.7.10 and AreaShop 1.3.0.
@Edit1: If I bought the region and then remove the sign it don't deregister. I'm sorry, I mean "/as updatebuys", my fault :) My signs are always outside the region because of player don't be able to remove.
@Edit2: No errors in log. I tested a little bit and found out: It's because of "greeting"-flag which will added to region if player bought it. Is it possible to deactivate this?
Thx for answer :)
@Androkai
What do you call the 'latest' version of WorldEdit? I just tested the restoring with WorldEdit 5.6.3, Bukkit 1.7.9 and AreaShop 1.3.0, and for me it works. Are you sure you have these same versions?
If you remove a buy sign normally (directly breaking it with your hands, not worldediting it away) then AreaShop removes the buy/rent completely, so it deregisters it from the system. If you break the sign in another way then the rent/buy will be deleted next reload/restart unless you place the sign at the right spot again.
For you first Edit: I think you mean you used '/as updatebuys'? Because '/as buyrestore' is just for setting if the region should restore or not and which profile it should use. If it says that not all signs have been updated then one or multiple signs are missing, so it could not update those. The plugin never restores a sign if it is outside the region, only when it is inside the region and schematic restoring is enabled it replaces it.
For your second Edit: I think when you bought the region the restoring triggered and threw an error in the console. Because of the error AreaShop never reaches the code that sends the message to the player so you don't get any feedback.
Please double-check your WorldEdit and WorldGuard versions and hopefully all the problems are fixed when you do that.
I'm using latest dev-build from WorldEdit and get this error: http://pastebin.com/pk4MrnMq
"com.sk89q.worldedit.LocalSession.setClipboard(Lcom/sk89q/worldedit/CuboidClipboard;)"
Maybe the "L" in front of "com/sk89q/worldedit/..." ?
Edit:
another little problem: If I accidentally remove a buy-sign and use /as buyrestore the plugin isn't able to restore the sign and shows me the message "Not all signs have been updated, maybe reload fixes it" I need to bring on a new sign but this could be ugly if I don't know where it was ;)
Edit2:
If I bought a region no message appears but every time I entered it the message that I bought it was sent to me.
@Karim_NexusNode
Thanks! I certainly come and check out your server, see you soon.
@Guble
Nice that you like it :) The problem you have with reselling and the transfer of the money will be worked on soon, it is already on the list of 'Planned Features', this point on the list also includes reselling for buy regions:
A way to let players create signs themselves for regions they own, for example let a player build a hotel and rent rooms to other players. This way money will not get lost, but will be transferred to the owner of a region.
Setting the buyer/renter of the region as owner of the WorldGuard region instead of as member is already possible, you can change that in the config. In the sections 'flagsForRent', 'flagsRented', 'flagsForSale' and 'flagsSold', change the lines with 'members:' to 'owners:' and keep the part that is behind it the same. Hopefully that helps you a bit towards the solution, but in 2 days I go on a 3 week trip so it will take some time before I can add the feature to the plugin. After I'm back from my trip I will be at home for another 3 weeks before college starts again so then I can work on the plugin some more.
Love the plugin, great job guys. It's the perfect plugin for renting out regions. That being said, it falls short of my needs for land selling. If I'm not mistaken, players can buy a region (with the option to sell it back to the original owner at a configurable loss), but they cannot resell the land to a different owner.
What I'm looking for is the ability for a player to buy the property (and be set as owner, rather than member), with the ability to remove the sign after the sale. Then, a few weeks or months down the road, they can opt to resell their land by setting up their own sign. Is this a feature that you would ever consider adding? I know SimplyRegionMarket has this functionality, but I really love the way you've handled renting and would much prefer sticking with this plugin.
Let me just say, Well done! I love this plugin and it runs my servers economy! I'd you to come see what use we have made for it here: 192.99.37.222:25698 Thank You. Econicraft 2.0 Team.
@EnderdragonDotDe
Something like that will be added, but what I think is even better is using the Fanciful Lib. Then the command could just display all your regions and if you click one of them you teleport to it. Check this example of using hover text + a command, this is from a private plugin of me where when you click your name in the chat it will display your stats (kills, deaths, etc.): You can check this out further on my server minecraft.go-craft.com, in the Kit-PVP server we use these kind of things.
The only problem with using such a library is that it will break the plugin quicker when minecraft updates, so I have to create some kind of fallback to make it more reliable. But it would be cool if I could use this throughout the plugin.
Let me think about it some more and then we hopefully get a good solution.
Could you add a command like "/as tpc" which teleports you to your plots and if you have more than one rotates through every plot everytime you use the command?
@nlthijs48
I will send you donations from time to time because my players also started to donate to my server