GunPlugin

GunPlugin 5.0.0 更新日志 / Release Notes

发布日期 / Release date： 2026-05-11 ---

1. 多语言支持 / Multi-Language Support

中文

- 扩充语言资源文件（messages/*.yml）：商店、配件、命令提示、物品 Lore、调试与日志字符串等与模板键对齐。 - 多套语种并行维护（含简体 / 英文 / 日文 / 韩文 / 繁体中文等）；缺失键回退默认语言。 - 统一射速等单位在各语言下的表述（如 RPM）。

English

- Expanded locale packs (messages/*.yml): shop, attachments, commands, item lore, debug/log strings aligned with keys. - Multiple locales shipped (e.g. zh_CN, en_US, ja_JP, ko_KR, zh_TW); missing keys fall back to default. - Consistent fire-rate labeling (e.g. RPM) across languages. ---

2. 配置文件大改与自定义枪械 / Configuration Overhaul & Custom Guns

中文

- guns.yml：枪械完全由数据驱动（伤害、rate（RPM）、弹匣、换弹、sounds、recoil、behavior/category 等），新增枪械仅需添加条目并重载。 - config.yml：default_guns 按枪械 ID 覆盖部分字段；购买与经济选项集中于配置。 - guns.yml 文件头提供中英文配置说明与必填项列表。

English

- guns.yml: Fully data-driven guns (damage, RPM rate, magazine, reload, sounds, recoil, behavior/category, etc.); add entries and reload. - config.yml: Per-gun overrides via default_guns.<id>; economy/buy settings in config. - Bilingual header docs in guns.yml for required keys and sections. ---

3. 后坐力调整 / Recoil Tuning

中文

- recoil：normal 参数式与 pattern 点列式；points 为按发序循环的 [水平, 垂直]。 - 区分 movement_spread（移动散布）与 recoil 内 horizontal_spread / vertical_spread（后坐视角散布）。

English

- recoil: normal vs pattern; points are cyclic [h, v] pairs per shot. - Clear separation between movement_spread and recoil spread fields. ---

4. 持枪移速 / Hold Move Speed

中文

- 持枪减速改为 直接调整行走速度（setWalkSpeed），以进入持枪前速度为基准按倍率计算；开镜、射击/换弹惩罚为额外乘数，不再使用缓慢药水。 - guns.yml 新增 `hold_move_speed`（可选，默认 0.88，取值 (0,1]）；机枪 `negev` 示例为 `0.62`（移动更慢）。

English

- Gun-hold slowdown uses `Player#setWalkSpeed` from a baseline captured before aiming; scoped / shoot-reload penalties multiply it—no Slowness potions. - guns.yml adds `hold_move_speed` (optional, default 0.88, range (0,1]); sample LMG negev uses `0.62`. ---

5. 修复已知问题 / Bug Fixes & Improvements

中文

- 全自动射速：按 RPM 使用固定 tick 周期连发并首发即时射击，缓解实际射速低于配置的问题。 - `default_guns.fire_rate`：合并进枪械解析，与 Lore 与实战一致。 - 文案：修正部分语言下 Lore 将 RPM 显示为「秒」等问题。

English

- Full-auto cadence: Tick-based scheduling from RPM plus immediate first shot; reduces undershoot vs configured RPM. - `default_guns.fire_rate`: Applied in resolved gun stats (matches lore and gameplay). - UI copy: Fixed RPM vs seconds in some locales. ---

Gun Plugin Changelog Gun 插件变更日志

[4.0.0]

I forgot what I updated 我忘记更新了什么🤔……             

Gun Plugin Changelog Gun 插件变更日志

[3.0.1]

Fixed the bug of material conflict between .50mm ammunition and the firearm "USP" 修复了.50mm弹药和枪械“USP”材质冲突的问题             

GunPlugin 3.0.0 更新日志 / Changelog

中文 / Chinese | English ---

重大更新 / Major Updates

全面多语言适配 / Complete Multi-Language Support

#### 中文 - 完整的多语言支持 - 所有GUI界面完全适配中英文 - 配件系统界面完全本地化 - 购买页面所有内容支持多语言 - 配件槽位名称、配件名称、描述完全本地化 - 修复了语言键缺失导致的警告问题 - 本地化改进 - 配件改装GUI完全支持多语言切换 - 配件槽位选择界面支持多语言 - 配件效果描述支持多语言 - 所有错误消息和提示信息完全本地化 #### English - Complete Multi-Language Support - All GUI interfaces fully support Chinese and English - Attachment system interface fully localized - All content in the purchase page supports multiple languages - Attachment slot names, attachment names, and descriptions fully localized - Fixed language key missing warnings - Localization Improvements - Attachment modification GUI fully supports language switching - Attachment slot selection interface supports multiple languages - Attachment effect descriptions support multiple languages - All error messages and prompts fully localized ---

配件系统全面重构 / Complete Attachment System Overhaul

#### 中文 - 移除旧升级系统，引入全新配件系统 - 删除了原有的枪械升级系统（弹容量、射速、换弹时间等升级） - 全新的配件改装系统，更加灵活和真实 - 配件系统核心特点 - 5个配件槽位：枪口、枪托、弹匣、侧导轨、下导轨 - 配件类型丰富： - 消音器（一级/二级）：降低枪声，减少后坐力 - 补偿器（一级/二级）：减少后坐力 - 扩容弹匣（一级/二级）：增加弹匣容量，提升换弹速度 - 镭指：减少子弹散步 - 垂直握把：减少后坐力 - 枪托（一级/二级）：减少后坐力 - 托腮板：减少10%后坐力（适用于霰弹枪、狙击枪、狙击步枪） - 配件效果叠加： - 弹匣容量加成：最高可增加40% - 换弹速度加成：最高可增加15% - 枪声减少：最高可降低85% - 后坐力减少：多种配件可叠加，最高可减少30%+ - 子弹散步减少：最高可减少20% - 智能槽位系统： - 不同枪械类型支持不同的配件槽位组合 - 步枪、Vector、狙击步枪：支持全部5个槽位 - 手枪（P250、沙漠之鹰、USP、AA12）：支持弹匣、枪口、下导轨、枪托 - CZ75：支持弹匣、枪口、下导轨 - S686：仅支持枪托 - 狙击枪：支持枪口、枪托 - PP19：仅支持枪口 - 机枪：支持弹匣、枪口 - 配件兼容性系统： - 狙击步枪（MK14、SKS）支持步枪配件和狙击枪配件 - 机枪（NEGEV）和AA12支持步枪弹匣 - 托腮板适用于霰弹枪、狙击枪、狙击步枪 - 智能配件分类：步枪配件、冲锋枪配件、霰弹枪配件、手枪配件、狙击枪配件 - 配件GUI系统： - 直观的配件改装界面 - 主界面显示所有可用槽位 - 槽位页面显示已安装配件和可用配件 - 配件效果实时显示 - 支持配件安装和卸载 - 配件数据持久化保存 #### English - Removed Old Upgrade System, Introduced New Attachment System - Removed the old gun upgrade system (magazine size, fire rate, reload time upgrades) - Brand new attachment modification system, more flexible and realistic - Attachment System Core Features - 5 Attachment Slots: Muzzle, Stock, Magazine, Side Rail, Under Rail - Rich Attachment Types: - Silencers (Level 1/2): Reduce sound, reduce recoil - Compensators (Level 1/2): Reduce recoil - Extended Magazines (Level 1/2): Increase magazine capacity, improve reload speed - Laser Sights: Reduce bullet spread - Vertical Grips: Reduce recoil - Stocks (Level 1/2): Reduce recoil - Cheek Pads: Reduce 10% recoil (for shotguns, sniper rifles, and DMRs) - Attachment Effect Stacking: - Magazine Capacity Bonus: Up to 40% increase - Reload Speed Bonus: Up to 15% increase - Sound Reduction: Up to 85% reduction - Recoil Reduction: Multiple attachments can stack, up to 30%+ reduction - Bullet Spread Reduction: Up to 20% reduction - Smart Slot System: - Different gun types support different attachment slot combinations - Rifles, Vector, DMRs: Support all 5 slots - Pistols (P250, Desert Eagle, USP, AA12): Support Magazine, Muzzle, Under Rail, Stock - CZ75: Support Magazine, Muzzle, Under Rail - S686: Only supports Stock - Sniper Rifles: Support Muzzle, Stock - PP19: Only supports Muzzle - LMG: Support Magazine, Muzzle - Attachment Compatibility System: - DMRs (MK14, SKS) support rifle attachments and sniper attachments - LMG (NEGEV) and AA12 support rifle magazines - Cheek pads work with shotguns, sniper rifles, and DMRs - Smart attachment categories: Rifle, SMG, Shotgun, Pistol, Sniper attachments - Attachment GUI System: - Intuitive attachment modification interface - Main interface shows all available slots - Slot page shows installed and available attachments - Real-time attachment effect display - Support for attachment installation and removal - Attachment data persistence ---

新增枪械 / New Gun

#### 中文 - USP手枪 - 射速：352 RPM（半自动） - 弹容量：12发 - 伤害：6.7 - 子弹速度：134米/秒 - 换弹时间：2.2秒 - 散步：小 - 材质：粉红色染料 - 价格：1200金币 - 支持配件：弹匣、枪口、下导轨、枪托 - 新增弹药类型 - .45口径弹药 - 适用于USP手枪 - 材质：下界砖 - 价格：4320金币/组 #### English - USP Pistol - Fire Rate: 352 RPM (Semi-automatic) - Magazine: 12 rounds - Damage: 6.7 - Bullet Speed: 134 m/s - Reload Time: 2.2 seconds - Spread: Small - Material: Pink Dye - Price: 1200 coins - Supported Attachments: Magazine, Muzzle, Under Rail, Stock - New Ammo Type - .45 Caliber Ammo - For USP pistol - Material: Nether Brick - Price: 4320 coins/stack ---

音效系统增强 / Enhanced Sound System

#### 中文 - 丰富的开枪音效 - AK74：entity.zombie.break_wooden_door + block.comparator.click - HK416：entity.zombie.attack_wooden_door + entity.zombie.attack_iron_door - AA12：block.lever.click + entity.zombie.attack_wooden_door - S686：entity.generic.explode + entity.zombie.attack_wooden_door + block.lever.click - PP19：entity.zombie.attack_iron_door + block.comparator.click + item.trident.throw - Vector：item.wolf_armor.damage + entity.zombie.attack_wooden_door - CZ75：entity.zombie.attack_wooden_door + item.trident.throw - P250：item.trident.throw + block.comparator.click - AUG：item.trident.throw + entity.zombie.attack_wooden_door - NEGEV：entity.dolphin.attack + entity.zombie.attack_iron_door - SKS：自定义音效组合 - 狙击枪（AWM、KAR98K）：entity.generic.explode + entity.warden.sonic_boom，发射后0.7秒播放三次item.armor.unequip_wolf - 消音器音效 - 当枪械装配消音器时，开枪音效自动切换为item.wolf_armor.damage - 支持所有可安装消音器的枪械 #### English - Rich Shooting Sound Effects - AK74: entity.zombie.break_wooden_door + block.comparator.click - HK416: entity.zombie.attack_wooden_door + entity.zombie.attack_iron_door - AA12: block.lever.click + entity.zombie.attack_wooden_door - S686: entity.generic.explode + entity.zombie.attack_wooden_door + block.lever.click - PP19: entity.zombie.attack_iron_door + block.comparator.click + item.trident.throw - Vector: item.wolf_armor.damage + entity.zombie.attack_wooden_door - CZ75: entity.zombie.attack_wooden_door + item.trident.throw - P250: item.trident.throw + block.comparator.click - AUG: item.trident.throw + entity.zombie.attack_wooden_door - NEGEV: entity.dolphin.attack + entity.zombie.attack_iron_door - SKS: Custom sound combination - Sniper Rifles (AWM, KAR98K): entity.generic.explode + entity.warden.sonic_boom, plays three item.armor.unequip_wolf sounds after 0.7 seconds - Silencer Sound Effects - When a gun is equipped with a silencer, shooting sound automatically switches to item.wolf_armor.damage - Supports all guns that can install silencers ---

枪械数值调整 / Gun Value Adjustments

#### 中文 - 射速系统重构 - 射速单位从"射击间隔（秒）"改为"RPM（每分钟发射数）" - 更直观的射速显示 - 精确的射速控制，支持快速射击（fireRate < 0.1） - 射速调整 - P250：400 RPM - TEC9：500 RPM - CZ75：600 RPM - 沙漠之鹰：277 RPM（4.6发/秒） - AK74：600 RPM - AUG：630 RPM - PP19：630 RPM - Vector：1000 RPM - NEGEV：583 RPM - MK14：550 RPM - SKS：600 RPM - HK416：620 RPM - AA12：462 RPM - S686：600 RPM #### English - Fire Rate System Overhaul - Fire rate unit changed from "Shooting Interval (seconds)" to "RPM (Rounds Per Minute)" - More intuitive fire rate display - Precise fire rate control, supports fast shooting (fireRate < 0.1) - Fire Rate Adjustments - P250: 400 RPM - TEC9: 500 RPM - CZ75: 600 RPM - Desert Eagle: 277 RPM (4.6 rounds/second) - AK74: 600 RPM - AUG: 630 RPM - PP19: 630 RPM - Vector: 1000 RPM - NEGEV: 583 RPM - MK14: 550 RPM - SKS: 600 RPM - HK416: 620 RPM - AA12: 462 RPM - S686: 600 RPM ---

功能改进 / Feature Improvements

半自动射击模式优化 / Semi-Automatic Firing Mode Optimizati

Gun Plugin Changelog Gun 插件变更日志

[2.0.1]

Updated bStats 更新了bStats

Gun Plugin Changelog Gun 插件变更日志

[2.0.0]

Updated a lot of content 更新了非常多的内容

Major Updates 主要更新

- Added recoil system 添加了后坐力系统 - Designed individual recoil for each firearm 为每个枪械设计了单独的后坐力 - Added firearm purchase system 添加了枪械购买系统 - You can customize the price of each firearm 可以自定义每个枪械的价格 - Added firearm upgrade system 添加了枪械升级系统 - Support players to upgrade multiple abilities of firearms 支持玩家为枪械的多项能力进行升级

Feature Improvements 功能改进

- Improved smoke material 改进了烟雾弹材质 - Improved the 'give' command 改进了give命令 - Improved the stacking logic of firearms 改进了枪械堆叠逻辑

New Commands 新命令

- /gun buy - 枪械购买命令 - /gun buy - gun purchase command - /gun upgrade - 升级枪械命令 - /Gun upgrade - Command to upgrade firearms

Bug Fixes 错误修复

- Fixed many bugs! 修复了很多漏洞！

Gun Plugin Changelog

[1.2.0]

Major Updates

#### Grenade System - Added High Explosive Grenade - Explodes after 5 seconds, dealing damage to entities within 5 block radius - Center explosion damage: 20 points, edge damage: 2 points - Material: Slime Ball - Supports left-click low throw and right-click high throw - Added Molotov Cocktail - Generates fire particles in 3 block radius at impact point - Deals 4 damage per second to players in contact, lasts 10 seconds - Fire spreads downward until hitting non-air blocks - Material: Fire Charge - Supports left-click low throw and right-click high throw - Added Smoke Grenade - Generates smoke particles in 3x3x3 area at impact point - Provides visual cover, lasts 15 seconds - Material: Egg - Supports left-click low throw and right-click high throw #### Multi-Language System - Complete Multi-Language Support - Supports Chinese (zh_CN) and English (en_US) - Language switching via configuration file - Language switching command /gun lang - Localized Content - All in-game messages support multiple languages - Gun names, ammo names, grenade names localized - Help information, error messages, console logs localized - ActionBar messages, item descriptions localized

Feature Improvements

#### Grenade System Optimization - Throw Cooldown Mechanism - 2-second throw interval to prevent spam - Shows remaining time during cooldown - High Explosive Grenade Optimization - Countdown starts when thrown, not when landing - Landing sound effects: minecraft:block.anvil.place and minecraft:entity.tnt.primed - Continuous smoke particles during countdown - Ensures entity cleanup after explosion - Molotov Cocktail Optimization - Fire sound effect minecraft:block.fire.ambient in flames - Optimized downward fire spread logic - Maximum 20 block depth check - Smoke Grenade Optimization - Uses minecraft:explosion_emitter particle effect - Optimized smoke height and radius #### Language System Optimization - Language Manager Enhancement - Automatically copies language files from resources folder - Supports message key fallback mechanism - Detailed debug logs and error handling - Parameter replacement system support - Enum Multi-Language Support - GunType enum supports localized names - AmmoType enum supports localized names and descriptions - Dynamic current language setting retrieval

New Commands

#### Language Management Commands - /gun lang - Show current language and available languages - /gun lang <language_code> - Switch language (zh_CN/en_US) #### Grenade Commands - /gun give grenade [amount] - Get High Explosive Grenade - /gun give molotov [amount] - Get Molotov Cocktail - /gun give smoke [amount] - Get Smoke Grenade

Configuration Updates

#### Language Configuration

# Language Settings
# Supported languages: zh_CN (Chinese), en_US (English)
language: "zh_CN"

#### Grenade Configuration - Throw distance: High throw max 50 blocks, low throw max 10 blocks - Throw cooldown: 2 seconds - Explosion delay: 5 seconds - Fire duration: 10 seconds - Smoke duration: 15 seconds

Bug Fixes

#### Grenade System Fixes - Fixed bug where items were consumed during cooldown - Fixed High Explosive Grenade explosion center position error - Fixed grenade entity not being cleared after explosion - Fixed inaccurate countdown timing #### Multi-Language System Fixes - Fixed warnings caused by missing message keys - Fixed gun item names not being translated - Fixed ActionBar messages not being translated - Fixed console logs not being translated - Fixed help messages not being translated

New Files

#### Language Files - src/main/resources/messages/zh_CN.yml - Chinese language file - src/main/resources/messages/en_US.yml - English language file #### Documentation Files - Multi-language system usage guide - Multi-language system fix guide - Final fix guide - Grenade system usage guide

Technical Improvements

#### Code Structure Optimization - Added LanguageManager class for multi-language management - Added GrenadeManager class for grenade management - Added Grenade class for grenade logic - Optimized GunCommand class for multi-language support - Optimized GunListener class for multi-language support #### Performance Optimization - Optimized grenade entity management - Optimized language file loading - Optimized message retrieval performance

Compatibility

#### Backward Compatibility - Maintains complete compatibility with existing gun system - Maintains complete compatibility with existing command system - Maintains complete compatibility with existing configuration format #### Version Compatibility - Supports Minecraft 1.21.4 - Supports Spigot API - Supports Bukkit API

Statistics

#### Code Statistics - New code lines: ~2000+ lines - New class files: 4 - New language files: 2 - Modified files: 15+ #### Feature Statistics - New grenade types: 3 - New language support: 2 - New commands: 3 - New configuration options: 1 ---

枪械插件更新日志

[1.2.0]

重大更新

#### 投掷物系统 - 新增高爆手雷 - 投掷后5秒爆炸，对半径5格内的生物造成伤害 - 中心爆炸伤害20点，边缘伤害2点 - 材质：粘液球 - 支持左键低抛、右键高抛投掷 - 新增燃烧瓶 - 在落点生成半径3格的火焰粒子 - 对接触的玩家造成每秒4点伤害，持续10秒 - 火焰会向下传播直到遇到非空气方块 - 材质：火焰弹 - 支持左键低抛、右键高抛投掷 - 新增烟雾弹 - 在落点生成半径3格、高3格的烟雾粒子 - 提供视觉掩护，持续15秒 - 材质：鸡蛋 - 支持左键低抛、右键高抛投掷 #### 多语言系统 - 完整的多语言支持 - 支持中文 (zh_CN) 和英文 (en_US) - 可通过配置文件切换语言 - 支持语言切换命令 /gun lang - 本地化内容 - 所有游戏内消息支持多语言 - 枪械名称、弹药名称、投掷物名称本地化 - 帮助信息、错误消息、控制台日志本地化 - ActionBar消息、物品描述本地化

功能改进

#### 投掷物系统优化 - 投掷冷却机制 - 投掷间隔2秒，防止连续投掷 - 冷却期间显示剩余时间提示 - 高爆手雷优化 - 投掷时开始倒计时，不再等待落地 - 落地时播放音效：minecraft:block.anvil.place 和 minecraft:entity.tnt.primed - 倒计时期间持续显示烟雾粒子 - 爆炸后确保实体正确清除 - 燃烧瓶优化 - 火焰中播放火焰音效 minecraft:block.fire.ambient - 火焰向下传播逻辑优化 - 最多检查20格深度 - 烟雾弹优化 - 使用 minecraft:explosion_emitter 粒子效果 - 烟雾高度和半径优化 #### 语言系统优化 - 语言管理器增强 - 自动从资源文件夹复制语言文件 - 支持消息键回退机制 - 详细的调试日志和错误处理 - 参数替换系统支持 - 枚举多语言支持 - GunType 枚举支持本地化名称 - AmmoType 枚举支持本地化名称和描述 - 动态获取当前语言设置

新增命令

#### 语言管理命令 - /gun lang - 显示当前语言和可用语言 - /gun lang <语言代码> - 切换语言 (zh_CN/en_US) #### 投掷物命令 - /gun give grenade [数量] - 获得高爆手雷 - /gun give molotov [数量] - 获得燃烧瓶 - /gun give smoke [数量] - 获得烟雾弹

配置更新

#### 语言配置

# 语言设置 (Language Settings)
# 支持的语言: zh_CN (中文), en_US (英文)
language: "zh_CN"

#### 投掷物配置 - 投掷距离：高抛最远50格，低抛最远10格 - 投掷冷却：2秒 - 爆炸延迟：5秒 - 火焰持续时间：10秒 - 烟雾持续时间：15秒

错误修复

#### 投掷物系统修复 - 修复投掷冷却期间仍扣除物品数量的bug - 修复高爆手雷爆炸中心位置错误的问题 - 修复手雷爆炸后实体不清除的问题 - 修复倒计时时间不准确的问题 #### 多语言系统修复 - 修复消息键不存在导致的警告 - 修复枪械物品名称不翻译的问题 - 修复ActionBar消息不翻译的问题 - 修复控制台日志不翻译的问题 - 修复帮助消息不翻译的问题

新增文件

#### 语言文件 - src/main/resources/messages/zh_CN.yml - 中文语言文件 - src/main/resources/messages/en_US.yml - 英文语言文件 #### 文档文件 - 多语言系统说明.md - 多语言系统使用说明 - 多语言系统修复说明.md - 多语言系统修复说明 - 多语言系统最终修复说明.md - 最终修复说明 - 投掷物系统说明.md - 投掷物系统使用说明

技术改进

#### 代码结构优化 - 新增 LanguageManager 类管理多语言 - 新增 GrenadeManager 类管理投掷物 - 新增 Grenade 类处理投掷物逻辑 - 优化 GunCommand 类支持多语言 - 优化 GunListener 类支持多语言 #### 性能优化 - 投掷物实体管理优化 - 语言文件加载优化 - 消息获取性能优化

兼容性

#### 向后兼容 - 保持原有枪械系统完全兼容 - 保持原有命令系统完全兼容 - 保持原有配置文件格式兼容 #### 版本兼容 - 支持 Minecraft 1.21.4 - 支持 Spigot API - 支持 Bukkit API

统计信息

#### 代码统计 - 新增代码行数：约 2000+ 行 - 新增类文件：4个 - 新增语言文件：2个 - 修改文件：15+ 个 #### 功能统计 - 新增投掷物类型：3种 - 新增语言支持：2种 - 新增命令：3个 - 新增配置项：1个 --- 版本: 1.2.0

v1.1.0 - Major Update



New Weapon System

- Renamed Original Weapons: - Pistol → P250 (Leather Horse Armor) - Rifle → AK-74 (Iron Horse Armor) - Shotgun → AA-12 (Golden Horse Armor) - Sniper → AWM (Diamond Horse Armor) - Added 11 New Weapons: - HK416 (Black Dye) - Full-auto assault rifle - PP19 (Brown Dye) - High-rate submachine gun - AUG (Red Dye) - Precision assault rifle - MK-14 (Orange Dye) - High-damage automatic rifle - S686 (Yellow Dye) - Double-barrel shotgun - 98K (Lime Dye) - Classic sniper rifle - Vector (Green Dye) - Ultra-high-speed submachine gun - Negev (Cyan Dye) - Heavy machine gun - SKS (Light Blue Dye) - Semi-automatic sniper rifle - Desert Eagle (Blue Dye) - High-caliber pistol - CZ75 (Purple Dye) - Compact pistol 

Weapon Characteristics

- Firing Mode Classification: - Full-auto weapons: AK-74, HK416, PP19, AUG, MK-14, Vector, Negev, CZ75 - Semi-auto weapons: 98K, SKS, Desert Eagle - Single-shot weapons: P250, AWM - Shotguns: AA-12, S686 - Balanced Design: - Damage range: 4.0-20.0 - Fire rate range: 0.4-25 rounds/second - Magazine capacity range: 2-150 rounds - Penetration power: 0-4 blocks 

Sound System

- Sound Classification: - Pistol sound group: P250, CZ75, Desert Eagle - Rifle sound group: AK-74, HK416, PP19, AUG, MK-14, Vector, Negev, SKS - Shotgun sound group: AA-12, S686 - Sniper sound group: AWM, 98K - Multi-layered Sounds: - Each weapon has unique shooting sounds - Includes main sound and delayed sound - Volume and pitch carefully tuned 

Command System

- New Command Support: - Supports /gun give command for all 15 weapons - Complete auto-completion functionality - Detailed help information - Backward Compatibility: - Maintains full compatibility with old commands - pistol → P250, rifle → AK-74, shotgun → AA-12, sniper → AWM 

Technical Improvements

- Code Refactoring: - Updated GunType enum to support 15 weapons - Refactored sound system with sound classification - Optimized command processing logic - Performance Optimization: - Improved weapon identification algorithms - Optimized sound playback mechanisms - Enhanced memory management 

v1.1.0 - 重大更新

新枪械系统 / New Weapon System

- 重命名原枪械 / Renamed Original Weapons: - 手枪 → P250 (皮革马铠) - 步枪 → AK-74 (铁马铠) - 霰弹枪 → AA-12 (金马铠) - 狙击枪 → AWM (钻石马铠) - 新增11种枪械 / Added 11 New Weapons: - HK416 (黑色染料) - 全自动突击步枪 - PP19 (棕色染料) - 高射速冲锋枪 - AUG (红色染料) - 精确突击步枪 - MK-14 (橙色染料) - 高伤害自动步枪 - S686 (黄色染料) - 双管霰弹枪 - 98K (黄绿色染料) - 经典狙击步枪 - Vector (绿色染料) - 超高速冲锋枪 - 内格夫 (青色染料) - 重型机枪 - SKS (淡蓝色染料) - 半自动狙击步枪 - 沙漠之鹰 (蓝色染料) - 大口径手枪 - CZ75 (紫色染料) - 紧凑型手枪

武器特性 / Weapon Characteristics

- 射击模式分类 / Firing Mode Classification: - 全自动武器: AK-74, HK416, PP19, AUG, MK-14, Vector, 内格夫, CZ75 - 半自动武器: 98K, SKS, 沙漠之鹰 - 单发武器: P250, AWM - 霰弹枪: AA-12, S686 - 平衡性设计 / Balanced Design: - 伤害范围: 4.0-20.0 - 射速范围: 0.4-25发/秒 - 弹容量范围: 2-150发 - 穿透力: 0-4格

音效系统 / Sound System

- 音效分类 / Sound Classification: - 手枪音效组: P250, CZ75, 沙漠之鹰 - 步枪音效组: AK-74, HK416, PP19, AUG, MK-14, Vector, 内格夫, SKS - 霰弹枪音效组: AA-12, S686 - 狙击枪音效组: AWM, 98K - 多层次音效 / Multi-layered Sounds: - 每种枪械都有独特的射击音效 - 包含主音效和延迟音效 - 音量和音调经过精心调校

命令系统 / Command System

- 新命令支持 / New Command Support: - 支持所有15种枪械的/gun give命令 - 完整的自动补全功能 - 详细的帮助信息 - 向后兼容 / Backward Compatibility: - 保持旧命令的完全兼容性 - pistol → P250, rifle → AK-74, shotgun → AA-12, sniper → AWM

技术改进 / Technical Improvements

- 代码重构 / Code Refactoring: - 更新了GunType枚举，支持15种枪械 - 重构了音效系统，支持音效分类 - 优化了命令处理逻辑 - 性能优化 / Performance Optimization: - 改进了枪械识别算法 - 优化了音效播放机制 - 增强了内存管理

音效调整 / Sound Adjustments

- CZ75音效更新 / CZ75 Sound Update: - 从步枪音效改为手枪音效 - 与P250使用相同的音效配置 - 更符合其紧凑型手枪的定位 - 沙漠之鹰音效更新 / Desert Eagle Sound Update: - 从步枪音效改为手枪音效 - 与P250使用相同的音效配置 - 更符合其大口径手枪的特点

技术实现 / Technical Implementation

- 添加了专门的音效处理逻辑 - 为CZ75和沙漠之鹰配置了与P250相同的手枪音效 - 保持了音效系统的一致性和可维护性

GunPlugin - 枪械插件详细说明

GunPlugin - Detailed Plugin Description

---

插件概述 / Plugin Overview

中文描述

GunPlugin是一个功能丰富的Minecraft枪械插件，为Spigot 1.21.4服务器提供完整的射击体验。插件支持多种枪械类型、真实弹道系统、自定义配置和高级射击功能，让玩家在Minecraft中体验真实的枪战。

English Description

GunPlugin is a feature-rich Minecraft gun plugin that provides a complete shooting experience for Spigot 1.21.4 servers. The plugin supports multiple weapon types, realistic ballistics system, custom configuration, and advanced shooting features, allowing players to experience realistic gunfights in Minecraft. ---

功能列表 / Feature List

核心功能 / Core Features

#### 1. 枪械系统 / Weapon System - 默认枪械 / Default Weapons: - 手枪 (皮革马铠) - 单发，12发弹匣，4点伤害 - 步枪 (铁马铠) - 连发，40发弹匣，5点伤害 - 霰弹枪 (金马铠) - 多发，7发弹匣，15点伤害 - 狙击枪 (钻石马铠) - 单发，5发弹匣，20点伤害 - 自定义枪械 / Custom Weapons: - 支持任意物品材质作为枪械 - 可配置弹匣容量、伤害、射速等参数 - 支持自动/单发/霰弹枪模式 #### 2. 弹道系统 / Ballistics System - 子弹物理 / Bullet Physics: - 真实的重力下坠效果 - 可配置的子弹速度 - 穿透系统（可穿透特定方块） - 移动散步系统（移动时精度降低） #### 3. 射击机制 / Shooting Mechanics - 射击模式 / Firing Modes: - 单发模式：点击射击 - 连发模式：按住连续射击 - 霰弹枪模式：一次发射多发子弹 - 弹药管理 / Ammunition Management: - 弹匣系统 - 自动换弹 - 手动换弹（F键） - 弹药显示（ActionBar） #### 4. 音效系统 / Sound System - 多层次音效 / Multi-layered Sounds: - 射击音效（延迟播放） - 换弹音效（分阶段播放） - 击中音效 - 后坐力音效 #### 5. 视觉效果 / Visual Effects - 粒子效果 / Particle Effects: - 枪口火焰 - 子弹轨迹 - 击中效果 - 血雾效果 - 后坐力粒子 #### 6. 交互系统 / Interaction System - 左键右键禁用 / Left/Right Click Disable: - 持枪时禁用左键攻击 - 持枪时禁用右键交互 - 可配置开启/关闭 #### 7. 高级功能 / Advanced Features - 爆头检测 / Headshot Detection: - 击中头部增加30%伤害 - 特殊音效反馈 - 后坐力系统 / Recoil System: - 视觉粒子反馈 - 不影响玩家移动 ---

使用教程 / Usage Tutorial

基础使用 / Basic Usage

#### 1. 获得枪械 / Getting Weapons

# 给予默认枪械 / Give default weapons
/gun give pistol      # 手枪 / Pistol
/gun give rifle       # 步枪 / Rifle
/gun give shotgun     # 霰弹枪 / Shotgun
/gun give sniper      # 狙击枪 / Sniper

# 给予自定义枪械 / Give custom weapons
/gun give custom_rifle  # 自定义步枪 / Custom rifle

#### 2. 射击操作 / Shooting Operations - 单发武器 / Single-shot Weapons: - 右键点击射击 - 自动消耗弹药 - 弹匣空时自动换弹 - 连发武器 / Automatic Weapons: - 按住右键连续射击 - 松开右键停止射击 - 支持弹药耗尽自动换弹 - 霰弹枪 / Shotgun: - 一次发射5发子弹 - 每发子弹有独立弹道 - 近距离伤害更高 #### 3. 换弹操作 / Reload Operations - 自动换弹 / Auto Reload: - 弹匣空时自动开始换弹 - 显示换弹进度 - 播放换弹音效 - 手动换弹 / Manual Reload: - 按F键手动换弹 - 可在任何时候换弹 - 换弹时无法射击 #### 4. 弹药管理 / Ammunition Management

# 设置弹药数量 / Set ammo count
/gun ammo 100  # 设置当前枪械弹药为100发 / Set current weapon ammo to 100

# 查看弹药信息 / View ammo info
# 弹药信息显示在ActionBar中 / Ammo info displayed in ActionBar

高级使用 / Advanced Usage

#### 1. 自定义枪械创建 / Custom Weapon Creation

# 在config.yml中添加自定义枪械 / Add custom weapon in config.yml
guns:
  my_rifle:
    name: "我的步枪"  # Weapon name
    material: "IRON_SWORD"  # Item material
    magazine_size: 30  # Magazine capacity
    damage: 6.0  # Damage
    fire_rate: 0.1  # Fire rate (seconds)
    bullet_speed: 80  # Bullet speed
    bullet_drop: 0.08  # Bullet drop
    shoot_sound: "ENTITY_ZOMBIE_BREAK_WOODEN_DOOR"  # Shoot sound
    reload_time: 2.5  # Reload time
    penetration_power: 2  # Penetration power
    recoil: 1.8  # Recoil
    is_automatic: true  # Automatic firing
    is_shotgun: false  # Not shotgun
    shotgun_pellets: 1  # Single pellet

#### 2. 配置系统设置 / Configure System Settings

# 插件设置 / Plugin settings
settings:
  disable_left_click: true  # 禁用左键攻击 / Disable left-click attacks
  disable_right_click_interaction: true  # 禁用右键交互 / Disable right-click interactions

#### 3. 权限配置 / Permission Configuration

# LuckPerms权限配置示例 / LuckPerms permission configuration example
groups:
  default:
    permissions:
      - gunplugin.use  # 基础使用权限 / Basic usage permission
  vip:
    permissions:
      - gunplugin.use
      - gunplugin.give  # 给予枪械权限 / Give weapons permission
  admin:
    permissions:
      - gunplugin.*  # 所有权限 / All permissions

---

调试教程 / Debugging Tutorial

常见问题诊断 / Common Issue Diagnosis

#### 1. 子弹没有伤害 / Bullets Don't Deal Damage 症状 / Symptoms: - 子弹击中目标但没有伤害 - 子弹轨迹正常但无效果 诊断步骤 / Diagnosis Steps:

# 1. 检查玩家权限 / Check player permissions
/lp user <player> permission check gunplugin.use

# 2. 检查插件状态 / Check plugin status
/plugins

# 3. 查看控制台错误 / Check console errors
# 查看服务器控制台是否有错误信息 / Check server console for error messages

# 4. 测试基础功能 / Test basic functions
/gun give pistol
# 尝试射击测试 / Try shooting test

解决方案 / Solutions: - 确保玩家有gunplugin.use权限 - 检查插件是否正确加载 - 重新加载插件：/reload - 检查是否有其他插件冲突 #### 2. 自动射击不工作 / Auto Fire Not Working 症状 / Symptoms: - 按住右键无法连续射击 - 射击立即停止 诊断步骤 / Diagnosis Steps:

# 1. 检查枪械类型 / Check weapon type
# 确认使用的是自动武器（步枪） / Confirm using automatic weapon (rifle)

# 2. 检查弹药 / Check ammunition
# 确保有足够弹药 / Ensure sufficient ammunition

# 3. 检查换弹状态 / Check reload status
# 确保不在换弹中 / Ensure not reloading

解决方案 / Solutions: - 使用步枪进行测试 - 确保弹药充足 - 等待换弹完成 - 检查右键松开检测设置 #### 3. 自定义枪械不工作 / Custom Weapons Not Working 症状 / Symptoms: - 自定义枪械无法射击 - 配置不生效 诊断步骤 / Diagnosis Steps:

# 1. 检查配置文件语法 / Check config file syntax
# 确保YAML格式正确 / Ensure YAML format is correct

# 2. 重新加载配置 / Reload configuration
/reload

# 3. 检查材质名称 / Check material names
# 确保材质名称正确 / Ensure material names are correct

解决方案 / Solutions: - 检查YAML语法错误 - 使用正确的材质名称 - 重新加载插件 - 参考默认配置格式 #### 4. 音效不播放 / Sounds Not Playing 症状 / Symptoms: - 射击时没有音效 - 换弹时没有音效 诊断步骤 / Diagnosis Steps:

# 1. 检查音效名称 / Check sound names
# 确保音效名称正确 / Ensure sound names are correct

# 2. 检查客户端设置 / Check client settings
# 确保音效已启用 / Ensure sounds are enabled

# 3. 测试默认音效 / Test default sounds
# 使用默认枪械测试 / Test with default weapons

解决方案 / Solutions: - 使用正确的音效名称 - 检查客户端音效设置 - 使用默认配置测试 - 更新到最新版本

调试命令 / Debug Commands

# 检查插件状态 / Check plugin status
/plugins

# 重新加载插件 / Reload plugin
/reload

# 检查玩家权限 / Check player permissions
/lp user <player> permission check gunplugin.use

# 查看插件配置 / View plugin configuration
# 检查plugins/GunPlugin/config.yml文件 / Check plugins/GunPlugin/config.yml file

日志分析 / Log Analysis

#### 重要日志信息 / Important Log Information

# 插件加载日志 / Plugin loading logs
[INFO] [GunPlugin] Enabling GunPlugin v1.9.7
[INFO] [GunPlugin] GunPlugin has been enabled!

# 错误日志 / Error logs
[ERROR] [GunPlugin] Error in bullet update task
[WARN] [GunPlugin] Player not found in ammo data

# 调试信息 / Debug information
[DEBUG] [GunPlugin] Player <player> shot with <weapon>
[DEBUG] [GunPlugin] Bullet hit entity: <entity>

---

功能原理 / Feature Principles

1. 子弹系统原理 / Bullet System Principles

#### 子弹创建 / Bullet Creation

// 子弹创建流程 / Bullet creation process
1. 玩家射击触发 / Player shooting triggered
2. 检查弹药和权限 / Check ammunition and permissions
3. 创建Bullet对象 / Create Bullet object
4. 添加到activeBullets列表 / Add to activeBullets list
5. 启动子弹更新任务 / Start bullet update task

#### 子弹更新 / Bullet Update

// 子弹更新机制 / Bullet update mechanism
public boolean update() {
    // 1. 应用重力 / Apply gravity
    velocity.add(new Vector(0, -bulletDrop / 20.0, 0));
    
    // 2. 移动子弹 / Move bullet
    Location newLocation = location.clone().add(velocity);
    
    // 3. 检测碰撞 / Detect collision
    RayTraceResult result = world.rayTraceEntities(...);
    
    // 4. 处理击中 / Handle hit
    if (result != null) {
        // 造成伤害 / Deal damage
        // 播放音效 / Play sound
        // 显示粒子 / Show particles
        return true; // 移除子弹 / Remove bullet
    }
    
    // 5. 检查方块碰撞 / Check block collision
    // 6. 处理穿透 / Handle penetration
    // 7. 更新位置 / Update position
}

2. 射击系统原理 / Shooting System Principles

#### 单发射击 / Single Shot ```java // 单发射击流程 / Single shot process 1. 检查射击条件 / Check shooting conditions - 弹药检查 / Ammunition check - 射速检查 / Fire