龙核方块 LyDragonBlock

LyDragonBlock 用来把 DragonCore 方块做成可放置、可保存、可交互的家具方块。玩家从 /ldb open 获取方块物品，放置后插件会记录位置、放置者、方块 ID 和原始物品，再按 block/*.yml 的配置处理左键、右键、破坏事件。

插件信息

项目	内容
插件名	LyDragonBlock
中文名	龙核方块
插件版本	1.0.1
作者	离渊
主命令	/ldb
硬前置	ProtocolLib
软依赖	PlaceholderAPI、DragonCore
支持版本	1.12.2、1.20.1

警告

ProtocolLib 缺失时插件无法正常工作。DragonCore 方块展示和动画相关功能需要 DragonCore。

主要功能

功能	说明
方块总览	OP 使用 /ldb open 打开总览，点击获取可放置的方块物品。
方块保存	方块放置后保存到 plugins/LyDragonBlock/data/，重启后会自动载入。
放置指令	方块放置成功后可执行控制台指令或 OP 指令。
交互事件	支持左键、右键、破坏三种事件。
条件判断	支持 PAPI 公式、权限、无权限、概率、指定槽位物品名和 Lore 判断。
动作脚本	支持消息、指令、动画、坐下、冷却、掉落、移除和中断。
主人限制	可禁止非放置者破坏指定方块。

指令

指令	说明
/ldb	OP 查看插件帮助。
/ldb open	OP 打开方块总览，点击获取方块物品。
/ldb reload	OP 重载主配置和 block/ 方块配置。
/ldb load	OP 手动载入方块存储数据，仅初始化失败时使用。

提示

从 /ldb open 获取的物品会带有插件需要的数据。不要直接用普通头颅或手动改名的物品代替。

基础流程

1. 在 DragonCore 方块配置中准备好方块，并记下对应的 match。
2. 在 plugins/LyDragonBlock/block/ 新建或修改方块 yml。
3. 把方块 ID 的 match 填成 DragonCore 方块配置里的 match。
4. 使用 /ldb reload 重载配置。
5. 使用 /ldb open 获取方块物品并放置测试。

文档索引

页面	内容
配置说明	主配置、方块文件、放置指令和事件结构。
事件动作	左键、右键、破坏事件与动作脚本。
条件与槽位	条件写法、物品槽位、名称和 Lore 判断。
开发接口	当前可确认的 Java 接口。
常见问题	加载、总览、交互、破坏和数据排查。