原创 Add-on rpg|修仙|灵宠|交易|传送|领地|技能|群聊消息互通 2026-09-08

修复背包可能会刷物品的错误

修仙 Addon 安装使用方法
单机版 & 服务器版 ｜ 版本 1.0.486 ｜ 更新日期 2026-08-12

---

一、选择正确的版本

修仙 Addon 提供两种版本：单机版（单人存档/客户端）和服务器版（BDS 开服），不要混用。

使用场景	Minecraft 版本	安装包
单机版	客户端 1.26.20	xiuxian_addon_v1.0.486_12620.mcaddon
单机版	客户端 1.26.40 及以上	xiuxian_addon_v1.0.486_12640.mcaddon
服务器版	BDS 1.26.20	xiuxian_server_12620.zip（服务器部署压缩包）
服务器版	BDS 1.26.40 及以上	xiuxian_server_12640.zip（服务器部署压缩包）

版本号会随更新变化，选择与当前版本号一致的安装包即可。

---

二、单机版安装（单人存档）

第 1 步：导入 addon

• 双击对应版本的 .mcaddon 文件，自动装入行为包和资源包

第 2 步：创建或编辑世界，必须开启实验性玩法

• 世界设置 → 「实验性玩法」→ 勾选 Beta APIs
• 不勾选的话，进游戏后 /xx 没有反应，修仙功能全部不生效

第 3 步：激活两个包

• 世界设置 → 「行为包」→ 添加并启用「修仙 Addon」
• 世界设置 → 「资源包」→ 添加并启用「修仙 Addon」
• 如果安装过多个版本，选择最新的版本号（包描述里会显示当前版本号）

第 4 步：进入游戏

• 输入 /xx 打开修仙主菜单

提示：旧世界之前没开过实验，需要在世界设置里把 Beta APIs 勾上再进入。

---

三、服务器版安装（BDS 开服）

服务器版提供现成的部署压缩包，包含行为包、资源包、注册文件和权限文件，复制即可，无需解压 mcaddon。

第 1 步：准备服务器

• BDS 1.26.20 → 下载 xiuxian_server_12620.zip
• BDS 1.26.40 及以上 → 下载 xiuxian_server_12640.zip

第 2 步：准备世界存档（关键）

• 在客户端新建世界时，勾选「实验性玩法 → Beta APIs」后保存
• 把这个世界文件夹上传到服务器 worlds/ 目录（例如 worlds/Bedrock leve）

第 3 步：解压并复制文件

压缩包解压后结构如下，按路径复制：

压缩包内路径	复制到服务器
behavior_packs/xiuxian_addon_bp	世界目录的 behavior_packs/ 下
resource_packs/xiuxian_addon_rp	世界目录的 resource_packs/ 下
world_behavior_packs.json	世界目录（与 behavior_packs 同级）
world_resource_packs.json	世界目录（与 resource_packs 同级）
config/default/permissions.json	服务器根目录的 config/default/ 下（已含网络模块授权）

permissions.json 是网络模块授权文件，必须复制，否则服务器会报 not configured to use it、脚本全部失效。

第 4 步：设置管理员

• 打开服务器根目录 permissions.json，把服主/管理员的 xuid 加入 operator（简单说就是有OP权限想使用特殊指令还得用指令给自己增加一个tag：xx_tp_admin）
• 这样才能在游戏内使用 /tag 等管理命令（例如给玩家添加 xx_tp_admin 管理员标签）

第 5 步：重启服务器

• 脚本在服务器启动时加载，改完配置后必须完整重启（热重载无效）
• 进服输入 /xx 验证

（可选）QQ 群联动

• 服务器版已内置 QQ 联动配置，开箱即用
• 如需修改，编辑 scripts/qq.js 里的 WS_URL（NapCat 正向 WebSocket 地址）和 GROUP_ID（QQ 群号），保存后重启

---

四、常见问题

