Xiaoxiang Cultivation World

A deep Eastern xianxia/cultivation mod for Minecraft 1.20.1. Cultivate your spirit, break through 11 realms, master 23 techniques, learn 25 powerful spells, and ascend to true immortality.

⚡ Highlights

🌌 11 Cultivation Realms from Mortal to True Immortal, each split into 4 sub-stages (Early / Middle / Late / Peak)
🌀 23 Cultivation Techniques — equip a technique to unlock the cultivation system and gain stat bonuses (attack / defense / move-speed / spell power / passive effects …)
⚔️ 25 Spells including charge-up Great Fireball, Sword Convergence, passive Qi Flight (creative-mode flight that drains qi), Qi Shield, Spirit Vision, and 20+ more
💎 4-tier Spirit Stones with matching ores — mine, eat for qi, or craft 9→1 to upgrade tiers
🌪️ Heavenly Tribulation lightning when breaking through realms (1~100 strikes depending on realm)
🧘 Meditation Cushion — sit cross-legged to absorb qi 10× faster
🎯 7 Qi Elements: Pure / Metal / Wood / Water / Fire / Earth / Ice — accumulate elemental qi to amplify matching spells
🏛️ Worldgen Structures — 5 intact + 5 ruined cultivation buildings with loot chests
🎨 Custom UI — cultivation panel (default G) + spell wheel (default V, hold-to-show + direction-snap)
🌍 Multi-language: English / 繁體中文 / 简体中文

Player Cultivation Panel - Techniques Tab

Player Cultivation Panel - Spells Tab

Undergoing the Lightning Tribulation:

Undergoing the Lightning Tribulation

🔥 Spectacular Spells (Showcase)

Great Fireball (Supreme · Active · Charge-up)

Hold the cast key to channel qi into an ever-growing fireball. Visual diameter, explosion radius, damage, and the number of "fireball rain" sub-projectiles all scale exponentially with channeled qi. Tap for a 1-block-wide pellet, or hold until your qi runs out for an apocalyptic 80-block-wide blazing sphere.

Qi Flight (Supreme · Passive)

Toggle on for full creative-mode flight (same double-tap-jump + space + sneak controls). Drains qi continuously while in the air; no cost when grounded. Auto-cancels when qi runs out — better land before that happens.

Sword Convergence (Supreme · Active · Charge-up)

Requires a sword in main hand. Hold to spawn waves of immortal flying swords that home onto your crosshair, exploding on impact and re-targeting until you release. The longer you hold, the faster they spawn and the wider they spread — at peak charge, blades fill the sky.

Star Fall (天星墜) — Immortal-tier Fire Active Spell

Channel meteoric fire from the heavens to obliterate your foes from above.

Tap to fire (1,000 Qi): Summons a single small meteor that drops from high above the player's head and streaks down toward the crosshair location. Explodes on impact, igniting the area — roughly twice the power of a Great Fireball tap-cast.
Hold to channel (1,000+ Qi/sec): Continuously rains small meteors from the sky toward your aim, scattering across the target zone like a meteor storm.
5-Second Full Charge (10,000 Qi): Unleashes a Mega Meteor — a 20-block-wide colossus that materializes 200 blocks above the crosshair and slowly accelerates downward. Impact creates an explosion 20× the power of a Great Fireball, an outward shockwave, and a persistent multi-second mushroom cloud. The thunder is audible from up to 1,920 blocks away.

Star Fall

Star Fall 2

Star Fall 3

Sword Aura (劍氣) — Supreme-tier Metal Passive Spell

The mark of a true blade master — every swing carries a slicing crescent of cultivated Qi.

Trigger: Hold any sword and left-click into empty air or a block (not an entity) to release a flying crescent-shaped sword aura along your line of sight. Costs 50 Qi per release.
On entity hit: 100 damage (200 if your primary Qi element is Metal) plus an element-based status effect.
On block hit: No block destruction, but a small AoE damage burst at the impact point. Fire element will ignite blocks.
Element effects on hit:
- None — Pure 100 damage
- Ice — Freeze + Slowness + Blindness
- Metal — Doubled damage (200)
- Wood — Strong Poison
- Water — Drowning
- Fire — Burning
- Earth — Weakness

