• 欢迎来到Minecraft插件百科！
  • 对百科编辑一脸懵逼？帮助:快速入门带您快速熟悉百科编辑！
  • 因近日遭受攻击，百科现已限制编辑，有意编辑请加入插件百科企鹅群：223812289

Residence：修订间差异

来自Minecraft插件百科
跳转到导航 跳转到搜索
小 （新增已知bug）
（// Edit via Wikiplus）
 
（未显示5个用户的15个中间版本）
第1行： 第1行：
{{Bukkit Plugin Infobox
|插件名=Residence
|图标=[[文件:Residence logo.jpg]]
|版本=5.1.2.0
|兼容服务端版本= 1.7.10 - 1.20.1
|作者= Bekvon, t00thpick1, DartCZ 及更多
|网址=https://www.spigotmc.org/resources/residence-1-7-10-up-to-1-16.11480/
|前置插件=[[CMILib]]
}}


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


注：旧版本的Residence已不再支持1.8以上的Minecraft服务器，本页面仅适用于新版本。<blockquote></blockquote>
注：自5.0.0.0开始需要安装[[CMILib]]前置插件
[[文件:Residence logo.jpg|有框|右]]
 
旧版本的Residence不支持1.8以上的Minecraft服务器，本页面仅适用于新版本。<blockquote></blockquote>
 
==特性==
==特性==
      
      
第14行： 第26行：
* 集成领地木牌系统。不必安装额外插件，便可以使用木牌轻松交易领地。
* 集成领地木牌系统。不必安装额外插件，便可以使用木牌轻松交易领地。
* 可设置当玩家一段时间不上线后自动删除其领地。
* 可设置当玩家一段时间不上线后自动删除其领地。
* 可在某个世界不使用领地插件。
* 可在某个世界禁用领地插件。
* 可在全图随机传送。
* 可在全图随机传送。
* 支持多世界插件。
* 支持多世界插件。


== 支持版本 ==
==安装与配置==
Residence插件支持'''1.7.10/1.8/1.9/1.10/1.11/1.12'''版本


完全支持'''Bukkit/Spigot/PaperSpigot'''服务端
==安装与配置==
===安装===
===安装===
将下载的领地插件放入plugins文件夹，运行服务器以生成必要的文件。<br />保持默认的设置即可正常使用，无需手动添加权限，若要修改设置请参见下方的配置文件说明。
将下载的领地插件放入plugins文件夹，运行服务器以生成必要的文件。<br />保持默认的设置即可正常使用，无需手动添加权限，若要修改设置请参见下方的配置文件说明。
===配置文件说明===
===配置文件说明===
注：配置文件的翻译工作进行中
 
====config.yml====
====config.yml====
<syntaxhighlight lang="yaml">
<syntaxhighlight lang="yaml">
Global:
Global:
     # 语言设置，国人一般喜欢设为Chinese
     # 语言设置，国内一般设为Chinese
     Language: English
     Language: English
     # 领地选区工具，默认是木棍（280）
     # 领地选区工具，默认为木棍（280）
     SelectionToolId: 280
     SelectionToolId: 280
     # 领地信息查看工具，默认是线（287）
     # 领地信息查看工具，默认为线（287）
     InfoToolId: 287
     InfoToolId: 287
     # 玩家位置移动检测间隔，单位为毫秒
     # 玩家位置移动检测间隔，单位为毫秒
     # 减小将加大服务器负担
     # 减小此值将加大服务器负担
     # 增大会减慢对玩家错误移动反应的时间
     # 增大此值会减慢服务器对玩家错误移动的反应速度
     MoveCheckInterval: 500
     MoveCheckInterval: 500
     # 领地保存的周期，单位为分钟
     # 领地保存的周期，单位为分钟
第67行： 第75行：
     # 领地聊天频道的字体颜色
     # 领地聊天频道的字体颜色
     ResidenceChatColor: DARK_PURPLE
     ResidenceChatColor: DARK_PURPLE
     # 是否只允许OP修改领地
     # 是否只允许服务器管理员修改领地
     AdminOnlyCommands: false
     AdminOnlyCommands: false
     # 是否将OP设为领地插件的管理员
     # 是否将服务器管理员设为领地插件的管理员
     AdminOPs: true
     AdminOPs: true
     # 填入服务器所使用的多世界插件（Multiverse-Core或Multiworld），若使用多世界插件，请务必填写！
     # 填入服务器所使用的多世界插件（Multiverse-Core或Multiworld），若使用多世界插件，请务必填写！
