MineEstates
基于 WorldGuard 的房地产管理
更新于 14年2月21日
欢迎来到 MineEstates!本插件旨在让服务器管理员和玩家在购买、出售房屋、公寓及其他地块时变得更加轻松。所有由 WorldGuard 定义的地块均可由其所有者进行出售或出租,当所有权发生变更时,Lockette/Deadbolt 告示牌将自动更新。
如果你是受够了不断有人要求分配新地块或转让城市地块所有权的服务器管理员;或者你是正在寻找一款能让你的服务器摆脱“懒惰的管理员不愿处理玩家与区域事务”这一困境的玩家插件,那么你来对地方了。
该插件在城市风格的环境中效果最佳,即初始可创建大量地块,随后反复买卖。租赁系统支持拥有小型单间地块的大型公寓楼,这些单间地块可由公寓楼的所有者持有并循环使用。收租模块每五分钟扫描一次,但每个地块每天仅收取一次租金。租赁采用预付制,因此不存在玩家直接离开并通过续租来逃避收费的风险。
所有与地产相关的命令仅限在你当前所在的维度(世界)内操作,且无法保证在命令行中执行有效。
简略版:
1. /estates search [sales 或 rents]
2. 找到你喜欢的
3. /estates goto <地块名称>
4. /estates buy <地块名称> 或 /estates rent <地块名称>
搞定!
详细版:
销售市场和租赁市场是独立的,但使用相同的命令进行搜索。只需输入 /estates search sales 即可获取一个清晰格式显示的、包含五个结果的简短列表。estate search 命令支持类似 LogBlock 的限制条件:
/estates search sales size 10x10 price 30000
将显示面积等于或大于 10x10,且价格低于 30,000 的地块。
输入 /estates page <页码> 将从第 1 页开始显示你最近一次搜索结果的对应页面。一旦找到符合你期望的大小和价格的地块,使用 /estates tp <地块名称> 或 /estates goto <地块名称> 快速传送至该区域,然后使用 /estates buy <地块名称> 购买它,或者如果是租赁地块则使用 /estates rent <地块名称>。
就是这样!你已成功购买或租下了一块地。
============================================
命令列表
============================================
[可选] 参数非必需
<必需> 参数是必须的
/estates search <sales | rents> price | owner | name>
此命令搜索可供出售或出租的地块。结果可按以下任一条件排序:
- name(名称)
- price(价格)
- owner(所有者)
- size(大小)
也可通过以下一个或多个条件进行限制:
- size(以 lengthXwidth 格式表示,例如 10x10)
- price(最高允许价格)
- owner(地块所有者的名称)
/estates page <页码>
搜索结果每页分为 5 条。完成搜索后,你可以使用此命令浏览缓存的结果。由于缓存的存在,结果可能会过时,特别是如果搜索时间较早且服务器上有大量的地产活动时。小型服务器通常不会出现此问题,且每次用户执行搜索时都会重新生成其缓存。
/estates goto <地块名称> OR /estates tp <地块名称>
此命令将你传送到你想查看的地块。要使此命令生效,该地块必须在公开市场上可用。目前的传送代码较为粗糙,但如果该 WorldGuard 区域设置了传送标记,它将覆盖默认的传送算法并使用该标记的位置。
/estates buy <地块名称>
此命令允许你购买指定名称的地块。价格将从你的账户扣除并支付给所有者。随后该地块会自动从市场上移除。
/estates rent <地块名称> <天数>
此命令将你添加为该地块的成员——而非所有者。首次付款立即发生,租赁费用每 24 小时重复收取一次。该系统按天预付。将 <天数> 标志设置为负数将导致无限期租赁。在你离开或被驱逐之前,该地块将从租赁市场中移除。<天数> 仅代表最大时长,租赁房产可随时退租。
/estates sell <地块名称> <价格>
此命令将指定地块以给定价格上架公开市场。面积通过 WorldGuard 自动计算。
只有当有人购买时,你才会收到款项!一旦有人购买,任何 Lockette 或 Deadbolt 保护告示牌*都会*更新为新所有者的名字,所以在出售前请清理好你的物品。
/estates lease <地块名称> <每日价格>
此命令将指定地块以给定的每日价格上架租赁市场。面积通过 WorldGuard 自动计算。除非有人正在积极租赁该地块,否则你不会收到任何费用。如果你经营着公寓综合体,填满你的地块符合你的最大利益。
租客将被添加为成员,但你保留地块的所有权。Lockette 和 Deadbolt 告示牌*不会*被更新。
/estates cancel <地块名称>
此命令会将从市场上移除一个地块,无论是出租还是出售。如果当前有租客正在租用该房产,请勿执行此操作,因为它不会驱逐租客;实际上,由于租赁会使地块脱离市场,此命令本应完全无法生效。
/estates evict <地块名称>
此命令会强制将当前租客从房产中移除。不会退还任何费用,也不会更新 Lockette/Deadbolt 告示牌,但租客会被移出房产,且该地块将重新放回租赁市场。如果可能,应避免使用此命令。
/estates leave <地块名称>
此命令的作用与驱逐相同,但由租客而非地块所有者执行。当租客决定搬离地块时使用此命令。不会退还任何费用,也不会更新 Lockette/Deadbolt 告示牌。租客会从地块中移除,且该地块将返回租赁市场。
/estates sellpublic <地块名称> <价格>
此命令仅供服务器管理员使用。当地块最初创建但暂无所有者时,此命令会将地块上架至市场,方式与 /estates sell 相同,但售出的资金会消失,不会支付给地块所有者。管理员也可使用此命令出售废弃的地块。
此命令的权限仅应授予管理员。
============================================
权限节点
============================================
estates.plots.buy
提供在市场购买地块的权限。
estates.plots.sell
提供在市场出售地块的权限。
estates.plots.rent
提供租赁和退租的权限。
estates.plots.lease
提供将你的房产设置为租赁市场可用房源的权限。
estates.plots.goto
提供传送至可租或可售房产的权限。
estates.plots.sellpublic
提供将区域作为公共领域属性出售的权限。售出资金会消失。此权限应仅授予管理员,用于出售新地块或废弃地块。此命令不检查地块所有权,因此不应分发给普通用户。
estates.plots.canceloverride
提供取消任何当前正在出售或出租的地块的权限,无论用户是否拥有该地块。此权限仅应授予管理员以监管市场。
============================================
更新时间!
============================================
截至 2014年2月21日,插件的基本功能已全部完成。然而,非 SQL 数据库尚未实现。
============================================
安装
============================================
重要提示:右侧的下载文件并非正确版本!请从右侧的文件列表中手动下载最新版本。
以下是该插件的工作原理简述。
- 你需要配置好 WorldGuard。你可以将其完全配置好并运行数月,这并不重要。
- 你需要一个兼容 Vault 的权限插件。
- 你需要一个兼容 Vault 的经济插件。
- 第一步:安装 Vault 插件
- * 这非常简单。只需将 Vault 插件的 jar 文件放入你的 plugins 文件夹即可。它会处理其余所有事情。
- 第二步:确定你要使用的数据库类型。
- * 如果你的 WorldGuard 在配置中将 MySQL 数据库选项设置为“true”,则你无需额外操作来安装 MineEstates,只需将 MineEstates.jar 放入你的 plugins 文件夹即可。
- 第三步:创建 MineEstates MySQL 数据库。
- * 这非常简单。只需连接到 MySQL,创建一个数据库,授予 config.yml 中配置的 mineestates 用户/密码对该数据库的所有权限,即可完成。确保更改 MineEstates 的 config.yml 中 “dsn” 字符串末尾的数据库名称。
- 就这样!
你完成了。这就是你需要做的所有事情。简单的设置,简单的管理,简单的插件。
请注意,插件至少需要启动一次,才会生成 config.yml 文件。
如果没有生成配置文件,说明出现了重大问题,例如服务器内存严重不足或其他异常情况。
有问题?有顾虑?请联系我。联系方式见下文。
当前代码
Github 源代码
这里始终有最新的可用源代码。如果你发现某个旧版本的 MineEstates 因为……嗯……太旧而无法正常工作,但你又需要在旧的 Minecraft/Bukkit 服务器上获得最新功能,你可以使用旧的 Bukkit/CraftBukkit 代码并在其基础上编译 MineEstates。除非是极其古老的 Bukkit 版本,否则通常没问题,届时你可能就无能为力了。
别忘了 GitHub 上还有维基!MineEstates 维基
这将随着时间的推移不断扩展和编辑。
============================================
依赖要求:
============================================
- WorldEdit(最新开发版)
- WorldGuard(同样为最新开发版)
- MineEstates 的 MySQL 数据库(允许使用 WorldGuard 的 MySQL 数据库,如果 WG 使用了它的话)
- 合适的 CraftBukkit 版本
- Vault(允许与各个经济/权限系统交互,例如 iConomy 和 PEX)
============================================
当前功能
============================================
更新于 2月21日 **
- 出售/购买 WorldGuard 地块
- 出租 WorldGuard 地块
- 当玩家购买地块时更新 Lockette/Deadbolt 告示牌
- 如果租客资金不足或租约到期,则驱逐租客
- 允许传送至待售/待租的地块
- 允许搜索销售/租赁市场
- 市场搜索可按最高价格、最小尺寸(长 X 宽,即 10x10)或所有者名称进行限制
============================================
计划中的功能
============================================
- 地块租赁
- 独立的配置文件,可选择数据库类型
- 非 MySQL 数据库选项
- 黑名单用户
- 黑名单地块
============================================
待办事项列表
============================================
到目前为止,仍需实现的功能如下:
- 非 MySQL 数据库存储方法(不再强制要求使用 WorldGuard 的 MySQL)
- 实现 db4o 数据库
- 配置项以限制玩家一次性可租用/购买的地块数量(-1 表示无限制)
- 有什么建议吗?
============================================
联系方式
============================================
如果您因任何原因需要联系我,或者在设置方面需要帮助,或其他类似情况,请给我发邮件至
- wtechboy18@gmail.com
我可能会在六小时或更短时间内给您回信。我一直都会查看邮件。
56.13
MineEstates
WorldGuard-based real estate management
Updates 2/21/14
Welcome to MineEstates! This plugin was created to make selling and buying houses, apartments, and other plots, much easier on both the server admin and on the users. All WorldGuard plots can be sold or rented out by their owners, and Lockette/Deadbolt signs will be updated when ownership changes.
If you're a server admin, tired of having to deal with people constantly wanting new plots or transferred ownership in a city, or if you're a player trying to find a plugin your server can use to get past the fact that your lazy admin never want to deal with players and regions, you're in the right place.
This plot works best in a city-like environment, where large amounts of plots can be created initially and then simply bought and sold repeatedly. The rental system allows for large apartment buildings with small per-room plots, which can be owned by the apartment building's owner and recycled over and over. The rent collector scans once every five minutes; however, it only charges rent once per 24 hours on every plot. The rentals work on a pay-in-advance system, so there's no risk of people simply leaving and renewing their rentals to try to evade the system.
All estates-related commands are limited to operation in the world (dimension) that you currently reside in, and none of them are guaranteed to work from the command line.
The short version:
1. /estates search [sales or rents]
2. find one you like
3. /estates goto <plotname>
4. /estates buy <plotname> or /estates rent <plotname>
And you're done!
The long version:
The sales and rentals markets are separate but use the same commands to search through results. Simply do /estates search sales to get a short five-entry list of results in a clearly displayed format. The estates search command supports logblock-style limiters:
/estates search sales size 10x10 price 30000
will display plots that are equal or larger to 10x10 in size, and less than 30,000 in price.
Doing /estates page <pagenum> will, starting at 1, display that page of results from your latest search. Once you've found a plot that matches the size and price you want, use /estates tp <plotname> or /estates goto <plotname> to teleport quickly to the region, and /estates buy <plotname> to buy it, or /estates rent <plotname> if it's a rental plot.
And that's it! You've successfully bought or rented a plot.
============================================
Commands List
============================================
[optional] parameters aren't necessary
<required> parameters are
/estates search <sales | rents> price | owner | name>
This command searches through plots that are available either to sell or to rent. The results can be sorted by one of:
- name
- price
- owner
- size
They can also be limited by none, any, or all of:
- size (in the format lengthXwidth, i.e. 10x10)
- price (maximum allowable price)
- owner (name of owner of plots)
/estates page <pagenumber>
Search results are organized into pages of 5 results each. Once you have done a search, you can use this command to scroll through the results, which are cached. Caching results in the possibility that the results are out-of-date, especially if the search was performed long ago, and the server has large amounts of estates activity. Small servers should generally not have this problem, and the cache is regenerated for the user every time they perform the search.
/estates goto <plotname> OR /estates tp <plotname>
This command teleports you to the plot that you wish to see. For this to work, the plot must be available on the open market. The teleportation code is currently crude at best, but it will override its teleportation algorithm with the location of the worldguard region teleport flag, if it has one.
/estates buy <plotname>
This command allows you to purchase the plot with the name specified. The price will be deducted from your account and given to the owner. The plot will then be taken off the market automatically.
/estates rent <plotname> <days>
This command adds you as a member- NOT an owner- to the plot. The first payment happens immediately, and the price of the rental recurs once every 24 hours. This system is pay-in-advance on a per-day basis. Setting the <days> flag to a negative number will result in infinite rental duration. The plot will be taken off the rental market until you leave or are evicted. The <days> is simply a maximum duration, and rental properties can be left at any time.
/estates sell <plotname> <price>
This command places the plot specified on the open market for the price given. Size is calculated automatically through WorldGuard.
You will NOT receive money for the plot until someone buys it! Once they have bought it, any Lockette or Deadbolt protection signs *will* be updated with the new owner's name, so get your crap out before selling.
/estates lease <plotname> <dailyprice>
This command places the plot specified on the rentals market for the daily price given. Size is calculated automatically through WorldGuard. You will not receive money unless someone is actively renting the plot. If you're running an apartment complex, filling your plots is in your best interests.
Renters will be added as members, but you will retain ownership of the plot. Lockette and Deadbolt signs will NOT be updated.
/estates cancel <plotname>
This command removes a plot, whether rental or for sale, from the market entirely. Do not do this to a rental property if a renter is currently there, as it WILL NOT evict them, and in fact should not work at all since renting takes the plot off the market.
/estates evict <plotname>
This command forcibly removes the current renter from the property. No money is returned to them, and no Lockette/Deadbolt signs are updated, but they are removed from the property and the plot is placed back on the rental market. Doing this should be avoided if possible.
/estates leave <plotname>
This command works the same as eviction, but is performed by the renter, not the plot owner. This is used if the renter decides they want to leave the plot. No money is returned, and no Lockette/Deadbolt signs are updated. The renter is removed from the plot and the plot is returned to the rental market.
/estates sellpublic <plotname> <price>
This command is for server administrators. When a plot is originally created, but no owner is immediately available, this will put the plot on the market the same way as /estates sell will, but the money from the sale essentially disappears and is not given to the owner of the plot. This can also be used by administrators to sell abandoned plots.
THIS COMMAND'S PERMISSIONS SHOULD ONLY BE GIVEN TO ADMINISTRATORS.
============================================
Permissions Nodes
============================================
estates.plots.buy
This provides the permission for buying plots on the open market.
estates.plots.sell
This provides the permission for selling plots on the open market.
estates.plots.rent
This provides the permission for renting AND leaving rental properties.
estates.plots.lease
This provides the permission to set your property up as an available rental property on the rentals market.
estates.plots.goto
This provides the permission to teleport to available rental/for-sale properties.
estates.plots.sellpublic
This provides the permission to sell a region as Public Domain property. The money from the sale disappears. This should be given to administrators only, for the purpose of selling new or abandoned plots. This does *not* check for plot ownership, and so should not be given out to regular users.
estates.plots.canceloverride
This provides the permission to cancel ANY plot that is currently up for sale or rent, whether or not the user owns it. This should only be given to administrators in order to regulate the market.
============================================
Updates time!
============================================
As of 2/21/14, the plugin has all the basic functionality finished. Non-SQL databases have *not* been implemented, however.
============================================
Installation
============================================
IMPORTANT: The download file on the right doesn't use the right file! Download the latest version manually from the files list on the right.
Here's basically how this plugin works.
- You have your WorldGuard setup. You can have it fully set up, running for months, whatever, doesn't matter.
- You have a Vault-compatible permissions plugin.
- You have a Vault-compatible economy plugin.
- Step one: Install the Vault plugin
- * This is very simple. Just put the Vault plugin jarfile in your plugins folder. It takes care of everything else.
- Step two: Figure out what kind of database you want.
- * If your WorldGuard was created with the MySQL database option set to "true" in the config, you don't need to do anything extra to install MineEstates but put the MineEstates.jar in your plugins folder.
- Step Three: Create a MineEstates MySQL database.
- * This is very simple. Simply connect to MySQL, create a database, grant the mineestates user/password in the config all permissions on that database, and you're finished. Make sure you change the database name at the end of the "dsn" string in the config.yml for MineEstates.
- That's it!
You're done. That's all you need to do. Simple setup, simple management, simple plugin.
Keep in mind, however, that the plugin needs to be started AT LEAST ONCE before you'll get a generated config.yml file.
If it isn't generating a config that means something big went wrong, like your server being horribly out of memory or something weird like that.
Questions? Concerns? Contact me. See below for contact info.
Current Code
Code Source @ Github
There's always the latest working source code here. If you find that an older version of MineEstates isn't working correctly because it's... well... old, but you need the latest features with a legacy minecraft/bukkit server, you can use the old Bukkit/CraftBukkit code and compile MineEstates against it. Unless it's REALLY old Bukkit, at which point you may be outta luck.
Don't forget that the github has a wiki as well! MineEstates Wiki
This'll be expanded and edited over time.
============================================
REQUIREMENTS:
============================================
- WorldEdit (Latest dev build)
- WorldGuard (Also latest dev build)
- MySQL Database for MineEstates (permitted to use WorldGuard's MySQL database, if WG uses it)
- Appropriate CraftBukkit version
- Vault(Allows interfacing wth individual economy/permissions systems, such as iConomy and PEX)
============================================
Current features
============================================
Updated 2/21 **
- Sell/buy WorldGuard plots
- Rent out WorldGuard plots
- Updates Lockette/Deadbolt signs when the plot is bought by a player
- Evicts renters if they run out of money or their lease ends
- Allows teleportation to plots for sale/rent
- Allows searching of sales/rentals markets
- Markets search can be limited to max price, min size (len X wid, i.e. 10x10), or owner name
============================================
Planned features
============================================
- Renting of plots
- Separate config with choice of DB type
- Non-MySQL database option
- Blacklisted Users
- Blacklisted Plots
============================================
TODO list
============================================
So far the things that remain to be implemented are as follows:
- Non-MySQL database storage method (WorldGuard's MySQL is no longer required)
- implement db4o database
- Config value to limit # of plots players can rent/buy at once (-1 for unlimited)
- Suggestions?
============================================
Contact info
============================================
If you need to contact me for any reason, help with setup, or anything like that, email me at
- wtechboy18@gmail.com
I'll get an email back to you probably within six hours or less. I'm always on my email.
56.13
评论 0
登录后参与评分
还没有评论,来抢沙发吧