How do I install ZaKoStrengthen?

Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. Download the .jar. Put it in the .minecraft/mods folder and launch that loader profile. Opens on Modrinth — not every file is mirrored on our own servers.

What Minecraft version does ZaKoStrengthen work with?

The listing gives Minecraft 1.21.10. This is the version stated by the author or source site, not something we verified ourselves.

Home›Java›Mods›ZaKoStrengthen

ModsJava

ZaKoStrengthen

by BeruiiuFengxuan · on Modrinth

Equipments can be enhanced through a custom GUI interface, allowing additional attribute boosts to be applied to weapons, armor, and shields.

⬇ Download on Modrinth

Open in MC Java Mods Get it on Google Play →

ZaKoStrengthen (Equipment Enhancement Plugin)

A Paper 1.21.10 plugin: Enhance equipment via a custom GUI, adding extra attribute bonuses to weapons/armor/shields. Supports 3-tier failure penalties, protection scrolls, mineral/mystery potions to boost success rate, and chest/fishing item acquisition.

I. Gameplay Overview

Phase	Description
Obtain Enhancement Core	Chest loot (5%) or admin `/sh core`
Open Enhancement Interface	Right-click while holding Enhancement Core to open 45-slot GUI
Insert Materials	Enhancement Template in left slot, equipment to enhance in right slot
Execute Enhancement	Click green concrete to execute; success/failure based on level probability
Failure Penalty	Levels 1-10: no penalty / Levels 11-20: level down / Levels 21+: destroy (protection scroll auto-activates)
Boost Success Rate	Consume Mineral Potion (crafting table) or Mystery Potion for stacking bonuses

II. Core Mechanics

1. Enhancement Stages & Failure Penalties

Stage	Level Range	Failure Penalty	Protection
Safe Zone	1 ~ 10	None	Not needed
Level Down Zone	11 ~ 20	Enhancement level -1	Level Protection Scroll (auto-consumed from inventory)
Destroy Zone	21 ~ 100	Equipment destroyed	Destroy Protection Scroll (auto-consumed from inventory)

Each enhancement consumes 1 Enhancement Template.
Success rate is read from level-success-rate config, using the largest configured value <= current level.
Mineral Potion and Mystery Potion bonuses are directly added as percentages to the base success rate (stackable).

2. Attribute Bonus System (Stacking)

Enhancement appends additional Minecraft attribute modifiers to equipment, without overwriting original attributes (vanilla default attributes + existing custom attributes + enhancement attributes merged together).

Each equipment type can have multiple attributes configured, each with an independent base-value (per-level bonus) and slot (active slot).

Final Bonus Formula: Bonus = base-value × Enhancement Level

Example: Diamond Sword enhanced to +20, config generic.attack_damage base-value=0.5:

Bonus = 0.5 × 20 = +10 Attack Damage

3. Enhancement GUI Layout (45 Slots)

Row 0: [Gray Glass] [Gray Glass] [Gray Glass] [Gray Glass] [Gray Glass] [Gray Glass] [Gray Glass] [Gray Glass] [Gray Glass]
Row 1: [Gray Glass] [Template Label] [Template Slot] [Gray Glass] [Gray Glass] [Equipment Label] [Equipment Slot] [Gray Glass] [Gray Glass]
Row 2: [Gray Glass] [Gray Glass] [Gray Glass] [Gray Glass] [Gray Glass] [Gray Glass] [Gray Glass] [Gray Glass] [Gray Glass]
Row 3: [Gray Glass] [Gray Glass] [Confirm] [Gray Glass] [Status Indicator] [Gray Glass] [Cancel/Close] [Gray Glass] [Gray Glass]
Row 4: [Gray Glass] [Gray Glass] [Gray Glass] [Gray Glass] [Gray Glass] [Gray Glass] [Gray Glass] [Gray Glass] [Gray Glass]

Clicking non-interactive slots will be cancelled. Player inventory (>=45 slots) is unrestricted and items can be freely taken.

4. Potion System

Mineral Potions (Crafting Table):

