节点图

节点图

一个可重用的节点图编辑器库及评估引擎。

NodeGraph

Maven Central
License

一个适用于 Minecraft Forge 1.20.1 的可复用节点图编辑器库和求值引擎。

功能特性

  • 节点编辑器：包含标题、带类型的输入/输出端口以及输入控件（文本 / 滑块 / 按钮组 / 下拉菜单）的节点
  • 类型系统：按类型设置颜色、注册表、自动转换规则（渲染时带有警告提示）
  • 求值引擎：类似 Blender 的惰性求值，支持循环检测和每次运行的缓存
  • 画布：平移 / 缩放 / 滚动、网格、可嵌入的 NodeGraphWidget
  • 节点组：线框盒、拖拽重组、调整大小手柄、按组缩放
  • 编辑功能：框选、右键上下文菜单、复制 / 剪切 / 粘贴、完整撤销/重做、快捷键（Ctrl+C/X/V、Del、Ctrl+Z / Ctrl+Shift+Z）
  • 添加节点：可搜索覆盖层；将端口拖拽到空白区域会打开类型过滤菜单，并自动连接
  • 实时结果：输出端口每帧显示其求值结果；控件编辑会立即重新计算下游内容

安装方法

Gradle（Forge 1.20.1 模组使用者需使用 fg.deobf）：

repositories {
    mavenCentral()
}

dependencies {
    implementation fg.deobf('io.github.tt432:nodegraph:1.0.0')
}

游戏内使用

  1. 从工具创造标签页获取 节点图编辑器 物品。
  2. 右键点击打开编辑器。
  3. 从输出端口拖拽到输入端口以连接它们 —— 仅限相同类型，或自动转换（显示橙色警告）。
  4. 右键点击画布 → 添加节点... 从目录中插入；将端口拖拽到空白区域会打开类型过滤菜单，并自动连接新节点。
  5. 点击文本输入控件编辑其值；下游结果会实时重新计算。
  6. 中键拖拽平移，Ctrl+滚轮缩放，左键在空白区域拖拽进行框选。

许可证

MIT