ElementalCraft: Reactions

Minecraft 版本： 1.20.1

平台： forge

标签： adventure game-mechanics mobs

ElementalCraft: Reactions Mod Introduction（中文描述在下方）

Welcome to ElementalCraft! This is a Minecraft mod centered around elemental combat, adding a new attribute system, elemental reactions, special enchantments, and stunning visual effects to vanilla survival and combat.

The following applies to the current version. Frost-related effects, reactions, and Iron's Spellbooks integration were added in V1.7.0. All content is based on actual source code.

? Core Elements

The game features 4 elemental types + None:

Each element has attack enchantments, enhancement enchantments, and resistance enchantments.

⚔️ Enchantment System

The mod adds 12 exclusive enchantments to weapons and armor (3 per element):

Weapon Enchantments (Attack Attributes)

• Fire Aspect / Nature Aspect / Frost Aspect / Thunder Aspect: Grants the weapon corresponding elemental attack, dealing additional elemental damage.
  • Can be enchanted on any weapon with attack damage (V1.7.0). (Previously limited to swords, axes, tridents, bows, crossbows)
  • Mutually exclusive with Flame, Fire Aspect, and Channeling.
  • Different elemental attack enchantments are mutually exclusive.

Armor Enchantments (Enhancement + Resistance)

• Fire Enhancement / Nature Enhancement / Frost Enhancement / Thunder Enhancement: Increases damage bonus for corresponding elemental attacks (fixed percentage per level).
• Fire Resistance / Nature Resistance / Frost Resistance / Thunder Resistance: Reduces damage taken from corresponding elemental attacks.
  • Can only be enchanted on armor (helmet, chestplate, leggings, boots).
  • Enhancement and resistance for the same element can coexist.
  • Different elemental enhancement enchantments are mutually exclusive, same with resistance enchantments.
  • Maximum enchantment level is dynamically calculated from configuration file (maxStatCap / points per level).

All enchantments can be obtained normally through enchanting tables, villager trades, loot chests, etc., or forcibly bound with commands.

? Elemental Weaknesses

Elements have weakness relationships (customizable in configuration):

• Default Weakness Chain: ? Fire → ? Nature → ⚡ Thunder → ❄️ Frost → ? Fire
  • Example: Fire attack against Nature → 1.5× elemental damage; Fire attack against Frost → 0.5× elemental damage.
  • Elemental relationships (weak/strong/none) can be viewed on entities using Jade info panel.

? Status Effects

The mod introduces 6 new status effects:

Parameters like duration and damage can be adjusted in configuration files.

? Elemental Reactions

? Fire-Related Reactions

? Nature-Related Reactions

⚡ Thunder-Related Reactions

❄️ Frost-Related Reactions (V1.7.0)

Universal Reactions

All reaction parameters can be adjusted in configuration files.

? Biome Elemental Bias

Different biomes generate creatures with specific elemental tendencies:

• ? Hot biomes (desert, badlands, nether, etc.) → Fire bias
• ❄️ Cold biomes (snow plains, ice spikes, etc.) → Frost bias
• ? Forest/jungle biomes → Nature bias
• ⛈️ Thunderstorm weather (global) → Thunder bias

? Mob Attribute System

Mobs can randomly receive elemental attributes when spawning, based on biome bias and configuration:

Attribute Assignment (V1.7.0)

• Hostile mobs (Monsters) have a configurable chance to receive elemental attributes on spawn.
• Neutral mobs (NeutralMob, Piglins) have a separate, lower chance.
• The assigned element is determined by biome elemental bias (e.g., Nether → Fire, End → Thunder).
• Each mob can receive: an attack element (chance-based), enhancement points (distributed across 4 armor slots), and resistance points (distributed across 4 armor slots).
• Resistance type may be the counter element to the attack type (configurable chance).

Equipment & Durability (V1.7.0)

• Mobs with attack attributes receive an Iron Sword with the corresponding elemental attack enchantment (e.g., Fire Aspect) and Unbreaking III.
• Armor pieces (iron armor) are automatically generated with enhancement and/or resistance enchantments + Unbreaking III.
• All equipment drop chances are set to 0% by default (items are not dropped).

Enchanted Book Drops (V1.7.0)

• When a mob with elemental attributes dies, it has a chance to drop an enchanted book (affected by Looting level).
• The book can contain one of: the mob's attack enchantment, enhancement enchantment (random level based on enhancement points), or resistance enchantment (random level based on resistance points).
• Book level is weighted toward the mob's actual attribute quality.

