FN P90 战术型

FN P90 战术型

向游戏中添加一把FN P90战术枪,包含动画和独立子弹消耗机制

免责声明:所有代码工作和技术说明均由 Opus 5.5 完成,我只负责撰写这份描述(以及进行了大量游戏内测试。很多。太多了。)

[size=4][b]描述[/b][/size]
[color=#D4D4D8]添加了一把 P90[/color]
[color=#D4D4D8]应该兼容原版配件(瞄准镜/消音器)[/color]

[size=4][b]安装说明[/b][/size]
解压下载文件,并将 .pak 文件安装到
[code]Stalker2/Content/Paks/~mods[/code](如果 ~mods 文件夹不存在,请创建它)

如果使用可选的调参器,请将其安装到你的 UE4SS mods 文件夹


[size=4][b]获取方式[/b][/size]
酒保在罗斯托克出售这把枪

[b][size=4]已知问题[/size][/b]

[list]
[]游戏内弹匣材质不太对,而且在某些光照下(例如亚尼夫和罗斯托克建筑外的聚光灯)光照不会作用于它,所以看起来太暗[/]
[]弹壳从侧面弹出,而不是像真正的 P90 那样从底部弹出。[/]
[]把弹匣拍进枪里时,左手位置不完美[/]
[/list]
1.01 中修复:
[list]
[]换弹时没有音效[/]
[]安装瞄准镜时,动画会覆盖到枪的后部播放(动画结束后瞄准镜会到正确位置)[/]
[/list]

[b][size=4]技术说明[/size] [/b](由 Opus 提供)
[b]材质[/b]
[spoiler][b]半透明弹匣是如何着色渲染的(技术向)[/b]

要让一个带纹理的半透明第一人称部件在《S.T.A.L.K.E.R. 2》中正常工作,需要解决五个独立的问题,每一个看起来都像是另一个不同的问题。以下大致按它们误导我们的严重程度排序:

[b]1. 永远加载不了的模组着色器[/b]
[list]
[]Zone Kit 为模组编译的着色器会进入模组自己的着色器库。对于安装在 ~mods 中的模组,游戏显然永远不会打开那个库,因此任何需要这些着色器的材质都会被静默地[i]不绘制[/i]。没有错误,没有回退的网格材质,什么都没有。[/]
[]着色器恰好与 GSC 的着色器相同的材质则可以正常工作:GSC 材质的普通实例,或 GSC 主材质的完全副本。Kit 的派生数据缓存会分发游戏已自带的 GSC 预编译着色器。这就是为什么一个材质在你更改一个节点之前都能正常工作。[/]
[]一个关键的测试:一个本应是纯红色的材质结果变成了不可见。[/]
[]修复方法:在 [font=Courier New][/Script/UnrealEd.ProjectPackagingSettings][/font] 下使用 [font=Courier New]bShareMaterialShaderCode=False[/font](以及 [font=Courier New]bSharedMaterialNativeLibraries=False[/font])来烘焙模组,例如在烘焙期间将其追加到 Kit 的 [font=Courier New]Stalker2/Config/Custom/ModCookNewContent/DefaultGame.ini[/font] 中。这样每个材质都会内联携带自己的着色器:材质包会大约膨胀 10 倍,且烘焙后的容器没有 ShaderCode 块。[/]
[/list]
[b]2. 第一人称放置[/b]
[list]
[]第一人称武器部件并不是绘制在它们真正所在的位置。GSC 的材质函数 [font=Courier New]MF_ForegroundWithShadowSwitch[/font] 在 World Position Offset 上,会使用 [font=Courier New]MPC_FOV[/font](TanFOV、DepthScale、IsFOVEnabled)应用武器视野校正以及对墙体裁剪的深度压缩。[/]
[]游戏在运行时通过为武器创建的动态材质实例设置 [font=Courier New]ForegroundFOVEnabled = 1[/font] 来对每个部件启用它。每个实例资源默认携带的都是 0。[/]
[]自定义的第一人称材质需要在其 WPO 引脚上使用该函数,否则该部件会被绘制在其真实位置:更大、更靠近摄像机、偏离枪身。简单的方法是复制一个带有该函数的 GSC 武器主材质(本模组使用的是 M_PBR_WeaponGlass_02_glass),只更改像素部分。Kit 的 Python 无法自行连接 WPO 引脚。[/]
[]由脚本创建的动态实例初始值为 0,因此要在其上设置 [font=Courier New]ForegroundFOVEnabled = 1[/font]。[/]
[/list]
[b]3. 第一人称半透明度的光照模式[/b]
[list]
[][b]Surface ForwardShading[/b](逐像素):会闪烁,在某些摄像机角度下会出现白色斑块在表面扩散,即使关闭反射也是如此。[/]
[][b]Surface TranslucencyVolume[/b]:稳定且能响应光照。本模组使用它。[/]
[][b]Volumetric[/b](逐顶点,方向性或非方向性):稳定但扁平。[/]
[][b]Thin Translucent[/b] 和[b]基于 SceneColor 的玻璃[/b](从其后方图像伪造折射):在我们的测试中,第一人称渲染过程中表面后方没有任何东西显示出来,因此它们渲染成了扁平的片状。[/]
[]半透明表面的反射会随其不透明度缩放,因此非常清透的外皮反射很少。[/]
[/list]
[b]4. 单个网格内部的绘制顺序[/b]
[list]
[]半透明网格按缓冲区顺序绘制其三角形,不进行排序,而且网格构建过程无论如何都可能在一个区段内重新排列三角形。[/]
[]该模型的弹匣建模时带有真实厚度:一层外皮和一层内皮。因此内皮和远侧壁被绘制在顶板[i]之上[/i],顶部看起来是透明的,除非被后面绘制的三角形覆盖。[/]
[]区段会保持其顺序,因此外壳被拆分为三个从后到前绘制的区段:内皮,然后是外侧和底部,最后是外顶部。[/]
[]这是通过 Kit 的 Python 网格描述 API(get_static_mesh_description、create_polygon_group、set_polygon_polygon_group、build_from_static_mesh_descriptions)完成的。[/]
[]陷阱:
[list]
[
]你获取的描述是实时描述,因此即使你的脚本在构建之前失败,编辑也会保留下来。[/]
[
]新组的材质来自该组索引处的槽位,因为导入的槽位名称无法从 Python 设置。请将新槽位放在这些索引处。[/]
[
]在使用该构建路径之后,后续的材质槽位编辑会以[i]零[/i]边界重建网格。引擎会将其视为屏幕外而剔除,弹匣就在发布版本中消失了。发布前请检查网格边界。[/]
[/list][/
]
[/list]
[b]5. 着色器本身[/b]
[list]
[]GSC 武器玻璃主材质的副本(因此放置保持不变),双面,使用模型的虚拟纹理。[/]
[]采样器类型必须与纹理匹配。Masks 压缩的贴图需要 Virtual Masks。不匹配会导致材质编译失败,而烘焙仍然报告 Success;唯一的迹象是日志行 "Failed to compile Material"。[/]
[]不透明度 = 纹理的 alpha × 一个缩放系数,加上一个菲涅尔边缘项,因此塑料在你斜看它时会变得更密更暗,这读起来像厚度。[/]
[]颜色层使用视差偏移(BumpOffset)采样,因此斑点位于表面之下,而凹凸和反射保持在顶部。[/]
[]粗糙度贴图的斑点也会驱动颜色和不透明度,因此它从每个角度都能显示出来,而不仅仅是在反射捕捉到它的地方。[/]
[]从背面看到的表面会着色得更暗,内皮和外皮会获得单独的材质实例。[/]
[/list]
[b]6. 无需重新构建即可调参[/b]
可选的 P90GlassTuner(UE4SS)会在游戏自己的弹匣动态实例上按皮肤实时设置材质参数。内置外观就是这样调出来的。其脚本和设置文件位于 "with GlassTuner" 压缩包中。[/spoiler]
[b]可见子弹消耗[/b]
[spoiler][b]可见子弹是如何工作的(技术向)[/b]

《S.T.A.L.K.E.R. 2》已经有一套用于显示单发子弹的系统:它就是绘制 PKP 弹链的系统。它没有任何 PKP 特定的内容。它完全由武器配置加上第一人称[i]手部[/i]动画中的通知驱动,因此只要每个部分都到位,任何武器都可以使用它。这些内容没有任何文档记录,下面每一部分都至少花费了一次失败的构建才找到。

[b]1. 配置[/b]
在武器的常规设置原型中:
[code]BulletsSockets : struct.begin {bskipref}
[0] = P90Round_49
[1] = P90Round_48
...
[48] = P90Round_01
struct.end
BulletMeshPath = StaticMesh'/FNP90Tactical/FNP90Tactical/Meshes/SM_FNP90T_round.SM_FNP90T_round'[/code][list]
[]对于每个条目,游戏会使用 BulletMeshPath 生成一个 StaticMeshComponent,并将其附加到该名称对应的插槽上。[/]
[]插槽不存在的条目完全不会获得组件。缺失的插槽会被静默跳过,而不是放置在原点。[/]
[]在弹匣附加原型上,使用 PKP 弹链盒的那一对:[font=Courier New]Magazine { BindBulletsToAttach = true; HasMultipleMeshes = false }[/font]。Vector 的弹匣使用 HasMultipleMeshes = true(它的满/空弹匣网格切换)。[/]
[/list]
[b]2. 插槽必须在枪的骨骼网格上[/b]
[list]
[]游戏会将子弹附加到[i]武器[/i]骨骼网格上的插槽,即使 BindBulletsToAttach = true 也是如此。当枪和弹匣上都有同名插槽时,每发子弹都会挂在枪的插槽上,移动弹匣的插槽不会移动任何东西。[/]
[]弹匣附加本身必须是静态网格。骨骼弹匣会获得一个 StaticMeshComponent 并且永远不会被绘制。[/]
[]为了让子弹在换弹期间随弹匣移动,每个插槽的父骨骼是弹匣骨骼(在 Vector 派生骨骼上是 jnt_clip_base),其变换位于弹匣空间中。[/]
[]Zone Kit 的 Python 无法更改插槽的骨骼,而编辑[i]已烘焙[/i]的网格会完全破坏枪(不可见、武器状态卡住)。有效的方法是:在烘焙之前使用 UAssetAPI 编辑未烘焙的 Kit 资源,然后让 Kit 正常烘焙它。[/]
[/list]
[b]3. 可见性来自手部蒙太奇通知,别无其他[/b]
子弹的出现和消失仅通过第一人称手部蒙太奇中带有 [font=Courier New]WeaponAction = BulletMeshesVisibility[/font] 的 [font=Courier New]AnimNotify_WeaponAction[/font] 通知实现。PKP 的蒙太奇是参考;Vector 的没有这些通知,这就是为什么很长时间内什么都显示不出来。
[list]
[][font=Courier New]ShowBulletMeshes = true[/font] 显示每一发子弹。[/]
[][font=Courier New]ShowBulletMeshes = false[/font] 只会[i]隐藏[/i]:它会从索引 0 开始隐藏除最后一个(弹药数 + 1)之外的每个条目。它从不显示任何东西。[/]
[]子弹初始是隐藏的,因此必须有东西触发[i]true[/i]。只有[i]false[/i]通知的设置完全不会显示任何东西。[/]
[/list]P90 使用的(从 PKP 的蒙太奇复制到重命名的手部蒙太奇副本中):
[list]
[]每个射击蒙太奇(腰射、瞄准、瞄准镜变体):每次射击触发一次[i]false[/i]。枪的射击动画集合条目指向这些副本。[/]
[]两个换弹蒙太奇:在 1.8 秒时触发[i]true[/i],即弹匣骨骼离枪最远的时刻(交换),这样新弹匣进来时已经是满的;以及在 AddAmmo 通知之后再次触发[i]true[/i],这样数量就匹配了。[/]
[/list]
[b]4. 顺序决定哪一端先清空[/b]
隐藏从索引 0 开始,因此把应该最先消失的子弹列在前面。在真正的 P90 上,托弹板将弹柱推向供弹口,因此弹匣前端先清空:[0] 是最前面的子弹,最后一项是后方供弹处的子弹。

[b]5. 多出来的那发子弹[/b]
因为[i]false[/i]会保持 ammo + 1 可见,所以空弹匣中会留下一发子弹(1.0 中的已知问题)。可能的修复方法是在枪身内部放一个隐藏的虚拟插槽作为最后一项,用来容纳那发多出来的子弹。尚未单独测试。

[b]6. 继承部件的陷阱(“幽灵子弹”)[/b]
一个继承自另一个文件(refurl + refkey)的配置条目会[i]按索引[/i]合并数组,而且 {bskipref} 跨文件会被忽略。你自己列表末尾之后的每个继承部件都会保留下来。Vector 的膛内子弹网格、枪机和其他部件被绘制在了 P90 内部,包括握把下方一发多出来的子弹。修复方法是写出父级的整个设置块并合并你的更改,而不是部分覆盖。

[b]7. 让它变得可调试的东西[/b]
一个小型只读 UE4SS 脚本,每次有变化时列出附加到枪上的每个组件(网格、插槽、父骨骼、可见性)。它显示了子弹组件实际挂在哪里以及哪些可见,这是从配置中怎么猜都做不到的。[/spoiler]


[size=4][b]致谢[/b][/size]
[color=#D4D4D8]模型:[url=https://sketchfab.com/3d-models/fn-p90-tactical-model-380f4250f2f6453ebd7c4efb1eb42e08]Original Model[/url] 由 [url=https://sketchfab.com/moco80]MojoLeeDa[/url] 制作,来自 sketchfab。[url=https://creativecommons.org/licenses/by/4.0/]LICENSE[/url][/color]
[color=#D4D4D8]动画:修改自[url=https://www.nexusmods.com/fallout4/mods/22871]这个 FO4 模组[/url]中的动画 - 描述中的截图:[/color]
[spoiler][color=#D4D4D8][img]https://staticdelivery.nexusmods.com/mods/6944/images/2873/2873-1790746719-2055427437.png[/img][/color][/spoiler]
所有移植和代码工作:Opus 5.5
测试:我