原创 - 游戏模式 - 盲期-末日枪械 | MineBBS 我的世界中文论坛

版权类型: 原创

插件中文名称: 末日枪械

插件英文名称: WarZGun

原帖地址: #

支持的核心（服务端）

Spigot
Paper

语言支持: 中文（简体）

前置组件: MrCore

适配版本（Java）

1.21
1.20
1.19
1.18
1.17
1.16
1.15
1.14
1.13
1.12

一、插件简介

WarZGun 核心定位是硬核枪战+RPG养成结合的复合型枪械插件，并非单纯的射击工具，而是完整还原了末日生存类游戏的枪械养成逻辑，从基础伤害、穿甲对抗，到配件强化、破损修复、特技触发、环境影响，全流程可自定义，服主能自由平衡服务器数值，玩家能体验深度装备养成乐趣。

核心特性一览

专属AP3穿甲系统：区别于普通伤害计算，引入独立穿甲属性，伤害结算同时考虑目标防御力与枪械穿甲率，打破传统“高防无敌”的局面，实现攻防策略对抗。
完整配件养成线：支持配件安装、强化升级、破损、修复全流程，强化有成功率与失败惩罚，还原真实装备养成质感，高等级配件还可触发套装增益。
多样化场景特技：内置多款适配不同场景的武器特技，涵盖血量触发、环境触发、防御削弱、耐久优化等类型，丰富战斗策略，适配PVP与PVE双场景。
实时环境互动：天气（雨天、雪天）、生物群系直接影响武器伤害与性能，特定特技仅在对应环境下触发，让战斗不再局限于单纯数值比拼。
极致自定义自由度：全插件数值、物品ID、特效、成功率、材料均可通过配置文件修改，无强制固定数值，完美适配不同服务器的平衡需求。
流畅战斗手感：还原真实枪械后座力、弹道扩散、射速控制，支持弹道粒子显示，兼顾手感与视觉效果，适配各类玩家操作习惯。

二、安装与依赖

WarZGun 依赖核心前置插件实现功能，安装前需确保服务器环境匹配，避免功能异常或崩溃，支持主流Spigot、Paper、Purpur等服务端，兼容1.16.5及以上高版本Minecraft。

依赖插件区分（必装/推荐）

必须依赖（缺一不可）

MrCore：插件核心前置，负责基础功能加载、环境判断、数据存储、粒子特效调用等核心逻辑，需安装对应版本的MrCore，建议使用最新稳定版。

软依赖（推荐安装，拓展功能）

AttributePlus：属性拓展插件，支持玩家AP3攻击力、防御力与自身属性叠加，实现角色属性与枪械属性联动，强化RPG养成深度。
PlaceholderAPI：变量占位符插件，支持在计分板、聊天栏、GUI中显示枪械耐久、穿甲率、配件等级等实时数据，提升玩家体验。
MythicMobs：自定义怪物/物品插件，支持将MM自定义物品作为强化、修复材料，适配服务器自定义物品体系，避免依赖原版物品。

标准安装步骤

关闭服务器，先安装必装依赖MrCore，放入plugins文件夹，推荐提前安装软依赖插件；
将 WarZGun-1.0.0.jar 插件文件放入服务器 plugins 目录；
启动服务器，等待插件自动生成配置文件夹，路径为plugins/WarZGun/；
检查控制台无报错后，即可进行配置修改，修改后需执行重载命令生效。

安装注意：请勿随意删除自动生成的配置文件夹与子文件，否则会导致插件功能失效；低版本服务端或前置插件版本不匹配，会出现枪械无法使用、配置不加载问题。

三、命令与权限

插件主命令别名为/gun 或 /wg，两类命令均可使用，管理员命令需对应权限，玩家基础命令默认开放，无需额外授权。

完整命令对照表

