Affliction Text Framework (ATF)
这是一个提供给MOD作者使用的底层前置框架，用于扩展和优化潜渊症的 Affliction 文本描述功能。
This is a core framework for modders to expand and optimize Affliction descriptions.
普通玩家：如果其他MOD提示需要此项，直接订阅并在模组列表中启用即可。
然后你可以离开此页面了，享受渊深。
For Players: Just subscribe and enable it if required by other mods.
Then you can leave this page and enjoy games.
对于MOD作者 / For Modders:
⚠️ 重要声明 (Important Note):
1.由于Steam简介的系统限制，下文演示中的大括号 { } ，在你的实际XML代码中请务必替换为标准的英文中括号 [ ] ！！
Due to Steam formatting limits, please replace all curly braces { } below with standard square brackets [ ] in your actual XML code!!
2. 游戏本身并不会对未使用的文本或额外的 XML 文件类型做检测：被声明为 Other 类型的 BuffRelations.xml 文件，以及本地化文本中本模组用于适配的 <…_cs> 标签，绝对不会引发任何形式的红字报错。
也就是说：即使你的 MOD 适配了本 ATF 框架，但玩家并没有订阅本框架，你的 MOD 依然能原样正常运行，不会产生报错。
The base game does not check for unused texts or extra XML file types. Therefore, the BuffRelations.xml file declared as Other, and the custom <…_cs> tags in your localization, will NEVER cause any red error logs.
In other words: Even if your mod is fully adapted to the ATF framework, if a player hasn't subscribed to this framework, your mod will also run perfectly without any errors.
本框架为原版 Affliction 系统提供了以下扩展功能：
This framework provides the following features:
1. 动态变量与数学运算 / Dynamic Variables & Math
允许直接在 `<afflictiondescription>` 文本中使用表达式进行计算：
Allows using expressions directly in `<afflictiondescription>` text:
- {amount} 或 {=int_strength}：Affliction强度的整数（向下取整） / Affliction Int Strength (rounded down)。
- {=strength}：带小数的精确强度。 / Float Strength
- {=strength * 2.5}：支持简单的四则运算（+ - * /）。 / Simple arithmetic operations (+ - * /).
<!-- 示例（来自 `浊心斯卡蒂` MOD ） -->
<!-- Example (From `Skadi the Corrupting Heart` MOD) -->
<afflictiondescription.AgorSkadi_cs>‖color:gui.green‖+{amount}%‖end‖ ‖color:gui.orange‖游泳速度‖end‖</afflictiondescription.AgorSkadi_cs>
2. 三元条件判断 / Ternary Conditions
支持根据强度动态改变输出的文本。格式：{=条件 ? 真值 : 假值}
Supports dynamic text output based on strength. Format: {=condition ? true : false}
为了防止XML标签报错，请使用英文缩写代替符号：lt(<), lte(<=), gt(>), gte(>=), eq(==), neq(!=)。
To prevent XML tag errors, please use English abbreviations instead of symbols: lt (<), lte (<=), gt (>), gte (>=), eq (==), neq (!=).
<!-- 示例：当强度等于100时显示MAX，否则显示具体数字 -->
<!-- Example: Display MAX when the Strength is 100, otherwise display the specific number. -->
<afflictiondescription.Example1_cs>强度：{=strength eq 100 ? MAX : strength}</afflictiondescription.Example1_cs>
<!-- 示例：当强度等于100时显示ON，否则不显示 -->
<!-- Example: Display "ON" when Strength is 100; otherwise, the output is empty. -->
<afflictiondescription.Example1_cs>{=strength eq 100 ? ON : }</afflictiondescription.Example1_cs>
<afflictiondescription.Example1_cs>{=strength eq 100 ? ON : Null}</afflictiondescription.Example1_cs>
<afflictiondescription.Example1_cs>{=strength eq 100 ? ON : Empty}</afflictiondescription.Example1_cs>
<!-- 留空、NULL 或 Empty 均可 / Leaving blank, or NULL or Empty, are all acceptable. -->
<!-- 示例：根据强度改变文字颜色 -->
<!-- <!-- Example: Change text color based on Strength --> -->
<afflictiondescription.Example2_cs>状态：{=strength gt 50 ? ‖color:gui.green‖安全‖color:end‖ : ‖color:gui.red‖危险‖color:end‖}</afflictiondescription.Example2_cs>
<!-- 示例（来自 `浊心斯卡蒂` MOD ） -->
<!-- Example (From `Skadi the Corrupting Heart` MOD) -->
<afflictiondescription.WaveSaltWind_cs>抵抗‖color:gui.green‖{=int_strength}%‖end‖ ‖color:gui.orange‖水流冲击‖end‖，‖color:gui.green‖+{=strength lt 15f ? 50% : 100%}%‖end‖ ‖color:gui.orange‖游泳速度‖end‖</afflictiondescription.WaveSaltWind_cs>
3. 子状态合并与UI图标隐藏 / Sub-affliction Merging & UI Hiding
可以将多个附属 Buff 的文本自动拼接到主 Buff 的描述中，并在游戏界面彻底隐藏这些子 Buff 的图标，保持UI整洁。
Automatically appends sub-affliction texts to the main affliction and hides their HUD icons to keep the UI clean.
如何接入 / How to integrate :
在你自己的MOD中新建一个以 BuffRelations.xml 结尾的文件（例如 MyMod_BuffRelations.xml）。
Create a file ending with "BuffRelations.xml" in your mod.
<?xml version="1.0" encoding="utf-8"?>
<BuffRelations>
<!-- identifier填主Buff，subbuffs填子Buff，separator为拼接符(留空默认换行) override则用于覆盖(不写或者为false则默认向`主buff`追加) -->
<MainBuff identifier="你的主Buff_ID" subbuffs="子Buff_1, 子Buff_2" separator=" " override="true"/>
</BuffRelations>
<!-- 示例（来自 `浊心斯卡蒂` MOD ） -->
<!-- Example (From `Skadi the Corrupting Heart` MOD) -->
<?xml version="1.0" encoding="utf-8"?>
<BuffRelations>
<!-- 同葬无光之愿(腐化之心-无限) -->
<MainBuff identifier="CorruptedHeart_Active" subbuffs="NamelessSea, LostFlagship, TideShadow" />
<!-- 同葬无光之愿(普通) -->
<MainBuff identifier="Skadi_CH_buff_SkadiWishes" subbuffs="NamelessSea, LostFlagship, TideShadow" />
<!-- 同归殊途之吟 -->
<MainBuff identifier="SkadiChant_TidalMemories" subbuffs="WaveSaltWind, ProfoundMourning" />
</BuffRelations>
⚠️ 注意：必须在你的 filelist.xml 中将其作为 <Other /> 引用，否则框架无法读取BuffRelations.xml文件！
Note: You must reference it as <Other /> in your filelist.xml file; otherwise, the framework will not be able to read BuffRelations.xml!
<Other file="%ModDir%/MyMod_BuffRelations.xml" />
范例文件以及更多说明请参考本MOD目录下的 Example_BuffRelations.xml 和 Example_Localization_zh.xml，当然，你也可以看看上面提示到的` 浊心斯卡蒂 ` MOD。
For example files and further instructions, please refer to Example_BuffRelations.xml and Example_Localization_en.xml in the MOD directory, and you can also check out the ` Skadi the Corrupting Heart ` MOD mentioned above.
模组造船：200300947
