可配置的兼容弓的1911、泵动式和M16枪械，支持鹿弹、龙息弹、穿甲弹和中空弹。

史诗枪械 0.5.0

三种可配置的英灵神殿枪械，使用 弓术技能与弓类物品类别，拥有自定义模型、图标、弹药和音效。需要 BepInExPack Valheim 5.4.2350 和 Jotunn 2.30.2。史诗战利品为可选。

武器和配方

武器	层级 / 关卡	制作材料	默认伤害	开火
1911	黑森林 / 锻造坊 1	8 青铜，4 优质木材，2 鹿皮	22点武器穿透加18点弹药穿透	一轮，1秒基础装填
泵动式	黑森林 / 熔炉 1	15 青铜，15 锡	12发弹丸共60点穿透	单发装填，基础装填时间1.8秒
M16	沼泽 / 熔炉 2	20 铁，10 细木，5 碎皮	每发子弹18点武器伤害+10点弹药穿透	三连发自动射击，射速间隔0.12秒，基础装填时间1.1秒

伤害数值为计算技能、护甲、抗性及魔法修正前的数值。霰弹枪每颗弹丸造成5点基础穿刺伤害，而非60点。散布效果使霰弹枪在近距离最为有效。英灵神殿对每次命中分别计算护甲。两把新武器均有四个品质等级；霰弹枪升级每级共增加6点穿刺伤害，步枪升级每级每颗子弹增加3点穿刺伤害。

霰弹枪采用发蓝钢枪管、青铜配件、带棱纹胡桃木泵动护木、枪托、扳机护圈、瞄具、机匣销和抛壳口。M16采用固定聚合物枪托、开放式提把、带棱纹护木、准星塔、消焰器和微弧形弹匣。翻修后的1911采用纤薄倒角套筒、齐平枪口、流线型胡桃木握把、开放式弧形扳机护圈、防滑纹、保险控制件、击锤和螺丝。这些是带有尺寸安全回退的程序化模型；长枪使用左手支撑姿势。它们使用现有的射击动画；没有泵动循环动画或可拆卸弹匣换弹动画。

弹药

配方产出	材料	效果
20 .45 ACP	1 铜，2 煤，1 树脂	现有手枪弹药
10 × 12号鹿弹	1 铜，1 煤	12颗弹丸，合计60点基础穿透
10 × 12号口径龙息弹	2 铜，2 煤	12发弹丸，60穿透 加15火焰 默认画质下
30 × 556	1 铁，1 铜，2 煤	标准M16弹药
20 × .45 ACP 穿甲弹	2铜，2煤，1树脂	+6穿刺；46合并基础穿刺
20 × .45 ACP 空尖弹	2铜，2煤，1树脂	40点综合基础穿刺加6点钝击
30 × 556 穿甲弹	2 铁，1 铜，2 煤	+5穿刺；33基础穿刺合计
30 × 556 空尖弹	1 铁，2 铜，2 煤	28 组合基础穿刺 +5 钝击

所有.45 ACP和12号口径的配方使用锻造1；所有5.56的配方使用锻造2。穿甲弹和中空弹的加成及制作成本可配置。穿甲弹按正常护甲/抗性规则提供额外穿透伤害。中空弹保留标准穿透并增加钝击伤害。在背包中选择所需兼容弹药。龙息弹附加火焰伤害等于 最终穿刺伤害的25%，包括武器品质和伤害修正。其飞行的弹丸带有橙黄色火焰轨迹和渐隐的残余火焰。火焰伤害遵循《英灵神殿》的燃烧和抗性规则。新的弹药图标与现有的三发弹、金色描边风格保持一致；霰弹壳顶部为平口卷边，龙焰弹壳则带有火焰标记。

一发霰弹枪射击消耗一发霰弹。步枪点射按照 Valheim 常规弹药选择方式，每发子弹消耗一发弹药，保留 Epic Loot 的弹药节约机制。不完整的弹药堆叠只会发射可用的弹药；切换武器或中断攻击会取消点射的剩余部分。点射发数和间隔可配置。此版本采用点射射击，而非基于弹匣的持续自动射击系统。