Dimension Defaults

• Nether: All mobs default to Fire element (configurable).
• End: All mobs default to Thunder element (configurable).

Mob Flee Behavior (V1.7.0)

• Mobs near entities with active Scorched Aura, Frostbite Aura, or Static Aura will attempt to flee (pathfind away from the aura source).

?️ Command System (Admin/OP)

All commands start with /elementalcraft and support Tab completion.

Debug Mode

/elementalcraft debug  # Toggle debug mode, displays elemental damage calculations and reaction info

Reload Config

/elementalcraft reload  # Reload all configuration caches from disk

Biome Bias Management

/elementalcraft biome add <element> <probability>
/elementalcraft biome remove <element>
/elementalcraft biome list

Forced Entity Attributes

/elementalcraft entity add <attack element> [enhancement element] [enhancement points] [resistance element] [resistance points]
Example: /elementalcraft entity add fire fire 50 frost 20
Points support fixed values (e.g., 50) or ranges (e.g., 20-80)
All parameters after attack element are optional (default: none, 0, none, 0)
/elementalcraft entity remove              # Clear forced attributes on held spawn egg

Entity Attribute Blacklist

/elementalcraft entity blacklist add <element>      # Hold spawn egg, prevent entity from carrying specific element (or "all" for all)
/elementalcraft entity blacklist remove <element>
/elementalcraft entity blacklist list

Forced Item Attributes

• Weapons:

  /elementalcraft item weapon add <element>       # Bind attack attribute (hold weapon)
  /elementalcraft item weapon remove              # Remove forced weapon attribute (hold weapon)

• Armor:

  /elementalcraft item armor add <enhancement element> [enhancement points] [resistance element] [resistance points]
  # Bind enhancement+resistance attributes (hold armor piece)
  # Enhancement element is required; points, resist element, resist points are optional (default: 0, none, 0)
  /elementalcraft item armor remove               # Remove forced armor attributes (hold armor piece)

Effect Immunity Blacklist

# Command format (using Scorched as example):
/elementalcraft blacklist scorched add/remove/list
# All effects: scorched (灼烧), spore (孢子), static (静电), paralysis (麻痹), frostbite (霜冻), freeze (冻结), steam (蒸汽), wetness (潮湿)

Configuration File Operations

• Changes made via commands are automatically saved and hot-loaded, no restart needed.
• Directly edit TOML files in config/ElementalCraft/, mod automatically detects and refreshes every 100 ticks.

✨ Visual Effects (Graded by Enhancement Points)

When equipment enhancement points reach thresholds, visual effects are triggered (threshold = maxStatCap configuration value):

Melee Swing Effects

• ? Fire: Flame arcs (higher levels add soul flames, lava, smoke)
• ? Nature: Compost particles, spore flowers (higher levels add cherry blossoms, waxed particles)
• ❄️ Frost: Ice rune particles, snowflake particles (higher levels add frost overlay, frozen ice layers, snow layer effects)
• ⚡ Thunder: Glowing particle arcs (higher levels add reverse portal, lightning arcs)

Ranged Projectile Effects

• ? Fire: Double spiral flame trail (outer flame, inner soul flame, lava particles at tail)
• ? Nature: Cherry blossom spiral trail (tail with happy villager particles)
• ❄️ Frost: Frost snowflake particle trail (higher levels add frostbite overlay, ice rune particles)
• ⚡ Thunder: Lightning spark spiral trail (higher levels add ender candles, reverse portals, dragon breath)

Impact Explosion Effects

• Bursts of corresponding elemental particles (flame/lava, cherry blossoms/spore flowers, ice runes/snowflakes, glowing/ender candles, etc.)
• Effect intensity increases linearly with level, max level is extremely impressive. Can be adjusted in elementalcraft-visuals.toml.

Frost-Specific Visual Effects (V1.7.0)

• Frostbite Overlay: Screen overlay when entity has Frostbite effect
• Frostbite Snow Layer: Snow layer rendering on frozen entities
• Frozen Ice Layer: Ice shell visual on Frozen entities

⚙️ Configuration Files (Server/Client)

Configuration files are located in config/ElementalCraft/:

Supports hot-loading: modifications are automatically refreshed after saving.

? Iron's Spellbooks Integration (V1.7.0, Unfinished, for reference only)

