? CombatGunSSS
CombatGunSSS 是一款高性能、功能丰富的现代 Minecraft 枪械插件,专为现代服务器(1.21+)设计。它带来了战术性、逼真的战斗体验,包含 46 种独特配置的武器(40 种枪械 + 6 种近战)、高级合成机制、优化的即时命中(hitscan)技术、完整的自定义事件 API 以及不断增长的插件集成生态系统。
? 主要特性
- ? 战术战斗:具有精确后坐力、子弹散布和爆头倍率的逼真即时命中机制。
- ⚔️ 近战系统:左键近战攻击,具备范围检测、击退效果和独立的冷却系统。
- ?️ 高级穿透:弹丸可根据各枪械的属性穿过“软”方块和多个实体。
- ? 渐进式伤害:基于距离的伤害衰减和可配置的击退强度。
- ?️ 双层合成系统:
- 原版工作台:使用官方配方书支持合成基础组件。
- 机械合成台:一个用于组装高级枪械的自定义 21 槽工业 GUI。
- ? 交互式配方浏览器:内置于机械合成台中 — 无需命令!通过枪械、近战或弹药分类标签页浏览,快速找到想要合成的物品。
- ? 46 种内置武器:40 种远程枪械 + 6 种近战武器,支持连发、霰弹和近战逻辑。
- ? 耐久度系统:武器拥有有限的耐久度并需要修理(完全可配置)。
- ? 持久化 HUD:实时显示动作栏,包括枪械名称(按稀有度着色)、可视化弹药条、当前/最大弹药量以及备用弹药数量。
- ? 自动装填:发射最后一发子弹后自动重新装填(可切换)。
- ?️ WorldGuard 集成:通过自定义
gun-shooting 标志在受保护区域内禁止使用枪械。
- ? Vault 商店:玩家通过
/gun buy <id> 使用服务器经济购买武器。
- ? PlaceholderAPI:提供 8 个实时占位符,适用于记分板、HUD 和 TAB 插件。
- ? ADS(腰射转瞄准):每把枪独立的开镜系统。Shift+右键切换 — 减少散布并施加移动惩罚。
- ? 流血:可选的击中后持续伤害效果。按住绷带并按
[F] 即可治愈。
- ? 弹药袋:压缩弹药包。Shift+右键将其放入背包。通过
/gun givepouch 发放。
- ? 多语言 (i18n):所有消息存储在
lang/en.yml 或 lang/vi.yml 中。你可以添加自己的翻译文件。
- ?️ 反作弊:自动为 Vulcan 和 Matrix 添加豁免,以防止误判后坐力行为。
- ? 开发者 API:完整的自定义事件 —
GunShootEvent、GunReloadEvent、GunHitEvent、GunHeadshotEvent。
- ? 友军伤害控制:通过记分板队伍或权限组检测来开启/关闭友军伤害。
- ? 可切换特效:每个粒子效果和音效都可以单独启用/禁用。包括主音量控制
sound_volume。
- ? 自定义击杀信息:死亡信息显示击杀者姓名、武器名称(按稀有度着色)和爆头指示器。
? 玩家控制
| 操作 |
控制方式 |
| 射击 |
右键 |
| 装填 |
交换手按键 [F] |
| 近战攻击 |
左键 |
| 购买武器 |
/gun buy <id> |
| 合成 |
右键点击机械合成台 |
? 武器分类
远程武器 (39)
- 突击步枪: AK47, M4A1, SCAR, AUG, FAMAS, G36, Groza, AN94, M14, ParaFAL, XM8, Kingfisher
- 冲锋枪: MP5, P90, Vector, Bizon, UMP, Thompson, MAC-10, MP40, VSS, CG15
- 狙击枪: AWM, M24, Kar98k, M82B, M107, VSK94
- 霰弹枪: M1014, SPAS-12, MAG-7, M1887, M590, Trogon
- 手枪: Desert Eagle, G18, USP, M1917, M1873, M500
近战武器 (6)
- 棒球棍: 普通,挥动速度快
- 匕首: 普通,攻速最高
- 平底锅: 稀有,防御性击退
- 砍刀: 稀有,伤害/速度平衡
- 武士刀: 史诗,高伤害
- 镰刀: 传说,最大伤害
? 技术武器属性
CombatGunSSS 中的每把武器都拥有一系列深度的可配置属性:
- 伤害衰减:定义伤害开始下降的确切方块距离 (
damage_falloff_start) 和最小伤害下限 (min_damage_multiplier)。
- 后坐力与散布:每次射击独立的俯仰角(垂直)和偏航角(水平)后坐力,以及在移动或跳跃时的移动散布惩罚。
- 连发:配置武器在每次扣动扳机时发射多发子弹 (
burst_count),并设置自定义延迟。
- 霰弹逻辑:支持每次射击发射多个弹丸 (
projectiles_per_shot),并计算单个弹丸的伤害。
- 耐久度:设置最大使用次数 (
max_durability)。武器将损坏且无法使用,直到修理完毕。
- 穿透:定义单个弹丸可以穿过的方块数 (
block_penetration) 或实体数 (entity_penetration)。
- 近战范围:近战武器的最大攻击距离(默认:4 个方块)。
- 击退:远程和近战武器的推力强度。
? 文件夹结构
plugins/CombatGunSSS/
├── config.yml # 主配置文件
├── guns/ # 远程武器配置 (40 种内置 + 自定义)
│ ├── ak47.yml
│ ├── m4a1.yml
│ └── ...
├── melees/ # 近战武器配置 (6 种内置 + 自定义)
│ ├── katana.yml
│ ├── knife.yml
│ └── ...
└── README.md
自定义武器:在 guns/ 或 melees/ 文件夹中创建你自己的 YAML 文件,然后运行 /gun reload。
⚒️ 合成机制
1. 组件(基础)
在标准合成台中合成原材料,如钢锭、枪管和弹簧。这些配方会自动在你的原版配方书中解锁。
2. 组装(进阶)
将你的组件放入机械合成台。
- 非网格模式:只需将材料投入 21 格输入区域即可。
- 视觉预览:在合成之前,输出槽会显示你武器的属性。
- 配方指南:点击工作站中的发光书本图标,浏览所有武器需求。
? 动作栏 HUD
手持任何远程武器时,CombatGunSSS 会在你的动作栏上显示一个持久化的 HUD:
? AK47 ▐████████████░░░░▌ 22 / 30 • 90
- 枪械名称根据稀有度着色:白色(普通)→ 青色(稀有)→ 浅紫色(史诗)→ 金色(传说)。
- 可视化进度条随着弹药耗尽,颜色由绿变为金(≤25%),再变为红(≤10%)。
- 备用数量在你没有备用弹药时变红。
- 在主动装填期间,HUD 会自动让位于装填进度条。
combatgun:
hud:
enabled: true
update_interval_ticks: 5
? ADS — 开镜瞄准
在 YAML 配置中为每把枪启用 ADS:
ads:
enabled: true
spread_multiplier: 0.35 # 开镜时精度提高 65%
movement_penalty: 0.6 # 开镜时的移动速度倍率
控制方式:Shift+右键切换 ADS 开关。动作栏显示 ? ADS [spread ×0.35]。
当你切换物品、传送或死亡时,ADS 会自动退出。可缩放狙击步枪使用传统的潜行开镜机制,而非 ADS。
? 流血
一个可选的伤害持续(DoT)系统。启用后,击中玩家的子弹有可配置的几率造成流血效果。
combatgun:
bleeding:
enabled: true
chance: 0.15
damage_per_second: 1.0
duration_seconds: 10
cure_item: bandage
手持绷带(合成组件)并按下 [F] 键进行治疗。死亡时流血效果会自动停止。
? 弹药袋
一种压缩弹药容器,可在单个槽位中存储数百发子弹。
/gun givepouch ar_ammo 300 PlayerName
Shift+右键将所有子弹卸载到你的物品栏中。如果物品栏已满,多余的子弹会被留在原地。
? 多语言支持
在 config.yml 中设置活动语言:
combatgun:
language: vi # en | vi | (任意 lang/xx.yml)
内置:English (en) 和 Tiếng Việt (vi)。通过在插件数据文件夹中放置 lang/xx.yml 并运行 /gun reload 来添加自定义翻译。
? 插件集成
PlaceholderAPI
8 个实时占位符,可用于记分板、TAB、AdvancedHud 等类似插件:
| 占位符 |
示例 |
描述 |
%combatgun_gun_name% |
AK47 |
手持枪械的显示名称 |
%combatgun_gun_id% |
ak47 |
手持枪械的内部 ID |
%combatgun_gun_rarity% |
epic |
手持枪械的稀有度 |
%combatgun_ammo% |
24 |
当前弹匣弹药量 |
%combatgun_ammo_max% |
30 |
弹匣容量 |
%combatgun_ammo_reserve% |
90 |
物品栏中的备用弹药量 |
%combatgun_is_reloading% |
true |
玩家是否正在装填 |
%combatgun_is_gun% |
true |
手持物品是否为枪械 |
Vault Shop
在 config.yml 中启用商店,为每把枪设置价格,然后玩家可以在游戏中购买武器:
combatgun:
shop:
enabled: true
currency_symbol: "$"
guns:
ak47: 700.0
awm: 2500.0
knife: 100.0
/gun buy ak47 # 按配置价格购买
/gun buy ak47 free # 管理员免费赠送(需要 combatgun.admin 权限)
WorldGuard
当存在 WorldGuard 时,自定义标志 gun-shooting 会自动注册:
/rg flag <region> gun-shooting deny # 在该区域禁止所有枪械
/rg flag <region> gun-shooting allow # 明确允许
/rg flag <region> gun-shooting -g # 移除标志(继承父级)
如果区域未设置 gun-shooting,则回退到 WorldGuard 内置的 PVP 标志。
反作弊 (Vulcan / Matrix)
自动检测。当存在反作弊插件时,每次射击后的 anticheat.exempt_ticks 刻内,玩家将被豁免运动检查,以防止后坐力触发误报。
combatgun:
anticheat:
exempt_ticks: 3
? 命令与权限
| 命令 |
描述 |
权限 |
/gun statsreset <player> |
重置特定玩家的统计信息 |
combatgun.admin |
/gun seasonreset confirm |
清除所有玩家的统计信息(赛季重置) |
combatgun.admin |
/gun give <id> [player] |
给予特定武器 |
combatgun.admin |
/gun giveammo <id> [amt] [player] |
给予自定义弹药 |
combatgun.admin |
/gun givepart <id> [amt] [player] |
给予合成组件 |
combatgun.admin |
/gun station [player] |
给予机械合成台 |
combatgun.admin |
/gun book [player] |
给予配方指南书 |
combatgun.admin |
/gun recipe <id> |
在聊天中显示完整的合成链 |
combatgun.admin |
/gun list [category] |
查看所有已加载的武器 |
combatgun.admin |
/gun inspect [player] |
查看手持武器的深层统计信息 |
combatgun.admin |
/gun reload |
重新加载所有配置 |
combatgun.admin |
/gun buy <id> |
购买武器(需要 Vault) |
combatgun.use |
/gun givepouch <ammo_id> <amount> [player] |
给予弹药袋 |
combatgun.admin |
玩家权限
combatgun.use — 允许射击和使用枪械(默认:true)
combatgun.use.<gun_id> — 单把枪的权限节点(例如 combatgun.use.awm)
? 配置示例
远程武器(AK47)
name: AK47
category: assault_rifles
ammo_type: ar_ammo
damage: 12
fire_rate: 10.0
magazine_size: 30
reload_time: 2.6
headshot_multiplier: 1.8
damage_falloff_start: 35.0
min_damage_multiplier: 0.5
range: 72.0
block_penetration: 0.8
entity_penetration: 0
recoil:
pitch: 1.45
yaw: 0.42
spread: 0.24
recovery: 0.80
rarity: rare
custom_model_data: 1001
sound: ENTITY_FIREWORK_ROCKET_BLAST
recipe:
station: mechanical_crafting_table
ingredients:
steel_ingot: 6
gun_barrel: 1
spring: 2
hardwood: 3
近战武器(Katana)
name: Katana
category: melee
ammo_type: none
rarity: epic
damage: 10
fire_rate: 1.35
range: 4.0
knockback: 0.3
sound: ENTITY_PLAYER_ATTACK_CRIT
custom_model_data: 26002
recipe:
station: mechanical_crafting_table
ingredients:
steel_ingot: 10
carbon_fiber: 2
leather_strip: 3
blade_core: 1
? 开发者 API
自定义事件
| 事件 |
可取消 |
触发时机 |
GunShootEvent |
✅ |
每次射击前 — 可取消或设置伤害倍率 |
GunReloadEvent |
✅ |
玩家开始装填弹药时 |
GunHitEvent |
❌ |
伤害生效后 — 完整的伤害处理流程 |
GunHeadshotEvent |
❌ |
子弹命中头部区域时 |
AttachmentApplyEvent |
✅ |
配件安装到枪械之前 |
AttachmentRemoveEvent |
✅ |
从枪械上移除配件之前 |
@EventHandler
public void onShoot(GunShootEvent event) {
if (isInsideArena(event.getShooter()))
event.setDamageMultiplier(2.0);
}
@EventHandler
public void onReload(GunReloadEvent event) {
if (isCapturingObjective(event.getPlayer()))
event.setCancelled(true);
}
@EventHandler
public void onHit(GunHitEvent event) {
// 基础伤害、最终伤害、是否爆头标志、距离
plugin.getStats().record(
event.getShooter(), event.getGun().getId(),
event.getFinalDamage(), event.isHeadshot(), event.getDistance());
}
@EventHandler
public void onHeadshot(GunHeadshotEvent event) {
event.getShooter().giveExp(5);
}
API 实例
CombatGunAPI api = CombatGunAPI.getInstance();
// 查询枪械
GunData gun = api.getGun("ak47");
Collection<GunData> all = api.getAllGuns();
// 创建物品
ItemStack gunItem = api.createGunItem("ak47");
ItemStack ammo = api.createAmmoItem("ar_ammo", 30);
// 检查物品
boolean isGun = api.isGun(item);
String gunId = api.getGunId(item);
// 玩家状态
boolean isReloading = api.isReloading(player.getUniqueId());
// 插件挂钩状态
boolean shopEnabled = plugin.getHookManager().getVaultHook().isEnabled();
boolean wgActive = plugin.getHookManager().getWorldGuardHook().isAvailable();
? 安装
- 下载
CombatGunSSS-2.3.0.jar。
- 将其放入服务器的
plugins 文件夹中。
- (可选)安装所需的软依赖插件:PlaceholderAPI, Vault, WorldGuard, Vulcan, Matrix。
- 重启服务器以生成默认配置文件。
- (可选)添加资源包以查看 3D 枪械模型。
要求
- 服务器: Paper/Spigot 1.21+
- Java: 21 或更高版本
- 必需依赖项: 无(独立插件)
- 可选依赖项: PlaceholderAPI, Vault + 经济插件, WorldGuard, Vulcan, Matrix
? 更新日志
请参阅 CHANGELOG.md 查看完整的版本历史。
2.3.0 — 修复关键漏洞及近战战斗问题
- 修复了弹药/组件物品(基于金粒/铁粒等原版材料构建)在没有资源包的情况下仍可被合成或熔炼成真实原版资源的问题 — 关闭了合成台和熔炉熔炼两条路径
- 修复了近战武器(katana, knife, pan 等)不造成伤害且不影响目标的问题 — 击中音效正常播放,但由于事件递归 bug,攻击实际上静默失效
2.2.0 — 权限门控修复版本 + 配方浏览器分类
- 修复了
/gun 命令树对非管理员玩家屏蔽所有面向玩家的子命令(buy, attach, detach, attachments, stats, leaderboard, recipe)的问题 — onCommand() 和 onTabComplete() 均被硬编码限制在 combatgun.admin 权限后
- 修复了
VaultHook.buyGun() 在购买者背包已满时静默丢弃已购买武器的问题
- 在配方浏览器中添加了 Gun / Melee / Ammo 分类标签页,以便玩家更快地找到可制作的物品
2.1.0 — 错误修复版本:修复了 8 个 Bug
- 修复了
StatsManager.flushBuffer() 的竞态条件 — 在高并发负载下击杀数据静默丢失
- 修复了
ThrowableManager 任务未在插件禁用时取消的问题 — 导致每次禁用插件时抛出 IllegalPluginAccessException
- 修复了
clearAds() 错误地移除瞄具减速效果的问题
- 修复了所有
ReloadManager 消息绕过国际化(i18n)的问题(向 vi 语言服务器显示硬编码的英文)
- 修复了
BleedingManager 和 ThrowableManager 使用 Math.random() 而非 ThreadLocalRandom 的问题
- 修复了
AttachmentManager 和 GunListener 中的重复导入语句
- 修复了
getRecentDamage() 暴露可变 Map 引用;添加了安全的 getDamageRecord() 查找方法
2.0.6 — 错误修复版本:修复了 4 个 Bug
- 修复了友军伤害记分板队伍检测使用玩家记分板而非主记分板的问题 — 可能导致友军伤害规避
- 修复了
recentDamage 内存泄漏:条目现在会在玩家退出和死亡事件中移除
- 修复了共享
static Random 的竞争问题:替换为 ThreadLocalRandom.current()(每线程独立,无锁,熵更好)
- 修复了异步 SQLite 连接安全性:
incrementGunKill() 和 getGunKills() 现在与 flushBuffer() 同步
2.0.5 — 开发者 API 与架构发布:新增 4 项功能,优化 1 项
- 新增
AttachmentApplyEvent 和 AttachmentRemoveEvent(可取消)——在 /gun attach 和 /gun detach 时触发
- 新增
DamageCalculator 工具类 —— 集中处理从 GunListener 中提取的所有伤害计算逻辑(爆头、衰减、散布、弹丸)
- 新增
kills_by_gun_detail SQLite 表(v3 结构)—— 记录每次击杀的日志,包含时间戳、武器及是否爆头标记
- 新增命令:
/gun statsreset <player> 和 /gun seasonreset confirm
- 部分重构
GunListener God Class —— 其中 4 个方法委托给 DamageCalculator
2.0.4 — 稳定性与性能发布:修复 2 个错误,优化 3 项
- 修复了
StatsManager 统计缓冲区中的线程安全数据竞争问题(使用 ConcurrentHashMap)
- 修复了无效枪械配置文件的静默加载问题(通过 YAML 验证并提供清晰的逐字段错误提示)
- 使用
kills DESC 索引优化了 StatsManager 排行榜查询(结构迁移至 v2)
- 商店价格现在缓存在内存中;执行
/gun reload 时使缓存失效
- 配置文件版本检测会在更新后
config.yml 过时警告管理员
2.0.3 — 错误修复版本:已修复 7 个错误
- 弹药袋在背包已满时不再丢失物品
- 装填任务的 CPU 占用率降低 50%(从每 1 刻改为每 2 刻间隔)
isHeadshot() 在玩家蹲下时现在能准确工作
craftFromStation() 在合成失败时能正确回退材料
BleedingManager 现在使用墙钟时间,即使在服务器卡顿期间也能确保伤害计算的准确性
applyRecoil() 现已完全支持空指针安全
- 修复了
onItemHeldChange 中的竞态条件
? 故障排除
尽管已禁用友军伤害,仍发生误伤
- 已在 2.0.6 中修复 —— 队伍检测现在使用主计分板,而非每个玩家的个人视角
- 请确保使用
/team add <name> 设置队伍,并使用 /team join <name> <player> 添加玩家
- 在
config.yml 中测试使用 combatgun.team_provider: scoreboard
枪械无法使用 / 无法射击
- 检查是否已向玩家授予
combatgun.use 权限
- 确保该世界未在
config.yml 中被列入黑名单
- 如果使用 WorldGuard,请检查该区域是否设置了
gun-shooting deny
- 尝试执行
/gun give ak47 并在干净区域进行测试
- 请使用 Paper —— Spigot 不受支持
找不到弹药 / 无法装填
- 确保你的物品栏中有正确的弹药类型(例如,突击步枪需要使用 AR 弹药)
- 在原版工作台或机械工作台中制作弹药
- 检查枪械 YAML 文件中的
ammo_type 是否与 config.yml 中定义的弹药类型匹配
- 编辑配置文件后运行
/gun reload
工作台中未显示合成配方
- 运行
/gun reload 重新注册原版配方
- 给自己一本配方指南书:
/gun book
- 确保枪 YAML 中的材料 ID 与
config.yml 中定义的一致
控制台警告:“config.yml is OUTDATED”
- 当你的
config.yml 的 config-version 低于插件期望的版本时,会出现此警告。
- 备份当前的
config.yml,删除它,然后重启服务器以生成一个新的配置文件。
- 接着从备份中手动复制你的自定义设置(世界列表、商店价格、效果等)。
- 即使配置过时,插件也会正常加载——缺失的键将使用默认值。
枪械配置未加载 / “config validation failed” 警告
- 新增于 2.0.4 —— 现在具有无效配置的枪械会记录清晰的逐字段错误,而不是静默加载。
- 检查列出的字段:
damage、fire_rate、magazine_size、reload_time 必须全部大于 0。
burst_count 必须至少为 1。name 不能为空。
- 修复枪械 YAML 中的值,然后运行
/gun reload。
排行榜(`/gun leaderboard`)在大型服务器上较慢
- 已修复于 2.0.4 —— SQLite 数据库现已自动创建
kills DESC 索引。
- 迁移仅在 2.0.4 首次启动时运行一次。如果仍然感到缓慢,请确保服务器已完全重启(而非使用
/reload)。
弹药袋在背包已满时销毁物品
- 已修复于 2.0.3 —— 请更新插件
- 部分取出弹药时,剩余的弹药现在会保存回弹药袋中,而不是被销毁
换弹时间不正确或不一致
- 已修复于 2.0.3 —— 换弹任务现在每 2 刻执行一次,而不是每 1 刻(CPU 占用减少 50%,换弹持续时间不变)
- 如果仍然不正确,请检查枪械 YAML 中的
reload_time(单位为秒)
爆头未能正确判定
- 已修复于 2.0.3 —— 蹲伏状态下的玩家碰撞箱现计算正确
- 爆头检测基于实体碰撞箱顶部 20% 的区域,并根据蹲伏状态进行调整
流血伤害低于配置值
- 已修复于 2.0.3 ——
BleedingManager 现使用墙钟时间而非刻数计数
- 即使在服务器卡顿的情况下,伤害计算也保持准确
插件启动时崩溃
- 已修复于 2.0.1 —— 启动错误现在按管理器隔离
- 检查控制台中带有
[CombatGunSSS] 的错误行,以确定哪个管理器失败
- 常见原因:损坏的
config.yml 或无效的枪械 YAML 语法
- 修复配置后重启服务器(请勿使用
/reload)
射击时出现 NullPointerException
- 已在 2.0.2 中修复 —— 延迟访问 HudManager 可防止启动时出现空指针异常
- 如果存在持久化问题:检查堆栈跟踪中
HookManager 是否为 null,并更新到最新版本
反作弊系统标记后坐力移动
- 确保
Vulcan 或 Matrix 已列在 softdepend 中(通常会自动完成)
- 在
config.yml 中增加 combatgun.anticheat.exempt_ticks 的值(默认值:3)
- 插件会通过反射自动检测并注册豁免权限 —— 无需额外的 API jar 包
PlaceholderAPI 占位符显示为原始文本
- 安装 PlaceholderAPI 并运行
/papi reload
- 确保 CombatGunSSS 在 PlaceholderAPI 之后加载(需重启服务器,而非使用
/reload)
- 使用
/papi parse me %combatgun_gun_name% 进行测试
Vault 商店无法使用
- 确保安装了经济类插件(如 EssentialsX、CMI 等)并与 Vault 配合使用
- 在
config.yml 中设置 combatgun.shop.enabled: true
- 确认枪械 ID 存在于
combatgun.shop.guns 价格列表中
- 使用
/gun buy <id> free(管理员权限)在不检查余额的情况下测试
/reload 导致插件失效
- 请勿使用
/reload —— 始终进行完整的服务器重启
- 使用
/gun reload 热重载枪械配置、语言文件和设置,而无需重启服务器
自定义枪械 YAML 文件未加载
- 将文件放置在
plugins/CombatGunSSS/guns/(远程武器)或 melees/(近战武器)目录下
- 运行
/gun reload —— 检查控制台是否有针对该文件的警告信息
- 确保包含必填字段:
name、category、ammo_type、damage、magazine_size
- YAML 对缩进敏感 —— 建议使用验证工具,如 yaml.org/start.html
❓ 常见问题 (FAQ)
这个插件能在 Spigot 上运行吗?
不能 —— CombatGunSSS 需要 Paper 1.21+。Spigot 缺少插件内部使用的部分 API 功能。
我可以添加自己的枪械吗?
可以。在 plugins/CombatGunSSS/guns/ 目录下创建一个新的 .yml 文件,格式需与内置武器文件保持一致,然后运行 /gun reload。
我可以禁用特定的枪械吗?
只需从 guns/ 文件夹中删除或移除该枪械的 YAML 文件,然后运行 /gun reload。持有该枪械的玩家仍会保留物品,但将无法正常使用其功能。
它支持多世界吗?
支持。您可以在 config.yml 中的 combatgun.worlds 下配置世界白名单或黑名单。
在大服上会造成卡顿吗?
CombatGunSSS 使用的是命中检测(Hitscan,即射线追踪,而非投射物实体),因此比基于投射物的枪械插件要轻量得多。像弹道轨迹这样的高消耗效果可以在 config.yml 的 combatgun.effects 中关闭。
我可以禁用合成系统吗?
可以 —— 只需不给予玩家“机械工作台”或“配方书”即可。请使用 /gun give 进行管理员发放。原版工作台配方也可以针对单个物品进行禁用。
我需要资源包吗?
不需要。该插件无需资源包即可正常运行。不过,每把枪械都预配置了 custom_model_data 数值,如果您有资源包,可以将其链接到 3D 模型上。
我可以禁用流血或弹药袋吗?
可以。在 config.yml 中设置 combatgun.bleeding.enabled: false 或 combatgun.ammo_pouch.enabled: false。
它支持 ZombieApocalypseSSS 吗?
支持 —— CombatGunSSS 是 ZombieApocalypseSSS 推荐的配套枪械插件。所有枪械对各类僵尸均造成全额伤害,并会自动触发噪音和仇恨系统。
其他插件可以监听枪械事件吗?
可以。API 暴露了四个自定义事件:GunShootEvent(可取消)、GunReloadEvent(可取消)、GunHitEvent 和 GunHeadshotEvent。请参阅 开发者 API 章节。
如何不使用商店直接发放枪械?
使用 /gun give <id> [player](需要 combatgun.admin 权限)。例如:/gun give awm Steve。
由 Duong2012G ❤️ 开发。
[!NOTE]
本插件基于 Paper/Spigot 1.21 API 构建,需要 Java 21 或更高版本。
[!TIP]
如需支持与更新,请查看仓库或联系开发者。
? CombatGunSSS
CombatGunSSS is a high-performance, feature-rich Minecraft gun plugin designed for modern servers (1.21+). It brings a tactical, realistic combat experience with 46 uniquely configured weapons (40 firearms + 6 melee), advanced crafting mechanics, optimized hitscan technology, a full custom events API, and a growing ecosystem of plugin integrations.
? Key Features
- ? Tactical Combat: Realistic hitscan mechanics with accurate recoil, bullet spread, and headshot multipliers.
- ⚔️ Melee System: Left-click melee combat with range check, knockback, and separate cooldown system.
- ?️ Advanced Penetration: Projectiles can pass through "soft" blocks and multiple entities based on individual gun stats.
- ? Progressive Damage: Distance-based Damage Falloff and configurable Knockback intensities.
- ?️ Two-Tier Crafting System:
- Vanilla Workbench: Craft basic components with official Recipe Book support.
- Mechanical Crafting Table: A custom 21-slot industrial GUI for assembling advanced firearms.
- ? Interactive Recipe Browser: Built-in visual guide inside the Mechanical Crafting Table — no commands needed! Browse by Gun, Melee, or Ammo category tabs to quickly find what you want to craft.
- ? 46 Built-in Weapons: 40 ranged guns + 6 melee weapons with burst-fire, shotgun pellets, and melee logic.
- ? Durability System: Weapons can have limited usage and require repairs (fully configurable).
- ? Persistent HUD: Real-time action bar showing gun name (rarity-colored), visual ammo bar, current/max ammo, and reserve count.
- ? Auto-Reload: Automatically reloads after firing the last round (toggleable).
- ?️ WorldGuard Integration: Block gun use inside protected regions with a custom
gun-shooting flag.
- ? Vault Shop: Players purchase weapons via
/gun buy <id> using server economy.
- ? PlaceholderAPI: 8 real-time placeholders for scoreboards, HUDs, and TAB plugins.
- ? ADS (Aim Down Sights): Per-gun aim-down-sights system. Shift+Right-click to toggle — reduces spread and applies movement penalty.
- ? Bleeding: Optional damage-over-time on bullet hit. Cured by holding a bandage and pressing
[F].
- ? Ammo Pouch: Compressed ammo bag. Shift+Right-click to unpack into inventory. Give via
/gun givepouch.
- ? Multi-Language (i18n): All messages live in
lang/en.yml or lang/vi.yml. Add your own translation file.
- ?️ Anti-Cheat: Automatic exemptions for Vulcan and Matrix to prevent recoil false-positives.
- ? Developer API: Full custom events —
GunShootEvent, GunReloadEvent, GunHitEvent, GunHeadshotEvent.
- ? Friendly Fire Control: Toggle friendly fire on/off with scoreboard team or permission-group detection.
- ? Toggleable Effects: Every particle and sound effect can be individually enabled/disabled. Includes a master
sound_volume control.
- ? Custom Kill Messages: Death messages show killer name, weapon name (colored by rarity), and headshot indicator.
? Player Controls
| Action |
Control |
| Shoot |
Right Click |
| Reload |
Swap Hand Key [F] |
| Melee Attack |
Left Click |
| Buy a weapon |
/gun buy <id> |
| Crafting |
Right Click on Mechanical Crafting Table |
? Weapon Categories
Ranged Weapons (39)
- Assault Rifles: AK47, M4A1, SCAR, AUG, FAMAS, G36, Groza, AN94, M14, ParaFAL, XM8, Kingfisher
- SMGs: MP5, P90, Vector, Bizon, UMP, Thompson, MAC-10, MP40, VSS, CG15
- Snipers: AWM, M24, Kar98k, M82B, M107, VSK94
- Shotguns: M1014, SPAS-12, MAG-7, M1887, M590, Trogon
- Pistols: Desert Eagle, G18, USP, M1917, M1873, M500
Melee Weapons (6)
- Bat: Common, fast swing
- Knife: Common, highest attack speed
- Pan: Rare, defensive knockback
- Parang: Rare, balanced damage/speed
- Katana: Epic, high damage
- Scythe: Legendary, maximum damage
? Technical Weapon Stats
Every weapon in CombatGunSSS features a deep set of configurable properties:
- Damage Falloff: Define exactly at what block distance damage begins to drop (
damage_falloff_start) and the minimum damage floor (min_damage_multiplier).
- Recoil & Spread: Independent Pitch (vertical) and Yaw (horizontal) kick per shot, plus Movement Spread penalties while moving or jumping.
- Burst Fire: Configure weapons to fire multiple rounds per trigger pull (
burst_count) with custom delays.
- Shotgun Logic: Support for multiple projectiles per shot (
projectiles_per_shot) with per-pellet damage calculation.
- Durability: Set a maximum usage limit (
max_durability). Weapons will break and become unusable until repaired.
- Penetration: Define how many blocks (
block_penetration) or entities (entity_penetration) a single bullet can pass through.
- Melee Range: Maximum attack distance for melee weapons (default: 4 blocks).
- Knockback: Push strength for both ranged and melee weapons.
? Folder Structure
plugins/CombatGunSSS/
├── config.yml # Main configuration
├── guns/ # Ranged weapon configs (40 built-in + custom)
│ ├── ak47.yml
│ ├── m4a1.yml
│ └── ...
├── melees/ # Melee weapon configs (6 built-in + custom)
│ ├── katana.yml
│ ├── knife.yml
│ └── ...
└── README.md
Custom Weapons: Create your own YAML files in guns/ or melees/ folders and run /gun reload.
⚒️ Crafting Mechanics
1. Components (The Basics)
Craft raw materials like Steel Ingots, Gun Barrels, and Springs at a standard Crafting Table. These recipes are automatically unlocked in your Vanilla Recipe Book.
2. Assembly (The Advanced)
Place your components into the Mechanical Crafting Table.
- Non-grid-based: Just throw the ingredients into the 21-slot input area.
- Visual Preview: The output slot shows your gun stats before you build it.
- Recipe Guide: Click the Glowing Book icon in the station to browse all weapon requirements.
? Action Bar HUD
While holding any ranged weapon, CombatGunSSS displays a persistent HUD on your action bar:
? AK47 ▐████████████░░░░▌ 22 / 30 • 90
- Gun name is colored by rarity: white (common) → aqua (rare) → light purple (epic) → gold (legendary).
- Visual bar transitions green → gold (≤25%) → red (≤10%) as ammo depletes.
- Reserve count turns red when you have no backup ammo left.
- The HUD automatically yields to the reload progress bar during active reloads.
combatgun:
hud:
enabled: true
update_interval_ticks: 5
? ADS — Aim Down Sights
Enable ADS per gun in its YAML config:
ads:
enabled: true
spread_multiplier: 0.35 # 65% tighter accuracy while ADS
movement_penalty: 0.6 # movement speed while ADS active
Control: Shift+Right-click to toggle ADS on/off. Action bar shows ? ADS [spread ×0.35].
ADS exits automatically when you switch items, teleport, or die. Scopeable sniper rifles use the traditional sneak-to-scope mechanic instead of ADS.
? Bleeding
An optional damage-over-time system. When enabled, bullets hitting players have a configurable chance to cause bleeding.
combatgun:
bleeding:
enabled: true
chance: 0.15
damage_per_second: 1.0
duration_seconds: 10
cure_item: bandage
Hold a bandage (crafting component) and press [F] to cure. Bleeding stops automatically on death.
? Ammo Pouch
A compressed ammo container that stores hundreds of rounds in a single slot.
/gun givepouch ar_ammo 300 PlayerName
Shift+Right-click to unpack all rounds into your inventory. Surplus rounds are left if the inventory is full.
? Multi-Language
Set the active language in config.yml:
combatgun:
language: vi # en | vi | (any lang/xx.yml)
Bundled: English (en) and Tiếng Việt (vi). Add a custom translation by placing lang/xx.yml in the plugin data folder and running /gun reload.
? Plugin Integrations
PlaceholderAPI
8 real-time placeholders for use in scoreboards, TAB, AdvancedHud, and similar plugins:
| Placeholder |
Example |
Description |
%combatgun_gun_name% |
AK47 |
Display name of held gun |
%combatgun_gun_id% |
ak47 |
Internal ID of held gun |
%combatgun_gun_rarity% |
epic |
Rarity of held gun |
%combatgun_ammo% |
24 |
Current magazine ammo |
%combatgun_ammo_max% |
30 |
Magazine capacity |
%combatgun_ammo_reserve% |
90 |
Reserve ammo in inventory |
%combatgun_is_reloading% |
true |
Whether player is reloading |
%combatgun_is_gun% |
true |
Whether held item is a gun |
Vault Shop
Enable the shop in config.yml, set prices per gun, then players can buy weapons in-game:
combatgun:
shop:
enabled: true
currency_symbol: "$"
guns:
ak47: 700.0
awm: 2500.0
knife: 100.0
/gun buy ak47 # purchase for configured price
/gun buy ak47 free # admin free-give (requires combatgun.admin)
WorldGuard
The custom flag gun-shooting is automatically registered when WorldGuard is present:
/rg flag <region> gun-shooting deny # block all guns in region
/rg flag <region> gun-shooting allow # explicitly allow
/rg flag <region> gun-shooting -g # remove flag (inherit parent)
Falls back to WorldGuard's built-in PVP flag if gun-shooting is not set on a region.
Anti-Cheat (Vulcan / Matrix)
Auto-detected. When present, players are exempted from motion checks for anticheat.exempt_ticks ticks after each shot to prevent recoil from triggering false positives.
combatgun:
anticheat:
exempt_ticks: 3
? Commands & Permissions
| Command |
Description |
Permission |
/gun statsreset <player> |
Reset a specific player's stats |
combatgun.admin |
/gun seasonreset confirm |
Wipe ALL player stats (season reset) |
combatgun.admin |
/gun give <id> [player] |
Give a specific weapon |
combatgun.admin |
/gun giveammo <id> [amt] [player] |
Give custom ammunition |
combatgun.admin |
/gun givepart <id> [amt] [player] |
Give crafting components |
combatgun.admin |
/gun station [player] |
Give the Mechanical Crafting Table |
combatgun.admin |
/gun book [player] |
Give the Recipe Guide Book |
combatgun.admin |
/gun recipe <id> |
Show the full crafting chain in chat |
combatgun.admin |
/gun list [category] |
View all loaded weapons |
combatgun.admin |
/gun inspect [player] |
View deep stats of the held weapon |
combatgun.admin |
/gun reload |
Reload all configurations |
combatgun.admin |
/gun buy <id> |
Purchase a weapon (requires Vault) |
combatgun.use |
/gun givepouch <ammo_id> <amount> [player] |
Give an ammo pouch |
combatgun.admin |
Player Permissions
combatgun.use — Allows shooting and using guns (default: true)
combatgun.use.<gun_id> — Per-gun permission node (e.g. combatgun.use.awm)
? Configuration Examples
Ranged Weapon (AK47)
name: AK47
category: assault_rifles
ammo_type: ar_ammo
damage: 12
fire_rate: 10.0
magazine_size: 30
reload_time: 2.6
headshot_multiplier: 1.8
damage_falloff_start: 35.0
min_damage_multiplier: 0.5
range: 72.0
block_penetration: 0.8
entity_penetration: 0
recoil:
pitch: 1.45
yaw: 0.42
spread: 0.24
recovery: 0.80
rarity: rare
custom_model_data: 1001
sound: ENTITY_FIREWORK_ROCKET_BLAST
recipe:
station: mechanical_crafting_table
ingredients:
steel_ingot: 6
gun_barrel: 1
spring: 2
hardwood: 3
Melee Weapon (Katana)
name: Katana
category: melee
ammo_type: none
rarity: epic
damage: 10
fire_rate: 1.35
range: 4.0
knockback: 0.3
sound: ENTITY_PLAYER_ATTACK_CRIT
custom_model_data: 26002
recipe:
station: mechanical_crafting_table
ingredients:
steel_ingot: 10
carbon_fiber: 2
leather_strip: 3
blade_core: 1
? Developer API
Custom Events
| Event |
Cancellable |
When it fires |
GunShootEvent |
✅ |
Before each shot — cancel or set damage multiplier |
GunReloadEvent |
✅ |
When a player starts reloading |
GunHitEvent |
❌ |
After damage is applied — full damage pipeline |
GunHeadshotEvent |
❌ |
When a shot lands in the head zone |
AttachmentApplyEvent |
✅ |
Before an attachment is fitted to a gun |
AttachmentRemoveEvent |
✅ |
Before an attachment is removed from a gun |
@EventHandler
public void onShoot(GunShootEvent event) {
if (isInsideArena(event.getShooter()))
event.setDamageMultiplier(2.0);
}
@EventHandler
public void onReload(GunReloadEvent event) {
if (isCapturingObjective(event.getPlayer()))
event.setCancelled(true);
}
@EventHandler
public void onHit(GunHitEvent event) {
// base damage, final damage, headshot flag, distance
plugin.getStats().record(
event.getShooter(), event.getGun().getId(),
event.getFinalDamage(), event.isHeadshot(), event.getDistance());
}
@EventHandler
public void onHeadshot(GunHeadshotEvent event) {
event.getShooter().giveExp(5);
}
API Instance
CombatGunAPI api = CombatGunAPI.getInstance();
// Query guns
GunData gun = api.getGun("ak47");
Collection<GunData> all = api.getAllGuns();
// Create items
ItemStack gunItem = api.createGunItem("ak47");
ItemStack ammo = api.createAmmoItem("ar_ammo", 30);
// Check items
boolean isGun = api.isGun(item);
String gunId = api.getGunId(item);
// Player state
boolean isReloading = api.isReloading(player.getUniqueId());
// Hook state
boolean shopEnabled = plugin.getHookManager().getVaultHook().isEnabled();
boolean wgActive = plugin.getHookManager().getWorldGuardHook().isAvailable();
? Installation
- Download the
CombatGunSSS-2.3.0.jar.
- Drop it into your server's
plugins folder.
- (Optional) Install any soft-depend plugins you want: PlaceholderAPI, Vault, WorldGuard, Vulcan, Matrix.
- Restart the server to generate default configurations.
- (Optional) Add a Resource Pack to see 3D gun models.
Requirements
- Server: Paper/Spigot 1.21+
- Java: 21 or higher
- Required dependencies: None (standalone plugin)
- Optional dependencies: PlaceholderAPI, Vault + economy plugin, WorldGuard, Vulcan, Matrix
? Changelog
See CHANGELOG.md for the full version history.
2.3.0 — Critical exploit + melee combat fix
- Fixed ammo/component items (built on vanilla materials like gold/iron nuggets) being craftable or smeltable into real vanilla resources without a resource pack — closed both the crafting-grid and furnace-smelting paths
- Fixed melee weapons (katana, knife, pan, etc.) dealing no damage and not affecting the target at all — hit sound played but the attack silently did nothing due to an event-recursion bug
2.2.0 — Permission-gate fix release + Recipe Browser categories
- Fixed
/gun command tree blocking every player-facing subcommand (buy, attach, detach, attachments, stats, leaderboard, recipe) for non-admins — both onCommand() and onTabComplete() were hard-gated behind combatgun.admin
- Fixed
VaultHook.buyGun() silently discarding a purchased weapon when the buyer's inventory was full
- Added Gun / Melee / Ammo category tabs to the Recipe Browser so players can find craftable items faster
2.1.0 — Bug-fix release: 8 bugs fixed
- Fixed
StatsManager.flushBuffer() race condition — kill data silently lost under concurrent load
- Fixed
ThrowableManager tasks not cancelled on plugin disable — IllegalPluginAccessException on every disable
- Fixed
clearAds() removing scope slowness incorrectly
- Fixed all
ReloadManager messages bypassing i18n (hardcoded English shown to vi servers)
- Fixed
BleedingManager and ThrowableManager using Math.random() instead of ThreadLocalRandom
- Fixed
AttachmentManager and GunListener duplicate import statements
- Fixed
getRecentDamage() exposing mutable map reference; added safe getDamageRecord() lookup
2.0.6 — Bug-fix release: 4 bugs fixed
- Fixed friendly-fire scoreboard team detection using player scoreboard instead of main scoreboard — could allow friendly-fire bypass
- Fixed
recentDamage memory leak: entries now removed on player quit and death events
- Fixed shared
static Random contention: replaced with ThreadLocalRandom.current() (per-thread, no lock, better entropy)
- Fixed async SQLite connection safety:
incrementGunKill() and getGunKills() now synchronized alongside flushBuffer()
2.0.5 — Developer API & architecture release: 4 new additions, 1 improvement
- New
AttachmentApplyEvent and AttachmentRemoveEvent (cancellable) — fired on /gun attach and /gun detach
- New
DamageCalculator utility class — centralises all damage math extracted from GunListener (headshots, falloff, spread, pellets)
- New
kills_by_gun_detail SQLite table (schema v3) — per-kill log with timestamp, weapon, headshot flag
- New commands:
/gun statsreset <player> and /gun seasonreset confirm
GunListener God Class partially refactored — 4 methods delegate to DamageCalculator
2.0.4 — Stability & performance release: 2 bug-fixes, 3 improvements
- Fixed thread-safety data race in
StatsManager stat buffer (ConcurrentHashMap)
- Fixed silent loading of invalid gun configs (YAML validation with clear per-field errors)
StatsManager leaderboard query optimized with a kills DESC index (schema migration v2)
- Shop price reads now cached in memory; invalidated on
/gun reload
- Config version detection warns admins when
config.yml is outdated after an update
2.0.3 — Bug-fix release: 7 bugs fixed
- Ammo Pouch no longer loses items when the inventory is full
- Reload task CPU usage reduced by 50% (changed from 1 tick to 2 tick interval)
isHeadshot() now works accurately when the player is crouching
craftFromStation() properly rolls back ingredients if crafting fails
BleedingManager now uses wall-clock time for accurate damage even during server lag
applyRecoil() is now fully null-safe
- Fixed race condition in
onItemHeldChange
? Troubleshooting
Friendly fire still occurring despite being disabled
- Fixed in 2.0.6 — team detection now uses the main scoreboard instead of each player's personal view
- Ensure teams are set up with
/team add <name> and players added with /team join <name> <player>
- Test with
combatgun.team_provider: scoreboard in config.yml
Guns not working / can't shoot
- Check
combatgun.use permission is granted to players
- Make sure the world is not blacklisted in
config.yml
- If using WorldGuard, check if the region has
gun-shooting deny
- Try
/gun give ak47 and test in a clean area
- Use Paper — Spigot is not supported
Ammo not found / can't reload
- Make sure you have the correct ammo type in your inventory (e.g. AR ammo for assault rifles)
- Craft ammo at a Vanilla Crafting Table or Mechanical Crafting Table
- Check
ammo_type in the gun's YAML matches a defined ammo type in config.yml
- Run
/gun reload after editing configs
Recipes not showing in crafting table
- Run
/gun reload to re-register vanilla recipes
- Give yourself the Recipe Guide Book:
/gun book
- Ensure the ingredient IDs in the gun YAML match those defined in
config.yml
Console warning: "config.yml is OUTDATED"
- This warning appears when your
config.yml has a lower config-version than the plugin expects.
- Back up your current
config.yml, delete it, and restart the server to regenerate a fresh one.
- Then manually copy over your custom settings (world lists, shop prices, effects, etc.) from the backup.
- The plugin loads normally even with an outdated config — default values are used for missing keys.
Gun config not loading / "config validation failed" warning
- Added in 2.0.4 — guns with invalid configs now log a clear per-field error instead of loading silently.
- Check the listed fields:
damage, fire_rate, magazine_size, reload_time must all be greater than 0.
burst_count must be at least 1. name cannot be blank.
- Fix the values in the gun's YAML and run
/gun reload.
Leaderboard (`/gun leaderboard`) is slow on large servers
- Fixed in 2.0.4 — a
kills DESC index is now created automatically on the SQLite database.
- The migration runs once on first startup of 2.0.4. If you still experience slowness, ensure the server was fully restarted (not
/reload).
Ammo Pouch destroying items when inventory is full
- Fixed in 2.0.3 — update the plugin
- Partial unpacks now save remaining ammo back into the pouch instead of destroying it
Reload taking wrong amount of time / inconsistent
- Fixed in 2.0.3 — reload task now runs every 2 ticks instead of 1 (50% less CPU, same reload duration)
- If still wrong, check
reload_time in the gun's YAML (in seconds)
Headshots not registering correctly
- Fixed in 2.0.3 — crouching player hitbox now calculated correctly
- Headshot detection uses the top 20% of the entity hitbox, adjusted for crouch state
Bleeding damage lower than configured
- Fixed in 2.0.3 —
BleedingManager now uses wall-clock time instead of tick counting
- Damage is now accurate even under server lag
Plugin crashes on startup
- Fixed in 2.0.1 — startup errors are now isolated per manager
- Check console for
[CombatGunSSS] error lines indicating which manager failed
- Common cause: corrupted
config.yml or invalid gun YAML syntax
- Fix the config, then restart (do not use
/reload)
NullPointerException when shooting
- Fixed in 2.0.2 — lazy HudManager access prevents NPE at startup
- If persisting: check that
HookManager is not null in the stack trace and update to latest version
Anti-cheat flagging recoil movement
- Ensure Vulcan or Matrix is listed in
softdepend (already done automatically)
- Increase
combatgun.anticheat.exempt_ticks in config.yml (default: 3)
- The plugin auto-detects and registers exemptions via reflection — no API jar needed
PlaceholderAPI placeholders showing as raw text
- Install PlaceholderAPI and run
/papi reload
- Ensure PlaceholderAPI is loaded before CombatGunSSS (restart, not
/reload)
- Test with
/papi parse me %combatgun_gun_name%
Vault shop not working
- Make sure an economy plugin (EssentialsX, CMI, etc.) is installed alongside Vault
- Set
combatgun.shop.enabled: true in config.yml
- Confirm the gun ID exists in
combatgun.shop.guns price list
- Use
/gun buy <id> free (admin) to test without balance requirement
/reload breaks the plugin
- Never use
/reload — always do a full server restart
- Use
/gun reload to hot-reload gun configs, language files, and settings without restarting
Custom gun YAML not loading
- Place the file inside
plugins/CombatGunSSS/guns/ (ranged) or melees/ (melee)
- Run
/gun reload — check console for warnings about your file
- Ensure required fields are present:
name, category, ammo_type, damage, magazine_size
- YAML is whitespace-sensitive — use a validator like yaml.org/start.html
❓ FAQ
Does this work on Spigot?
No — CombatGunSSS requires Paper 1.21+. Spigot lacks several API features used internally.
Can I add my own guns?
Yes. Create a new .yml file in plugins/CombatGunSSS/guns/ following the same format as the built-in weapon files, then run /gun reload.
Can I disable specific guns?
Simply delete or remove the gun's YAML file from the guns/ folder and run /gun reload. Players holding that gun will keep the item but it won't function.
Does it support multiple worlds?
Yes. Configure a world whitelist or blacklist under combatgun.worlds in config.yml.
Is it laggy on large servers?
CombatGunSSS uses hitscan (ray-trace, not projectile entities), so it is significantly lighter than projectile-based gun plugins. Heavy effects like bullet trails can be toggled off in config.yml under combatgun.effects.
Can I disable the crafting system?
Yes — simply don't give players the Mechanical Crafting Table or Recipe Book. Use /gun give for admin distribution. Vanilla workbench recipes can also be disabled per-item.
Do I need a Resource Pack?
No. The plugin works without a resource pack. However, each gun has a custom_model_data value pre-configured for you to link 3D models if you have a pack.
Can I disable bleeding or the Ammo Pouch?
Yes. Set combatgun.bleeding.enabled: false or combatgun.ammo_pouch.enabled: false in config.yml.
Does it support ZombieApocalypseSSS?
Yes — CombatGunSSS is the recommended gun companion for ZombieApocalypseSSS. Guns deal full damage to all zombie types and trigger the noise / aggro system automatically.
Can other plugins listen to gun events?
Yes. Four custom events are exposed via the API: GunShootEvent (cancellable), GunReloadEvent (cancellable), GunHitEvent, and GunHeadshotEvent. See the Developer API section.
How do I give guns without the shop?
Use /gun give <id> [player] (requires combatgun.admin). Example: /gun give awm Steve.
Developed with ❤️ by Duong2012G.
[!NOTE]
This plugin is built on the Paper/Spigot 1.21 API and requires Java 21 or higher.
[!TIP]
For support and updates, check the repository or contact the developer.
评论 0
登录后参与评分
还没有评论,来抢沙发吧