安装与配置

导入 dist/EpicGuns-0.5.0.zip 作为模组管理器中的本地模组，或将其BepInEx目录解压到你的配置文件/游戏文件夹中。替换之前的EpicGuns安装，确保只加载一个EpicGuns DLL。源ZIP文件供开发使用。

在服务器和每个客户端上安装相同版本。所有现有的物品预制体ID、弹药类别ID和配置节名称均保持不变，因此已保存的武器和弹药仍然有效。只有显示名称发生变化：森林霰弹枪 → 泵动式霰弹枪，沼泽突击步枪 → M16，步枪弹药 → 556。现有的[霰弹枪]、[突击步枪]和[步枪弹药]配置节仍然控制重命名后的物品。不捆绑任何依赖DLL，也不会覆盖任何现有配置文件。

首次启动后，编辑 BepInEx/config/com.triston.epicguns.cfg见 配置.md 适用于所有新的默认值。游戏设置和配方数量使用Jotunn的服务器同步；本地音频、瞄准、曳光弹和火焰视觉效果仍保留在客户端。手动编辑文件后需重启。通过配置管理器所做的更改会更新已注册的平衡性和配方数值；现有的投射物/攻击将以当前状态完成，视觉效果更改将应用于新生成的 эффект。

模组包兼容性

打包的史诗战利品补丁将霰弹枪添加到 弓 / 击败_地精王 以及步枪 弓 / 击败骨量，以匹配现有测试配置文件的“黑森林”和“沼泽”列表。武器保留弓术技能和弓类物品类别，以兼容相应的魔法效果。长枪在装备时暂时使用双手装备路径，随后立即恢复其弓类类别。这样可以避免触发双持单手装备分支。

原版手枪仍为单手持用。霰弹枪标准化会将所有受到的伤害和技能增益按配置的基础弹丸数量进行分配，因此多重射击产生的额外弹丸仍可增加总伤害。弓类武器没有全局伤害改动。每把枪械仅接受其所属的弹药类型。

枪声效果预制体和弹丸已进行网络注册，包括更新后的1911报告。手枪音效经过重新制作，采用干涩的宽带爆裂声、压力主体和短暂的户外反射，没有音高合成的尾音。泵动式霰弹枪在换弹实际开始时播放开头的“咔嚓”声，完成时播放结尾的“咔嚓”声；取消换弹不会播放完成音效。泵动音效拥有独立的本地音量和启用设置。视觉/音频代码会跳过专用服务器。本次更新针对本地安装的游戏和配置文件依赖进行了编译；已检查选定的Epic Loot和DualWield代码路径。 完整的模组包、多人游戏、视觉和听觉测试在运行中的游戏里仍然是必需的。 请参阅 VALIDATION.md。

控制台生成

生成 EpicGuns_1911 生成 EpicGuns_45ACP 100 生成 EpicGuns_Shotgun 生成 EpicGuns_Buckshot 100 生成 EpicGuns_DragonBreath 100 生成 EpicGuns_AssaultRifle 生成 EpicGuns_RifleAmmo 100 生成 EpicGuns_45ACP_AP 100 生成 EpicGuns_45ACP_HP 100 生成 EpicGuns_556_AP 100 生成 EpicGuns_556_HP 100

建筑

插件需要 .NET SDK 8 或更高版本（.NET Standard 2.1）。可选的验证工具使用 SDK 10。

./build.ps1 -EpicGunsManaged 'D:/SteamLibrary/steamapps/common/Valheim/valheim_Data/Managed' -EpicGunsBepInEx 'C:/path/to/profile/BepInEx/core' -EpicGunsJotunn 'C:/path/to/profile/BepInEx/plugins/ValheimModding-Jotunn'

脚本将在以下位置创建插件和资源： src/bin/Release/netstandard2.1、安装/源码ZIP包、构建日志和SHA-256校验和，详见 远端编译器中间产物保存在一个新的临时目录中。 tools/build-audio.ps1 重新生成所有程序化枪声和泵动循环音效。ASSET_PROMPTS.md 记录了内置的图像生成提示词和已保存的资源。