第85行： 第93行：
     # 是否在服务器开启时检查插件版本
     # 是否在服务器开启时检查插件版本
     VersionCheck: true
     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.
     # 实验性功能 - 下列方块列表用于自定义检查"container"和"use"属性的方块ID（一般用于模组服务器）
     CustomContainers: []
     CustomContainers: []
     CustomBothClick: []
     CustomBothClick: []
第95行： 第103行：
<syntaxhighlight lang="yaml">
<syntaxhighlight lang="yaml">
Groups:
Groups:
     Default: #组名，不要删除这个组
     Default: #默认组名，不要删除这个组
       #删除下面的井号可将此配置应用到其他组
       #删除下面的井号可将此配置镜像至其他组
       #Mirror:
       #Mirror:
         #- 'group1'
         #- 'group1'
第103行： 第111行：
           # 该组玩家是否可以创建领地
           # 该组玩家是否可以创建领地
           CanCreate: true
           CanCreate: true
           # 玩家可以拥有的最大领地数量
           # 该组玩家可以拥有的最大领地数量
           MaxResidences: 3
           MaxResidences: 3
           # 领地可包含的最大物理区域
           # 领地可包含的最大物理区域
第125行： 第133行：
           # 所在区域可拥有的最大子领地数量
           # 所在区域可拥有的最大子领地数量
           MaxSubzonesInArea: 3
           MaxSubzonesInArea: 3
            # The maximum recursive depth that subzones can go.
          # 最大子领地深度
            # A subzone within a subzone within the Residence zone would be a depth of 2.
          # 一个领地中的子领地中的子领地深度为2
            # Set to 0 to disable subzones.
          # 设为0以禁用子领地
          # 译者注：子领地深度即子领地嵌套的层数，子领地的子领地深度为2，以此类推
           SubzoneDepth: 3
           SubzoneDepth: 3
           # (Optional) The maximum number of blocks a Residence Subzone can be, East to West (X).
           # （可选）子领地最大格数（东西方向）
           SubzoneMaxEastWest: 16
           SubzoneMaxEastWest: 16
           # (Optional) The minimum number of blocks a Residence Subzone can be, East to West (X).
           # （可选）子领地最小格数（东西方向）
           SubzoneMinEastWest: 3
           SubzoneMinEastWest: 3
           # (Optional) The maximum number of blocks a Residence Subzone can be, North to South (Z).
           # （可选）子领地最大格数（南北方向）
           SubzoneMaxNorthSouth: 16
           SubzoneMaxNorthSouth: 16
           # (Optional) The minimum number of blocks a Residence Subzone can be, North to South (Z).
           # （可选）子领地最小格数（南北方向）
           SubzoneMinNorthSouth: 3
           SubzoneMinNorthSouth: 3
           # (Optional) The maximum number of blocks a Residence Subzone can be, High to Low (Y).
           # （可选）子领地最大格数（高度）
           SubzoneMaxUpDown: 256
           SubzoneMaxUpDown: 256
           # (Optional) The minimum number of blocks a Residence Subzone can be, High to Low (Y).
           # （可选）子领地最小格数（高度）
           SubzoneMinUpDown: 3
           SubzoneMinUpDown: 3
           # Whether or not to allow teleporting to Residences.
           # 是否允许领地传送
           CanTeleport: true
           CanTeleport: true
           # Allow or Disallow the use of /res unstuck, to get yourself out of a residence if stuck in one somehow
           # 是否允许使用/ res unstuck使你在被困住的时候离开领地
           Unstuck: true
           Unstuck: true
           # Allow or Disallow the use of /res kick, to kick player from residence.
           # 是否允许使用/res kick把玩家从领地踢出
           Kick: False
           Kick: False
           # Allow or Disallow the use of the /res select command, if disabled they can only use the selection tool.
           # 是否允许使用/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
           SelectCommandAccess: true
           # Allow or Disallow the group to access the Blacklist/Ignorelist for residences they own.
           # 是否允许该组玩家访问自己领地的物品黑名单/忽略名单
           ItemListAccess: true
           ItemListAccess: true
       # Options relating to enter and leave messages on the residence.
       # 以下为进出领地时的提示消息设置项
       Messaging:
       Messaging:
           # Whether or not the player can change the Residence enter and leave messages.
           # 是否允许玩家更改进出领地时的提示消息
           CanChange: true
           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.
           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.
           DefaultLeave: Now leaving %residence.
       # Options relating to the Lease system.
       # 以下为出租系统设置项
       Lease:
       Lease:
           # The maximum number of days to allow leases.
           # 最多允许出租的天数
           MaxDays: 16
           MaxDays: 16
           # The number of days to add to the lease following a '/res lease renew' command.
           # 当使用 '/res lease renew' 指令时续期的天数
           RenewIncrement: 14
           RenewIncrement: 14
       #Options related to the rent system
       # 以下为租赁系统设置项
       Rent:
       Rent:
           #determines how many residences can be rented by players of this group at once
           # 此组玩家一次最多可租赁的领地数
           MaxRents: 3
           MaxRents: 3
           #determines how many residences can be set for rent by players of this group at once
           # 此组玩家一次最多可出租的领地数
           MaxRentables: 3
           MaxRentables: 3
           # determines max days player can rent residence at once
           # 此组玩家可出租领地的最长天数
           MaxRentDays: 31
           MaxRentDays: 31
       # Options relating to the Residence Economy.
       # 以下为领地经济系统设置项
       Economy:
       Economy:
           # Whether or not players in this group can buy other Residences that are for sale.
           # 是否允许此组玩家购买其他玩家出售的领地
           CanBuy: true
           CanBuy: true
           # Whether or not players in this group can sell their Residences.
           # 是否允许此组玩家出售领地
           CanSell: false
           CanSell: false
           # Whether or not to ignore the Residence size/count limits when buying a residence.
           # 是否在玩家购买领地时忽略领地大小/数量
           IgnoreLimits: false
           IgnoreLimits: false
           # The cost, per block, of making a new Residence or adding a area to it.
           # 创建/扩大领地时每方块的价格
           BuyCost: 0.5
           BuyCost: 0.5
           # The cost, per block, player will be getting back when removing residence.
           # 删除领地时每方块返还的价格
           SellCost: 0.25
           SellCost: 0.25
           # The cost, per block, of renewing a Residence lease (if the lease system is enabled).
           # 续租领地时每方块的价格（如果启用了租赁系统的话）
           RenewCost: 0.2
           RenewCost: 0.2
       # Flags are checked in the order:
       # 标记按顺序识别:
       # 1: Player
       # 1: 玩家
       # 2: Group
       # 2: 组
       # 3: Owner
       # 3: 所有者
       # 4: If all others are undefined, reverts to default value (usually true).
       # 4: 如果其它项均未定义，则使用默认值（通常为true）
       # Flag permissions default to false.
       # 标记权限默认为false
       # These flags settings override the globals.
       # 以下标记设置优先级高于全局设置
       Flags:
       Flags:
           # Specifically allow or deny this group from changing certain flags.
           # 指定此组玩家是否可以更改某些标记
           Permission:
           Permission:
               #build: true
               #build: true
           # Specifys the flags that are applied at residence creation for players of this group.
           # 指定领地创建时对此组玩家默认应用的标记
           Default:
           Default:
               #build: true
               #build: true
           # Specifys the flags that are applied at to the creator at residence creation.
           # 指定领地创建时对创建者默认应用的标记
           CreatorDefault:
           CreatorDefault:
               #build: true
               #build: true
           # Specifys the flags that are applied to other groups for this residence, at creation.
           # 指定领地创建时对其他组玩家默认应用的标记
           GroupDefault:
           GroupDefault:
               #default: #group name
               #default: #组名
                   #build: false
                   #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:
           World:
                 Global: #these flags will apply to all worlds
                 Global: #以下标记会被应用于所有世界
                     #build: false
                     #build: false
                 WorldNameHere: #or you can apply them by each individual world
                 WorldNameHere: #你也可以为每个世界分别设置
                     #build: false
                     #build: false
     NextGroup: #group name, player should have residence.group.nextgroup permission node to have access to this residence group
     NextGroup: #组名，玩家必须拥有residence.group.nextgroup权限节点才能使用此组权限
       Residence:
       Residence:
           CanCreate: true
           CanCreate: true
