Download File

# 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 ```yaml # 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 [数量]` - 获得烟雾弹 ### 📋 配置更新 #### 语言配置 ```yaml # 语言设置 (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