查看“Residence”的源代码

==概览==
===关于===
   Residence不同于其他大多数的保护类插件，它旨在让用户能够自行保护他们自己的家而不需要麻烦管理员进行操作。     
   Residence支持很多种类的保护项目，包括限制地区内的移动,领地的拥有者可以配置这些保护项目，但同时仍受限于管理员。

===链接===
  Vault: Vault
GitHub资源:
GitHub
IRC discussion channel: irc://irc.esper.net/Residence
  Development builds of this project can be acquired at the provided
continuous integration server
. 
   这些开发版本还没有被BukkitDev的职员正式认可.使用时自负风险。

===拓展插件===
   Dynmap Residence
- 动态地图插件使得领地信息可以显示在网页地图中.
   ResExtras - 增加雪，冰，动物，怪物以及更多可以控制的项目.
   Residence Fly - 领地内控制飞行的开启/关闭，当玩家离开领地时，将会失去飞行能力.
   Residence Signs - 使用木牌实现购买，售卖，租赁领地的便捷功能.
   ResTown - 设置城镇型领地，使得领地外的建设行为纳入控制.(设置哪些玩家可以不受领地限制，在领地外能够建设)
   ResProtect - 通过权限保护领地内动物.
   ResCreative - 进入领地时激活创造模式.
   ResPerm - 添加更多的个人领地权限节点.
    
   SimpleClansResidence
- 合并领地与简易的家族两个插件的特性.
  Flags - 显然，这个拓展添加了旗帜或其它东西.

===贡献===
  smbarbour (代码编译)
inorixu (代码编译)
lemon42 (代码编译)
Daniel Few (Wiki编写)
Linaks (Residence图标设计)
SirHedgehog (代码编译)
GSValore (代码编译)
Samkio (Wiki音频)
JustinGuy (代码编译)
Tonkovich (代码编译)

===捐助===
   Donations
   如果你感谢我这些年来对插件的更新与维护，你可以自愿地捐助一些钱来作为谢意。

==使用==
===权限===
  注1：本条目中的“越权”指无视当前领地的权限设置，直接使命令生效。
  注2：true即启用，false即关闭。

====管理员权限====

residence.admin:
  描述: 给你使用/resadmin命令的权限
  默认开启: op

子权限:
  residence.admin.tp: true
  描述: 允许越权使用强制TP命令
  默认开启: op

  residence.admin.move: true
  描述: 允许越权在领地中移动
  默认开启: op

  residence.commands.admin: true
  描述: 允许应用默认的基础权限设置
  默认开启: true

====管理员命令权限====

residence.commands.admin:
  描述: 允许使用管理员的命令
  默认开启: op

子权限:
  residence.commands.user: true
  residence.commands.setowner: true
  residence.commands.listallhidden: true
  residence.commands.server: true

====用户权限====

residence.user:
  描述: 允许应用默认的基础权限设置
  默认开启: true

子权限:
  residence.commands.user: true
  residence.flags.*: true

====用户命令权限====

residence.commands.user:
  描述: 允许使用普通用户的命令
  默认开启: op

子权限:
  residence.commands.create: true
  residence.commands.select: true
  residence.commands.remove: true
  residence.commands.subzone: true
  residence.commands.gui: true
  residence.commands.sublist: true
  residence.commands.compass: true
  residence.commands.info: true
  residence.commands.current: true
  residence.commands.set: true
  residence.commands.pset: true
  residence.commands.rset: true
  residence.commands.rentlink: true
  residence.commands.rentlinks: true
  residence.commands.rename: true
  residence.commands.unstuck: true
  residence.commands.mirror: true
  residence.commands.defualt: true
  residence.commands.list: true
  residence.commands.listall: true
  residence.commands.tp: true
  residence.commands.tpset: true
  residence.commands.market: true
  residence.commands.give: true
  residence.commands.message: true
  residence.commands.clearflags: true
  residence.commands.tool: true

====命令权限====

residence.commands:
  描述: 允许使用所有命令
  默认开启: op
子权限:
  residence.commands.admin: true

residence.commands.create:
  描述: 允许创建领地
  默认开启: op
子权限:
  residence.commands.select: true

residence.commands.select:
  描述: 允许选择一个地区来创建领地
  默认开启: op

residence.commands.remove:
  描述: 允许删除领地
  默认开启: op

residence.commands.setowner:
  描述: 允许设置领地拥有者
  默认开启: op

residence.commands.subzone:
  描述: 允许创建子领地
  默认开启: op

residence.commands.gui:
  描述: 暂时无效
  默认开启: op