第252行： 第262行：
           RenewCost: 0.3
           RenewCost: 0.3


# You can manually specify the group a player is in below, this overrides their permissions group.
# 你可以在这里手动为玩家指定Ta所属的组，此项优先级高于权限组
GroupAssignments:
GroupAssignments:
     bekvon: default
     bekvon: default
第260行： 第270行：
====flags.yml====
====flags.yml====
<syntaxhighlight lang="yaml">
<syntaxhighlight lang="yaml">
#These are Global Settings for Residence.
# 以下为领地插件全局设置
Global:
Global:
     # These are world flags that are applied when the player is NOT within a residence.
     # 以下为领地外应用的世界标记
     Flags:
     Flags:
         Global: #these are default for all worlds unless specified below, they can be overridden per group
         Global: # 全局设置，除非在下面定义，否则全部为默认设置（可在组设置内覆盖）
             use: true
             use: true
             build: true
             build: true
第273行： 第283行：
             tnt: true
             tnt: true
             pvp: true
             pvp: true
         WorldNameHere: #here you can set flags for individual worlds, these override Global
         WorldNameHere: # 你可以在这里为每个世界分别配置标记，优先级高于全局设置
             #build: true
             #build: true
     # This gives permission to change certain flags to all groups, unless specifically denied to the group.
     # 以下配置给予所有组更改标记的权限，除非为某个组单独配置
     FlagPermission:
     FlagPermission:
         move: true
         move: true
