修仙插件 Wiki

基于《凡人修仙传》世界观设计的 Minecraft 修仙系统框架。玩家通过吸收灵气、突破境界、获取灵根体质、修炼功法、炼制法宝，最终飞升成仙。

🎮 版本信息

插件版本: 1.0.0

API 版本: 1.20

作者: XYQM

📊 数据概览

境界总数: 15 个

总突破次数: 81 次

灵根种类: 5 种

体质种类: 5 种

⚡ 属性机制

生命上限: 60 (40 bonus + 20 base)

溢出转护甲: 最高 20 点

攻击上限: +55

移速上限: +150%

💡 属性成长机制
本插件采用替换式成长——突破到新境界后，旧境界属性被完全替换。例如：道祖期的 +55 攻击是最终加成，不是从凡人一路累加而来。

📑 目录

境界系统 — 15个境界，81次突破
突破系统 — 成功率与失败惩罚
灵气系统 — 杀怪、挖矿、打坐
灵根系统 — 五行灵根
体质系统 — 稀有度与属性
功法系统 — 五种流派
法宝系统 — 本命法宝
丹药系统 — 五种丹药
宠物系统 — 灵兽养成
指令大全 — 玩家/管理员

⚔ 境界系统

境界是修仙的核心 progression 系统。玩家从凡人开始，历经练气、筑基、结丹……最终达到道祖之境。

层数结构

凡人

层数: 20层

每层灵气: 50

属性: 无

练气期

层数: 13层

每层灵气: 200

属性: +4血 / +0.5攻 / +10%速

筑基+

层数: 4层

每层灵气: 1000 ~ 2亿

小阶段: 前期/中期/后期/大圆满

境界详情表

境界	层数	每层灵气	生命	攻击	移速	护甲溢出	特效
凡人	20	50	0	0	0	-	-
练气期	13	200	+4	+0.5	+10%	-	-
筑基期	4	1,000	+8	+1	+20%	-	🌙 夜视
结丹期	4	5,000	+12	+2	+30%	-	🌙夜视 🔥火抗
元婴期	4	20,000	+18	+3	+40%	-	🌙夜视 🔥火抗 ✈飞行
化神期	4	80,000	+25	+5	+50%	-	🌙夜视 🔥火抗 ✈飞行 🌊水下呼吸
炼虚期	4	250,000	+32	+7	+60%	-	+ ⚡速度
合体期	4	800,000	+40	+10	+70%	-	+ 💪力量
大乘期	4	2,000,000	+40	+13	+80%	+5	同上
渡劫期	4	5,000,000	+40	+17	+90%	+10	+ ❤恢复
真仙	4	10,000,000	+40	+22	+100%	+15	+ ⛏急迫
金仙	4	30,000,000	+40	+28	+110%	+20	+ 🍖饱和
太乙	4	80,000,000	+40	+35	+120%	+20	+ ❤生命提升
大罗	4	200,000,000	+40	+45	+130%	+20	+ 🦘跳跃提升
道祖	1	999,999,999	+40	+55	+150%	+20	全部特效

境界ID速查

管理员设置境界指令: /setrealm <玩家> <ID> <层数>

ID	名称	层数	指令示例
`mortal`	凡人	20	`/setrealm XYQM mortal 1`
`qi-training`	练气期	13	`/setrealm XYQM qi-training 5`
`foundation-building`	筑基期	4	`/setrealm XYQM foundation-building 1`
`golden-core`	结丹期	4	`/setrealm XYQM golden-core 2`
`nascent-soul`	元婴期	4	`/setrealm XYQM nascent-soul 3`
`deity-transformation`	化神期	4	`/setrealm XYQM deity-transformation 4`
`soul-severing`	炼虚期	4	`/setrealm XYQM soul-severing 1`
`body-integration`	合体期	4	`/setrealm XYQM body-integration 2`
`great-ascension`	大乘期	4	`/setrealm XYQM great-ascension 3`
`tribulation`	渡劫期	4	`/setrealm XYQM tribulation 4`
`true-immortal`	真仙	4	`/setrealm XYQM true-immortal 1`
`golden-immortal`	金仙	4	`/setrealm XYQM golden-immortal 2`
`taiyi`	太乙	4	`/setrealm XYQM taiyi 3`
`daluo`	大罗	4	`/setrealm XYQM daluo 4`
`dao-ancestor`	道祖	1	`/setrealm XYQM dao-ancestor 1`