[TABLE=ne-table]
[TR]
[td]命令格式[/td]
[td]功能描述[/td]
[td]适用对象[/td]
[td]对应权限节点[/td]
[/TR]
[TR]
[td][SIZE=16px]/gun give [玩家ID] <枪械ID>[/SIZE][/td]
[td]给予指定玩家指定ID的枪械，支持在线玩家直接发放[/td]
[td]管理员[/td]
[td]warzgun.admin[/td]
[/TR]
[TR]
[td][SIZE=16px]/gun giveatt [玩家ID] <配件ID>[/SIZE][/td]
[td]给予指定玩家指定ID的配件，适配所有配件类型[/td]
[td]管理员[/td]
[td]warzgun.admin[/td]
[/TR]
[TR]
[td][SIZE=16px]/gun list[/SIZE][/td]
[td]控制台/聊天栏列出所有已注册的枪械ID、配件ID，方便配置核对[/td]
[td]管理员[/td]
[td]warzgun.admin[/td]
[/TR]
[TR]
[td][SIZE=16px]/gun reload[/SIZE][/td]
[td]重载插件全部配置文件，修改配置后无需重启服务器，直接生效[/td]
[td]管理员[/td]
[td]warzgun.admin[/td]
[/TR]
[TR]
[td][SIZE=16px]/gun repair[/SIZE][/td]
[td]打开枪械专属修复GUI界面，消耗材料修复枪械耐久[/td]
[td]全玩家[/td]
[td]warzgun.use（默认开放）[/td]
[/TR]
[TR]
[td][SIZE=16px]/gun repairatt[/SIZE][/td]
[td]打开配件专属修复GUI界面，修复破损、低耐久配件[/td]
[td]全玩家[/td]
[td]warzgun.use（默认开放）[/td]
[/TR]
[TR]
[td][SIZE=16px]/gun enhance[/SIZE][/td]
[td]打开配件强化GUI界面，消耗材料提升配件等级[/td]
[td]全玩家[/td]
[td]warzgun.use（默认开放）[/td]
[/TR]
[/TABLE]

权限节点详解

warzgun.admin：管理员最高权限，默认OP玩家自动拥有，包含所有发放、重载、管理命令，禁止赋予普通玩家；
warzgun.use：玩家基础使用权限，默认所有玩家拥有，包含枪械射击、配件安装、强化修复、GUI打开等基础操作，无需额外配置；
自定义权限限制：可通过权限管理插件（如LuckPerms）回收玩家权限，实现付费枪械、限定配件等特殊玩法。

四、核心游戏机制

WarZGun 的核心玩法围绕四大机制展开，所有机制均支持配置微调，服主可根据服务器节奏修改数值，实现个性化平衡。

1. AP3穿甲伤害计算（核心机制）

插件采用独立的AP3伤害结算公式，摒弃传统直接减伤逻辑，兼顾攻击力、防御力、穿甲率三大核心属性，战斗更具策略性，完整计算流程：

基础攻击值结算：枪械固定基础伤害 + 可选玩家AP3攻击力（config.yml中开启叠加）；
穿甲减伤结算：目标总AP3防御力 ×（1 - 最终穿甲率），穿甲率=枪械基础穿甲+配件加成+强化等级加成；
多重修正乘区：基础伤害扣除穿甲减伤后，再叠加各类修正倍率，最终得出实际伤害；
特技修正：浴血、毁伤等触发后的伤害倍率；
环境修正：雨天、雪天对应特技的伤害加成/衰减；
距离修正：超出枪械最大射程后，伤害逐步衰减，避免远距离无脑射击；
部位修正：爆头默认1.5倍伤害，腿部0.8倍伤害，可自定义倍率；
暴击修正：触发暴击后，按配置暴击倍率额外增伤。

2. 配件养成系统

配件是提升枪械性能的核心途径，每把枪械有固定槽位限制，无法跨槽位安装，养成全程有损耗与风险，还原真实养成体验。

配件槽位类型

MAGAZINE（弹夹）：核心提升枪械载弹量，减少换弹频率，适配持续输出场景；
STOCK（枪托）：大幅降低垂直+水平后座力，提升射击稳定性，适合连续射击；
MUZZLE（枪口）：降低后座、提升有效射程、减少枪口火焰，兼顾性能与隐蔽性；
AP3_CHIP（穿甲芯片）：专属提升AP3穿甲率，针对高防御目标必备配件；
SCOPE（瞄具）：辅助瞄准优化，部分配置可提升射程或暴击率，视自定义属性而定。

强化与破损机制

强化升级：玩家消耗配置好的材料，提升配件等级，每级提升固定属性加成，等级越高加成越高，强化成功率可自定义，高等级强化有失败概率；
破损机制：强化失败、枪械过度损耗会导致配件破损，破损配件完全失效，不提供任何属性加成；
修复机制：通过修复GUI消耗对应材料，修复破损配件或恢复配件耐久，修复材料支持原版与MM物品双兼容；
套装效果：单把枪械安装多个同品质、高等级配件时，自动触发套装增益，如额外穿甲率、伤害加成，可在配置中自定义套装条件。

3. 特技触发系统

特技分为枪械固定特技与配件附加特技，满足条件即可自动触发，无额外操作，全程有粒子或文字提示，内置核心特技一览：

