更好的弹药限制框架

更好的弹药限制框架

自动弹药检测与容量系统,支持单独、全局和基于重量的限制。

描述

Better Ammo Limit Framework 是一个面向玩家和模组作者的灵活弹药容量框架。它能自动检测原版和模组添加的弹药类型,无需手动修补或显式支持。

对于模组作者,该框架包含一个兼容性系统,允许将特定弹药记录排除在容量管理之外,或为其指定推荐的默认上限。

主要特性

  • 兼容原版及添加弹药的模组。
  • 自动弹药检测:自动检测原版和模组添加的弹药类型,无需手动将其加入框架。
  • 独立弹药容量:为每种特定弹药类型强制执行独立、专属的容量上限。
  • 全局弹药容量:对所有受管理的弹药类型合并后强制执行一个共享的总容量上限。
  • 基于重量的容量:根据总重量限制你的弹药携带总量。兼容为弹药施加重量的模组。
  • 严格强制与溢出处理:容量上限会在弹药获取、制作、购买和商人转移过程中强制执行。如果从无法事先限制的来源获得了超出容量的弹药,多余部分会自动掉落至地面,而不是被删除。
  • 远程武器物品栏标签:可选为弹药物品分配 "[i]RangedWeapon"[/i] 标签,使其在物品栏中显示于武器标签页下而非一般物品中。默认启用,更改后需要重启游戏。

容量上限的交互方式

所有已启用的容量系统会同时生效。最严格的一项适用上限决定你还能携带多少额外弹药。

  • 独立 + 全局上限:若两者均启用,则两者都会强制执行。某种弹药的携带量永远不会超过其独立容量或剩余全局容量两者中的较小值。
    • 示例:在全局弹药上限为 600、独立弹药上限为 200 的情况下,携带 200 发手枪弹药后,还可携带最多 400 发任意其他弹药类型或其组合。
  • 所有系统启用:若独立、全局和基于重量的上限全部启用,则三者会同时强制执行。

达到某种弹药的独立容量上限并不会阻止你获取其他弹药类型,只会阻止该特定弹药类型超过其独立上限。

全局弹药容量限制你在所有受管理弹药类型上合并携带的子弹总数。

基于重量的容量限制你携带弹药的总重量。

哪项适用限制留下的剩余容量最少,就决定了还能携带多少额外弹药。

模组作者集成

Better Ammo Limit Framework 的设计使弹药模组无需对框架本身做任何更改即可与之集成。

任何兼容的弹药记录都会被框架自动检测。模组作者可以选择提供兼容性文件,以自定义其弹药与 BALF 的交互方式。

兼容性文件可以:

  • 排除不应由框架管理的弹药记录。
  • 为特定弹药类型提供推荐的默认容量上限。

模组作者集成通过 json 系统提供。只需创建一个指向 \bin\x64\plugins\cyber_engine_tweaks\mods\BaLF\Mod Integrations\"yourmodname".json 的文件/文件夹结构即可。

示例 .json

{
  "ammo": {
    "Ammo.HandgunAmmo": {
      "exclude": true,
      "defaultLimit": 1000
    },
    "Ammo.RifleAmmo": {
      "exclude": true,
      "defaultLimit": 1000
    },
    "Ammo.ShotgunAmmo": {
      "exclude": true,
      "defaultLimit": 200
    },
    "Ammo.SniperRifleAmmo": {
      "exclude": true,
      "defaultLimit": 100
    }
  }
}

玩家自定义的容量设置始终优先于兼容性提供的默认值。

这允许弹药模组提供合理的推荐容量,同时仍将最终配置完全交由玩家掌控。

安装说明

  1. 标准安装:像安装任何标准《赛博朋克 2077》模组一样,使用你偏好的模组管理器安装。
  2. 加载顺序:建议将 Better Ammo Limit Framework 加载在添加或修改弹药的模组之后,作为预防措施。在使用其他加载顺序进行测试时,未观察到与加载顺序相关的问题。
  • 容量强制执行以及制作/商人集成在开发时参考了 Much Better Ammo。物理溢出处理在开发时参考了 Ammo Limiter 对《赛博朋克》原生掉落物系统的使用。Expanded Ammo 被用作测试用例,以验证第三方弹药类型的动态获取与管理。