Troubleshooting #

Common issues and solutions for UltraGameCore development.

Overview #

This guide covers common issues you might encounter when developing with UltraGameCore and provides solutions to help you resolve them quickly.

Common Issues #

Installation Issues #

Unity Version Compatibility #

Problem: UltraGameCore doesn’t work with your Unity version.

Solutions:

1. Check Unity Version: Ensure you’re using Unity 6 LTS or later
2. Update Unity: Update to the latest LTS version
3. Check Package Manager: Verify all required packages are installed
4. Reimport: Try reimporting the UltraGameCore package

Package Import Errors #

Problem: Errors when importing UltraGameCore package.

Solutions:

1. Check Dependencies: Ensure all required packages are installed first
2. Clear Cache: Clear Unity’s package cache
3. Restart Unity: Restart Unity after installing dependencies
4. Manual Import: Try importing packages one by one

Missing Dependencies #

Problem: Missing required packages or dependencies.

Solutions:

1. Install Netcode: Install Netcode for GameObjects 1.5.0+
2. Install Input System: Install Input System 1.4.4+
3. Install TextMeshPro: Install TextMeshPro if needed
4. Check Package Manager: Verify all packages are properly installed

Configuration Issues #

Input System Not Working #

Problem: Input controls not responding.

Solutions:

1. Check Input Settings: Verify Input System is set to “Both”
2. Check Project-Wide Actions: Ensure InputSystem_Actions is selected
3. Check Input Actions: Verify InputSystem_Actions asset exists
4. Restart Unity: Restart Unity after configuration changes

Network Connection Issues #

Problem: Cannot connect to server or host.

Solutions:

1. Check NetworkManager: Ensure NetworkManager exists in scene
2. Check Network Prefabs: Verify Network Prefabs List is populated
3. Check Firewall: Check firewall settings
4. Check Transport: Verify transport settings

Build Issues #

Problem: Build fails or doesn’t run properly.

Solutions:

1. Check Build Settings: Verify scene is added to Build Settings
2. Check Platform: Ensure correct platform is selected
3. Check Dependencies: Verify all required packages are included
4. Check Console: Check Unity console for build errors

Performance Issues #

Low FPS #

Problem: Game runs at low frame rate.

Solutions:

1. Check Quality Settings: Lower graphics quality settings
2. Check LOD Settings: Adjust level of detail settings
3. Check Culling: Enable frustum and occlusion culling
4. Use Profiler: Use Unity Profiler to identify bottlenecks

High Memory Usage #

Problem: Game uses too much memory.

Solutions:

1. Check Object Pooling: Use object pooling for frequently created objects
2. Check Texture Size: Reduce texture sizes
3. Check LOD Models: Use appropriate LOD models
4. Check Garbage Collection: Optimize garbage collection

Network Lag #

Problem: Network performance is poor.

Solutions:

1. Check Update Rates: Optimize network update rates
2. Check Bandwidth: Monitor network bandwidth usage
3. Check Compression: Enable data compression
4. Check Latency: Check network latency

Character Controller Issues #

Movement Not Working #

Problem: Character doesn’t move or responds poorly.

Solutions:

1. Check Input System: Verify input configuration
2. Check Character Controller: Verify CharacterController component
3. Check Ground Detection: Verify ground detection setup
4. Check Physics: Check physics settings

Animation Issues #

Problem: Character animations not playing correctly.

Solutions:

1. Check Animator: Verify Animator component and controller
2. Check Animation States: Verify animation state setup
3. Check Network Sync: Verify animation synchronization
4. Check Performance: Check for performance issues

State Issues #

Problem: Character states not changing properly.

Solutions:

1. Check State Manager: Verify StateManager component
2. Check State Transitions: Verify state transition logic
3. Check Network Sync: Verify state synchronization
4. Check State Stack: Verify state stack operations

Network Issues #

Sync Problems #

Problem: Network synchronization issues.

Solutions:

1. Check Networked Properties: Verify [Networked] attributes
2. Check Update Rates: Verify network update rates
3. Check Bandwidth: Check network bandwidth usage
4. Check Latency: Check network latency

Connection Drops #

Problem: Network connections dropping frequently.

Solutions:

1. Check Network Stability: Verify network stability
2. Check Timeout Settings: Adjust connection timeout settings
3. Check Firewall: Check firewall and router settings
4. Check Transport: Verify transport configuration

Player Spawning Issues #

Problem: Players not spawning correctly.

Solutions:

1. Check Spawn Points: Verify spawn points are configured
2. Check Player Prefabs: Verify player prefabs are assigned
3. Check Network Prefabs: Verify Network Prefabs List
4. Check Spawn Logic: Verify spawn logic implementation

UI Issues #

UI Not Updating #

Problem: UI elements not updating properly.

Solutions:

1. Check UI References: Verify UI element references
2. Check Network Sync: Verify UI state synchronization
3. Check Update Logic: Verify UI update logic
4. Check Performance: Check for performance issues

UI Not Animating #

Problem: UI animations not playing.

Solutions:

1. Check Animation Settings: Verify animation settings
2. Check Animation Curves: Verify animation curves
3. Check Animation Speed: Verify animation speed
4. Check Performance: Check for performance issues

UI Layout Issues #

Problem: UI layout problems.

Solutions:

1. Check Canvas Settings: Verify Canvas settings
2. Check Layout Components: Verify layout components
3. Check Resolution: Check screen resolution settings
4. Check Scaling: Verify UI scaling settings

Debug Tools #

Unity Debugger #

Use Unity’s built-in debugging tools:

1. Console: Check for errors and warnings
2. Inspector: Inspect component properties
3. Profiler: Monitor performance
4. Debugger: Step through code

Custom Debug Tools #

Use UltraGameCore’s custom debug tools:

1. Network Inspector: Debug network issues
2. Performance Monitor: Monitor performance metrics
3. State Inspector: Inspect state information
4. UI Debugger: Debug UI issues

Third-Party Tools #

Use third-party debugging tools:

1. Visual Studio: Advanced code debugging
2. JetBrains Rider: Professional IDE
3. Git: Version control
4. GitHub: Code hosting and collaboration

Debug Steps #

Systematic Debugging #

Follow these steps for systematic debugging:

1. Identify Problem: Clearly identify the problem
2. Check Console: Check Unity console for errors
3. Use Profiler: Use Unity Profiler for performance issues
4. Test Locally: Test with local connections
5. Check Documentation: Check relevant documentation
6. Search Community: Search community forums
7. Ask for Help: Ask for help if needed

Performance Debugging #

For performance issues:

1. Use Profiler: Use Unity Profiler to identify bottlenecks
2. Check Metrics: Monitor key performance metrics
3. Optimize Code: Optimize problematic code
4. Test Changes: Test optimization changes
5. Measure Impact: Measure optimization impact

Network Debugging #

For network issues:

1. Check Network Stats: Monitor network statistics
2. Check Latency: Check network latency
3. Check Bandwidth: Check network bandwidth usage
4. Check Sync: Verify network synchronization
5. Test Locally: Test with local connections

Getting Help #

Documentation #

• API Reference: Check API documentation
• Tutorials: Follow step-by-step tutorials
• Examples: Study example code
• Best Practices: Follow best practices

Community #

• Discord: Join our Discord community
• Forums: Participate in community forums
• GitHub: Check GitHub issues and discussions
• Social Media: Follow us on social media

Professional Support #

• Consulting: Professional consulting services
• Training: Training and education
• Custom Development: Custom development services
• Technical Support: Technical support services

Prevention #

Best Practices #

Follow these best practices to prevent issues:

1. Read Documentation: Read documentation thoroughly
2. Follow Tutorials: Follow step-by-step tutorials
3. Test Regularly: Test your code regularly
4. Use Version Control: Use proper version control
5. Backup Work: Backup your work regularly

Code Quality #

Maintain high code quality:

1. Follow Standards: Follow coding standards
2. Document Code: Document your code
3. Test Code: Test your code thoroughly
4. Review Code: Review code regularly
5. Refactor Code: Refactor code when needed

Performance #

Optimize for performance:

1. Profile Regularly: Profile performance regularly
2. Optimize Early: Optimize early and often
3. Monitor Metrics: Monitor key performance metrics
4. Test Performance: Test performance regularly
5. Update Strategies: Update optimization strategies

---

Still having issues? Visit our Discord Community for additional support or check the API Reference for technical details.