🎮 Zion Console Menu

Troubleshooting

Menu Does Not Open

• Confirm the relevant UIDocument is active.
• Check that the UIDocument references the correct UXML asset.
• Confirm all menu screens use the expected Panel Settings.
• Run Full Validation in the Setup Wizard.

Virtual Cursor Appears Behind a Menu or Dialog

Set the virtual cursor UIDocument sort order to:

100

Confirmation Dialog Appears Behind a Menu

• Set the Confirmation Dialog UIDocument sort order to 90.
• Confirm the dialog and all package UIDocuments use the same Panel Settings asset.
• Keep the virtual cursor above the dialog at sort order 100.

Dialog Does Not Block the Underlying Menu

Confirm the current Version 1.1.0 Confirmation Dialog and menu scripts are in use. The modal should block underlying controls, close itself on B or Escape and restore focus without popping the menu history.

Input Prompt Blocks Buttons

• Set the prompt overlay Picking Mode to Ignore.
• Use a sort order below the virtual cursor.
• The recommended prompt sort order is 50.

Controller Navigation Does Not Work

• Confirm the New Input System package is installed.
• Confirm Active Input Handling uses the New Input System.
• Check that UI/Navigate, UI/Submit and UI/Cancel exist.
• Confirm the EventSystem uses InputSystemUIInputModule.
• Run the Setup Wizard diagnostics.

Rebinding Changes Do Not Affect the Live UI

Confirm ZionInputRebindService and InputSystemUIInputModule reference the same physical Input Action Asset.

Rebinding Does Not Persist

• Confirm the rebind service loads saved overrides at startup.
• Check PlayerPrefs for the binding override data.
• Ensure Reset All is not being called during initialisation.

Display Controls Do Not Appear

Confirm the Settings UIDocument references the UXML containing:

• displayModeDropdown
• resolutionDropdown
• vSyncToggle

Resolution or Fullscreen Does Not Behave Correctly

Test the display controls in a standalone build. The Unity Editor does not reproduce all desktop display behaviour accurately.

Audio Sliders Do Not Change the Mixer

• Confirm the AudioMixer is assigned.
• Confirm the expected mixer parameters are exposed.
• Check the parameter names in the Inspector.
• Confirm Music and SFX AudioSources use the expected mixer groups.

Pause Menu Opens but Gameplay Continues

• Confirm the Pause action reaches ZionMenuManager.
• Check whether another system immediately resets time scale.
• Confirm the menu is not configured as a visual overlay only.

Settings Opened from Pause Return to Main Menu

Confirm navigation occurs through ZionMenuManager so it can preserve the correct screen history and pause session.

Save or Load Opens with No Slot Data

• Check Provider Source on both SaveMenu and LoadMenu.
• Confirm the assigned component implements IZionSaveSlotProvider.
• Use Generate Missing Setup to create the demo provider for testing, or assign your production provider manually.
• Run Full Validation and resolve the missing-provider diagnostic.

Load or Delete Is Available on an Empty Slot

Ensure HasData is false and return false from CanLoad and CanDelete for that slot, then refresh the menu.

Save, Load or Delete Fails

• Confirm the provider operation completes exactly once.
• Return a clear success or failure ZionSaveOperationResult.
• Keep the menu usable after failure instead of leaving its controls disabled.
• For Load, coordinate scene readiness before applying restored gameplay data.

Continue Does Not Update After Save or Delete

Raise the Continue provider's availability-change notification or call the established RefreshContinueState() path after the operation completes.

Diagnostics Warns About the Demo Save Provider

This warning is expected when Demo Save Provider (Demo Only) is assigned. The provider is suitable for the three test slots only; replace it with your own production IZionSaveSlotProvider implementation before release.

Continue Is Always Disabled

• Confirm a Continue availability provider is assigned.
• Confirm the provider reports valid save data.
• Call RefreshContinueState after the save state changes.

Quit Does Nothing in the Unity Editor

Confirm the current Main Menu and Pause Menu screen scripts are being used. In the Editor, Quit should stop Play Mode. In a standalone build, it should call Application.Quit.

Requesting Support

Include the following information:

• Unity version
• Zion Console Menu version
• Exact reproduction steps
• Console errors and warnings
• Copied Setup Wizard diagnostic report
• Screenshots of the relevant Inspector configuration