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 / 繁體中文 / 简体中文


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.

? 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
Spoiler
**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:
```text
.minecraft/saves//datapacks//
```
Example structure:
```text
my_cultivation_pack/
├─ pack.mcmeta
└─ data/
└─ my_pack/
└─ recipes/
└─ dragon_blood_elixir.json
```
For Minecraft `1.20.1`, `pack.mcmeta` can be:
```json
{
"pack": {
"pack_format": 15,
"description": "Custom Xiaoxiang Cultivation recipes"
}
}
```
After adding or editing files, run:
```text
/reload
```
### 2. Custom Alchemy Recipe
Alchemy recipes use:
```json
"type": "xiaoxiang_cultivation:alchemy"
```
Example:
```json
{
"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:
```json
{ "tag": "forge:gems/diamond", "count": 2 }
```
### 3. Custom Refining Recipe
Refining recipes use:
```json
"type": "xiaoxiang_cultivation:refining"
```
Example:
```json
{
"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:
```text
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:
```json
"outputs": {
"low": "...",
"mid": "...",
"high": "...",
"supreme": "...",
"immortal": "..."
}
```
### 5. Pill Effect Customization
Pill effects go here:
```text
data//pill_effects/.json
```
Example: modify Low Rejuvenation Pill:
```text
data/xiaoxiang_cultivation/pill_effects/pill_rejuvenation_low.json
```
```json
{
"heal": 8.0
}
```
Example: modify Immortal Qi Recovery Pill:
```text
data/xiaoxiang_cultivation/pill_effects/pill_qi_recovery_immortal.json
```
```json
{
"qi": -1
}
```
`qi: -1` means restore Qi to full.
Supported fields:
```json
{
"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. 資料包位置
資料包放在世界存檔底下:
```text
.minecraft/saves//datapacks//
```
範例結構:
```text
my_cultivation_pack/
├─ pack.mcmeta
└─ data/
└─ my_pack/
└─ recipes/
└─ dragon_blood_elixir.json
```
Minecraft `1.20.1` 的 `pack.mcmeta` 可使用:
```json
{
"pack": {
"pack_format": 15,
"description": "Custom Xiaoxiang Cultivation recipes"
}
}
```
新增或修改後,進遊戲執行:
```text
/reload
```
### 2. 自訂煉丹配方
煉丹配方使用:
```json
"type": "xiaoxiang_cultivation:alchemy"
```
範例:
```json
{
"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:
```json
{ "tag": "forge:gems/diamond", "count": 2 }
```
### 3. 自訂煉器配方
煉器配方使用:
```json
"type": "xiaoxiang_cultivation:refining"
```
範例:
```json
{
"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"
}
}
```
陣旗材料也是煉器配方,所以同樣可以用這種方式覆蓋。
例如要覆蓋內建「護宗大陣陣旗」配方,建立:
```text
data/xiaoxiang_cultivation/recipes/sect_protection_flag.json
```
並使用同樣 ID 覆蓋即可。
### 4. 產物品階
目前煉丹與煉器配方都需要提供五個品階產物:
```json
"outputs": {
"low": "...",
"mid": "...",
"high": "...",
"supreme": "...",
"immortal": "..."
}
```
### 5. 自訂丹藥效果
丹藥效果放在:
```text
data//pill_effects/.json
```
例如修改下品回春丹:
```text
data/xiaoxiang_cultivation/pill_effects/pill_rejuvenation_low.json
```
```json
{
"heal": 8.0
}
```
例如修改仙品回靈丹:
```text
data/xiaoxiang_cultivation/pill_effects/pill_qi_recovery_immortal.json
```
```json
{
"qi": -1
}
```
`qi: -1` 代表直接回滿靈氣。
支援欄位:
```json
{
"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 合成升階
- ?️ 渡劫天雷:境界突破時必須承受雷劫 (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
简体中文
小翔的修仙世界
一个深度的东方修仙主题 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
暂无评论,抢个沙发吧~