Potion	Material	Bonus
Iron Ore Potion	Raw Iron + Awkward Potion + Gunpowder	+3%
Gold Ore Potion	Raw Gold + Awkward Potion + Gunpowder	+5%
Copper Ore Potion	Raw Copper + Awkward Potion + Gunpowder	+2%
Diamond Potion	Diamond + Awkward Potion + Gunpowder	+15%
Netherite Potion	Netherite Ingot + Awkward Potion + Gunpowder	+20%
Emerald Potion	Emerald + Awkward Potion + Gunpowder	+10%
Lapis Potion	Lapis Lazuli + Awkward Potion + Gunpowder	+3%
Redstone Potion	Redstone + Awkward Potion + Gunpowder	+2%
Coal Potion	Coal + Awkward Potion + Gunpowder	+1%
Amethyst Potion	Amethyst Shard + Awkward Potion + Gunpowder	+6%

Crafting Layout (3x3 Crafting Table):

[Empty] [Mineral] [Empty]
[Empty] [Awkward Potion] [Empty]
[Empty] [Gunpowder] [Empty]

Mystery Potion: +25%, stackable with Mineral Potions, cannot stack with itself.

5. Chest Loot

When opening normal chests/trapped chests/barrels/shulker boxes, items are automatically inserted based on probability:

Item	Probability
Enhancement Core	5%
Level Protection Scroll	4%
Destroy Protection Scroll	3%

Each chest block is evaluated only once; all items are independently evaluated (a single chest can yield multiple items).

6. Fishing Acquisition

Fishing has an 8% chance to replace the caught item with an Enhancement Template.

III. Items

Item	Acquisition	Purpose
Enhancement Core	Chest (5%) / `/sh core`	Right-click while holding to open enhancement interface
Enhancement Template	Fishing (8%) / `/sh template`	Enhancement consumable, 1 consumed per enhancement
Level Protection Scroll	Chest (4%) / `/sh scroll level`	Auto-consumed on failure at levels 11-20, prevents level down
Destroy Protection Scroll	Chest (3%) / `/sh scroll destroy`	Auto-consumed on failure at levels 21+, prevents destruction
Mystery Potion	`/sh potion`	Drinking grants +25% success rate for 30 seconds
Mineral Potion	Crafting Table (see table above)	Drinking grants corresponding mineral success rate bonus for 30 seconds

IV. Commands

Command	Permission	Description
`/sh core`	zakostrengthen.give	Give Enhancement Core
`/sh template`	zakostrengthen.give	Give Enhancement Template
`/sh scroll level [amount]`	zakostrengthen.give	Give Level Protection Scroll
`/sh scroll destroy [amount]`	zakostrengthen.give	Give Destroy Protection Scroll
`/sh potion`	zakostrengthen.give	Give Mystery Potion
`/sh give <player> <core\|template\|level scroll\|destroy scroll\|potion> [amount]`	zakostrengthen.give	Give item to specified player
`/sh setlevel <level>`	zakostrengthen.admin	Set enhancement level of held equipment
`/sh info`	zakostrengthen.admin	View enhancement info of held equipment
`/sh reload`	zakostrengthen.admin	Reload configuration file
`/strengthenreload`	zakostrengthen.admin	Reload configuration file (alias)

V. Configuration File Parameters (config.yml)

Message Text

messages:
  prefix: "&8[&6Strengthen System&8] &r"
  success: "&aEnhancement successful! Current level: &e%level%"
  fail-safe: "&cEnhancement failed, but your equipment was not affected."
  fail-level-down: "&cEnhancement failed! Equipment level dropped to &e%level%"
  fail-destroy: "&cEnhancement failed! Equipment has been destroyed!"
  protect-level: "&eLevel Protection Scroll activated, equipment level preserved."
  protect-destroy: "&eDestroy Protection Scroll activated, equipment preserved. Scroll consumed."
  potion-active: "&aMystery Potion effect activated, success rate +%bonus%%"
  invalid-slot: "&cThis equipment cannot be enhanced!"
  max-level: "&cThis equipment has reached the maximum enhancement level!"
  give-received: "&aYou received %item%"
  set-level-success: "&aSet %item% enhancement level to &e%level%"
  reload-success: "&aConfiguration reloaded!"
  no-permission: "&cYou do not have permission to perform this action."

