|
|
本帖最后由 鼓掌之间 于 2026-8-8 15:02 编辑
转自：https://www.nexusmods.com/cyberpunk2077/mods/19679
·基础说明：
通过简单的 TweakDB/TweakXL 记录实现自定义的游戏内商贩支持。
·自定义商贩功能：
- 可自定义工作点：商贩的动画/待机动作
- 可自定义角色/外观：NPC 的身份及其外貌
- 可自定义商贩名称：扫描时及交互提示中显示的名称
- 可自定义库存：可以是物品列表，也可以是预定义商贩（原生游戏或MOD添加的均可）
- 可自定义地图/小地图图标：8 种图标可供选择，也可选择不显示（AutoFixer 在地图筛选中有独立分类，不与其他商贩并列）
- 可自定义位置/旋转角度：NPC 在游戏世界中的生成位置
- 当玩家靠近时，商贩会看向玩家；每次玩家首次靠近商贩时，V 会有一句对话语音。
（语音有基于距离的共享冷却机制，因此如果多个商贩距离过近，玩家只需对第一个商贩说过台词后，在远离前不会重复触发。）
·依赖要求
- ArchiveXL：https://bbs.3dmgame.com/thread-6550610-1-1.html
- Codeware：https://bbs.3dmgame.com/thread-6550997-1-1.html
- RED4ext：https://bbs.3dmgame.com/thread-6554657-1-1.html
- redscript：https://bbs.3dmgame.com/thread-6555794-1-1.html
- TweakXL：https://bbs.3dmgame.com/thread-6551536-1-1.html
·如何“使用”该MOD？[玩家]
只需安装该MOD，以及所有使用它的其他MOD*即可！无需前往特定地点或执行额外操作，ArchiveXL 会自动激活商贩逻辑。
*请注意：本 [VendorsXL] MOD本身不会添加任何商贩！它用于供其他MOD作者为其MOD/商店创建/添加新商贩。
·如何“使用”该MOD？[MOD作者]
只需在你的MOD中包含一个基于模板的新配置，设置唯一名称和自定义值即可。这甚至可以包含在已有的 .yaml 文件中。
配置名称必须唯一，但其他值可以共享（不过尽量不要让商贩位置重叠）。确保你的 yaml 文件/文件夹命名不会导致其加载早于“##########VendorsXL”，否则配置可能无法正确加载。
“显示名称”（Display Name）可以是任何已有的或新的 LocKey，但新 LocKey 需作为你的MOD的一部分自行创建。
“工作点”（Workspot）可以是任何工作点，但你需确保所选工作点适用于你的角色/实体，不一定非得是站立动作。
“实体”（Entity）和“外观”（Appearance）可以是任何已有的或MOD添加的实体和外观，这些值可在配置数据库中现有角色记录的相同变量中找到。
（该MOD仅确保对类人角色有效，非类人角色可能无法正常工作——我没能让原生游戏的布兰登正常运行……）
查看文件区可获取一个可选压缩包，内含模板（如下所示）和一个示例 yaml 文件，其中包含 3 个商贩的设置（位于体育场入口外的停车场）。
·MOD文件区包含的模板：
yaml
Character.<你的唯一工作室/MOD/ID名称>:
$base: Character.vendorsxl_base
#商贩/NPC的实体和外观设置[默认是歌舞伎区枪支商贩]：
appearanceName: None
entityTemplatePath: base\open_world\characters\vendors\wat_kab_gun_trainer_01.ent
#命名[默认是“Vendor”]：
displayName: LocKey#15525
#工作点文件[默认是站立使用平板]：
holocallInitializerPath: base\workspots\common\ground\generic__stand_ground_tablet__use__01.workspot
#位置数据[必需]
bossHealthBarThresholds: [<x>, <y>, <z>, <i>, <j>, <k>, <r>]
#位置数据 x, y, z,
#旋转数据（四元数） i, j, k, r
#示例：[-1286.9, -1686.1, 44.2, 0.0, 0.0, -0.615, -0.787]
#获取V站立位置的CET命令：
#print(GetPlayer():GetWorldPosition()) print(GetPlayer():GetWorldOrientation())
#你的商贩物品，可编辑和扩展：
items:
- Items.<第一个物品>
- Items.<第二个物品>
- Items.<第三个物品>
#示例：- Items.CasualShoes_07_rich_02
#现有商贩ID；若希望使用游戏中现有商贩的库存而非自定义库存，可修改此值。
#若使用上述自定义库存/物品，请勿编辑此项。
vendorID: Vendors.vendorxl_custom
#地图图标，默认：服装
forcedTBHZOffset: 1
# 0: 无地图标记/隐藏
# 1: 服装
# 2: 枪支
# 3: 食物
# 4: 酒吧
# 5: 近战武器
# 6: 医疗
# 7: 杂物
# 8: 网行者
# 9: AutoFixer
·安装方法？
只需将主 .zip 文件解压到“Cyberpunk 2077”文件夹中，确保 .archive 和 .archive.xl 文件最终位于“Cyberpunk 2077\archive\pc\mod”文件夹。
解压后，VendorsXL 文件夹及包含的文件会位于“Cyberpunk 2077\r6\scripts”文件夹，“##########VendorsXL”文件夹及包含的文件会位于“Cyberpunk 2077\r6\tweaks”文件夹。
文件夹和文件名称中的 # 符号很重要，因为其中定义的某些配置必须早于其他MOD加载。
·依赖要求：
TweakXL、ArchiveXL、Red4ext、Codeware 和 Redscript。
·卸载方法？
只需删除“Cyberpunk 2077\r6\tweaks”和“Cyberpunk 2077\r6\scripts”文件夹中的 VendorsXL 文件夹，也可删除“Cyberpunk 2077\archive\pc\mod”文件夹中的 VendorsXL.archive.xl 文件。
单独的 VendorsXL.archive 文件本身完全无害，但在存档中已正常运行后删除它，若未来重新安装，可能会导致MOD在该存档中无法正常工作。
·语言支持
支持所有语言，MOD本身不使用自定义文本，仅包含一个硬编码的错误弹窗，且不属于MOD的正常运行部分。
·兼容性风险：
预计无兼容性问题，所有内容均为自定义，不修改现有文件。
若该MOD广受欢迎且大量MOD作者迅速使用它，可能会耗尽商贩容量（0.9.0 版本限制为 50 个），超过 50 个不会导致崩溃，但部分商贩可能无法显示。
游戏中已包含警告弹窗，若商贩数量超过 50 个会触发，此时我会（若尚未扩展）对容量进行扩展！
·问题/限制：
- 0.9.0 版本限制为 50 个商贩，我会进行扩展！
- 安装新的/不同的 VendorXL 商贩MOD可能会改变它们的加载顺序……这可能导致库存混乱，因此库存刷新时间设为 1 游戏小时。使用现有商贩可能会将刷新时间改回类似 24 游戏小时：若发现商贩库存不正确/不符合预期，可跳过时间等待刷新修复。
- 加载顺序变化还可能导致工作点物品混乱，若看到商贩手持错误物品等情况，离开该区域并等待其重新生成后即可修复。
- V 的语音无法自定义，因此我将其设置为通用内容，适用于任何商店类型。
- 无法为 NPC 添加专属语音，因为他们的性别和整体角色都是可自定义的。
下载地址：
|
评分
-
1
查看全部评分
-
|
发表于 2025-8-3 15:56
收藏
楼主