PotionGames - 药水游戏：生存竞技插件

PotionGames 是一款基于 Bukkit 的 Minecraft 小游戏插件，其玩法类似于生存游戏，但核心机制围绕药水与状态效果展开！玩家通过开启战利品箱获得各种药水效果，并利用策略在竞技中取胜。

💡核心功能

• 自定义战利品配置
• 为普通箱子类型设置专属战利品表。
• 为开启普通箱子的玩家配置特定的药水效果。
• 创建自定义的箱子类型。

• 特色游戏机制
• 空投补给：使用红石火把激活空投。
• 货币与商店：拾取硬币和玻璃瓶，用于在商店中消费。
• 药水商店：可配置多达 27 种药水供玩家购买。
• 职业套装：可配置多达 26 种职业套装，为商店中的特定药水提供折扣价格。
• 多大厅与竞技场：支持设置 27 个大厅，每个大厅包含 26 个竞技场供每回合投票选择。
• 团队系统：支持自定义团队人数。
• 效果清除：使用牛奶桶清除自身所有药水效果。
• 快速治疗：一键喝汤以恢复生命值。
• 死亡竞赛：游戏内置死亡竞赛阶段。

• 统计与数据
• 使用 SQLite 或 MySQL 存储玩家数据。
• 设置统计墙，展示排名前三的玩家。
• 与 BungeeCord 联动：通过 startOnJoin 选项实现玩家加入即进入游戏。

• 加入方式
• 通过 GUI 界面或告示牌加入大厅。

• 经济奖励（需要 Vault）
• 为获胜和击杀提供游戏内货币奖励。

🎮安装指南

• 下载插件

- 下载最新版本的 PotionGames 插件。

- 将 `.jar` 文件放入服务器的 `plugins` 文件夹。

• 安装 Multiverse-Core（用于地图管理）

- 下载最新版本的 Multiverse-Core 插件。

- 将 `.jar` 文件放入服务器的 `plugins` 文件夹。

- 在 `permissions.yml` 文件中添加权限：`mv.bypass.gamemode.*: true`

• 服务器设置

- 启动服务器以生成配置文件。

- 使用命令 `/mv import [世界名称] NORMAL` 导入你的游戏世界。

- 在 `config.yml` 中根据需要将 `lobbySystem` 设置为 `false`（单大厅）或 `true`（多大厅）。

- 调整 `PotionGames` 文件夹内的 `.yml` 配置文件。

- 重启服务器以使配置更改生效。

🔧基本使用与设置

使用命令 /pg setup 开始插件的基础设置流程。

多大厅系统设置

你需要拥有 OP 权限或 pg.setup 权限。

• 创建大厅：/pg setlobby [大厅编号]
• 创建竞技场：/pg addarena [大厅编号] [竞技场名称]
• 添加竞技场出生点：/pg addspawn [大厅编号] [竞技场名称]
• 在竞技场中放置箱子。
• 添加死亡竞赛出生点：/pg adddeathmatch [大厅编号] [竞技场名称]（需在配置中设置 activateDeathmatch = true）

单大厅系统设置

你需要拥有 OP 权限或 pg.setup 权限。

• 创建大厅：/pg setlobby
• 创建竞技场：/pg addarena [竞技场名称]
• 添加竞技场出生点：/pg addspawn [竞技场名称]
• 在竞技场中放置箱子。
• 添加死亡竞赛出生点：/pg adddeathmatch [竞技场名称]（需在配置中设置 activateDeathmatch = true）

箱子类型说明

• 末地传送门框架：普通箱子（类似生存游戏），包含不同概率的物品分类（如 food1: 20%, weapons1: 20% 等）。
• 标靶：特殊箱子，内含火焰弓和箭矢。
• 下界合金块：特殊箱子，内含下界合金锭。
• 锻造台：用于将钻石装备升级为下界合金装备（在其旁边放置信标可使该位置在全地图显示）。
• 堆肥桶：药水商店（在其下方放置信标可使商店在全地图显示）。

创建加入与统计告示牌

• 加入告示牌：放置一个告示牌并看着它，根据你的大厅系统类型使用对应的命令（见下方命令列表）。
• 统计告示牌：放置一个告示牌，在第二行输入 PotionGames，第三行输入 Stats。

创建统计墙

• 将 3 个玩家头颅并排放在一个方块上。
• 在该方块正面放置 3 个告示牌。
• 使用以下命令创建领奖台：

- 看着领奖台上第 1（2；3）名的头颅，执行：`/pg headp1(2;3)`

- 看着领奖台上第 1（2；3）名的告示牌，执行：`/pg signp1(2;3)`

⭐命令与权限

多大厅系统命令

