- 版权类型
- 原创
- 插件中文名称
- 拓灵绽放
- 插件英文名称
- TuoLingBloom
- 原帖地址
- 原创哦
- 支持的核心(服务端)
- Spigot
- Paper
- 语言支持
- 中文(简体)
- 前置组件
- DragonCore 2.1.6.5
TuoLingCore 1.0
MythicMobs 4.11
PlaceholderAPI 2.11
- 适配版本(Java)
- 1.12
拓灵绽放 TuoLingBloom
插件功能
核心绽放
- 双路线支持:贴图路线(texture,基于世界贴图渲染)与模型路线(model,基于 MythicMobs 实体挂载)
- 5 种物品获取策略:
- main-hand 主手物品
- off-hand 副手物品
- dragon-slot 龙核自定义槽位
- inventory 背包指定槽位索引
- direct-bloom 直接绽放(无需物品,value 指定 identify 表名)
- 多层魂环:单次绽放可同时渲染多个贴图层,支持逐层延迟入场动画
- 无限嵌套预设索引:支持多层目录组织 preset,按需展开
动画与持续
- 逐层动画:每层独立配置 delay / 位移 / 缩放 / 旋转动画
- 持续时间:duration 控制自动取消(-1 为永久,常见于魂兽与世界贴图)
- 冲突检测:同 group 内不能同时绽放,已绽放时再次执行同预设即取消
冷却系统
- 分组冷却:同组共享冷却(如主手1/主手2 互斥冷却)
- OP 免冷却:op-not-cooldown 开关
- 怪物免冷却:魂兽绽放不走冷却逻辑
世界贴图
- 独立 world-texture.yml 配置固定坐标的世界贴图
- 支持按玩家补发,玩家上线自动渲染
- reload 后自动清理并重新渲染
补发机制
- 玩家重进服务器自动补发已绽放的贴图
- 怪物生成时自动给附近在线玩家补发
- 实体死亡/取消时自动清理所有观察者的客户端贴图
配置热重载
- /bloom reload 重载全部配置后,自动用新配置重新绽放所有正在绽放的实体与世界贴图
- 两阶段执行:先统一取消清理旧状态,再统一用新配置绽放
识别系统
- identify-texture:通过 check-lore / check-name 识别物品对应的贴图路径
- identify-model:识别物品对应的 MythicMobs 模型名
- 支持双条件同时校验(lore + name 都匹配才生效)
其他
- PAPI 变量:%tuolingbloom_cooldown_<预设名>% 查询冷却
- 软依赖隔离:MythicMobs / PlaceholderAPI 未安装时自动降级
- 多版本兼容:版本敏感操作(路径、模型名)统一 String 返回,策略封装
附赠可视化编辑器
随插件附赠一个 3D 可视化配置编辑器,无需手写 YAML,所见即所得:- 3D 实时预览:Three.js 渲染,直接预览魂环/贴图在玩家身上的最终效果
- 可视化拖拽:调整位置、缩放、旋转,参数实时同步到配置
- 双编辑模式:可视化编辑与原始 YAML 编辑可一键切换
- 贴图套用:从 DragonCore 目录一键套用贴图到对应魂环层
- 零依赖后端:PowerShell 编写,Windows 自带即可运行(start.bat 双击启动)
玩法
你可以拿这个插件做:- 花式绽放 —— 多层魂环组合特效
- 特效插件 —— 技能释放/受伤时的动态贴图表现
- 宠物插件 —— 模型路线挂载 MythicMobs 实体作为跟随宠物
- 武魂真身插件 —— 龙核槽位触发模型变身
- 表情包插件 —— 头顶表情包循环播放
- 称号插件 —— 玩家头顶/背部常驻称号贴图
指令
- /bloom run <预设名>:绽放指定预设组(玩家)
- /bloom remove <预设名>:取消指定预设绽放(玩家)
- /bloom reload:重载全部配置并重新绽放(OP)
PlaceholderAPI
软依赖,未安装不影响使用- 变量:%tuolingbloom_cooldown_预设名% 返回玩家该预设的冷却剩余秒数(0 表示无冷却/可绽放)
- 示例:%tuolingbloom_cooldown_主手%
依赖
必装:- DragonCore:龙核,提供世界贴图、客户端实体模型挂载等核心 API
- TuoLingCore:拓灵核心框架,提供命令注册、管理器基座
- MythicMobs:模型路线生成挂载模型所用怪物实体(不装影响:仅 model 路线不可用)
- PlaceholderAPI:提供冷却查询变量(不装影响:变量失效,其余功能正常)
代码规模
- TuoLingBloom:71 文件 / 3,923 行
- TuoLingCore:14 文件 / 885 行
- 合计:85 文件 / 4,808 行
AI 使用率
- bloom + core:85% 手写(包括框架)
- 编译器 + 文案:99% AI 写