第328行： 第338行：
         shop: true
         shop: true
         bank: false
         bank: false
     # This sets GUI items to represent each flag, if not given, then gray wool will be used
     # 以下设置定义了在可视化界面中每个标记显示的物品样式，未定义则使用灰色羊毛
     FlagGui:
     FlagGui:
         animalkilling:  
         animalkilling:  
第480行： 第490行：
             Id: 326
             Id: 326
             Data: 0
             Data: 0
     # These are default flags applied to all residences from any user group.
     # 以下为默认应用至所有组的领地标记
     ResidenceDefault:
     ResidenceDefault:
         build: false
         build: false
第499行： 第509行：
         tp: true
         tp: true
         explode: false
         explode: false
     # These are default flags applied to the residence creator of any group.
     # 以下为默认应用至创建者的领地标记
     CreatorDefault:
     CreatorDefault:
         build: true
         build: true
第512行： 第522行：
         shear: true
         shear: true
         leash: true
         leash: true
     # These are default group flags applied to a residence made by a user of any group.
     # 以下为组内玩家创建领地时默认应用至此组的领地标记
     GroupDefault:
     GroupDefault:
         #default: #group name
         #default: # 组名
             #build: true
             #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.
     # 以下为组标记，当玩家使用 /res pset 昵称 redstone true时，玩家会得到列表内的标记，设置为false亦然
     GroupedFlags:
     GroupedFlags:
       redstone:
       redstone:
第543行： 第553行：
       - ignite
       - ignite
       - firespread
       - firespread
ItemList: #this is where you can create blacklists / whitelists
ItemList: # 在这里你可以创建黑名单/白名单
     DefaultList: #list name is not important, as long as it is unique. Its good to use a descripive name.
     DefaultList: # 列表名不重要，只要它是独一无二的，当然具有辨识性的名称更好
         #type of the list, can be blacklist, whitelist, or ignorelist
         # 列表类型，可为blacklist，whitelist或ignorelist
         Type: blacklist
         Type: blacklist
         #If you want, you can have this list only apply to one world, otherwise it applys to all worlds
         # 可以根据需要将列表应用于特定世界或所有世界
         #World: world
         #World: world
         #You can also have the list apply only to one group, otherwise it applys for all groups
         # 可以根据需要将列表应用于特定组或所有组
         #Group: default
         #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>
         # 你可以使用/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
         # 相对的，你也可以使用数字ID，但这样不方便辨别你到底允许/禁止了些什么
         Items:  
         Items:  
           - 'BEDROCK'
           - 'BEDROCK'
第563行： 第573行：
</syntaxhighlight>
</syntaxhighlight>