The aura's color, particles, and effect dynamically match your active Qi element.

Sword Aura

Sky-Splitting Sword Aura (裂天劍氣) — Immortal-tier Metal Active Spell

The legendary technique that cleaves both heaven and earth — a swordsman's ultimate invocation.

Requires a sword in the main hand to cast.
Tap to fire (1,000 Qi): Releases a small crescent sword aura (3× the size of a basic Sword Aura) that flies forward at moderate speed for 3 seconds. Carves a crescent-shaped tunnel through any blocks along its path (excluding bedrock, obsidian, reinforced deepslate, and end portal frame). 50 damage per entity struck.
Hold to channel (~2 seconds to fully charge, 3,000 Qi cap): Builds up power. During channeling:
- From the caster's first-person view: Your held sword glows brighter and brighter with a white emissive halo as the charge builds — clean and unobtrusive, no screen flashes.
- From other players' / third-person view: White outline glow appears on the player and sword (vanilla Glowing effect), with intensifying flash particles around the body. At full charge, the player visibly strobes — clear visual cue to allies (and enemies) that something massive is coming.
Release at full charge: Unleashes a Mega Sky-Splitting Sword Aura — a colossal crescent 30× the size of the standard one, flying forward at 6 blocks/tick. It exists for 5 seconds then gradually fades into transparency. 1,000 damage per entity struck. Carves a massive crescent-shaped tunnel through the world along its trajectory, devastating terrain and structures alike.
After the Mega aura fades, a long-lasting white sky trail (~30 seconds) marks the path of destruction across the sky.

Sky-Splitting Sword Aura

Sky-Splitting Sword Aura 2

💎 Spirit Stones & Ores

4 tiers of qi-rich crystals form the cultivation economy:

Low Spirit Stone — 10 qi (eat to absorb)
Mid Spirit Stone — 100 qi (9 low → 1 mid)
High Spirit Stone — 1,000 qi (9 mid → 1 high)
Supreme Spirit Stone — 10,000 qi (9 high → 1 supreme)

Each tier has a matching ore that spawns deep underground.

🌀 Qi Particles & Elements

The world is alive with qi. Different biomes and blocks generate different elemental qi orbs floating in the air — pure white in normal terrain, frosty blue in snow biomes, fiery red near lava, deep green in forests, etc. Absorb them naturally (passive) or 10× faster while meditating on a cushion. The element distribution of your absorbed qi grants damage/power bonuses to matching spells.

📦 All Items & Blocks

🎮 Quick Start Guide

Explore the world to find a Cultivation Manual: Fragment in cultivation building chests — or craft one with 8 paper + 1 low spirit stone.
Right-click the manual to learn the Cultivation Fragment technique.
Press G to open the cultivation panel, switch to the Techniques tab, and click the technique to equip it. This activates the entire cultivation system — without an equipped technique, you cannot see the HUD, absorb qi, or use the cushion.
Find spirit stones, meditate on cushions, absorb floating qi orbs to fill your qi bar.
When qi is full, press the Breakthrough button — endure the heavenly tribulation lightning to advance.
Find spell books in chests and right-click to learn one of the 25 spells. Press V (hold) to open the spell wheel — drag mouse in any direction → release V → that spell is primed. Press R to cast.

📐 Tech Specs

Minecraft: 1.20.1
Loader: Forge 47.4.20+
Java: 17
Side: Both client and server (full multiplayer support)
Languages: English (en_us), Traditional Chinese (zh_tw), Simplified Chinese (zh_cn)

⚙️ Default Keybindings

G — Open Cultivation Panel
V (hold) — Show Spell Wheel; release to prime spell in mouse direction
R — Cast primed spell (or hold for charge-up spells)
Right-click cushion — Sit to meditate
Double-tap shift while sitting — Stand up

Welcome to join our discussion groups:

Discord Group: https://discord.gg/FebXy3TZPg

QQ Group: https://qm.qq.com/q/AbGpN6kKqs

