
合并站点兼容性框架
A framework that allows different items to be compatible with each other in the Combine Station 合成ステーションのアイテム互換性フレームワーク
查看大图※日本語の説明は下部にあります
Combine Station Compatibility Framework
本框架扩展了《7 Days to Die》的 Combine Station,允许具有不同 ItemClass 的兼容物品进行组合。
兼容性通过简单的 XML 属性定义,使武器和装备模组作者能够创建独立物品,同时不失去对 Combine Station 系统的访问。
## 特性
- 组合具有不同 ItemClass 的兼容物品
- 完全兼容和部分 Family 兼容
- 放置在第一个槽位的物品保留为结果物品
- 保留原版同物品组合行为
- 没有兼容性属性的物品保留正常原版行为
- 兼容武器、工具、护甲和其他具有品质的物品
- 可选的 Gears 世界设置用于 Family 转移效率
- 无自定义存档数据
## 工作原理
Combine Station 的第一个槽位是基础物品。
第二个槽位是捐赠物品。
结果物品始终保留基础物品的 ItemClass。
兼容性按以下顺序检查:
- 相同 ItemClass
- 匹配 CombineCompatibility
- 匹配 CombineFamily
- 不兼容
## 相同 ItemClass
使用原始原版 Combine Station 行为,不做修改。
## 完全兼容
具有匹配 CombineCompatibility 值的物品使用原版风格的完全合并。
品质、耐久度和随机物品属性使用正常的最佳值合并行为。
## Family 兼容
具有不同 Compatibility 值但匹配 CombineFamily 值的物品可用于部分改进。
品质和耐久度保留原版合并行为。
随机物品属性使用配置的转移率从基础值向更好的捐赠值移动。
```
Result = Base + (Donor - Base) × Transfer Rate
<br />如果舍入会阻止原本有效的改进,则应用一个内部属性点的最小改进,且不超过捐赠值。
<br />## 已安装的武器模组
<br />在组合具有不同 ItemClass 的物品之前,必须移除普通和外观武器模组。
<br />这可以防止不兼容的附件在无关物品定义之间转移。
<br />相同 ItemClass 组合保留正常的原版附件规则。
<br />## Gears 集成
<br />安装 Gears 后,以下世界设置可用:
<br />**Family Combine Transfer Rate**
<br />可用值:
<br />- 25%
<br />- 50%
<br />- 75%
<br />- 100%
默认值为 75%。
<br />如果未安装 Gears,框架使用:
<br />```
Config/FrameworkConfig.xml
```Gears 是可选的,不是必需的 DLL 依赖项。
<br />## 安装
<br />- 安装所需的 Harmony 框架。
<br />- 将此模组解压到游戏的 Mods 目录。
<br />- 确认生成的文件夹结构:
<br />```
7 Days To Die/
<br />└── Mods/
<br />└── 0F_FNK_CombineStationCompatibilityFramework/
<br />├── ModInfo.xml
<br />├── CombineStationCompatibilityFramework.dll
<br />└── Config/
```对于多人游戏,请在服务器和参与的客户端上都安装该框架。
<br />## 面向模组作者的 XML 用法
<br />向具有品质的物品添加一个或两个属性。
<br />```
<property name="CombineFamily" value="AR15"/>
<br /><property name="CombineCompatibility" value="AR15Standard"/>
```示例:
<br />```
<br /><item name="exampleM4">
<br /><!-- Existing item properties -->
<br /><property name="CombineFamily" value="AR15"/>
<br /><property name="CombineCompatibility" value="AR15Standard"/></item> [/CODE]
```共享 **AR15Standard** 的物品获得完全兼容。
<br />具有不同 Compatibility 值但相同 **AR15** Family 的物品获得部分 Family 兼容。
<br />属性值比较不区分大小写,但强烈建议保持一致拼写。
<br />空值或缺失值视为未定义。
<br />## 原版兼容性
<br />安装框架不会全局启用无关物品之间的组合。
<br />没有这些属性的物品行为与在原版中完全相同:
<br />- 相同 ItemClass:可组合
<br />- 不同 ItemClass:不可组合
若干明确可识别的原版枪械包含保守的兼容性定义。
<br />管式枪械被有意排除。
<br />## 卸载
<br />框架不会向生成的 ItemValues 添加自定义数据。
<br />之前通过框架组合的物品仍然是普通游戏物品。
<br />未安装框架时,自定义 XML 兼容性属性会被安全忽略。
<br />## 已知限制
<br />- 兼容性信息不显示在 Combine Station UI 中。
<br />- 已安装的普通或外观模组会阻止不同 ItemClass 组合。
<br />- 每个物品仅支持一个 Family 和一个 Compatibility 值。
<br />- 目前不支持 Family 特定速率和每物品覆盖。
<br />
<br />~以下日本語説明~
<br />Combine Station Compatibility Framework
<br />7 Days to DieのCombine Stationを拡張し、互換性が設定された異なるItemClass同士を合成可能にするフレームワークです。
<br />XMLプロパティによって互換関係を定義できるため、武器や装備を独立したItemClassとして実装しながら、同系統アイテムを合成素材として利用できます。
<br />## 主な機能
<br />- 異なるItemClass同士の合成
<br />- 完全互換とFamily互換の2段階判定
<br />- スロット1に置いたアイテムのItemClassを維持
<br />- 同一ItemClassの合成はバニラ処理を維持
<br />- 互換プロパティ未設定アイテムはバニラ挙動のまま
<br />- 武器、工具、防具など品質を持つアイテムへ利用可能
<br />- GearsによるFamilyカテゴリの合成効率のワールド設定
<br />- 独自セーブデータなし
<br />## 合成の仕組み
<br />Combine Stationの第1スロットが**Base Item**です。
<br />第2スロットが**Donor Item**です。
<br />合成結果は常にBase ItemのItemClassを維持します。
<br />互換性は次の順序で判定されます。
<br />1. 同一ItemClass
2. CombineCompatibility一致
3. CombineFamily一致
4. 互換性なし
<br />## 同一ItemClass
<br />変更を加えず、バニラのCombine Station処理をそのまま使用します。
<br />## 完全互換
<br />**CombineCompatibility**が一致するアイテムは、異なるItemClassでも完全互換として扱われます。
<br />品質、耐久、ランダムステータスは、バニラと同様に良い値を採用する形で合成されます。
<br />## Family互換
<br />CombineCompatibilityは異なるものの、**CombineFamily**が一致するアイテムは部分的な合成が可能です。
<br />品質と耐久はバニラの合成規則を使用します。
<br />ランダムステータスは、設定された転送率に応じてBaseの値からDonorの良い値へ近づきます。
<br />```
<br />結果 = Base + (Donor - Base) × 転送率
```Donorの値がBaseより悪い場合、そのステータスは変更されません。
<br />有効な改善が丸め処理によって失われる場合は、Donorの値を超えない範囲で内部ステータスを最低1ポイント改善します。
<br />ゲーム上「低いほど良い」と定義されているステータスについても、正しい改善方向で計算されます。
<br />## 装着パーツについて
<br />異なるItemClass同士を合成する場合、BaseまたはDonorに通常MODやCosmetic MODが一つでも装着されていると合成できません。
<br />異なる武器へ装着不能なパーツが移動することを防ぐための仕様です。
<br />合成前に両方のアイテムからパーツを取り外してください。
<br />同一ItemClass同士の合成では、従来のバニラ規則が使用されます。
<br />## Gears連携
<br />Gearsが導入されている場合、次のワールド設定が追加されます。
<br />**Family Combine Transfer Rate**
<br />選択可能な値:
<br />- 25%
<br />- 50%
<br />- 75%
<br />- 100%
デフォルトは75%です。
<br />Gearsが導入されていない場合は、次のファイルに設定された値を使用します。
<br />```
<br />Config/FrameworkConfig.xml
```Gearsは任意連携であり、必須のDLL依存関係ではありません。
<br />## 導入方法
<br />1. - 前提となるHarmony環境を導入します。
- 本MODをゲームのModsフォルダへ展開します。
2. 次のフォルダ構成になっていることを確認してください。
7 Days To Die/
└── Mods/
└── 0F_FNK_CombineStationCompatibilityFramework/
├── ModInfo.xml
├── CombineStationCompatibilityFramework.dll
└── Config/
<br />## MOD作者向けXML設定
<br />品質を持つ対象アイテムへ、次のプロパティの片方または両方を追加します。
<br />```
<br /><property name="CombineFamily" value="AR15"/>
<br /><property name="CombineCompatibility" value="AR15Standard"/>
```記述例:
<br />```
<br /><item name="exampleM4">
<br /><!-- 既存のアイテム定義 -->
<br /><property name="CombineFamily" value="AR15"/>
<br /><property name="CombineCompatibility" value="AR15Standard"/></item> [/CODE]
```**AR15Standard**が一致するアイテム同士は完全互換になります。
<br />CombineCompatibilityが異なっていても、**AR15** Familyが一致していればFamily互換として部分合成できます。
<br />プロパティ値は大文字と小文字を区別せず比較されますが、管理上は表記を統一することを推奨します。
<br />空文字またはプロパティ未設定は、互換関係なしとして扱われます。
<br />## バニラ互換性
<br />Frameworkを導入しただけで、無関係なアイテム同士が合成可能になることはありません。
<br />互換プロパティが設定されていないアイテムは、バニラと同じ挙動を維持します。
<br />- 同一ItemClass:合成可能
<br />- 異なるItemClass:合成不可
モデルを明確に確認できる一部のバニラ銃器には、保守的な互換定義が含まれています。
<br />パイプ銃は意図的に互換定義の対象外としています。
<br />## アンインストール
<br />Frameworkは生成されたItemValueへ独自データを追加しません。
<br />Frameworkを利用して合成したアイテムも、通常のゲームアイテムとして残ります。
<br />アイテムXMLに互換プロパティが残っていても、Frameworkが導入されていない環境では安全に無視されます。
<br />## 既知の制限
<br />- Combine StationのUIには互換種別や転送率が表示されません。
<br />- 通常MODまたはCosmetic MOD装着中は、異なるItemClass同士を合成できません。
<br />- 各アイテムに設定できるFamilyとCompatibilityはそれぞれ1種類です。
<br />- Familyごとの転送率やアイテム単位の倍率上書きには未対応です。
<br />
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。