主要特性
- 游戏内配置 GUI – 在游戏内直接编辑映射,支持自动生成图形界面
- 静态与动态映射 – 静态映射使用注册表别名进行简单的 1:1 转换(需要重启),动态映射使用运行时转换并支持完整缩放功能(可重载)
- 属性转换 – 使用可配置的比率将源属性修饰符转换为目标属性
- 单向模式 – 控制源属性是显示虚拟值还是直接重定向到目标属性
- 运算转换 – 将 ADDITION(加法)修饰符转换为 MULTIPLY_BASE/MULTIPLY_TOTAL(乘法基础/总乘)以实现正确的缩放
- 回退支持 – 如果主目标模组缺失,则映射到次要属性
- 完全替换模式 – 完全替换特定属性,以防止“双重叠加”导致的平衡问题
- 实时重载 – 动态映射更改在重新登录时立即生效(无需完全重启游戏)
- 客户端-服务器同步 – 服务器配置自动同步给所有已连接的客户端
工作原理
效果(effects)使用布尔检查,而属性(attributes)存储数值。Attributification 通过以下方式处理这一差异:
- 修饰符转换:物品修饰符在应用时从源转换为目标
- 虚拟显示:
/attribute get 命令显示基于目标计算出的虚拟值(当 unidirectional=false 时)
- 属性重定向:对源属性的查找请求会重定向到目标属性
- 运算转换:ADDITION(加法)修饰符可以转换为 MULTIPLY_BASE(乘法基础)以基于百分比进行缩放
单向模式
Unidirectional = false(默认):
- 源属性显示虚拟值:
source = target × equivalence
/attribute get source 返回基于目标计算的值
- 适用于大多数需要视觉一致性的情况
Unidirectional = true:
- 源属性不显示虚拟值
- 不进行乘法运算的直接重定向
- 适用于希望源属性直接显示目标值的情况
支持的模组(开箱即用)
注意: 预配置的映射仅包含在 Forge 版本中。Fabric 用户初始配置为空,因为默认映射中的大多数目标模组在 Fabric 上不可用。您可以通过游戏内 GUI 或配置文件为兼容 Fabric 的模组添加自定义映射。
-
魔法与法术:Iron's Spells 'n Spellbooks ↔ Spell Power Attributes, Ars Nouveau, Eidolon, Goety, Wizard's Reborn
-
核心库:Apothic Attributes ↔ Obscure API, Turtleboi's Core Library, GTBC's SpellLib/API, Lodestone
-
涉及的所有模组 ID:spell_power, irons_spellbooks, traveloptics, gtbcs_geomancy_plus, attributeslib, ranged_weapon, eidolon, more_rpg_classes, obscure_api, turtlecore, gtbcs_spell_lib, goety, ars_nouveau, lodestone, wizards_reborn, iter_rpg
配置
游戏内 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 属性系统的模组添加支持
- 自动迁移 – 旧配置文件会自动转换为最新格式
从旧版本迁移
升级时:
- 您的旧配置会自动转换为最新格式
- 所有自定义映射都会保留
- 旧配置会以
.old 扩展名备份
- 无需手动操作!
示例 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
- 无修饰符转换,仅更改显示名称
- 适用于外观统一
Key Features
- In-Game Configuration GUI – Edit mappings directly in-game with automatic GUI generation
- Static & Dynamic Mappings – Static mappings use registry aliasing for simple 1:1 conversions (requires restart), dynamic mappings use runtime conversion with full scaling support (reloadable)
- Attribute Conversion – Converts source attribute modifiers to target attributes using configurable ratios
- Unidirectional Mode – Control whether source shows virtual values or redirects directly to target
- Operation Conversion – Transform ADDITION modifiers to MULTIPLY_BASE/MULTIPLY_TOTAL for proper scaling
- Fallback Support – Maps to secondary attributes if a primary target mod is missing
- Full Replacement Mode – Completely replaces specific attributes to prevent "double-dipping" balance issues
- Real-Time Reload – Dynamic mapping changes apply immediately with relog (no full restart needed)
- Client-Server Sync – Server config automatically syncs to all connected clients
How It Works
Unlike effects which use boolean checks, attributes store numeric values. Attributification handles this by:
- Modifier Conversion: Item modifiers are converted from source to target at application time
- Virtual Display:
/attribute get commands show virtual values calculated from the target (when unidirectional=false)
- Attribute Redirection: Source attribute lookups redirect to target attribute
- Operation Transformation: ADDITION modifiers can be converted to MULTIPLY_BASE for percentage-based scaling
Unidirectional Mode
Unidirectional = false (default):
- Source shows virtual value:
source = target × equivalence
/attribute get source returns calculated value from target
- Use for most cases where you want visual consistency
Unidirectional = true:
- Source does NOT show virtual value
- Direct redirection without multiplication
- Use when you want source to show target value directly
Supported Mods (Out-of-the-box)
Note: Pre-configured mappings are included only in the Forge version. Fabric users start with an empty config because most target mods in the default mappings are not available on Fabric. You can add your own mappings for Fabric-compatible mods via the in-game GUI or config file.
-
Magic & Spells: Iron's Spells 'n Spellbooks ↔ Spell Power Attributes, Ars Nouveau, Eidolon, Goety, Wizard's Reborn
-
Core Libraries: Apothic Attributes ↔ Obscure API, Turtleboi's Core Library, GTBC's SpellLib/API, Lodestone
-
All modids involved: spell_power, irons_spellbooks, traveloptics, gtbcs_geomancy_plus, attributeslib, ranged_weapon, eidolon, more_rpg_classes, obscure_api, turtlecore, gtbcs_spell_lib, goety, ars_nouveau, lodestone, wizards_reborn, iter_rpg
Configuration
In-Game GUI
Access the configuration GUI through:
- Fabric: Mod Menu → Attributification → Config button
- Forge: Mods list → Attributification → Config button
The GUI provides:
- Visual Editor – Edit all mappings with a user-friendly interface
- Attribute Suggestions – Dropdown lists of all registered attributes
- Real-Time Preview – See changes immediately without restarting
- Field Tooltips – Hover over fields for detailed explanations
- List Summaries – Quick overview of each mapping in the list
Configuration File
Config location: config/attributification/attributification.toml
The configuration system supports:
- Static Mappings – Registry aliasing at startup (requires restart, simple 1:1 only)
- Dynamic Mappings – Runtime attribute conversion (reloadable with relog, supports scaling)
- Equivalence Ratios – Define exact scaling between different attribute values
- Operation Conversion – Switch logic between ADDITION and MULTIPLY_BASE/MULTIPLY_TOTAL
- Unidirectional Mode – Control whether source shows virtual values or redirects directly
- Full Replacement – Freeze source attribute to prevent double-dipping
- Fallback Chains – Define multiple target attributes:
"primary, fallback1, fallback2"
- Custom Mappings – Add support for any mod utilizing the standard Minecraft attribute system
- Automatic Migration – Old configs are automatically converted to the latest format
Migration from Older Versions
When upgrading:
- Your old config is automatically converted to the latest format
- All your custom mappings are preserved
- Old config is backed up with
.old extension
- No manual action required!
Example 1: Static Mapping (Registry Aliasing)
[[staticMappings]]
sourceAttribute = "spell_power:haste"
targetAttribute = "irons_spellbooks:cast_time_reduction"
What happens:
- Registry-level aliasing:
spell_power:haste becomes an alias for irons_spellbooks:cast_time_reduction
- Simple 1:1 mapping without conversion options
- Requires game restart to apply changes
- Use only when attributes have identical scales (1:1 ratio)
- For attributes with different scales (e.g., 100:1), use dynamic mappings instead
Example 2: Dynamic Mapping with Operation Conversion
[[dynamicMappings]]
sourceAttribute = "spell_power:earth"
targetAttribute = "gtbcs_geomancy_plus:geo_spell_power, irons_spellbooks:nature_spell_power"
equivalence = 3.0
conversionEquivalence = 20.0
unidirectional = false
onlyVisualChange = false
fullReplacement = false
subtractValue = 0.0
operationConversion = "ADDITION_TO_MULTIPLY_BASE"
What happens:
- Item with
+6 spell_power:earth ADDITION → converted to +0.3 geo_spell_power MULTIPLY_BASE (30% increase)
/attribute get spell_power:earth shows virtual value: geo_spell_power × 3.0
- If GTBC's Geomancy Plus is not installed, falls back to
irons_spellbooks:nature_spell_power
- Unidirectional=false: source shows virtual value calculated from target
- Changes apply with relog (no restart needed)
Example 3: Full Replacement to Prevent Double-Dipping
[[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"
What happens:
- Source attribute is "frozen" at base value (modifiers are blocked)
- Only target attribute works, preventing both from stacking
/attribute get obscure_api:critical_hit shows base value only
- Solves balance issues where both attributes would stack for double effect
Example 4: Visual Change Only
[[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"
What happens:
- Source attribute is renamed to target without value conversion
- Item with
+10 some_mod:visual_attribute shows as +10 minecraft:generic.attack_damage
- No modifier conversion, only display name changes
- Useful for cosmetic unification
评论 0
登录后参与评分
还没有评论,来抢沙发吧