Data-driven Customization Guide

Starting from v0.1.308, Xiaoxiang Cultivation World supports datapack-based customization for:

Alchemy recipes
Refining recipes
Formation flag crafting materials
Some pill effects, such as Qi recovery and healing values

This allows modpack makers to integrate other mods without writing Java code.

1. Datapack Folder Structure

Put your datapack inside the world folder:

.minecraft/saves/<world_name>/datapacks/<your_pack_name>/

Example structure:

my_cultivation_pack/
├─ pack.mcmeta
└─ data/
   └─ my_pack/
      └─ recipes/
         └─ dragon_blood_elixir.json

For Minecraft 1.20.1, pack.mcmeta can be:

{
  "pack": {
    "pack_format": 15,
    "description": "Custom Xiaoxiang Cultivation recipes"
  }
}

After adding or editing files, run:

/reload

2. Custom Alchemy Recipe

Alchemy recipes use:

"type": "xiaoxiang_cultivation:alchemy"

Example:

{
  "type": "xiaoxiang_cultivation:alchemy",
  "translation_key": "recipe.my_pack.dragon_blood_elixir",
  "sort_order": 100,
  "ingredients": [
    { "item": "xiaoxiang_cultivation:herb", "count": 1 },
    { "item": "some_magic_mod:dragon_blood", "count": 1 }
  ],
  "qi_cost_per_pill": 500,
  "outputs": {
    "low": "xiaoxiang_cultivation:pill_qi_recovery_low",
    "mid": "xiaoxiang_cultivation:pill_qi_recovery_mid",
    "high": "xiaoxiang_cultivation:pill_qi_recovery_high",
    "supreme": "xiaoxiang_cultivation:pill_qi_recovery_supreme",
    "immortal": "xiaoxiang_cultivation:pill_qi_recovery_immortal"
  }
}

ingredients supports both item IDs and tags:

{ "tag": "forge:gems/diamond", "count": 2 }

3. Custom Refining Recipe

Refining recipes use:

"type": "xiaoxiang_cultivation:refining"

Example:

{
  "type": "xiaoxiang_cultivation:refining",
  "translation_key": "recipe.my_pack.dragon_fang_sword",
  "sort_order": 120,
  "ingredients": [
    { "item": "xiaoxiang_cultivation:low_spirit_stone", "count": 1 },
    { "item": "some_magic_mod:dragon_fang", "count": 2 },
    { "tag": "forge:rods/wooden", "count": 1 }
  ],
  "qi_cost_per_item": 800,
  "outputs": {
    "low": "xiaoxiang_cultivation:xuan_iron_sword_low",
    "mid": "xiaoxiang_cultivation:xuan_iron_sword_mid",
    "high": "xiaoxiang_cultivation:xuan_iron_sword_high",
    "supreme": "xiaoxiang_cultivation:xuan_iron_sword_supreme",
    "immortal": "xiaoxiang_cultivation:xuan_iron_sword_immortal"
  }
}

Formation flag materials are also refining recipes, so you can override them the same way.

To override the built-in Sect Protection Flag recipe, create:

data/xiaoxiang_cultivation/recipes/sect_protection_flag.json

using the same recipe ID.

4. Outputs

Both alchemy and refining recipes currently require all five tiers:

"outputs": {
  "low": "...",
  "mid": "...",
  "high": "...",
  "supreme": "...",
  "immortal": "..."
}

5. Pill Effect Customization

Pill effects go here:

data/<namespace>/pill_effects/<item_id>.json

Example: modify Low Rejuvenation Pill:

data/xiaoxiang_cultivation/pill_effects/pill_rejuvenation_low.json

{
  "heal": 8.0
}

Example: modify Immortal Qi Recovery Pill:

data/xiaoxiang_cultivation/pill_effects/pill_qi_recovery_immortal.json

{
  "qi": -1
}

qi: -1 means restore Qi to full.

Supported fields:

{
  "qi": 1000,
  "heal": 10.0,
  "heal_full": false,
  "regeneration_ticks": 2400,
  "regeneration_amplifier": 1,
  "absorption_ticks": 2400,
  "absorption_amplifier": 0
}

