🎮 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

Set the virtual cursor UIDocument sort order to:

100

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.

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