⚠️ 生命上限机制
游戏内生命加成硬上限为 40 点（总生命 60）。超过 40 的部分会自动转化为 GENERIC_ARMOR 属性（护甲图标），每点护甲约 4% 减伤，20 点护甲达到约 80% 减伤上限。

🔥 突破系统

当玩家积累足够灵气后，可以使用 /breakthrough（别名 /bt）尝试突破。突破成功则晋升层数/境界，失败则受到惩罚。

突破条件

当前灵气 ≥ 该境界每层所需灵气
未达到最高境界（道祖大圆满）

成功率

当前境界	突破成功率	失败率
凡人	100%	0%
练气期	85%	15%
筑基期	70%	30%
结丹期	60%	40%
元婴期	50%	50%
化神期	45%	55%
炼虚期	40%	60%
合体期	35%	65%
大乘期	30%	70%
渡劫期	25%	75%
真仙	20%	80%
金仙	15%	85%
太乙	12%	88%
大罗	10%	90%

失败惩罚

config.yml 中可配置三种惩罚类型（默认 qi-loss）：

💨 灵气损失 (qi-loss)

默认惩罚。损失当前灵气的 50%。最安全的选择。

📉 掉层 (layer-drop)

退回上一层。如果在第 1 层，则退回上一境界最后一层。

💥 掉境界 (realm-drop)

直接退回上一境界第 1 层。最严厉的惩罚。

突破保护

🛡️ 护脉丹效果
服用 护脉丹 后，可在 30 分钟内抵消一次突破失败的境界掉落惩罚。被抵消时只会损失灵气，不会掉层/掉境界。

突破成功特效

⚡ 玩家位置召唤闪电特效（无伤害）
🔔 播放升级音效
📢 全服广播突破喜讯
✨ 自动应用新境界的属性和特效

💨 灵气系统

灵气是突破境界的消耗品，也是修仙的根本。灵气可以通过多种方式获取。

灵气获取途径

⚔️ 杀怪获取

击杀生物可获得灵气

公式: 灵气 = 怪物基础经验值 × 2.0

倍率可在 config.yml 调整

⛏️ 挖矿获取

煤矿石	+5
铁矿石	+10
钻石矿石	+50

🧘 打坐修炼

使用 /dazuo 进入打坐状态

每秒获取: 10 点灵气

打坐时会在动作栏显示状态

灵气查看

使用 /qi 查看当前灵气值和该层突破所需灵气。

🌿 灵根系统

灵根决定玩家的修炼天赋。新玩家首次登录时自动觉醒随机灵根。灵根影响修炼速度和突破成功率，并提供属性加成。

灵根种类

灵根	颜色	概率	属性加成	修炼加成	突破加成
金灵根	金色	20%	攻击 +2	+10%	+5%
木灵根	绿色	20%	生命 +4	+15%	-
水灵根	青色	20%	生命 +2 / 移速 +1%	+20%	-
火灵根	红色	20%	攻击 +3	+5%	+10%
土灵根	黄色	20%	生命 +6	-	+8%

灵根ID速查

管理员指令: /setspiritroot <玩家> <ID>

ID	名称	颜色
`metal`	金灵根	金色
`wood`	木灵根	绿色
`water`	水灵根	青色
`fire`	火灵根	红色
`earth`	土灵根	黄色

💡 灵根策略
水灵根修炼速度最快 (+20%)，适合快速冲级；火灵根突破率最高 (+10%)，适合冲击高境界；土灵根血最厚 (+6)，适合 PVP。

💪 体质系统

体质决定玩家的肉身强度。新玩家首次登录时自动觉醒随机体质。体质按稀有度分为普通稀有史诗传说四个等级。

稀有度权重

普通

100

稀有

史诗

传说

体质详情

体质	稀有度	颜色	生命	攻击	移速	修炼	突破
凡体	普通	灰色	-	-	-	-	-
灵体	稀有	青色	+4	-	+1%	+20%	+5%
剑骨	史诗	白色	+2	+4	-	+15%	+10%
道体	传说	金色	+6	+3	-	+50%	+15%
混沌体	传说	深紫	+10	+6	+3%	+100%	+30%

体质ID速查

管理员指令: /setphysique <玩家> <ID>

ID	名称	稀有度
`mortal`	凡体	普通
`spirit`	灵体	稀有
`sword`	剑骨	史诗
`dao`	道体	传说
`chaos`	混沌体	传说

🎲 抽卡玄学
混沌体概率仅为 2/142 ≈ 1.4%，但提供 +100% 修炼速度和 +30% 突破率，是欧皇专属体质。