Note: On multiplayer servers, recipe data is synced normally. Pill effect values are applied server-side after /reload; for client tooltips to show the same custom values, clients should also have the same pack data installed.

繁體中文

小翔的修仙世界

一個深度的東方修仙主題 Minecraft 1.20.1 模組。修煉靈氣、突破 11 個境界、掌握 23 種功法、學習 25 種法術、最終飛升真仙。

⚡ 主要特色

🌌 11 個修仙境界：從凡人到真仙，每境界再分初期/中期/後期/大圓滿四個小階段
🌀 23 種功法：裝備功法後才能使用修仙系統，並獲得各種屬性加成 (傷害/防禦/移速/法術威力/被動效果…)
⚔️ 25 種法術：包含蓄力的「大火球術」、「萬劍歸宗」、被動的「靈氣飛行」(同創造模式飛行但會耗靈氣)、靈氣免傷、靈氣視野等
💎 4 階靈石：含對應的靈石礦，可挖、可吃、可 9→1 合成升階
🌪️ 渡劫天雷：境界突破時必須承受雷劫 (1~100 道雷，依境界)
🧘 蒲團打坐：盤坐其上，吸收靈氣速度 ×10
🎯 7 種靈氣屬性：無/金/木/水/火/土/冰 — 累積對應屬性的靈氣可加成同屬性法術
🏛️ 世界生成建築：5 種完整 + 5 種廢墟修仙建築，內含戰利品箱子
🎨 自訂 UI：修仙彈窗 (預設 G) + 法術輪盤 (預設 V，按住顯示 + 滑鼠方向選取)
🌍 三種語言：English / 繁體中文 / 简体中文

🎮 快速上手

探索世界，在修仙建築的箱子中找到「功法書：殘篇」— 或用 8 張紙 + 1 顆下品靈石合成
右鍵書本習得「功法殘篇」
按 G 開啟修仙彈窗，切到「功法」分頁點擊功法裝備。這會啟動整個修仙系統 — 未裝備功法時 HUD 不顯示、無法吸收靈氣、蒲團也無作用
採集靈石、蒲團打坐、吸收浮空的靈氣球來填滿靈氣槽
靈氣滿後按「突破境界」— 撐過天劫雷擊即可晉升
從箱子找到法術書、右鍵學會 (共 25 種)。按住 V 開啟法術輪盤，滑鼠任意方向 → 放開 V → 該法術設為待施放。再按 R 即可施放。

歡迎加群討論：

Discord 群： https://discord.gg/FebXy3TZPg

QQ 群： https://qm.qq.com/q/AbGpN6kKqs

Data-driven 自訂教學

從 v0.1.308 開始，小翔的修仙世界支援透過資料包自訂：

煉丹配方
煉器配方
陣旗煉器材料
部分丹藥效果，例如回氣量、回血量

這代表整合包作者不需要寫 Java，就能把其他模組材料接進修仙模組。

1. 資料包位置

資料包放在世界存檔底下：

.minecraft/saves/<世界名稱>/datapacks/<你的資料包名稱>/

範例結構：

my_cultivation_pack/
├─ pack.mcmeta
└─ data/
   └─ my_pack/
      └─ recipes/
         └─ dragon_blood_elixir.json

Minecraft 1.20.1 的 pack.mcmeta 可使用：

{
  "pack": {
    "pack_format": 15,
    "description": "Custom Xiaoxiang Cultivation recipes"
  }
}

新增或修改後，進遊戲執行：

/reload

2. 自訂煉丹配方

煉丹配方使用：

"type": "xiaoxiang_cultivation:alchemy"

範例：

{
  "type": "xiaoxiang_cultivation:alchemy",
  "translation_key": "recipe.my_pack.dragon_blood_elixir",
  "sort_order": 100,
  "ingredients": [
    { "item": "xiaoxiang_cultivation:herb", "count": 1 },
    { "item": "some_magic_mod:dragon_blood", "count": 1 }
  ],
  "qi_cost_per_pill": 500,
  "outputs": {
    "low": "xiaoxiang_cultivation:pill_qi_recovery_low",
    "mid": "xiaoxiang_cultivation:pill_qi_recovery_mid",
    "high": "xiaoxiang_cultivation:pill_qi_recovery_high",
    "supreme": "xiaoxiang_cultivation:pill_qi_recovery_supreme",
    "immortal": "xiaoxiang_cultivation:pill_qi_recovery_immortal"
  }
}