问题	原因	解决办法
单机导入后报 depends on unknown module [@minecraft/server-net]	装成了服务器版安装包	改用单机版 .mcaddon，重新导入
服务器报 not configured to use it	permissions.json 没复制或缺少网络模块授权	把压缩包内 config/default/permissions.json 复制到服务器并重启
进游戏 /xx 没反应	脚本未加载	依次检查：实验开关 Beta APIs、两个包都启用、版本号最新、服务器权限文件
提示选择版本号	装过多个旧版本	移除旧版本，选择与当前版本号一致的包
服务器报 requested invalid version	依赖版本写错（带 build 后缀）	重新下载服务器部署压缩包（已使用正确的 1.0.0-beta）

---

五、注意事项

• 单机版与服务器版不能混用：单机版给玩家单人存档用；服务器版只能用于 BDS 专用服务器（客户端没有网络模块，装服务器版会加载失败）
• 客户端/BDS 版本低于 1.26.20 时，请升级到对应版本
• 更新 addon 时，先移除旧版本的行为包/资源包再装新版本，避免版本冲突
• 服务器每次更新后都要完整重启一次

更新内容在红字部分

修仙 Addon · 更新公告 v1.0.376
更新范围 v1.0.260 → v1.0.376 · 更新日期 2026-08-08 · 适用 BDS 1.26.20 / 1.26.40（双版本包）

---

✔ 本次更新速览

• 妖兽系统（重磅） —— 野外生物 50% 概率变妖兽，15 种 × 1~12 阶
• 御空飞行 —— 金丹期聊天「飞」/「落」，耗灵气 2/秒
• 修仙钟 —— 主菜单获取，手持右键开菜单
• 战斗信息 —— 攻击生物显示 ⚔攻击力；远程灵气 3→5
• 领地传送修复 —— 不再掉虚空 / 卡墙

---

✔ 妖兽系统（新增·重磅）

原版生物生成时 50% 概率替换为修仙妖兽；境界生成时定死（1-12 阶递减概率 × 初/中/后期）

15 种妖兽：僵尸 / 尸壳 / 骷髅 / 蜘蛛 / 狼 / 北极熊 / 末影人 / 卫道士 / 铁傀儡 / 凋灵骷髅 / 烈焰人 / 猪灵蛮兵 / 潜影贝 / 恶魂（下界·会飞） / 溺尸（水下）

• 外观与原版一致，名字常显「妖兽.僵尸·5阶·后期」，不怕阳光
• 血量/攻击/体型按阶强化：1 阶 1.5 倍 → 12 阶 3.15 倍（恶魂单独更小比例）
• 精英妖兽（10%）：移速 ×1.5 + 随机负面效果；死亡 50% 掉精英宝箱（10 妖丹 + 丹药 ×3 + 药料 ×10）
• 妖丹 100% 掉落：数量按阶（1-3 阶 1~3 颗 → 10-12 阶 1~6 颗），五行属性随机
• 妖丹价格按阶：1-3 阶 30 灵石 → 12 阶 210 灵石
• 修为 5×1.5^(阶-1)，精英 +300×阶；击杀消息白色 + 当前修为
• 背包满时妖丹自动掉死亡处（不丢失）
• 攻击妖兽：物品栏上方显示名字 + 血量 + ⚔攻击力

---

✔ 御空飞行（新增）

• 聊天发送「飞」起飞、「落」降落（金丹期及以上解锁）
• 飞行耗灵气（2/秒），耗尽强制缓降落地
• 起飞/落地特效，飞行时灵气实时显示在物品栏上方

✔ 修仙钟（新增）

• 主菜单「获取修仙钟」，手持右键随时打开修仙菜单

---

✔ 战斗信息（改动）

• 攻击生物：目标名字 + 血量 + ⚔攻击力
• 远程武器（弓/弩）每次射击灵气消耗 3 → 5

✔ 领地传送（修复）

• 中心 + 四角 5 点采样，找最高安全站立点（不再掉虚空）
• 站立点上方 2 格为空校验（不再卡墙）
• 无安全位置时拒绝传送并提示

---

✔ 安装方法

1. 按 BDS 版本选择：xiuxian_addon_v1.0.376_12620.mcaddon（1.26.20）或 xiuxian_addon_v1.0.376_12640.mcaddon（1.26.40）
2. 解压两个 .mcpack 到世界目录：behavior_packs/xiuxian_addon_bp + resource_packs/xiuxian_addon_rp
3. 注册包 ID 与版本，完整重启服务器