📜 功法系统

功法是额外的养成线，玩家通过学习功法书获得被动属性加成。功法最高 10 级，升级消耗灵气。

功法获取与学习

📦 获取方式
本插件为框架型设计，不内置合成/掉落系统。功法书由管理员通过 /givecultivationbook <玩家> <ID> 发放，或配合其他插件分发。

获得功法书：从管理员或其他系统获得功法书物品
领悟功法：手持功法书右键点击空气或方块即可学习
消耗书本：学习成功后自动消耗一本功法书
唯一功法：玩家同一时间只能修炼一种功法，学习新功法会覆盖旧功法

升级消耗公式

消耗 = base-qi-cost + (level - 1) × increase-per-level

功法列表

功法	类型	满级	基础消耗	每级增加	每级属性	修炼加成
《狂雷剑诀》	攻击型	10	1,000	500	攻+1.5 / 血+1	+5%
《玄龟神甲功》	防御型	10	1,000	500	血+4	+2%
《风影决》	速度型	10	1,000	500	攻+0.5 / 速+0.5%	+5%
《混元无极功》	全能型	10	1,500	800	攻+1 / 血+2 / 速+0.2%	+8%
《太真吐纳法》	修炼型	10	800	400	血+0.5	+20%

功法ID速查

管理员指令: /givecultivationbook <玩家> <ID>

ID	名称	类型
`attack_method`	《狂雷剑诀》	攻击型
`defense_method`	《玄龟神甲功》	防御型
`speed_method`	《风影决》	速度型
`all_around_method`	《混元无极功》	全能型
`cultivate_method`	《太真吐纳法》	修炼型

满级消耗示例

以《狂雷剑诀》为例，升到满级（Lv.10）总消耗：

1000 + 1500 + 2000 + 2500 + 3000 + 3500 + 4000 + 4500 + 5000 = 31,000 灵气

🗡 法宝系统

法宝是修仙者的本命武器，需要神识认主后才能发挥威力。认主后的法宝绑定玩家，其他人无法拾取。

法宝获取与认主

📦 获取方式
本插件为框架型设计，不内置合成/掉落系统。法宝由管理员通过 /givemagicweapon <玩家> <ID> 发放，或配合其他插件（商店、任务、BOSS掉落等）分发。

获得法宝：从管理员或其他系统获得法宝物品
神识认主：手持法宝右键点击空气或方块，自动绑定你的UUID
绑定效果：认主后法宝属性立即生效，非主人无法拾取
切换更新：切换手持物品时自动更新属性加成
死亡保护：死亡时法宝属性临时清除，复活后重新装备即可恢复

法宝列表

法宝	品阶	材质	攻击	生命	移速	描述
青锋剑	凡阶	铁剑	+4	-	+1%	削铁如泥的利剑
赤焰刀	地阶	钻石剑	+8	+2	-	刀身缠绕烈焰
玄武盾	地阶	盾牌	-	+10	-2%	蕴含玄武之力
追风弓	玄阶	弓	-	-	+5%	极大提升身法
开天斧	天阶	下界合金斧	+15	+4	-	可劈开混沌的凶器

境界-法宝品阶对照

以下为本服务器自定义的法宝品阶体系，建议管理员按玩家境界发放对应级别的法宝：

玩家境界	法宝品阶	对应原品阶	建议发放
凡人 ~ 筑基期	法器	凡阶	青锋剑
结丹期 ~ 元婴期	法宝	地阶	赤焰刀、玄武盾
化神期 ~ 合体期	灵宝	玄阶	追风弓
大乘期 ~ 渡劫期	玄天灵宝	天阶	开天斧
真仙 ~ 金仙	玄天仙器	天阶+	开天斧（强化）
太乙 ~ 大罗	玄天至宝	传说级	自定义
道祖	鸿蒙至宝	唯一	自定义

法宝ID速查

管理员指令: /givemagicweapon <玩家> <ID>

ID	名称	品阶	材质
`qing_feng_jian`	青锋剑	凡阶	铁剑
`chi_yan_dao`	赤焰刀	地阶	钻石剑
`xuan_wu_dun`	玄武盾	地阶	盾牌
`zhui_feng_gong`	追风弓	玄阶	弓
`kai_tian_fu`	开天斧	天阶	下界合金斧

💊 丹药系统

丹药提供临时或瞬时的辅助效果。每种丹药有独立的冷却时间。

丹药获取与服用

