Hugs - 拥抱传递爱意

Hugs 是一款简单而温馨的社交插件，允许玩家在游戏中互相拥抱，传递温暖。它最初为朋友的小服务器而开发，现已更新并支持新版 Minecraft，提供了丰富的自定义选项和稳定的功能。

💡主要特性

• 完全可定制的消息：包括发送者/接收者消息、标题与副标题、服务器广播等。
• 丰富的视觉与听觉效果：可配置的粒子效果（如爱心）和声音。
• 灵活的设置选项：
• 启用/禁用拥抱功能及广播。
• 可配置的冷却时间。
• 可选择在拥抱后恢复接收者的生命值和饱食度。
• 详细日志记录：在控制台和文件中记录插件活动（如谁重载了配置、谁拥抱了谁）。
• 内置重载命令：无需重启服务器即可更新配置。
• 开发者彩蛋：拥抱开发者时可触发特殊消息和奖励。
• 手动更新检查器。
• 支持 PlaceholderAPI：提供多种统计变量。
• 现代化控制台界面：用户友好，支持点击命令，并显示权限状态。

🎮命令列表

以下是所有可用的命令。使用这些命令需要相应的权限。

• /hug <player> - 拥抱指定的玩家。
• /hugs - 插件基础命令，显示插件信息。
• /hugs help - 显示帮助页面及所有可用命令。
• /hugs total - 显示服务器总共送出的拥抱次数。
• /hugs info <player> - 查看指定玩家的拥抱统计信息。
• /hugs reload - 重载插件配置（config.yml 和 messages.yml）。

🎮权限列表

默认情况下，OP 拥有所有权限。如需给予普通玩家权限，请使用权限管理插件。

• hugs.hug - 允许使用 /hug <player>。
• hugs.hug.everyone - 允许使用 /hug *（拥抱所有人）。
• hugs.bypass.normal - 绕过普通拥抱的冷却时间。
• hugs.bypass.mass - 绕过群体拥抱的冷却时间。
• hugs.use - 允许使用 /hugs 和 /hugs help。
• hugs.total - 允许使用 /hugs total。
• hugs.info - 允许使用 /hugs info <player>。
• hugs.update - 允许非 OP 玩家接收插件更新通知。
• hugs.reload - 允许使用 /hugs reload。

❓安装与配置

前置需求

你需要一个权限管理插件来为玩家分配权限，例如

• LuckPerms
• zPermissions
• PermissionsEx
• bPermissions
• GroupManager

安装步骤

**方法一（推荐）**

• 停止服务器。
• 将 Hugs (v2.0).jar 放入服务器的 /plugins/ 目录。
• 启动服务器（插件会自动生成必要文件）。
• 按需编辑 config.yml 和 messages.yml（记得保存）。
• 在服务器中输入 /hugs reload。
• 完成！

**方法二（使用 Plugman）**

• 确保已安装 Plugman。
• 将 Hugs (v2.0).jar 放入 /plugins/ 目录。
• 在游戏中输入 /plugman load Hugs。
• 编辑 config.yml 和 messages.yml。
• 输入 /hugs reload。
• 享受！

> 注意：若非首次安装，请务必删除 /plugins/ 目录下旧的 Hugs 文件夹，以免配置冲突。

配置文件说明

插件包含三个主要文件

• config.yml：核心设置文件（如功能开关、冷却时间、粒子效果）。
• messages.yml：所有消息文本的配置文件，支持颜色代码和占位符。
• data.yml：存储拥抱统计数据，不建议手动修改。

> 提示：修改 config.yml 或 messages.yml 后，使用 /hugs reload 即可生效。由于插件以“只读”方式处理这些文件，编辑器中可能不会弹出“配置已重载”的提示，但功能会正常更新。

✨PlaceholderAPI 支持

若服务器已安装 PlaceholderAPI，可在其他支持 PAPI 的插件中使用以下占位符：

• %hugs_total%：获取服务器送出的拥抱总次数。
• %hugs_player_total_given%：获取玩家送出的拥抱次数。
• %hugs_player_total_received%：获取玩家收到的拥抱次数。
• %hugs_player_total_mass_given%：获取玩家送出的群体拥抱次数。
• %hugs_player_total_mass_received%：获取玩家收到的群体拥抱次数。

> 注意：Hugs 插件本身不支持在它的配置文件中使用其他插件的 PAPI 占位符。

🔧开发构建与支持

• 支持版本：1.14 至 1.18 的支持已在开发构建中提供。
• 开发构建获取：请加入 Discord 频道获取：https://discord.gg/kJyZwBj。
• 更新日志：如需了解每个版本的详细更新内容，请查阅更新日志。

⭐常见问题与计划

未来计划 (v2.1 ToDo)

• 添加 MySQL 数据库支持。
• 优化排行榜功能。

更新频率

更新会尽量适配新版 Minecraft。功能更新则视开发进度和生活情况而定。开发者仍在不断学习 Java，感谢您的耐心。

反馈与支持

如有任何问题、建议或想法，请在插件的讨论区留言，而非评论区。如果您喜欢这个插件，请考虑为其评分或提出建议。

如果您想支持开发者创作更多插件，欢迎捐赠。所有捐赠将用于未来插件的开发。

点击此处捐赠！ （图片也可点击哦 :3）

---

版权声明：您在此确认，ShadowMasterGaming 是 Hugs 插件的创作者并拥有其所有权利。您同意不将其声称为自己的作品，也不以任何形式重新分发。