LDLib2
一款现代化的 Minecraft 模组开发库,涵盖 UI、渲染、同步、持久化及游戏内编辑器功能。
Documentation | Java Integration | UI Guide | Discord | CurseForge | Modrinth
LDLib2 是对原版 LDLib 的全面重写,围绕现代 Minecraft 和 NeoForge 开发进行了重新设计。它为模组作者提供了一个更高层级的底层基础,用于构建 UI、游戏内工具、基于渲染器的内容、同步数据以及持久化运行时系统,无需在每个项目中重复构建相同的基础设施。
功能亮点
|
LDLib2 UI 使用 Taffy 驱动的布局、LSS 样式表、可复用组件、XML 定义、数据绑定、RPC 事件以及 HUD 覆盖层来构建 Minecraft 屏幕。 |
数据同步与持久化 通过注解 @Persisted、@DescSynced 以及 RPC 辅助方法,以极少的样板代码生成 NBT IO、编解码器(codecs)、脏字段同步和数据包传输流程。
|
![]() 节点图工具箱 (Node Graph Toolkit) 创建包含节点、端口、连线、变量、子图、黑板(blackboards)、可撤销命令以及基于资源的图资产的游戏内图形编辑器。 |
![]() 游戏内编辑器框架 构建类似 Unity、Blender 或 Blockbench 风格的工具,支持可停靠视图、项目文件、资源浏览器、检查器、历史记录、设置以及自定义编辑器面板。 |
![]() Configurable 将带有注解的 Java 对象转换为可供检查器使用的属性面板,包括范围选择、下拉选择器、列表、资源位置、搜索框、撤销历史以及持久化支持。 |
![]() 渲染与集成 结合 LDLib2 的光影、纹理、模型渲染、场景和编辑器工具,并与 JEI、REI、EMI、KubeJS 以及 Java 插件入口点等常见模组开发工作流配合使用。 |
完整指南请参阅 UI 入门指南。
链接
许可
LDLib2 根据 LGPL-3.0 license 授权。
LDLib2
A modern Minecraft modding library for UI, rendering, synchronization, persistence, and in-game editors.
Documentation | Java Integration | UI Guide | Discord | CurseForge | Modrinth
LDLib2 is a complete rewrite of the original LDLib, redesigned around modern Minecraft and NeoForge development. It gives mod authors a higher-level foundation for building UI, in-game tools, renderer-backed content, synchronized data, and persistent runtime systems without rebuilding the same infrastructure in every project.
Feature Highlights
|
LDLib2 UI Build Minecraft screens with Taffy-powered layout, LSS stylesheets, reusable components, XML definitions, data bindings, RPC events, and HUD overlays. |
Data Synchronization and Persistence Annotate fields with @Persisted, @DescSynced, and RPC helpers to generate NBT IO, codecs, dirty-field sync, and packet flow with minimal boilerplate.
|
![]() Node Graph Toolkit Create in-game graph editors with nodes, ports, wires, variables, subgraphs, blackboards, undoable commands, and resource-backed graph assets. |
![]() In-game Editor Framework Build Unity-, Blender-, or Blockbench-style tools with dockable views, project files, resource browsers, inspectors, history, settings, and custom editor panels. |
![]() Configurable Turn annotated Java objects into inspector-ready property panels, including ranges, selectors, lists, resource locations, search fields, undo history, and persistence. |
![]() Rendering and Integrations Use LDLib2's shader, texture, model rendering, scene, and editor utilities together with common modding workflows such as JEI, REI, EMI, KubeJS, and Java plugin entry points. |
For a full walkthrough, see the UI Getting Started guide.
Links
License
LDLib2 is licensed under the LGPL-3.0 license.
下载 LDLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LDLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LDLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LDLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LDLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LDLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LDLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LDLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LDLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LDLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
v2.2.46.a
- 修复了自 v2.2.46 起,具有方形角落的 SDF 矩形在绘制时其填充的一半变为透明的问题
v26.3.2.45.a
- 为场景添加了改进的透明度支持:当游戏使用此功能时,
WorldSceneRenderer会按照层级渲染的方式,通过无顺序依赖透明度(order-independent transparency)阶段来绘制半透明方块和特性。调用setFollowImprovedTransparency(false)可使场景采用经典混合方式;正交场景以及未启用深度绘制的场景也会保持经典混合模式。
v26.3.2.45
- 添加了
MarkStrategies,这是一个用于判断类的值是否发生更改的廉价方法的注册表,以及用于计算自身更改次数的值的IContentVersion - 添加了
UIRecording,这是一种带有平滑指针、点击和按键叠加层、字幕及缩放功能的脚本化 UI 视频录制功能,通过-PldRecord运行,同时支持 OpenGL 和 Vulkan - 为 OS 窗口添加了独立的 GUI 缩放比例,可通过右键单击浮动选项卡或从“视图”>“窗口大小”中选择
- 添加了
UIElement#reorderChildren,该方法在不分离子元素的情况下将元素的子元素按新顺序排列,从而使焦点和正在运行的动画得以保留 - 添加了
UIElement#getContentHost,这是外部添加的子元素所属的元素,对于ScrollerView而言即为其内部容器 - 添加了
ModularUI#addFrameCallback和removeFrameCallback,用于在样式和布局计算之前每帧都要执行的工作 - 改进了异步同步:每个周期每个区块发送一个数据包,并将无人关注的区块更改在未编码状态下保留直到有人关注,同时仍保存这些更改
- 改进了异步同步:每个周期每个方块实体调用一次
setChanged,而不是每次字段更改时都调用 - 改进了托管字段的更改检测:逐个槽位比较 NeoForge 的物品、流体和资源堆栈处理器,而不是每个周期都序列化它们;直接比较字符串、数字、枚举和注册表条目的集合与映射;当编解码器标记的字段发生更改时,仅编码一次而非两次
- 改进了附加和分离异步逻辑至常数时间复杂度,因此一次性卸载大量方块实体不再导致服务器卡顿
- 改进了
UIElement#getOrCreateMessageRPC,使子类可以调用它,并从其构造函数中在两端注册命名消息 RPC - 改进了取消的场景编译:使其在下一个方块处停止,而不是在其方块组的末尾停止
- 改进了编辑器的“最小化”提示:更新已显示的提示,而不是排队另一个
- 改进了 UI 测试帧等待:允许每帧的时间而不是固定超时,因此单个 GPU 上的多个测试客户端不再超时
- 修复了在另一种 GUI 大小的 OS 窗口中,半透明和蒙版元素被挤压或拉伸到游戏窗口大小的问题
- 修复了仍在运行时取消的场景编译写入或释放下一个编译构建使用的缓冲区的问题
- 修复了托管列表和集合中的空元素加载回
_NULL_或其前一个元素的副本的问题 - 修复了物品和流体堆栈标记与实时堆栈共享组件映射的问题
- 修复了没有 RPC 的同步持有者永远不离开异步线程的问题
- 修复了关闭 OS 窗口后其 UI 仍然存活,导致泄漏并跳过编辑器清理的问题
- 修复了从代码弹出的编辑器被其设置拉回游戏窗口的问题
- 修复了 UI 编辑器从其自己的窗口停靠回来时丢失 JEI 的问题
- 修复了布局为空的可自适应滚动条从不增长,从而隐藏了浮动窗口的选项卡条的问题
- 修复了选择上下文菜单条目后焦点停留在已关闭的菜单上,导致后续快捷键无效的问题
- 修复了添加到 UI 后 ID 发生变化的元素不再能通过该 ID 找到的问题
- 修复了标签和进度条在其数据源解除绑定后仍保留其刻度监听器的问题
- 修复了
runParTest和runMpTest同时从多个子构建中构建相同文件,在具有子项目的项目中失败,并在运行死亡且未写入自身结果时报告先前运行的结果的问题 - 修复了 UI 模板向控制台打印空白行的问题
- 修复了 UI 测试世界未冻结时间、天气、生物生成和火焰,其游戏规则由不再存在的名称设置的问题
- 修复了配方查看器被保留在 UI 首次布局的排除区域,无论其元素之后如何移动
v26.2.2.45
- 添加了
MarkStrategies,这是一个用于廉价判断类的值是否发生更改的注册表,以及IContentVersion,用于对自身更改进行计数的值 - 添加了
UIRecording,一种带有平滑指针、点击和按键覆盖层、字幕及缩放功能的脚本化 UI 视频录制功能,支持-PldRecord运行参数,兼容 OpenGL 和 Vulkan - 为 OS 窗口添加了独立的 GUI 缩放设置,可通过右键单击浮动标签页或从“视图”>“窗口大小”中进行选择
- 添加了
UIElement#reorderChildren,该方法可在不分离子元素的情况下将其重新排序,从而保留焦点和正在运行的动画效果 - 添加了
UIElement#getContentHost,即外部添加的子元素所属的元素;对于ScrollerView而言,这是其内部容器 - 添加了
ModularUI#addFrameCallback和removeFrameCallback,用于在计算样式和布局之前每帧执行的工作 - 添加了
Scene#setLighting,用于设置场景为其实体和方块实体着色的漫射光照 - 改进了异步同步:每个周期仅发送每个区块的一个数据包,并将无人监看的区块更改在未编码状态下保留(直到有人查看),同时仍对其进行保存
- 改进了异步同步:每个周期对每个方块实体调用一次
setChanged,而不是针对每个更改的字段调用一次 - 改进了托管字段的更改检测:按槽位逐个比较物品和流体容器,而不是每个周期都对其进行序列化;直接比较字符串、数字、枚举和注册表条目的集合与映射;当编解码器标记的字段发生更改时,仅编码一次而非两次
- 将附加和分离异步逻辑的时间复杂度优化为常数时间,因此一次性卸载大量方块实体不再导致服务器卡顿
- 改进了
UIElement#getOrCreateMessageRPC,使子类可以调用它,并从其构造函数中在双方注册命名消息 RPC - 改进了已取消的场景编译行为:现在会在下一个方块处停止,而不是在其方块组的末尾停止
- 改进了编辑器的“最小化”提示:更新当前显示的提示,而不是排队显示另一个
- 修复了托管列表和集合中的空元素加载回
_NULL_或其前一个元素的副本的问题 - 修复了物品和流体堆栈标记与实时堆栈共享组件映射的问题
- 修复了没有 RPC 的同步持有者永远无法离开异步线程的问题
- 修复了关闭 OS 窗口后其 UI 仍处于存活状态,导致内存泄漏并跳过编辑器清理过程的问题
- 修复了通过代码弹出的编辑器因其设置而被拉回游戏窗口的问题
- 修复了 UI 编辑器在从其自身窗口停靠回来后丢失 JEI 的问题
- 修复了布局为空的可自适应滚动条永远不会增长,从而隐藏浮动窗口选项卡条的问题
- 修复了选择上下文菜单项后焦点留在已关闭的菜单上,导致后续快捷键无效的问题
- 修复了 ID 在添加到 UI 后发生变化的元素无法再通过该 ID 被找到的问题
- 修复了标签和进度条在其数据源解除绑定后仍保留其 tick 监听器的问题
- 修复了
runParTest和runMpTest同时从多个子构建中构建相同文件,导致包含子项目的工程失败,并在某次运行在写入结果前崩溃时报告之前运行的结果的问题 - 修复了 UI 模板向控制台打印空行的问题
- 修复了场景隐藏半透明方块后方物体、使面向相机的物体背离其相机、以及由先于它们绘制的对象决定实体光照的问题
- 修复了
FluidStorage未保存或同步其容量,导致运行时更改的流体容量恢复为初始构建时的容量的问题 - 修复了配方查看器被保留在 UI 首次布局的排除区域中,即使其后元素位置发生变化也是如此的问题
v26.2.2.43.a
- 修复了缓存场景在首次编译后其方块发生变化时不渲染的问题,例如编辑器场景在首次显示后填充内容时
- 修复了在场景仍在运行时取消编译,导致写入或释放下一个编译所构建使用的缓冲区的问题
- 修复了 UI 测试世界未冻结时间、天气、生物生成和火焰的问题;其游戏规则名称已在 26.2 中不再使用
- 改进了 UI 测试帧等待机制,使其为每一帧预留足够的时间,而非使用固定的超时时间,从而避免同一 GPU 上的多个测试客户端出现超时
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
适用于 MC 1.18+ 的 Effekseer 加载器




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