View source for ProtectionStones

{{模板:待完善}}
{{Bukkit Plugin Infobox
|中文名     = 保护石
|外文名     = ProtectionStones
|图片       = [[文件:ProtectionStones_logo.png]]
|作者       = AxelDios
|最新版本   = 1.9j
|兼容服务端 = Spigot/Paper (1.13+)
|前置插件   = [[WorldGuard]], [[WorldEdit]]
|源地址     = https://dev.bukkit.org/projects/protectionstones
}}
[[分类:管理]][[分类:安全]]
== 简介 ==
ProtectionStones是一个功能强大，自定义性很强的领地插件<br />
★ 包括但不仅限于：<br />
操作简单，适合新手，免除圈地麻烦<br />
自由出租、出售，自由交易领地<br />
多领地合并，管理更方便<br />
领地税收，还原国家级待遇<br />
自由添加保护石<br />
自由更改获得方式，要求资金<br />
可自定义配方，且可以多层升级<br />
点击式更改权限，免除指令麻烦<br />
......
=== 原文 ===
<pre>
Ever needed an easy, yet powerful way to prevent grief, and protect a certain area?

This plugin allows players to protect land using a block that they place down. It creates a WorldGuard region at a set radius (configurable) around where the block is placed. The plugin also allows players to add and remove people to the region, as well as set flags (defined in the config).
</pre>
== 前置要求 ==
{| class="wikitable"
|-
! 插件 !! 版本 !! 需求性
|-
| WorldGuard || 7+ || 必须
|-
| WorldEdit || 7+ || 必须
|-
| Vault || * || 可选(没有的话无法使用经济相关系统)
|-
| PlaceholderAPI || * || 可选
|}
== 安装 ==
确保你已经把上面的必须前置安装完之后再进行这一步<br />
下载插件并放到你的plugins文件夹下，运行服务器生成配置文件<br />
添加新的保护石：打开plugins/ProtectionStones/blocks，复制默认保护石文件block1.toml，按照原有格式自行更改，然后保存退出<br />
配置权限：各种默认权限决定玩家创建后默认可以做的事，ProtectionStones采用的是worldguard的保护机制，这意味着起保护作用的是worldguard，所以你可以设置的权限也是worldguard，具体可以参考[https://worldguard.enginehub.org/en/latest/regions/flags/ 这里]<br />
'''★另外，ProtectionStones支持worldguard的flag(权限)相关的拓展'''<br />
原文
<pre>
To install ProtectionStones, make sure youhave the requirements above already installed. You can simply just add theplugin to the plugins folder, and it will generate the default configuration.

Adding new blocks:
To add new protection blocks, go intoplugins/ProtectionStones/blocks, and copy and paste the default block1.tomlfile and rename it (ex. block2.toml). Then, you have to change the"type" and "alias" fields in the new  block config, sincethere cannot be duplicates.

Configuring flags:
Flags allow for customisation of regionbehaviour. ProtectionStones uses WorldGuard flags, meaning that WorldGuard isactually doing the protecting, not ProtectionStones. You can view the list ofWorldGuard flags here.

It is also possible to use other pluginsthat add flags to WorldGuard, such as WorldGuard Extra Flags and use them inProtectionStones.

Permissions:
The permission list is on the wiki:https://github.com/espidev/ProtectionStones/wiki/Permissions. By default, nopermissions are given to players, so you have to add them explicitly. You canalso view the recommended   permissions to give for commands here.

Other Recommendations:
WorldGuard by default prevents hoppers fromgoing between regions. I recommend setting "ignore-hopper-item-move-events"in WorldGuard's config to false to fix this.

If you want to protect against water andlava flow, you can set "high-frequency-flags" and"protect-against-liquid-flow" to true in WorldGuard's config.

WorldGuard config: https://worldguard.readthedocs.io/en/latest/config/

Default Config Files:
Wiki:https://github.com/espidev/ProtectionStones/wiki/Configuration

Translated Versions of messages.yml:
Interested in having the plugin messages ina different language? Users have contributed translated versions of themessages.yml file. Contact me if you want to supply a messages.yml file in adifferent language!
https://github.com/espidev/ProtectionStones/wiki/Translated-messages.yml
</pre>
== 指令大全 ==
=== 普通指令 ===
{| class="wikitable"
|-
! 指令 !! 权限 !! 描述
|-
| <nowiki>ps get [block]</nowiki>	|| protectionstones.get	|| 获得一个保护石(扣除金币，需要设置)
|-
| <nowiki>ps give [block] [player]</nowiki>	|| protectionstones.give || 给与一个保护石(不扣除金币)
|-
| <nowiki>ps info [members|owners|flags]</nowiki>	|| protectionstones.info || 查看当前领地成员| 所有者| 权限
|-
| <nowiki>ps add|remove [playername]</nowiki>	|| protectionstones.members	|| 增加/删除一位成员
|-
| <nowiki>ps addowner|removeowner [playername]</nowiki>	|| protectionstones.owners || 增加/删除一位所有者
|-
| <nowiki>ps flag [flag] [value|null|default]</nowiki>	|| protectionstones.flags || 设为领地权限
|-
| <nowiki>ps rent  [lease|rent|stopleasing|stoprenting]</nowiki>	|| protectionstones.rent || 租赁/出租/停止租赁/停止出租
|-
| ps tax	|| protectionstones.tax	|| 税收相关指令
|-
| ps buy	|| protectionstones.buysell	|| 购买你所在的领地
|-
| <nowiki>ps sell [price|stop]</nowiki>	|| protectionstones.buysell	|| 出售你所在的领地并设定价格/停止出售领地
|-
| ps hide	|| protectionstones.hide || 隐藏保护石
|-
| ps unhide	|| protectionstones.unhide || 取消隐藏保护石
|-
| <nowiki>ps setparent [region|none]</nowiki>	|| protectionstones.setparent || 为当前区域设置父级，不懂查[https://worldguard.enginehub.org/en/latest/regions/priorities/ 这里]
|-
| <nowiki>ps name [name|none]</nowiki>	|| protectionstones.name || 为领地设置名称/取消名称
|-
| <nowiki>ps home [name|id (可选)]</nowiki>	|| protectionstones.home || 传送回领地
|-
| ps sethome	|| protectionstones.sethome	|| 设置领地家传送地点
|-
| <nowiki>ps tp [id| player] [num (optional)]</nowiki>	|| protectionstones.tp || 传送到某个领地/某个玩家的领地
|-
| ps toggle	|| protectionstones.toggle || 开启/关闭保护石放置提示信息
|-
| ps view	|| protectionstones.view || 开启/关闭保护石放置提示信息
|-
| ps unclaim	|| protectionstones.unclaim	|| 放弃/删除领地
|-
| <nowiki>ps priority [number|null]</nowiki>	|| protectionstones.priority || 设置领地优先级
|-
| <nowiki>ps region [list|remove|disown] [player]</nowiki>	|| protectionstones.region || '''管理指令，不建议给玩家'''使用指令查询或者编辑其他玩家或者自己领地的相关信息
|-
| <nowiki>ps list [playername (optional)]</nowiki>	|| protectionstones.list || 列出你/其他玩家所拥有的的领地
|-
| <nowiki>ps count [playername (optional)]</nowiki>	|| protectionstones.count || 列出你/其他玩家所拥有的的领地数量
|-
| ps merge	|| protectionstones.merge || 与邻近领地合并
|}


=== 管理员指令 ===
{| class="wikitable"
|-
! 指令 !! 权限 !! 描述
|-
| ps admin help	|| protectionstones.admin || 查看管理帮助菜单
|-
| ps admin version	|| protectionstones.admin || 查看插件当前版本
|-
| <nowiki>ps admin hide|unhide</nowiki>	|| protectionstones.admin || 隐藏| 取消隐藏当前世界所有保护石
|-
| ps admin cleanup remove <nowiki>[days] [world  (console)]</nowiki>	|| protectionstones.admin || 清理掉长期不上线玩家的领地(天数自定义)以及没有所有人的领地
|-
| ps admin cleanup disown <nowiki>[days] [world  (console)]</nowiki>	|| protectionstones.admin || 清理掉长期不上线玩家的领地(天数自定义)
|-
| <nowiki>ps admin flag [world] [flag] [value|null|default]</nowiki>	|| protectionstones.admin || 给当前世界上所有领地设置权限
|-
| <nowiki>ps admin lastlogon [player]</nowiki>	|| protectionstones.admin || 获取玩家上次登陆时间
|-
| ps admin lastlogons	|| protectionstones.admin || 列出所有玩家最后一次登录的信息
|-
| <nowiki>ps admin stats [player (optional)]</nowiki>	|| protectionstones.admin || 显示插件统计数据
|-
| ps admin recreate	|| protectionstones.admin || 重新创建所有领地(用于配置文件更改时)
|-
| ps admin settaxautopayers	|| protectionstones.admin || 为所有没有税收的领地增加自动收税系统
|-
| <nowiki>ps admin forcemerge [world]</nowiki>	|| protectionstones.admin || 对某个世界上所有重叠的为同一所有者的领地进行合并
|-
| <nowiki>ps admin changeblock [world]  [fromblockalias] [toblockalias]</nowiki>	|| protectionstones.admin || 将某个世界某种保护石更换为另一种保护石
|-
| ps admin fixregions	|| protectionstones.admin || 使用此指令修复当前世界所有错误的领地，在出错的时候很有用
|-
| ps reload	|| protectionstones.admin || 重载插件配置文件
|}

== 权限 ==
'''本插件没有默认权限，需要手动给予，各位服主参考下面自行斟酌是否给予权限'''
{| class="wikitable"
|-
! 权限 !! 描述 !! 是否推荐给玩家
|-
| protectionstones.create || 允许玩家创建领地 || 是
|-
| protectionstones.destroy || 允许玩家删除领地(会删除保护石) || 是
|-
| protectionstones.merge || 允许玩家合并领地 || 是
|-
| protectionstones.unclaim || 允许玩家取消领地(会保留保护石) || 是
|-
| protectionstones.view || 允许玩家使用/ps view || 是
|-
| protectionstones.info || 允许玩家使用/ps info || 是
|-
| protectionstones.info.others || 允许玩家在其他玩家的领地使用/ps info || 否
|-
| protectionstones.get || 允许玩家使用/ps get. || 否，除非你已经设置了价格
|-
| protectionstones.give || 允许玩家使用/ps give (以管理员权限给予保护石). || 否
|-
| protectionstones.count || 允许玩家使用/ps count. || 是
|-
| protectionstones.count.others || 允许玩家使用/ps count [player]. || 是
|-
| protectionstones.list || 允许玩家使用/ps list. || 是
|-
| protectionstones.list.others || 允许玩家使用/ps list [player] || 否
|-
| protectionstones.hide || 允许玩家隐藏保护石 || 是
|-
| protectionstones.unhide || 允许玩家取消隐藏保护石 || 是
|-
| protectionstones.setparent || 允许玩家使用/ps setparent || 是
|-
| protectionstones.setparent.others || 允许玩家对其他玩家领地使用/ps setparent || 否
|-
| protectionstones.name || 允许玩家使用/ps name || 是
|-
| protectionstones.home || 允许玩家使用/ps home || 是
|-
| protectionstones.sethome || 允许玩家使用/ps sethome || 是
|-
| protectionstones.tp || 允许玩家使用/ps tp || 否
|-
| protectionstones.tp.bypasswait || 允许玩家使用/ps home以及/ps tp时无视等待时间 || 否
|-
| protectionstones.tp.bypassprevent || 无视配置文件的设置: prevent_teleport_in || 否
|-
| protectionstones.priority || 允许玩家设置领地优先级 || 否
|-
| protectionstones.owners || 允许玩家增加/删除所有者(允许玩家使用/ps info owners) || 是
|-
| protectionstones.members || 允许玩家增加/删除成员(允许玩家使用/ps info members) || 是
|-
| protectionstones.flags || 允许玩家设置领地权限 || 是
|-
| protectionstones.flags.edit.[flag] || 设置为false时禁止掉玩家对某个特定权限的设定权限(例: protectionstones.flags.edit.tnt)以便禁止玩家修改某项设定(此项权限会覆盖 allowed_flags 的设定) || 自行斟酌
|-
| protectionstones.buysell || 允许玩家使用 /ps buy 以及 /ps sell. || 是
|-
| protectionstones.tax || 允许玩家使用/ps tax || 是
|-
| protectionstones.rent || 允许玩家使用/ps rent || 是
|-
| protectionstones.toggle || 允许玩家切换保护石提示信息 || 否
|-
| protectionstones.region || 允许玩家使用/ps region || 否
|-
| protectionstones.adjacent.x || 设置玩家最大可拥有的不相邻领地数目(此项设置要求regions_must_be_adjacent为true) -1表示无限个 || 自行斟酌
|-
| protectionstones.admin || 允许使用/ps admin 以及/ps reload || 否
|-
| protectionstones.limit.x || 设置玩家最大可以拥有的领地数量，x只能是整数，如果不想限制，就不要给予这类权限 || 自行斟酌
|-
| protectionstones.limit.alias.x || 设置玩家最多可以自定义多少个领地的别名，x只能是整数，如果不想限制，就不要给予这类权限 || 自行斟酌
|-
| protectionstones.superowner || 允许玩家覆盖所有者权限，设置成自己的领地(类似setowner作用) || 否
|}
== 变量 ==
=== 引用 ===
一共有两种引用领地的方法
<pre>
%protectionstones_currentregion_...% - 当前玩家所在领地
%protectionstones_region_[identifier]_...% - 通过名称/ID搜索到的领地
</pre>

下面是'''...'''部分可以填入的参数

{| class="wikitable"
|-
! 参数 !! 描述
|-
| owners || List of owners, separated by comma and space.
|-
| members || List of members, separated by comma and space.
|-
| name || The name of the region, or the id if there isn't one  set.
|-
| id || The id of the region.
|-
| type || The block type of the region.
|-
| alias || The region's alias type.
|-
| is_hidden || Whether or not the protection block is hidden.
|-
| home_location || The location of the region's home.
|-
| is_for_sale || Whether or not the region is for sale.
|-
| rent_stage || The rent stage of the region.
|-
| landlord || The region's landlord if it is being rented out.
|-
| rent_period || The period for rent payments.
|-
| rent_amount || The amount tenants pay per rent period.
|-
| sale_price || The price as to which the region is on sale for.
|-
| tax_owed || How much tax is unpaid for this region.
|-
| tax_autopayer || The region's configured autopayer.
|-
| flags || The list of flags of the region.
|-
| <nowiki>flags_[flag]</nowiki> || <nowiki>Where [flag] is the name of the flag you want to get  the value of.</nowiki>
|}

=== PAPI变量 ===
据作者所说，所有配置都可以显示为PAPI变量，引用他们的办法就是在通用引用变量后面加上这个部分的参数。
比如说你要引用某种保护石的价格，那就就是%protectionstones_config_block_[alias]_block_data_price%。
alias指保护石的名称，格式基本相同，举一反三即可。
=== 全局配置变量 ===
引用方法:
<pre>
%protectionstones_config_...%
</pre>
特殊格式变量:
<pre>
%protectionstones_config_economy_max_rent_period_pretty%
%protectionstones_config_economy_min_rent_period_pretty%
</pre>
=== 保护石配置变量 ===
引用方法:
<pre>
%protectionstones_config_block_[alias]_...%
%protectionstones_currentregion_config_...%
%protectionstones_region_[identifier]_config_...%
</pre>
可以填入的参数:
<pre>
economy_tax_period_pretty
economy_tax_payment_time_pretty
</pre>
=== 玩家变量 ===
引用方法:
<pre>
%protectionstones_currentplayer_...%
</pre>
可以填入的参数
<pre>
global_region_limit	当前玩家所在领地最大人数，-1表示无限制
region_limit_[alias]	特定类型保护块的最大限制 (用保护石名称替换[alias])
</pre>

== 配置文件 ==
=== config.toml ===
(对于版本''2.7.0-2020.4.