🎯 ZionTPS

Troubleshooting

This page covers the most common setup and integration issues when using ZionTPS.

Input does not work

• Input System package is installed
• Active Input Handling is set to Input System Package (New) or Both
• Unity restarted after the setting change
• input actions are assigned correctly

Character does not move

• required ZionTPS components are attached
• the player object is enabled
• a valid ground surface exists
• collisions are not blocked by incorrect layer setup

Camera does not follow correctly

• camera target references are assigned
• follow target exists in the scene
• required rig objects are present
• no other camera controller is taking control

Namespace or assembly errors

• your custom .asmdef references ZionGames.ZionTPS.Runtime
• the package finished importing
• Unity has finished recompiling
• there are no duplicate script definitions in the project

Integration Feels Messy

• keep ZionTPS core untouched where possible
• layer custom systems on top through separate components
• isolate combat, stats, and UI into modules
• use the demo or minimal scene as your baseline reference