Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > ComfyUI-SplatKit-World > Scene Reference at MoGe level (SplatKit World)

ComfyUI Node: Scene Reference at MoGe level (SplatKit World)

Class Name

SplatKitWorld_SceneReference

Category
SplatKit/World
Author
mickmumpitz (Account age: 476days)
Extension
ComfyUI-SplatKit-World
Latest Updated
2026-11-05
Github Stars
0.04K

How to Install ComfyUI-SplatKit-World

Install this extension via the ComfyUI Manager by searching for ComfyUI-SplatKit-World
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI-SplatKit-World in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

Scene Reference at MoGe level (SplatKit World) Description

Builds a scene-reference point cloud from a panorama with a selectable MoGe detail level.

Scene Reference at MoGe level (SplatKit World):

SplatKitWorld_SceneReference builds a scene-reference point cloud from a panorama using SplatKit’s MoGe-based geometry processing. A point cloud is a collection of points that describes the scene’s estimated 3D shape, helping you understand where surfaces lie when planning camera movement. This node’s main purpose is to let SplatKit World build that reference at an explicitly chosen MoGe detail level, rather than relying on an environment default. Matching this level to the geometry used by the Plot Camera nodes is important: otherwise, the editor’s reference and the rendered scene can differ in depth scale, so a camera path that appears safe in the editor may leave the actual geometry. The node delegates scene-reference creation to SplatKit’s own builder, keeping the reference compatible with SplatKit World without requiring changes to ComfyUI’s environment settings. It is a geometry-preparation helper, not a Gaussian-splat renderer or mesh-export node, and requires ComfyUI-SplatKit version 1.1.4 or newer to be loaded.

Scene Reference at MoGe level (SplatKit World) Input Parameters:

panorama

Required input of type IMAGE containing the panorama from which SplatKit will build the scene reference. The panorama supplies the visual scene used for MoGe-based geometry estimation, so you should use the same panorama that belongs to your subsequent camera-planning and rendering workflow. The node passes only the first image in the supplied image batch to the builder; additional images in that batch are not processed. No default image, numeric limits, or resolution requirements are specified in this node’s interface.

ref_name

Required STRING that names the scene reference, with a default value of default. This name is passed to SplatKit’s scene-reference builder and appears in the completion message, making it useful for identifying which scene was built. SplatKit World also uses the reference name when requesting the cached scene points for its editor. Choose a recognizable name for each scene and keep it consistent wherever that reference is retrieved. The node does not declare a list of allowed names, a length limit, or other text restrictions; naming and storage behavior beyond this call are handled by SplatKit.

point_budget

Required INT controlling the point budget supplied to the scene-reference builder. The default is 40000, the minimum is 500, the maximum is 40000, and the interface step is 500. This setting controls the requested amount of point-cloud detail rather than the MoGe reconstruction level: a larger budget allows a denser reference for inspecting scene surfaces, while a smaller budget limits the number of points available to represent them. SplatKit World uses 40000 specifically for a denser editor cloud. Treat this value as a budget rather than a guarantee that exactly that many points will be generated; the completion message reports the count returned by the builder.

moge_level

Required INT selecting the explicit MoGe level used to build the scene reference. The default is 9, the minimum is 0, and the maximum is 9. The interface tooltip instructs you to use the Plot Camera nodes’ moge_level. This is the key compatibility setting: the reference cloud must be built at the same level as the mesh used for camera-control rendering so that the editor and rendered geometry agree. Do not assume the default of 9 matches your workflow; inspect the relevant Plot Camera settings and copy their value. The node does not define named presets or document a precise quality or processing-time relationship for each level, so matching the rendering geometry is the primary selection rule.

Scene Reference at MoGe level (SplatKit World) Output Parameters:

status

A STRING reporting the result returned by SplatKit’s scene-reference builder. Its format is scene ref 'NAME': COUNT pts at MoGe level LEVEL -> PATH, where the fields identify the reference name, the reported point count, the selected MoGe level, and the path returned by the builder. Use this message to confirm that the intended reference was generated and to check its reported size and location. This output is informational text, not the point cloud, a mesh, an image, or a Gaussian-splat object. The scene reference is written or cached by SplatKit as part of execution; SplatKit World subsequently retrieves scene points by reference name rather than receiving them through this output socket.

