# 不断优化完善 - Minecraft枪械插件 --- ## 📋 插件简介不断优化完善的Minecraft枪械插件，提供真实的枪械射击体验、配件系统、耐久系统等功能。此插件使用AI辅助开发，无参考其它插件。 --- ## 🎯 核心功能 ### 🔫 枪械系统 - 支持31种枪械类型：手枪、冲锋枪、突击步枪、狙击枪、霰弹枪、机枪、火箭筒等 - 真实的弹道系统：散射、后坐力、精准度、射程 - 多种射击模式：单发、连发、全自动、充能射击 - 头部伤害加成、护甲穿透、暴击系统 - 枪械耐久与磨损系统 - 枪管热量系统 ### 🎯 配件系统 - 9种配件类型：枪口、瞄准镜、握把、枪管、枪托、战术配件、下挂配件、侧轨配件、机匣 - 40+种配件可选 - 配件耐久系统，射击消耗耐久 - 配件修复系统 - 配件属性加成：精度、后坐力、伤害等 - 分页查看配件列表 ### 📦 弹夹系统 - 可拆卸弹夹，独立耐久系统 - 弹夹装填GUI界面，支持拖拽操作 - 战术换弹机制，枪膛有弹时换弹多+1发 - 弹夹重量随子弹数量变化 - 弹夹故障率系统 ### 💥 子弹变种系统 - 20+种子弹变种：标准弹、穿甲弹、空尖弹、燃烧弹、爆炸弹等 - 每种变种有独特属性修正：伤害、穿透、散布、射程、后坐力、初速度等 - 支持弹夹内混合装填不同变种 - 按装填倒序发射，先装入的后发射 - 特殊效果：燃烧、爆炸、曳光、烟雾等 ### 🎮 真实射击体验 - 心率系统：射击、移动影响心率，高心率降低精度 - 呼吸系统：屏息减少散射，呼吸值过低增加抖动 - 疲劳系统：连续射击导致疲劳，影响精准度 - 重量系统：装备重量影响移动速度和精度 - 散射机制：只有屏息时才减少散射，开镜不减少 - 后坐力系统：蹲伏、趴下减少后坐力 ### ⚙️ 其他功能 - 完整的命令系统 - 权限节点控制 - 配置文件热重载 - 调试模式 - 弹道轨迹粒子效果 --- ## 📦 安装方法 1. 确保服务器版本为 **1.21** 或更高 2. 将JAR文件放入 `plugins` 文件夹 3. 重启服务器 4. 修改配置文件（可选） 5. 使用 `/xh help` 查看命令帮助 --- ## 💻 命令列表 ### 主命令 ``` /xh (别名: /xhgun, /xhg, /xhw) /xh give <枪械ID> [数量] - 获得枪械 /xh list [页码] - 列出所有枪械 /xh info <枪械ID> - 查看枪械详情 /xh ammo <数量> - 设置手持枪械弹药 /xh reload - 重载配置 /xh help - 查看帮助 ``` ### 配件命令 ``` /xhaccessory (别名: /xha, /xhacc) /xha give <配件ID> [数量] - 获得配件 /xha list [类型] [页码] - 分页列出配件 /xha attach <配件ID> - 安装配件 /xha detach <类型|all> - 拆卸配件 /xha info <配件ID> - 查看配件详情 /xha repair [类型] [数量] - 修复配件耐久 ``` ### 弹夹命令 ``` /xhmagazine (别名: /xhmag, /xhm) /xhm give <弹夹ID> [子弹数量] [耐久] - 获得弹夹 /xhm list [页码] - 列出所有弹夹 /xhm info <弹夹ID> - 查看弹夹详情 /xhm load - 打开弹夹装填界面 ``` ### 弹药命令 ``` /xhammo (别名: /xham, /xhb) /xham give <弹药类型> <变种> [数量] - 获得弹药 /xham list - 列出所有弹药类型 /xham variants - 列出所有子弹变种 ``` ### 其他命令 ``` /xhrepair (别名: /xhrp, /xhfix) - 修复和维护枪械 /xhstatus (别名: /xhs, /xhstat) - 查看玩家状态 /xhreload - 重载插件 /xhconfig - 热重载配置 /xhweight - 查看重量系统 /xhfatigue - 管理疲劳值 ``` --- ## 🔑 权限节点 | 权限 | 说明 | 默认 | |------|------|------| | `gunplugin.use` | 使用基础命令 | true | | `gunplugin.give` | 获得枪械 | op | | `gunplugin.reload` | 重载配置 | op | | `gunplugin.repair` | 清洁枪械 | true | | `gunplugin.repair.maintain` | 完全维护 | op | | `gunplugin.status` | 查看状态 | true | | `gunplugin.accessory` | 使用配件系统 | true | | `gunplugin.accessory.give` | 获得配件 | op | | `gunplugin.debug` | 调试命令 | op | | `gunplugin.admin` | 管理员权限 | op | --- ## 📊 子弹变种类型 | 变种 | 伤害 | 穿透 | 特殊效果 | |------|------|------|----------| | 标准弹 | 基准 | 基准 | 无 | | 穿甲弹 | -10% | +30% | 对护甲目标伤害+20% | | 空尖弹 | +25% | -20% | 对无护甲目标伤害+30% | | 燃烧弹 | +5% | -10% | 命中后点燃目标3秒 | | 爆炸弹 | +15% | -30% | 命中后造成范围伤害 | | 曳光弹 | -5% | 基准 | 显示弹道轨迹 | | 亚音速弹 | -15% | 基准 | 射击声音降低50% | | 竞赛级弹药 | +5% | +5% | 极高精度，散布降低20% | | 重型弹 | +20% | +15% | 高伤害高穿透，后坐力大 | | 轻型弹 | -10% | -10% | 高初速低后坐，伤害略低 | --- ## 🔫 枪械类型 | 类型 | 说明 | 代表枪械 | |------|------|----------| | 手枪 | 平衡型武器 | 战术手枪、沙漠之鹰 | | 冲锋枪 | 高射速近距离 | MP5、UZI、Vector | | 突击步枪 | 全能型武器 | AK47、M4A1、SCAR | | 狙击枪 | 远程高伤害 | AWP、巴雷特 | | 霰弹枪 | 近距离爆发 | M870、S12K | | 轻机枪 | 持续火力压制 | M249、RPK | | 火箭筒 | 范围爆炸伤害 | 毒刺导弹 | --- ## 🔧 配件类型 | 类型 | 效果 | |------|------| | 枪口配件 | 消音、制退、消焰 | | 瞄准镜 | 放大倍率、精度提升 | | 握把 | 后坐力控制、稳定性 | | 枪管 | 射程、精度、伤害 | | 枪托 | 后坐力、稳定性 | | 战术配件 | 激光瞄准、战术手电 | | 下挂配件 | 前握把、榴弹发射器 | | 侧轨配件 | 侧面瞄准镜 | | 机匣配件 | 射速、伤害修正 | --- ## 📁 配置文件 | 文件 | 说明 | |------|------| | `config.yml` | 主配置文件 | | `guns.yml` | 枪械配置（31种枪械） | | `accessories.yml` | 配件配置（40+种配件） | | `magazines.yml` | 弹夹配置 | | `ammo_types.yml` | 弹药类型配置 | | `ammo_variants.yml` | 子弹变种配置（20+种变种） | | `gun_types.yml` | 枪械类型系数配置 | --- ## 🎮 特色系统详解 ### 散射系统屏息时使用瞄准散射（低散射），开镜但未屏息时使用腰射散射（高散射），真实模拟射击体验。 ### 耐久系统枪械和配件都有耐久度，射击会消耗耐久。耐久度影响枪械性能，可通过命令修复。 ### 心率系统移动、射击会增加心率，高心率降低瞄准精度。静止时心率逐渐恢复。 ### 呼吸系统瞄准时可屏息减少散射，屏息消耗呼吸值。呼吸值过低时弹道不稳定。 ### 护甲穿透系统 - 枪械有护甲穿透属性，可穿透原版护甲和附魔 - 支持保护、弹射物保护、荆棘等附魔效果 - 穿甲弹可额外提升穿透能力 --- ## 📜 更新日志 ### v1.1.0 **新增弹夹系统** - 支持可拆卸弹夹，弹夹有独立耐久 - 弹夹装填GUI界面，支持拖拽装填 - 战术换弹机制，枪膛有弹时换弹多+1发 **新增子弹变种系统** - 20+种子弹变种：穿甲弹、空尖弹、燃烧弹、爆炸弹等 - 每种变种有独特属性：伤害、穿透、散布、射程、后坐力等 - 支持弹夹内混合装填不同变种，按装填倒序发射 **新增事件系统** - GunShootEvent - 射击事件，可取消或修改伤害 - GunDamageEvent - 伤害事件，可修改伤害值和类型 - GunReloadEvent - 换弹事件，可取消换弹 - GunJamEvent - 卡壳事件，可自定义卡壳原因 **新增缓存系统** - 枪械、弹夹、配件配置缓存 - 提升频繁访问性能 - 配置热重载自动清理缓存 **新增护甲穿透系统** - 兼容原版护甲和附魔 - 支持保护、弹射物保护、荆棘效果 - 枪械类型穿透系数 **功能优化** - 配件属性显示区分水平/垂直后坐力 - 综合效果计算优化，正确处理逆向属性 - 配置热重载完善，大部分配置无需重启 **Bug修复** - 修复换弹后旧弹夹弹药数量错误 - 修复大容量换小容量弹夹弹药溢出 - 修复战术换弹不增加子弹 - 修复子弹属性未正确应用到伤害计算 - 修复配件属性重复显示 ### v1.0.0 - 初始版本发布 - 31种枪械支持 - 40+种配件支持 - 完整的心率、呼吸、疲劳系统 - 重量系统 - 耐久与修复系统 - 散射系统优化（屏息减少散射） - 配件列表分页功能 --- ## 📋 支持信息 - **服务端**: Paper / Spigot / Purpur - **Minecraft版本**: 1.21+ - **Java版本**: 17+ --- ## 📄 版权信息 ``` Copyright (c) 2026 磕深 QQ群: 1081839135 此插件使用AI辅助开发，无参考其它插件 MIT License ``` --- ## 📞 联系方式如有问题请加QQ群反馈: **1081839135** 多平台同步发布

不断优化完善枪械插件

不断优化完善枪械插件

基本信息

我的世界Java版本

平台

运行环境

创作者

详情信息

讨论