Pearl Ascension

⚠️ Beta Version — This mod is currently in Beta phase. Core features have been implemented and tested, but there may still be undiscovered issues. Bug reports and suggestions are welcome!(Website URL:http://ad.rainplay.cn:50389)

An ender-pearl enhancement mod with chrono throws, swap sigils, and weapon synergies.

!Replace this with a description

---

✦ Features

⏱ Chrono Pause — 时空暂停

Press V to freeze yourself in place and enter Chrono Pause mode. While frozen, throwing ender pearls doesn't teleport you immediately — instead, target positions are queued (up to 8 pearls). Use the mouse scroll wheel to adjust throw distance scaling (0.25× ~ 4.0×). Press V again to release — pearls fire in nearest-first order, one per second.

• Queue up to 8 ender pearls before releasing
• Scroll to adjust distance scaling in real-time
• Can be used in coordination with weapons
• Pearls release from nearest to farthest
• Hunger cost scales with distance
• Singleplayer: optional global tick freeze
• Multiplayer: safe mode by default (no impact on other players)

!Replace this with a description

Chrono Pause HUD overlay with distance scaling indicator and ash particle path preview.

!Replace this with a description

Queued pearls shown with particle trail previews before release.

---

🔄 Swap Sigil — 移形换位

A custom enchantment "Swap Position" for ender pearls. Instead of teleporting the thrower to the landing point, a Swap Pearl swaps positions between the thrower and the hit entity.

How to obtain:

• Anvil: Ender Pearl + Enchanted Book (Swap Position) — costs 5 XP levels
• Loot: Mineshaft & Dungeon chests have a 20% chance to contain the enchantment book
• Villager Trade: Librarian level 3 — 24 Emeralds + Book → Swap Position book

!Replace this with a description

Position swap on hit with portal particle effects and enderman teleport sound.

!Replace this with a description

Anvil crafting: combining an ender pearl with a Swap Position enchanted book.

---

⚔ Weapon Synergy — 武器协同

Hold a sword/axe in main hand and an ender pearl in off-hand, then press Ctrl + Left Click to trigger a synergy attack. The pearl launches along your look direction, teleports you, and delivers an auto-crit on the nearest enemy.

• Consumes 1 off-hand ender pearl + hunger
• Synergy distance = base distance × 1.5× multiplier (default 27 blocks)
• Auto-crit: auto-face nearest enemy, deal max(attack damage, 6.0) × 1.75× damage
• Works with Chrono Pause — queued synergy pearls auto-crit on release
• Auto-target range: 6 blocks

Ctrl + Left Click triggers the synergy: teleport + auto-crit combo.

!Replace this with a description

Auto-crit particle burst on the target after synergy teleport.

---

✦ Controls

Action	Key	Notes
Toggle Chrono Pause	V	Freeze/unfreeze yourself
Adjust throw distance	Scroll Wheel	Only while Chrono is active
Trigger Weapon Synergy	Ctrl + Left Click	Main hand weapon + off-hand pearl
Open Config	O	Cloth Config GUI

---

✦ Configuration

All features are fully configurable via Cloth Config (press O or use ModMenu).

Chrono Pause:

• Enable/disable Chrono Pause
• Multiplayer safe mode / Singleplayer global freeze
• Parabolic vs. linear trajectory
• Max stored pearls (1–32), base distance (4–64), scroll step
• Hunger cost: base cost + distance factor

Swap Sigil:

• Enable/disable Swap Sigil enchantment

Weapon Synergy:

• Enable/disable Weapon Synergy
• Off-hand pearl bonus damage, hunger cost
• Distance multiplier, auto-crit multiplier, auto-target range

!Replace this with a description

Cloth Config integration with ModMenu support.

---

✦ Requirements

Dependency	Version
Minecraft	1.21.1
Fabric Loader	≥ 0.16.10
Fabric API	Any (1.21.1)
Cloth Config	≥ 15.0.0
Java	≥ 21

Recommended: ModMenu for easy config access

---

✦ License

All Rights Reserved/No License

---

✦ Credits

• Author: mccmcaozr
• Loader: Fabric
• Config Lib: Cloth Config by shedaniel