HawChow-GTFO_Sentry_Skins icon

GTFO Sentry Skins

GTFO 四座哨戒炮的二次元机械皮肤组(food/Skins 0.12.0)。装包即自动安装皮肤组,无需手动复制。注意:炮台显示屏已被替换,无法再通过显示屏查看剩余弹药;材质仅彩色 albedo 为真实贴图,法线/金属度/自发光为中性兜底。

Last updated 5 days ago
Total downloads 152
Total rating 0 
Categories Client Mods AI Generated
Dependency string HawChow-GTFO_Sentry_Skins-1.2.13
Dependants 1 other package depends on this package

This mod requires the following mods to function

AuriRex-Clonesoft_Json-13.0.0 icon
AuriRex-Clonesoft_Json

Library - Newtonsoft.Json but in a renamed namespace.

Preferred version: 13.0.0
food-Skins-0.12.0 icon
food-Skins

Modular skin support (no more replacing asset files!)

Preferred version: 0.12.0
BepInEx-BepInExPack_GTFO-3.2.4 icon
BepInEx-BepInExPack_GTFO

BepInEx pack for GTFO. Preconfigured and includes Unity Base DLLs.

Preferred version: 3.2.4

README

GTFO 哨戒炮皮肤(四座)

把 GTFO 的四座哨戒炮换成二次元机械炮台外观,按 food/Skins 0.12.0 的皮肤组格式分发。 模型与色图图集由本项目自建烘焙流程生成:静态网格 + 单张彩色 albedo 图集。

1.2.13 变更:兼容插件 SentrySkinCompat.dll 升级到 1.2.13(Assembly/File 1.2.13.0,118,784 B, SHA-256 96568534…):修复同一 owner token 上两个待写贴图项互相删除/覆盖的缺陷,并把“贴图缓存键中毒”的 恢复测试重新纳入回归。四个皮肤组的网格 / 贴图 / 材质目标与 1.2.5 逐字节相同(含霰弹炮台眼部图集 D106BB44…)。

1.2.3 变更:修复“部署后炮台整机发黑”——兼容插件改为逐 MeshRenderer 发放 Skins owner,皮肤贴图的异步排队不再被同一个 GearPartHolder 的其它 renderer 覆盖。

1.2.2 变更:皮肤组的网格与材质改用他在 Test profile 实机验证过的 v4 烘焙(尺寸/朝向修正);打包改为 Assets/Skins/ 自动安装。

必读(功能风险):炮台自带的显示屏被替换/简化,玩家无法再通过炮台显示屏查看剩余弹药。 这是本 MOD 的可观测性代价,请务必在安装前知悉:剩余弹药请改用 HUD 的装备计时/弹药信息判断, 或干脆按经验打。任何依赖“看炮台屏幕”判断剩余弹药的习惯都会失效。

四座哨戒炮对应表

游戏内型号 gear ID 外观代号 皮肤组 GUID
Mechatronic SGB3(连发哨戒炮) 24 sgb3 gtfosentryskins.sentry-sgb3
RAD Labs Meduza(HEL 自动哨戒炮) 6 meduza gtfosentryskins.sentry-meduza
Mechatronic B5 LFR(霰弹哨戒炮) 25 b5lfr gtfosentryskins.sentry-b5lfr
Autotek 51 RSG(狙击哨戒炮) 23 rsg gtfosentryskins.sentry-rsg

材质清单 / 是否完整

四个 _Slot 都在 GTFO 原版材质 1(sharedassets370.assets,Unity 2019.4.21f1)的贴图属性表里 被证实存在,因此 Skins 能真正写入;但只有 albedo 绑定的是本项目烘焙的彩色图集:

炮台 gear albedo normal emissive metal-ORM
状态口径 彩色贴图 / 中性兜底 彩色贴图 / 中性兜底 彩色贴图 / 中性兜底 彩色贴图 / 中性兜底
RAD Labs Meduza(HEL 自动哨戒炮) 6 ✅ 彩色贴图 hd2_albedo_atlas.png 中性兜底 中性兜底(黑图) 中性兜底
Mechatronic SGB3(连发哨戒炮) 24 ✅ 彩色贴图 hd2_albedo_atlas.png 中性兜底 中性兜底(黑图) 中性兜底
Autotek 51 RSG(狙击哨戒炮) 23 ✅ 彩色贴图 hd2_albedo_atlas.png 中性兜底 中性兜底(黑图) 中性兜底
Mechatronic B5 LFR(霰弹哨戒炮) 25 ✅ 彩色贴图 hd2_albedo_atlas.png 中性兜底 中性兜底(黑图) 中性兜底

结论:材质不完整:只有 albedo 是彩色贴图,normal / emissive / metal-ORM 三项全部是中性兜底。 上表只用两态:彩色贴图 与 中性兜底,不存在"部分绑定"这种中间说法。

  • normal=中性兜底:烘焙法线图集是切线空间的,它与 GTFO 网格切线基是否一致无法离线证明, 硬绑会出现错误明暗,因此不绑。
  • metal-ORM=中性兜底:烘焙 ORM 是 R=AO/G=roughness/B=metallic,Unity 的 _MetallicGlossMap 是 R=metallic/A=smoothness,通道重映射与 _Metallic/_Glossiness 着色器默认值都无法离线证明,因此不绑。
  • emissive=中性兜底(黑色):烘焙 emissive 蒙版是纯白,绑定会把整只炮台照成白色; 黑图 + 黑色 tint 是构建期选定的保守写法,尚未实机复验(IN_GAME_VERIFY=false)。
  • 槽位是否存在:只在材质层证明(GTFO 原版材质 1 的贴图属性表里有这四个槽)。本次探针 没有解析到 Shader 资产(shaders 为空),所以本文不宣称任何"着色器层证明"。

安装方式(装即用)

  1. 在 r2modman / Thunderstore Mod Manager 里对 GTFO 的 profile 安装本包即可:
    • 皮肤组随包自动落到 <profile>/BepInEx/Assets/Skins/,Skins 首次启动会把它们并入 全局皮肤库 %AppData%\io.takina.gtfo.Skins\skins\,不需要手动复制任何文件;
    • 前置 food-Skins 0.12.0、BepInEx Pack GTFO 3.2.4、AuriRex-Clonesoft_Json 13.0.0 都写在 manifest.json 的 dependencies 里,模组管理器会一并拉取。
  2. 进游戏 → Skins 菜单 → 给四座哨戒炮分别选对应皮肤组(gear 24 / 6 / 25 / 23)。
  3. 兼容插件 SentrySkinCompat(随包)负责把“部署态炮台”接进 Skins 的应用路径, 并在每帧重新持有贴图。它只处理上表四座炮台,其它装备一概不碰。
  4. 手工安装(不用模组管理器)时:把 BepInEx/plugins/SentrySkinSlayerSquad-GTFO_Sentry_Skins/ 放进对应的 profile,把 Assets/Skins/ 下四个目录复制到 <profile>/BepInEx/Assets/Skins/(或全局 skins 目录)。

为什么要带一个 .dll(必读风险)

本包不只是皮肤数据,还带一个 BepInEx 插件 SentrySkinCompat.dll。不是偷懒 —— 是 Skins 0.12.0 自己补不上这一步:

手里的 gear 丢在世界里的 gear(含已部署哨戒炮)
PlayfabItemInstanceId 有(库存实例) null
Skins 的处理 正常换模 GearPatches.cs:31-35 直接 return
需要本插件吗 不需要 必须

所以"纯皮肤组、无插件"的包(例如大锤那种拿在手上的武器皮肤)能直接工作,而部署到地图上的炮台不行: Skins 会在识别 gear ID 那一步放弃,网格替换根本不会发生。插件只补这一步 —— 在同一个 GearPartHolder.OnAllPartsSpawned 上挂一个低优先级(-200)postfix,认出四座炮台、校验你在 Skins 菜单里选的那组 GUID,然后调用 Skins 自己的公开入口 SkinManager.ApplyGroupToRawTarget。

