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).
@jobroDoesMinecraft
actually thats when i try to add the region sorry for that.
Now when i try to make a region it says Caused by: java.lang.ClassNotFoundException: com.sk89q.worldguard.protection.databases.ProtectionDatabaseException
in the console, there is nothing else "red" when i try to add a region to area shop, i also have tried removing worldguard but that doesnt work at all.
(From cosmic magics)
@nlthijs48
Sorry to jump you there. DarkHawx is the head admin on my fan server and we were just talking about how we're going to implement Area Shop. I guess we both had the same idea, reach out to the author :)
In any case, keep up the good work! Very excited to use this plugin.
@Koz4christ
1. I was typing a private message to you about it and already changed the video, I did not think you would see it before I would be able to click Send for the message :) I like the tutorial and appreciate that you made it, thanks!
2. Showing the remaining time is on the list of things I want to add (was already requested in a ticket and I have added it to the 'Planned Features' section of this page now)
@xDARKHAWXx
Point number 2 also answers your question. I realize that it is a thing that a lot of players would like to use so I will try to work on this before I add anything else.
Hi there,
Just wondering if you can add the option to display the remaining rent time of a shop (for example if my rental expired in 14 days, 12 hours and 3 minutes it would display '14d, 12h, 3m' on the fourth line of the sign) instead of displaying when the shop will expire.
@nlthijs48
1.) Thanks for posting my tutorial! 2.) Just realized that the time a rental property expires may not be that helpful with people connecting from other timezones etc. Would it be difficult to have it show the time remaining instead? Or give that option? Or is that option already available and I missed it?
I have managed to fix AreaShop for the dev builds of WorldGuard 6 and WorldEdit 6, until these versions are released as stable I will not release the update to the public. If you really need to use WorldGuard and WorldEdit 6 then you can send me a PM to get the build of AreaShop. It is not advised to use these dev builds of WorldGuard and WorldEdit because they are not completely ready yet and could still introduce some breaking changes.
@nlthijs48
Okay sounds great, I appreciate it.
@cuddyier
I was very busy last weekend so i did not have time to see how much work it will be to support the latest WorldGuard and WorldEdit versions. I think I have some time tomorrow so then i will see what i can do. I try to keep you informed about the status as much as possible and if i have something ready then i will send you a (test) build. Uploading it here is useless since the file approvals are still not being processed (version 2.0.1 is in the que for 16 days now).
@NoHoPeLess
Okey thanks, i will try to join monday afternoon or evening. I can add you on skype or join teamspeak (if you have that) to help a bit easier.
@nlthijs48
Oh... i will add NL,"Netherlands" now you can join ;D
Is there anyway you can update really soon to be compatible with the latest worldedit development builds? I have to use them for IslandWorld but your plugin just breaks with them and as well as worldguard of course as you are already aware.
@NoHoPeLess
If you have signs then the teleportLocationY should not matter for the /as find command (but it still matters for /as tp). So it will teleport you to the sign but a little in a block? Is it a transparent block or a half slab you spawn in?
It would be nice if I could join your server to help trouble-shoot the problem, but I can't connect from The Netherlands it seems.
@nlthijs48
i have:
http://s1.directupload.net/images/140912/bfqw5gyb.png
And on all Regions a fancy sign :D , but i spawn a little in a block? dont know why...?
@scuroK
Currently it is quite unsure about what will happen with the Minecraft community and we don't know if Bukkit keeps going or if another project will take over. AreaShop depends heavily on WorldGuard and WorldEdit so if a platform does not have those plugins then I can't do much. Sponge has sk89q as a project leader and he is also the developer of WorldGuard and WorldEdit, so I'm quite sure these plugins will come to Sponge.
I will for sure try to get AreaShop working on the next platform, whichever one it will be. I already created an account on the Sponge forums and I will try to follow the development of it. It is just a matter of time before we know what will happen, I'm also not sure.
@nlthijs48
Will you try to port the plugin to Sponge if it would become the bukkit replacement? I love areashop. Its in my top 3 plugins i would need to start on a new servermod.
@NoHoPeLess
If you have a sign connected to the region it should teleport you to the sign of the region it found (equal to '/as tp <region> sign'). If you don't have a sign connected it will teleport you normally (equal to '/as tp <region>'). So if you have 'general.teleportLocationY' in the default.yml file set to 'bottom', and your region does not have a sign, the teleport algorithm will start at the bottom of the region and will likely find a safe spot close to the bottom.
Just change this setting to 'middle' to get higher teleport positions, check the Config System page for where that setting should be and for more information.
i will with /as find ... spawn in the bootom... dont know how can i fix that? any help? :D
@nlthijs48
Thank you for this! You are great!
There is quite some trouble around Bukkit, Craftbukkit and BukkitDev, a lot of the staff has left and that is why some Curse employees are moderating the forums. I however don't want to break the rules and post a link to the latest version (V2.0.1, uploaded almost 10 days ago and still not approved).
If you want to download this version anyway you can send me a private message and I will give you a link. This way people that want to test this new build can do so and I won't have to break the rules.
As a precaution it is best to save the link to the Github page of this plugin, because I can always answer questions, give support and release new versions there.
WOW ! Bukkit has gone -.- .... can you pls send me the file? his stuff will never release any... its horrible