GFBS 3D-CONSOLE Studio 0.3.2

GFBS 3D-CONSOLE Studio 是 LytharaLab 为 GFBS-Main / 3D-CONSOLE 制作的 Blockbench Desktop 可视化 Scene 编辑器。

它直接打开和保存：

data/<namespace>/gfbs_console/scenes/*.json

GFBS Scene JSON 始终是 source of truth；不会要求 .bbmodel 中间格式。

0.3.0 把 Studio 从“能编辑 Scene”推进到更完整的 3D-CONSOLE 制作工作台：修复画布节点拾取，加入引用安全的重命名/复制、节点导航、预检总览、完整快捷创建项、资源根管理，以及能直接运行 Preview Runtime 的 Starter Console Assembly。

0.3 核心升级

所有节点都能从画布选中：每个 Console 节点拥有不可见的拾取代理；模型、文字会按实际内容自动贴合，Interaction 按 hit shape 贴合，纯逻辑节点也保留稳定点击范围。
父子 Transform 真正联动：移动、旋转或缩放父节点时，整个子树即时跟随，同时继续以局部 Transform 写回 Scene JSON。
Console 节点可真正收纳子节点：node_3d 等 Console 节点现在会被 Blockbench 识别为 Outliner 父节点，可直接把 model、text 等节点拖入；右键或 Structure 菜单另有 Move to Console Parent...，支持多选、循环检测和保持世界 Transform。
不会再由父节点吞掉子节点选择：父级代理只计算自己的直接视觉内容，不包围整棵子树。
清晰的选中反馈：Render / Authoring / Debug 三种视图中，当前节点都有轻量琥珀色选择框。
引用安全重命名：改 Node ID 时同步更新 Indicator、Animation、Binding、Connection、Preview Override 与资源诊断引用；支持 ID 内含 .。
引用安全复制子树：自动生成全局唯一 ID，重写内部引用，并复制相关 Binding / Connection / Preview Override。
Find / Select Node：通过完整 Outliner 路径与节点类型快速定位节点。
Scene Overview / Preflight：集中查看节点类型统计、逻辑图规模、资源缺失与保存前错误。
Starter Console Assembly：一键生成 Panel、Text、Button、Toggle、Knob、Slider、Indicator、Property、Binding 与 Connection 相互连通的示例骨架。
完整快捷创建：补齐 Knob、Lever、Slider、Indicator、Animation、Sound、Timer、Linear/Grid/Surface Layout。
Resource Roots 可管理：除了添加，还能删除、清空和调整优先级。
节点类型图标：Outliner 使用对应的 Model、Text、Sound、Control、Layout 等图标，复杂场景更易读。
Minecraft 1.20.1 字体一致预览：Text 不再使用浏览器 monospace；Studio 会读取 Minecraft font/default.json、位图字形与 include/unifont / unifont.zip，按游戏端相同的字符宽度、字距、ascent、2x oversample 与 9px 行高生成预览。中文不会再因系统字体回退而在进游戏后突变；legacy Unicode 资源包也仍可预览。

Text 字体资源与 Vanilla 模型资源共用同一套来源解析。一般使用 Auto-detect Minecraft 1.20.1 Assets 即可；也可以通过 Set Minecraft Client JAR... 指定客户端 JAR。字体位图异步完成解码后，文字平面会自动按真实像素宽度重建，无需重新打开场景。若资源中缺少 assets/minecraft/font/default.json，Resource Status 会明确标记该 Text 正在使用临时系统字体，而不会把近似结果冒充为 MC 预览。

Minecraft 1.20.1 的 unifont.zip 由 client JAR 内的字体定义引用，实际字节可能位于启动器的哈希资源库中。Studio 会把已经选中的 client JAR 作为安装根锚点并优先读取其资源；插件同时内置完整且字节一致的 1.20.1 默认字体资源组。Blockbench 若解析出“合法但只有 bitmap、没有 Unihex”的 minecraft:default，Studio 会强制把 1.20.1 原版 Unihex 追加为最终 Unicode 覆盖层；资源包 provider 保持更高优先级。若 Blockbench 提供的是残缺 Unihex，普通 provider 全部查找失败后还会直接查询内置原版码点，然后才允许进入 missing-glyph 分支。外部字体链无论在哪一环失真，原版支持的中文都不会再被画成方框。

Blockbench 自带的 Move to Group / 移动至分组 只面向原生 Group，不负责 GFBS Scene 节点。0.3.2 已从 Console 节点菜单移除这个误导入口，请使用拖放或 Move to Console Parent...。

Studio 让 Blockbench 真正承担 3D-CONSOLE Scene Visual Editor / Studio 的职责：真实模型预览、干净 Render View、交互调试、Preview Runtime、Binding/Indicator/Material 状态预览，以及结构化逻辑编辑。

运行要求

Blockbench Desktop 5.0+
GFBS-Main 当前 3D-CONSOLE format_version: 1
推荐把 Scene 放在标准 Forge/Gradle 项目下：

<project>/src/main/resources/

安装

打开 Blockbench Desktop。
File → Plugins...。
选择 Load Plugin from File。
选择 dist/gfbs_console_studio.js。
安装后会出现 GFBS 3D-CONSOLE Scene 格式和 Tools → GFBS 3D-CONSOLE Studio 菜单。

打开 Scene

Visual Editor

三种 View Mode

Render

默认模式。

只显示真正有视觉意义的 Scene 内容：

Model
Text
Material / Indicator preview state
glTF animation preview

不会把所有 Node、Indicator、Sound、Interaction hitbox 全部画成蓝色 wireframe。

无法解析的模型只显示一个很小的洋红色 missing marker，而不是 1×1×1 大代理方块淹没场景。

Authoring

显示真实场景，同时只给当前选中节点显示编辑辅助：

origin
interaction hitbox
spatial helper
logic helper

适合摆放、对齐、改 hitbox。

Interaction Debug

显示真实场景，并打开所有交互/逻辑辅助信息，适合检查：

Button / Toggle / Knob / Lever / Slider hit shape
Sound range helper
logic/spatial node helper

菜单：

Tools
└─ GFBS 3D-CONSOLE Studio
   ├─ View Mode: Render
   ├─ View Mode: Authoring
   └─ View Mode: Interaction Debug

Model Preview

GFBS glTF

gfbs_main:gltf：

优先使用 Blockbench 当前 THREE.GLTFLoader
支持 glTF / GLB
保留 hierarchy / standard material
支持 named node / part alias 查找
支持 Scene Material Profile preview
支持 Indicator 状态驱动 profile
支持 Animation node 的 playing / speed Preview Runtime
Blockbench 无 GLTFLoader 时保留静态 core glTF fallback reader

项目资源：

source.location = gfbs_main:models/console/foo.gltf

解析为：

src/main/resources/assets/gfbs_main/models/console/foo.gltf

Vanilla / Minecraft JSON

gfbs_main:vanilla_json 不再只是 wireframe proxy。

0.2.0 内置 Minecraft Java model preview renderer，支持：

parent
block registry ID → blockstates/*.json model fallback
texture variable inheritance，例如 #all
namespace inheritance
elements
from / to
six faces
per-face texture
UV
face texture rotation
element rotation
element rotation origin
rescale
shade: false
transparent texture
item/generated / layer0 的平面预览

例如：

{
  "source": {
    "adapter": "gfbs_main:vanilla_json",
    "location": "minecraft:polished_deepslate"
  }
}

插件会尝试解析：

assets/minecraft/models/block/polished_deepslate.json

并递归读取它的 parent 和 textures。

Minecraft 原版资源从哪里来？

插件按顺序搜索：

当前 Forge project 的 src/main/resources
手工添加的 Resource Pack / resource root
手工指定的 Minecraft assets directory 或 client JAR
自动探测 Minecraft 1.20.1 client JAR

Windows 默认会尝试：

%APPDATA%\.minecraft\versions\1.20.1\1.20.1.jar

以及 ForgeGradle Minecraft cache。

插件内置轻量 ZIP/JAR resource reader，因此不需要先解压 Minecraft JAR。

Preview Runtime

0.2.0 新增编辑器内 Preview Runtime。

它会建立当前 Scene 的 property state：

Scene root properties
Node authored properties
built-in properties
Preview overrides

然后执行当前 Binding：

Direct
Map
Range
Format

所以例如：

power_toggle.state
        ↓ binding
$root.power
        ↓ indicator
PowerLamp material profile

可以直接在 Blockbench 中预览。

菜单：

Preview Runtime State...

可以给任意已知 property 设置仅编辑器使用的 override，例如：

$root.power = true
$root.mode = AUTO
output_knob.value = 0.75
scanner_animation.playing = true

这些 Preview override 不会写进 Scene JSON。

Show Resolved Preview State 可以查看经过 Binding 后的最终属性值。

Material Profile Preview

Model 的 material_profiles 会作用到真实 linked preview，并按当前 GFBS adapter 能力区分：

GFBS glTF adapter：

PBR
UNLIT
NEON（Blockbench 近似预览）
color
alpha
emissive color
emissive strength
neon strength
fullbright
visible

vanilla_json adapter 当前按 GFBS-Main runtime 对齐，只预览实际会生效的：

RGB tint
fullbright
visible

不会在 Blockbench 中给 vanilla JSON 虚构 runtime 尚未实现的 Neon/emissive/alpha 行为。

Indicator 会根据：

source property
→ mapping key
→ states
→ model::partAlias
→ material profile

实时决定当前 preview profile。

最终 Minecraft shader / GFBS-RP / GFBS-glTF 的光照、Bloom、Neon 结果仍以 Minecraft dev client 为准；Blockbench 预览用于 Scene authoring，不声称逐像素复刻游戏渲染器。

Interaction Simulation

选中：

interaction
button
toggle
knob
lever
slider

然后使用：

Simulate ACTIVATE
Simulate Interaction...

支持模拟：

PRESS
RELEASE
ACTIVATE
SCROLL
DRAG_START
DRAG
DRAG_END

行为按照当前 GFBS ConsoleInteractionNode 语义实现：

Toggle / Lever 的 ACTIVATE 切换 state
Lever 同步 min/max value
Knob / Slider / Lever 的 SCROLL / DRAG 更新 value
step / min / max sanitize
发射对应 signal

随后 Studio 会执行 Scene connection：

set
toggle
emit

host 和第三方 custom action 不会在 Blockbench 真执行，而会记录到 simulation log，因为真实 host action 属于 Minecraft server/runtime。

快速添加

通用 “Add Node” 默认选择 gfbs_main:model，同时提供按用途组织的快捷创建项。

菜单提供：

Add Minecraft / Vanilla Model...
Add GFBS glTF Model...
Add Text...
Add Button...
Add Toggle...
Add Knob...
Add Lever...
Add Slider...
Add Indicator...
Add Animation Driver...
Add Sound Node...
Add Timer...
Add Linear Layout...
Add Grid Layout...
Add Surface Layout...
Add Empty Node3D...
Add GFBS Console Node...

Create Starter Console Assembly 会一次生成一套已连通的控制台示例，可直接用 Preview Runtime 和 Interaction Simulation 检查 Toggle、Knob、Indicator、Text、Binding 与 Connection。

例如创建一块石头：

Add Minecraft / Vanilla Model...
Node ID: test_block
Resource: minecraft:stone

即可获得真实 Minecraft JSON 模型预览；如果找不到原版 assets，再配置 Minecraft JAR。

Scene / Node Authoring

支持当前全部内建节点：

node
node_3d
model
text
indicator
animation
sound
timer
linear_layout
grid_layout
surface_layout
interaction
button
toggle
knob
lever
slider

并支持第三方 ResourceLocation node type，以及 unknown JSON 字段 round-trip 保留。

支持：

parent / child Scene Tree
position / rotation / scale / pivot
GFBS XYZ Euler order
layout preview offset
引用安全的 node rename / subtree duplication
subtree JSON 一键复制到剪贴板
reparent（Blockbench Outliner）
Find / Select Node 路径导航

Properties / Logic

Properties

支持：

boolean
integer
long
double
string
color
vec3
resource

以及：

default
sync
save
interpolate
built-in property type conflict validation

Bindings

结构化编辑：

source / target property address
Direct
Map
Range
Format

Connections / Actions

结构化编辑：

signal source
set
toggle
emit
host
custom ResourceLocation action
typed literal value

Model Tools

Model Part Aliases
glTF node name scan
Material Profiles

Indicator Tools

source property picker
model::partAlias picker
state → profile mapping

Interaction Tools

box / aabb / obb
sphere
cylinder
plane / plane_rect
Fit Interaction Hitbox

Validation

保存前自动校验当前 GFBS format_version: 1 的主要约束：

max 4096 nodes
max depth 64
node ID 格式 / 全局唯一
ResourceLocation 字符规则
transform finite / non-zero scale
property definitions / built-in type compatibility
model source / part / material profile
indicator target/profile
animation target
hit shape / control range
sound range/speed
timer/layout
binding address/map/range/format
connection signal source
set/toggle/emit/host 参数

手工执行：

Tools → GFBS 3D-CONSOLE Studio → Validate Scene

Scene Overview / Preflight 还会把节点类型数量、Binding / Connection 数量、Preview Override、资源缺失及前 30 项校验结果合并显示，适合发布前快速扫一遍。

典型工作流

Blender / Minecraft model resources
             ↓
GFBS-Main Forge project
             ↓
Blockbench + GFBS 3D-CONSOLE Studio
             ↓
Open data/.../gfbs_console/scenes/*.json
             ↓
Render View 检查真实视觉
Authoring View 摆放 / 对齐
Interaction Debug 检查 hitbox
Preview Runtime 调状态 / 跑 Binding / Indicator
Simulate Interaction 测局部 Scene logic
             ↓
Ctrl+S
             ↓
Minecraft /reload
             ↓
GFBS-RP / GFBS-glTF / Minecraft runtime 最终验证

测试

npm test

当前自动测试覆盖：

JS syntax check
Scene parse → compile round-trip
unknown/known data preservation
validation negative cases
Preview Binding / Format evaluation
Preview override propagation
interaction ACTIVATE simulation
host action simulation logging
Vanilla model parent/texture inheritance
Forge workspace resource resolution
Minecraft JAR/ZIP entry reader
从 JAR 继承 Vanilla model geometry
Minecraft font reference provider 展开
bitmap / Unihex / legacy Unicode 字形宽度与 advance 计算
由深层 client JAR 反向解析便携启动器 asset store
完整内置默认字体 provider 链、三张 PNG 与 Unihex 档案的完整性及无 MC 安装回退
Headless Canvas 实际渲染“中文”及中英混合控制台标题，并校验宽度与非空字形像素
模拟 Blockbench 返回“合法但仅 bitmap”的 minecraft:default，验证强制 Unihex 补全后仍实际渲染中文
模拟“存在但不含中文”的残缺 Unihex provider，验证 canonical 码点直查阻断 missing-glyph 分支

预览边界

Studio 已经是视觉编辑器，但 Blockbench 仍不是 Minecraft client：

Forge BakedModel 的所有 loader/mod extension 不可能全部在 Blockbench 原生执行；Studio 实现的是标准 Minecraft Java model JSON renderer，并保留 ResourceLocation/Scene 数据。
GFBS-RP、Oculus/Embeddium、Minecraft light engine、GFBS-glTF 自定义 shader 的最终像素结果必须以 dev client 为准。
GFBS-Auralis 声音数据可以编辑，但 Studio 不启动真实 Auralis source/runtime。
host action 不在 Studio 执行真实机器逻辑。

这些边界不会把默认场景退化回 wireframe proxy；它们只决定“最终游戏渲染/服务器逻辑”仍需 Minecraft 验收。

Name		Name	Last commit message	Last commit date
dist		dist
src		src
test		test
third_party/unifont		third_party/unifont
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
THIRD_PARTY_NOTICES.md		THIRD_PARTY_NOTICES.md
package-lock.json		package-lock.json
package.json		package.json

Navigation Menu

Repository navigation

About

Repository files navigation

GFBS 3D-CONSOLE Studio 0.3.2

0.3 核心升级

运行要求

安装

打开 Scene

Visual Editor

三种 View Mode

Render

Authoring

Interaction Debug

Model Preview

GFBS glTF

Vanilla / Minecraft JSON

Minecraft 原版资源从哪里来？

Preview Runtime

Material Profile Preview

Interaction Simulation

快速添加

Scene / Node Authoring

Properties / Logic

Properties

Bindings

Connections / Actions

Model Tools

Indicator Tools

Interaction Tools

Validation

典型工作流

测试

预览边界

License

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

GFBS 3D-CONSOLE Studio 0.3.2

0.3 核心升级

运行要求

安装

打开 Scene

Visual Editor

三种 View Mode

Render

Authoring

Interaction Debug

Model Preview

GFBS glTF

Vanilla / Minecraft JSON

Minecraft 原版资源从哪里来？

Preview Runtime

Material Profile Preview

Interaction Simulation

快速添加

Scene / Node Authoring

Properties / Logic

Properties

Bindings

Connections / Actions

Model Tools

Indicator Tools

Interaction Tools

Validation

典型工作流

测试

预览边界

License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages