Reduce a problem to one saved scene connection, one start action and a known supplied design. Add media, overrides and stages back one group at a time.
Setup and appearance#
| Problem | What to check |
|---|---|
| Tools menu missing | Resolve compilation errors and preserve the package folder/Editor assembly. |
| Text missing or pink | TMP Essential Resources, font/material/shader references and glyph coverage. |
| Theme change has no effect | Use Theme Font/Color and explicit local overrides. |
| Gradient too dark | Gradient multiplies base tint. Start with white for direct gradient colors. |
| Bar end caps stretch | Nine-slice sprite borders, source size and filtering. |
| Phone composition clips | Aspect range, active profile, safe area, anchors and long-text bounds. |
| Rotation keeps old arrangement | Profiles are selected at request start. Stabilize orientation during the flow. |
| Custom prefab static in Designer | Prefab scripts do not run in the authoring canvas. Test runtime. |
| Missing design in scene table | Choose a valid LoadingLayout or remove the obsolete mapping. |
| Wrong design at runtime | Explicit API override, saved destination connection, then fallback. |
| Exported panel differs | Native edits stay in the baked hierarchy. BeginLoading uses saved Builder data. |
Copy affected designs before broad edits. Restore disk backups with matching .meta files to keep GUIDs. Save scenes/prefabs as well as Builder data.
Loading and readiness#
| Problem | What to check |
|---|---|
| Button does nothing | Assign Scene object in no-code setup, or wire the script method. A connection alone does not start. |
| Scene unavailable / wrong index | Save and enable in the active build list. Use path/index for duplicate names. |
| Progress stuck / Game Ready timeout | Stage ID, phase, dependencies, matching task/signal and timeout. Do not await destination objects before activation. |
| Initializer never completes | Keep outside held GameplayGate targets and avoid scaled waits while time is paused. |
| Manual progress 100%, flow remains | Complete real work or the required checkpoint. Visual reporting does not finish operations. |
| Busy request immediately fails | Reject is default. Choose Queue deliberately or prevent duplicate start actions. |
| Per-scene Post override ignored | Use LoadScene/CreateSceneRequest. Current LoadingTrigger uses design-level post settings. |
| Cancel does not restore old scene | Single activation is irreversible. Use a deliberate safe-menu recovery path. |
Input, video and sound#
| Problem | What to check |
|---|---|
| Continue / Skip ignored | Active gate, input filter, countdown lock and fresh Pressed versus Held callbacks. |
| Video remains on poster | Clip/decoder, Reduced Motion, prepare timeout and foreground/target-player playback. |
| Video/countdown silent | Their own audio options, assigned/imported clips, session Master/SFX and mute. |
| Track named Ambience uses Music level | Name does not route audio. Change Channel to Ambience. |
Report a reproducible issue#
Include the package revision, Unity version, target platform, minimal scene/design setup, expected and actual behavior, and Console output. Keep the request handle and inspect State/Error and lifecycle milestones. Editor simulation alone cannot establish native loading or video behavior.