本次无新增指令：妖兽自动玩法；飞行/修仙钟均为聊天/手持触发

---

修仙 Addon · 持续更新中 · 更新公告_v1.0.376

修仙 Addon · 更新公告 v1.0.260
突破特效系统 + 领地系统 · 更新日期 2026-08-07 · 适用 BDS 1.26.20 / 1.26.40（双版本包）

---

✔ 本次更新亮点速览

• 突破特效系统 —— 突破时天降光柱、冲击波、能量大球、螺旋天雷，不同境界不同大场面
• 五行属性变色 —— 突破光效颜色随机取玩家自身五行属性（金白金 / 木翠绿 / 水冰蓝 / 火赤橙 / 土土黄）
• 5 个自制音效 —— 传送 / 渡劫 / 结丹 / 结婴 / 突破，100 格内 3D 定位可闻，包体仅 +380KB
• 传送体验升级 —— 到达特效改为白金环绕光圈，告别原版粒子卡顿
• 领地系统 —— 木斧圈地、成员管理、五类防护、领地传送、边界可视化
• 管理指令 —— /xx:stone 灵石调整（管理员）

---

✔ 突破特效分档（突破时自动触发）

突破类型	特效	音效
小境界突破	光束下坠（光柱从天而降 + 对冲光束）	突破音效
大境界·筑基以前（凡人→炼体→练气）	光束下坠	突破音效
大境界·到筑基 / 结丹（金丹）	完整突破（下坠 + 落地爆发）	结丹音效
大境界·到元婴	豪华完整版（光圈→天雷→下坠→爆发→余波）	结婴音效
大境界·化神及以后（化神~飞升）	落地爆发（巨型光束 + 能量大球扩散）	渡劫音效

特效颜色 = 随机取玩家五行属性色；单灵根固定属性色，多灵根每次突破随机变化

---

✔ 特效测试指令（服主调校 / 玩家观赏）

指令	功能
/xx:fx descent [颜色]	光束下坠
/xx:fx impact [颜色]	落地爆发（含能量大球）
/xx:fx charge [颜色]	环绕光圈
/xx:fx thunder [颜色]	天雷渡劫（螺旋闪电）
/xx:fx aftermath [颜色]	余波翻涌
/xx:fx full [颜色]	完整版（下坠+爆发）
/xx:fx plus [颜色]	豪华完整版

颜色：gold金 / purple紫 / cyan青 / red红 / blue蓝 / white白 / metal金行 / wood木行 / water水行 / fire火行 / earth土行

---

✔ 领地系统（新增）

• 木斧圈地 —— 手持木斧左/右键选两点（2D/3D），一键创建；每人最多 5 块，单块边长 ≤500
• 创建 / 删除 / 改名 —— 领地主菜单全管理
• 成员管理 —— 添加/移除成员，成员可建、外人不行
• 五类防护 —— 破坏 / 放置 / 交互 / 捡取 / 爆炸
• 领地传送 —— 一键传回自己的领地
• 边界可视化 —— 粒子边框显示领地范围（可开关）
• 灵石计费 —— 每格 0.02 灵石，最低 50
• 入口 —— /xx:land 领地主菜单

管理指令：/xx:stone give|take <玩家> <数量>（需 xx_tp_admin tag）

管理员怎么获得：

管理员判定 = 玩家身上带 xx_tp_admin tag。给玩家管理员权限需服务器 OP / 控制台执行（需开启作弊）：

代码：

/tag <玩家名> add xx_tp_admin

移除管理员：

代码：

/tag <玩家名> remove xx_tp_admin

管理员可用：/xx:stone 灵石管理、设置/管理公共传送点（/xx:csz 菜单内）

---

✔ 历史功能回顾

