查看“Residence”的源代码

== 插件简介 ==
Residence 是一款常见的领地管理插件。

（待补充）

== 命令介绍 ==
此插件的大多数操作需要使用命令完成。以下将提供有关此插件的多数命令帮助（即玩家在 SLS 生存服务器中可能会用到的指令；不包括部分使用频率较低的命令或需要服务器管理员权限的命令），其中较常用或者较重要的内容会以蓝色字体标出。

注：以下命令中，若不写领地名，则默认为你当前所在位置的领地。

=== <font color=#3388CC>帮助类命令 ===
* /res - 显示帮助的第一页。
* /res ? [页数] - 显示帮助的某一页（不填页数则默认为第一页）。问号必须是半角问号（下同）。
* /res <某命令> ? - 显示关于某命令的用法。</font>

=== 选择类命令 ===
<font color=#3388CC>主手持用木锄时，你可以对方块分别使用【破坏】键（默认为鼠标左键或触控长按）和【使用】键（默认为鼠标右键或触控单击）来将此方块标记为选择的起点或终点。</font>

* /res select [x] [y] [z] - 选择领地的长方体区域（其中 X、Y、Z 都是以你当前位置为中心延伸出的距离）。
** /res select chunk - 直接选取你所在的整个区块。
** /res select vert - 把选区在高度方向上延伸到从 y = 256 到 y = -64（即建筑高度的上下限）。
** /res select size - 显示已选择区域的尺寸。
** /res select expand [格数] - 向你的前方延伸选区。
** /res select shift [格数] - 向你的前方移动选区。

=== 创建类命令 ===

* /res area (add|remove|replace) <领地名> [区域ID] - 向某领地中增加 | 去除 | 替换区域。可与同一领地内的区域重合。
* <font color=#3388CC>/res create <领地名> - 创建一个领地。你必须先选择好领地的区域。领地名不能和已有领地重复。在 SLS 中，每个账号至多可以拥有 6 个领地。</font>
** /res auto - 自动（以你为中心）创建领地。你不必先选择好领地的区域。
* /res remove [领地名] - 移除一个你的领地。
** /res removeall - 移除你的所有领地。
* /res subzone <领地名> [子区域名] - 在某领地内创建一块子区域。仅领地所有者可用。

=== 信息类命令 ===

* /res area list [领地名] - 列出某领地的所有区域。　　
** /res area listall [领地名] - 列出某领地的所有区域以及它们的坐标。　
* <font color=#3388CC>/res info <领地名> - 显示关于某领地的信息。</font>
** /res current - 显示关于你所在的领地的信息。
* /res list - 显示你拥有权限的领地。
* /res limits - 显示你拥有与此插件相关命令的使用权限。
* /res sublist - 显示你所在领地的所有子区域。

=== 权限类命令 ===

* /res gset <领地名> [群组名] [权限] [true|false|remove] - 设置某领地对于某群组的权限。
** /res lset <领地名> [黑名单|忽略名单] [纹理] - 从某领地的黑名单 | 忽略名单中增加或移除某纹理。
** /res lset <领地名> info - 显示某领地的黑名单 | 忽略名单设置。
* <font color=#3388CC>/res pset <领地名> [玩家名] [权限] [true|false|remove] - 设置某领地对于某玩家的权限。</font>
** <font color=#3388CC>/res pset <领地名> [玩家名] admin true - 将某领地的管理员权限赋予某玩家。</font>
** /res give [领地名] [玩家名] - 将某领地的所有权转赠给某玩家（目标玩家必须在线，且设置领地数量未达到上限）。
* <font color=#3388CC>/res set [领地名] [权限] [true|false|remove] - 设置某领地的（某项）权限。</font>
** <font color=#3388CC>你可以直接使用</font> /res set [领地名] <font color=#3388CC>，不填具体权限。这样即可弹出一个可视化 GUI 窗口——使用鼠标以及 Shift 键即可快捷设置各项权限。</font>
** /res default [领地名] - 将某领地的权限设置全部重置为默认值。

=== 其他命令 ===

* /res message [领地名] [enter|leave] [信息] - 设置玩家进入 | 退出某领地时会收到的信息。
** /res message [领地名] remove [enter|leave] - 移除玩家进入 | 退出某领地时会收到的信息。
** /res mirror [源领地名] [目标领地名] - 复制源领地的权限设置至目标领地。
* /res rename - [旧名称] [新名称] 重命名领地（对于子区域，旧名称必须写全名，新名称可以只写子区域名）。
** /res renamearea [领地名] [旧名称] [新名称] - 重命名某领地中某子区域的名称。
* /res rt - 将你传送到到一个附近没有领地的随机位置（此位置不会离世界出生点较远，然而大概率可能将你传送到世界出生点附近的空置域或受保护区域，因此不推荐使用此命令）。
* <font color=#3388CC>/res tp [领地名] - 传送至某领地。</font>
* <font color=#3388CC>/res tpset - 将当前领地的传送点设为你站立的地方。</font>
* /res unstuck - 将你从当前领地移出（可用于脱离卡点）。