Placeholders: %level% = Enhancement Level / %item% = Item Name / %bonus% = Bonus Percentage

Success Rate & Stages

level-success-rate:
  1: 100.0    # Level 1 success rate 100%
  10: 91.0    # Level 10 success rate 91%
  20: 70.0    # Level 20 success rate 70%
  25: 55.0    # Level 25 success rate 55%
  50: 11.0    # Level 50 success rate 11%
  100: 0.3    # Level 100 success rate 0.3%
  # Format: level: percentage, uses largest configured value <= current level

max-level: 100

stages:
  stage1-max: 10   # Levels 1-10: no failure penalty
  stage2-max: 20   # Levels 11-20: failure causes level down
  stage3-max: 100  # Levels 21+: failure causes destruction

Enhanceable Equipment Types

Three config sections (equipment-types / intensify-attributes / slot-config) must use identical type names. Default provides 3 types, extendable as needed.

Default Type Names:

Type Name	Purpose	Default Slot	Example Items
`weapon`	Weapons	`HAND`	Sword, Axe, Hoe, Bow, Crossbow, Trident, Mace
`armor`	Armor	`ANY`	Helmet, Chestplate, Leggings, Boots, Elytra
`shield`	Shields	`OFF_HAND`	Shield

Custom Type Example (e.g., distinguishing bows from melee weapons):

equipment-types:
  weapon:
    - "minecraft:netherite_sword"
    - "minecraft:diamond_sword"
  bow:
    - "minecraft:bow"
    - "minecraft:crossbow"
  tool:
    - "minecraft:netherite_pickaxe"
    - "minecraft:diamond_pickaxe"

intensify-attributes:
  weapon:
    - attribute: "generic.attack_damage"
      base-value: 0.5
      slot: "HAND"
  bow:
    - attribute: "generic.attack_damage"
      base-value: 0.3
      slot: "HAND"
  tool:
    - attribute: "generic.mining_efficiency"
      base-value: 0.5
      slot: "HAND"

slot-config:
  weapon: "HAND"
  bow: "HAND"
  tool: "HAND"

The type names across all three sections must be identical, otherwise that type's attribute bonuses and slot config will not take effect.

Custom Attribute Bonuses (Core Config)

intensify-attributes:
  weapon:
    - attribute: "generic.attack_damage"  # Attribute ID
      base-value: 0.5                     # Per-level bonus value
      slot: "HAND"                        # Active slot
    - attribute: "generic.attack_speed"
      base-value: 0.1
      slot: "HAND"
  armor:
    - attribute: "generic.armor"
      base-value: 0.3
      slot: "ANY"  # Applies to helmet/chestplate/leggings/boots
    - attribute: "generic.armor_toughness"
      base-value: 0.15
      slot: "ANY"
  shield:
    - attribute: "generic.max_health"
      base-value: 0.2
      slot: "OFF_HAND"
    - attribute: "player.reach"
      base-value: 0.05
      slot: "OFF_HAND"

Field Descriptions:

Field	Description
`attribute`	Minecraft Attribute ID (see table below)
`base-value`	Value added per enhancement level (Final Bonus = base-value × level)
`slot`	Which equipment slot this attribute applies to (see table below, optional; falls back to slot-config if omitted)

Common Attribute IDs:

Attribute ID	Description	Applicable Types
`generic.attack_damage`	Attack Damage	weapon
`generic.attack_speed`	Attack Speed	weapon
`generic.attack_knockback`	Attack Knockback	weapon
`generic.armor`	Armor	armor
`generic.armor_toughness`	Armor Toughness	armor
`generic.max_health`	Max Health	shield/armor
`generic.max_absorption`	Max Absorption Health	armor
`generic.knockback_resistance`	Knockback Resistance	armor
`generic.explosion_knockback_resistance`	Explosion Knockback Resistance	armor
`generic.movement_speed`	Movement Speed	armor
`generic.movement_efficiency`	Movement Efficiency	armor
`generic.flying_speed`	Flying Speed	armor
`generic.follow_range`	Follow Range	weapon
`generic.luck`	Luck	armor
`generic.scale`	Entity Scale	armor
`generic.step_height`	Step Height	armor
`generic.fall_damage_multiplier`	Fall Damage Multiplier	armor
`generic.safe_fall_distance`	Safe Fall Distance	armor
`generic.burning_time`	Burning Time Multiplier	armor
`generic.camera_distance`	Camera Distance	armor
`generic.block_break_speed`	Block Break Speed	weapon
`generic.block_interaction_range`	Block Interaction Range	weapon
`generic.entity_interaction_range`	Entity Interaction Range	weapon/shield
`generic.mining_efficiency`	Mining Efficiency	weapon
`generic.sneaking_speed`	Sneaking Speed	armor
`generic.submerged_mining_speed`	Submerged Mining Speed	weapon
`generic.sweeping_damage_ratio`	Sweeping Damage Ratio	weapon
`generic.spawn_reinforcements`	Spawn Reinforcements Chance	armor
`generic.oxygen_bonus`	Oxygen Bonus	armor
`generic.water_movement_efficiency`	Water Movement Efficiency	armor
`generic.tempt_range`	Tempt Range	armor
`generic.jump_strength`	Jump Strength	weapon
`generic.waypoint_transmit_range`	Waypoint Transmit Range	armor
`generic.waypoint_receive_range`	Waypoint Receive Range	armor
`player.reach`	Reach (= entity_interaction_range)	weapon/shield

Slot Options:

Slot	Description
`HAND`	Main Hand
`OFF_HAND`	Off Hand
`HEAD`	Helmet
`CHEST`	Chestplate
`LEGS`	Leggings
`FEET`	Boots
`ANY`	All Equipment Slots (helmet/chestplate/leggings/boots/main hand/off hand)

When the slot field is omitted in attribute config, it automatically falls back to the default slot in slot-config for that type. For armor types, set slot: "ANY" to make bonuses apply across all armor pieces.

Potions & Loot

mineral-potion-bonus:
  iron: 3.0        # Success rate bonus for each mineral potion
  diamond: 15.0
  netherite: 20.0
  # ...

mineral-potion:
  duration: 30     # Mineral potion duration in seconds

mystery-potion:
  bonus-rate: 25.0 # Mystery potion bonus

template-drop:
  fishing-chance: 0.08  # Chance to obtain Enhancement Template from fishing

chest-loot:
  enabled: true
  strengthen-core: 0.05
  level-protect-scroll: 0.04
  destroy-protect-scroll: 0.03

Custom Item Appearance

custom-items:
  strengthen-core:
    material: "nether_star"       # Item material
    name: "&6Enhancement Core"    # Display name (supports & color codes)
    lore:                         # Item description
      - "&7Right-click to open enhancement interface"
    custom-model-data: 10000      # Custom model data (for resource pack)
  # ...other items follow the same format

Item identification relies on internal PDC tags; material/name/lore can be freely modified without affecting functionality.

Mineral Potion Crafting Recipes

mineral-potion-recipes:
  iron:
    mineral: "RAW_IRON"          # Crafting material (material ID)
    name: "&7Iron Ore Potion"
    lore:
      - "&7Drink to gain"
      - "&7enhancement success rate &a+3%"
    bonus-rate: 3.0              # Must match mineral-potion-bonus
    custom-model-data: 10010
  # ...other minerals follow the same format

config.yml is only auto-generated on plugin first run. After modification, use /sh reload for hot-reload; if the server already has an older config version, manually add new parameters or delete the file to regenerate.

VI. Technical Notes (Admin Reference)