• 修炼境界 —— 12 大境界（凡人→飞升），属性线性过渡永不倒挂，突破失败跌层
• 挖矿灵石 —— 18 种矿石获得灵石 + 0.3% 挖矿惊喜
• 炼丹系统 —— 炼丹炉实体放置，6 种丹药（回灵/培元/五行/续命/破障/洗髓）
• 药材种植 —— 15 种药材、8 阶段生长、骨粉催熟、品质方块
• 传送阵 —— 玩家互传 / 个人 20 传送点 / 公共点 / 跨维度
• 交易与转账 —— 灵石转账（5% 手续费）、交易行（上架/浏览/部分购买/离线收益）
• QQ 群联动 —— 聊天互通、群指令（say/list/c）、进服/突破/死亡自动推送
• 界面细节 —— 头顶境界开关、聊天颜色规范、进服提示

---

✔ 安装方法

方式一：BDS 服务器部署（推荐）

1. 按 BDS 版本选择安装包：BDS 1.26.20 → xiuxian_addon_v1.0.260_12620.mcaddon；BDS 1.26.40 → xiuxian_addon_v1.0.260_12640.mcaddon
2. 把 .mcaddon 内两个 .mcpack 解压到世界目录：行为包 → worlds/<世界名>/behavior_packs/xiuxian_addon_bp/；资源包 → worlds/<世界名>/resource_packs/xiuxian_addon_rp/
3. 在 world_behavior_packs.json / world_resource_packs.json 注册包 ID 与版本
4. 完整重启服务器

方式二：客户端导入（单机/局域网）

1. 双击 .mcaddon → Minecraft 自动导入
2. 创建/打开世界 → 设置 → 行为包/资源包 → 启用「修仙 Addon」

---

✔ QQ 群联动配置（可选，不配不影响其他功能）

1. 打开服务器行为包 scripts/qq.js，顶部填写：const WS_URL = 'ws://IP:端口/?access_token=xxx'; const GROUP_ID = 群号;
2. NapCat WebUI → 网络配置 → 新建 WebSocket 服务器（正向 WS），Host 填 0.0.0.0，放行防火墙端口
3. 完整重启服务器，日志出现 [QQ] 已连接 NapCat 即成功

若报错 requesting dependency on module [@minecraft/server-net]，在 config/default/permissions.json 的 allowed_modules 加入 "@minecraft/server-net"

---

✔ 指令速查

指令	功能
/xx:xx	修仙主菜单
/xx:status	查看修仙状态
/xx:absorb <n>	吸收灵石为修为
/xx:restore <n>	恢复灵气
/xx:up	尝试突破
/xx:csz	传送阵
/xx:jy	交易行
/xx:land	领地主菜单
/xx:stone give|take <玩家> <数量>	灵石管理（管理员）
/xx:fx <效果> [颜色]	突破特效测试

---

修仙 Addon · 持续更新中 · 更多玩法敬请期待

====================================================
修仙 Addon 更新公告
当前版本：v1.0.231 | 更新日期：2026-08-05
====================================================

【v1.0.231】适配 BDS 1.26.40
■ 兼容 BDS 1.26.40.8 新版本（功能不变）
■ 提供双版本安装包（1.26.20 / 1.26.40 各一份）
■ 安装包已清空 QQ 配置，按文末配置说明自行填写
■ 修复新版本下插件无法加载的问题

【v1.0.199 ~ 1.0.229】QQ 群联动（重磅新功能）
服务器可接入 QQ 机器人（NapCat），游戏与 QQ 群实时互通：

① 聊天互通
- 游戏内聊天 → 自动转发到 QQ 群
- 群里发：say 内容 → 游戏内全服广播

② 群指令（QQ 群里直接发）
say 内容 在游戏内全服广播
list 查询当前在线玩家及境界
c 玩家名 查询该玩家的修仙状态
（境界/灵根/灵石/修为/灵气/五行/炼丹师）

③ 自动推送
- 进服：XX 加入了服务器
- 突破：【境界突破】XX 突破至 元婴中期
- 死亡：XX 被 僵尸村民 干死了
（50+ 生物中文名、玩家击杀显示玩家名、
摔落/岩浆/溺水等 20+ 原因中文描述）

【v1.0.222】体验优化
■ 死亡复活灵气补充：复活时灵气为 0 自动恢复 80 点

