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).
@scuroK
You are right that the 'as info' command is to long for players to use, it was originally intended to provide all status information to admins but later I also made it available by default to normal players.
I was already thinking about a shorter command to use for checking your own regions. I was thinking about a command that lists all your regions in the chat, and then you can hover over the name of a region to get information (remaining rent time etc.) and if you click the name of the region you teleport to it. Example of hover:![Example of hover in minecraft chat](http://dev.bukkit.org/media/images/75/825/Hover_text.png)
I have already started to make the language system ready for hover and command text, that is something i want to include into the next version for sure.
Then about your problem with the owners/members, i have silently added a feature for this into 2.0 (forgot to put it in the changelog). You can simply set the 'members' and 'owners' settings inside the 'forrent' and 'forsale' sections to the value 'clear' to get rid of all owners and members. You have to use the '/as updatebuys' and '/as updaterents' commands after you have set those and restarted the server to get rid of the members and owners that got left behind earlier.
Found another problem. I can noot allow players to use worldguard for adding friends to their plots. because when i do /as del <region> the friend will remain member/owner of the region. only the one who bouht it gets cleared.
works great now!
For now there is only 1 thing i would change. The /as info player <> command is to long. when i remember how stupid some players are. they will forget to /sethome so they will cry and ask how to find the plot again... :D
Maybe it would be awesome to have it like this:
/as home = shows you a list of all your rented AND bought plots. (they dont care) Than they just have to add the region name to the command and it brings them to it.
This would be very nice and easy and time saving for admins, mods etc! But overall your plugin will be the best of its kind! for shore! THANK YOU!
@nlthijs48
i didnt run 2.0 before. but i was looking for the TeleportIntoRegion line inside the config. i just found it in the default.yml xD
@scuroK
You have to add the option yourself if you have ran 2.0.0 before 2.0.1. If I would add the new section in automatically after upgrading then all comments would disappear, so then all documentation would be gone.
Check the Config System page to copy the options from there (the last two options in the 'general' section).
Sorry for this inconvenience, I'm still searching for a method that does not delete the comments when saving the configuration. To prepare for it I already added the version thing to the config.
@nlthijs48
?? Where is this teleportintoregion option?? i dont see it. and also the config says its 2.0.0 but its actually the 2.0.1 version of the plugin. is there something messed up in terms of the confog file?
EDIT: OH I was just looking in the main config. but the teleportintoregion option is in the file called default.yml sorry.
@vinzenco
I don't understand what you did and why it worked, but I'm happy for you :D
@scuroK
If you set 'teleportIntoRegion' to false as I added to my previous message then my plugin does exactly that when using '/as find', and if you use '/as tp <region> sign' then it will teleport you to the sign of that region instead of somewhere inside the region.
@nlthijs48
hmm simpleregionmarket does it simple. it brings you just to the buy sign and thats ok. well if i place the sign inside the region will players be able to destroy the sign?
@scuroK
@vinzenco
Ah, I know what causes that. The default configuration has teleportation to outside of a region disabled, but '/as find' will try to teleport you to the sign of the region. So if you have your sign outside your region then it can't find a spot because it starts outside of the region. That is indeed a problem and is annoying. When teleporting to the sign I could disable the part that checks if it is still inside the region and then it would work. Or I could just disable the 'inside region check' if the starting position is already outside of it, then setting the teleport position outside of the region also does not cause problems anymore.
Removing the complete 'safe teleport' thing is not really an option, because otherwise I would need to require first setting a teleportation spot before you could use the tp command (and if then something in the region changes after setting it players will be teleported into blocks and die).
Let me know what your think.
EDIT: You can by the way just set the 'teleportIntoRegion' option in the 'general' section of default.yml to 'false' to fix it for now (but when teleporting to regions the players could get teleported next to the region).
@nlthijs48
In 2-0.1 the as find function does not realy work. always tells me it can not find a save spot. mayb you are getting a bit to complicated. just set the tp location for as find to where the sign is, or where the tp was set. the rest ist to complicated and does not work
@scuroK
If you compare the download-links of the last 3 versions maybe you find out an system of naming and be able to download version 2.0.1 even if it's not aproved ;)
@nlthijs48
As i said before. Release it on spigot forums.
@scuroK
Yeah, approval times are not so great lately.
@vinzenco
I have indeed fixed that problem in version 2.0.1 by adding some options, check the following comment of me about this fix: http:dev.bukkit.org/bukkit-plugins/regionbuyandrent/?comment=168
@nlthijs48
It seems i found a little bug :D I put - 'as tp %region%' to the rightClickPlayer. I bought the area with a sign but it teleports me always to the neighbor region or in a cave. I test it with "bottom, top, middle" but all these teleports me in a different place.
/Edit I test it with v2.0.0 I see you uploaded the 2.0.1 Version. I will test it with this Version. Maybe it is fixed :)
still waiting for approval?
@nlthijs48
Yeah not to much stuff and user friendlyness sounds great
@vinzenco
Thanks for testing stuff, always appreciated.
@vinzenco
Glad you like it, an auction function is not on the list at the moment and I don't know if much people would use that. So I'm not sure if I will add that, I certainly want to improve user-friendlyness first by using the hover and click things in chat.
@nlthijs48
Thank you very much! This is a awsome plugin and the best alternative to simpleregionmamarket! :) Have you planed a auction function ? to bet for a shop or a area ? Thanks a lot :)
@nlthijs48
I will wait and repeat send you problems with newer versions in future. Maybe sometimes you can fix it so it works with both versions :)
@Androkai
I did not test the pugin with that dev-version yet. I fear that if i switch to the dev version of WorldGuard that I cannot support the current version anymore and that would be bad (I dont't want to force all AreaShop users to an unstable version of WorldGuard). If that WorldGuard version is released as stable then I could switch to it. If I can somehow support both versions then that would be great.
About the 1.8 update, if the Bukkit API does not change significantly then even the oldest version of AreaShop still works. And normally they try to keep the API exactly the same so it should be no problem (AreaShop does not use packets, NMS or other weird stuff so it should be fine). If however it breaks I will try to update it as fast as I can. Since version 1.3 I use UUID's to identify players so that is already taken care of. The vanilla version of 1.8 is almost out, but then it will take Bukkit probably more then a month to get a version out.
@vinzenco
With version 2.x of AreaShop you can do exactly what you want (version 2.0 file is awaiting approval from Bukkit). In the config you can change what should happen when a player clicks a sign, just change that to the teleport command (add 'as tp %region%' to for example 'leftClickPlayer'). If you want players to be able to teleport to all regions instead of only their bought/rented regions give them the permission 'areashop.teleportall'.
Hopefully version 2.0 will be approved soon :)
PS: All documentation has already been updated for version 2.0, links to the documentation for version 1.x can be found at the new pages.