原创 闭源 游戏模式 SKi_Bingo v2.x 2.1.0

# SKi_Bingo v2.1.0
**Paper 1.21.11 多人竞技 Bingo 插件**
作者：SLATT团队-斯基
---
## 适配
Paper 1.21.11 / Purpur 1.21.11 / Pufferfish 1.21.11
---
## 简介
SKi_Bingo 是一款团队竞技 Bingo 插件。玩家分为红/蓝/绿/黄四支队伍，每人持有一张 5x5 的 Bingo 物品卡（物理地图），在野外收集指定物品获取分数，率先达到目标分数的队伍获胜。
**v2.x 新增探路模式**：Bingo 卡上的物品初始全部隐藏，玩家收集到任意物品后揭示该格及上下左右四格，同队共享进度。旁观者可按队伍查看差异化的揭示状态。
---
## 快速上手
```
管理员:
/bingo settings → 打开配置面板
/bingo start → 开始游戏
/bingo stop → 强制结束
/bingo reveal → 切换管理员完整视角
玩家:
/bingo join → 选择队伍
/bingo teams → 查看各队成员
/bingo card → 查看 Bingo 卡
/bingo view <玩家> → 查看他人进度（仅旁观/管理）
/bingo rank → 查看排名
/bingo status → 查看游戏状态
```
---
## 指令完整列表
| 指令 | 权限 | 说明 |
|------|------|------|
| `/bingo start` | `bingo.admin` | 开始游戏 |
| `/bingo stop` | `bingo.admin` | 强制结束 |
| `/bingo settings` | `bingo.admin` | 打开配置 GUI |
| `/bingo reveal` | `bingo.admin` | 切换管理员完整视角，全服广播 |
| `/bingo join` | `bingo.player` | 打开队伍选择界面 |
| `/bingo join <队伍>` | `bingo.player` | 直接加入（red/blue/green/yellow） |
| `/bingo leave` | `bingo.player` | 离开队伍 |
| `/bingo card` | `bingo.player` | 查看 Bingo 卡 |
| `/bingo view <玩家>` | 管理员/旁观 | 查看他人 Bingo 卡进度 |
| `/bingo teams` | `bingo.player` | 查看各队成员 |
| `/bingo rank` | `bingo.player` | 查看实时排名 |
| `/bingo status` | `bingo.player` | 查看游戏状态 |
---
## 管理员配置面板
`/bingo settings` 打开 45 格 GUI：
| 设置项 | 说明 | 默认值 |
|--------|------|--------|
| 目标分数 | 队伍总分到达此值获胜 | 20 |
| 最大时长 | 分钟制，Shift+/- 10分钟 | 30分钟 |
| 队伍人数 | 每队最多人数 | 4 |
| 出生半径 | ±方块 | 500 |
| 连线奖励 | 行/列/对角线加分 | 10 |
| 难度模式 | 极易/简单/普通/困难/极难 | 普通 |
| 探路模式 | 物品初始隐藏，获得后揭示相邻格 | 关闭 |
| Tier 1~5 分值 | 各难度物品分数 | 1~5 |
底部按钮：保存/刷新/退出
---
## 难度模式
不同模式从 1000+ 物品池中按比例抽取 25 个：
| 模式 | T1 | T2 | T3 | T4 | T5 | 说明 |
|------|----|----|----|----|----|------|
| 极易 | 25 | 0 | 0 | 0 | 0 | 纯基础物品，新手练习 |
| 简单 | 8 | 10 | 5 | 2 | 0 | 基础为主，少量进阶 |
| 普通 | 5 | 6 | 9 | 4 | 1 | 中段偏重 |
| 困难 | 3 | 4 | 6 | 8 | 4 | 高难为主 |
| 极难 | 2 | 3 | 4 | 7 | 9 | 大量顶级稀有物品 |
---
## 探路模式
管理员在设置面板开启后：
- 所有格子初始隐藏（显示 ???）
- 任意队员收集到物品 → 揭示该格 + 上下左右相邻四格
- 同队共享揭示进度，左下角通知全队
- 旁观者按队伍查看差异化的揭示状态
- 管理员 `/bingo reveal` 可查看完整 Bingo 卡（全服广播）
- 地图上多队伍占领颜色公开可见
---
## 物品翻译
所有物品名使用 Paper 1.21.11 的 `Component.translatable()`，由客户端根据玩家语言自动显示。config.yml `item-names` 节点可手动覆盖。
---
## 游戏流程
1. **准备**：管理员调参，玩家 `/bingo join` 选队
2. **开始**：`/bingo start`，获地图+头盔，同队出生同区域（安全检测），背包清空
3. **进行**：收集物品，地图+计分板实时更新
4. **结束**：达目标分数→公布排名+音效；超时按分排名
---
## 死亡掉落
遵循世界 `keepInventory` 规则：
| keepInventory | 行为 |
|---------------|------|
| true | 全部保留 |
| false | Bingo 地图和头盔保留，其余正常掉落，重生恢复生存模式 |
---
## 安装
1. 下载 `SKi_Bingo-2.1.0.jar`
2. 放入 Paper 1.21.11 `plugins/` 目录
3. 重启服务器
4. 编辑 `plugins/SKi_Bingo/config.yml` 或用游戏内 GUI 配置
---
## 配置文件
```yaml
game:
target-score: 20
max-duration: 1800
max-team-size: 4
spawn-radius: 500
difficulty: "NORMAL"
fog-enabled: false
score-values:
tier-1: 1
tier-2: 2
tier-3: 3
tier-4: 4
tier-5: 5
line-bonus: 10
```
## 权限
| 节点 | 默认 | 说明 |
|------|------|------|
| `bingo.admin` | OP | 管理指令 |
| `bingo.player` | true | 玩家指令 |