BuyRegion
As BukkitDev staff have left the team I am no longer updating the plugin on here, Please visit the discussion on Spigot, I will move all updates and information over soon - If plugin releases start to get accepted I will think about moving over downloads back to bukkit - As for other plugins you can view my uploads here
Allows you to create signs which can be used to buy or rent WorldGuard regions. The plugin works with all Vault supported economy systems as it requires Vault for economy support.
Please create a ticket for problems else they get lost in the comments.
Plugin work and update
I have pushed build 1.1.7 out (Pending to be released) to squat bugs and fix anything that appears, The plugin has been tested on a spigot / bukkit 1.7.8 build and is working successful with no errors. Please report anything you get into the comments so we can go through and fix these problems together :)
PS: Try and use pastebin when pasting a error
UUID's:
A UUID safe build will be released soon along with bug fixes when some are found.
Installation
- Put BuyRegion.jar in your plugins directory.
- Do a /reload to reload your plugins.
- Configure your permissions if needed.
- Enjoy!
Permissions
- buyregion.create - allows the creation of [BuyRegion] and [RentRegion] signs.
- buyregion.admin - allows usage of admin commands.
- buyregion.exempt - allows player to bypass BuyRegionMax
- buyregion.buy - allows player to buy a region (if config requires)
- buyregion.rent - allows player to rent a region (if config requires)
(note: OPs have all nodes)
Usage
Create a BuyRegion Sign
- : [BuyRegion]
- : <regionname>
- : <price>
- : unused/any
Example Sign
- [BuyRegion]
- epic_store
- 200
The previous would make a sign that would sell region 'epic_store' for '200' of your economy currency.
Create a RentRegion Sign
- : [RentRegion]
- : <regionname>
- : <price>
- : <timespan>
Example Sign
- [RentRegion]
- epic_store
- 200
- 7 days
The previous would make a sign that would rent region 'epic_store' for '200' of your economy currency for 7 days. Once rented properties expire, the region is automatically put back up for rent. If the renter has auto-renew turned on, the property will be renewed to them if they have the available money. See notes for information about sign replacement.
Buy a Region
- The player must enter buy mode by typing /buyregion
- The player must right-click a BuyRegion sign.
(note: if the player right-clicks a BuyRegion sign while not in buy mode, they will be prompted to enter buy mode.)
(note: if RequireBuyMode is set to false the player will not be required to enter buy mode before buying or renting a region.)
Rent a Region
- Same as buying a region, see above.
Player Commands
- /buyregion - toggles buy mode
- /buyregion renew <region> - renews rental on <region>
- /buyregion autorenew - shows current autorenew status
- /buyregion autorenew <true/false> - sets auto-renew for all of the player's rentals
- /buyregion help - shows help screen
Admin Commands
- /buyregion buycheck <player> - checks total bought regions for <player>
- /buyregion rentcheck <player> - checks total rented regions for <player>
- /buyregion buyset <player> <amount> - sets total bought regions for <player>
- /buyregion rentset <player> <amount> - sets total rented regions for <player>
- /buyregion buymax - displays current BuyRegionMax
- /buyregion buymax <amount> - sets BuyRegionMax
- /buyregion rentmax - displays current RentRegionMax
- /buyregion rentmax <amount> - sets RentRegionMax
- /buyregion buymode - shows the current RequireBuyMode setting
- /buyregion buymode <true/false> - sets RequireBuyMode
- /buyregion buyperms - shows the current RequireBuyPerms setting
- /buyregion buyperms <true/false> - sets RequireBuyPerms
- /buyregion rentperms - shows the current RequireRentPerms setting
- /buyregion rentperms <true/false> - sets RequireRentPerms
- /buyregion evict <region> - performs an eviction on <region>
- /buyregion help - shows all commands
(note: Setting BuyRegionMax or RentRegionMax to 0 makes it unlimited)
Timespans
Timespan Examples
- 1 day
- 15 secs
- 20 mins
- 5 h
Accepted Time Values
- Seconds: s, sec, secs, second, seconds
- Minutes: m, min, mins, minute, minutes
- Hours: h, hour, hours
- Days: d, day, days
Config Options
- BuyRegionMax - max regions a player can buy with BuyRegion
- RentRegionMax - max regions a player can rent with BuyRegion
- CheckExpirationsInMins - how often to check for expired rented regions IN MINUTES
- RequireBuyMode - is buy mode required to be on to use buy/rent signs? Recommended: true
- RequireBuyPerms - require the player to have buyregion.buy to buy a region
- RequireRentPerms - require the player to have buyregion.rent to rent a region
- DateFormat - Sets the date format - Accepted Values: Default, US, EU
Date Formats
- Default - year/month/day
- US - month/day/year
- EU - day/month/year
Message Configuration
- All messages that are sent to a player can be changed by editing your config.yml in the 'Messages' section.
- Between the name of the field and the contents you should be able to figure out which is which.
- Sentences that seem to just end will probably have the value placed there.. consider this when making changes.
- No admin messages can be changed... would be a lot of work on my end for nothing.
Notes
- Auto-renew is defaulted to OFF for all players. They will only need to turn it on once, however.
- Only use 1 [RentRegion] sign per rentable region. For performance reasons it does not properly support multiple signs per region. It will let you create them, but it will probably lead to strange behavior. This applies to [BuyRegion] signs also.
- I would recommend trying to avoid original RentRegion signs being destroyed.. the replacement of them is still a little sketchy for positioning. I do plan to look at this but was trying to get a release out with the renting for all the people currently dead in the water from that other plugin going inactive.
- The CheckExpirationsInMins config setting can accept decimals.. so 0.05 = 3 seconds for instance. Although I wouldn't recommend going less than 0.5 for that setting. With a lot of rented regions it could be a taxing operation. Best left to 5+ minutes for average servers that rent things for days, and not minutes or seconds.
- I didn't bother making the signs indestructible as the idea is to place it inside the already defined protected region.. which would typically make it unbreakable anyways. Furthermore, for performance reasons I'm trying very hard to avoid hooking the block break event.
@JDigital1337
Thanks man, I look forwarding to using the heck out of this. Once I learn about this "World Guard" parenting system, and the 1.3 build comes out Ill be opening up the server to the public.
@Tech_Lewis
I'll add a permission for buying and for renting in the next version...
Unsure when the next version will be coming as we are all waiting on bukkit to update...
Amazing plugin, and simple to use. I'm definetly going to support your progress if all goes well with my server. Will you be adding group permissions in the future so we can only allow certain groups to buy/rent regions? If so that would be great.
@JDigital1337
No problem was just a suggestion. I think it would be extremely hard to accomplish as well hehe. I just didn't want my players to be able to loot other people's areas once the shop expired. So maybe I'll just keep an eye on the area before they expire and take it all down for them ahead of time. Either way awesome plugin since it regulates so much where I don't have the time to. Thank you for your hard work :]
Hmm... I don't think this "destroy anything built on the land when rented region" is a good idea. It must be real. If some day it happens, should have the both options for renting (remove everything changed or not)
@imaapseudonym
This has been asked a bunch of times but basically, if we start getting into world manipulation, that grows the scope of this plugin exponentially.
I may look a little more into WorldEdit to see if there is a way I can have WE do the clearing, but as far as my plugin itself... probably won't happen.
Side note: This kind of thing is what causes so many other plugins to be crappy.. trying to do too much... (that and most plugins are written by complete amateurs/kids)
Is there any way you can make it so when the rent sign expires it destroys anything built on that land?
Well... considering my plugin runs in bukkit, and bukkit hasn't been updated to 1.3...
That said, as soon as bukkit updates I don't see why it would break this plugin unless they change the API (which they wont do).
So more than likely this version will be compatible when bukkit updates.
Heeeyy JD, just asking if the plugin is compatible with Minecraft 1.3. Is it?
Thanks =)
No problem. Plugin is working great so far with no issues. Highly recommended!
@MogriMoogle
Hey thanks for the heads up.. didn't even know there were tickets. Apparently bukkit doesn't call that out..
Thanks!
Sent in a ticket, but not sure if you are checking those as many seem unanswered.
First of all, fantastic plug-in! Secondly, I was wondering if you could add a configuration to change the date format. Currently it is yy/mm/dd and I'd prefer mm/dd/yy. Could you add a config so people could change what format they want? Thanks!
Plug in is working great, however I seriously need a particular function if possible. You have in the notes that you can't don't more than one rent sign per region. Is there any way to fix this? I would love to be able to rent access to a mine or to a workshop with IC machines, etc. Thanks again! Come by the AE Tekkit Server sometime and visit us. 108.174.63.235:25565
As for lwc and the signs, yes.. BuyRegion will change a sign that is protected by LWC. It will also replace the sign if it is destroyed.. although the positioning still needs some work.
And heh.. unfortunately what you're after is a WorldGuard thing if you want people making regions...
Be sure to let me know how it performs on your server... interested to see how far it can go!
Now, I know this is a "buyregion" plugin - but man... it would be super awesome if there was a way you can set in a config (or node) that granted the users the ability to create regions (that were limited in size/by block scope) so the admins didn't have to do that either.
Real estate in minecraft!
@JDigital1337
The admins could just as easy LWC the sign - right? will the sign data still change?
Ahhh! the sign doesnt have to be in the region that is being sold! :) makes SENSE!
Unless you have an obscene amount of rented regions, its pretty much unnoticable. And nothing stops them from destroying the sign..
I would recommend trying to avoid original RentRegion signs being destroyed.. the replacement of them is still a little sketchy for positioning. I do plan to look at this but was trying to get a release out with the renting for all the people currently dead in the water from that other plugin going inactive.
With that said, most people make the inside of the shops the region that is sold, and the sign is outside the shop...
What kind of performance impact does this have on a server? I run a server of 200+ players (avg 100) and it can get a bit heavy.
What stops a player from removing the "rent" sign when they own the region? I just saw a player do it.
This looks like a much better plugin than what I'm using at the moment, when I'm home I'm going to replace the old with this!
@Trecoo
good catch, fixed it and uploaded 1.1.2
Thanks!