【v1.0.135 ~ 1.0.197】核心玩法合集

■ 修炼境界
- 12 大境界（凡人→飞升），属性线性过渡永不倒挂
- 突破失败反噬扣修为 + 境界跌落
- 五行灵根检测修复

■ 挖矿灵石
- 18 种矿石破坏获得灵石（煤 2 → 远古残骸 350）
- 0.3% 挖矿惊喜：普通方块可能挖出灵气（+1~3 灵石）
- 获得灵石实时显示总灵石数

■ 炼丹系统
- 炼丹炉：主菜单一键放置，每玩家最多 6 个
- 打掉炉子只掉材料，本体需从菜单重新生成
- 6 种丹药：回灵 / 培元 / 五行 / 续命 / 破障 / 洗髓

■ 种植药材
- 15 种药材（10 基础 + 5 稀有），8 阶段生长
- 骨粉催熟、品质方块
- 草丛有概率掉落药材种子（稀有种子 2%）

■ 传送阵
- 玩家互传（对方确认后传送）
- 个人传送点 20 个 / 公共传送点
- 指令 /xx:csz 快捷打开，传送消耗灵石

■ 交易与转账
- 灵石转账：收款方确认，5% 手续费
- 交易行：上架 / 浏览 / 部分购买 / 离线收益
- 妖丹背包一键出售 / 服用

■ 界面与细节
- 头顶境界显示开关（可隐藏）
- 聊天颜色规范（境界/品阶/五行对应彩色）
- 进服提示：[addon:1.0.231] /xx进入菜单

====================================================
【安装方法】

方式一：BDS 服务器部署（推荐，多人联机）
1. 按 BDS 版本选择安装包：
BDS 1.26.20 → xiuxian_addon_v1.0.231_12620.mcaddon
BDS 1.26.40 → xiuxian_addon_v1.0.231_12640.mcaddon
2. 解压 mcaddon 里的两个 mcpack 到服务器世界：
行为包 → worlds/<世界名>/behavior_packs/xiuxian_addon_bp/
资源包 → worlds/<世界名>/resource_packs/xiuxian_addon_rp/
3. 在 world_behavior_packs.json / world_resource_packs.json
注册包 ID 与版本（或用启动器一键加载）
4. 完整重启服务器

方式二：客户端直接导入（单机/局域网）
1. 双击 .mcaddon 自动导入
2. 世界设置 → 行为包/资源包 → 启用「修仙 Addon」

====================================================
【安装后配置（QQ 群联动）】
提示：不配置 QQ 不影响其他功能，可跳过。

① 修改 addon 配置（必做）
编辑服务器世界里的：
worlds/<世界名>/behavior_packs/xiuxian_addon_bp/scripts/qq.js
文件顶部填写两项：
const WS_URL = ''; // 填这里：NapCat 正向 WS 地址
// 格式：ws://服务器IP:端口/?access_token=xxx
const GROUP_ID = 0; // 填这里：你的 QQ 群号（数字）

② 准备 NapCat（QQ 机器人）
1. 安装 NapCat 并登录机器人 QQ（WebUI 默认 6099）
2. WebUI → 网络配置 → 新建 → WebSocket 服务器（正向 WS）
Host：0.0.0.0 端口：如 4955
AccessToken：设置一个（与 qq.js 填的一致）
3. 服务器防火墙/安全组放行该端口

③ 服务器权限（启动报错才需要）
若日志报：
requesting dependency on module [@minecraft/server-net]
but it is not configured to use it
编辑 config/default/permissions.json，
在 allowed_modules 数组加入 "@minecraft/server-net"，
然后完整重启服务器。

④ 验证
重启后日志出现 [QQ] 已连接 NapCat 即成功。
游戏聊天 → 群收到；群里发 say 你好 → 游戏广播

====================================================
【指令速查】
/xx:xx 修仙主菜单
/xx:status 修仙状态
/xx:absorb <n> 吸收灵石为修为
/xx:restore <n> 恢复灵气
/xx:up 尝试突破
/xx:csz 传送阵
/xx:jy 交易行

====================================================
修仙 Addon · 持续更新中
====================================================
浏览附件143767