📦 获取方式
本插件为框架型设计，不内置炼丹/合成系统。丹药由管理员通过 /givepill <玩家> <ID> 发放，或配合其他插件分发。丹药在游戏内显示为带有自定义颜色的药水。

获得丹药：从管理员或其他系统获得丹药（外观为彩色药水）
服用方式：手持丹药右键点击空气或方块即可服用
注意事项：丹药有独立冷却时间，不可连续服用同种丹药
内置机制：系统会自动阻止原版药水的饮用行为，确保丹药效果正确触发

丹药列表

丹药	品阶	效果类型	效果	持续	冷却
回气丹	凡阶	qi_restore	瞬间恢复 1000 灵气	瞬发	60秒
聚气丹	黄阶	cultivate_speed	修炼速度 +20%	10分钟	30分钟
筑基丹	玄阶	breakthrough_rate	突破成功率 +15%	5分钟	60分钟
护脉丹	地阶	breakthrough_protect	抵消一次突破掉境界惩罚	30分钟	120分钟
狂暴丹	天阶	attribute_boost	临时攻击 +5	3分钟	10分钟

丹药ID速查

管理员指令: /givepill <玩家> <ID>

ID	名称	品阶	效果
`hui_qi_dan`	回气丹	凡阶	瞬间恢复1000灵气
`ju_qi_dan`	聚气丹	黄阶	修炼速度+20%
`zhu_ji_dan`	筑基丹	玄阶	突破成功率+15%
`hu_mai_dan`	护脉丹	地阶	抵消一次掉境界惩罚
`kuang_bao_dan`	狂暴丹	天阶	临时攻击+5

🐺 宠物系统

宠物是修仙者的战斗伙伴，通过孵化宠物蛋获得。宠物可以召唤参战，也能收回灵兽袋。

宠物获取与孵化

📦 获取方式
本插件为框架型设计，不内置合成/掉落系统。宠物蛋由管理员通过 /givepetegg <玩家> <ID> 发放，或配合其他插件分发。

获得宠物蛋：从管理员或其他系统获得宠物蛋
孵化契约：手持宠物蛋右键点击空气或方块，孵化并签订灵魂契约
自动召唤：孵化成功后宠物自动出现在身边
经验获取：玩家击杀生物时，宠物获得 20 点经验
战斗协助：宠物会自动攻击你攻击的目标
宠物保护：你无法误伤自己的宠物
重伤回收：宠物重伤濒死时自动收回灵兽袋，不掉落任何物品

宠物列表

宠物	实体	满级	基础生命	基础攻击	成长生命	成长攻击	基础经验
啸月天狼	狼	50	20	4	+2	+0.5	100
玄铁傀儡	铁傀儡	30	100	10	+10	+1	200
烈焰火灵	烈焰人	40	30	6	+3	+1	150
天毒蛛	洞穴蜘蛛	40	16	3	+1.5	+0.8	120
九命灵猫	猫	50	10	2	+1	+1.5	80

满级属性示例

啸月天狼 Lv.50

生命: 118 (20 + 2×49)

攻击: 28.5 (4 + 0.5×49)

玄铁傀儡 Lv.30

生命: 390 (100 + 10×29)

攻击: 39 (10 + 1×29)

宠物ID速查

管理员指令: /givepetegg <玩家> <ID>

ID	名称	实体	满级
`spirit_wolf`	啸月天狼	狼	50
`iron_guardian`	玄铁傀儡	铁傀儡	30
`fire_spirit`	烈焰火灵	烈焰人	40
`poison_spider`	天毒蛛	洞穴蜘蛛	40
`holy_cat`	九命灵猫	猫	50

🛠 指令生成器

选择指令类型，填写参数，一键生成管理员指令并复制到剪贴板。

玩家名称

指令类型

目标

层数

生成结果

已复制！

⌨ 指令大全

玩家指令

指令	别名	说明	权限
`/xiuxian`	`/xx`	修仙主命令（含 reload）	xiuxian.command.use
`/realm`	-	查看自己的境界信息	默认
`/qi`	-	查看当前灵气	默认
`/dazuo`	-	进入或退出打坐状态	默认
`/breakthrough`	`/bt`	尝试突破当前境界	默认
`/spiritroot`	`/sr`	查看自己的灵根信息	默认
`/physique`	`/ph`	查看自己的体质信息	默认
`/cultivationmethod`	`/cm`	查看当前功法信息	默认
`/upgradecultivation`	`/upcm`	升级当前功法	默认
`/pet`	-	查看当前宠物信息	默认
`/petsummon`	-	召唤宠物	默认
`/petdismiss`	-	收回宠物	默认