residence.commands.sublist:
  描述: 允许你查看子领地列表
  默认开启: op

residence.commands.compass:
  描述: 允许你设置指南针指示领地方向
  默认开启: op

residence.commands.info:
  描述: 允许你查看领地信息
  默认开启: op

residence.commands.current:
  描述: 查看你现在所处的领地
  默认开启: op

residence.commands.set:
  描述: 允许你设置领地的flags
  默认开启: op

residence.commands.pset:
  描述: 允许你设置玩家flags
  默认开启: op

residence.commands.rset:
  描述: 允许你设置租赁flags
  默认开启: op

residence.commands.rentlink:
  描述: 允许你通过rentlink把子领地租赁给另一个人
  默认开启: op

residence.commands.rentlinks:
  描述: 允许你查看领地内的rentlinks
  默认开启: op

residence.commands.rename:
  描述: 允许重命名领地
  默认开启: op

residence.commands.unstuck:
  描述: 允许你在领地里脱离卡死
  默认开启: op

residence.commands.mirror:
  描述: 允许你继承另一个领地的权限
  默认开启: op

residence.commands.defualt:
  描述: 允许你把领地的权限设置为默认
  默认开启: op

residence.commands.list:
  描述: 允许查看自己领地的列表
  默认开启: op

residence.commands.listall:
  描述: 允许查看所有领地列表
  默认: op

residence.commands.listall.hidden:
  描述: 允许你查看隐藏领地
  默认: op

residence.commands.tp:
  描述: 允许使用/res tp
  默认: op

residence.commands.tpset:
  描述: 允许设置领地传送点
  默认: op

residence.commands.market:
  描述: 允许使用交易命令
  默认: op

residence.commands.give:
  描述: 允许赠送领地
  默认: op

residence.commands.message:
  描述: 允许设置领地信息
  默认: op

residence.commands.clearflags:
  描述: 允许你清楚领地flags
  默认(开启): op

residence.commands.tool:
  描述: 允许查看圈地工具
  默认(开启): op

residence.commands.server:
  描述: 允许建立服务器领地
  默认(开启): op

residence.flags.*:
  描述:允许设置所有的领地权限   
  默认(开启): op

residence.flags.FLAGNAME:
  描述:允许设置FLAFGNAME这个领地权限(替换为特定的领地权限名)
  默认(开启): op