Supports Paper 1.21.10 only (API 1.21), Java 21.
Attribute merging implemented via NMS: reads DataComponents.ATTRIBUTE_MODIFIERS (MC 1.21.10 stores default attribute values in this component), merges vanilla default attributes + player custom attributes + enhancement attributes, then writes back to ItemMeta.
Enhancement modifiers use deterministic NamespacedKeys (zakostrengthen:strengthen_<attribute>_<slot>), ensuring no identification loss during NMS round-trips.
All custom items identified via PDC (PersistentDataContainer) tags, not dependent on item name or lore comparison.
Potion effects use PDC tags to prevent same-type stacking; effects auto-remove upon expiration.
Chest loot uses TileState PDC tags to prevent duplicate evaluation; each chest block triggers only once.

ZaKoStrengthen (装备强化插件)

一款 Paper 1.21.10 插件：通过自定义 GUI 界面强化装备，为武器/盔甲/盾牌添加额外属性加成。支持 3 阶段失败惩罚、保护卷轴、矿物药水/神秘药水提升成功率，以及宝箱/钓鱼获取道具。

一、玩法总览

阶段	说明
获取强化核心	宝箱战利品（5%）或管理员 `/sh core` 发放
打开强化界面	手持强化核心右键打开 45 格 GUI
放入材料	左侧放强化模板，右侧放要强化的装备
执行强化	点击绿色混凝土执行，根据等级按概率成功/失败
失败惩罚	1-10 级无惩罚 / 11-20 级掉级 / 21 级+销毁（保护卷自动生效）
提升成功率	饮用矿物药水（工作台合成）或神秘药水叠加加成

二、核心机制说明

1. 强化阶段与失败惩罚

阶段	等级范围	失败惩罚	保护方式
安全区	1 ~ 10	无	不需要
掉级区	11 ~ 20	强化等级 -1	掉级保护卷（背包中自动消耗）
销毁区	21 ~ 100	装备直接销毁	强化保护卷（背包中自动消耗）

每次强化消耗 1 个强化模板。
成功率从 level-success-rate 配置读取，取 <= 当前等级的最大已配置值。
矿物药水和神秘药水的加成在基础成功率上直接加百分比（可叠加）。

2. 属性加成系统（叠加式）

强化为装备追加额外的 Minecraft 属性修饰符，不会覆盖装备原有属性（原版默认属性 + 已有自定义属性 + 强化属性三层合并）。

每个装备类型可配置多个属性，每个属性有独立的 base-value（每级加成）和 slot（生效槽位）。

最终加成公式：加成值 = base-value × 强化等级

示例：钻石剑强化到 +20，配置 generic.attack_damage base-value=0.5：

加成 = 0.5 × 20 = +10 攻击伤害

3. 强化 GUI 布局（45 格）

第0行: [灰玻璃] [灰玻璃] [灰玻璃] [灰玻璃] [灰玻璃] [灰玻璃] [灰玻璃] [灰玻璃] [灰玻璃]
第1行: [灰玻璃] [强化模板标签] [模板槽位] [灰玻璃] [灰玻璃] [装备标签] [装备槽位] [灰玻璃] [灰玻璃]
第2行: [灰玻璃] [灰玻璃] [灰玻璃] [灰玻璃] [灰玻璃] [灰玻璃] [灰玻璃] [灰玻璃] [灰玻璃]
第3行: [灰玻璃] [灰玻璃] [确认执行] [灰玻璃] [状态指示] [灰玻璃] [取消关闭] [灰玻璃] [灰玻璃]
第4行: [灰玻璃] [灰玻璃] [灰玻璃] [灰玻璃] [灰玻璃] [灰玻璃] [灰玻璃] [灰玻璃] [灰玻璃]

点击非交互槽位会被取消，玩家背包（>=45 格）不受限制，可自由拿取物品。

4. 药水系统

矿物药水（工作台合成）：

