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.

Player Cultivation Panel - Stats Tab

⚡ 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.

charging great fireball

great fireball explosion

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.

💎 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

English

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.

繁體中文

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"

範例：

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

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

3. 自訂煉器配方

煉器配方使用：

"type": "xiaoxiang_cultivation:refining"

範例：

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

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

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 也顯示完全一致的自訂數值，玩家端也需要安裝同份資料包/資源內容。