不断优化完善 - Minecraft枪械插件

📋 插件简介

不断优化完善的Minecraft枪械插件，提供真实的枪械射击体验、配件系统、耐久系统等功能。此插件使用AI辅助开发，无参考其它插件。

🎯 核心功能

🔫 枪械系统

支持31种枪械类型：手枪、冲锋枪、突击步枪、狙击枪、霰弹枪、机枪、火箭筒等
真实的弹道系统：散射、后坐力、精准度、射程
多种射击模式：单发、连发、全自动、充能射击
头部伤害加成、护甲穿透、暴击系统
枪械耐久与磨损系统
枪管热量系统

🎯 配件系统

9种配件类型：枪口、瞄准镜、握把、枪管、枪托、战术配件、下挂配件、侧轨配件、机匣
40+种配件可选
配件耐久系统，射击消耗耐久
配件修复系统
配件属性加成：精度、后坐力、伤害等
分页查看配件列表

📦 弹夹系统

可拆卸弹夹，独立耐久系统
弹夹装填GUI界面，支持拖拽操作
战术换弹机制，枪膛有弹时换弹多+1发
弹夹重量随子弹数量变化
弹夹故障率系统

💥 子弹变种系统

20+种子弹变种：标准弹、穿甲弹、空尖弹、燃烧弹、爆炸弹等
每种变种有独特属性修正：伤害、穿透、散布、射程、后坐力、初速度等
支持弹夹内混合装填不同变种
按装填倒序发射，先装入的后发射
特殊效果：燃烧、爆炸、曳光、烟雾等

🎮 真实射击体验

心率系统：射击、移动影响心率，高心率降低精度
呼吸系统：屏息减少散射，呼吸值过低增加抖动
疲劳系统：连续射击导致疲劳，影响精准度
重量系统：装备重量影响移动速度和精度
散射机制：只有屏息时才减少散射，开镜不减少
后坐力系统：蹲伏、趴下减少后坐力

⚙️ 其他功能

完整的命令系统
权限节点控制
配置文件热重载
调试模式
弹道轨迹粒子效果

📦 安装方法

确保服务器版本为 1.21 或更高
将JAR文件放入 plugins 文件夹
重启服务器
修改配置文件（可选）
使用 /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 多平台同步发布

不断优化完善枪械插件