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).
You should add /as home which allows the player to teleport to there region that they bought or rented. And with a timer that teleports them to it (or set to 0 in the config)
@omgGrim
By default the plugin adds the player as a member of the region after they rented/bought the region, this can be changed in the config. If you want them to only access chests, doors, etc. you can add an extra line to the config to deny building/destroying. In the 'flagsForRent' and 'flagsRented' section of the config add the following line: "build: deny", without the quotes and with 2 spaces in front (same indenting as the members and greeting). Then a player should not be able to destroy/place anything but then can use the chests etc. You can do the same thing for buy regions, these have a similar section in the config. All the normal region flags you can use with WorldGuard can be added to these sections.
@MineCaddict
Can you send me the full error or your full startup log at pastebin.com? Then I take a look and try to figure out a solution for your problem.
@SeeingBlue
Schematic saving and loading is off by default, check if all the rules from the default config are present in your config. Then be sure that 'enableSchematics' is set to true (that is default), and that 'useRentRestore' and/or 'useBuyRestore' are also set to true. Then it should save a schematic when you place a sign for buying or renting a region, and it should restore this schematic when renting is over or you delete the sign (that is the default profile, can be changed in the config). The signs don't have to be in the region. If schematic save/restore is enabled it should post debug messages in the console whether or not it saved/restored a schematic (depending on how your profile is set up in the config).
Setting your moneyCharacter to '' should work, just tested it myself and it only displayed a number, as it should do. Are you sure that you reloaded/restarted your server after you changed the config? (you can also do /as reload, and the /as updaterents to update it). I have added an extra line to the config to set the character(s) that should be displayed after the price, a new version of my plugin will be released soon with this feature.
Will players be able to destroy blocks in the area rented or purchased? Because I would like to let players rent a house and store items in it. And only they can access the chests, doors, trapdoors, etc. Also and any support for adding players to regions?
Unfortunately, this plugin doesn't work for me.. I really need it. Here's what I get when I start up my server: "ERROR: Could not load 'plugins\areashop_V1.1.2.jar' in folder 'plugins'. " I also tried the previous versions (v1.1 and v1.0) but same error. I'm running on CB 1.7.2-R0.3. Please help.
Is the Schem suppose to be created when the sign is created? The signs don't have to created inside the region do they?
I just created a rental region and it did not save my schem. Could be a file permission issue with Linux, not sure because debug doesn't list anything related to the schem saving.
One other thing. I set my moneyCharacter to nothing (''). When I create a new region it worked, didn't list the moneyCharacter. When I tried /as updaterents it didn't remove the $ from the other signs. It would be useful for servers that use items like gold as currency to maybe list the word "gold" after the rental/buy price on the signs. Probably the best way to handle this is to hook into vault or something and just look at the currenty type if that's possible.
thanks for this plugin, i needed a replacement for simple region market while it is getting re-coded
@Tunner3406
I could add that feature to the plugin, good suggestion! The downside is that the sign is in the region that will be sold/rented, and then the player will be able to break the block behind/below the sign so that my plugin misses the sign and deletes the renting/buying of that region next reload/reboot of the server.
Currently the plugin stops breaking the sign directly by players who don't have permission, but indirectly (with piston, etc) is just to hard to detect. What I will add for sure is that if the sign is missing from a region then the region flags get reset to the forRent or forSale state, so that the player that destroyed the sign does not have permission in that region anymore. Otherwise the player would be owner of the region forever, without it being registered in my plugin.
Would be great to put the sign that the name of the region is automatically put as simple region market.
Sorry for my English, I'm Spanish
@SeeingBlue
Working on the restore functionality, hopefully getting it done soon. I still do it for renting and buying regions, the underlying code just uses the same save and restore function anyway.
Those commands are for updating the signs/regions, if you for example change the 'signRentable' line in the config, you could run the '/as updaterentsigns' command to update all the signs. Then the new line from the config will be on all your already set-up signs and you don't have to refresh them manually one-by-one. The same thing for the regions, if you would change the greeting message in the config you can update them all with a command.
These commands will not be used much, but can be very helpful if you have already set-up 100 signs and changed something in the config (experienced that myself).
@nlthijs48
I think that's a good idea because I would like to restore rental properties, but not exactly bought properties.
Can you explain what these commands are used for?
@SeeingBlue
I changed the description of the command at this page, it was wrong, thanks for letting me know.
I already worked on the saving and restoring of the schematic, this already works, I only need to add config options. The config options you suggested would be nice, I think I go for that. Then I also add the option to enable/disable the schematic saving and restoring per region, which can be usefull if you only want certain regions to save and restore.
@nlthijs48
I haven't tested "/as sell" to see if it's working. I was just confused by what you said above. Maybe it's a typo but it does say "/as sell <region> Sell a region you have bought (you don't get any money back)"
As for implementing the schematic feature I know how buyland done it was in the config. There was a placeSchematic & takeSchematic property for each event like onCreate, onBuy, onSell, onRent, onExpire. You just set whether placeSchem & takeSchem was true or false for each event.
Also what are the update commands used for?
@SeeingBlue
I want to add the restoring of a region with schematics in the next version, hopefully I get that done within 2 weeks. I already found out how I need to do it, just need to implement in a user-friendly way.
The /as sell <region> command does give you money back (at least with the default config), in the config you can specify a percentage of the money that will be given back (buyMoneyBack) if it is 100 the full price will be given back, if it is 0 nothing will be given back. Maybe check your startup log to see if Vault is working correctly and that AreaShop can detect Vault correctly.
As far as I can tell this is the only plugin for 1.7.2 that is worth installing right now. Buyland just announced they are shutting down. SimpleRegionMarket isn't done for 1.7.2.
Some suggestions would be to utilize schematic snapshots to save and restore property to before it was rented or purchased.
Also I'm a bit confused by this line /as sell <region> Sell a region you have bought (you don't get any money back) Why would you ever use this command if you don't get any money back? Does this just mean it's sellable and ready for you to put a sell sign on it or is a sell sign enough to sell a home?
@UltrafaceGuy
Thanks for using the plugin! If you want me to add something or if you want to report a bug, just post here or PM me.
Looking good so far, this is exactly what I needed. I'll keep you posted if I find any issues! Good work!