查看“Residence”的源代码

== '''插件简介''' ==
'''Residence''' 是一款常见的领地管理插件。它可以让玩家自己保护自己的家园，无需再麻烦管理员。新版的Residence更是增添了许多新特性，为服主减轻了不少负担。

不同于其他的领地插件，Residence提供了很多方便的操作，例如支持设置领地权限时使用GUI操作。是一个对玩家和管理员都十分友好的领地插件。

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

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

=== 帮助类命令 ===
* <font color=#3388CC>/res - 显示帮助的第一页。</font>
* <font color=#3388CC>/res ? [页数] - 显示帮助的某一页（不填页数则默认为第一页）。问号必须是半角问号（下同）。</font>
* <font color=#3388CC>/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 [格数] - 向你的前方移动选区。

=== 创建类命令 ===
<font color="#3388CC">SLS 没有游戏币的设定，因此创建领地无需支付代价，但在创建领地时，请注意不要违反服规。</font>

<font color="#3388CC">每个账号同时至多可以拥有 6 个领地。若你设置领地只是为方便自己传送，建议使用 /sethome 或 /warp 命令，而非 /res create。</font>
* /res area (add|remove|replace) [领地名] <区域ID> - 向某领地中增加 | 去除 | 替换区域。可与同一领地内的区域重合。
* <font color="#3388CC">/res create <领地名> - 创建一个领地。你必须先选择好领地的区域。领地名不能和已有领地重复。</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 [领地名] - 将某领地的权限设置全部重置为默认值。

=== 其他命令 ===

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