管理员指令

指令	别名	说明	权限
`/setrealm <玩家> <境界> <层>`	-	设置玩家境界	xiuxian.admin.setrealm
`/addrealm <玩家> <数量>`	-	提升玩家层数	xiuxian.admin.addrealm
`/addqi <玩家> <数量>`	-	增加玩家灵气	xiuxian.admin.qi
`/setqi <玩家> <数量>`	-	设置玩家灵气	xiuxian.admin.qi
`/setspiritroot <玩家> <ID>`	-	设置玩家灵根	xiuxian.admin.spiritroot
`/setphysique <玩家> <ID>`	-	设置玩家体质	xiuxian.admin.physique
`/givecultivationbook <玩家> <ID>`	-	给予功法书	xiuxian.admin.method
`/givepill <玩家> <ID>`	-	给予玩家丹药	xiuxian.admin.pill
`/givemagicweapon <玩家> <ID>`	`/gmw`	给予玩家法宝	xiuxian.admin.magicweapon
`/givepetegg <玩家> <ID>`	-	给予宠物蛋	xiuxian.admin.pet

👑 权限组
xiuxian.admin 是总管理员权限组，默认授予 OP。包含所有管理指令和 /xiuxian reload 权限。

💬 消息文本

所有游戏内显示的文本都可以在 messages.yml 中自定义，支持 & 颜色代码和 16 进制颜色。

常用消息变量

变量	说明	适用场景
`%player%`	玩家名称	广播、设置提示
`%realm%`	境界名称	突破提示、境界信息
`%layer%`	层数	突破提示、境界信息
`%hp%`	生命加成	境界属性显示
`%damage%`	攻击加成	境界属性显示
`%speed%`	移速加成	境界属性显示
`%current%`	当前灵气	灵气信息
`%max%`	所需灵气	灵气信息
`%required%`	突破所需灵气	灵气不足提示
`%loss%`	损失的灵气	突破失败提示
`%amount%`	数量/层数	给予物品、提升层数
`%color%`	Bukkit 颜色代码	灵根/体质名称染色
`%name%`	名称	灵根、体质、功法、丹药、宠物
`%rarity%`	稀有度	体质信息
`%level%`	当前等级	功法、宠物
`%max%`	最高等级	功法、宠物
`%cost%`	升级消耗	功法升级
`%cultivate%`	修炼加成百分比	灵根、体质、功法
`%breakthrough%`	突破加成百分比	灵根、体质
`%exp%`	当前经验	宠物
`%req%`	升级所需经验	宠物
`%time%`	冷却剩余时间	丹药冷却

⚙ 配置说明

文件清单

文件	说明	热重载
`config.yml`	主配置（数据库、默认数据、灵气系统、突破惩罚）	✅ /xiuxian reload
`realm.yml`	境界配置（层数、灵气、属性、特效）	⚠️ 需重启
`breakthrough.yml`	突破成功率配置	✅ /xiuxian reload
`spirit-root.yml`	灵根配置	✅ /xiuxian reload
`physique.yml`	体质配置	✅ /xiuxian reload
`cultivation-method.yml`	功法配置	✅ /xiuxian reload
`magic-weapons.yml`	法宝配置	✅ /xiuxian reload
`pills.yml`	丹药配置	✅ /xiuxian reload
`pets.yml`	宠物配置	✅ /xiuxian reload
`messages.yml`	消息文本	✅ /xiuxian reload

⚠️ realm.yml 热重载限制
修改 realm.yml 后使用 /xiuxian reload 可以重载配置，但已在线玩家的境界效果不会立即更新。建议修改后重启服务器，或等待玩家重新登录/突破。

默认数据配置

default-data:
  realm: "mortal"          # 默认境界
  qi: 0.0                  # 默认灵气
  spiritual-root: "metal"  # 默认灵根（必须为 spirit-root.yml 中存在的ID）
  physique: "mortal"       # 默认体质（必须为 physique.yml 中存在的ID）

支持的特效类型

在 realm.yml 的 effects 列表中使用：

NIGHT_VISION
夜视

FIRE_RESISTANCE
火焰免疫

WATER_BREATHING
水下呼吸

FLY
飞行权限

SPEED
速度提升

INCREASE_DAMAGE
力量增幅

REGENERATION
生命恢复

FAST_DIGGING
急迫

SATURATION
饱和

HEALTH_BOOST
生命提升

JUMP
跳跃提升

DAMAGE_RESISTANCE
抗性提升