?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
GunPlugin

GunPlugin

A feature rich Minecraft Java version firearm plugin一个功能丰富的Minecraft Java版枪械插件

5.9Kdownloads
10followers
5.9Kdownloads
10followers

Tags

Creators

Details

Licensed MIT
Published last year
Updated 3 months ago
All versions

3.0.0

Alpha
GunPlugin 3.0.0last year 210
Download

Compatibility

Minecraft: Java Edition
1.21–1.21.10
Platforms
Bukkit
Paper
Purpur
Spigot

Changes

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 Optimization

中文

  • 重写半自动射击逻辑
    • 按下右键发射一颗子弹
    • 必须释放右键后再次按下才能发射下一发
    • 更真实的半自动射击体验
    • 修复了连续点击无法发射的问题

English

  • Rewritten Semi-Automatic Firing Logic
    • Press right-click to fire one bullet
    • Must release right-click and press again to fire the next shot
    • More realistic semi-automatic firing experience
    • Fixed issue where continuous clicking couldn't fire

配件系统优化 / Attachment System Optimization

中文

  • 配件GUI锁定

    • 配件GUI中的物品完全锁定，无法拖拽
    • 防止误操作导致配件丢失
    • 返回按钮和关闭按钮正常工作

  • 配件兼容性优化

    • 智能配件兼容性检查
    • 支持跨类型配件使用（如狙击步枪使用步枪配件）
    • 配件效果正确叠加

English

  • Attachment GUI Locking

    • Items in attachment GUI are completely locked, cannot be dragged
    • Prevents accidental loss of attachments
    • Back button and close button work correctly

  • Attachment Compatibility Optimization

    • Smart attachment compatibility checking
    • Supports cross-type attachment usage (e.g., DMRs using rifle attachments)
    • Attachment effects correctly stack

🐛 错误修复 / Bug Fixes

配件系统修复 / Attachment System Fixes

中文

  • 修复了配件GUI中物品可以被拖拽的问题
  • 修复了配件安装和卸载功能不工作的问题
  • 修复了返回按钮无效的问题
  • 修复了狙击步枪无法装配托腮板的问题
  • 修复了配件页面部分内容未适配英文的问题
  • 修复了狙击枪配件分类中重复显示托腮板的问题

English

  • Fixed issue where items in attachment GUI could be dragged
  • Fixed issue where attachment installation and removal didn't work
  • Fixed issue where back button was ineffective
  • Fixed issue where DMRs couldn't install cheek pads
  • Fixed issue where part of attachment page wasn't adapted to English
  • Fixed issue where sniper attachment category showed duplicate cheek pads

射击系统修复 / Firing System Fixes

中文

  • 修复了半自动武器连续点击无法发射的问题
  • 修复了射速计算问题（fireRate < 0.1时射速过快）
  • 修复了自动武器射速不准确的问题

English

  • Fixed issue where semi-automatic weapons couldn't fire on continuous clicks
  • Fixed fire rate calculation issue (fire rate too fast when fireRate < 0.1)
  • Fixed issue where automatic weapon fire rate was inaccurate

语言系统修复 / Language System Fixes

中文

  • 修复了command.unknown_command和command.reload_success语言键缺失的警告
  • 修复了配件槽位名称未本地化的问题
  • 修复了配件GUI标题未本地化的问题

English

  • Fixed warnings for missing language keys command.unknown_command and command.reload_success
  • Fixed issue where attachment slot names weren't localized
  • Fixed issue where attachment GUI titles weren't localized

📋 配置更新 / Configuration Updates

配置文件版本 / Configuration File Version

中文

  • 配置文件版本更新至 3.0.0
  • 新增配件价格配置
  • 新增USP和.45弹药价格配置

English

  • Configuration file version updated to 3.0.0
  • Added attachment price configuration
  • Added USP and .45 ammo price configuration

配件价格配置 / Attachment Price Configuration

中文

  • 步枪配件：消音器、补偿器、扩容弹匣、镭指、握把、枪托
  • 冲锋枪配件：消音器、扩容弹匣、握把、枪托
  • 霰弹枪配件：消音器、枪托、托腮板
  • 手枪配件：消音器、扩容弹匣、握把、枪托
  • 狙击枪配件：消音器、补偿器、扩容弹匣、镭指、枪托、托腮板

