SimplySmith

SimplySmith adds gear quality, random affixes, enhancement, and quality breakthroughs.

How it works

Equipment receives a quality and a set of affixes when it first enters a player's inventory. Affixes only take effect while the item is held or equipped. An item counts as equipment if it does not stack and matches any of: it has durability, it is worn in an armor or off-hand slot, it is a sword, tool, bow or crossbow, it carries a vanilla equipment tag, or it deals attack damage. Initial quality is based on the item's vanilla rarity, enchanted loot keeps vanilla's rarity increase, and the three highest qualities are reached through breakthroughs.

Affix categories

Affixes are split into four category pools: weapon, tool, armor and generic. Each roll has a 50% chance by default to be drawn from the item's own category pool instead of the whole pool, so a sword sees weapon affixes more often, and generic affixes count toward every item's category pool. Categories only shift the odds and never restrict an item to a single pool; the bias is configurable.

Attribute affixes

Attribute-affix values are calculated as base value × quality multiplier × (1 + enhancement level). Each base value is also the increase from one enhancement level before the quality multiplier is applied.

Functional affixes

Added items

SimplySmith adds two upgrade items. Both can be found in the Ingredients creative tab:

• Enhancement Stone: combine it with stamped equipment in an anvil to increase every affix on the item. Enhancement has no level cap and costs no experience.
• Breakthrough Stone: combine it with stamped equipment in an anvil to raise its quality by one tier and fill the new affix slots. Ultimate equipment cannot be raised further.

Adding custom affixes

Any mod or datapack can add attribute affixes to the shared pool. No dependency on SimplySmith is needed.

Put custom affix JSON files at:

data/<namespace>/simplysmith/affixes/<affix_name>.json

The affix id comes from the file path, so data/mymod/simplysmith/affixes/deadly.json registers mymod:deadly.

{
  "attribute": "minecraft:attack_damage",
  "operation": "addition",
  "base_value": 1.5,
  "category": "weapon",
  "quality_multiplier": {
    "epic": 4.0,
    "ultimate": 20.0
  }
}

Affix names and descriptions

Affix names and descriptions are read from language files rather than the affix JSON. The key format is:

affix.<namespace>.<affix_name>         name
affix.<namespace>.<affix_name>.desc    description, shown while holding Shift

So for mymod:deadly, add to assets/mymod/lang/en_us.json:

{
  "affix.mymod.deadly": "Deadly",
  "affix.mymod.deadly.desc": "Increases attack damage by %s"
}

%s receives the current value. Leave it out if the affix has no number worth showing.

A plain datapack has no assets/ folder. If you ship a datapack rather than a mod, add a matching resource pack, otherwise the tooltip shows the raw translation key.

Notes

• Only attribute affixes can be added this way.
• base_value can be overridden per affix under [affix_base] in config/simplysmith.toml, and the config wins where an entry exists. quality_multiplier in the JSON always wins for the tiers it lists.

Compatible Mods:

• Cloth Config API
• Mod Menu
• JEI

SimplySmith

SimplySmith 添加了装备品质、随机词条、强化和品质突破。

玩法

装备第一次进入玩家背包时，会获得品质和一组随机词条。词条只在物品被手持或穿戴时生效。 判定为装备的条件是不可堆叠，且满足以下任意一条：有耐久、穿戴在盔甲位或副手位、是剑或工具或弓弩、带有原版装备标签、主手有攻击力。 初始品质取决于物品的原版稀有度，带附魔的战利品会保留原版的稀有度提升，最高的三档品质需要通过突破获得。

词条分类

词条池分为武器、工具、盔甲、普通四类，每次抽取默认有 50% 的概率从该装备所属分类的池子中抽取，而不是从全池抽取，因此剑更容易抽到武器词条，普通分类的词条会计入所有装备的分类池。分类只改变概率，不做物品类型限定，偏向概率可进行配置。

属性词条

属性词条的实际数值为 基础值 × 品质倍率 × (1 + 强化等级)。基础值就是每提升一级强化后的增量，两者都会受到品质倍率影响。

功能词条

新增物品

本Mod新增了两种强化物品，均可在创造模式的原材料栏中找到：

