Documentation Index
Fetch the complete documentation index at: https://docs.lightcraft.pro/llms.txt
Use this file to discover all available pages before exploring further.
Camera or asset moves break on playback
You forgot to toggle Keyframes on for the asset or camera before moving it. The interface does not warn you. Select the object, enable Keyframes in the asset settings panel, then redo the move.
Composited actor looks giant or doll-sized
The splat scale is wrong. Return to the Location Settings panel, drop in the six-foot reference figure, and rescale. Every camera distance and composited element downstream depends on correct scale.
Teammate sees a different script version
You did not publish the latest version. Open the version sidebar and click Publish on the version you want everyone working from.
Teammate cannot see your environment
You used Load Locally instead of Upload when importing the location file. Load Locally keeps the file on your machine for the current session only — collaborators opening the same scene will not see it. Re-import with Upload so the file writes to the production library.
Scene loads in Spark Story but fails on iPhone or iPad
Your splat exceeds the roughly 5 million splat cap on Lightcraft Spark for iPhone or iPad. Downsample the splat for the phone and keep the full-resolution version for the browser and Jetset.
Pre-animated USD sits frozen on iPhone or iPad playback
You dropped the animation clip on the timeline but did not toggle Keyframes on for that object. Spark Story may render it correctly in the browser while the iOS app does not.
Lightning bolt does not engage
Tap it again. The handshake between Lightcraft Spark and Spark Story occasionally needs a second attempt.
Driving across a large scene is slow
Drop scene locators at every action point and jump between them instead of flying. See arranging objects for creating locators in the browser, or add them directly in Lightcraft Spark.
Splat chokes the browser
If a splat exceeds roughly 7 GB, keep a downsampled version for previs and reserve the full-resolution version for Jetset on set.
Download the MP4 from the shot list. AI video tools like Seedance produce cleaner output from a real Spark Story shot than from a text prompt, because the camera move is already locked and consistent.
Keying needs green screen or blue screen
Lightcraft Spark compositing is AI matting only. Route through Jetset for green-screen or blue-screen keying workflows.