Scene Reference at MoGe level (SplatKit World) Usage Tips:

  • Match moge_level to the Plot Camera nodes that render your control geometry. For example, if those nodes use level 6, set this node to 6 rather than leaving its default of 9. - Use the same panorama for reference creation and the associated camera-rendering workflow. A matching MoGe level cannot compensate for using a reference built from a different scene.
  • Start with point_budget set to 40000 when you need a dense editor reference, matching SplatKit World’s configuration. If you want a lighter reference, try a smaller allowed budget and check whether important surfaces remain clear enough for camera planning.
  • Change point_budget to adjust reference density, not to correct geometry alignment. If camera paths appear safe in the editor but fail against the rendered geometry, check moge_level first.
  • Supply a single panorama whenever possible. If you connect an image batch, only its first image is used; use separate executions to create references for different panoramas.
  • Give separate scenes recognizable ref_name values and use the corresponding name when retrieving their cached points. This makes it easier to verify that the editor is displaying the intended reference.
  • Rebuild the reference after changing the panorama or the MoGe level used by your rendering geometry. Check the returned status to confirm the name, level, and reported point count before planning camera movement.

Scene Reference at MoGe level (SplatKit World) Common Errors and Solutions:

ComfyUI-SplatKit (1.1.4 or newer) is not loaded - install it and restart ComfyUI

  • Explanation: This is the explicit error raised when the helper cannot find a loaded SplatKit module containing the expected scene-reference builder and scene-reference class. Installing SplatKit World alone does not provide that underlying builder.
  • Solution: Install or update ComfyUI-SplatKit to version 1.1.4 or newer, restart ComfyUI, and check the startup log for any SplatKit import failures. Resolve those failures before running this node again.

MoGe produced no scene geometry

  • Explanation: This exact message comes from the surrounding SplatKit World pipeline, not directly from this node. It means the pipeline requested the cached scene points after reference generation but received no usable points.
  • Solution: Confirm that the panorama loads correctly, check the node’s reported point count, and verify that the requested reference name matches ref_name. Rebuild the reference and inspect the ComfyUI log for an earlier error from SplatKit’s geometry processing if the problem persists.

Scene Reference at MoGe level (SplatKit World) is unavailable or reported as an unknown node type

  • Explanation: This describes a node-loading problem rather than an exact error string defined by this class. ComfyUI has not registered the helper node, which belongs to ComfyUI-SplatKit-World.
  • Solution: Verify that ComfyUI-SplatKit-World is installed in the custom nodes directory, restart ComfyUI, and inspect its startup log for import errors. Also install the separate ComfyUI-SplatKit dependency required to execute the node.

Input validation fails for point_budget or moge_level

  • Explanation: Exact validation wording depends on ComfyUI. The declared interface requires integer values, with point_budget between 500 and 40000 and moge_level between 0 and 9; incompatible input types or values outside those limits can prevent execution.
  • Solution: Enter valid integers within the declared ranges. Use the interface’s 500-point increments for point_budget, and set moge_level to the valid level used by your Plot Camera nodes. If you submit workflows through an API, check the submitted values as well as the visible workflow settings.

Camera paths look safe in the editor but leave the rendered geometry

  • Explanation: This is a workflow symptom, not a literal exception. The supplied context identifies mismatched MoGe levels between the editor’s scene reference and the Plot Camera rendering mesh as a cause, because their depth scales can differ.
  • Solution: Set this node’s moge_level to the same value as the relevant Plot Camera nodes, rebuild the reference, and reload or retrieve the updated editor geometry. Also confirm that both stages use the same panorama and that the editor requests the correct reference name.

The reference was built from the wrong image in a batch

  • Explanation: This is expected behavior rather than a runtime error. The node selects only the first panorama in the input batch, so it will not automatically choose another image or build one reference per image.
  • Solution: Select the intended panorama before connecting it to this node, or process each panorama separately with its own reference name.

Scene Reference at MoGe level (SplatKit World) Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI-SplatKit-World
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

Scene Reference at MoGe level (SplatKit World)