VendorsXL 封面

VendorsXL

赛博朋克2077模组作者资源

通过简单的 TweakDB/TweakXL 记录支持自定义游戏内商贩

预览

前置 Mod

详情

基础:

通过简单的 TweakDB/TweakXL 记录支持自定义游戏内商贩

自定义商贩功能:

  • 可自定义工作点(workspot)——商贩拥有的动画/待机动作
  • 可自定义角色/外观——NPC 是谁以及他们长什么样
  • 可自定义商贩名称——扫描时和提示中显示的名称
  • 可自定义库存——可以是物品列表,也可以是预定义的 Vendor(基础游戏或 mod 添加的)
  • 可自定义地图/小地图图标——有 8 个图标可供选择,也可以选择无(AutoFixer 在地图筛选器中有自己的类别,不与其他商贩放在一起)
  • 可自定义位置/旋转——NPC 在世界中出现的位置

当玩家靠近商贩时,商贩会看向玩家;V 每次首次接近他们时,都会有一句与他们交谈的语音台词。

(语音有一个基于距离的共享冷却,所以如果多个商贩彼此靠得很近,你在离开第一个你对其说过话的商贩之前,只会说一次这句台词)

如何“使用”这个 mod? [用户]

只需安装它,以及任何使用它的 mod*!

如果这是(在你的存档中)第一次安装/使用 Deceptious Quest Core,那么请前往 H10 公寓以启动(如果你已经通过 H10 启动过 DQC,那么 VendorsXL 将立即启动)

*这个 [VendorsXL] mod 本身不会添加任何商贩!!它是为了让其他 mod 作者为他们的 mod/商店创建/添加新商贩

如何“使用”这个 mod? [MOD 作者]

只需在你的 mod 中包含一个基于模板的新 tweak,并使用唯一的名称和自定义值

这甚至可以包含在现有的 .yaml 文件中。

tweak 的名称必须唯一,但所有其他值都可以共享(不过,尽量不要把你的商贩放在彼此重叠的位置……)

确保你的 yaml 文件/文件夹命名使其不会在 '##########VendorsXL' 之前加载,否则你的 tweak 将无法正确加载。

显示名称可以是任何现有的或新的 LocKey——但你必须自己创建新的 LocKey,作为你的 mod 的一部分。

Workspot 可以是任何 workspot,但你有责任选择一个你的角色/实体所支持的工作点。它也不一定是站立姿态。

实体和外观可以是任何现有的或 mod 添加的实体和外观——这些值可以在 tweak 数据库中现有 Character 记录的相同变量中找到。

(该 mod 仅假定适用于人形角色,非人形角色可能无法工作——我没能让基础游戏中的 Brendan 正常工作……)

请查看文件区,获取一个可选的 zip 文件,其中包含模板(如下所示)以及一个包含 3 个商贩设置的示例 yaml(这些商贩设置在 Stadium 入口外的停车场)

模板(包含在 mod 文件区中):

Character.<your unique atelier/mod/id name>:
  $base: Character.vendorsxl_base
  #Entity and appearance setup for your vendor/npc [default is the Kabuki Gun Vendor]:
  appearanceName: None
  entityTemplatePath: base\open_world\characters\vendors\wat_kab_gun_trainer_01.ent
 
  #Naming [default is 'Vendor']:  
  displayName: LocKey#15525
 
  #Workspot file [default is standing using a tablet]:
  holocallInitializerPath: base\workspots\common\ground\generic__stand_ground_tablet__use__01.workspot
 
  #Location data [REQUIRED]
  bossHealthBarThresholds: [<x>, <y>, <z>, <i>, <j>, <k>, <r>]
#Position data         x,   y,   z,
#and Rotation data (quaternions)        i,   j,   k,   r
#Example: [-1286.9, -1686.1, 44.2, 0.0, 0.0, -0.615, -0.787]
#CET Command to get these values where V is standing:
#   print(GetPlayer():GetWorldPosition()) print(GetPlayer():GetWorldOrientation())
 
  #Your vendors items, edit and expand:
  items:
- Items.<first>
- Items.<second>
- Items.<third>
#Example: - Items.CasualShoes_07_rich_02
 
  #Existing Vendor ID; change if you wish to use an existing game vendor inventory, NOT your own.
  #Do not edit if using custom stock/items above.
  vendorID: Vendors.vendorxl_custom
 
  #Mappin icon on maps, default: Clothing
  forcedTBHZOffset: 1
  # 0: No mappin /  hidden
  # 1: Clothing
  # 2: Guns
  # 3: Food
  # 4: Bar
  # 5: Melee
  # 6: Medical
  # 7: Junk
  # 8: Netrunner
  # 9: AutoFixer

支持我:

真的很喜欢我的 mod?:

Ko-Fi: Deceptious或

Patreon: Deceptious

如何重置这个 mod?

你可以使用 Deceptious Quest Core Utilities and Settings 来重置 VendorsXL,此时你需要重新进入 H10 公寓才能再次启动商贩(Mappin 不会重置/消失)

安装:

只需将主 .zip 文件解压到 "Cyberpunk 2077" 文件夹中,使 .archive 和 .archive.xl 文件最终位于 "Cyberpunk 2077\archive\pc\mod" 文件夹中。

这将使 VendorsXL 文件夹及其包含的文件位于 "Cyberpunk 2077\r6\scripts" 文件夹中。

这还将使 ##########VendorsXL 文件夹及其包含的文件位于 "Cyberpunk 2077\r6\tweaks" 文件夹中。

文件夹和文件名中的 # 号很重要,因为其中定义的某些 tweak 必须在任何其他 mod 之前加载。

重置以排查问题/调试/修复问题:

你可以使用 Deceptious Quest Core Utilities and Settings 来“重置”该 mod,在其 Native Settings UI 菜单中有一个按钮,这会停止该 mod,然后你可以通过重新访问 H10 公寓来重新激活它,就像全新安装一样

需求:

TweakXL、ArchiveXL 和 Red4ext

Codeware 和 Redscript

Deceptious Quest Core [自 v2.0.0 起]

卸载:

只需从 "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 就会弹出,到时候如果我没有已经扩展它,我就必须扩展它!

问题/限制:

2.2.0 限制为 120 个商贩,我可以/将会扩展这个限制!

安装新的/不同的 VendorXL 商贩 mod 可能会改变它们的加载顺序……

这可能会打乱它们的库存;因此它们的库存刷新时间被设置为游戏内 1 小时。使用现有商贩可能会将其改回大约游戏内 24 小时:如果你看到某个商贩的库存不正确/不符合预期,你可以跳过时间让它刷新并自行修复。

它们也可能打乱它们的工作点物品;如果你看到这样的商贩手上或某个部位附着错误的物品,当你离开该区域并且它们重新生成后,这会得到修复。

V 的语音不适合自定义,所以我把做成了通用的,这样它适用于任何商店类型。

NPC 实际上无法获得任何语音,因为它们的性别和整个角色都是可自定义的

Bug

如果有人在问题/限制所列内容之外发现任何 bug,请告诉我!