CannaTaleEssentials

CannaTaleEssentials

CannaTaleEssentials 是一个为 Hytale 服务器 设计的实用工具包：包含家、传送点、传送、消息、管理员工具和生活便利命令，专门为与服务器的管理流程顺畅配合而打造。

必需依赖

本模组依赖于 CannaTalePermissions（在 manifest.json 中声明为必需）

• 确保在 Essentials 注册命令之前，权限系统已可用
• 让工作人员/管理员权限使用统一的系统进行管理

包含功能

玩家生活便利（无需权限）

• 出生点传送：/spawn
  • 使用世界的真实出生点提供器（与新玩家使用的出生点系统相同）
  • 必要时会回退到 Essentials 存储的出生点（通过 /setspawn 设置）
• 家
  • /sethome [名称]、/home <名称>、/delhome <名称>、/homes
  • 每个玩家单独存储在 data.json 中
• 传送点
  • /warp <名称>、/warps
• 传送请求
  • /tpa <玩家>（传送到对方位置）
  • /tpahere <玩家>（请求对方传送到你位置）
  • /tpaccept [玩家]、/tpdeny [玩家]、/tpcancel
  • 请求在 60 秒后自动过期，且每个请求方→目标方只保留一个未处理的请求
• 私信
  • /msg <玩家> <消息...>
  • /reply <消息...>（回复最后一位私信对象）
• 返回
  • /back 返回上次保存的位置
  • 仅当通过 CTE 命令传送时才会保存位置（不影响其他传送系统）
• 在线列表
  • /who 列出在线玩家

工作人员工具（需要权限）

• 工作人员频道
  • /staffchat <消息...>（别名：/sc）
  • 仅向具有工作人员权限节点的玩家广播消息
• 即时工作人员传送
  • /tpo <玩家>（瞬间传送到玩家位置）
  • /tpohere <玩家>（瞬间将玩家传送到你位置）
• 隐身（持久化）
  • /vanish（别名：/v）
  • 使用每个观察者的 HiddenPlayersManager 来显示/隐藏隐身玩家
  • 重连后依然保持状态
  • 隐身时在屏幕显示一个小型 HUD 指示器
• 飞行
  • /fly 通过 MovementManager 设置切换飞行模式
  • 重连后依然保持状态，并在插件重新加载时重新应用

管理工具（需要权限）

• 设置出生点
  • /setspawn 将世界出生点设置为当前位置（使用与世界配置相同的底层出生点提供方法）
  • 同时同步 Essentials 的回退出生点
• 传送点管理
  • /setwarp <名称>
  • /delwarp <名称>

CTE 使用的权限

CTE 有意保持权限系统简洁：

• cannatale.essentials.staff - 工作人员工具（工作人员频道、隐身、飞行、tpo/tpohere）
• cannatale.essentials.staff.admin - 管理工具（设置出生点、设置传送点、删除传送点）

数据 / 文件

创建于插件数据文件夹中：

• data.json - 一个简单的 JSON 数据文件，存储：
  • 出生点回退位置
  • 传送点
  • 家
  • 持久化的隐身状态
  • 持久化的飞行状态

贴心设计：/cte 帮助中心

• /cte（别名：/ct）是一个帮助/使用命令，列出可用命令
• 仅在查看者拥有相应权限节点时，才会显示工作人员/管理员部分