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).
I'm currently finishing an AreaShop update with hover/click parts in messages (see examples below), for this a lot of translations need to be updated. So I would like to invite everyone that speak English and another language to help translating AreaShop.
Help translating: https://github.com/NLthijs48/AreaShop/wiki/Language-support#translating-on-transifex
More information about the new messages: https://github.com/NLthijs48/AreaShop/issues/18
Output of '/as me', you can click the region names for details about your region.
Output of '/as info region <regionName>' (clicking one of the regions in '/as me' shows this).
'Extend for' can be clicked to immediately extend the rent, 'unrenting payback' can be clicked to stop renting, 'Go to the region' can be clicked to teleport to it, 'set teleport location' can be clicked to set the teleport location to your current location.
@frizzbee30
I agree that would be useful, I updated issue #31 to include purging regions. If the region all have a similar name then removing them in the '/plugins/AreaShop/regions' folder should also be easy. If the world is still there then you can also make a big WorldEdit selection containing all the regions you want to remove and use '/as del', which will then remove all of them (WorldGuard regions would still be there though).
A handy feature would be the option to 'purge' regions with a missing worldguard region. if I recall I did this manually in the background in the past. We are currently resetting our survival world which has a mass of AS areas set up, which will all be orphaned and need a manual clear afterwards :)
@Timothy_The_King
Sounds like you need to set priority for the sold region.
/region setpriority <region> 1
See this one: https://github.com/NLthijs48/AreaShop/wiki/Frequently-Asked-Questions#why-cant-the-buyerrenter-of-the-region-build-inside-of-it
I Removed It But Still I Mean That Now Noone Can Buid Even If They Have Rented It
@Timothy_The_King
"build allow" is the problem and normally not needed. If you define a region only owners/members of the region and users with special WorldGuard-permission/OPs can build in. In other words: it's already protected. If you're having no special reason to set build-flag remove it.
See >>this<< one for further information, also the bottom of the red box.
I Just Changed The Flags And Still People Can Place Blocks
Sorry For The Rage :/ But I Mean The Flags I Have Is Build Allow Shall I Set Block-break And Block-Place Allow I Have No Clue Just Please Help Me
@Timothy_The_King
No need for capslock, it just looks rude.
Check which regions are at the same spot as the region you are having trouble with, and check which flags they have. You might have set 'block-break' or 'block-place' on one of them which might mess up the flags.
If you cannot figure it out then please send a screenshots of '/region info' for all regions that overlap with the AreaShop region and the region itself.
OTHER PEOPLE CAN BUILD IN OTHERS REGIONS HOW DO I FIX IT???
@nlthijs48
thankyou
@PhanaticD
Set the 'maxExtends' option in 'default.yml' to -1, and set the 'maxRentTime' setting to '8 days'. That would let them use the region infinitely, but only let them extend it again when they have 1 day or less left. Of course you can set it higher if you want to give them some more time to extend ('14 days' might be good).
How can I make it so there is infinite extends, but they can only do 1 extend at a time. So for example they rent a shop area for 1 week, but they can only extend it to the next week, and when they get to the next week, they can only extend it one more. Basically want it so they have to extend it every week to keep the shop. I don't see any possible way to do this with the current config
Hey nlthijs48,
sry for the late Answer. It works after Delete the Config, i have changed it all back do my old Settings and it works. Only all Ranted Shops are losed but it`s no Probleme for me.
LG
Hey there, could you please make a version that is compatible with Minecraft 1.6.4 ? Thanks!
Your best bet is probably trying version 1.2.1, which is for 1.7.2. I won't make a version for 1.6.4 because there are almost no servers using that anymore.
@Blackyvk
You should not have to give them permissions for it, the commands are executed in the console so they should use the permissions of the console. Are you sure you used a key like 'rightClickConsole' instead of one like 'rightClickPlayer'?
You need to add a 'groups' section to the limitgroups and specify the region groups in them, so that would be A and B. The names of limitgroups are not in any way linked to the names of region groups.
@nlthijs48
but what if I dont want to give /tellraw permissions ? normal users shouldnt have acess to that I believe. because if I dont give them permissions they just get a "permission error" and the sign does nothing.
_
Btw, I tried to use groups this way I dont know if its possible.
I want all players to be able to buy 1 region in group A and 1 region in group B, total regions in world 2, but no more than 1 region per group.
I tried this
but it didnt work, i also gave the permissions for both groups... or groups dont work this way?
@Blackyvk
You can either disable it, or add a confirmation before actually unrenting. For disabling it you can remove the unrent command from the flagProfiles section found in the config.yml file, for adding confirmations check this FAQ entry (this will require the player to click a message in chat before it is actually unrented).
So today we discovered that players can unrent their Area by shift+rightcliking the sign of their own region, this is a problem because that triggers the schematic and cleans the area... any way to change it ?