===插件权限===
===插件权限===
residence.group.[groupname] -从groups.yml中设置玩家的领地组
{| class="wikitable"
 
|-
residence.flag.[flag] - 在某flag在flag.yml中关闭时允许玩家使用该flag
! 权限 !! 介绍 !! 默认使用者
 
|-
residence.worldguard.[worldRegionName] - 允许在worldguard区域内创建领地
| residence.group.[groupname] || 从groups.yml中设置玩家的领地组 ||
 
|-
residence.max.subzones.[number] - 玩家可拥有的最大子领地数量
| residence.flag.[flag] || 在某flag在flag.yml中关闭时允许玩家使用该flag ||
 
|-
residence.max.rents.[number] - 玩家可出租的最大领地数量
| residence.worldguard.[worldRegionName] || 允许在worldguard区域内创建领地 ||
 
|-
residence.max.res.[number] - 玩家可拥有的最大领地数量
| residence.max.subzones.[number] || 玩家可拥有的最大子领地数量 ||
 
|-
residence.admin - (OP) 给玩家使用/resadmin的权限
| residence.max.rents.[number] || 玩家可出租的最大领地数量 ||
 
|-
residence.topadmin - (OP) 给玩家使用 /resreload 和 /resload commands的权限
| residence.max.res.[number] || 玩家可拥有的最大领地数量 ||
 
|-
residence.admin.tp - (OP) 允许无视tp权限
| residence.admin || 给玩家使用/resadmin的权限 || OP
 
|-
residence.admin.move - (OP) 允许无视移动权限
| residence.topadmin || 给玩家使用 /resreload 和 /resload commands的权限 || OP
 
|-
residence.create - (Default) 允许创建领地
| residence.admin.tp || 允许无视tp权限 || OP
 
|-
residence.select - (Default) 允许选择区域以创建领地
| residence.admin.move || 允许无视移动权限 || OP
 
|-
residence.nofly.bypass - (OP) 无视禁飞
| residence.create || 允许创建领地 || Default
 
|-
residence.delete - (Default) 允许删除自己的领地
| residence.select || 允许选择区域以创建领地 || Default
 
|-
residence.delete.subzone - (Default) 允许删除自己的子领地
| residence.nofly.bypass || 无视禁飞 || OP
 
|-
residence.rename - (Default) 允许重命名领地
| residence.delete || 允许删除自己的领地 || Default
 
|-
residence.create.subzone - (Default) 允许在领地内创建子领地
| residence.delete.subzone || 允许删除自己的子领地 || Default
 
|-
residence.expand - (Default) 允许扩张自己的领地
| residence.rename || 允许重命名领地 || Default
 
|-
residence.expand.subzone - (Default) 允许扩张自己的子领地
| residence.create.subzone || 允许在领地内创建子领地 || Default
 
|-
residence.contract - (Default) 允许合并自己的领地
| residence.expand || 允许扩张自己的领地 || Default
 
|-
residence.contract.subzone - (Default) 允许合并自己的子领地
| residence.expand.subzone || 允许扩张自己的子领地 || Default
 
|-
residence.resize - (Default) 允许重新设置领地大小
| residence.contract || 允许合并自己的领地 || Default
 
|-
residence.versioncheck - (OP) 允许接收新版本通知
| residence.contract.subzone || 允许合并自己的子领地 || Default
 
|-
residence.flag.command.bypass - (OP) 无视领地内输入命令权限
| residence.resize || 允许重新设置领地大小 || Default
 
|-
residence.select.auto.others - (OP) 允许为其他玩家开启自动选择
| residence.versioncheck || 允许接收新版本通知 || OP
 
|-
residence.chatcolor - (Default) 允许修改领地聊天颜色
| residence.flag.command.bypass || 无视领地内输入命令权限 || OP
 
|-
residence.chatprefix - (OP) 允许修改领地聊天前缀
| residence.select.auto.others || 允许为其他玩家开启自动选择 || OP
 
|-
residence.chatkick - (Default) 允许将玩家从领地聊天频道踢出
| residence.chatcolor || 允许修改领地聊天颜色 || Default
 
|-
residence.compass - (Default) 允许设置指南针指向
| residence.chatprefix || 允许修改领地聊天前缀 || OP
 
|-
residence.randomtp - (Default) 允许使用 /res rt 命令
| residence.chatkick || 允许将玩家从领地聊天频道踢出 || Default
 
|-
residence.bypass.build - 无视 build false flag
| residence.compass || 允许设置指南针指向 || Default
 
|-
residence.bypass.destroy - 无视 destroy false flag
| residence.randomtp || 允许使用 /res rt 命令 || Default
 
|-
residence.bypass.ignorey - 无视领地Y坐标（高度）限制
| residence.bypass.build || 无视 build false flag ||
 
|-
residence.backup - 允许使用flag：backup
| residence.bypass.destroy || 无视 destroy false flag ||
 
|-
residence.cleanbypass - 防止玩家的领地在自动清理时被移除
| residence.bypass.ignorey || 无视领地Y坐标（高度）限制 ||
 
|-
residence.market.evict - 允许强制赶出领地内的玩家
| residence.backup || 允许使用flag：backup ||
 
|-
residence.flybypass - 允许无视禁止飞行设置
| residence.cleanbypass || 防止玩家的领地在自动清理时被移除 ||
|-
| residence.market.evict || 允许强制赶出领地内的玩家 ||
|-
| residence.flybypass || 允许无视禁止飞行设置 ||
|-
|}


