Harbor - A Sleep Enhancement Plugin! - Harbor - 睡眠优化插件

Harbor 是一款 Spigot 插件，它重新定义了服务器中的睡眠机制，让所有在线玩家都能更轻松地快速上床睡觉，跳过夜晚！

💡核心特性

Harbor 旨在鼓励玩家睡觉！它最适合安装在生存 SMP 服务器中，让玩家更容易跳过夜晚并防止幻翼攻击！

• 当一定百分比的玩家睡觉时，可以平滑地跳过夜晚（百分比可在配置中自定义）。
• 显示当前睡觉玩家的计数器，以鼓励其他玩家睡觉。
• 当有玩家睡觉时，会在聊天栏或动作栏通知其他玩家。
• 拥有 harbor.bypass 权限的玩家可以被排除在睡眠计数之外。创造模式和旁观者模式的玩家也可以被排除。
• 可以忽略 AFK 玩家，不将其计入睡眠计数。
• 可以禁用幻翼生成！

💡版本支持与重要提示

• 重要提示：更新到 1.6 版本时，您之前的配置文件将无法使用。
• Harbor 1.6+ 仅支持 Minecraft 1.14+。
• 如果需要 1.8 至 1.13 版本支持，请使用 Harbor 1.5.3。

🎮配置概览

我相信所有插件都应该是完全可配置的，因此 Harbor 的每个部分都可以在配置文件中修改！每条消息都支持自定义，并完全支持 Unicode 和颜色代码。

以下是配置文件 (config.yml) 的主要结构：

夜晚跳过设置

• night-skip.enabled: 是否启用夜晚跳过功能。
• night-skip.percentage: 跳过夜晚所需的睡觉玩家百分比 (0-100)。
• night-skip.time-rate: 跳过夜晚时，每游戏刻增加的时间量。
• night-skip.daytime-ticks: Harbor 视为白天的游戏刻时间（默认为 1200，即正午）。
• night-skip.instant-skip: 是否在达到百分比阈值时立即跳过夜晚（跳过动画）。
• night-skip.proportional-acceleration: 是否根据睡觉玩家数量比例加速夜晚跳过速度。
• night-skip.clear-rain / clear-thunder: 跳过夜晚时是否清除雨/雷暴。
• night-skip.reset-phantom-statistic: 跳过夜晚后，是否重置所有在线玩家的“失眠”统计（类似于 1.15+ 的 /gamerule doInsomnia）。

排除规则

• exclusions.ignored-permission: 是否排除拥有 harbor.ignored 权限的玩家。
• exclusions.exclude-adventure / exclude-creative / exclude-spectator: 是否排除处于冒险、创造、旁观模式的玩家。
• exclusions.exclude-vanished: 是否排除隐身玩家。

AFK 检测

• afk-detection.enabled: 是否启用 AFK 检测。
• afk-detection.timeout: 玩家被判定为 AFK 的时长（分钟）。
• 当 Essentials 可用时，会使用其 API 进行检测，否则使用内置的备用系统。

世界管理

• blacklisted-worlds: 黑名单世界列表，Harbor 将忽略这些世界。
• whitelist-mode: 若为 true，则上述列表将作为白名单而非黑名单。

消息系统

消息系统分为聊天栏、动作栏和 Boss 栏，每条消息都可自定义，并支持如 [player]、[sleeping]、[needed]、[more]、[displayname] 等占位符。

• messages.chat.enabled: 启用聊天消息。
• messages.chat.message-cooldown: 玩家发送上床/离床消息的冷却时间（秒）。
• messages.actionbar.enabled: 启用动作栏消息。
• messages.bossbar.enabled: 启用 Boss 栏进度显示。

杂项

• miscellaneous.chat-prefix: 插件聊天消息前缀。
• miscellaneous.unrecognized-command: 未知命令的提示消息。

关于 Essentials 的重要说明：请确保取消 essentials.sleepingignored 权限，以防止 Harbor 与服务器管理员（OP）在运行 Essentials 时产生冲突。

🔧命令与权限

• /harbor reload

重新加载 Harbor 的配置文件。需要权限：`harbor.reload`

• /forceskip

强制跳过当前世界的夜晚。需要权限：`harbor.forceskip`

• /sleeping (1.5 版本新增)

显示一个 GUI，列出当前世界中正在睡觉的玩家。

权限节点

• harbor.bypass: 拥有此权限的玩家不会被计入睡眠计数，也无法触发夜晚跳过。
• harbor.ignored: 如果配置中 exclusions.ignored-permission 为 true，拥有此权限的玩家将被排除在计数外。
• harbor.forceskip: 允许使用 /forceskip 命令。
• harbor.reload: 允许使用 /harbor reload 命令。

✨更新日志摘要

版本 1.6.2

• 重写大部分代码以优化性能。
• 世界检查任务改为异步执行。
• 重构配置文件，使选项更清晰易用。
• 新增睡觉进度 Boss 栏显示。
• 重新实现上床/离床聊天消息，并增加消息冷却。
• 新增 [displayname] 占位符。
• 新增排除隐身玩家选项。
• 新增 /forceskip 命令。
• 新增即时跳过夜晚和比例加速选项。
• 重新实现轻量级备用 AFK 检测系统。
• 新增世界黑名单/白名单功能。
• 天气与雷暴清除选项现在独立。
• 移除自动更新器。

版本 1.6

• 大规模代码改进与简化，完全使用计时器和新版 API。
• 平滑加速跳过夜晚。
• 移除 NMS 代码，插件更轻量。
• 集成 Essentials AFK 检测。
• 修复配置重载和权限问题。

版本 1.5

• 完全重写插件，增加 1.13.2 - 1.14.2 支持。
• 新增禁用幻翼生成功能。
• 新增自动更新器、AFK 玩家检测、标题消息。
• 新增 /sleeping 命令。
• 修复大量数学计算错误。

更早版本的更新内容（如多世界支持、天气清除、动作栏修复等）已整合到当前功能中。

❓常见问题

• 如何更新到 1.6+ 版本？

更新前请备份您的旧配置。安装新版本后，旧的 `config.yml` 将失效，插件会生成一份新的默认配置，您需要根据需求重新自定义。

• 如何排除 OP 或特定玩家？

给予他们 `harbor.bypass` 权限，或在配置中启用 `exclusions.ignored-permission` 并给予他们 `harbor.ignored` 权限。

• 为什么夜晚跳过动画不流畅？

请检查 `night-skip.time-rate` 设置，调高数值可以加速。也可以启用 `proportional-acceleration` 让速度随睡觉人数增加而变快，或启用 `instant-skip` 直接跳过动画。

• 如何禁用某个世界的 Harbor 功能？

在配置文件的 `blacklisted-worlds` 列表中添加该世界名称，或将 `whitelist-mode` 设为 true 并只将需要启用 Harbor 的世界加入列表。

• 与 Essentials 冲突怎么办？

确保为所有管理员/OP 玩家取消 `essentials.sleepingignored` 权限（例如使用权限组插件设置 `-essentials.sleepingignored`）。

---

**链接**

• 项目源码：https://github.com/nkomarn/Harbor
• 示例服务器（使用 Harbor）：

- firestartermc.com

- play.lemoncloud.org

- join.playersassembly.com

- play.treebomc.com

- silverstone.servegame.com

- play.darklandmc.net