DefCoreLib
def9a2a4 插件家族的共享核心库——一个数据驱动的自定义方块引擎及演示内容。单独安装时仅提供引擎和一些仅通过命令使用的演示物品;其他插件在此基础上构建其功能。详见
提供的内容
- 自定义方块引擎 - 基于 YAML 驱动的玩家头颅方块,支持状态、红石行为、粒子效果、光照、存储以及动画展示实体。特别是使用自定义头颅和展示实体的方式,允许实现酷炫的视觉效果 无需任何模组或资源包!
- 自定义物品与头颅、配方注册及持久化(区块扫描 + 自我修复),供配套插件复用而非重新实现。
- 机制引擎 - 将一组方块转化为移动的展示实体和碰撞体:用于基于胶水的门/吊桥以及机制矿车。
- 配方门控 - 配套插件按命名空间启用其内容的配方,因此安装其中一个插件即可添加一套连贯且可制作的特性集。
- 约 20 个 仅通过命令使用 的演示方块(蜡烛、红石/二进制显示器、储物桶、警报器、旋转/脉冲装饰)- 使用
/defcorelib give获取。并非旨在实用,仅用于测试功能。
被以下插件使用
DefCoreLib 是其他插件安装时依赖的核心库:
- VerticalSlabs - 垂直板
- BetterBanners - 旗帜横幅 + 大型/巨型横幅
- Mechanism - 旋转机制、胶水、机制矿车
- RedstoneDisplays - 红石能量指示头颅
- Pipes - 物品运输管道
画廊
| 插件 | 预览 |
|---|---|
| VerticalSlabs | ![]() |
| BetterBanners | ![]() |
| Mechanism | ![]() |
| RedstoneDisplays | ![]() |
| Pipes | ![]() |
命令
权限 corelib.admin。
| 命令 | 描述 |
|---|---|
/defcorelib give <id> [n] |
给予自定义物品(namespace:id 或简写;例如 give glue -> 给予胶水刷) |
/defcorelib list |
列出所有已注册的方块 ID |
/defcorelib colliders |
切换机制碰撞体发光可视化 |
/defcorelib cleanorphans [confirm] |
查找(并在输入 confirm 后移除)孤立的展示实体 |
前置要求
无——这是基础插件。
链接
- 文档与物品目录:
- 仓库:
- 问题反馈:
DefCoreLib
Shared core library for the def9a2a4 plugin family - a data-driven custom-block engine plus demo content. On its own it only ships the engine and some command-only demo items; other plugins build their features on top of it. See
What it provides
- Custom-block engine - YAML-driven player-head blocks with states, redstone behavior, particles, light, storage, and animated display entities. In particular, the use of custom heads and display entities allows cool visuals without any mods or resource packs!
- Custom items & heads, recipe registration, and persistence (chunk scan + self-healing) that companion plugins reuse instead of reimplementing.
- Mechanism engine - turns groups of blocks into moving display entities + colliders: glue-based doors/drawbridges and mechanism minecarts.
- Recipe gating - companion plugins switch their content's recipes on by namespace, so installing one adds a coherent, craftable feature set.
- ~20 command-only demo blocks (candles, redstone/binary displays, storage barrels, alarms, spinning/pulsing decorations) - grab them with
/defcorelib give. Not meant to be useful, just there for testing the functionality.
Used by
DefCoreLib is a dependency other plugins install alongside:
- VerticalSlabs - vertical slabs
- BetterBanners - flag banners + large/huge banners
- Mechanism - rotation mechanisms, glue, mechanism minecarts
- RedstoneDisplays - redstone power indicator heads
- Pipes - item-transport pipes
Gallery
| Plugin | Preview |
|---|---|
| VerticalSlabs | ![]() |
| BetterBanners | ![]() |
| Mechanism | ![]() |
| RedstoneDisplays | ![]() |
| Pipes | ![]() |
Commands
Permission corelib.admin.
| Command | Description |
|---|---|
/defcorelib give <id> [n] |
Give a custom item (namespace:id or shorthand; give glue -> glue brush) |
/defcorelib list |
List all registered block ids |
/defcorelib colliders |
Toggle mechanism collider glow visualization |
/defcorelib cleanorphans [confirm] |
Find (and, with confirm, remove) orphaned display entities |
Requires
Nothing - this is the base plugin.
Links
- Docs & item catalog:
- Repository:
- Issues:
下载 defCoreLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 defCoreLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 defCoreLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 defCoreLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 defCoreLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
机械装置现在会携带已粘合的机器、坐垫、物品展示框和画作;新增了框架方块、棘轮,以及用于 BlockShips 的船舶推进器和车轮;内置物品目录;对套件进行了领地检查;并修复了大量物品丢失、重复生成和崩溃问题。
更新说明
- 适用于 Paper 或 Purpur 1.21.11、26.1.2、26.2 和 26.3(原为 1.21.8)。
api-version仍为1.21,因此旧版服务器会在启动时加载插件并在运行时失败,而不是在启动阶段拒绝它们。 - 请一起更新所有 def 插件。 Companion 插件需要 DefCoreLib 0.5.0,而 BlockShips 需要此版本及以上(0.0.18 或更高)才能配合使用。
- 机械装置移动速度变慢 —— 速度现在遵循负载质量,且旋转器、升降机和活塞的速度上限有所降低。详情参见机制说明。
- 裸露轴变为涂蜡铜链(原为铁链)。现有世界在区块加载时进行转换,同时保留每个轴的方向。
- 携带的风车仅提供一半动力(0 / 2 / 7,而非 1 / 5 / 15),并且动力块在船上具有一定重量。接近动力、浮力或举升限制的机械装置或船只可能需要重新平衡。详情参见机制说明。
- 框架仅拖拽框架,混合木材框架不再自动粘合。 对于依赖上述特性的现有机械装置,请使用粘合刷处理其关节。
- 机制配方和筛子掉落率发生变化 —— 详见机制说明。
- Pipes、HeadSmith 和 Railbound 有各自的升级说明 —— Pipes 迁移其 config.yml,拆分权限并移除
/pipes recipes;HeadSmith 替换独立 jar 文件及其命令;列车现在在模拟距离外停止。
新功能
- 可携带的机械装置、新方块和天花板安装座 —— 搬运者将嵌套的粘合机器作为一个刚体携带;坐垫、物品展示框和画作随之移动;新增齿轮箱、底盘、棘轮、三个螺旋桨、推进器、反作用轮和三种尺寸的车轮;旋转器、螺旋桨和风车可以悬挂在方块下方;引擎仅在消耗所需动力时燃烧燃料,管理员可通过
config/fuel.yml进行覆盖设置;粘合选择范围最大支持 1024 个方块。(mech 插件) - 船只随世界保存 —— BlockShips 中的船只(任何持久化的机械装置)在其所在区块加载时会通过自身的实体被重新发现;损坏的存档永远不会被删除,恢复过程会在出现一条警告后暂停,直到文件被修复或移走。其他机械装置不会保存,并在其所在区块卸载或服务器关闭时落地。
- 过滤管道 —— 提供三个层级的物品过滤器。(pipes 插件)
- HeadSmith 加入套件,作为 DefCoreLib 的配套插件。(headsmith 插件)
- 内置物品目录 ——
/defcorelib catalog浏览所有 def 插件中注册的方块,按类别分组,支持搜索和配方深入查看。对所有玩家开放(权限corelib.catalog,默认开启)。管理员(权限corelib.admin)可以在条目上右键点击,或在详细视图中右键点击物品,从而给自己发放一个。 - 每个命令的帮助信息 ——
/defcorelib、/mech、/pipes和/headsmith显示插件的功能、可用的子命令以及 GitHub 和 Discord 链接。输入未知的子命令时会显示帮助信息。每个/defcorelib子命令都会检查其自身权限(catalog对所有人开放;其余需要corelib.admin权限)。 give可以指定目标玩家 ——/defcorelib give、/pipes give和/headsmith give接受<id> [数量] [玩家]参数,支持从控制台执行,并将无法放入背包的物品掉落在玩家脚下。数量上限为一个堆叠组(不可堆叠物品数量为 1),如果某个 ID 被多个插件共享,则需要指定命名空间。- 领地检查 —— 粘合、放置手推车和旗帜、连接手推车、手动组装手推车机制、打开自定义容器(GriefPrevention 容器信任、WorldGuard 箱子访问权限、Towny 开关权利)、点燃头颅以及在受保护容器旁放置管道等,都会询问你的保护插件。引擎、燃烧室和吸料漏斗在打开存储时不受容器检查限制。DefCoreLib 软依赖 GriefPrevention、WorldGuard、Towny、Lands、PlotSquared 和 Residence,以便无论加载顺序如何都能获取它们的判定结果,且其测试放置行为对区块日志记录器(CoreProtect、Prism)不可见。
/defcorelib debug [on|off]—— 为 DefCoreLib、Pipes 和 HeadSmith 启用冗长日志记录,直至重启;在新建的plugins/DefCoreLib/config.yml中设置debug: true可保持开启状态。/defcorelib refreshdisplays报告过时的方块显示,并可在加上confirm参数后重新生成它们。- BetterBanners 的层级门限仅限制配方 —— 如果没有 BetterBanners,大型和巨型风车将无法制作,但已有的风车仍可正常使用,并且仍能制作成对应层级的螺旋桨。
面向插件开发者
- 可能影响您的行为变更:
MechanismAssembleEvent现在也会为崩溃恢复的机制触发;请检查isRecovered()。- 当无法写入存档时,
MechanismRegistry.persist()会抛出UncheckedIOException。 DropItemHook现在接收墙变体的物品形式,而不是null。- 方块 YAML 中的
sound值为命名空间键(如block.wood.break);像BLOCK_WOOD_BREAK这样的枚举名称不再加载。 - 可放置的方块必须具有
texture,除非它设置了placeable: false;否则现在会在加载时失败。 MechanismBlockData.blockData可能为null(来自assembleFromParts的无方块部分)。Mechanism新增了抽象方法:仅通过 DefCoreLib 实现它。
- 旋转状态(实验性):
Mechanism.isRotationPowered(int)、rotationSurplus(int)(非节点为 -1;整个网络为一个值)、rotationFacing(int)(机制本地朝向),以及用于已放置方块的CoreLibPlugin.rotationFacingAt(Block)。当机制的网络重新解决时(每 20 刻至多一次)以及在组装时,会触发MechanismRotationSolvedEvent。 - 驱动与持久化: 使用
repositionDriven驱动assembleMechanism(…, existingVehicle, …);persist(Mechanism)、hasPersistedState、discardPersistedState(World, UUID)、isRecoveryPending(UUID)、byId、activeMechanisms();当崩溃撤销的着陆被重做时,会触发MechanismTeardownRedoEvent。 - 船只建造: 座位(
designateSeat、isSeat、seatEntity、setSeatOccupant、SeatListener);碰撞体(colliderCount、getColliderBoxByBlock、colliderEntity、colliderBoxes());vehicle()、totalMass()、blockMass(int);assembleFromParts(PartSpec…);setBlockDemand(未设置时为 0)、isEngineFuelled、setBlockSpinScale、setBlockSpinSpeed、clearBlockSpin;MechanismRegistry.fuelSecondsLeft(Mechanism)(无引擎时为 -1,无引擎燃烧时为 +∞)。 - 着陆接缝:
addPreAirOutListener、CellPlacePolicy/PlaceDecision、DropItemHook、setBeforeEntityRemoval、landingSolidWouldWin(Material),以及BlockSnapshotProviderSPI(registerBlockSnapshotProvider)。类型未注册的已着陆方块会保留外部 PDC 键。 - 胶水与保护:
registerAnchorProvider/ExternalAnchor、openGlueSession、readGlueOffsets、writeGlueOffsets、resolveGlue、clearGlue、glueMaxSize;BuildProbe.mayBuild/isProbing;ContainerAccess.mayOpen(Player, Location)。 - 方块与目录:
requires_plugin配方门控;配方output:覆盖;furnace:和smoking:配方;版本门控配料仅跳过该配方;粒子velocity;构建器钩子onEntitiesLoad、onCapture、onRestore;registerCatalogContribution(CatalogContribution)以及 YAMLcategories:字段。 - 其他:
bannerTiersIn(World, BoundingBox)— 按主机方块的大/巨型旗帜展示(区域至少扩展 3 个方块,仅搜索包含加载实体的区块,且BannerTier.NORMAL表示栅栏旗帜和床旗帜);massRegistry();CushionSeats(实验性,在 26.3 之前返回空答案);用于辅助帮助、用法、标签补全和give的CommandHelp;ContainerAdapter.peekExtract;withPhysicsSuppressed;isCapturingForMechanism;带有rotateBlockData(BlockData, Turn)的BlockRotation.Turn;DebugLog。 CoreLibPlugin.API_LEVEL— 0.5.0 中为 1(自 0.3.2 以来的所有内容);缺失的字段意味着 0。每当消费者可以依赖新功能时,它都会上升。MachineProducedEvent现在在输出合并到部分满堆叠时报告生产的完整数量。
修复
- 飞船在停泊后不久发生碰撞仍能存活。 一个持久化的机械装置(BlockShips 飞船)在被拆解时立即删除了其存档,而此时世界尚未保存已放置的方块。其存档现在被替换为着陆记录;碰撞后的下一次启动将从该记录中完成着陆,且不会干扰那些已经成功写入磁盘的方块。
- 飞船在碰撞后回到原位。 恢复机制现在以找到的载具为中心,而不是上次保存的位置。移除由碰撞留下的框架或碰撞体的第二个副本,并重新生成缺失的碰撞体。
- 货物随世界一起保存,并且当玩家带着打开的货物菜单登出时也会保存,因此碰撞后货物的状态与玩家的物品栏保持一致。
- 拾取方块不再创建自定义方块 —— 在生存或冒险模式中右键点击自定义方块或矿车会选中你携带的一个,而不是铸造一个新的(创造模式仍然会给予)。
- 旧版自定义物品再次可用于合成配方 —— 在描述变更之前制作的物品(0.3.2 外壳、旋转器、风扇、链式滑轮、角管等…)会在你打开物品栏、加入游戏或拾取它们时进行刷新。
- 当保护插件拒绝破坏或爆炸时,自定义方块保持完整 —— 它们以前无论如何都会掉落物品和内容物,导致重复。
- 机器内容物在每个世界保存时存储(自动保存、
save-all),而不仅仅是在区块卸载时。 - 飞船货物复制漏洞 —— 如果飞船所在的区块卸载时货物菜单仍处于打开状态,玩家可以取出那些在重新加载后又返回的物品。现在菜单会自动关闭。
- 无法读取的容器会被密封 —— 如果自定义容器或飞船货物的存档内容无法读取(例如在移除数据包后),它将无法打开且永远不会被覆盖保存;数据将保持原样,并记录警告日志。
- 一个无法读取的方块不再阻止已保存的飞船恢复 —— 一个其保存形式不再加载的携带方块(例如在数据包或版本更改后)会以该方块的普通默认形态返回,如果方块已不存在则返回空气,并附带警告;以前这会导致飞船卡住无法恢复。
- 卸载世界(如 Multiverse 等插件)时会保存并释放其自定义方块和容器,并让任何移动的机械装置或加载的机制矿车着陆;重新加载世界可能导致容器物品重复或丢失。
- 碰撞前不久放置的自定义方块会被正确识别 —— 水车、锅炉或机械分配器可能会变回普通的原版方块。
- 被拒绝的放置操作不留痕迹 —— 被拒绝的自定义放置曾留下一个不可见的标记,使下一个匹配的原版方块变成自定义方块。
- 活塞弹出自定义头部而不是剥离它 —— 被推动的装饰性头部、垂直石板或指示器现在会以其自身的物品形态(或其通常的方块掉落物)掉落,并保留其存储内容,而不是作为普通的玩家头部移动。
- 风之弹和微风不再影响自定义方块 —— 它们的阵风会破坏自定义头部并溢出其存储内容,即使在领地范围内也是如此。
- 石匠菜单分页 —— 输入拥有超过 45 个自定义输出时,只显示前 45 个。
- 脉冲风暴下的服务器卡顿 —— 旋转网络和自定义铁轨的重算合并为每刻一次,且插件自身的方块写入不再反馈到其自身的物理循环中。
- 目录浏览成本低廉 —— 它只排序一次,并且仅构建你正在查看的那一页。
- 重新加载辅助插件(PlugMan)时,扫描已加载的区块只需一次,而不是每种方块类型各一次。
- 在存储菜单打开的情况下停止或重新加载服务器,不再为每个菜单记录错误日志。
- 区块卸载、自定义方块旁的漏斗传输以及持久化机械装置的世界保存快照成本更低。
有关各插件的具体细节,请参阅对应的插件说明(mech、pipes、railbound、headsmith、bbanners、rsd、vslab);机械装置和机器的修复内容位于 mech 说明中。
DefCoreLib v0.3.2
托管新的 Railbound 内容,并添加可选的动态光照钩子。
- 随包提供 Railbound 矿车与铁轨方块,并在安装 Railbound 配套模组时驱动列车、燃料、连接以及特殊铁轨逻辑(配方受其限制;若未安装,方块可通过 /defcorelib give 指令获得但无法合成,且列车无法运行)。
- 可选 DynLight 集成:点燃的高炉矿车会通过 DynLight 插件发出动态光照(无硬性依赖;缺失时无效)。移动机制现在改为在方块位置而非枢轴点发出光照。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。





评论 0
登录后参与评分
还没有评论,来抢沙发吧