CombatGunSSS

插件

· 作者 Duong2012G

为《Minecraft》添加了 45 种独特的枪械,每种武器都拥有自定义的伤害、后坐力、射速和装填机制,通过平衡的游戏玩法、多种武器类型以及针对不同游戏风格的灵活自定义来增强战斗体验。

0 本站下载 0 关注 更新于 3 个月前

最新 2.3.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

? 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();

? 安装

  1. 下载 CombatGunSSS-2.3.0.jar。
  2. 将其放入服务器的 plugins 文件夹中。
  3. (可选)安装所需的软依赖插件:PlaceholderAPI, Vault, WorldGuard, Vulcan, Matrix。
  4. 重启服务器以生成默认配置文件。
  5. (可选)添加资源包以查看 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] 如需支持与更新,请查看仓库或联系开发者。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源