Minecraft插件百科 - 用户贡献 [zh-cn]

UhcCore

2020-05-19T14:26:41Z

Stydxm：情境列表

= '''欢迎来到UhcCore Wiki！''' =

[[文件:UHC-core.png|UHC-core]]

<blockquote>原wiki地址：[https://github.com/Mezy/UhcCore/wiki https://github.com/Mezy/UhcCore/wiki]
</blockquote>

== 概述 ==

UhcCore是一个支持 1.8 - 1.15 的bukkit插件。它让您可以在专门的服务器上自动进行Ultra Hardcore游戏它是高度可配置的，并且有许多有趣的场景可供选择（完整列表可在此处找到）。该Wiki的目的是提供有关此插件使用的文档。一些主要功能包括：

* 使用GUI轻松地创建团队（无需使用命令）
* 开始指令，你可以使用 /start 强制开始游戏（需要指令 uhc-core.commands.start）
* 20多种场景和投票系统
* 可配置的团队上限 / limits / auto-start
* 定制插件（权限支持）
* 自定合成（权限支持）
* 支持保存游戏
* 金色头颅（译者注：不清楚什么意思）
* 存档选择：随机或从列表中选择随机种子或复制您指定的世界
* 预生成世界避免生成滞后
* 可配置的世界边界和边界缩小速度
* 启用了下界，并且仅比主世界小两倍，而不是Minecraft的默认值8
* 带有配置的计分板
* 开始时随机队伍传送
* 自动重新开始功能（spigot）并支持bungee，可最终将玩家引导到大厅
* 可以选择在快速模式下进行（= uhc run / speeduhc）
* 开发者API
* 还有更多（阅读配置以查看所有功能）...

如果您在阅读此Wiki之后还有其他疑问，随时可以[https://discord.gg/fDCaKMX 在这里]加入我们的discord

== 自动重新开始游戏 ==

为了开始新游戏，需要重新启动服务器，您可以使其自动化。最好的方法取决于您的设置。

=== 主机是在您的电脑或特定的服务器 ===

插件使用spigot的/restart 命令来重启服务器。为了使此命令起作用，您需要在spigot.yml中配置启动脚本。

=== 使用有控制面板的Minecraft主机 ===

使用/restart 命令运行脚本很有可能是不被允许的。因此，“重新启动”的唯一方法是使用崩溃重启。插件会关闭您的服务器。您的控制面板认为它“崩溃”了，然后会自动重启。如果你的服务商使用Multicraft那么它是默认被打开的。如果不是的话您也许可以自己开启它，如果不行，那么您需要联系您的服务商帮您开启如果您的主机商不使用Multicraft，请与您的主机商联系。

== 命令列表 ==

{|
!align="center"| 命令
! 介绍
!align="center"| 权限
|-
|align="center"| /uhccore reload
| 该命令用于重载配置文件。
|align="center"| uhc-core.commands.reload
|-
|align="center"| /uhccore update
| 该命令用于更新插件到最新版本。
|align="center"| uhc-core.commands.update
|-
|align="center"| /uhccore version
| 该命令用于查看插件版本。
|align="center"| -
|-
|align="center"| /chat
| 该命令用于切换全服和团队聊天。
|align="center"| -
|-
|align="center"| /teleport <player>
| 该命令可以被所有处于旁观者模式的玩家使用。
|align="center"| 默认对所有旁观者开启。（关闭时需要权限 'uhc-core.commands.teleport-admin'）
|-
|align="center"| /teleport <x> <y> <z>
| 该命令用于传送到参数中的坐标。 (如果你想使用原版的 /tp 指令，请使用 '/minecraft:tp')
|align="center"| uhc-core.commands.teleport-admin
|-
|align="center"| /spectate
| 你可以使用这个命令切换到观众模式，当在观众模式中，您会在游戏开始时自动进入旁观者模式。
|align="center"| uhc-core.commands.spectate
|-
|align="center"| /start
| 该命令用于强制开始游戏。
|align="center"| uhc-core.commands.start
|-
|align="center"| /scenarios
| 该命令用于查看活动或编辑场景。
|align="center"| uhc-core.scenarios.edit （编辑时需要）
|-
|align="center"| /teaminventory
| 启用分队时可以使用此命令。
|align="center"| -
|-
|align="center"| /hub
| 改命令可用于回到bungeecord大厅服。（当开启时）
|align="center"| -
|-
|align="center"| /iteminfo
| 此命令可用于生成插件的配置文件中使用的项目json或合成表。
|align="center"| uhc-core.commands.iteminfo
|-
|align="center"| /upload <file>
| 此命令可用于将配置文件上传到haste bin，当您寻求支持时，可能会要求您这样做。
|align="center"| uhc-core.commands.iteminfo
|-
|align="center"| /revive <player> [clear]
| 该命令用于复活死亡的玩家。您可以把clear作为第二个参数来使玩家复活，但清空他们的背包。
|align="center"| uhc-core.commands.revive
|-
|align="center"| /crafts
| 该命令可用于查询或创建自定义合成表。
|align="center"| uhc-core.commands.crafts.create (只在创建自定义合成表时需要)
|-
|align="center"| /top
| 该命令可以让玩家传送到他们头上的最高的方块。
|align="center"| uhc-core.commands.top
|-
|align="center"| /deathmatch start
| 该命令可以强制开始死亡竞赛。
|align="center"| uhc-core.commands.deathmatch
|}

== FAQ ==

=== 如何强制开始游戏？ ===

您可以使用 /start 指令来强制开始游戏。该命令需要的权限为 uhc-core.commands.start。

=== 我怎么加入本地大厅？ ===

您可以把自定义大厅用worldedit转换为schemetic格式，并命名为lobby，放在 plugins/UhcCore/ 。

=== 我怎么改变大厅出生点？ ===

大厅的出生点是您在worldedit中复制大厅的位置。要更改它，请选中大厅，站在想要作为出生点的方块上，输入 //copy, 然后用 //schem 保存schemetic文件并把文件从 plugins/Worldedit/schemetics/ 移动到 plugins/UhcCore/

=== 为什么我的服务器在启动后滞后？ ===

首先检查是不是真的是您的服务器滞后。为此，请输入 /tps，如果第一个数字是黄色或者红色的，而且游戏并没有开始，一个解决这个问题的方法是（这个问题可能是存档损坏引起的，比如从1.14切换到1.13）：

# 关闭您的服务器。
# 删除存档文件（名为<code>UUID</code>，<code>world</code>，<code>world_nether</code>，<code>world_the_end</code>的文件夹）。
# 您现在可以重新打开服务器并让所有东西加载

<blockquote>译者注：该操作会__使你的存档丢失！__
</blockquote>
=== 配置文件重载后没有更改或出错？ ===

这可能是您的配置文件问题，复制你的配置文件并粘贴到这个网站上来找到语法错误[https://yamlchecker.com/ https://yamlchecker.com/]

=== 我加载了一个插件或合成表，但是它没有在菜单上出现？ ===

如果上面的问题没有解决这个问题，那么这可能是插件或合成表的语法错误。打开你的<code>latest.log</code>文件（你也可以通过使用/upload log来做这个）然后找到你的插件或合成表的名字。

== 最初设定 ==

=== 启动并运行插件 ===

好的，那么你已经从 [https://www.spigotmc.org/resources/uhccore-automated-uhc-for-minecraft-1-8-8-1-15.47572/ spigot] 或 [https://github.com/Mezy/UhcCore/releases releases]下载了插件，而且现在你想要安装这个插件。这很简单，而且在每个版本中方法都是相同的（1.8.8-1.15.x）：

# 把 UhcCore 的 jar 文件放在您的 <code>plugins/</code> 文件夹里然后打开您的服务器
# 一个叫做UhcCore的文件夹应该会被自动创建在路径 <code>plugins/UhcCore</code>. 在这个文件夹里您可以看到一下文件：

* <code>config.yml</code>：常规服务器配置，请阅读整个文件以了解插件的功能。
* <code>crafts.yml</code>：让您可以使用自定义合成表。（可以关闭）
* <code>kits.yml</code>：所有插件。（可以关闭）
* <code>scenarios.yml</code>: 为某些方案配置其他选项。
* <code>lang.yml</code>：配置游戏中的消息和提示。
* <code>scoreboard.yml</code>：配置计分板展示什么。
* <code>storage.yml</code>: 储存插件数据，'''请不要更改这个文件！'''

<ol start="4">
<li>更改任何这些文档时，使用正确的YAML语法很重要。您可以用 [https://yamlchecker.com/ YAML 语法检查器]来检查语法。常见破坏配置的错误包括使用<code>TAB</code>键对齐（只能使用空格）或输入无效的方案名称。</li></ol>

=== 提升服务器性能的方法 ===

UHC是一种需要大量资源的游戏模式，因为整个世界都需要被加载。这是提升性能的方法：

* 如果您在UHC中不需要下界，那么请把它关闭，这会使需要保留的内存中少了一个世界。
* 让你的世界小一点
* 降低您服务器的视距
* 关闭默认的下界和末地。这个插件会加载自己的下界和末地，因此不需要使用默认除非您有需要。您可以在您的 <code>server.properties</code> 中关闭默认的下界，在您的 <code>bukkit.yml</code>中关闭默认的末地。
* 尽管该插件在Bukkit或Spigot服务器上运行良好，但切换到Paper可能会提高性能。

== 情境列表（未翻译） ==

{|
!align="center"| Name
! Description
|-
|align="center"| CutClean
| No furnaces required. Ores and animal drops are automatically smelted. Apple rates are 5%, flint rates are 90% No lapis is needed for enchanting.
|-
|align="center"| Fireless
| You cannot take fire damage.
|-
|align="center"| Bowless
| You are not able to craft bows.
|-
|align="center"| Rodless
| Fishing rods are not craftable.
|-
|align="center"| Shieldless
| Shields are not craftable.
|-
|align="center"| Blood Diamonds
| When mining a diamond ore, the player will take half a heart of damage.
|-
|align="center"| Timber
| Breaking a log of a tree will cause the whole tree to fall down.
|-
|align="center"| Horseless
| You are not able to tame horses/donkeys.
|-
|align="center"| Timebomb
| After killing a player, their loot will drop into a double chest. The chest will explode 30 seconds later.
|-
|align="center"| No-Fall
| Fall damage is off.
|-
|align="center"| BestPvE
| Each player will be added to the "Best PvE List" at the start of the game. While being on the list, you will gain 1 extra heart every 10 minutes. Once a player takes damage, the player will be removed from the list. If you kill a player, you are added back to the list.
|-
|align="center"| Triple Ores
| Ores drop in threes.
|-
|align="center"| Double Ores
| Ores drop in pairs.
|-
|align="center"| Team Inventory
| Each team has an extra inventory that all members from the team can view by using /teaminventory.
|-
|align="center"| No-Clean
| Gives you 30 seconds of invincibility after a kill. Attacking other players will remove this PvP Protection.
|-
|align="center"| Hastey Boys
| Every tool you craft will have Efficiency 3 and Unbreaking 1
|-
|align="center"| Lucky Leaves
| Trees have a 0.5% chance of dropping a Golden Apple.
|-
|align="center"| Bleeding Sweets
| On death a player drops 1 diamond, 5 gold, 1 book, 2 string and 16 arrows
|-
|align="center"| Double Gold
| The original amount of gold will double when mined.
|-
|align="center"| Gold Less
| When gold is mined, it will disappear and is not obtainable.
|-
|align="center"| FlowerPower
| Break flowers to receive items.
|-
|align="center"| Switcheroo
| When you shoot someone, you trade places with them
|-
|align="center"| Vein Miner
| Mining a block while crouched breaks blocks of the same type in a chain reaction Only works when using the correct tool for the block type
|-
|align="center"| DragonRush
| In dragon rush the goal is to kill the dragon. The first team to kill the dragon wins! There is a end portal at x 0, z 0
|-
|align="center"| Love At First Sight
| In this scenario you are not able to choose your teammates through the team selection inventory. Teams are created by clicking on someone in game.
|-
|align="center"| Fast Leaves Decay
| In this scenario after breaking all logs of a tree the leaves will be gone within seconds
|-
|align="center"| Sky High
| In this scenario after 30 minutes you will start taking damage every 30 seconds while not above y=120
|-
|align="center"| Fast Smelting
| In this scenario item smelting is sped up 5 times.
|-
|align="center"| Super Heroes
| Each player will gain a special ability. The powers are speed 1, strength 1, resistance 2, invisibility, 6 extra hearts, and jump boost 4.
|-
|align="center"| Anonymous
| All player names are distorted.
|-
|align="center"| Gone Fishing
| At the beginning of the game, everyone gets a lure 3 luck of the sea 3 rod.
|-
|align="center"| Infinite Enchants
| At the beginning of the game everyone gets 64 enchantment tables, anvils, lapis blocks and a lot of XP.
|-
|align="center"| Children Left Unattended
| When a tea
|}

UhcCore

2020-05-17T14:03:34Z

Stydxm：增加最初设定部分

UhcCore

2020-05-17T13:38:11Z

Stydxm：翻译FAQ部分

Studio讨论:互助客栈

2020-05-17T13:32:15Z

Stydxm：/* 在下面留名 */

{{模板:互助客栈提示}}

{{Comment Title}}

== 插件百科新图标设计意见征求 ==

''百科图标许久未变，初始是为kaho同学所协助编辑，但时至今日，此图标显得并不正式，且未显示出插件百科值特色与理念。

故在此征求大家对新图标的意见。

意见初步统一之后将创建投票，最终全部通过后由指定成员（小组）进行创作。
''
[[用户:Iwar|Re_]]（[[用户讨论:Iwar|讨论]]） 2015年9月2日 (三) 14:19 (HKT)

图标早就有啦 =A=

[[用户:LocusAzzurro|LocusAzzurro]]（[[用户讨论:LocusAzzurro|讨论]]） 2016年9月26日 (一) 02:51 (CST)
== 成员名单贴 ==

因为不知道有多少人在这里...

所以在此留下你的ID...

......

正经点吧

用5级标题写自己的名字

除管理员外请不要删除别人的名字

本人为例

作者seesaw_233 2015-10-16
::可以在[[特殊:贡献得分|这里]]了解下最近活跃的成员 [[用户:Iwar|Re_]]（[[用户讨论:Iwar|讨论]]） 2015年10月25日 (日) 11:10 (HKT)
=== 在下面留名 ===
===== Stydxm =====
===== seesaw_233 =====
===== LocusAzzurro =====
===== Lzs =====
===== Lichi2050 路过看看 =====
===== SYS_TEM =====
===== Leo =====
===== Mecho =====
===== Salt_lovely =====
===== D0048 =====
===== MiaoDaze =====
=====Jeason_Lan=====
===== zythonc =====
[[用户:SYS TEM|SYS TEM]]（[[用户讨论:SYS TEM|讨论]]） 2016年3月25日 (五) 23:09 (CST)

== 凉了？留名！ ==

大哥大姐们别吓唬我啊，这站凉了？

没凉的话来下面留个签名戳呗
----
[[用户:MiaoDaze|MiaoDaze]]（[[用户讨论:MiaoDaze|讨论]]） 2018年9月24日 (一) 18:11 (CST)
----

: 本页面用于成员间沟通正式的百科事务，在此处讨论之意义便是公开与存档，谢绝闲聊。

: [[用户:iwar|iwar]][[用户讨论:iwar|讨论]] 2018年9月25日 (二) 08:41 (CST)

:: Ironically, LK-chan has just left her name here :D --[[用户:Henry5041|Henry5041]]（[[用户讨论:Henry5041|讨论]]） 2018年9月29日 (六) 14:57 (CST)

== 建议 ==

各位插件wiki管理员：

各位好！

我是来自中文wiki的电量233，我有对贵wiki的几个建议要提：

1.主页

拜托各位建立主页的/editcopy，让每位用户都可以编辑主页。

2.模板

关于模板，在插件wiki也是这缺那缺，所以各位可以建立一个页面，专门放从其他wiki盗窃（划掉）借鉴的template。

3.制度

我观察到贵wiki仍没有一个详细、明确的管理制度，希望各位可以盗窃（划掉）借鉴一个管理制度，这样可以免一些杂事。

[[User:电量233|电量233]] [[User talk:电量233|讨论]]•[[Special:%E7%94%A8%E6%88%B7%E8%B4%A1%E7%8C%AE/电量233|贡献]] 2019年3月10日 (日) 07:52 (CST)

: 你好，感谢你的建议，也可以加主群278733923进行讨论。
[[用户:iwar|iwar]][[用户讨论:iwar|讨论]] 2019年3月16日 (六) 19:48 (CST)

: 值得注意的是，Minecraft Wiki采用CC_BY-NC-SA协议，而本wiki采用CC_BY-SA协议，无法从Minecraft Wiki直接复制粘贴模板。--[[用户:Jingkaimori|Jingkaimori]]（[[用户讨论:Jingkaimori|讨论]]） 2020年4月17日 (五) 08:51 (CST)

== 收不到确认电子邮件 ==

试过好几次了，收不到确认电子邮件，导致电子邮件无法确认。--[[用户:SolidBlock|SolidBlock]]（[[用户讨论:SolidBlock|讨论]]） 2020年1月31日 (五) 12:38 (CST)

== 收不到邮件+1 ==

注册以来已经一个多星期了，试了好几次，换了好几个邮箱都不能收到邮件，能否解决一下？

文件:UHC-core.png

2020-05-17T12:06:18Z

Stydxm：图片转换为PNG格式

== 文件说明 ==
图片转换为PNG格式
== 授权协议 ==
本图片来自于Minecraft，版权归Mojang AB所有。

UhcCore

2020-05-17T11:59:45Z

Stydxm：修改图片链接

UhcCore

2020-05-17T11:44:47Z

Stydxm：加入对于命令的介绍

= '''欢迎来到UhcCore Wiki！''' =

[[文件:UHC-core.webp|UHC-core]]

<blockquote>原wiki地址：[https://github.com/Mezy/UhcCore/wiki https://github.com/Mezy/UhcCore/wiki]
</blockquote>

== 概述 ==

UhcCore是一个支持 1.8 - 1.15 的bukkit插件。它让您可以在专门的服务器上自动进行Ultra Hardcore游戏它是高度可配置的，并且有许多有趣的场景可供选择（完整列表可在此处找到）。该Wiki的目的是提供有关此插件使用的文档。一些主要功能包括：

* 使用GUI轻松地创建团队（无需使用命令）
* 开始指令，你可以使用 /start 强制开始游戏（需要指令 uhc-core.commands.start）
* 20多种场景和投票系统
* 可配置的团队上限 / limits / auto-start
* 定制插件（权限支持）
* 自定合成（权限支持）
* 支持保存游戏
* 金色头颅（译者注：不清楚什么意思）
* 存档选择：随机或从列表中选择随机种子或复制您指定的世界
* 预生成世界避免生成滞后
* 可配置的世界边界和边界缩小速度
* 启用了下界，并且仅比主世界小两倍，而不是Minecraft的默认值8
* 带有配置的计分板
* 开始时随机队伍传送
* 自动重新开始功能（spigot）并支持bungee，可最终将玩家引导到大厅
* 可以选择在快速模式下进行（= uhc run / speeduhc）
* 开发者API
* 还有更多（阅读配置以查看所有功能）...

如果您在阅读此Wiki之后还有其他疑问，随时可以[https://discord.gg/fDCaKMX 在这里]加入我们的discord

== 自动重新开始游戏 ==

为了开始新游戏，需要重新启动服务器，您可以使其自动化。最好的方法取决于您的设置。

=== 主机是在您的电脑或特定的服务器 ===

插件使用spigot的/restart 命令来重启服务器。为了使此命令起作用，您需要在spigot.yml中配置启动脚本。

=== 使用有控制面板的Minecraft主机 ===

使用/restart 命令运行脚本很有可能是不被允许的。因此，“重新启动”的唯一方法是使用崩溃重启。插件会关闭您的服务器。您的控制面板认为它“崩溃”了，然后会自动重启。如果你的服务商使用Multicraft那么它是默认被打开的。如果不是的话您也许可以自己开启它，如果不行，那么您需要联系您的服务商帮您开启如果您的主机商不使用Multicraft，请与您的主机商联系。

== 命令列表 ==

{|
!align="center"| 命令
! 介绍
!align="center"| 权限
|-
|align="center"| /uhccore reload
| 该命令用于重载配置文件。
|align="center"| uhc-core.commands.reload
|-
|align="center"| /uhccore update
| 该命令用于更新插件到最新版本。
|align="center"| uhc-core.commands.update
|-
|align="center"| /uhccore version
| 该命令用于查看插件版本。
|align="center"| -
|-
|align="center"| /chat
| 该命令用于切换全服和团队聊天。
|align="center"| -
|-
|align="center"| /teleport <player>
| 该命令可以被所有处于旁观者模式的玩家使用。
|align="center"| 默认对所有旁观者开启。（关闭时需要权限 'uhc-core.commands.teleport-admin'）
|-
|align="center"| /teleport <x> <y> <z>
| 该命令用于传送到参数中的坐标。 (如果你想使用原版的 /tp 指令，请使用 '/minecraft:tp')
|align="center"| uhc-core.commands.teleport-admin
|-
|align="center"| /spectate
| 你可以使用这个命令切换到观众模式，当在观众模式中，您会在游戏开始时自动进入旁观者模式。
|align="center"| uhc-core.commands.spectate
|-
|align="center"| /start
| 该命令用于强制开始游戏。
|align="center"| uhc-core.commands.start
|-
|align="center"| /scenarios
| 该命令用于查看活动或编辑场景。
|align="center"| uhc-core.scenarios.edit （编辑时需要）
|-
|align="center"| /teaminventory
| 启用分队时可以使用此命令。
|align="center"| -
|-
|align="center"| /hub
| 改命令可用于回到bungeecord大厅服。（当开启时）
|align="center"| -
|-
|align="center"| /iteminfo
| 此命令可用于生成插件的配置文件中使用的项目json或合成表。
|align="center"| uhc-core.commands.iteminfo
|-
|align="center"| /upload <file>
| 此命令可用于将配置文件上传到haste bin，当您寻求支持时，可能会要求您这样做。
|align="center"| uhc-core.commands.iteminfo
|-
|align="center"| /revive <player> [clear]
| 该命令用于复活死亡的玩家。您可以把clear作为第二个参数来使玩家复活，但清空他们的背包。
|align="center"| uhc-core.commands.revive
|-
|align="center"| /crafts
| 该命令可用于查询或创建自定义合成表。
|align="center"| uhc-core.commands.crafts.create (只在创建自定义合成表时需要)
|-
|align="center"| /top
| 该命令可以让玩家传送到他们头上的最高的方块。
|align="center"| uhc-core.commands.top
|-
|align="center"| /deathmatch start
| 该命令可以强制开始死亡竞赛。
|align="center"| uhc-core.commands.deathmatch
|}

UhcCore

2020-05-17T10:48:22Z

Stydxm：翻译第自动重启部分

UhcCore

2020-05-17T10:30:27Z

Stydxm：创建UhcCore页面

文件:UHC-core.webp

2020-05-17T10:28:24Z

Stydxm：

用户:Stydxm

2020-05-10T13:32:11Z

Stydxm：创建关于我的个人页面

会很多编程语言，但一门都不精通，努力学习各种框架中

github:[https://github.com/stydxm stydxm]

Residence

2020-05-10T13:18:27Z

Stydxm：因链接无法显示，取消链接改为文字

Residence是大多数服务器都会使用的插件，它不同于其他保护类插件，它可以让玩家自己保护自己的家园，无需再麻烦管理员。新版的Residence更是增添了许多新特性，为服主减轻了不少负担。

注：旧版本的Residence已不再支持1.8以上的Minecraft服务器，本页面仅适用于新版本。<blockquote></blockquote>
[[文件:Residence logo.jpg|有框|右]]
==特性==

* 领地选区可视化操作。选择领地区域时，会以粒子效果显示所选区域。（此特性仅支持1.8版本以上的服务器）
* 领地权限设置GUI操作。设置权限时，不必再逐条输入指令，只需打开GUI界面，即可轻松设置领地权限。
* 领地帮助列表可点击。帮助列表中的指令、翻页按钮都可以用鼠标直接点击，无需手动输入。（此特性仅支持1.8版本以上的服务器）
* 丰富的领地内聊天系统。服主可自行设置聊天前缀和颜色。
* 领地区域可扩展。当建筑面积扩大时，无需删除领地重新创建，可在原有领地基础上扩展。
* 领地租赁/出售系统。玩家可以自行出租/租借/出售/购买领地。
* 集成领地木牌系统。不必安装额外插件，便可以使用木牌轻松交易领地。
* 可设置当玩家一段时间不上线后自动删除其领地。
* 可在某个世界不使用领地插件。
* 可在全图随机传送。
* 支持多世界插件。

== 支持版本 ==
Residence插件支持'''1.7.10/1.8/1.9/1.10/1.11/1.12'''版本

完全支持'''Bukkit/Spigot/PaperSpigot'''服务端

==安装与配置==
===安装===
将下载的领地插件放入plugins文件夹，运行服务器以生成必要的文件。 保持默认的设置即可正常使用，无需手动添加权限，若要修改设置请参见下方的配置文件说明。
===配置文件说明===
注：配置文件的翻译工作进行中
====config.yml====
<syntaxhighlight lang="yaml">
Global:
# 语言设置，国人一般喜欢设为Chinese
Language: English
# 领地选区工具，默认是木棍（280）
SelectionToolId: 280
# 领地信息查看工具，默认是线（287）
InfoToolId: 287
# 玩家位置移动检测间隔，单位为毫秒
# 减小将加大服务器负担
# 增大会减慢对玩家错误移动反应的时间
MoveCheckInterval: 500
# 领地保存的周期，单位为分钟
SaveInterval: 10
# 当无法调用或没有使用Permissions插件时默认使用的组
DefaultGroup: default
# 是否启用领地租赁(Lease)系统
UseLeaseSystem: false
# 领地租赁系统的检测周期，单位为分钟
LeaseCheckInterval: 10
# 在玩家的钱充足时，自动续期租赁的领地；如果经济系统关闭，此设置项无效
LeaseAutoRenew: true
# 是否使用Permissions插件来管控领地的权限
EnablePermissions: true
# 若未使用 Permissions 或 PermissionsBukkit 插件，请设置为true
LegacyPermissions: false
# 开启/关闭领地经济系统 (支持iConomy, MineConomy, Essentials, BOSEconomy, RealEconomy).
EnableEconomy: true
# 是否开启领地租借(Rent)系统（关于Rent和上文Lease的区别，望了解者加以修改完善）
EnableRentSystem: false
# 领地租借到期时间的检测周期，单位为分钟
RentCheckInterval: 10
# 是否开启领地聊天频道
ResidenceChatEnable: true
# 是否使用ActionBar（低于1.8版本请设为false）
UseActionBar: true
# 领地聊天频道的字体颜色
ResidenceChatColor: DARK_PURPLE
# 是否只允许OP修改领地
AdminOnlyCommands: false
# 是否将OP设为领地插件的管理员
AdminOPs: true
# 填入服务器所使用的多世界插件（Multiverse-Core或Multiworld），若使用多世界插件，请务必填写！
MultiWorldPlugin: Multiverse-Core
# 是否让子领地继承领地的权限设置
ResidenceFlagsInherit: true
# 是否阻止领地的租借者修改领地的设置
PreventRentModify: true
# 是否在检测到领地文件出现错误时停止加载插件
StopOnSaveFault: true
# 允许的领地名字限制，使用正则表达式
ResidenceNameRegex: '[^a-zA-Z0-9\\-\\_]'
# 若设为true，则每当插件检测租赁（Lease）或租借（Rent）时便向控制台输出一条消息
ShowIntervalMessages: false
# 是否在服务器开启时检查插件版本
VersionCheck: true
# Experimental - The following settings are lists of block IDs to be used as part of the checks for the "container" and "use" flags when using mods.
CustomContainers: []
CustomBothClick: []
CustomRightClick: []

</syntaxhighlight>

====groups.yml====
<syntaxhighlight lang="yaml">
Groups:
Default: #组名，不要删除这个组
#删除下面的井号可将此配置应用到其他组
#Mirror:
#- 'group1'
#- 'group2'
Residence:
# 该组玩家是否可以创建领地
CanCreate: true
# 玩家可以拥有的最大领地数量
MaxResidences: 3
# 领地可包含的最大物理区域
MaxAreasPerResidence: 2
# 领地最大格数（东西方向）
MaxEastWest: 16
# 领地最小格数（东西方向），设为-1则不限制
MinEastWest: 3
# 领地最大格数（南北方向）
MaxNorthSouth: 16
# 领地最小格数（南北方向）
MinNorthSouth: 3
# 领地最大格数（高度）
MaxUpDown: 256
# 领地最小格数（高度），设为-1则不限制
MinUpDown: 3
# 可创建领地的最小高度
MinHeight: 0
# 可创建领地的最大高度
MaxHeight: 255
# 所在区域可拥有的最大子领地数量
MaxSubzonesInArea: 3
# 最大子领地深度
# 一个领地中的子领地中的子领地深度为2
# 设为0以禁用子领地
# 译者注：子领地深度即子领地嵌套的层数，子领地的子领地深度为2，以此类推
SubzoneDepth: 3
# （可选）子领地最大格数（东西方向）
SubzoneMaxEastWest: 16
# （可选）子领地最小格数（东西方向）
SubzoneMinEastWest: 3
# （可选）子领地最大格数（南北方向）
SubzoneMaxNorthSouth: 16
# （可选）子领地最小格数（南北方向）
SubzoneMinNorthSouth: 3
# （可选）子领地最大格数（高度）
SubzoneMaxUpDown: 256
# （可选）子领地最霄格数（高度）
SubzoneMinUpDown: 3
# 是否允许领地传送
CanTeleport: true
# 允许或禁止使用/ res unstuck使你在被困住的时候离开领地
Unstuck: true
# 允许或禁止使用/res kick把玩家从领地踢出
Kick: False
# 允许或禁止使用/res select命令，如果禁止则玩家只能使用圈地工具来选择选区
#译者注：建议禁用，原因见此：http://mineplugin.org/Residence#.E5.88.A9.E7.94.A8.2Fres_select_shift.E5.91.BD.E4.BB.A4.E5.B0.86.E9.A2.86.E5.9C.B0.E9.80.89.E5.8C.BA.E7.A7.BB.E8.87.B3.E6.97.A0.E9.99.90.E8.BF.9C.E5.AF.BC.E8.87.B4.E6.9C.8D.E5.8A.A1.E5.99.A8.E5.B4.A9.E6.BA.83
SelectCommandAccess: true
# Allow or Disallow the group to access the Blacklist/Ignorelist for residences they own.
ItemListAccess: true
# Options relating to enter and leave messages on the residence.
Messaging:
# Whether or not the player can change the Residence enter and leave messages.
CanChange: true
# The default enter message to apply to new Residences created by players in this group.
# Leaving the message blank will disable it.
DefaultEnter: Welcome %player to %residence, owned by %owner.
# The default leave message to apply to new Residences created by players in this group.
# Leaving the message blank will disable it.
DefaultLeave: Now leaving %residence.
# Options relating to the Lease system.
Lease:
# The maximum number of days to allow leases.
MaxDays: 16
# The number of days to add to the lease following a '/res lease renew' command.
RenewIncrement: 14
#Options related to the rent system
Rent:
#determines how many residences can be rented by players of this group at once
MaxRents: 3
#determines how many residences can be set for rent by players of this group at once
MaxRentables: 3
# determines max days player can rent residence at once
MaxRentDays: 31
# Options relating to the Residence Economy.
Economy:
# Whether or not players in this group can buy other Residences that are for sale.
CanBuy: true
# Whether or not players in this group can sell their Residences.
CanSell: false
# Whether or not to ignore the Residence size/count limits when buying a residence.
IgnoreLimits: false
# The cost, per block, of making a new Residence or adding a area to it.
BuyCost: 0.5
# The cost, per block, player will be getting back when removing residence.
SellCost: 0.25
# The cost, per block, of renewing a Residence lease (if the lease system is enabled).
RenewCost: 0.2
# Flags are checked in the order:
# 1: Player
# 2: Group
# 3: Owner
# 4: If all others are undefined, reverts to default value (usually true).
# Flag permissions default to false.
# These flags settings override the globals.
Flags:
# Specifically allow or deny this group from changing certain flags.
Permission:
#build: true
# Specifys the flags that are applied at residence creation for players of this group.
Default:
#build: true
# Specifys the flags that are applied at to the creator at residence creation.
CreatorDefault:
#build: true
# Specifys the flags that are applied to other groups for this residence, at creation.
GroupDefault:
#default: #group name
#build: false
#these flags are applied specifically to this group whenever they are outside a residence
#these flags will override the flags at the top, under the Global section.
World:
Global: #these flags will apply to all worlds
#build: false
WorldNameHere: #or you can apply them by each individual world
#build: false
NextGroup: #group name, player should have residence.group.nextgroup permission node to have access to this residence group
Residence:
CanCreate: true
MaxResidences: 4
MaxAreasPerResidence: 2
MaxEastWest: 20
MaxNorthSouth: 20
MaxUpDown: 20
MinHeight: 0
MaxHeight: 255
SubzoneDepth: 3
CanTeleport: true
Unstuck: true
Kick: true
SelectCommandAccess: true
ItemListAccess: true
Messaging:
CanChange: true
DefaultEnter: Welcome %player to %residence, owned by %owner.
DefaultLeave: Now leaving %residence.
Lease:
MaxDays: 16
RenewIncrement: 14
Rent:
MaxRents: 3
MaxRentables: 3
MaxRentDays: 31
Economy:
CanBuy: true
CanSell: false
IgnoreLimits: false
BuyCost: 0.7
SellCost: 0.3
RenewCost: 0.3

# You can manually specify the group a player is in below, this overrides their permissions group.
GroupAssignments:
bekvon: default
player: default
</syntaxhighlight>

====flags.yml====
<syntaxhighlight lang="yaml">
#These are Global Settings for Residence.
Global:
# These are world flags that are applied when the player is NOT within a residence.
Flags:
Global: #these are default for all worlds unless specified below, they can be overridden per group
use: true
build: true
ignite: true
firespread: true
damage: true
creeper: true
tnt: true
pvp: true
WorldNameHere: #here you can set flags for individual worlds, these override Global
#build: true
# This gives permission to change certain flags to all groups, unless specifically denied to the group.
FlagPermission:
move: true
build: true
place: true
destroy: true
use: true
container: true
pvp: true
tp: true
ignite: true
firespread: true
flow: true
lavaflow: true
waterflow: true
creeper: true
tnt: true
monsters: true
animals: true
animalkilling: true
mobkilling: true
vehicledestroy: true
trade: true
shear: true
leash: true
nofly: false
subzone: true
healing: true
piston: true
diode: true
lever: true
button: true
door: true
table: true
enchant: true
brew: true
bed: true
cake: true
note: true
trample: true
burn: true
explode: true
fireball: true
command: false
day: true
night: true
chat: true
hidden: false
overridepvp: false
keepinv: false
keepexp: false
shop: true
bank: false
# This sets GUI items to represent each flag, if not given, then gray wool will be used
FlagGui:
animalkilling:
Id: 365
Data: 0
animals:
Id: 383
Data: 90
bed:
Id: 355
Data: 0
brew:
Id: 379
Data: 0
build:
Id: 45
Data: 0
burn:
Id: 50
Data: 0
button:
Id: 143
Data: 0
cake:
Id: 354
Data: 0
canimals:
Id: 383
Data: 91
chat:
Id: 386
Data: 0
cmonsters:
Id: 383
Data: 50
command:
Id: 137
Data: 0
container:
Id: 342
Data: 0
creeper:
Id: 383
Data: 50
destroy:
Id: 121
Data: 0
diode:
Id: 356
Data: 0
door:
Id: 324
Data: 0
enchant:
Id: 116
Data: 0
explode:
Id: 407
Data: 0
fireball:
Id: 385
Data: 0
firespread:
Id: 377
Data: 0
flow:
Id: 111
Data: 0
healing:
Id: 373
Data: 0
ignite:
Id: 259
Data: 0
lavaflow:
Id: 327
Data: 0
leash:
Id: 420
Data: 0
lever:
Id: 69
Data: 0
mobkilling:
Id: 367
Data: 0
monsters:
Id: 52
Data: 0
move:
Id: 301
Data: 0
nanimals:
Id: 383
Data: 92
nmonsters:
Id: 383
Data: 51
nofly:
Id: 171
Data: 1
nomobs:
Id: 166
Data: 0
note:
Id: 25
Data: 0
piston:
Id: 33
Data: 0
place:
Id: 169
Data: 0
pvp:
Id: 268
Data: 0
sanimals:
Id: 383
Data: 101
shear:
Id: 359
Data: 0
smonsters:
Id: 383
Data: 54
subzone:
Id: 160
Data: 7
table:
Id: 58
Data: 0
tnt:
Id: 46
Data: 0
tp:
Id: 120
Data: 0
trade:
Id: 388
Data: 0
trample:
Id: 3
Data: 0
use:
Id: 70
Data: 0
vehicledestroy:
Id: 328
Data: 0
waterflow:
Id: 326
Data: 0
# These are default flags applied to all residences from any user group.
ResidenceDefault:
build: false
destroy: false
use: false
container: false
pvp: false
tnt: false
creeper: false
ignite: false
firespread: false
vehicledestroy: false
animalkilling: false
hook: false
shear: false
leash: false
pistonprotection: true
tp: true
explode: false
# These are default flags applied to the residence creator of any group.
CreatorDefault:
build: true
move: true
use: true
ignite: true
container: true
animalkilling: true
mobkilling: true
vehicledestroy: true
trade: true
shear: true
leash: true
# These are default group flags applied to a residence made by a user of any group.
GroupDefault:
#default: #group name
#build: true
# These are grouped flags, so when using /res pset nickname redstone true, player will get all flags in list, same when setting to false or removing them.
GroupedFlags:
redstone:
- note
- pressure
- lever
- button
- diode
craft:
- brew
- table
- enchant
trusted:
- use
- tp
- build
- container
- move
- leash
- animalkilling
- mobkilling
- shear
- chat
- beacon
fire:
- ignite
- firespread
ItemList: #this is where you can create blacklists / whitelists
DefaultList: #list name is not important, as long as it is unique. Its good to use a descripive name.
#type of the list, can be blacklist, whitelist, or ignorelist
Type: blacklist
#If you want, you can have this list only apply to one world, otherwise it applys to all worlds
#World: world
#You can also have the list apply only to one group, otherwise it applys for all groups
#Group: default
#this is the actual list of material names that this list allows or dissallows
#You can look up the material name by item ID in game by typing /res material <id>
#Alternativly, you can simply use the item ID in the list, but its less descriptive and harder to see what the list allows or dissallows at a glance
Items:
- 'BEDROCK'
- 'LAVA'
- 'WATER'
- 'STATIONARY_LAVA'
- 'STATIONARY_WATER'
- 'MOB_SPAWNER'
</syntaxhighlight>

===插件权限===
residence.group.[groupname] -从groups.yml中设置玩家的领地组

residence.flag.[flag] - 在某flag在flag.yml中关闭时允许玩家使用该flag

residence.worldguard.[worldRegionName] - 允许在worldguard区域内创建领地

residence.max.subzones.[number] - 玩家可拥有的最大子领地数量

residence.max.rents.[number] - 玩家可出租的最大领地数量

residence.max.res.[number] - 玩家可拥有的最大领地数量

residence.admin - (OP) 给玩家使用/resadmin的权限

residence.topadmin - (OP) 给玩家使用 /resreload 和 /resload commands的权限

residence.admin.tp - (OP) 允许无视tp权限

residence.admin.move - (OP) 允许无视移动权限

residence.create - (Default) 允许创建领地

residence.select - (Default) 允许选择区域以创建领地

residence.nofly.bypass - (OP) 无视禁飞

residence.delete - (Default) 允许删除自己的领地

residence.delete.subzone - (Default) 允许删除自己的子领地

residence.rename - (Default) 允许重命名领地

residence.create.subzone - (Default) 允许在领地内创建子领地

residence.expand - (Default) 允许扩张自己的领地

residence.expand.subzone - (Default) 允许扩张自己的子领地

residence.contract - (Default) 允许合并自己的领地

residence.contract.subzone - (Default) 允许合并自己的子领地

residence.resize - (Default) 允许重新设置领地大小

residence.versioncheck - (OP) 允许接收新版本通知

residence.flag.command.bypass - (OP) 无视领地内输入命令权限

residence.select.auto.others - (OP) 允许为其他玩家开启自动选择

residence.chatcolor - (Default) 允许修改领地聊天颜色

residence.chatprefix - (OP) 允许修改领地聊天前缀

residence.chatkick - (Default) 允许将玩家从领地聊天频道踢出

residence.compass - (Default) 允许设置指南针指向

residence.randomtp - (Default) 允许使用 /res rt 命令

residence.bypass.build - 无视 build false flag

residence.bypass.destroy - 无视 destroy false flag

residence.bypass.ignorey - 无视领地Y坐标（高度）限制

residence.backup - 允许使用flag：backup

residence.cleanbypass - 防止玩家的领地在自动清理时被移除

residence.market.evict - 允许强制赶出领地内的玩家

residence.flybypass - 允许无视禁止飞行设置

==注意事项==
# 若使用Vault和WorldEdit，建议使用最新版本，否则可能出现各种问题。
# 若使用多世界插件（Multiverse-Core或Multiworld），必须在config.yml的“MultiWorldPlugin:”后填写（如：MultiWorldPlugin: Multiverse-Core），否则会出现重启服务器领地不保存的问题。
# 1.8版本以下不支持ActionBar功能，插件默认开启此功能，可在config.yml中设置关闭（UseActionBar: false）
==插件获取==
:此插件为SpigotMC上的付费插件，价格为9.99欧元（约合76.4RMB），作者在SpigotMC的页面中放出了不需付费的下载链接，可自行前去寻找。（[https://www.spigotmc.org/resources/residence-1-7-10-up-to-1-12.11480/ 点击前往]）
:欲及时获知新版本及新版特性，可去mcbbs.net服务器插件区搜索“Residence”收藏搬运帖。

== 已知Bug及应对方案 ==

=== 利用/res select shift命令将领地选区移至无限远导致服务器崩溃 ===
Bug描述：选择领地区域时，利用/res select shift指令，可将领地选区移动到无限远的地方（甚至超越地图边界），然后创建领地，严重可导致服务器瞬间崩溃。

应对方案：

方案一：在groups.yml中，将SelectCommandAccess设为false，则玩家只能通过选取工具来选取领地，而无法使用/res select指令

方案二：若装有essentials或其他权限管理插件，可为玩家组添加-residence.command.select权限，禁止玩家使用/res select指令

Residence

2020-05-10T13:16:16Z

Stydxm：继续翻译了一小部分配置文件

Residence是大多数服务器都会使用的插件，它不同于其他保护类插件，它可以让玩家自己保护自己的家园，无需再麻烦管理员。新版的Residence更是增添了许多新特性，为服主减轻了不少负担。

注：旧版本的Residence已不再支持1.8以上的Minecraft服务器，本页面仅适用于新版本。<blockquote></blockquote>
[[文件:Residence logo.jpg|有框|右]]
==特性==

* 领地选区可视化操作。选择领地区域时，会以粒子效果显示所选区域。（此特性仅支持1.8版本以上的服务器）
* 领地权限设置GUI操作。设置权限时，不必再逐条输入指令，只需打开GUI界面，即可轻松设置领地权限。
* 领地帮助列表可点击。帮助列表中的指令、翻页按钮都可以用鼠标直接点击，无需手动输入。（此特性仅支持1.8版本以上的服务器）
* 丰富的领地内聊天系统。服主可自行设置聊天前缀和颜色。
* 领地区域可扩展。当建筑面积扩大时，无需删除领地重新创建，可在原有领地基础上扩展。
* 领地租赁/出售系统。玩家可以自行出租/租借/出售/购买领地。
* 集成领地木牌系统。不必安装额外插件，便可以使用木牌轻松交易领地。
* 可设置当玩家一段时间不上线后自动删除其领地。
* 可在某个世界不使用领地插件。
* 可在全图随机传送。
* 支持多世界插件。

== 支持版本 ==
Residence插件支持'''1.7.10/1.8/1.9/1.10/1.11/1.12'''版本

完全支持'''Bukkit/Spigot/PaperSpigot'''服务端

==安装与配置==
===安装===
将下载的领地插件放入plugins文件夹，运行服务器以生成必要的文件。 保持默认的设置即可正常使用，无需手动添加权限，若要修改设置请参见下方的配置文件说明。
===配置文件说明===
注：配置文件的翻译工作进行中
====config.yml====
<syntaxhighlight lang="yaml">
Global:
# 语言设置，国人一般喜欢设为Chinese
Language: English
# 领地选区工具，默认是木棍（280）
SelectionToolId: 280
# 领地信息查看工具，默认是线（287）
InfoToolId: 287
# 玩家位置移动检测间隔，单位为毫秒
# 减小将加大服务器负担
# 增大会减慢对玩家错误移动反应的时间
MoveCheckInterval: 500
# 领地保存的周期，单位为分钟
SaveInterval: 10
# 当无法调用或没有使用Permissions插件时默认使用的组
DefaultGroup: default
# 是否启用领地租赁(Lease)系统
UseLeaseSystem: false
# 领地租赁系统的检测周期，单位为分钟
LeaseCheckInterval: 10
# 在玩家的钱充足时，自动续期租赁的领地；如果经济系统关闭，此设置项无效
LeaseAutoRenew: true
# 是否使用Permissions插件来管控领地的权限
EnablePermissions: true
# 若未使用 Permissions 或 PermissionsBukkit 插件，请设置为true
LegacyPermissions: false
# 开启/关闭领地经济系统 (支持iConomy, MineConomy, Essentials, BOSEconomy, RealEconomy).
EnableEconomy: true
# 是否开启领地租借(Rent)系统（关于Rent和上文Lease的区别，望了解者加以修改完善）
EnableRentSystem: false
# 领地租借到期时间的检测周期，单位为分钟
RentCheckInterval: 10
# 是否开启领地聊天频道
ResidenceChatEnable: true
# 是否使用ActionBar（低于1.8版本请设为false）
UseActionBar: true
# 领地聊天频道的字体颜色
ResidenceChatColor: DARK_PURPLE
# 是否只允许OP修改领地
AdminOnlyCommands: false
# 是否将OP设为领地插件的管理员
AdminOPs: true
# 填入服务器所使用的多世界插件（Multiverse-Core或Multiworld），若使用多世界插件，请务必填写！
MultiWorldPlugin: Multiverse-Core
# 是否让子领地继承领地的权限设置
ResidenceFlagsInherit: true
# 是否阻止领地的租借者修改领地的设置
PreventRentModify: true
# 是否在检测到领地文件出现错误时停止加载插件
StopOnSaveFault: true
# 允许的领地名字限制，使用正则表达式
ResidenceNameRegex: '[^a-zA-Z0-9\\-\\_]'
# 若设为true，则每当插件检测租赁（Lease）或租借（Rent）时便向控制台输出一条消息
ShowIntervalMessages: false
# 是否在服务器开启时检查插件版本
VersionCheck: true
# Experimental - The following settings are lists of block IDs to be used as part of the checks for the "container" and "use" flags when using mods.
CustomContainers: []
CustomBothClick: []
CustomRightClick: []

</syntaxhighlight>

====groups.yml====
<syntaxhighlight lang="yaml">
Groups:
Default: #组名，不要删除这个组
#删除下面的井号可将此配置应用到其他组
#Mirror:
#- 'group1'
#- 'group2'
Residence:
# 该组玩家是否可以创建领地
CanCreate: true
# 玩家可以拥有的最大领地数量
MaxResidences: 3
# 领地可包含的最大物理区域
MaxAreasPerResidence: 2
# 领地最大格数（东西方向）
MaxEastWest: 16
# 领地最小格数（东西方向），设为-1则不限制
MinEastWest: 3
# 领地最大格数（南北方向）
MaxNorthSouth: 16
# 领地最小格数（南北方向）
MinNorthSouth: 3
# 领地最大格数（高度）
MaxUpDown: 256
# 领地最小格数（高度），设为-1则不限制
MinUpDown: 3
# 可创建领地的最小高度
MinHeight: 0
# 可创建领地的最大高度
MaxHeight: 255
# 所在区域可拥有的最大子领地数量
MaxSubzonesInArea: 3
# 最大子领地深度
# 一个领地中的子领地中的子领地深度为2
# 设为0以禁用子领地
# 译者注：子领地深度即子领地嵌套的层数，子领地的子领地深度为2，以此类推
SubzoneDepth: 3
# （可选）子领地最大格数（东西方向）
SubzoneMaxEastWest: 16
# （可选）子领地最小格数（东西方向）
SubzoneMinEastWest: 3
# （可选）子领地最大格数（南北方向）
SubzoneMaxNorthSouth: 16
# （可选）子领地最小格数（南北方向）
SubzoneMinNorthSouth: 3
# （可选）子领地最大格数（高度）
SubzoneMaxUpDown: 256
# （可选）子领地最霄格数（高度）
SubzoneMinUpDown: 3
# 是否允许领地传送
CanTeleport: true
# 允许或禁止使用/ res unstuck使你在被困住的时候离开领地
Unstuck: true
# 允许或禁止使用/res kick把玩家从领地踢出
Kick: False
# 允许或禁止使用/res select命令，如果禁止则玩家只能使用圈地工具来选择选区
#译者注：建议禁用，原因[[Residence#.E5.88.A9.E7.94.A8.2Fres_select_shift.E5.91.BD.E4.BB.A4.E5.B0.86.E9.A2.86.E5.9C.B0.E9.80.89.E5.8C.BA.E7.A7.BB.E8.87.B3.E6.97.A0.E9.99.90.E8.BF.9C.E5.AF.BC.E8.87.B4.E6.9C.8D.E5.8A.A1.E5.99.A8.E5.B4.A9.E6.BA.83|见此]]
SelectCommandAccess: true
# Allow or Disallow the group to access the Blacklist/Ignorelist for residences they own.
ItemListAccess: true
# Options relating to enter and leave messages on the residence.
Messaging:
# Whether or not the player can change the Residence enter and leave messages.
CanChange: true
# The default enter message to apply to new Residences created by players in this group.
# Leaving the message blank will disable it.
DefaultEnter: Welcome %player to %residence, owned by %owner.
# The default leave message to apply to new Residences created by players in this group.
# Leaving the message blank will disable it.
DefaultLeave: Now leaving %residence.
# Options relating to the Lease system.
Lease:
# The maximum number of days to allow leases.
MaxDays: 16
# The number of days to add to the lease following a '/res lease renew' command.
RenewIncrement: 14
#Options related to the rent system
Rent:
#determines how many residences can be rented by players of this group at once
MaxRents: 3
#determines how many residences can be set for rent by players of this group at once
MaxRentables: 3
# determines max days player can rent residence at once
MaxRentDays: 31
# Options relating to the Residence Economy.
Economy:
# Whether or not players in this group can buy other Residences that are for sale.
CanBuy: true
# Whether or not players in this group can sell their Residences.
CanSell: false
# Whether or not to ignore the Residence size/count limits when buying a residence.
IgnoreLimits: false
# The cost, per block, of making a new Residence or adding a area to it.
BuyCost: 0.5
# The cost, per block, player will be getting back when removing residence.
SellCost: 0.25
# The cost, per block, of renewing a Residence lease (if the lease system is enabled).
RenewCost: 0.2
# Flags are checked in the order:
# 1: Player
# 2: Group
# 3: Owner
# 4: If all others are undefined, reverts to default value (usually true).
# Flag permissions default to false.
# These flags settings override the globals.
Flags:
# Specifically allow or deny this group from changing certain flags.
Permission:
#build: true
# Specifys the flags that are applied at residence creation for players of this group.
Default:
#build: true
# Specifys the flags that are applied at to the creator at residence creation.
CreatorDefault:
#build: true
# Specifys the flags that are applied to other groups for this residence, at creation.
GroupDefault:
#default: #group name
#build: false
#these flags are applied specifically to this group whenever they are outside a residence
#these flags will override the flags at the top, under the Global section.
World:
Global: #these flags will apply to all worlds
#build: false
WorldNameHere: #or you can apply them by each individual world
#build: false
NextGroup: #group name, player should have residence.group.nextgroup permission node to have access to this residence group
Residence:
CanCreate: true
MaxResidences: 4
MaxAreasPerResidence: 2
MaxEastWest: 20
MaxNorthSouth: 20
MaxUpDown: 20
MinHeight: 0
MaxHeight: 255
SubzoneDepth: 3
CanTeleport: true
Unstuck: true
Kick: true
SelectCommandAccess: true
ItemListAccess: true
Messaging:
CanChange: true
DefaultEnter: Welcome %player to %residence, owned by %owner.
DefaultLeave: Now leaving %residence.
Lease:
MaxDays: 16
RenewIncrement: 14
Rent:
MaxRents: 3
MaxRentables: 3
MaxRentDays: 31
Economy:
CanBuy: true
CanSell: false
IgnoreLimits: false
BuyCost: 0.7
SellCost: 0.3
RenewCost: 0.3

# You can manually specify the group a player is in below, this overrides their permissions group.
GroupAssignments:
bekvon: default
player: default
</syntaxhighlight>

====flags.yml====
<syntaxhighlight lang="yaml">
#These are Global Settings for Residence.
Global:
# These are world flags that are applied when the player is NOT within a residence.
Flags:
Global: #these are default for all worlds unless specified below, they can be overridden per group
use: true
build: true
ignite: true
firespread: true
damage: true
creeper: true
tnt: true
pvp: true
WorldNameHere: #here you can set flags for individual worlds, these override Global
#build: true
# This gives permission to change certain flags to all groups, unless specifically denied to the group.
FlagPermission:
move: true
build: true
place: true
destroy: true
use: true
container: true
pvp: true
tp: true
ignite: true
firespread: true
flow: true
lavaflow: true
waterflow: true
creeper: true
tnt: true
monsters: true
animals: true
animalkilling: true
mobkilling: true
vehicledestroy: true
trade: true
shear: true
leash: true
nofly: false
subzone: true
healing: true
piston: true
diode: true
lever: true
button: true
door: true
table: true
enchant: true
brew: true
bed: true
cake: true
note: true
trample: true
burn: true
explode: true
fireball: true
command: false
day: true
night: true
chat: true
hidden: false
overridepvp: false
keepinv: false
keepexp: false
shop: true
bank: false
# This sets GUI items to represent each flag, if not given, then gray wool will be used
FlagGui:
animalkilling:
Id: 365
Data: 0
animals:
Id: 383
Data: 90
bed:
Id: 355
Data: 0
brew:
Id: 379
Data: 0
build:
Id: 45
Data: 0
burn:
Id: 50
Data: 0
button:
Id: 143
Data: 0
cake:
Id: 354
Data: 0
canimals:
Id: 383
Data: 91
chat:
Id: 386
Data: 0
cmonsters:
Id: 383
Data: 50
command:
Id: 137
Data: 0
container:
Id: 342
Data: 0
creeper:
Id: 383
Data: 50
destroy:
Id: 121
Data: 0
diode:
Id: 356
Data: 0
door:
Id: 324
Data: 0
enchant:
Id: 116
Data: 0
explode:
Id: 407
Data: 0
fireball:
Id: 385
Data: 0
firespread:
Id: 377
Data: 0
flow:
Id: 111
Data: 0
healing:
Id: 373
Data: 0
ignite:
Id: 259
Data: 0
lavaflow:
Id: 327
Data: 0
leash:
Id: 420
Data: 0
lever:
Id: 69
Data: 0
mobkilling:
Id: 367
Data: 0
monsters:
Id: 52
Data: 0
move:
Id: 301
Data: 0
nanimals:
Id: 383
Data: 92
nmonsters:
Id: 383
Data: 51
nofly:
Id: 171
Data: 1
nomobs:
Id: 166
Data: 0
note:
Id: 25
Data: 0
piston:
Id: 33
Data: 0
place:
Id: 169
Data: 0
pvp:
Id: 268
Data: 0
sanimals:
Id: 383
Data: 101
shear:
Id: 359
Data: 0
smonsters:
Id: 383
Data: 54
subzone:
Id: 160
Data: 7
table:
Id: 58
Data: 0
tnt:
Id: 46
Data: 0
tp:
Id: 120
Data: 0
trade:
Id: 388
Data: 0
trample:
Id: 3
Data: 0
use:
Id: 70
Data: 0
vehicledestroy:
Id: 328
Data: 0
waterflow:
Id: 326
Data: 0
# These are default flags applied to all residences from any user group.
ResidenceDefault:
build: false
destroy: false
use: false
container: false
pvp: false
tnt: false
creeper: false
ignite: false
firespread: false
vehicledestroy: false
animalkilling: false
hook: false
shear: false
leash: false
pistonprotection: true
tp: true
explode: false
# These are default flags applied to the residence creator of any group.
CreatorDefault:
build: true
move: true
use: true
ignite: true
container: true
animalkilling: true
mobkilling: true
vehicledestroy: true
trade: true
shear: true
leash: true
# These are default group flags applied to a residence made by a user of any group.
GroupDefault:
#default: #group name
#build: true
# These are grouped flags, so when using /res pset nickname redstone true, player will get all flags in list, same when setting to false or removing them.
GroupedFlags:
redstone:
- note
- pressure
- lever
- button
- diode
craft:
- brew
- table
- enchant
trusted:
- use
- tp
- build
- container
- move
- leash
- animalkilling
- mobkilling
- shear
- chat
- beacon
fire:
- ignite
- firespread
ItemList: #this is where you can create blacklists / whitelists
DefaultList: #list name is not important, as long as it is unique. Its good to use a descripive name.
#type of the list, can be blacklist, whitelist, or ignorelist
Type: blacklist
#If you want, you can have this list only apply to one world, otherwise it applys to all worlds
#World: world
#You can also have the list apply only to one group, otherwise it applys for all groups
#Group: default
#this is the actual list of material names that this list allows or dissallows
#You can look up the material name by item ID in game by typing /res material <id>
#Alternativly, you can simply use the item ID in the list, but its less descriptive and harder to see what the list allows or dissallows at a glance
Items:
- 'BEDROCK'
- 'LAVA'
- 'WATER'
- 'STATIONARY_LAVA'
- 'STATIONARY_WATER'
- 'MOB_SPAWNER'
</syntaxhighlight>

===插件权限===
residence.group.[groupname] -从groups.yml中设置玩家的领地组

residence.flag.[flag] - 在某flag在flag.yml中关闭时允许玩家使用该flag

residence.worldguard.[worldRegionName] - 允许在worldguard区域内创建领地

residence.max.subzones.[number] - 玩家可拥有的最大子领地数量

residence.max.rents.[number] - 玩家可出租的最大领地数量

residence.max.res.[number] - 玩家可拥有的最大领地数量

residence.admin - (OP) 给玩家使用/resadmin的权限

residence.topadmin - (OP) 给玩家使用 /resreload 和 /resload commands的权限

residence.admin.tp - (OP) 允许无视tp权限

residence.admin.move - (OP) 允许无视移动权限

residence.create - (Default) 允许创建领地

residence.select - (Default) 允许选择区域以创建领地

residence.nofly.bypass - (OP) 无视禁飞

residence.delete - (Default) 允许删除自己的领地

residence.delete.subzone - (Default) 允许删除自己的子领地

residence.rename - (Default) 允许重命名领地

residence.create.subzone - (Default) 允许在领地内创建子领地

residence.expand - (Default) 允许扩张自己的领地

residence.expand.subzone - (Default) 允许扩张自己的子领地

residence.contract - (Default) 允许合并自己的领地

residence.contract.subzone - (Default) 允许合并自己的子领地

residence.resize - (Default) 允许重新设置领地大小

residence.versioncheck - (OP) 允许接收新版本通知

residence.flag.command.bypass - (OP) 无视领地内输入命令权限

residence.select.auto.others - (OP) 允许为其他玩家开启自动选择

residence.chatcolor - (Default) 允许修改领地聊天颜色

residence.chatprefix - (OP) 允许修改领地聊天前缀

residence.chatkick - (Default) 允许将玩家从领地聊天频道踢出

residence.compass - (Default) 允许设置指南针指向

residence.randomtp - (Default) 允许使用 /res rt 命令

residence.bypass.build - 无视 build false flag

residence.bypass.destroy - 无视 destroy false flag

residence.bypass.ignorey - 无视领地Y坐标（高度）限制

residence.backup - 允许使用flag：backup

residence.cleanbypass - 防止玩家的领地在自动清理时被移除

residence.market.evict - 允许强制赶出领地内的玩家

residence.flybypass - 允许无视禁止飞行设置

==注意事项==
# 若使用Vault和WorldEdit，建议使用最新版本，否则可能出现各种问题。
# 若使用多世界插件（Multiverse-Core或Multiworld），必须在config.yml的“MultiWorldPlugin:”后填写（如：MultiWorldPlugin: Multiverse-Core），否则会出现重启服务器领地不保存的问题。
# 1.8版本以下不支持ActionBar功能，插件默认开启此功能，可在config.yml中设置关闭（UseActionBar: false）
==插件获取==
:此插件为SpigotMC上的付费插件，价格为9.99欧元（约合76.4RMB），作者在SpigotMC的页面中放出了不需付费的下载链接，可自行前去寻找。（[https://www.spigotmc.org/resources/residence-1-7-10-up-to-1-12.11480/ 点击前往]）
:欲及时获知新版本及新版特性，可去mcbbs.net服务器插件区搜索“Residence”收藏搬运帖。

== 已知Bug及应对方案 ==

=== 利用/res select shift命令将领地选区移至无限远导致服务器崩溃 ===
Bug描述：选择领地区域时，利用/res select shift指令，可将领地选区移动到无限远的地方（甚至超越地图边界），然后创建领地，严重可导致服务器瞬间崩溃。

应对方案：

方案一：在groups.yml中，将SelectCommandAccess设为false，则玩家只能通过选取工具来选取领地，而无法使用/res select指令

方案二：若装有essentials或其他权限管理插件，可为玩家组添加-residence.command.select权限，禁止玩家使用/res select指令