🧩 Zion Stats

Zion Stats — Troubleshooting

The wizard cannot find my player

• Make sure your ZionTPS player is present in the open scene.
• Check that the player includes ZionPlayer.
• Check that the player hierarchy contains ThirdPersonBrain.
• Select the player root or a child object inside its hierarchy.

The HUD does not appear

• Confirm Create Stats HUD was enabled in the wizard.
• Check that the generated HUD object exists in the scene.
• Check that the binder targets the correct player or Stats module.
• For UI Toolkit, check that the UXML, USS and PanelSettings assets exist.
• Replace an old generated HUD if duplicate HUD objects are present.

Mana or XP bars are missing

• Select a preset that includes Mana or XP.
• Confirm the relevant values are configured in StatsConfig.
• Recreate the HUD after changing presets.
• Confirm the relevant HUD binder is enabled.

Stats do not update

• Check that a StatsConfig asset is assigned.
• Confirm the HUD is bound to the correct Stats module.
• Confirm the relevant stat is enabled by the selected preset.
• Check that runtime values are changing during Play Mode.

Stamina does not drain or recover

• Check that ZionTPS sprint input is working.
• Confirm Sprint Drain and Stamina Regeneration are greater than zero.
• Confirm the player is not sprinting while you expect regeneration.
• Allow time for the configured regeneration delay to pass.

Optional test controls do not work

• Ensure StatsHudHealthTester is attached only once.
• Assign or confirm the correct StatsModuleInstaller.
• Check that the Unity Input System is enabled.
• Click the Game view before testing keyboard input.
• Use Mana and XP controls only with presets that include those stats.

I have duplicate StatsHudHealthTester errors

Keep one copy of the helper script only:

Assets/ZionTPS.Stats/Runtime/StatsHudHealthTester.cs

Remove any duplicate copy from Assets/ZionTPS.Stats/Runtime/UI/.

UI Toolkit HUD assets are missing

Assets/ZionTPS.Stats/Runtime/UI/ZionStatsHUD.uxml
Assets/ZionTPS.Stats/Runtime/UI/ZionStatsHUD.uss
Assets/ZionTPS.Stats/Runtime/UI/ZionStatsPanelSettings.asset

Reimport the package or choose the uGUI HUD option if the UI Toolkit assets are unavailable.

UI Toolkit USS warnings appear in the Console

Reimport the updated package stylesheet if the Console reports unsupported selectors such as :last-child or incorrectly named Unity USS properties.