• /pg, /pg help, /pg commands - 显示命令与权限列表。权限：无
• /pg setlobby [大厅编号] - 设置大厅。权限：pg.setup
• /pg dellobby [大厅编号] - 移除大厅。权限：pg.setup
• /pg addarena [大厅编号] [竞技场名称] - 添加竞技场。权限：pg.setup
• /pg addspawn [大厅编号] [竞技场名称] - 添加出生点。权限：pg.setup
• /pg adddeathmatch [大厅编号] [竞技场名称] - 添加死亡竞赛出生点。权限：pg.setup
• /pg delarena [大厅编号] [竞技场名称] - 移除竞技场。权限：pg.setup
• /pg delspawn [大厅编号] [竞技场名称] - 移除最后一个出生点。权限：pg.setup
• /pg deldeathmatch [大厅编号] [竞技场名称] - 移除最后一个死亡竞赛出生点。权限：pg.setup
• /pg build - 激活建筑模式。权限：pg.build
• /pg pause - 暂停计时器/倒计时。权限：pg.pause
• /pg force [竞技场名称] - 强制选择某个竞技场。权限：pg.force
• /pg start - 将大厅倒计时设置为 10 秒。权限：pg.start
• /pg join [大厅编号] - 加入游戏（当 startOnJoin = false 时）。权限：pg.join
• /pg list - 打开显示所有大厅的 GUI（当 startOnJoin = false 时）。权限：pg.join
• /pg leave - 离开游戏（当 startOnJoin = false 时）。
• /pg stats [玩家名] - 显示玩家统计信息。权限：pg.stats
• /pg version - 显示当前插件版本及最新版本。权限：pg.update
• /pg reload - 重载所有配置文件。权限：pg.setup
• /pg headp1(2;3) - 为统计墙添加玩家头颅。权限：pg.setup
• /pg signp1(2;3) - 为统计墙添加玩家告示牌。权限：pg.setup
• /pg joinsign [大厅编号] - 设置加入告示牌。权限：pg.setup
• /pg setup - 进行插件设置。权限：pg.setup
• 彩色聊天名称（玩家与观察者聊天）：权限 pg.admin
• 查看错误信息：权限 pg.admin
• 更新检查器：权限 pg.update

单大厅系统命令

（命令格式简化，去除了大厅编号参数，其余与多大厅系统类似，例如 /pg setlobby, /pg addarena [竞技场名称] 等。完整列表请参考上方多大厅命令进行类比。）

❓配置详解 (`config.yml`)

以下为部分关键配置项说明

• activateMySQL: false - 数据库选择：false 使用 SQLite，true 使用 MySQL。
• gameServer: true - 服务器类型：true 为游戏服务器，false 为大厅服务器（用于 BungeeCord）。
• lobbySystem: false - 大厅系统：false 为单大厅，true 为多大厅。
• countdown: 60 - 大厅等待倒计时（秒）。
• maxPlayers: 24 - 每场游戏最大玩家数。
• minPlayers: 12 - 开始游戏所需的最小玩家数。
• teamSize: 2 - 每个团队的玩家数量。
• roundTime: 30 - 每回合游戏时长（分钟）。
• activateTeams: true - 是否启用团队。
• activateKits: true - 是否启用职业套装。
• activateShop: true - 是否启用商店。
• activateAirdrops: true - 是否启用空投。
• startOnJoin: false - 玩家加入服务器时是否直接进入大厅（例如用于 BungeeCord 传送）。
• language: en_US - 语言设置，需与 messages.yml 中定义的语言代码一致。
• activePotions: 19 - 药水商店使用的槽位数（最大：27）。
• activeKits: 6 - 职业选择器使用的槽位数（最大：26）。注：“Rich Kid” 套装为硬编码，只能禁用。
• activateDeathmatch: true - 是否在仅剩两名玩家时激活死亡竞赛。
• enableRewards: true - 是否启用经济奖励。
• winningReward: 100 - 获胜奖励金额。
• killReward: 10 - 击杀奖励金额（需要 Vault）。

✨自定义消息与语言

• 要修改任何消息，只需在 messages.yml 文件中更改对应的文本。
• 要添加新语言，请复制现有的语言部分（如 en_US: 下的所有行），粘贴在下方，并将 en_US 改为你的语言代码。同时，记得在 config.yml 中将 language 项也改为对应的语言代码。
• 可在此处下载最新的德语和中文翻译文件。

🔧版本更新历史

• 7.0：新增对 Minecraft 1.13+ 的支持。
• 6.0：新增空投补给。
• 5.2：新增音效。
• 5.1：新增击杀与获胜奖励（需要 Vault）。
• 5.0：新增死亡竞赛。
• 4.9.5：新增团队模式。
• 4.9：新增记分板。
• 4.8：新增单竞技场大厅。
• 4.7：将已点燃的 TNT 加入战利品表。
• 4.6：新增 /pg reload 命令。
• 4.5：新增 /pg version 命令。
• 4.4：新增通过 GUI 加入大厅。
• 4.3：新增对 1.17 的支持。
• 4.2：新增 BungeeCord 大厅服务器设置。
• 4.1：新增更改所有箱子方块类型的选项。
• 4.0：新增添加自定义方块及其专属战利品表的选项。
• （更早版本更新了库存设置、回合时间、多竞技场系统、药水效果、数据库、商店、职业等基础功能。）

❓问题与建议

如有任何漏洞或功能请求，请在此处报告！