药水	材料	加成
铁矿药水	粗铁 + 粗制药水 + 火药	+3%
金矿药水	粗金 + 粗制药水 + 火药	+5%
铜矿药水	粗铜 + 粗制药水 + 火药	+2%
钻石药水	钻石 + 粗制药水 + 火药	+15%
下界合金药水	下界合金锭 + 粗制药水 + 火药	+20%
绿宝石药水	绿宝石 + 粗制药水 + 火药	+10%
青金石药水	青金石 + 粗制药水 + 火药	+3%
红石药水	红石 + 粗制药水 + 火药	+2%
煤炭药水	煤炭 + 粗制药水 + 火药	+1%
紫水晶药水	紫水晶碎片 + 粗制药水 + 火药	+6%

合成摆放（工作台 3x3）：

[空] [矿物] [空]
[空] [粗制药水] [空]
[空] [火药] [空]

神秘药水：+25%，可与矿物药水叠加，不可与自身叠加。

5. 宝箱战利品

打开普通箱子/陷阱箱/木桶/潜影盒时，按概率自动放入物品：

物品	概率
强化核心	5%
掉级保护卷	4%
强化保护卷	3%

每个箱子方块只判定一次，所有物品独立判定（一个箱子可同时开出多个）。

6. 钓鱼获取

钓鱼时有 8% 概率将钓到的物品替换为强化模板。

三、物品道具

物品	获取方式	用途
强化核心	宝箱 (5%) / `/sh core`	手持右键打开强化界面
强化模板	钓鱼 (8%) / `/sh template`	强化消耗品，每次强化消耗 1 个
掉级保护卷	宝箱 (4%) / `/sh scroll level`	11-20 级失败时自动消耗，保护不掉级
强化保护卷	宝箱 (3%) / `/sh scroll destroy`	21 级+失败时自动消耗，保护不销毁
神秘药水	`/sh potion`	饮用后成功率 +25%，持续 30 秒
矿物药水	工作台合成（见上表）	饮用后对应矿物的成功率加成，持续 30 秒

四、命令

命令	权限	说明
`/sh core`	zakostrengthen.give	获得强化核心
`/sh template`	zakostrengthen.give	获得强化模板
`/sh scroll level [数量]`	zakostrengthen.give	获得掉级保护卷
`/sh scroll destroy [数量]`	zakostrengthen.give	获得强化保护卷
`/sh potion`	zakostrengthen.give	获得神秘药水
`/sh give <玩家> <核心\|模板\|掉级卷\|销毁卷\|药水> [数量]`	zakostrengthen.give	给予指定玩家物品
`/sh setlevel <等级>`	zakostrengthen.admin	设置手持装备的强化等级
`/sh info`	zakostrengthen.admin	查看手持装备的强化信息
`/sh reload`	zakostrengthen.admin	重载配置文件
`/strengthenreload`	zakostrengthen.admin	重载配置文件（别名）

五、配置文件参数（config.yml）

消息文本

messages:
  prefix: "&8[&6强化系统&8] &r"       # 消息前缀
  success: "&a强化成功！当前强化等级: &e%level%"
  fail-safe: "&c强化失败，但你的装备没有受到任何影响。"
  fail-level-down: "&c强化失败！装备强化等级下降至 &e%level%"
  fail-destroy: "&c强化失败！装备已被销毁！"
  protect-level: "&e掉级保护卷生效，装备未掉级。"
  protect-destroy: "&e强化保护卷生效，装备未被销毁，保护卷已消耗。"
  potion-active: "&a神秘药水效果已激活，成功率 +%bonus%%"
  invalid-slot: "&c该装备无法进行强化！"
  max-level: "&c该装备已达到最大强化等级！"
  give-received: "&a你获得了 %item%"
  set-level-success: "&a已将 %item% 强化等级设置为 &e%level%"
  reload-success: "&a配置已重载！"
  no-permission: "&c你没有权限执行此操作。"

占位符：%level% = 强化等级 / %item% = 物品名 / %bonus% = 加成百分比

成功率与阶段

level-success-rate:
  1: 100.0    # 1级成功率 100%
  10: 91.0    # 10级成功率 91%
  20: 70.0    # 20级成功率 70%
  25: 55.0    # 25级成功率 55%
  50: 11.0    # 50级成功率 11%
  100: 0.3    # 100级成功率 0.3%
  # 格式: 等级: 百分比，取 <= 当前等级的最大已配置值

