EssentialsZZ

EssentialsZZ 功能概览

• 提供管理员即时传送及玩家选择传送界面。
• 提供完整的 TPA 流程，包含请求过期、预热、冷却及聊天支持。
• 提供个人家园和部落家园，支持界面管理、重命名、删除及可配置的数量限制。
• 支持预热和冷却的权限绕过。
• 添加 /admin 管理面板，用于执行踢出、禁言、解除禁言、封禁及解封操作。

指令与操作流程

• /tp 处理管理员传送及传送界面。
• /tpa、/tpaccept 和 /tpdeny 处理传送请求。
• /home、/sethome 和 /delhome 管理家园。
• /admin、/kick、/mute、/unmute、/ban 和 /unban 处理管理操作。
• 中心枢纽会根据玩家权限自动开启传送、请求或家园流程。

运行时文件与数据

• config.json 存储预热时间、冷却时间、家园上限、部落家园设置及管理面板设置。
• messages.json 存储通过 ZZCore 注册的文本目录。
• 模组运行时数据存储于 ZonaZeroMc/ZZEssentials 目录下。
• homes/ 按所有者或作用域存储家园集合。
• moderation/moderation.json 存储封禁、禁言及管理状态信息。

配置示例

以下是模组生成设置时可见的 config.json 文件示例：

{
  "version": 5,
  "teleportEnabled": true,
  "teleportOpenMenuWithoutArgs": true,
  "teleportAllowCrossWorld": true,
  "teleportMenuMaxPlayers": 48,
  "teleportMenuHideSelf": true,
  "teleportMenuShowWorld": true,
  "teleportArrivalYOffset": 0.0,
  "tpaEnabled": true,
  "tpaRequestExpirySeconds": 60,
  "tpaTeleportWarmupSeconds": 3,
  "tpaTeleportCooldownSeconds": 3,
  "homesEnabled": true,
  "clanHomesEnabled": true,
  "maxPlayerHomes": 6,
  "maxClanHomes": 12,
  "homeDefaultName": "main",
  "homeTeleportWarmupSeconds": 3,
  "homeTeleportCooldownSeconds": 3,
  "moderationEnabled": true,
  "adminMenuMaxEntries": 80,
  "moderationDefaultMuteMinutes": 30,
  "moderationDefaultBanHours": 24
}

以下部分以通俗语言解释每项设置的含义。

配置参考

传送设置

• teleportEnabled (true/false)：启用或禁用传送功能。
• teleportOpenMenuWithoutArgs (true/false)：使用 /tp 命令且不带参数时打开传送菜单。
• teleportAllowCrossWorld (true/false)：启用后允许跨世界传送。
• teleportMenuMaxPlayers (数字)：传送选择界面中显示的最大玩家数。
• teleportMenuHideSelf (true/false)：启用后在列表中隐藏执行传送的玩家。
• teleportMenuShowWorld (true/false)：在传送界面中显示世界信息。
• teleportArrivalYOffset (数字)：传送到达时应用的垂直偏移量。

TPA 设置

• tpaEnabled (true/false)：启用或禁用 TPA 流程。
• tpaRequestExpirySeconds (数字)：请求过期时间。
• tpaTeleportWarmupSeconds (数字)：传送完成前的预热时间。
• tpaTeleportCooldownSeconds (数字)：下次传送请求流程可执行前的冷却时间。

家园设置

• homesEnabled (true/false)：启用或禁用个人家园。
• clanHomesEnabled (true/false)：启用或禁用部落家园。
• maxPlayerHomes (数字)：每名玩家可保存的最大家园数量。
• maxClanHomes (数字)：每个部落可保存的最大家园数量。
• homeDefaultName (文本)：模组使用的默认家园名称。
• homeTeleportWarmupSeconds (数字)：传送到家园前的预热时间。
• homeTeleportCooldownSeconds (数字)：家园传送之间的冷却时间。

管理设置

• moderationEnabled (true/false)：启用或禁用管理功能套件。
• adminMenuMaxEntries (数字)：管理菜单中显示的最大条目数。
• moderationDefaultMuteMinutes (数字)：默认禁言时长。
• moderationDefaultBanHours (数字)：默认封禁时长。

权限

• 基础可见性：zzessentials.use
• 传送流程：zzessentials.command.teleport.*
• 家园流程：zzessentials.command.home.*
• 管理流程：zzessentials.command.admin.*

安装方法

1. 先将 ZZCore.jar 复制到服务器的 mods 文件夹中。
2. 然后将 ZZEssentials.jar 复制到同一服务器的 mods 文件夹中。
3. 如需通过生态系统的组织提供者使用部落家园功能，还需安装 ZZClan.jar。
4. 启动 Hytale。
5. 配置预热时间、冷却时间、家园上限及管理权限。

许可协议

版权所有。

未经作者书面许可，禁止重新分发、转载、销售修改版本或重新上传分支版本。