When Iron's Spellbooks is installed alongside ElementalCraft, additional integration features are enabled:

Thunder Spell Reactions

• Lightning spells (Lightning Lance, Chain Lightning, Ball Lightning, Electrocute, Lightning Bolt, Shockwave, Thunderstorm, Ascension, Volt Strike) apply Static Shock stacks to targets based on caster's Thunder Enhancement points.
• If the target has Wetness, lightning spells trigger Paralysis.
• If the target is in water, lightning spells trigger Water Electrification (affects all entities in water in range).
• If the target has Flammable Spores, lightning spells can trigger Spore Blast.

Nature Spell Reactions

• Nature spells (Acid Orb, Poison Arrow, Earthquake, Firefly Swarm, Poison Spray, Stomp, etc.) trigger Nature Parasitism (spore application) based on caster's Nature Enhancement points.

Poison Cloud + Fire Reaction

• When a fire-enchanted projectile (Fire Aspect, Flaming Arrows, or burning arrows) collides with an ISS Poison Cloud, it triggers a Toxic Blast explosion.
• The explosion damage and radius scale with the attacker's Fire Enhancement points.
• Scorched Aura entities near a Poison Cloud can also trigger this reaction.

ROOT Spell Integration

• When the ROOT spell hits a target, it applies Flammable Spores stacks based on the caster's Nature Enhancement.
• If a fire-attribute attack hits a ROOTed target and triggers Scorched, the ROOT is removed and Scorching duration/damage is enhanced (same as Poison Enhancement).

Mob Caster AI

• Certain mobs automatically receive Thunder or Nature spell scrolls (enchanted with Thunder Aspect or Nature Aspect).
• Thunder caster mobs: Target Wet entities for Paralysis. Throw Splash Water Bottles at targets to apply Wetness before casting.
• Nature caster mobs: Cast nature damage spells and apply spores via ROOT spell.
• Mobs enter aggressive mode (faster casting) when health drops below 50%.
• Spell scrolls have a configurable drop chance (default: 100%).

Configuration

• ISS integration is configured in the main config files and only loads when Iron's Spellbooks is installed.
• Parameters include: thunder enhancement per static stack, nature enhancement per spore stack, mob casting cooldowns, scroll drop chance, etc.

属性锻造：元素反应 模组介绍

欢迎来到《属性锻造：元素反应》！这是一款围绕元素战斗打造的Minecraft模组，为原版生存与战斗玩法新增了全新的属性系统、元素反应机制、专属附魔以及炫酷的视觉特效。

以下内容适用于当前版本。冰霜属性相关效果、元素反应及Iron's Spellbooks法术联动于V1.7.0版本更新。所有内容根据代码实际内容编写。

? 核心元素

游戏内包含4种基础元素属性 + 无属性：

每种元素均配有攻击附魔、强化附魔和抗性附魔。

⚔️ 附魔系统

模组为武器和防具新增了12种专属附魔（每种元素对应3种）：

武器附魔（攻击属性）

• 赤焰属性 / 自然属性 / 冰霜属性 / 雷霆属性：为武器赋予对应元素的攻击效果，对敌人造成额外的元素伤害。
  • 可附魔在所有有伤害的武器上 (V1.7.0)。（此前仅限剑、斧、三叉戟、弓和弩）
  • 与火焰附加、火矢、引雷附魔互斥。
  • 不同元素的攻击附魔之间也相互排斥。

防具附魔（强化 + 抗性）

• 赤焰强化 / 自然强化 / 冰霜强化 / 雷霆强化：提升对应元素攻击的伤害加成（每级为固定百分比）。
• 赤焰抗性 / 自然抗性 / 冰霜抗性 / 雷霆抗性：降低受到的对应元素攻击伤害。
  • 仅可附魔在防具（头盔、胸甲、护腿、靴子）上。
  • 同一种元素的强化附魔和抗性附魔可以共存。
  • 不同元素的强化附魔之间相互排斥，抗性附魔同理。
  • 附魔最高等级由配置文件动态计算（最大属性上限 / 每级所需点数）。

所有附魔均可通过附魔台、村民交易、战利品宝箱等常规方式获取，也可通过指令强制绑定。

? 元素克制关系

元素之间存在克制关系（可在配置文件中自定义）：