max-level: 100

stages:
  stage1-max: 10   # 1-10级 失败无惩罚
  stage2-max: 20   # 11-20级 失败掉级
  stage3-max: 100  # 21级+ 失败销毁

可强化装备类型

三个配置节（equipment-types / intensify-attributes / slot-config）必须使用相同的类型名。默认提供 3 种类型，可自行扩展。

默认类型名：

类型名	用途	默认槽位	示例物品
`weapon`	武器	`HAND`	剑、斧、锄、弓、弩、三叉戟、锤
`armor`	护甲	`ANY`	头盔、胸甲、护腿、靴子、鞘翅
`shield`	盾牌	`OFF_HAND`	盾牌

自定义类型示例（如需区分弓和近战武器）：

equipment-types:
  weapon:
    - "minecraft:netherite_sword"
    - "minecraft:diamond_sword"
  bow:
    - "minecraft:bow"
    - "minecraft:crossbow"
  tool:
    - "minecraft:netherite_pickaxe"
    - "minecraft:diamond_pickaxe"

intensify-attributes:
  weapon:
    - attribute: "generic.attack_damage"
      base-value: 0.5
      slot: "HAND"
  bow:
    - attribute: "generic.attack_damage"
      base-value: 0.3
      slot: "HAND"
  tool:
    - attribute: "generic.mining_efficiency"
      base-value: 0.5
      slot: "HAND"

slot-config:
  weapon: "HAND"
  bow: "HAND"
  tool: "HAND"

三个节的类型名必须完全一致，否则该类型的属性加成和槽位配置不会生效。

自定义属性加成（核心配置）

intensify-attributes:
  weapon:
    - attribute: "generic.attack_damage"  # 属性ID
      base-value: 0.5                     # 每级加成值
      slot: "HAND"                        # 生效槽位
    - attribute: "generic.attack_speed"
      base-value: 0.1
      slot: "HAND"
  armor:
    - attribute: "generic.armor"
      base-value: 0.3
      slot: "ANY"  # 头盔/胸甲/护腿/靴子都生效
    - attribute: "generic.armor_toughness"
      base-value: 0.15
      slot: "ANY"
  shield:
    - attribute: "generic.max_health"
      base-value: 0.2
      slot: "OFF_HAND"
    - attribute: "player.reach"
      base-value: 0.05
      slot: "OFF_HAND"

字段说明：

字段	含义
`attribute`	Minecraft 属性 ID（见下表）
`base-value`	每强化 1 级增加的数值（最终加成 = base-value × 等级）
`slot`	该属性在哪个装备槽生效（见下表，可选，省略时回退到 slot-config）

常用属性 ID：

属性 ID	说明	适用类型
`generic.attack_damage`	攻击伤害	weapon
`generic.attack_speed`	攻击速度	weapon
`generic.attack_knockback`	攻击击退	weapon
`generic.armor`	护甲值	armor
`generic.armor_toughness`	盔甲韧性	armor
`generic.max_health`	最大生命值	shield/armor
`generic.max_absorption`	最大吸收生命	armor
`generic.knockback_resistance`	击退抗性	armor
`generic.explosion_knockback_resistance`	爆炸击退抗性	armor
`generic.movement_speed`	移动速度	armor
`generic.movement_efficiency`	移动效率	armor
`generic.flying_speed`	飞行速度	armor
`generic.follow_range`	追踪距离	weapon
`generic.luck`	幸运值	armor
`generic.scale`	实体缩放	armor
`generic.step_height`	跨台阶高度	armor
`generic.fall_damage_multiplier`	摔落伤害倍率	armor
`generic.safe_fall_distance`	安全摔落距离	armor
`generic.burning_time`	燃烧时间倍率	armor
`generic.camera_distance`	相机距离	armor
`generic.block_break_speed`	方块破坏速度	weapon
`generic.block_interaction_range`	方块交互距离	weapon
`generic.entity_interaction_range`	实体交互距离	weapon/shield
`generic.mining_efficiency`	挖掘效率	weapon
`generic.sneaking_speed`	潜行速度	armor
`generic.submerged_mining_speed`	水下挖掘速度	weapon
`generic.sweeping_damage_ratio`	横扫伤害比例	weapon
`generic.spawn_reinforcements`	刷新增援概率	armor
`generic.oxygen_bonus`	氧气加成	armor
`generic.water_movement_efficiency`	水中移动效率	armor
`generic.tempt_range`	诱惑距离	armor
`generic.jump_strength`	跳跃强度	weapon
`generic.waypoint_transmit_range`	路标传输距离	armor
`generic.waypoint_receive_range`	路标接收距离	armor
`player.reach`	触达距离（= entity_interaction_range）	weapon/shield

