ℹ️基础指令

Residence的指令基本上都遵守以下规则：

/res <二级指令> [领地命名] [其他参数...]

· 若玩家在一个领地内，则可忽略“领地命名”参数，忽略后直接指定为当前领地；

· 若玩家不在自己指定的领地内，则必须输入“领地命名”参数；

· 标*星号*的指令仅限领地拥有者和管理员使用。

· 指令运行失败，返回消息大多数都为“无效的领地...”，原因大多数为待操作的目标领地非自己所属或不存在。

运行能够修改领地属性的指令时，建议最好位于需要修改的领地范围内，以减少指令执行异常的可能性；

→ 创建一个领地

/res create <领地命名>

1 创建领地前，请用圈地工具选定两个点确定圈地区域；

2 创建领地需要消耗资金，在选择第二个点后，Residence将会在物品栏上方（ActionBar）短暂地显示圈地费用，请确认资金是否足够用于圈地；

3 创建领地时的名称不能与已有领地的名称相同；

4 只能使用数字、字母和规定的英文符号（短横线-、下划线_、感叹号!、问号?）对领地进行命名。使用不合规的命名，管理员将对其强制改名、删除领地，直至禁止圈地。

→ 移除一个领地

/res remove <领地命名>

1 为避免误用指令，这条指令需要二次确认才可生效，需要再次输入/res confirm确认移除；

2 只能移除自己创建的领地；

1 完成移除的领地不能恢复；

2 移除领地不会退还星穗，请在圈地时确认选区是否合适。

→ 选区

创建领地时，必须告诉插件你需要多大的领地面积和位置，因此需要先进行选区操作。

↘ 使用圈地工具选区（推荐）

操作方法：左键确定第1个点，右键确定第2个点，这两个点可确定一个长方体的空间对角线，即一个长方体选区。

需要更清晰地显示领地区域，请安装WorldEditCUI模组。

↘ 使用指令选区

/res select - 选区指令的一级指令

· 以玩家所站位置为中心，提供三边半棱长值选区

/res select <X_half_length> <Y_half_length> <Z_half_length>

以玩家所处位置坐标为中心，指定3个方向的半棱长长度，最终确定一个长方体选区。

玩家所处位置也需要计入到三边半棱长中(+1)。

· 自动选区模式（不推荐）

/res select auto - 启用/禁用自动选区模式

启用后，插件会开始检测玩家所处坐标，当玩家向一个方向行走时会延伸该方向的选区。

1 若投掷末影珍珠，则选区会延伸到玩家整个实体所在的位置；

2 完成选区后，若再次输入该指令会清除选区。

· 延伸选区

/res select expand <数值> - 向玩家光标所指方向延伸选区到指定长度

· 查看选区大小和创建领地的消耗

/res select size 或 /res select cost

→ 显示领地边界

/res show

1 运行这条指令后，会以粒子特效显示领地边界（粒子显示在长方体选区的棱），在玩家进出领地时也会自动显示；

2 只有在领地范围内才能使用该指令。

→ 显示所在领地的领地名

/res current

→ 显示所在领地的信息

/res info [领地命名]

- 若在一个领地内，“领地命名”参数可忽略，插件将会直接显示所在领地的信息；

- 若不在领地内，必须输入“领地命名”参数。

→ 领地权限指令*

/res set - 领地权限(flag)指令的一级指令

1 要查看可用的权限项目，请输入/res flags；

2 查看领地权限的全部翻译，请查看《领地权限列表》。

↘ 通过指令设置权限*

/res set [领地命名] <flag> <true|false|remove>

1 true为启用该权限；false为禁用该权限；remove为移除设定；

2 领地设定的权限优先级高于服务器与世界规则；

3 移除权限后，领地内的此权限将遵循服务器设定的世界规则或Minecraft默认规则。

↘ 通过菜单界面设置权限（仅部分权限）*

/res set [领地命名]

1 只有领地所有者可以这么做；

2 点击鼠标左键，将权限设置为true；点击鼠标右键，将权限设置为false；点击鼠标滚轮，将权限设置为remove；

3 菜单界面可能存在翻译不准确的问题，可参照《领地权限列表》进行设置，但一切内容以官方文档和插件实际运行情况为准。没有否定词或否定前缀的权限，设置为true即为启用，设置为false即为禁用；

例如：

mobspawn - （中立）生物是否生成

将其设为true，启用（中立）生物生成；

设置为false，禁用（中立）生物生成；

nomobspawn - 是否禁止生成（中立）生物

将其设为true，禁止（中立）生物生成；

设置为false，不禁止（中立）生物生成。

→ 修改进入/离开领地的消息*

/res message [领地命名] <enter|leave> [文本]

1 只有领地所有者可以这么做；

2 设置完成后，进出领地时文本消息将会显示在对话框；

3 此处可以使用颜色代码；

4 支持占位符变量：

%player - 接收消息的玩家名；

%owner - 领地所有者；

%residence - 领地内部名称；

· 不要将文本参数留空！！若文本参数留空，Residence将输出不可见的消息。如果修改message权限为true仍然看不见消息，请考虑输出内容是否为不可见的空文本；

· 要禁用消息输出，请使用/res message [领地命名] remove [enter|leave]

→ 移除进入/离开领地的消息*

/res message [领地命名] remove [enter|leave]

→ 将权限设定复制到领地*

/res mirror <源领地> <目标领地>

运行指令的玩家必须同时是源领地和目标领地的所有者。

→ 转让领地*

/res give <领地命名> <玩家名>

被转让者必须在线。

→ 重命名领地*

/res rename <领地命名> <新的领地命名>

→ 设置当前位置为领地传送点*

/res tpset

→ 传送到领地

/res tp <领地命名>