浴血 (Blood Rage)：玩家血量低于配置阈值（默认30%）时触发，大幅提升伤害倍率，残血反杀核心特技；
毁伤 (Armor Break)：命中目标后，短暂降低目标AP3防御力，持续数秒，适合团队集火或单挑破防；
精制 (Refined)：降低枪械射击耐久消耗，延长枪械使用寿命，减少修复频率，适合长期作战；
典藏 (Classic)：手持对应枪械时，小幅提升移动速度，兼顾机动性与输出；
雨战 (Rain Combat)：雨天环境下，伤害直接提升，适配户外雨天PVP/PVE；
雪地 (Snow Battle)：雪天或雪地生物群系内，伤害提升，适配雪地主题生存场景。

4. 后座力与弹道机制

后座力：分为垂直后座（视角上扬）和水平后座（左右抖动），连续射击后座力会累积，停止射击后快速自动回落，不同枪械后座力数值不同，步枪、冲锋枪、狙击枪差异化明显；
弹道系统：支持子弹轨迹粒子效果（可配置开关），弹道会随后座力轻微扩散，点射稳定性远高于连射，逼迫玩家把控射击节奏；
射速控制：每把枪械有固定射击冷却tick，冷却期间无法射击，平衡枪械输出效率，避免无脑扫射。

五、详细配置指南

插件配置文件全部存放在 plugins/WarZGun/ 目录，分为全局配置、枪械独立配置、配件独立配置三大类，支持YAML语法，修改后执行/gun reload即可生效，无需重启服务器。

1. 全局配置（config.yml）

控制插件全局开关、基础数值、特技参数、特效显示等核心设置，关键配置项说明：

代码：

global:
  prevent_drop: true        # 禁止玩家自然丢弃枪械，防止恶意丢枪卡bug
  actionbar_refresh_ticks: 10 # 动作栏实时数据刷新间隔，数值越小越流畅
  show_bullet_tracer: true  # 是否开启子弹弹道粒子效果
  use_ap3_attack: false     # 是否叠加玩家自身AP3攻击力，开启后强化RPG属性
  durability_loss: 0.02     # 每次射击耐久损耗比例，数值越大损耗越快

traits:
  # 浴血特技配置
  blood_rage:
    hp_threshold_percent: 0.30 # 触发血线，0.30代表30%血量
    damage_multiplier: 1.25    # 伤害加成倍率，1.25代表25%增伤
  # 其余特技配置格式一致，可自行修改数值
  rain_combat:
    damage_multiplier: 1.20
  snow_battle:
    damage_multiplier: 1.20

2. 枪械配置（guns/文件夹下）

每把枪械对应一个独立YAML文件，文件名即为枪械ID，可自由复制新增枪械，核心配置项示例：

代码：

AK47:  # 枪械ID，命令发放时使用
  display_name: "§6AK-47 突击步枪" # 枪械显示名称，支持颜色代码
  type: RIFLE  # 枪械类型，区分步枪、狙击枪、冲锋枪
  lore:
    - "§7明日之后风格经典突击步枪"
    - "§7基础穿甲30%，适配中近距离作战"
  stats:
    base_damage: 85.0       # 基础伤害值
    base_penetration: 0.30  # 基础穿甲率，0.30代表30%
    crit_chance: 0.08       # 暴击率，0.08代表8%
    shoot_cooldown_ticks: 4 # 射击冷却tick，数值越小射速越快
    max_range: 30           # 最大有效射程，超出后伤害衰减
  recoil:
    vertical: 1.6           # 垂直后座力数值
    horizontal: 0.4         # 水平后座力数值
  slots:                    # 允许安装的配件槽位，不可跨类型添加
    - MAGAZINE
    - STOCK
    - MUZZLE
    - AP3_CHIP

3. 配件配置（attachments/文件夹下）

每个配件对应独立配置文件，定义槽位、属性、强化等级、材料需求，核心配置示例：

代码：

AP3_Chip_1:  # 配件ID
  slot: AP3_CHIP  # 对应槽位类型
  display_name: "§5初级穿甲芯片"
  stats:
    penetration_bonus: 0.10 # 基础穿甲加成10%
  enhancement:
    max_level: 5            # 最大强化等级
    success_rate: 0.85      # 强化成功率，0.85代表85%
    bonus_per_level:
      penetration_bonus: 0.03 # 每级提升3%穿甲率
    materials:              # 对应等级强化材料
      1: {AMETHYST_SHARD: 3}
      2: {AMETHYST_SHARD: 5, DIAMOND: 1}
  repair_items:             # 修复所需材料
    AMETHYST_SHARD: 2

4. 材料匹配规则（强化+修复通用）

强化材料与修复材料支持两种格式，兼容原版物品与MythicMobs自定义物品，无需额外插件转换：

