WorldGen Prepare Workspace

The WorldGen nodes are the pack's attempt to lift HY-World's own world-generation pipeline into ComfyUI - the workflow where a panorama becomes an explorable scene, trajectories get generated, and keyframes get rendered into video. VNCCS_WorldGenExportBankFromPLY is the first step: it takes an existing reconstruction (your ply_data + images from WorldMirror) and lays it out as a proper WorldGen workspace on disk, with the point cloud aligned, filtered, and written in the structure the downstream Generate/Render/WorldStereo nodes expect.

Think of it as "prepare the ground." It returns scene_dir (the workspace path) and an info string - those feed the rest of the WorldGen chain.

The inputs that matter

• ply_data + images (required) - your reconstruction and the views it came from.
• workspace_name (default comfy_worldgen) - the workspace folder name under root_dir.
• root_dir - base output folder. Empty means ComfyUI/output/hyworld2_worldgen. This is the one people miss; set it once and keep it consistent so later nodes find the workspace.
• panorama (optional) - the source panorama for the same scene. The tooltip spells out the payoff: "When connected, this workspace can continue through Generate/Render/WorldStereo." Without it, the workspace stops at what you already have.
• scene_type - unknown / indoor / outdoor. Cheap signal that helps the pipeline pick sensible behavior.
• bank_name (default comfy-worldmirror) - suffix for the generation bank folder. The tooltip notes official runs use worldstereo-memory-dmd.
• global_max_points (default 3M) and aligned_max_points (default 2M) - point budgets for the global and ICP-aligned point clouds. Lower them if the workspace gets unwieldy; the alignment pass is where big scenes get slow.
• write_aligned_from_filtered (default true) - whether to also write the aligned cloud derived from the filtered one.

Why this structure exists

WorldGen is the closest thing in this pack to Tencent's full "make me a set" pitch - and the KB's framing applies: this is scene/world generation where the splat is the deliverable, not a mesh. The workspace layout (aligned clouds, generation bank) is what lets the later nodes keep consistent geometry across generated frames. If you're only doing single-image reconstruction, you don't need this. If you want an explorable, video-extended world, this is where it starts.

Gotchas

• The workspace_dir it produces is consumed by VNCCS_WorldGenBuildGSDataFromWorldMirror - feed the returned scene_dir string in there, don't retype the path.
• Deep scene point clouds make the alignment pass slow and the disk footprint big; trim global_max_points if you're iterating.
• This family pulls in cupy-cuda13x and friends from requirements - a CUDA-version-specific dependency, so if the pack installed cleanly but WorldGen nodes fail on import, cupy is the suspect.

Install

Pack standard - Manager → HY-World 2.0, or:

cd ComfyUI/custom_nodes
git clone https://github.com/AHEKOT/ComfyUI_HYWorld2
cd ComfyUI_HYWorld2
pip install -r requirements.txt
python install.py