D2 Affix

[暗黑2词缀 / D2 Operation] D2 Affix — Beta

English section (Machine-translated. Please excuse any grammatical errors.)

Overview

D2 Affix is a Minecraft Forge 1.20.1 mod that brings Diablo II's elite monster affix system into Minecraft.

Monsters can spawn as elites with randomized affixes (Cold Enchanted, Extra Fast, Teleportation...) and auras (Might, Holy Freeze, Conviction...). Elites are classified into 5 tiers with per-difficulty weight balancing, minion spawning, equipment pools, dynamic crossbow ammo, and a custom attribute + damage-type framework. Elite type definitions are data-driven (JSON) and can be overridden under config/d2affix/elite_types/.

Elite Types (Tiers)

Each tier is defined as a template in data/d2affix/elite_types/*.json, then registered with an ID. Types that set applicableTags or applicableEntities only spawn on matching monsters; types with neither restriction apply to all eligible mobs. Child types use extends to inherit and override a parent's fields.

Tier Comparison

Registered Types

• common — unrestricted base tier, applies to all eligible mobs
• champion — minion elite type for Champion minions
• unique — unrestricted, full prefix + aura affix pool
• minion — minion elite type for Unique / Super Unique minions, inherits parent name
• super_unique — base Super Unique template (red, translation-key naming)
• bonebreaker — UNDEAD, innate spectral_hit, wooden sword
• bonesaw — UNDEAD, innate extra_strong + magic_resistant, iron axe + shield
• rakanishu — UNDEAD, innate lightning_enchanted + extra_fast
• treehead — BEAST tag, innate extra_fast + extra_strong
• corpsefire — UNDEAD, innate spectral_hit, wooden sword
• bishibosh — BEAST tag, innate magic_resistant + fire_enchanted

Attribute Modifiers (all MULTIPLY_TOTAL; values are Normal / Nightmare / Hell)

Difficulty System

Persistence via SavedData in the Overworld. Kill flags prevent repeated triggers. Players can manually set with /d2affix difficult <0-2>. Affix numbers scale per difficulty tier.

All Affixes

Prefixes (13) — used by Unique and Super Unique

Auras (17) — max 1 per mob, radius 10~15 (varies by aura)

Champion Affixes (5) — used by Champion type pool

Custom Attributes (D2Attributes)

All RangedAttribute, synced, range [-2, 0.75] for resists.

Custom Damage Types

Custom Potions & Effects

Drinkable Potions

All available as splash and lingering variants.

Mob Effects

Includes: amplify_damage, soul_burn, poison, thorns_aura, might_aura, defense_aura, blessed_aim_aura, concentration_aura, fanaticism_aura, holy_fire_aura_buff/debuff, holy_freeze_aura_buff/debuff, holy_lightning_aura_buff/debuff, conviction_aura, salvation_aura, fire_resistance_aura, cold_resistance_aura, lightning_resistance_aura, sanctuary_aura_buff, prayer_aura, redemption_aura.

Custom Entity

d2affix:charged_bolt — projectile entity (0.25×0.25 hitbox, tracking 64 blocks, update interval 1 tick)

Custom AI Goals

All extend RangedWeaponGoal (based on vanilla Goal):

Config Files

All in config/d2affix/ (created on first run; hot-reloadable via /d2affix reload):

Equipment Pool Example

Weapon priority per material tier (sword/axe/pickaxe/hoe/shovel ratio 10:7:5:2:2):

• Leather/Wood: N=100, H=30, E=0
• Chain/Stone: N=50, H=70, E=0
• Iron: N=10, H=150, E=100
• Gold: N=50, H=100, E=50
• Diamond: N=0, H=10, E=50
• Netherite: N=0, H=0, E=1

Offhand items: Flint (all), Shield (NM+), Totem (Hell+). Empty hand weight: N=2000, H=700, E=0. All items drop=false.

Tags

Entity Tags

• d2affix:undead — Undead entities (zombies, skeletons, etc.)
• d2affix:illager — Illager entities
• d2affix:beast — Beast entities
• d2affix:enhance_remote_ai — Entities eligible for ranged weapon AI

Damage Tags

• d2affix:on_crit — Bypasses critical damage
• minecraft:is_fire — Fire damage
• minecraft:is_lightning — Lightning damage
• minecraft:is_freezing — Freezing damage
• d2affix:is_poison — Poison damage
• d2affix:no_knockback — No-knockback damage
• minecraft:bypasses_armor — Armor-piercing damage
• minecraft:bypasses_invulnerability — Invulnerability-piercing damage
• d2affix:is_thorns — Thorns reflect damage (prevents reflection loops)

Item Tags

• d2affix:unlock_0 — Available at Normal difficulty
• d2affix:unlock_1 — Available at Nightmare difficulty
• d2affix:unlock_2 — Available at Hell difficulty

Commands

All commands require permission level 2 (op).

/d2affix

NBT Data Structure

All stored in PersistentData → d2affix:

d2affix/
├── affixes/ [ { id: "cold_enchanted" }, ... ]
├── component/ { teleport_cooldown: ... }
└── elite/
    ├── is_processed: bool
    ├── type_id: string
    ├── steps/ { fill_affixes, spawn_minions, ... }   (per-step completion flags)
    └── parent_key: string  (for minion display)

Technical Info

• Mod ID: d2affix
• Minecraft: 1.20.1
• Forge: 47.4.10+
• Version: 0.1.0-Beta
• Author: PyroStella

中文版

概述

暗黑2操作 是一个 Minecraft Forge 1.20.1 模组，将暗黑破坏神 2 的精英怪物词缀系统完整移植到 Minecraft 中。

怪物可以带有随机词缀（冰冷强化、特别快速、传送……）和光环（力量灵气、神圣冰冻、信念灵气……）生成。精英分为 5 个等级，按难度权重分配，支持随从生成、装备池、动态弩箭弹药切换，以及自定义属性和伤害类型框架。精英类型定义由数据驱动（JSON），可在 config/d2affix/elite_types/ 下覆盖。

精英类型（等级）

每个等级在 data/d2affix/elite_types/*.json 中定义，再以 ID 注册。设置了 applicableTags 或 applicableEntities 的类型只在匹配的怪物上生成；两者皆未设置的类型适用于所有符合条件的敌对生物。子类型通过 extends 继承并覆盖父类型的字段。

等级对比

已注册类型

• common — 基础档，无限制，适用所有符合条件的敌对生物
• champion — 冠军随从专用
• unique — 无限制，全量前缀 + 光环词缀池
• minion — 独特/超级独特的随从专用，继承父级名称
• super_unique — 超级独特基础模板（红色，使用翻译键命名）
• bonebreaker — 亡灵生物，固有 spectral_hit，木剑
• bonesaw — 亡灵生物，固有 extra_strong + magic_resistant，铁斧 + 盾牌
• rakanishu — 亡灵生物，固有 lightning_enchanted + extra_fast
• treehead — BEAST 标签，固有 extra_fast + extra_strong
• corpsefire — 亡灵生物，固有 spectral_hit，木剑
• bishibosh — BEAST 标签，固有 magic_resistant + fire_enchanted

属性修正（全部 MULTIPLY_TOTAL；数值为 普通 / 噩梦 / 地狱）

难度系统

通过 SavedData 在主世界持久化，防重复触发。玩家可用 /d2affix difficult <0-2> 手动设置。词缀数值按难度档位缩放。

词缀列表

前缀（13 个）— 独特与超级独特使用

光环（17 个）— 每个生物最多 1 个，半径 10~15（随光环不同）

冠军词缀（5 个）— 冠军类型池使用

自定义属性（13 个）

全部为 RangedAttribute，已同步，抗性范围 [-2, 0.75]。

自定义伤害类型（7 个）

药水与效果

可饮用药水

均提供喷溅型与滞留型。

生物效果

包括：amplify_damage、soul_burn、poison、thorns_aura、might_aura、defense_aura、blessed_aim_aura、concentration_aura、fanaticism_aura、holy_fire_aura_buff/debuff、holy_freeze_aura_buff/debuff、holy_lightning_aura_buff/debuff、conviction_aura、salvation_aura、fire_resistance_aura、cold_resistance_aura、lightning_resistance_aura、sanctuary_aura_buff、prayer_aura、redemption_aura。

自定义实体

d2affix:charged_bolt — 弹射物实体（0.25×0.25 碰撞箱，追踪 64 格，每 tick 更新）。

自定义 AI

全部继承 RangedWeaponGoal（基于原版 Goal）：

配置文件

均位于 config/d2affix/（首次运行生成，可通过 /d2affix reload 热重载）：

装备池示例

各材质按难度权重（剑/斧/镐/锄/铲 比例 10:7:5:2:2）：

• 皮革/木：N=100, H=30, E=0
• 锁链/石：N=50, H=70, E=0
• 铁：N=10, H=150, E=100
• 金：N=50, H=100, E=50
• 钻石：N=0, H=10, E=50
• 下界合金：N=0, H=0, E=1

副手物品：打火石（全部）、盾牌（噩梦+）、图腾（地狱+）。空手权重：N=2000, H=700, E=0。所有物品 drop=false。

标签

实体标签

• d2affix:undead — 亡灵生物（僵尸、骷髅等）
• d2affix:illager — 灾厄村民生物
• d2affix:beast — 野兽生物
• d2affix:enhance_remote_ai — 可启用远程武器 AI 的生物

伤害标签

• d2affix:on_crit — 无视暴击伤害
• minecraft:is_fire — 火焰伤害
• minecraft:is_lightning — 闪电伤害
• minecraft:is_freezing — 冰冻伤害
• d2affix:is_poison — 毒素伤害
• d2affix:no_knockback — 无击退伤害
• minecraft:bypasses_armor — 无视护甲伤害
• minecraft:bypasses_invulnerability — 无视无敌伤害
• d2affix:is_thorns — 荆棘反伤（防止反射循环）

物品标签

• d2affix:unlock_0 — 普通难度解锁
• d2affix:unlock_1 — 噩梦难度解锁
• d2affix:unlock_2 — 地狱难度解锁

指令

所有指令需要权限等级 2（op）。

/d2affix

NBT 数据结构

全部存储于 PersistentData → d2affix：

d2affix/
├── affixes/ [ { id: "cold_enchanted" }, ... ]
├── component/ { teleport_cooldown: ... }
└── elite/
    ├── is_processed: bool
    ├── type_id: string
    ├── steps/ { fill_affixes, spawn_minions, ... }   (各步骤完成标记)
    └── parent_key: string  (随从的父类型显示用)

技术信息

• Mod ID: d2affix
• Minecraft: 1.20.1
• Forge: 47.4.10+
• 版本: 0.1.0-Beta
• 作者: PyroStella