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

修仙 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