槽位可选值：

槽位	说明
`HAND`	主手
`OFF_HAND`	副手
`HEAD`	头盔
`CHEST`	胸甲
`LEGS`	护腿
`FEET`	靴子
`ANY`	所有装备槽位（头盔/胸甲/护腿/靴子/主手/副手都生效）

属性配置中省略 slot 字段时，自动回退到 slot-config 中该类型的默认槽位。盔甲类建议设为 slot: "ANY" 使加成覆盖所有护甲部位。

药水与战利品

mineral-potion-bonus:
  iron: 3.0        # 各矿物药水的成功率加成
  diamond: 15.0
  netherite: 20.0
  # ...

mineral-potion:
  duration: 30     # 矿物药水持续秒数

mystery-potion:
  bonus-rate: 25.0 # 神秘药水加成

template-drop:
  fishing-chance: 0.08  # 钓鱼获得强化模板概率

chest-loot:
  enabled: true
  strengthen-core: 0.05
  level-protect-scroll: 0.04
  destroy-protect-scroll: 0.03

自定义物品外观

custom-items:
  strengthen-core:
    material: "nether_star"       # 物品材质
    name: "&6强化核心"            # 显示名称（支持 & 颜色）
    lore:                         # 物品描述
      - "&7右键打开强化界面"
    custom-model-data: 10000      # 自定义模型数据（配合资源包）
  # ...其他物品同理

物品识别靠内部 PDC 标记，material/name/lore 可自由修改不影响功能。

矿物药水合成配方

mineral-potion-recipes:
  iron:
    mineral: "RAW_IRON"          # 合成材料（材质ID）
    name: "&7铁矿药水"
    lore:
      - "&7饮用后30秒内"
      - "&7强化成功率 &a+3%"
    bonus-rate: 3.0              # 需与 mineral-potion-bonus 一致
    custom-model-data: 10010
  # ...其他矿物同理

config.yml 仅在插件首次运行时自动生成。修改后用 /sh reload 热重载；若服务端已存在旧版配置，需手动添加新参数或删除该文件重新生成。

六、技术说明（管理员参考）

仅支持 Paper 1.21.10（API 1.21），Java 21。
属性合并通过 NMS 实现：读取 DataComponents.ATTRIBUTE_MODIFIERS（MC 1.21.10 属性默认值存储在该组件中），合并原版默认属性 + 玩家自定义属性 + 强化属性，再写回 ItemMeta。
强化修饰符使用确定性 NamespacedKey（zakostrengthen:strengthen_<属性>_<槽位>），确保 NMS 往返不丢失识别。
所有自定义物品通过 PDC（PersistentDataContainer）标记识别，不依赖物品名称或 lore 比对。
药水效果通过 PDC 标记防止同类叠加，过期自动移除。
宝箱战利品通过 TileState PDC 标记防止重复判定，每个箱子方块只触发一次。

Quick facts

Edition: Minecraft Java
File type: .jar
Minecraft version listed: 1.21.10
How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

Verified by MCModsHub

Ships as ZaKoStrengthen-4.0.2.jar — drop this file into the mods folder
Download size: 60 KB
Download link checked 26 Sept 2026 — working

These come from our own check of the pack file, not from the source page.

Explore more

All Mods for Java All Minecraft Java mods Java mods for 1.21