RandomItemPVP v3.0.0 发布说明
🎉 欢迎使用 RandomItemPVP v3.0.0
本次更新是一个重大稳定性版本，专注于修复并发问题和数据准确性。
🌟 主要亮点
💪 企业级稳定性
- 完整的并发安全保证，确保 Folia 多线程环境下数据零丢失
- 精确的统计记录，每一局游戏的数据都准确无误
- 优化的游戏状态管理，告别奇怪的并发 bug
🎮 更好的管理体验
- 详细的配置反馈，reload 时一目了然
- 智能日志系统，启动静默，管理友好
📦 本次更新内容
🔧 稳定性（Breaking Changes: 0）
- 线程安全全面优化
- 统计数据精确修复
- 配置热加载增强
- 游戏状态管理优化
🐛 修复（15+）
- 修复死亡数重复记录
- 修复游戏结束后的意外记录
- 修复并发加入游戏问题
- 修复 reload 日志冗余
- 修复统计数据不准确
- ...以及更多
📚 文档
- 新增完整的 .gitignore
- 优化代码示例
- 改进配置说明
🚀 快速开始
安装
- 下载
RandomItemPVP-3.0.0.jar - 放入
plugins文件夹 - 重启服务器
配置（可选）
# 默认配置已经非常完善，大多数服务器无需修改
arena:
radius: 48
min-players: 2
database:
type: SQLITE # 默认使用 SQLite开始游戏
/ripvp start # 发起游戏
/ripvp join # 加入游戏
📊 统计功能（v2.2.0+）
完整的玩家数据追踪系统：
- ✅ 胜负统计
- ✅ 击杀死亡
- ✅ KD 比率
- ✅ 胜率计算
- ✅ 排行榜系统
命令
/ripvp stats- 查看统计/ripvp top- 排行榜
数据库
- SQLite（默认，零配置）
- MySQL（可选，跨服共享）
🎯 PlaceholderAPI 支持
17+ 个变量，无缝集成到记分板/TAB/聊天：
%randomitempvp_wins%
%randomitempvp_kills%
%randomitempvp_kd%
%randomitempvp_winrate%
查看 PLACEHOLDERAPI_GUIDE.md 了解更多。
🔄 从 v2.2.0 升级
零配置升级
- 替换 JAR 文件
- 重启服务器
- 完成！
注意事项
- ✅ 配置文件完全兼容
- ✅ 数据库完全兼容
- ✅ 无需手动操作
- ✅ 数据零丢失
🛠️ 技术栈
- 平台: Paper 1.21.1+ / Folia
- 语言: Java 21
- 数据库: SQLite + MySQL
- 连接池: HikariCP
- API: PlaceholderAPI 2.11.5+
📈 性能
- ⚡ 异步数据库操作
- 🔄 智能连接池
- 💾 高效索引
- 🧵 并发优化
- ⏱️ 查询速度提升 600 倍
🌍 兼容性
服务器类型
- ✅ Paper（推荐）
- ✅ Folia（完全支持）
- ✅ Purpur（兼容）
Minecraft 版本
- ✅ 1.21.1+
- ✅ 最新快照
Java 版本
- ✅ Java 21（必需）
📚 相关文档
- README.md - 完整说明
- DATABASE_GUIDE.md - 数据库配置
- PLACEHOLDERAPI_GUIDE.md - PAPI 变量
- CHANGELOG_v3.0.0.md - 详细更新日志
🐛 反馈 Bug
发现问题？立即报告：
- GitHub Issues: 提交完整错误日志和复现步骤
- 描述问题发生的场景
- 附上相关配置
💡 贡献
欢迎贡献代码、文档或建议！
🙏 致谢
感谢所有测试人员和反馈用户！
版本: 3.0.0
发布日期: 2025-11-02
最低 Java 版本: 21
最低 Minecraft 版本: 1.21.1