===配置文件===
注：以下配置文件均来源于Residence V2.6.6.6版本，仅做参考!
#这些是Residence插件的全局设定.
Global:
    # 这是在Residence语言文件夹中加载的语言文件 <你想设置的语言>.yml 
    # 所有 Residence 的文本均来源于此(NOT DONE YET)
    Language: English
    #木锄是Residence默认的选择工具.
    # 你可以选择另外一个列表中的物品的ID http://www.minecraftwiki.net/wiki/Data_values
    SelectionToolId: 290
    # 这是你想用来查看领地信息的工具 默认为线.
    # 简单的选中这个工具并且在你想要查询的领地区域内单击一下地面，聊天栏内就会出现领地的信息
    InfoToolId: 287
    # 移动权限检查间隔, 以毫秒（ms）为单位.
    # 减少这个数值将会增加服务器负担.
    # 增加这个数值将会允许玩家在被传送走之前无移动权限下走的更远.
    MoveCheckInterval: 500
    # 保存领地间隔，单位: 分钟(min)
    SaveInterval: 10
    # 默认权限组
    DefaultGroup: default
    # 开启/关闭租赁系统
    UseLeaseSystem: false
    # 检查租赁间隔，单位: 分钟(min)
    LeaseCheckInterval: 10
    # 当玩家有足够的钱的时候自动续租，如果禁止了Economy的话，这个设置会没有卵用
    LeaseAutoRenew: true
    # 是否允许用权限系统连接配置
    EnablePermissions: true
    # 如果不用Permissions或者PermissionsBukkit请把这项设置为true，或者使用更老的Permissions版本
    LegacyPermissions: false
    # 开启/关闭领地Economy系统(支持iConomy, MineConomy, Essentials, BOSEconomy, 和 RealEconomy)
    EnableEconomy: true
    # 允许/禁止租赁系统
    EnableRentSystem: false
    # 检查领地租赁时间的间隔(单位: 分钟)
    RentCheckInterval: 10
    # 开启/关闭领地聊天频道
    ResidenceChatEnable: true
    # 领地聊天的颜色
    ResidenceChatColor: DARK_PURPLE
    # 是否无视基本权限flags并且只允许OP和'residence.admin'权限的人修改领地
    AdminOnlyCommands: false
    # 设置为true使OP获得admin权限
    AdminOPs: true
    # 这个是你所使用的多世界插件的名字，如果你没有多世界插件，请无视
    # 这个配置用来检查多世界插件是不是优先于领地插件启动，用来确保领地在其他世界正常运行
    MultiWorldPlugin: Multiverse-Core
    # 设置成true使子领地继承父领地的flags
    ResidenceFlagsInherit: true
    # 设置成false将允许正在租赁的玩家修改领地
    PreventRentModify: true
    # 设置成false将使领地插件在错误后继续加载
    StopOnSaveFault: true
    # 这是领地名字的筛选器，用来筛选掉不要的字符。搜索"Java RegEx"或者"Java正则表达式"获知他是如何运行的
    ResidenceNameRegex: '[^a-zA-Z0-9\\-\\_]'
    # 设置成true使领地租赁时长检查输出到后台
    ShowIntervalMessages: false
    # [测试中] 这个设置是用来把mod的方块加入"container"和"use"flags的
    CustomContainers: []
    CustomBothClick: []
    CustomRightClick: []
    # 这是玩家不在领地里面的flags
    Flags:
        Global: #这是除下方指出的世界默认的flags，优先于任何一个权限组
            use: true
            build: true
            ignite: true
            firespread: true
            damage: true
            creeper: true
            tnt: true
            pvp: true
        在这里输入世界名: #你可以在这里设置特殊的世界flags，这些flags优先于Global
            #build: true
    # 这个给所有用户组默认权限，除了被特殊禁止
    FlagPermission:
        move: true
        build: true
        place: true
        destroy: true
        use: true
        container: true
        pvp: true
        tp: true
        ignite: true
        firespread: true
        bucket: true
        flow: true
        lavaflow: true
        waterflow: true
        creeper: true
        tnt: true
        monsters: true
        animals: true
        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: false
        burn: true
        explode: false
        fireball: true
    # 这是所有领地对任何用户默认的flags
    ResidenceDefault:
        build: false
        use: false
        container: false
        pvp: false
        tnt: false
        creeper: false
        flow: false
        piston: false
        ignite: false
        firespread: false
    # 这是领地所有者默认的flags
    CreatorDefault:
        build: true
        move: true
        use: true
        ignite: true
        container: true
     # 这是默认组内用户在领地中的默认权限
    GroupDefault:
        #default: #组名
            #build: true
    
# 这些在'<世界名>.yml'的组的固定权限
Groups:
    Default: #group name
       # 关于领地可以固定的玩家的信息
       #取消注释下面的线可以把配置镜像到其他组
       #Mirror:
         #- 'group1'
         #- 'group2'
       Residence:
           # 确定这个权限组是否能创建领地。这个配置可以被'residence.create'覆盖
           CanCreate: true
           # 玩家可拥有的最大领地数量
           MaxResidences: 3
           # 玩家可拥有的最大区域数量
           MaxAreasPerResidence: 2
           # 领地最大东西方向(X轴)方块数量
           MaxEastWest: 16
           # 领地最大南北方向(Z轴)方块数量
           MaxNorthSouth: 16
           # 领地最大高度(Y轴)方块数量
           MaxUpDown: 256
           # 最低高度
           MinHeight: 0
           # 最高高度
           MaxHeight: 255
            # 子领地最大包含数
            # 领地内的子领地在另一个子领地中的深度是2
            # 设置为0可以禁止子领地
           SubzoneDepth: 3
           # 是否允许传送到领地
           CanTeleport: true
           # 当你卡在领地里时是否允许使用'/res unstuck'
           Unstuck: true
           # 是否允许使用'/res select'，如果禁止的话将只能用圈地工具
           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
       # 领地经济系统设置
       Economy:
          # 是否允许玩家购买其他销售的领地
          CanBuy: true
          # 是否允许玩家销售领地
          CanSell: false
          # 购买领地时是否忽略领地最大数和大小
          IgnoreLimits: false
          # 每方块创建新的领地或者加入区域的费用
          BuyCost: 0.05
          # 每方块续租费用(如果启用了租赁系统)
          RenewCost: 0.02
       # Flags的检查优先级:
       # 1: Player
       # 2: Group
       # 3: Owner
       # 4: 如果其他的都不存在，默认为true
       # Flags权限默认是false
       # 这些权限设置优先于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

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

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'
# Used to determine which major revision of Residence this config is from, dont change this.
ResidenceVersion: 2