==注意事项==
==注意事项==

2024年3月22日 (五) 09:41的最新版本

Residence
外文名Residence
作者Bekvon, t00thpick1, DartCZ 及更多
插件类型Spigot / CraftBukkit
最新版本5.1.2.0
兼容服务端1.7.10 - 1.20.1
前置插件CMILib
源地址https://www.spigotmc.org/resources/residence-1-7-10-up-to-1-16.11480/

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

注：自5.0.0.0开始需要安装CMILib前置插件

旧版本的Residence不支持1.8以上的Minecraft服务器，本页面仅适用于新版本。

特性

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

安装与配置

安装

将下载的领地插件放入plugins文件夹，运行服务器以生成必要的文件。
保持默认的设置即可正常使用，无需手动添加权限，若要修改设置请参见下方的配置文件说明。

配置文件说明

config.yml

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
    # 是否只允许服务器管理员修改领地
    AdminOnlyCommands: false
    # 是否将服务器管理员设为领地插件的管理员
    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
    # 实验性功能 - 下列方块列表用于自定义检查"container"和"use"属性的方块ID（一般用于模组服务器）
    CustomContainers: []
    CustomBothClick: []
    CustomRightClick: []

groups.yml

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
           # 是否允许该组玩家访问自己领地的物品黑名单/忽略名单
           ItemListAccess: true
       # 以下为进出领地时的提示消息设置项
       Messaging:
           # 是否允许玩家更改进出领地时的提示消息
           CanChange: true
           # 此组玩家创建领地时默认的进入领地提示消息
           # 留空此项以禁用
           DefaultEnter: Welcome %player to %residence, owned by %owner.
           # 此组玩家创建领地时默认的离开领地提示消息
           # 留空此项以禁用
           DefaultLeave: Now leaving %residence.
       # 以下为出租系统设置项
       Lease:
          # 最多允许出租的天数
          MaxDays: 16
          # 当使用 '/res lease renew' 指令时续期的天数
          RenewIncrement: 14
       # 以下为租赁系统设置项
       Rent:
           # 此组玩家一次最多可租赁的领地数
           MaxRents: 3
           # 此组玩家一次最多可出租的领地数
           MaxRentables: 3
           # 此组玩家可出租领地的最长天数
           MaxRentDays: 31
       # 以下为领地经济系统设置项
       Economy:
          # 是否允许此组玩家购买其他玩家出售的领地
          CanBuy: true
          # 是否允许此组玩家出售领地
          CanSell: false
          # 是否在玩家购买领地时忽略领地大小/数量
          IgnoreLimits: false
          # 创建/扩大领地时每方块的价格
          BuyCost: 0.5
          # 删除领地时每方块返还的价格
          SellCost: 0.25
          # 续租领地时每方块的价格（如果启用了租赁系统的话）
          RenewCost: 0.2
       # 标记按顺序识别:
       # 1: 玩家
       # 2: 组
       # 3: 所有者
       # 4: 如果其它项均未定义，则使用默认值（通常为true）
       # 标记权限默认为false
       # 以下标记设置优先级高于全局设置
       Flags:
          # 指定此组玩家是否可以更改某些标记
          Permission:
               #build: true
          # 指定领地创建时对此组玩家默认应用的标记
          Default:
              #build: true
          # 指定领地创建时对创建者默认应用的标记
          CreatorDefault:
              #build: true
          # 指定领地创建时对其他组玩家默认应用的标记
          GroupDefault:
               #default: #组名
                   #build: false
          # 当处于领地外时，这些标记会被立即应用于此组玩家
          # 除了全局设置之外，这些标记的优先级最高
          World:
                Global: #以下标记会被应用于所有世界
                     #build: false
                WorldNameHere: #你也可以为每个世界分别设置
                     #build: false
    NextGroup: #组名，玩家必须拥有residence.group.nextgroup权限节点才能使用此组权限
       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

