RandomItemPVP v3.0.1 更新说明

RandomItemPVP v3.0.1 更新说明

版本信息

• 版本号: 3.0.1
• 发布日期: 2026-02-01
• 构建状态: ✅ 成功
• 兼容性: Paper/Folia 1.21+

---

更新内容

游戏机制优化

盟友生物逻辑改进

• 优化: 盟友生物现在只保护召唤者，会主动攻击其他所有玩家
• 调整: 修改了 AllyMobManager.java 中的攻击逻辑
  • 盟友不会攻击召唤者本人
  • 盟友会主动追击和攻击其他玩家
• 稳定性: 暂时禁用盟友刷怪蛋功能（配置文件 allies.yml 中 enabled: false）
  • 原因：机制不稳定，需要进一步优化

物品系统重构

物品权重大幅调整

• 增加方块种类和权重:

  • 新增 50+ 种方块：云杉木板、白桦木板、金合欢木板、各类原木、石砖、裂石砖、圆石墙、砖块、砂岩、红砂岩、石英块、紫珀块、海晶石、各类羊毛、蜘蛛网、火把、灵魂火把、压力板、按钮、拉杆、各类楼梯、各类台阶、各类地毯、发射器、投掷器等
  • 方块权重提升：圆石 80、石头 75、泥土 70、各类木板 55-65、玻璃 50、黑曜石 45
  • 方块现在占据主要掉落比例

• 降低武器权重:

  • 移除钻石武器和下界合金武器
  • 移除木制和金制武器
  • 移除光灵箭和药效箭
  • 精简为 7 种武器：铁剑(20)、石剑(15)、铁斧(15)、石斧(12)、弓(20)、弩(15)、箭(18)

• 降低工具权重:

  • 移除钻石工具和金制工具
  • 移除所有锄头
  • 精简为 4 种工具：铁镐(15)、石镐(12)、铁锹(15)、石锹(12)

• 降低护甲权重:

  • 移除钻石套和锁链套
  • 护甲权重降至 6-12
  • 盾牌权重降至 10

移除液体桶

• 移除: 水桶和岩浆桶
• 原因: 当前项目存在 bug，流动的水和岩浆无法清除
• 影响: 玩家无法通过物品掉落获得水桶或岩浆桶

文档更新

README 文档完善

• 新增: 完整的项目概述和设计理念
• 新增: 详细的核心功能介绍（随机物品系统、大逃杀机制、空投系统、随机事件、击杀奖励系统、特殊物品能力、数据统计系统、多房间系统）
• 新增: 技术栈说明和项目文件结构
• 新增: 详细的环境要求和安装指南
• 新增:
  • 完整的配置说明（模块化配置文件结构、主配置参数、配置热加载）
  • 使用指南（基本操作、完整游戏流程、胜利条件）
  • 指令与权限（玩家指令、管理员指令、权限节点）
  • PlaceholderAPI 集成（14个可用变量、使用示例）
  • 多房间系统（世界实例化、房间管理）
  • 数据库配置（SQLite/MySQL、初始化SQL）
  • 构建指南（Maven/Gradle）
  • 常见问题解答
  • 贡献指南
  • 许可证和联系方式

---

配置文件变更

config-modules/items.yml

• 大幅增加方块种类和权重
• 降低武器、工具、护甲权重
• 移除水桶和岩浆桶

config-modules/allies.yml

• enabled 从 true 改为 false（禁用盟友刷怪蛋功能）

---

技术细节

修改的文件

• src/main/java/org/luminolcraft/randomitempvp/AllyMobManager.java
• src/main/resources/config-modules/items.yml
• src/main/resources/config-modules/allies.yml
• src/main/resources/config-modules/README.md
• pom.xml

构建信息

• Maven 命令: mvn clean package -DskipTests
• 构建时间: 14.1 秒
• 输出文件: target/RandomItemPVP-3.0.1.jar
• 构建状态: ✅ BUILD SUCCESS

---

已知问题

盟友生物机制

• 状态: 已禁用
• 原因: 机制不稳定，需要进一步优化
• 计划: 后续版本重新启用并优化

---

升级指南

从 v3.0.0 升级到 v3.0.1

1. 备份配置文件

   cp -r config-modules config-modules.backup

2. 替换插件文件

   • 停止服务器
   • 删除旧版本 RandomItemPVP-3.0.0.jar
   • 上传新版本 RandomItemPVP-3.0.1.jar 到 plugins 目录

3. 更新配置文件

   • 建议使用新的配置模板
   • 或手动修改现有配置文件

4. 重启服务器

   # 启动服务器

5. 验证更新

   • 检查插件版本：/ripvp version
   • 重载配置：/ripvp reload

---

下载链接

GitHub Releases

• 主仓库: https://github.com/LuminolCraft/RandomItemPVP
• 发布页面: https://github.com/LuminolCraft/RandomItemPVP/releases

直接下载

• JAR 文件: RandomItemPVP-3.0.1.jar

---

反馈与支持

问题反馈

• GitHub Issues: https://github.com.com/LuminolCraft/RandomItemPVP/issues

联系方式

• GitHub: https://github.com/LuminolCraft/RandomItemPVP

---

许可证

MIT License - 详见 LICENSE 文件

---