Dragon Curse Chronicles

A Minecraft mod inspired by the classic animated series Jackie Chan Adventures, recreating the powers of the Twelve Chinese Zodiac Talismans. Expanded gameplay includes the Origin Power enchantment, Uncle's Dried Puffer Fish, and a custom particle rendering API.

跳转至中文介绍: README.md

---

Platform Support

Loader	Minecraft Version	Mod Version	Status
Minecraft Forge	1.20.1	0.2.4-rc-9	✅ Released, feature-complete
Fabric	1.20.1	1.0.6-1.20.1Fabric	✅ Released, feature-complete
NeoForge	1.21.1	0.1.0-1.21.1NeoForge	✅ Released, feature-complete

All three loaders ship with feature parity. Each platform requires three jars to be installed together: the main mod + DC Render API dependency + a Kotlin language adapter (see Installation below).

---

Features

• Twelve Talismans System: Re-creates the powers of the Rat, Ox, Tiger (WIP), Rabbit, Dragon, Snake, Horse, Sheep, Monkey (WIP), Rooster, Dog, and Pig. Each talisman has dedicated particles and sound effects.
• Origin Power Enchantment: 10-level progressive enchantment. Levels 1–5 are obtainable from the enchanting table and villager trades; levels 6–10 are crafted by combining 4 books of level N → 1 book of level N+1. Full armor unlocks 6 layered effects: reflection, damage reduction, energy shield, health regeneration, knockback immunity, and Origin Aura.
• Origin Aura: 10-block radius effect, toggleable via custom keybind (unbound by default). Applies continuous Origin End damage to nearby entities.
• Uncle's Dried Puffer Fish: Right-click fires a green laser (no charge-up) with two counter-rotating spiral particle bands and gradient colors, then enters a 5-second cooldown. Includes a specialized "five-kill-chain" bypass for bosses such as the Draconic Guardian.
• Custom Particle API (DC Render API): Home-grown particle dispatcher featuring color/particle object pooling, frame-aware batching, LOD distance falloff, and progressive emission — bypassing aggressive culling performed by client-side particle optimization mods.
• Talisman Power Extractor & Cube of Tang Shan: Extract talismanic essence from animals. The Cube of Tang Shan drops from Meteor Shower loot chests at 35% chance.
• Meteor Shower Event: 30% chance to trigger every Overworld midnight. Chests spawn inside impact craters with Cube of Tang Shan, Talisman Base, and other rare items. Trigger manually with /meteorshower start (OP only).
• Sheep Talisman — Soul Out-of-Body: Invisibility + Night Vision + Flight + No-Clip + Invulnerability. Returns the player to their recorded body position when deactivated.
• Data-driven recipes: Datapack recipes are provided for all talismans, Talisman Base, and Origin Power book upgrades.

---

Talisman Reference

✅ Implemented

Talisman	Ability	Usage
🐭 Rat	Transform specific blocks into the matching creatures	Hold and right-click the target block
🐮 Ox	Strength III + Resistance III + Speed II	Hold and right-click — 3-minute duration
🐇 Rabbit	Speed boost + 5-block teleport. Chicken + Rabbit combo (flight) is unlocked if the Rooster's Levitation is active first	Hold and right-click
🐉 Dragon	Fires a ghast-style fireball with a flaming particle trail, dealing AoE explosion damage	Hold and right-click — 1-second cooldown
🐍 Snake	Enhanced Invisibility II + custom Snake Power icon	Hold and right-click — 5-minute duration
🐎 Horse	Fully heals the player and clears 10 negative effects (Poison, Wither, Weakness, Slowness, Blindness, Hunger, Levitation, Glowing, Bad Omen, Darkness)	Hold and right-click — 1-minute Horse Power
🐑 Sheep	Soul Out-of-Body: Invisibility + Night Vision + Flight + No-Clip + Invulnerability. Body position is saved and restored on exit	Hold and right-click to toggle
🐔 Rooster	Slow Falling / Levitation modes. When Levitation is active, right-click Rabbit Talisman to trigger Chicken-Rabbit Flight.	Right-click fires mode. Shift + right-click switches mode
🐶 Dog	Health regen + clears 10 debuffs + sustained damage absorption (renewing every 30s)	Hold and right-click
🐷 Pig	Fires a high-energy laser dealing 99 damage + ignites targets along the line. Custom particle track	Hold and right-click — 2-second cooldown

🔧 Work In Progress (WIP)

• 🐯 Tiger: Good/Evil Separation — spawns a benevolent and a malicious clone of the player
• 🐒 Monkey: Polymorph Power — randomly transforms target mobs into other creatures

---

Origin Power Enchantment

Item	Details
Acquisition	Levels 1–5: Enchanting Table / Villager Trades (higher level = lower probability). Levels 6–10: Combine 4 × Level N books in a crafting table → 1 × Level N+1 book.
Max Level	10
Valid Equipment	Any armor piece (helmet, chestplate, leggings, boots). Enchanting non-armor has no effect.
Origin End Damage	Triggered by Uncle's Dried Puffer Fish via the custom origin_end damage type, bypassing most defenses, effects, and invulnerability.

Armor Effect Ladder (unlocked by total level across 4 armor slots)

