ZeFreeze - 玩家冻结插件

ZeFreeze 是一款专为现代管理团队设计的可靠冻结检查插件，它能让管理员在调查、活动或检查期间将玩家固定在原地，并提供强大的配置控制和离线玩家支持。

💡核心特性

灵活的冻结目标

• 可冻结单个玩家、全服玩家 (@a 或 all) 或指定半径内的玩家。
• 支持冻结曾经加入过服务器的离线玩家。
• 提供便捷的冻结/解冻切换功能。

全面的行为限制

• 限制移动、交互、造成/承受伤害、放置/破坏方块。
• 可选限制聊天功能。
• 可配置冻结时的药水效果（如失明）。
• 可阻止玩家在冻结期间使用命令（支持白名单）。

管理与控制

• 设置专用的“控制点”位置，用于集中调查。
• 可将被冻结玩家（及管理员）传送至控制点。
• 内置防断开连接GUI，防止玩家通过退出游戏逃避检查。
• 支持配置玩家断开连接时执行的命令（如清空经济或封禁）。

高度可定制

• 可配置所有提示信息、冻结/解冻音效。
• 支持配置文件 (config.yml, messages.yml) 的热重载。
• 提供详细的冻结信息查询（冻结者、原因、位置）。

🎮要求与安装

运行环境

• 服务端核心: Spigot 或 Paper 1.21+
• Java 版本: Java 21+

安装步骤

• 下载最新版本的 ZeFreeze.jar。
• 将文件放入服务器的 plugins/ 文件夹。
• 启动或重启服务器。
• （可选）按需编辑 plugins/ZeFreeze/ 目录下的 config.yml 和 messages.yml 文件。
• 编辑后，可在游戏内执行 /zefreeze reload 重载配置。

🔧命令列表

• /zefreeze - 显示帮助页面。
• /zefreeze help - 显示帮助页面。
• /zefreeze <玩家|@a|all> - 冻结或解冻目标玩家（支持切换）。
• /zeunfreeze <玩家|@a|all> - 解冻命令别名。
• /zefreeze radius <半径> - 冻结或解冻附近玩家。
• /zefreeze control set - 设置控制点位置。
• /zefreeze control <玩家> - 将被冻结玩家（及你自己）传送至控制点。
• /zefreeze info <玩家> - 显示玩家的冻结信息。
• /zefreeze reload - 重载插件配置文件。

✨权限节点

• zefreeze.freeze - 允许冻结玩家。
• zefreeze.unfreeze - 允许解冻玩家。
• zefreeze.info - 允许查看冻结信息。
• zefreeze.control - 允许使用控制点传送功能。
• zefreeze.control.set - 允许设置控制点位置。
• zefreeze.reload - 允许重载插件。
• zefreeze.bypass - 允许玩家免疫被冻结。
• zefreeze.disconnect.alert - 当被冻结玩家断开连接时接收警报。

⭐配置与消息文件

插件所有文本和功能均可通过 config.yml 和 messages.yml 文件自定义。

主要配置选项 (`config.yml`)

• disconnect-action: 配置玩家断开连接时在控制台执行的命令。
• block-commands: 启用命令屏蔽，并可设置命令白名单。
• unfreeze-on-disconnect: 玩家断开连接时是否自动解冻。
• freeze-toggle: 是否启用冻结/解冻切换功能。
• block-y-axis: 是否阻止冻结玩家在Y轴上移动（跳跃/下坠）。
• freeze-sound / unfreeze-sound: 设置冻结与解冻音效。
• **disable-* 系列选项**: 控制冻结期间对各种行为（聊天、交互、伤害等）的限制。
• freeze-effects: 设置冻结时施加的药水效果列表。
• anti-disconnection-gui: 详细配置防断开连接GUI的界面、大小和物品。

消息文件 (`messages.yml`)

此文件包含插件所有发送给玩家和管理员的提示信息，例如：

• prefix: 插件消息前缀。
• player-frozen: 管理员冻结玩家后收到的消息。
• target-frozen: 玩家被冻结时收到的消息。
• move-while-frozen: 玩家尝试移动时的提示。
• help-page: 帮助命令显示的内容。
• 以及各种错误提示，如权限不足、玩家未冻结等。

您可以根据需要自由修改这些消息的格式和颜色代码。

❓支持与反馈

如果您在使用中遇到问题或有建议，欢迎加入我们的 Discord 社区获取支持。如果 ZeFreeze 有效提升了您服务器的管理效率，请考虑为我们留下评价！