Attributification [Attribute Unification]

模组

· 作者 UtherHel

将来自不同模组的相似属性统一,并支持可配置的转换系数,以防止重复和提升兼容性。

0 本站下载 0 关注 更新于 7 个月前

需要前置:Architectury API、Fzzy Config

最新 2.0.5 · 1.21.1 · Fabric

一键开服(送7天)

主要特性

  • 游戏内配置 GUI – 在游戏内直接编辑映射,支持自动生成图形界面
  • 静态与动态映射 – 静态映射使用注册表别名进行简单的 1:1 转换(需要重启),动态映射使用运行时转换并支持完整缩放功能(可重载)
  • 属性转换 – 使用可配置的比率将源属性修饰符转换为目标属性
  • 单向模式 – 控制源属性是显示虚拟值还是直接重定向到目标属性
  • 运算转换 – 将 ADDITION(加法)修饰符转换为 MULTIPLY_BASE/MULTIPLY_TOTAL(乘法基础/总乘)以实现正确的缩放
  • 回退支持 – 如果主目标模组缺失,则映射到次要属性
  • 完全替换模式 – 完全替换特定属性,以防止“双重叠加”导致的平衡问题
  • 实时重载 – 动态映射更改在重新登录时立即生效(无需完全重启游戏)
  • 客户端-服务器同步 – 服务器配置自动同步给所有已连接的客户端

工作原理

效果(effects)使用布尔检查,而属性(attributes)存储数值。Attributification 通过以下方式处理这一差异:

  1. 修饰符转换:物品修饰符在应用时从源转换为目标
  2. 虚拟显示:/attribute get 命令显示基于目标计算出的虚拟值(当 unidirectional=false 时)
  3. 属性重定向:对源属性的查找请求会重定向到目标属性
  4. 运算转换:ADDITION(加法)修饰符可以转换为 MULTIPLY_BASE(乘法基础)以基于百分比进行缩放

单向模式

Unidirectional = false(默认):

  • 源属性显示虚拟值:source = target × equivalence
  • /attribute get source 返回基于目标计算的值
  • 适用于大多数需要视觉一致性的情况

Unidirectional = true:

  • 源属性不显示虚拟值
  • 不进行乘法运算的直接重定向
  • 适用于希望源属性直接显示目标值的情况

支持的模组(开箱即用)

注意: 预配置的映射仅包含在 Forge 版本中。Fabric 用户初始配置为空,因为默认映射中的大多数目标模组在 Fabric 上不可用。您可以通过游戏内 GUI 或配置文件为兼容 Fabric 的模组添加自定义映射。

配置

游戏内 GUI

通过以下路径访问配置 GUI:

  • Fabric:Mod Menu → Attributification → Config 按钮
  • Forge:Mods 列表 → Attributification → Config 按钮

GUI 提供以下功能:

  • 可视化编辑器 – 使用用户友好的界面编辑所有映射
  • 属性建议 – 下拉列表显示所有已注册的属性
  • 实时预览 – 无需重启即可立即查看更改
  • 字段工具提示 – 悬停在字段上可查看详细解释
  • 列表摘要 – 快速概览列表中的每个映射

配置文件

配置文件位置:config/attributification/attributification.toml

配置系统支持:

  • 静态映射 – 启动时的注册表别名(需要重启,仅限简单 1:1 映射)
  • 动态映射 – 运行时属性转换(可通过重新登录重载,支持缩放)
  • 等价比率 – 定义不同属性值之间的精确缩放比例
  • 运算转换 – 在 ADDITION(加法)和 MULTIPLY_BASE/MULTIPLY_TOTAL(乘法)之间切换逻辑
  • 单向模式 – 控制源属性是显示虚拟值还是直接重定向
  • 完全替换 – 冻结源属性以防止双重叠加
  • 回退链 – 定义多个目标属性:"primary, fallback1, fallback2"
  • 自定义映射 – 为任何使用标准 Minecraft 属性系统的模组添加支持
  • 自动迁移 – 旧配置文件会自动转换为最新格式

从旧版本迁移

升级时:

  1. 您的旧配置会自动转换为最新格式
  2. 所有自定义映射都会保留
  3. 旧配置会以 .old 扩展名备份
  4. 无需手动操作!
示例 1:静态映射(注册表别名)
[[staticMappings]]
sourceAttribute = "spell_power:haste"
targetAttribute = "irons_spellbooks:cast_time_reduction"

发生的情况:

  • 注册表级别别名:spell_power:haste 成为 irons_spellbooks:cast_time_reduction 的别名
  • 简单的 1:1 映射,无转换选项
  • 需要重启游戏才能应用更改
  • 仅在属性具有相同刻度(1:1 比率)时使用
  • 对于具有不同刻度的属性(例如 100:1),请改用动态映射
示例 2:带有运算转换的动态映射

效果说明:

  • 带有 +6 spell_power:earth ADDITION(加法)的物品 → 转换为 +0.3 geo_spell_power MULTIPLY_BASE(乘算基底)(增加 30%)
  • /attribute get spell_power:earth 显示虚拟值:geo_spell_power × 3.0
  • 如果未安装 GTBC 的 Geomancy Plus,则回退到 irons_spellbooks:nature_spell_power
  • Unidirectional=false:源属性会显示由目标属性计算得出的虚拟值
  • 更改在重新登录后生效(无需重启游戏)
示例 3:完全替换以防止双重叠加
[[dynamicMappings]]
sourceAttribute = "obscure_api:critical_hit"
targetAttribute = "attributeslib:crit_chance"
equivalence = 1.0
conversionEquivalence = 0.0
unidirectional = false
onlyVisualChange = false
fullReplacement = true
subtractValue = 0.0
operationConversion = "DEFAULT"

效果说明:

  • 源属性被“冻结”在基础值(修饰符被阻止生效)
  • 仅目标属性生效,防止两者同时叠加
  • /attribute get obscure_api:critical_hit 仅显示基础值
  • 解决了因两个属性同时叠加而导致效果翻倍的问题
示例 4:仅视觉更改
[[dynamicMappings]]
sourceAttribute = "some_mod:visual_attribute"
targetAttribute = "minecraft:generic.attack_damage"
equivalence = 1.0
conversionEquivalence = 0.0
unidirectional = false
onlyVisualChange = true
fullReplacement = false
subtractValue = 0.0
operationConversion = "DEFAULT"

效果说明:

  • 源属性重命名为目标属性,但不进行数值转换
  • 带有 +10 some_mod:visual_attribute 的物品将显示为 +10 minecraft:generic.attack_damage
  • 无修饰符转换,仅更改显示名称
  • 适用于外观统一

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源