• 强化石：在铁砧中与已生成品质的装备合成，提升装备上的全部词条。强化等级没有上限，也不消耗经验。
• 突破石：在铁砧中与已生成品质的装备合成，将品质提升一档，并补齐新品质增加的词条槽位。品质到顶后无法继续突破。

添加自定义词条

任何 Mod 或数据包都可以往共用词条池里添加属性词条，不需要依赖 SimplySmith。

将自定义词条 json 放在：

data/<命名空间>/simplysmith/affixes/<词条名>.json

词条 id 由文件路径推导，因此 data/mymod/simplysmith/affixes/deadly.json 注册的是 mymod:deadly。

{
  "attribute": "minecraft:attack_damage",
  "operation": "addition",
  "base_value": 1.5,
  "category": "weapon",
  "quality_multiplier": {
    "epic": 4.0,
    "ultimate": 20.0
  }
}

词条名和描述

词条的名字和相关描述从语言文件中读取而不是在词条 json 里面，命名规则如下：

affix.<命名空间>.<词条名>         名称
affix.<命名空间>.<词条名>.desc    描述，按住 Shift 时显示

因此 mymod:deadly 需要在 assets/mymod/lang/zh_cn.json 中添加：

{
  "affix.mymod.deadly": "致命",
  "affix.mymod.deadly.desc": "攻击力提升 %s 点"
}

%s 会接收当前数值。没有数值可展示的词条省略它即可。

纯数据包没有 assets/ 目录。如果你发布的是数据包而不是 Mod，需要另外配一个资源包，否则 Tooltip 会显示原始的翻译键。

注意事项

• 只能通过这种方式添加属性词条。
• base_value 可以在 config/simplysmith.toml 的 [affix_base] 中按词条覆盖，存在条目时以配置文件为准。JSON 中的 quality_multiplier 对它列出的档位始终优先。

兼容 Mod：

• Cloth Config API
• Mod Menu
• JEI

SimplySmith

SimplySmith adds gear quality, random affixes, enhancement, and quality breakthroughs.

How it works

Damageable equipment receives a quality and a set of affixes when it first enters a player's inventory. Affixes only take effect while the item is held or equipped.

Initial quality is based on the item's vanilla rarity. Enchanted loot keeps vanilla's rarity increase. The three highest qualities are reached through breakthroughs.

Affix values are calculated as base value × quality multiplier × (1 + enhancement level). Each base value is also the increase from one enhancement level before the quality multiplier is applied.

Two related items are also added. Both can be found in the Ingredients creative tab:

• Enhancement Stone: combine it with stamped equipment in an anvil to increase every affix on the item. Enhancement has no level cap and costs no experience.
• Breakthrough Stone: combine it with stamped equipment in an anvil to raise its quality by one tier and fill the new affix slots. Ultimate equipment cannot be raised further.

Cloth Config API and Mod Menu are optional. SimplySmith works without them; on Fabric, installing both adds an in-game configuration screen. On Forge, Cloth Config API alone adds the same screen.

SimplySmith

SimplySmith 添加装备品质、随机词条、强化和品质突破。

玩法

可损坏的装备第一次进入玩家背包时，会获得品质和一组随机词条。词条只在物品被手持或穿戴时生效。

初始品质取决于物品的原版稀有度，带附魔的战利品会保留原版的稀有度提升。最高的三档品质需要通过突破获得。

词条的实际数值为 基础值 × 品质倍率 × (1 + 强化等级)。基础值就是每提升一级强化后的增量，两者都会受到品质倍率影响。

新增了两种相关物品，均可在创造模式的原材料栏中找到：

• 强化石：在铁砧中与已生成品质的装备合成，提升装备上的全部词条。强化等级没有上限，也不消耗经验。
• 突破石：在铁砧中与已生成品质的装备合成，将品质提升一档，并补齐新品质增加的词条槽位。品质到顶后无法继续突破。

Cloth Config API 和 Mod Menu 都是可选项，不安装也不会影响 SimplySmith 正常运行。Fabric 安装这两个 Mod 后可在游戏内打开配置页面；Forge 只需安装 Cloth Config API 即可。