• 默认克制链：? 赤焰 → ? 自然 → ⚡ 雷霆 → ❄️ 冰霜 → ? 赤焰
  • 示例：赤焰攻击自然属性目标 → 1.5倍属性伤害；赤焰攻击冰霜属性目标 → 0.5倍属性伤害。
  • 可通过Jade信息面板查看实体的元素关系（克制/被克制/无关系）。

? 状态效果

模组新增了6种全新的状态效果：

持续时间、伤害等参数均可在配置文件中调整。

? 元素反应

? 赤焰相关反应

? 自然相关反应

⚡ 雷霆相关反应

❄️ 冰霜相关反应 (V1.7.0)

通用反应

所有反应参数均可在配置文件中调整。

? 群系元素偏向

不同群系生成的生物会带有特定的元素倾向：

• ? 炎热群系（沙漠、恶地、下界等）→ 赤焰偏向
• ❄️ 寒冷群系（雪原、冰刺平原等）→ 冰霜偏向
• ? 森林/丛林群系 → 自然偏向
• ⛈️ 雷暴天气（全局）→ 雷霆偏向

? 生物属性系统

生物在生成时可以根据群系偏向和配置随机获得元素属性：

属性分配 (V1.7.0)

• 敌对生物（Monster）有可配置的概率在生成时获得元素属性。
• 中立生物（NeutralMob、猪灵）有独立的、较低的概率。
• 分配的元素由群系元素偏向决定（如下界→赤焰，末地→雷霆）。
• 每个生物可获得：攻击元素（概率触发）、强化点数（分配到4个防具槽位）、抗性点数（分配到4个防具槽位）。
• 抗性类型可能是攻击元素的克制元素（可配置概率）。

装备与耐久 (V1.7.0)

• 拥有攻击属性的生物会获得一把铁剑，附带对应的元素攻击附魔（如赤焰属性）和耐久III。
• 防具（铁甲）会自动生成，附带强化和/或抗性附魔 + 耐久III。
• 所有装备掉落概率默认设为0%（不掉落装备本身）。

附魔书掉落 (V1.7.0)

• 拥有元素属性的生物死亡时，有概率掉落附魔书（受抢夺等级影响）。
• 附魔书可包含：生物的攻击附魔、强化附魔（随机等级，基于强化点数）、或抗性附魔（随机等级，基于抗性点数）。
• 附魔书等级加权偏向生物的实际属性质量。

维度默认值

• 下界：所有生物默认为赤焰属性（可配置）。
• 末地：所有生物默认为雷霆属性（可配置）。

生物逃跑行为 (V1.7.0)

• 靠近拥有灼烧光环、霜冻光环或静电光环效果的实体时，生物会尝试逃跑（远离光环来源寻路）。

?️ 指令系统（管理员/OP专用）

所有指令均以 /elementalcraft 开头，支持Tab补全。

调试模式

/elementalcraft debug  # 切换调试模式，显示元素伤害计算过程和反应相关信息

重载配置

/elementalcraft reload  # 从磁盘重新加载所有配置缓存

群系偏向管理

/elementalcraft biome add <元素> <概率>
/elementalcraft biome remove <元素>
/elementalcraft biome list

强制实体属性

/elementalcraft entity add <攻击元素> [强化元素] [强化点数] [抗性元素] [抗性点数]
示例：/elementalcraft entity add fire fire 50 frost 20
点数支持固定值（如50）或范围值（如20-80）
攻击元素之后的所有参数均为可选（默认：无、0、无、0）
/elementalcraft entity remove              # 清除手持刷怪蛋对应的实体强制属性

实体属性黑名单

/elementalcraft entity blacklist add <元素>      # 手持刷怪蛋，禁止该实体携带指定元素（或填写"all"表示所有元素）
/elementalcraft entity blacklist remove <元素>
/elementalcraft entity blacklist list

强制物品属性

• 武器：

  /elementalcraft item weapon add <元素>       # 绑定攻击属性（手持武器）
  /elementalcraft item weapon remove           # 移除强制武器属性（手持武器）

• 防具：

  /elementalcraft item armor add <强化元素> [强化点数] [抗性元素] [抗性点数]
  # 绑定强化+抗性属性（手持防具）
  # 强化元素为必填；点数、抗性元素、抗性点数为可选（默认：0、无、0）
  /elementalcraft item armor remove            # 移除强制防具属性（手持防具）

效果免疫黑名单

