endstone-easyhotpotato 0.1.2

📖 简介

EasyHotPotato 是一个专为 EndStone 服务器设计的烫手山芋游戏插件，提供了一个刺激有趣的多人竞技游戏体验。玩家需要在限定时间内将"烫手山芋"传递给其他玩家，避免在自己手中爆炸。插件支持自动游戏流程管理、玩家战绩记录、排行榜系统、粒子特效、音效反馈和BossBar倒计时等功能，为服务器玩家提供完整的游戏体验。

✨ 核心特性

🗂️ 目录结构

服务器根目录/
├── logs/
│   └── EasyHotPotato/                    # 日志目录
│       └── easyhotpotato_YYYYMMDD.log    # 主日志文件
├── plugins/
│   ├── endstone_easyhotpotato-x.x.x-py3-none-any.whl  # 插件主文件
│   └── EasyHotPotato/                    # 插件资源目录
│       ├── config/
│       │   └── config.json               # 配置文件
│       └── data/                         # 数据目录
│           ├── player_stats.json         # 玩家战绩数据
│           └── game_history.json         # 战局记录数据

🚀 快速开始

安装步骤

1. 下载插件

   • 从 Release页面 下载最新版本
   • 或从 MineBBS 获取

2. 安装插件

   # 将插件主文件复制到服务器 plugins 目录
   cp endstone_easyhotpotato-x.x.x-py3-none-any.whl plugins/
   

3. 启动服务器

   • 重启服务器或使用 /reload 命令
   • 插件会自动生成默认配置文件和数据目录

⚙️ 配置详解

配置文件位于：plugins/EasyHotPotato/config/config.json

📋 主要配置项

{
  // 📍 等待中心坐标
  "waitPos": {
    "x": 0,
    "y": 0,
    "z": 0,
    "dimid": 0
  },

  // 📍 竞技中心坐标
  "gamePos": {
    "x": 100,
    "y": 64,
    "z": 100,
    "dimid": 0
  },

  // 📏 活动半径
  "areaSize": {
    "x": 10,
    "z": 10
  },

  // ⏰ 游戏参数
  "waitTime": 120,    // 满人后的预备等待时间（秒）
  "preTime": 10,      // 正式开赛前的热身倒计时（秒）
  "gameTime": 180,    // 游戏时长（秒）

  // 👥 玩家数量设置
  "minPlayers": 2,    // 触发自动开赛的最低人数
  "maxPlayers": 0     // 最大参与人数，0表示无上限
}

🎮 命令手册

玩家命令

管理员命令

🎯 游戏规则

1. 加入游戏：通过主菜单进入战场，等待其他玩家加入
2. 游戏开始：达到最低人数后，经过等待时间和热身倒计时后游戏正式开始
3. 传递山芋：持有山芋的玩家必须通过物理攻击其他玩家来传递山芋
4. 山芋爆炸：每轮都有随机的倒计时，计时器归零时山芋爆炸，淘汰当前持有者
5. 区域限制：离开比赛区域将立即判负
6. 游戏胜利：最后剩下的玩家获得胜利
7. 战绩记录：胜场最多的玩家将登上排行榜

🔧 高级功能

🎨 粒子特效

插件为山芋持有者提供持续的火焰粒子效果，并在淘汰时播放爆炸粒子效果，增强游戏视觉体验。

🔊 音效反馈

• 传递音效：山芋传递时播放火焰射击音效
• 爆炸音效：山芋爆炸时播放爆炸音效
• 倒计时音效：最后5秒播放经验音效，声调逐渐升高

📊 BossBar显示

• 等待阶段：显示当前玩家数量和所需最低人数
• 倒计时阶段：显示游戏开始倒计时
• 游戏进行中：显示山芋持有者和剩余时间
• 淘汰提示：显示被淘汰玩家信息

🛠️ 故障排除

常见问题

📊 日志文件说明

📄 许可证

本项目采用 AGPL-3.0 许可证开源。

版权所有 (c) 2023 梦涵LOVE

本程序是自由软件：您可以自由地重新发布和修改它，
但必须遵循AGPL-3.0许可证的条款。

完整许可证文本请参阅 LICENSE 文件。

👥 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 项目仓库
2. 创建功能分支

   git checkout -b feature/AmazingFeature
   

3. 提交更改

   git commit -m 'Add some AmazingFeature'
   

4. 推送分支

   git push origin feature/AmazingFeature
   

5. 创建 Pull Request

🌟 支持与反馈

• GitHub Issues: 提交问题
• MineBBS: 讨论帖
• 作者: 梦涵LOVE