Total Level Tier	Unlocked Effect
1+	Damage Reflection — reflects a portion of damage back to the attacker (scales with level)
5+	Damage Reduction — tiered DR, strongest at the highest bracket
10+	Energy Shield — periodic damage absorption
15+	Regeneration — periodic healing ticks
20+	Knockback Immunity — no longer knocked back
25+	Origin Aura — continuous Origin End damage to all entities within a 10-block radius. Toggle via keybind.

Aura keybind is unbound by default; set it in Controls → Key Binds. Toggle state is network-synced and persisted per player.

---

Uncle's Dried Puffer Fish

• Trigger: Right-click fires a green laser immediately (no charge-up), then enters a 5-second cooldown.
• Damage Pipeline: Origin End damage type; uses a specialized kill-chain for bosses like the Draconic Guardian (break shield → attack head → execute).
• Visual Pipeline: Green central beam + 2 counter-rotating helical bands (green→cyan gradient and purple→pink gradient). ~1200 particle candidates are enqueued per shot and emitted progressively near→far via SmartParticleDispatcher (pooled + LOD).
• Audio: Uncle's "Madgaq" voice line on cast, followed by a firework blast + ambient fire sound on impact.

---

Items & Events

Talisman Power Extractor

• Usage: Main hand = Extractor, offhand = Talisman Base → right-click an animal to extract.
• Probability: 10% by default, configurable via config file.
• Use limits: Rooster/Dragon/Pig = 100 attempts each; all others = 10 attempts each (hardcoded).
• Obtainment: Crafting recipe.

Cube of Tang Shan

• Usage: Same flow as the Extractor, but only works on sheep — yields Sheep Talisman.
• Obtainment: Meteor Shower loot chest (35% chance).

Meteor Shower Event

• Trigger time: Overworld midnight 00:00, 30% chance per night.
• Manual trigger: OP players run /meteorshower start.
• Rewards: Chest(s) spawn inside meteor craters with the Cube of Tang Shan, Talisman Bases, and other rare loot.

---

Installation

⚠ All three loaders require the three-jar setup: Main Mod + DC Render API + Kotlin Language Adapter. Missing any of the three will crash during load.

Forge 1.20.1

1. Install Minecraft Forge 1.20.1 (47.x or newer).
2. Download these three Forge jars:
   • Kotlin Adapter: Kotlin-for-Forge-*-1.20.1.jar (by thedarkcolour, available on CurseForge and Modrinth)
   • DC Render API (required dependency): dcrapi-X.X.X-1.20.1Forge.jar
   • Main Mod: dcc-0.2.4-rc-9.jar
3. Drop all three jars into your mods/ folder.
4. Launch the game.

Fabric 1.20.1

1. Install Fabric Loader 0.16.13+ and Fabric API 0.92.11+1.20.1.
2. Download these three Fabric jars:
   • Kotlin Adapter: fabric-language-kotlin-* (available on CurseForge and Modrinth)
   • DC Render API (required dependency): dcrapi-X.X.X-1.20.1Fabric.jar
   • Main Mod: dcc-1.0.6-1.20.1Fabric.jar
3. Drop all three jars into your mods/ folder.
4. Launch the game.

NeoForge 1.21.1

1. Install NeoForge 21.1.248+ for Minecraft 1.21.1.
2. Download these three NeoForge jars:
   • Kotlin Adapter: Kotlin-for-Forge-*-1.21.1-NeoForge.jar (by thedarkcolour, available on CurseForge and Modrinth)
   • DC Render API (required dependency): dcrapi-*-1.21.1NeoForge.jar
   • Main Mod: dcc-0.1.0-1.21.1NeoForge.jar
3. Drop all three jars into your mods/ folder.
4. Launch the game.

---

Building & Developing

Project Structure

Twelve Talismans/                           # Monorepo root
├── src/main/java/com/qituo/dcc/            # Forge 1.20.1 main mod sources
├── fabric/Dragon Curse Chronicles/src/     # Fabric 1.20.1 main mod sources
├── neoforge/src/main/java/com/qituo/dcc/   # NeoForge 1.21.1 main mod sources
├── DC Render API/                          # Particle API dependency subdirectory
│   ├── src/                                # Forge API
│   ├── fabric/DC Render API/               # Fabric API
│   └── neoforge/                           # NeoForge API
├── gradle.properties                       # Forge version numbering
├── README.md / README_en.md                # Chinese / English documentation

Build Commands

# Forge 1.20.1 (repo root)
./gradlew build            # artifact → build/libs/dcc-0.2.4-rc-9.jar

# Fabric 1.20.1
cd fabric/Dragon\ Curse\ Chronicles
./gradlew build            # artifact → build/libs/dcc-1.0.6-1.20.1Fabric.jar

# NeoForge 1.21.1
cd neoforge
./gradlew build            # artifact → build/libs/dcc-0.1.0-1.21.1NeoForge.jar

A -sources.jar is generated automatically for every build.

---

Roadmap

• Full implementations of Monkey (Polymorph) and Tiger (Good/Evil Split) Talismans.
• Polish and expand remaining feature details on the NeoForge 1.21.1 side.
• Talisman Box GUI & hotbar quick-switch.
• Replace the current Origin Power NBT-stub approach with a true datapack-driven enchantment registration.

---

Contributing

Issues, feature requests, and pull requests are always welcome!

---

License

This project is released under the MIT License — see LICENSE.md.