前往下载
2
CyanCuilian
SpigotMC
玄易同志
2026-11-07
支持什么版本
全版本
资源介绍
CyanCuilian 插件功能
一 定位
| 项 | 值 |
|---|---|
| 类型 | 多版本装备淬炼与升星插件 |
| 模板 | CyanMVPluginTemplate |
| 主命令 | `/cuilian` 别名 `/cl` |
| 权限 | `cyancuilian.use` 默认 true |
| 管理权限 | `cyancuilian.admin` 默认 op |
| 依赖 | 可选 AttributePlus 与 SX-Attribute |
| 产物 | 单 Jar 含核心 接口 全部版本桥接 |
二 版本支持
| 服务端 | 桥接 | 策略 |
|---|---|---|
| 1.8.8 | `r1_8_8` | 聊天消息替代标题 旧版粒子 |
| 1.12.2 | `r1_12_2` | 原生标题 旧版粒子 |
| 1.19 与 1.19.2 与 1.19.4 | `r1_19` 系列 | 原生标题 现代粒子 |
| 1.20.1 与 1.20.4 | `r1_20` 系列 | 原生标题 现代粒子 |
| 1.21 至 1.21.11 | `r1_21_11` | 范围桥接 |
| 26.x | `r26_x` | 独立模块 支持 CustomModelData |
- 高版本桥接仅在对应服务端反射加载
- 26.x 已验证 26.1 与 26.2 与 26.3
三 核心玩法
升星
- 熔炉路径 装备放输入槽 淬炼石放燃料槽 约 200 tick 结算
- GUI 路径 27 格界面点确认按钮即时结算
- 两条路径共用 `QuenchingService` 概率与掉星规则只有一份
结算规则
1. 目标等级等于当前等级加石头升星幅度 封顶最高等级
2. 投 0 到 100 随机数 小于目标星级对应 `chance` 即成功
3. 成功直接设为目标等级
4. 失败在 `drop-min` 到 `drop-max` 内随机掉星 不低于 0
5. 命中保护下限时抬回下限 按配置决定是否消耗保护符
保护符
- 手持保护符右键空气或方块进入待附加状态
- 再右键目标装备完成附加
- 目标等级需不低于保底星级
- 失败时托底 保护后按 `consume-on-failure` 决定消耗
移星
| mode | 公式 |
|---|---|
| `SUM_MINUS_ONE` 默认 | 源加目标减一 |
| `SUM` | 源加目标 |
| `MAX` | 取两者较高 |
四 界面
GUI 淬炼 27 格
| 槽位 | 用途 |
|---|---|
| 10 | 放一件可淬炼装备 |
| 16 | 放一枚淬炼石 |
| 13 | 确认按钮 默认铁砧 |
| 其余 | 装饰玻璃板 |
- 关闭自动返还输入物品
- 背包满时掉落在脚下
- 满级或等级未定义时不消耗石头
- 材质按版本自动降级
移星界面 9 格
| 槽位 | 用途 |
|---|---|
| 2 | 源装备 等级清零 |
| 4 | 目标装备 承接等级 |
| 6 | 铁砧确认 |
五 表现层
| 功能 | 触发 | 关键配置 |
|---|---|---|
| 等级 Lore | 星级变化 | `levels.yml` 的 `lore` |
| 部位属性 Lore | 星级变化 | `levels.yml` 的 `attributes` |
| 随机数值 | 等级实际变化时重算 | `<r:10-20>` 占位 |
| 套装效果 | 四件同达最低星级 | `suit.potions` 与 `suit.particles` |
| 全服广播 | 升到 `announce` 为 true 的等级 | `levels.yml` |
| 击杀公告 | 用已淬炼武器击杀玩家 | `kill-message` |
| 手持粒子 | 主手星级达标 | `held-particles` 与 `scripts` |
- 击杀公告为替换原版死亡消息 不是追加广播
- 粒子脚本在后台线程预计算 游戏线程播放缓存帧
- 粒子有每帧预算与轮转上限 人多时部分玩家本轮不播放
六 物品体系
淬炼石 11 种
| ID | 名称 | 升星 | 失败掉星 |
|---|---|---|---|
| `normal` | 普通 | +1 | 1 到 1 |
| `medium` | 中等 | +1 | 1 到 2 |
| `advanced` | 高等 | +1 | 1 到 2 |
| `perfect` | 完美 | +1 | 1 到 3 |
| `ancient` | 远古 | +1 | 1 到 3 |
| `cisan` | 次三 | +3 | 1 到 3 |
| `ciliu` | 次六 | +6 | 1 到 3 |
| `cijiu` | 次九 | +9 | 1 到 3 |
| `cishier` | 次十二 | +12 | 1 到 3 |
| `cishiwu` | 次十五 | +15 | 1 到 3 |
| `cishiba` | 次十八 | +18 | 1 到 3 |
保护符 6 档
| ID | 保底星级 | 失败消耗 |
|---|---|---|
| `rune-3` | 3 | true |
| `rune-6` | 6 | true |
| `rune-9` | 9 | true |
| `rune-12` | 12 | true |
| `rune-15` | 15 | true |
| `rune-18` | 18 | true |
合成与掉落
- 工作台 3 乘 3 九格全满才判定
- 外圈 8 格为原料 中心格为材料
- 取出时校验真实身份 防改名冒充
- 挖掘额外掉落默认关闭 按方块配概率 为额外发放
七 指令
玩家
TEXT
/cuilian open 打开淬炼界面
/cuilian move 打开移星界面
/cuilian info 查看手持装备等级与保护下限管理员
TEXT
/cuilian reload 重载配置与脚本
/cuilian set <等级> 设定手持装备星级
/cuilian clear 清除星级与保护符
/cuilian give <stone|rune> <玩家> <ID> [数量]
/cuilian particles <status|reload>
/cuilian debug <on|off|status>- Tab 补全覆盖子命令 在线玩家名 物品 ID
- 玩家专属命令拒绝控制台执行
八 配置文件
| 文件 | 职责 |
|---|---|
| `config.yml` | 显示名 禁用世界 移星公式 界面外观 公告 掉落 兼容 脚本 粒子 |
| `items.yml` | 可淬炼白名单与部位分类 |
| `levels.yml` | 每级 Lore 属性 公告 套装 最大键即上限 |
| `stones.yml` | 淬炼石定义 概率 掉星 配方 |
| `runes.yml` | 保护符定义 保底 消耗 配方 |
| `messages.yml` | 全部可见消息 |
| `scripts/` | 套装脚本与粒子脚本 附编写教程 |
- 运行时不会反复读取 YAML
九 兼容与扩展
- 属性走 Lore 协议 不链接外部插件内部 API
- 检测到兼容插件则交给它解析 两种方式不重复计算
- 内置只算物理伤害与物理防御
- 数据存隐藏 Lore 跨版本一致 改名后仍可识别
- 十六进制颜色在旧版本降级为最接近传统色
- `item.data` 旧版为耐久值 现代版为 CustomModelData
JAVA
if (CuiLianApi.canCuiLian(item)) {
int level = CuiLianApi.getLevel(item);
CuiLianApi.setLevel(item, level + 1);
}- 插件未启用时 API 安全返回 不抛异常
十 注意
- 等级键必须连续 缺失即视为满级
- `chance` 缺省为 0 不是默认 50
- 删除隐藏 Lore 会使物品失效
- 禁用世界内界面 结算 套装 公告全部拦截
- 套装扫描每秒一次 不是逐 tick
- 脚本权限等同插件 默认关闭 只跑可信代码
- 熔炉时序与外部属性解析建议真实服务端联机验收
作者信息
玄易同志
网站的个人号~