RandomAffix

⚠ Known Issues / 已知问题

Flight does not work in some modpacks. 飞行在部分整合包中无法使用。

This happens in modpacks that use PlayerAbilityLib (PAL) — for example, any pack that includes Origins or Apoli. 这种情况出现在使用了 PlayerAbilityLib（PAL）的整合包中，例如任何包含 Origins 或 Apoli 的整合包。

• Symptoms: the sword is summoned, but it stays in place and the player falls down. 症状： 剑能召唤出来，但剑停在原地，玩家向下掉落。
• Cause: PAL resets the vanilla flight ability (`mayfly) every time player abilities are synced. 原因： PAL 每次同步玩家能力时都会重置原版飞行能力（mayfly）。

Workaround: use version 1.1.2 or newer. If the problem persists, temporarily remove the following mods to isolate the conflict: 规避方法： 使用 1.1.2 或更新版本。若问题依旧，请暂时移除以下模组以隔离冲突：

• Icarus（伊卡洛斯）
• Paraglider（滑翔伞）
• ShoulderSurfing（越肩视角）
• BetterLockon（更好锁敌）
• LockOnMovementFix（锁敌移动修正）

Still investigating / 仍在排查中

I cannot confirm yet which mod causes this, because every modpack has a different mod list. 目前还无法确定到底是哪个模组导致的，因为每个整合包的模组列表都不一样。

• Sword Qi works normally. Only flight is affected. 剑气功能正常，只有飞行受影响。
• Summoning the orbiting flying sword has not been tested in these packs yet. 召唤环绕飞剑（御剑）尚未在这些整合包中测试过。
• If you have tested either feature, please leave a comment or open an issue with your result and your latest.log. If you happen to find the culprit mod, that would help a lot. Thank you. 如果有玩家测试过其中任一功能，欢迎留言或提交 Issue，附上测试结果和 latest.log。如果能顺便找到冲突模组就帮大忙了，十分感谢。

Random Affix turns every item you craft into a roll: vanilla gear, random stat affixes, and swords that can carry you into the sky.

## Affixes on everything you craft

Weapons, tools and armor roll a random set of affixes the moment they are crafted. No new items, no new blocks — everything rides on vanilla gear.

- Affix ranges scale with the material tier: a wooden sword rolls small numbers, a netherite one rolls absurd ones.
- Each affix has its own rarity (Common → Legendary), and values can roll negative — a bad affix is marked **Flawed**.
- The tooltip grades the whole item on a 10-step scale: Common → Rare → Epic → Divine → Legendary → Mythic → Peak → Peak Rare → Peak Epic → Peak Mythic.

**Weapons**: attack damage, attack speed, attack %, crit rate, crit damage, life steal, reach.
**Tools**: mining speed, plus the weapon stats.
**Armor**: max health, armor toughness, knockback resistance, crit rate / crit damage, movement speed. Boots can also roll max walk height (1–3 blocks), so hills stop requiring jumps.

## Anvil merging

Put two affixed items of the same type in an anvil: matching affixes keep the higher value, and every merge has a chance to push it further.

- 10% base chance, +3% for each merge that fails to improve, capped at 50%.
- A successful upgrade resets the odds back to 10%, so progress comes one step at a time.
- The three sword abilities are fixed values and never level up through the anvil.

## Sword arts

Three abilities, each available as an affix (level 1) or as an enchantment (higher levels).

**Sword Flight (御剑飞行, I–V)** — summon a sword under your feet and fly with plain vanilla controls: WASD, space to rise, Shift to dive. No seat, no camera fighting.

- Every sword has its own flight budget: it drains while flying, you glide down when it runs out, and it recharges on the ground (~2% per second).
- Touching the ground recalls the sword. Dying, logging out or changing dimension recalls it safely.

**Sword Control (御剑, I–III)** — orbiting swords that pick their own targets and attack on their own. Enchantment level = number of swords.

**Sword Qi (剑气, I–III)**

- Hold left-click to charge up to 1 second, release to fire a crescent of qi. It pierces everything in a 3 × 2 corridor for its full 32-block range, and your crit rate / attack % / life steal all apply to it.
- A charge of 50% or more carves a walkable tunnel through terrain, and mobs behind the hole still take damage.
- Tapping left-click has a 20% chance (guaranteed by the 6th attempt) to fire a weak qi that never breaks blocks.
- Each shot costs 1 durability.

**Elements** — swords can roll ·Fire or ·Ice, burning or freezing whatever the qi touches.

## Compatibility

- Forge 1.20.1, NeoForge 1.20.1, Forge 1.21.1, NeoForge 1.21.1
- Required on both client and server.
- Nothing is replaced: vanilla anvil, vanilla gear, vanilla enchanting table.