# 指令格式（以灼烧为例）：
/elementalcraft blacklist scorched add/remove/list
# 全部效果：scorched（灼烧）、spore（孢子）、static（静电）、paralysis（麻痹）、frostbite（霜冻）、freeze（冻结）、steam（蒸汽）、wetness（潮湿）

配置文件操作

• 通过指令做出的修改会自动保存并热加载，无需重启服务器。
• 直接编辑 config/ElementalCraft/ 目录下的TOML文件，模组每100刻会自动检测并刷新配置。

✨ 视觉特效（按强化点数分级）

当装备的强化点数达到阈值时，会触发对应的视觉特效（阈值 = 配置文件中的maxStatCap值）：

近战挥砍特效

• ? 赤焰：火焰弧光（高等级追加灵魂火、熔岩、烟雾效果）
• ? 自然：堆肥粒子、孢子花（高等级追加樱花、蜡质粒子效果）
• ❄️ 冰霜：冰符文粒子、雪花粒子（高等级追加霜冻覆盖层、冻结冰层、积雪层效果）
• ⚡ 雷霆：发光粒子弧光（高等级追加反向传送门、闪电弧光效果）

远程投射物特效

• ? 赤焰：双螺旋火焰轨迹（外层火焰、内层灵魂火，尾部附带熔岩粒子）
• ? 自然：樱花螺旋轨迹（尾部附带村民喜悦粒子）
• ❄️ 冰霜：雪花粒子螺旋轨迹（高等级追加霜冻覆盖层、冰符文粒子）
• ⚡ 雷霆：闪电火花螺旋轨迹（高等级追加末地蜡烛、反向传送门、龙息效果）

撞击爆炸特效

• 对应元素粒子爆发（火焰/熔岩、樱花/孢子花、冰符文/雪花、发光粒子/末地蜡烛等）
• 特效强度随等级线性提升，最高等级效果极具视觉冲击力。可在 elementalcraft-visuals.toml 中调整。

冰霜专属视觉效果 (V1.7.0)

• 霜冻覆盖层：实体带有霜冻效果时的屏幕覆盖层
• 霜冻积雪层：冻结实体上的积雪渲染
• 冻结冰层：冻结实体的冰壳视觉效果

⚙️ 配置文件（服务端/客户端）

配置文件位于 config/ElementalCraft/ 目录下：

支持热加载：保存修改后配置会自动刷新。

? Iron's Spellbooks 联动 (V1.7.0，未完成，仅供参考)

当 Iron's Spellbooks（铁的法术书）与 ElementalCraft 同时安装时，将启用额外的联动功能：

雷霆法术反应

• 闪电法术（闪电长矛、连锁闪电、球状闪电、电击、闪电束、冲击波、雷暴、升天、伏特打击）根据施法者的雷霆强化点数对目标施加静电层数。
• 若目标有潮湿效果，闪电法术会触发麻痹。
• 若目标在水中，闪电法术会触发感电水域（影响范围内水中所有实体）。
• 若目标带有易燃孢子，闪电法术可触发孢子引爆。

自然法术反应

• 自然法术（酸液球、毒箭、地震、萤火虫群、毒雾喷射、践踏等）根据施法者的自然强化点数触发自然寄生（施加孢子）。

毒雾云 + 赤焰反应

• 当带有赤焰附魔的投射物（赤焰属性、火矢、或燃烧的箭矢）碰触ISS的毒雾云时，会触发毒火爆燃爆炸。
• 爆炸伤害和范围随攻击者的赤焰强化点数提升。
• 灼烧光环实体靠近毒雾云时也可触发此反应。

ROOT法术联动

• ROOT法术命中目标时，根据施法者的自然强化点数施加易燃孢子层数。
• 若赤焰属性攻击命中被ROOT的目标并触发灼烧，则ROOT被移除，灼烧持续时间和伤害增强（与中毒增幅相同）。

生物施法AI

• 特定生物自动获得雷霆或自然法术卷轴（附有雷霆属性或自然属性附魔）。
• 雷霆施法生物：瞄准潮湿目标施法以触发麻痹。向目标投掷喷溅水瓶施加潮湿后再施法。
• 自然施法生物：施放自然伤害法术并通过ROOT法术施加孢子。
• 生物在生命值低于50%时进入激进模式（施法更频繁）。
• 法术卷轴掉落概率可配置（默认：100%）。

配置

• ISS联动配置在主配置文件中，仅在Iron's Spellbooks安装时加载。