English

  • Rifle Attachments: Silencers, Compensators, Extended Magazines, Laser Sights, Grips, Stocks
  • SMG Attachments: Silencers, Extended Magazines, Grips, Stocks
  • Shotgun Attachments: Silencers, Stocks, Cheek Pads
  • Pistol Attachments: Silencers, Extended Magazines, Grips, Stocks
  • Sniper Attachments: Silencers, Compensators, Extended Magazines, Laser Sights, Stocks, Cheek Pads

🔄 技术改进 / Technical Improvements

代码结构优化 / Code Structure Optimization

中文

  • 新增 ModificationManager 类管理配件系统
  • 新增 ModificationGUI 类处理配件GUI
  • 新增 AttachmentSlot 和 AttachmentType 枚举
  • 优化 GunType 枚举，添加槽位支持方法
  • 优化射速计算逻辑，使用毫秒级精确控制

English

  • Added ModificationManager class to manage attachment system
  • Added ModificationGUI class to handle attachment GUI
  • Added AttachmentSlot and AttachmentType enums
  • Optimized GunType enum, added slot support methods
  • Optimized fire rate calculation logic, using millisecond-level precision control

性能优化 / Performance Optimization

中文

  • 配件数据持久化优化
  • GUI响应速度优化
  • 射速计算性能优化

English

  • Attachment data persistence optimization
  • GUI response speed optimization
  • Fire rate calculation performance optimization

🎯 兼容性 / Compatibility

向后兼容 / Backward Compatibility

中文

  • 保持原有枪械系统完全兼容
  • 保持原有命令系统完全兼容
  • 配置文件自动更新并保留自定义配置

English

  • Maintains full compatibility with existing gun system
  • Maintains full compatibility with existing command system
  • Configuration files automatically update and preserve custom settings

版本兼容 / Version Compatibility

中文

  • 支持 Minecraft 1.21.4
  • 支持 Spigot API
  • 支持 Bukkit API

English

  • Supports Minecraft 1.21.4
  • Supports Spigot API
  • Supports Bukkit API

📊 统计信息 / Statistics

代码统计 / Code Statistics

中文

  • 新增代码行数：约 1500+ 行
  • 新增类文件：3个
  • 修改文件：20+ 个

English

  • New code lines: ~1500+ lines
  • New class files: 3
  • Modified files: 20+

功能统计 / Feature Statistics

中文

  • 新增配件类型：30+ 种
  • 新增配件槽位：5个
  • 新增枪械：1种（USP）
  • 新增弹药类型：1种（.45口径）
  • 新增音效组合：10+ 种

English

  • New attachment types: 30+ types
  • New attachment slots: 5
  • New guns: 1 (USP)
  • New ammo types: 1 (.45 Caliber)
  • New sound combinations: 10+ types

📝 升级指南 / Upgrade Guide

从 2.0.0 升级到 3.0.0 / Upgrading from 2.0.0 to 3.0.0

中文

  1. 备份数据

    • 备份 plugins/GunPlugin/ 目录
    • 备份玩家数据（如果有）

  2. 更新插件

    • 下载 GunPlugin-3.0.0.jar
    • 替换旧版本插件文件

  3. 更新配置

    • 配置文件会自动更新到 3.0.0 版本
    • 自定义配置会被保留
    • 检查新配置项并根据需要调整

  4. 注意事项

    • 旧的升级系统已被移除，改为配件系统
    • 玩家原有的升级数据不会自动转换
    • 建议通知玩家重新配置配件

English

  1. Backup Data

    • Backup plugins/GunPlugin/ directory
    • Backup player data (if any)

  2. Update Plugin

    • Download GunPlugin-3.0.0.jar
    • Replace old version plugin file

  3. Update Configuration

    • Configuration files will automatically update to version 3.0.0
    • Custom settings will be preserved
    • Check new configuration items and adjust as needed

  4. Important Notes

    • Old upgrade system has been removed, replaced with attachment system
    • Player's existing upgrade data will not be automatically converted
    • Recommend notifying players to reconfigure attachments

🙏 致谢 / Acknowledgments

中文

  • 主要开发者：114514h
  • 社区贡献者：感谢所有贡献者

English

  • Main Developer: 114514h
  • Community Contributors: Thanks to all contributors

版本 3.0.0 - 2025年11月 / Version 3.0.0 - 11 2025