Chinese Ancient Blade

**Ancient Chinese Weaponry Mod**

---

**Requirements:**
- Player Animator
- Geckolib

**Demo Videos:**
- Showcase: https://www.bilibili.com/video/BV1kHPAzzEMC
- Light Kung Fu: https://www.bilibili.com/video/BV19KFUzkErx

---

**About This Mod**

This mod adds ancient Chinese weapons to Minecraft, including the Tang Hengdao, Ring-shou Dao, Yanlingdao, Yanchidao, and Miaodao.

**Version History & Updates:**

- **Version 1.7.5 (1.20.1 Forge):** Added Yanlingdao, Yanchidao, Yanchi Changdao, and Miaodao. Added unique execution animations for these weapons and bare hands. Wall-running is now possible by sneaking while facing a wall.
- **Version 1.6.9 (1.20.1 Forge):** Updated and refined the Light Kung Fu system, adding new light body techniques.
- **Version 1.6.0 (1.20.1 Forge):** Added the Ring-hilted Dao and Ceremonial Sword. Corrected the Tang Hengdao's design for historical accuracy.
- **Version 1.3.9 (1.21.1 Neoforge) and earlier:** The Tang Hengdao in these versions was historically inaccurate. It has since been renamed to "Peidao" in later versions, with two new series of historically-accurate Tang Hengdao added.

*Note: Due to unexpected issues, the mod has migrated to 1.20.1 Forge and cannot currently return to 1.21.1 Neoforge. Apologies for the inconvenience.*

---

**Weapon Abilities**

Certain weapons grant special effects when wielded:

- **Ring-hilted Dao:** Attacks inflict "Bleeding" on targets for several seconds.
- **Nether Baodao, Golden Strategy Guard Hengdao, Cold Iron Spine Hengdao:** Continuously consumes small amounts of XP to sustain the Damage Absorption effect.
- **Blue Ice Jade Hengdao:** Continuously consumes small amounts of XP to sustain the Strength effect.
- **Sheathed Sword (Off-hand):** Grants Resistance I while held.

*Compatible with the Better Combat mod.*

---

**Crafting**

All weapons have built-in recipes and are obtainable in survival mode:
- Most weapons require crafting the blade and sheath separately
- Some require forging upgrades
- Others need a blade blank first, then the complete blade, followed by the sheath

*Installing a recipe viewer mod is recommended.*

---

**Light Kung Fu System**

Press **G** (default key) to activate internal energy, then:

- **Press G again** to perform Light Kung Fu (consumes small XP)
  - *On ground:* Longer leaps
  - *In air:* Shorter distance (requires momentum)
- **Water Sprinting:** Enabled while internal energy is active
- **Air Combos:**
  - Sneak + H = Three-kick combo
  - Shift + H (after charging) = Continuous flying kick (e.g., "Foshan Shadowless Kick")

---

**Credits & Disclaimer**

Weapon designs are inspired by various online sources and certain films/TV shows. Some designs have been modified from their original prototypes. Please point out any inaccuracies.

---