模组简介

VendorsXL 是针对《赛博朋克2077》开发的自定义户外商铺扩展框架类模组，本身不会直接向游戏内添加任何预设的新商贩NPC，核心作用是为其他模组创作者提供一套标准化的、基于 TweakDB 接口的商贩生成规则，让模组制作者无需从零开始调试商贩生成逻辑，就能快速向夜之城的任意位置添加符合自己模组内容设定的专属商贩，普通玩家安装该模组后，只有同时搭配使用该框架开发的第三方商贩模组，才能体验到各类新增的自定义商铺内容，不管是想要在夜之城偏僻角落找到隐藏装备店，还是在剧情模组里对接专属交易NPC，都可以通过该框架实现。

功能要点

  • 支持高度自定义商贩的工作站位与 idle 动画，玩家可以指定商贩站立、倚靠、使用设备等各类预设工作点资源，无需受原版游戏商贩的动作模板限制
  • 允许完全自定义商贩的人物外观与身份，可以直接调用游戏原版或其他模组制作的任意类人型实体与外观资源，生成符合场景设定的专属NPC商贩，不过暂不支持非人形角色的商贩逻辑适配
  • 全面自定义商贩的标识信息，包括NPC的显示名称、玩家扫描时弹出的提示文本、互动时的界面名称，还能自定义地图与小地图上的对应图标，内置8种不同类型的商铺图标可选，包含无图标的隐藏模式，其中AutoFixer类图标会单独归类到地图筛选器的专用分组中，不会和其他普通商贩图标混排
  • 支持完全自定义商贩卖售的货品清单，既可以手动逐一添加指定物品ID生成专属货物列表，也可以直接复用游戏原版或其他模组已经定义好的商贩库存模板，省去重复配置货品的步骤
  • 支持直接指定商贩在游戏世界中的精确三维坐标与旋转角度，将NPC放置在夜之城任意可到达的区域内，玩家靠近时商贩会自动转向面对V，首次靠近互动时还会触发专属的V的语音台词，且语音触发带有基于距离的冷却机制，多个距离过近的商贩不会重复触发同一段语音造成体验割裂

前置依赖

运行该模组需要先在游戏环境中安装 TweakXL、ArchiveXL、Red4ext、Codeware、Redscript 以及 Deceptious Quest Core 这些必备的底层支持组件，所有组件的安装要求均符合《赛博朋克2077》模组运行的通用规范，若未安装任意一个前置组件，该模组将无法正常加载生效。

安装方法

手动解压模组主压缩包之后，将得到的对应文件按规则放入指定路径：首先将对应的 .archive 和 .archive.xl 文件放入 Cyberpunk 2077archivepcmod 文件夹中；之后将解压出的 VendorsXL 文件夹连同内部文件一同放入 Cyberpunk 2077
6scripts 文件夹；最后将命名为 ##########VendorsXL 的文件夹连同内部文件放入 Cyberpunk 2077
6 weaks 文件夹，文件夹名里的多个#符号属于命名要求的必要部分，不能随意修改，否则会导致 Tweak 资源加载顺序出错，直接影响模组的正常运行。如果是首次在当前存档中安装使用 Deceptious Quest Core 相关组件，需要前往 H10 公寓完成触发步骤，若之前已经通过H10完成过 Deceptious Quest Core 的初始触发流程，安装 VendorsXL 后可以直接正常使用全部功能，无需重复触发。开发者使用该框架制作自定义商贩时，需要自行创建带有唯一标识的 Tweak 记录，yaml 文件的命名规则要保证不会加载在 ##########VendorsXL 相关文件之前，避免配置数据覆盖失效。

注意事项与兼容性说明

该模组没有修改游戏的任何原版核心文件，本身不存在和其他常规模组的原生冲突问题，早期版本最多支持同时加载50个自定义商贩，2.2.0 及之后的版本将支持上限提升至120个，如果玩家安装了太多基于该框架开发的商贩类模组，超出当前版本的商贩数量上限，超出部分的商贩将无法正常生成，游戏内会自动弹出对应提示告知玩家。安装新的使用 VendorsXL 开发的商贩模组后，可能会改变原有商贩的加载顺序，短暂出现商贩库存错乱、手持道具错位的异常情况，该模组默认将商贩库存刷新间隔设置为1个游戏小时，遇到这类问题只需要原地等待游戏时间推进或直接跳过对应时长的时间，库存就会自动恢复正常，道具错位的问题只要离开该区域一段时间让NPC重新生成也会自行修复。该模组本身没有内置自定义文本内容，仅在极端错误场景下会弹出一段硬编码的提示弹窗，支持游戏当前所有的语言版本。卸载该模组时，只需要从 Cyberpunk 2077
6 weaks 和 Cyberpunk 2077
6scripts 两个路径下删除对应的 VendorsXL 文件夹，再从 Cyberpunk 2077archivepcmod 路径下删除对应的 VendorsXL.archive.xl 文件即可，剩余的 VendorsXL.archive 文件本身属于无害资源，但若在存档已使用过该模组的情况下彻底删除该文件，后续重新安装该模组时可能会出现无法正常读取存档配置的问题。如果遇到运行异常需要重置模组，可通过 Deceptious Quest Core 附带的工具设置界面里的专用重置按钮完成操作，重置完成后重新前往 H10 公寓即可重新触发模组初始化流程。

常见问题

  • 安装完该模组之后游戏内看不到任何新商贩是怎么回事？该模组本身属于开发框架，不自带任何预设商贩内容，需要额外搭配使用该框架制作的第三方商贩模组，才能看到新增的自定义NPC商贩。
  • 配置的自定义商贩不生成该怎么排查？首先确认 Tweak 配置文件的加载顺序在 ##########VendorsXL 之后，同时确认自定义商贩的ID没有和其他模组的商贩ID重复冲突，还要检查当前加载的商贩总数没有超出对应版本的上限。
  • 能不能直接把原版游戏的商贩替换成自定义内容？该模组属于新增商贩的扩展框架，本身不会改动原版商贩的任何配置内容，想要替换原版商贩需要额外的针对性修改模组配合才能实现。