# 你可以在这里手动为玩家指定Ta所属的组，此项优先级高于权限组
GroupAssignments:
     bekvon: default
     player: default

flags.yml

# 以下为领地插件全局设置
Global:
    # 以下为领地外应用的世界标记
    Flags:
        Global: # 全局设置，除非在下面定义，否则全部为默认设置（可在组设置内覆盖）
            use: true
            build: true
            ignite: true
            firespread: true
            damage: true
            creeper: true
            tnt: true
            pvp: true
        WorldNameHere: # 你可以在这里为每个世界分别配置标记，优先级高于全局设置
            #build: true
    # 以下配置给予所有组更改标记的权限，除非为某个组单独配置
    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
    # 以下设置定义了在可视化界面中每个标记显示的物品样式，未定义则使用灰色羊毛
    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
    # 以下为默认应用至所有组的领地标记
    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
    # 以下为默认应用至创建者的领地标记
    CreatorDefault:
        build: true
        move: true
        use: true
        ignite: true
        container: true
        animalkilling: true
        mobkilling: true
        vehicledestroy: true
        trade: true
        shear: true
        leash: true
     # 以下为组内玩家创建领地时默认应用至此组的领地标记
    GroupDefault:
        #default: # 组名
            #build: true
     # 以下为组标记，当玩家使用 /res pset 昵称 redstone true时，玩家会得到列表内的标记，设置为false亦然
    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: # 在这里你可以创建黑名单/白名单
     DefaultList: # 列表名不重要，只要它是独一无二的，当然具有辨识性的名称更好 
        # 列表类型，可为blacklist，whitelist或ignorelist
        Type: blacklist
        # 可以根据需要将列表应用于特定世界或所有世界
        #World: world
        # 可以根据需要将列表应用于特定组或所有组
        #Group: default
        # 这是允许/禁止的物品具体名称列表
        # 你可以使用/res material <id>来查询对应的物品具体名称
        # 相对的，你也可以使用数字ID，但这样不方便辨别你到底允许/禁止了些什么
        Items: 
           - 'BEDROCK'
           - 'LAVA'
           - 'WATER'
           - 'STATIONARY_LAVA'
           - 'STATIONARY_WATER'
           - 'MOB_SPAWNER'


插件权限

权限 介绍 默认使用者
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 给玩家使用/resadmin的权限 OP
residence.topadmin 给玩家使用 /resreload 和 /resload commands的权限 OP
residence.admin.tp 允许无视tp权限 OP
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 允许使用 /res rt 命令 Default
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 允许无视禁止飞行设置

注意事项

  1. 若使用Vault和WorldEdit，建议使用最新版本，否则可能出现各种问题。
  2. 若使用多世界插件（Multiverse-Core或Multiworld），必须在config.yml的“MultiWorldPlugin:”后填写（如：MultiWorldPlugin: Multiverse-Core），否则会出现重启服务器领地不保存的问题。
  3. 1.8版本以下不支持ActionBar功能，插件默认开启此功能，可在config.yml中设置关闭（UseActionBar: false）

插件获取

此插件为SpigotMC上的付费插件，价格为9.99欧元（约合76.4RMB），作者在SpigotMC的页面中放出了不需付费的下载链接，可自行前去寻找。（点击前往）
欲及时获知新版本及新版特性，可去mcbbs.net服务器插件区搜索“Residence”收藏搬运帖。

已知Bug及应对方案

利用/res select shift命令将领地选区移至无限远导致服务器崩溃

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

应对方案：

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

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

取自“https://mineplugin.org/index.php?title=Residence&oldid=18313”