原版物品：直接填写英文ID，如IRON_INGOT（铁锭）、DIAMOND（钻石）、AMETHYST_SHARD（紫水晶碎片）；
MM自定义物品：格式为 MM:物品ID 或 MYTHIC:物品ID，插件会自动识别匹配，示例：MM:Steel_Core、MYTHIC:Weapon_Parts_A。

代码：

# 材料配置示例
MuzzleCompensator:
  enhancement:
    materials:
      1:
        IRON_INGOT: 3
        MM:Steel_Core: 1
  repair_items:
    IRON_INGOT: 2
    MM:Repair_Kit_T1: 1

六、使用须知与权限说明

玩家使用枪械需手持枪械，右键射击，部分枪械需换弹，换弹逻辑可配置；
配件安装：手持枪械，右键打开配件GUI，拖拽对应配件至槽位即可安装，破损配件无法安装；
管理员禁止随意修改枪械ID、配件ID，修改后需同步更新命令与物品，避免数据丢失；
服务器平衡建议：新手服降低强化成功率、提升基础伤害；硬核服调高后座力、增加损耗比例；
数据存储：插件自动存储玩家枪械、配件数据，无需额外数据库，本地文件存储，稳定不丢失。

七、常见问题与故障排查

Q：插件加载报错，无法使用？ A：优先检查MrCore是否安装、版本是否匹配，重启服务器后重新加载，确认服务端为高版本（1.16.5+）；
Q：枪械无法射击、无伤害？ A：检查枪械耐久是否耗尽、配件是否全部破损，执行/gun repair修复，或检查权限是否正常；
Q：强化材料不生效，无法强化？ A：核对材料ID是否正确，MM物品需确认MythicMobs已加载对应物品，大小写需完全匹配；
Q：弹道、特技不显示？ A：检查config.yml中对应开关是否开启，确认服务器粒子效果未被禁用；
Q：修改配置后不生效？ A：执行/gun reload重载，确认配置文件YAML语法无错误，无多余空格或符号。

授权转载加群 1003783524

反馈： GREENLIGHT

原创游戏模式盲期-末日枪械 1.0.0

一、插件简介

核心特性一览

二、安装与依赖

依赖插件区分（必装/推荐）

必须依赖（缺一不可）

软依赖（推荐安装，拓展功能）

标准安装步骤

三、命令与权限

完整命令对照表

权限节点详解

四、核心游戏机制

1. AP3穿甲伤害计算（核心机制）

2. 配件养成系统

配件槽位类型

强化与破损机制

3. 特技触发系统

4. 后座力与弹道机制

五、详细配置指南

1. 全局配置（config.yml）

2. 枪械配置（guns/文件夹下）

3. 配件配置（attachments/文件夹下）

4. 材料匹配规则（强化+修复通用）

六、使用须知与权限说明

七、常见问题与故障排查

评分

MangQi 的其他资源

分享资源

我们重视您的隐私

原创 游戏模式 盲期-末日枪械 1.0.0

一、插件简介​

核心特性一览​

二、安装与依赖​

依赖插件区分（必装/推荐）​

必须依赖（缺一不可）​

软依赖（推荐安装，拓展功能）​

标准安装步骤​

三、命令与权限​

完整命令对照表​

权限节点详解​

四、核心游戏机制​

1. AP3穿甲伤害计算（核心机制）​

2. 配件养成系统​

配件槽位类型​

强化与破损机制​

3. 特技触发系统​

4. 后座力与弹道机制​

五、详细配置指南​

1. 全局配置（config.yml）​

2. 枪械配置（guns/文件夹下）​

3. 配件配置（attachments/文件夹下）​

4. 材料匹配规则（强化+修复通用）​

六、使用须知与权限说明​

七、常见问题与故障排查​

评分

MangQi 的其他资源

分享资源

我们重视您的隐私

原创游戏模式盲期-末日枪械 1.0.0

一、插件简介

核心特性一览

二、安装与依赖

依赖插件区分（必装/推荐）

必须依赖（缺一不可）

软依赖（推荐安装，拓展功能）

标准安装步骤

三、命令与权限

完整命令对照表

权限节点详解

四、核心游戏机制

1. AP3穿甲伤害计算（核心机制）

2. 配件养成系统

配件槽位类型

强化与破损机制

3. 特技触发系统

4. 后座力与弹道机制

五、详细配置指南

1. 全局配置（config.yml）

2. 枪械配置（guns/文件夹下）

3. 配件配置（attachments/文件夹下）

4. 材料匹配规则（强化+修复通用）

六、使用须知与权限说明

七、常见问题与故障排查