你需要知道的风险

  • 进程内代码:这是一个真插件,会在游戏进程里运行并下 Harmony postfix。它只处理上表四座炮台, 其它装备一律 fail-closed 不碰;不修改 Skins.dll,也不改写任何游戏原始文件,只新增自己的 BepInEx/plugins/SentrySkinSlayerSquad-GTFO_Sentry_Skins/。
  • 版本绑定:只对 food-Skins 0.12.0 验证过。Skins 升级后,BepInEx 会因依赖不满足跳过本插件 (插件不再执行),皮肤会退回"菜单可选、部署不生效"的状态 —— 那时需要更新本包。
  • 每帧续租贴图:Skins 的 idle 回收会在约 60 秒后销毁没人引用的贴图(炮台会变黑),插件每帧为 四座炮台续租贴图句柄;代价是每帧极小的开销,换来炮台不会中途变黑。
  • 仅本机可见:这是客户端视觉替换。同局其他玩家没装同一套,就看不到你炮台的外观。
  • 不装这个 .dll 会怎样:皮肤组仍会被 Skins 扫到、菜单里也能选,但部署到远征里的炮台保持原版外观。
  • 怎么自查:BepInEx 日志里搜 [SentrySkinCompat] RECEIPT,出现 outcome=Proven 且 sharedMeshChanged=16 就是真的换上了;菜单/装备预览阶段的 SkipNoMeshTarget 属正常 (预览模型不是部署实例,不影响局内)。

已知限制

  • 炮台显示屏被替换/简化,玩家无法再通过炮台显示屏查看剩余弹药(见文首风险提示)。
  • 材质仅 albedo 为彩色贴图;法线/ORM 为中性兜底,自发光为黑色(详见上表)。
  • 部分辅助部件(弹链、特效面片等)不在烘焙网格内。
  • 连发哨戒炮的 hd2_source_normal_atlas.png / source_gltf_orm_atlas.png 随包但未绑定、代码不引用(脚注,非可用材质)。
  • 仅测试于 food/Skins 0.12.0 + GTFO 当前版本;其它版本不保证。

反馈

截图

本页六张实机截图以绝对 https:// 直链外链(Thunderstore 不显示包内图片,也不显示相对路径):

图 1:Mechatronic SGB3(连发哨戒炮)

Mechatronic SGB3 实机截图

炮座圆台 + 机匣/枪管近景;粉色系彩色图集(albedo_atlas)呈现金属反光。

图 2:Mechatronic B5 LFR(霰弹哨戒炮)

Mechatronic B5 LFR 实机截图

枪管与外壳近景;彩色图集整体偏亮白/米色。

图 3:RAD Labs Meduza(HEL 自动哨戒炮)

RAD Labs Meduza 实机截图

侧面站姿视角;可见炮台轮廓与比例。

图 4:Autotek 51 RSG(狙击哨戒炮)

Autotek 51 RSG 实机截图

整机近景(含长枪管);深色金属质感。

图 5:四座哨戒炮同屏(远景)

四座哨戒炮同屏实机截图

四座炮台同处一局:确认四种皮肤的尺寸与朝向彼此一致;炮座圆台(Turret_Base_1)为四座共用材质,同屏时不串味。

图 6:四座哨戒炮同屏(侧向)

四座哨戒炮同屏侧向实机截图

侧向视角下的四座炮台:长枪管朝向、水平支架与瞄准镜比例,与原版炮台模型的相对位置一致。


图标取自:截图 6(四座同屏那张,band-256px-height, centre-crop width,256×256,sha256 5dddce46071f7f8d…), 原图 https://raw.githubusercontent.com/hawchou1995/HawChow-Mod-Assets/main/GTFO-Sentry-Skins/sentry-06-sniper-rsg-scene.png。 包内静态校验见 release/static-report.json(python verify.py 逐条 PASS/FAIL)。