材料支援指定物品，也支援 tag：

{ "tag": "forge:gems/diamond", "count": 2 }

3. 自訂煉器配方

煉器配方使用：

"type": "xiaoxiang_cultivation:refining"

範例：

{
  "type": "xiaoxiang_cultivation:refining",
  "translation_key": "recipe.my_pack.dragon_fang_sword",
  "sort_order": 120,
  "ingredients": [
    { "item": "xiaoxiang_cultivation:low_spirit_stone", "count": 1 },
    { "item": "some_magic_mod:dragon_fang", "count": 2 },
    { "tag": "forge:rods/wooden", "count": 1 }
  ],
  "qi_cost_per_item": 800,
  "outputs": {
    "low": "xiaoxiang_cultivation:xuan_iron_sword_low",
    "mid": "xiaoxiang_cultivation:xuan_iron_sword_mid",
    "high": "xiaoxiang_cultivation:xuan_iron_sword_high",
    "supreme": "xiaoxiang_cultivation:xuan_iron_sword_supreme",
    "immortal": "xiaoxiang_cultivation:xuan_iron_sword_immortal"
  }
}

陣旗材料也是煉器配方，所以同樣可以用這種方式覆蓋。

例如要覆蓋內建「護宗大陣陣旗」配方，建立：

data/xiaoxiang_cultivation/recipes/sect_protection_flag.json

並使用同樣 ID 覆蓋即可。

4. 產物品階

目前煉丹與煉器配方都需要提供五個品階產物：

"outputs": {
  "low": "...",
  "mid": "...",
  "high": "...",
  "supreme": "...",
  "immortal": "..."
}

5. 自訂丹藥效果

丹藥效果放在：

data/<namespace>/pill_effects/<物品ID>.json

例如修改下品回春丹：

data/xiaoxiang_cultivation/pill_effects/pill_rejuvenation_low.json

{
  "heal": 8.0
}

例如修改仙品回靈丹：

data/xiaoxiang_cultivation/pill_effects/pill_qi_recovery_immortal.json

{
  "qi": -1
}

qi: -1 代表直接回滿靈氣。

支援欄位：

{
  "qi": 1000,
  "heal": 10.0,
  "heal_full": false,
  "regeneration_ticks": 2400,
  "regeneration_amplifier": 1,
  "absorption_ticks": 2400,
  "absorption_amplifier": 0
}

注意：多人伺服器中，煉丹/煉器配方會正常同步給客戶端。丹藥效果會由伺服器套用；若想讓客戶端 Tooltip 也顯示完全一致的自訂數值，玩家端也需要安裝同份資料包/資源內容。

简体中文

小翔的修仙世界

一个深度的东方修仙主题 Minecraft 1.20.1 模组。修炼灵气、突破 11 个境界、掌握 23 种功法、学习 25 种法术、最终飞升真仙。

⚡ 主要特色

🌌 11 个修仙境界：从凡人到真仙，每境界再分初期/中期/后期/大圆满四个小阶段
🌀 23 种功法：装备功法后才能使用修仙系统，并获得各种属性加成
⚔️ 25 种法术：包含蓄力的「大火球术」、「万剑归宗」、被动的「灵气飞行」、灵气免伤、灵气视野等
💎 4 阶灵石：含对应矿石，可挖、可吃、可 9→1 合成升阶
🌪️ 渡劫天雷、🧘 蒲团打坐、🎯 7 种灵气属性
🏛️ 5 种完整 + 5 种废墟世界生成建筑
🌍 English / 繁體中文 / 简体中文

欢迎加群讨论：

Discord 群： https://discord.gg/FebXy3TZPg

QQ 群： https://qm.qq.com/q/AbGpN6kKqs