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).
still hoping for a teleport function.
@ShadowKillerHDx
Which version of AreaShop are you using and which version of Bukkit? If you use AreaShop V1.3+ you need to use Bukkit 1.7.9+, otherwise the plugin won't start correctly. If it says 'internal server error' there should be an error in the logs of the server, could you send me this error + your startup log of your server? You can do that in a PM.
Okay I have the plugin installed on my server and I setup the sign and the area correctly. However, whenever someone clicks the sign nothing happens. And when you type in the command it disconnects you and says "Internal Server Error". Any solution for this? Everything was setup correctly.
@RIPtli08
A max rent time is already on the list of planned features and will be added. Setting the teleport location outside of the region is a good suggestion, I probably add a config option or permission to let players do that.
A command to list your current regions is already present, use /as info player <name>, I agree with you that if you want to see a list of your own regions that this command is way too long. So I also add your suggestion of /as list on the planned features list. I think it would also be nice to directly show the time left on a rent region if you use that command.
I was actually just working on the plugin so maybe I can add it directly (testing and releasing takes time so don't expect an update tomorrow or something)
@nlthijs48
could you add "max rent time" and /as settp (outside the rented region)?
and like /as list (wich shows you the regions you have rented)? pleaseee :3
@cindy_k
Good that your problem is solved, and that this plugin is useful for you. :)
General announcement: I probably don't have much time for working on the next update the upcoming 3 weeks, but after that I have vacation so then an update should be out fast (working on the list of planned features).
@nlthijs48 I had saved my own schematics, I didn't realize about the different folder, so they were still in the worldedit folder. I copied all my schematics to your schem folder and its working now. Thank you for your help. I am very excited about this plugin. I almost wrote something similar. This is going to save me a lot of time.
Thanks!
@cindy_k
Are you sure you followed the instructions on the Schematics page? With your current config it should create a schematic in the folder '/AreaShop/schem/' with filename 'rent-<region>' if you place a sign. Did you place a sign and check the folder if the schematic was created? Also did you change something in the region before you unrented the region? Otherwise you don't see any changes.
Hi! I can't get the shop reset after unrenting to work from the schematics. My schematics are name rent-shop1 rent-shop2 etc. and my regions are shop1 and shop2
This is my config. I am on the latest spigot. http://paste.md-5.net/dihowaqafu.coffee
Thanks!
@DatGamerthou
What version of Bukkit and AreaShop are you using? AreaShop V1.3.0 is only for Bukkit 1.7.9+ so maybe you used this version on Bukkit 1.7.2? If it says in internal error has occured then an error message will be in the console/log files, could you send met the full error and the startup log of your server? You can send me a PM with these files.
If i have the error then I can often see what is causing the problem.
I cant use rent signs, and when I try to use /as rent test, it says, "An internal error occured while trying to preform this command"
plz fix this, i really like this plugin
@snakemansos
Using version 1.3.0 on a 1.7.2 server is not possible, the plugin will crash while loading. You need to update your server to 1.7.9 or downgrade AreaShop to 1.2.1 to get it working again. If you decide to downgrade AreaShop be sure to folow the guide posted in the changelog of AreaShop V1.3.0 (the number list at the bottom). I can provide you a build of V1.2.1 that will load before Multiverse, check PM.
i change some strings for another language on config.yml but not recognize it.
I have a 1.7.2 r0.3 server...but using your last version of your plugin (because i got multiverse and i know AreaShop v1.2.1 have issues with it)
@scuroK
I will try to get it done fast, maybe I include it with the small update I did to the teleportation algorithm (/as tp). If an update with this feature is uploaded I will try to send you a PM (I could forget that), or just be sure you enable notifications for new versions of this plugin (check the explaination above)
@Dyenx999
Are you sure the plugin has started correctly? Try the command '/as', does it show a list of commands you can use? Also check the console for errors on the startup of your server. Did you change permissions? By default everyone should be able to rent 1 region unless you changed that. If you click the sign you do not get any message at all?
@nlthijs48
I Think i found a bug. I tried to click a rent sign and nothing happened. Do u know how to fix this ?
@nlthijs48
I will wait for this function. then i can get rid of the old simple region market. please add it soon!
@EnderdragonDotDe
I have send you a PM about some changes about the teleportation, let me know what you think about it.
Letting player teleport to regions that are not bought/rented yet is a good idea, I add that to the list of 'Planned Features' on the main page. Thanks for suggesting that.
I'll wait. More than 1000 regions are too much to set every teleport point manually. And as a new idea why not let the player teleport to a buyable region with a command, teleport him right next to the sign. For example, /as buyable [maximumprice] and the same for rent.
@EnderdragonDotDe
I was already thinking about checking all blocks around a player, but I decided to not do that and just center their position on the target block (instead of spawning on a edge and possible touching lava on another block you just spawn in the middle). If you did not set a teleport location using '/as settp' the algorithm will start from the middle of the region at the lowest y coordinate, so if your regions include caves it will start searching around there. The algorithm will not teleport players into lava, but it could be right next to lava and still flowing.
In the next version I will change the teleport function to also check blocks around the player for lava so it is even more safe. For now you could set the teleport location of the regions by hand using '/as settp'. If a player bought/rented a region they can also do this for their own region, so you can just make that clear to your players and then you don't have to do it yourself.
Thanks for the feedback.
Maybe you should improve the teleport function a little bit. very often players are teleporter right next to lava or flowing lave in caves.