First Multiplayer Test #

Test your UltraGameCore setup with a complete multiplayer session.

Prerequisites #

• Unity project with UltraGameCore installed
• All configuration steps completed
• Basic understanding of Unity’s Play mode

Test Overview #

This guide will help you:

1. Test single-player functionality in the editor
2. Build and test multiplayer with multiple clients
3. Verify network synchronization
4. Troubleshoot common issues

Method 1: Editor Testing (Single Player) #

Step 1: Open Demo Scene #

1. Navigate to Assets/FastSkillTeam/UltraGameCore/Scenes/
2. Open “Online Staging (BASE ONLY).unity”
3. Wait for the scene to load completely

Step 2: Verify Scene Setup #

Check that the scene contains:

• NetworkManager object (with NetworkManager component)
• GameManager object (with GameManager script)
• Player prefabs visible in the scene
• UI Canvas with network buttons

Step 3: Test Host Mode #

1. Click the Play button in Unity
2. In the game view, you should see network buttons
3. Click “Host” button
4. You should see “Mode: Host” displayed
5. Test basic controls:
   • WASD: Move around
   • Mouse: Look around
   • Space: Jump
   • Left Ctrl: Crouch

Step 4: Test Client Mode #

1. Stop the current play session
2. Click Play again
3. Click “Client” button
4. You should see “Mode: Client” displayed
5. Test the same controls as above

Method 2: Build Testing (Multiplayer) #

Step 1: Build the Game #

1. Go to File > Build Settings
2. Ensure “Online Staging (BASE ONLY)” scene is added
3. Select your target platform (Windows/Mac/Linux)
4. Click “Build”
5. Save as “UltraGameCoreTest” in your desired location

Step 2: Test Host + Client #

1. Run the first instance (Host):
   • Launch the built executable
   • Click “Host” button
   • You should see “Mode: Host”
   • Move around to test controls
2. Run the second instance (Client):
   • Launch the built executable again
   • Click “Client” button
   • You should see “Mode: Client”
   • Both players should be visible to each other

Step 3: Test Server + Client #

1. Run the first instance (Server):
   • Launch the built executable
   • Click “Server” button
   • You should see “Mode: Server”
   • Server won’t have a visible player
2. Run the second instance (Client):
   • Launch the built executable
   • Click “Client” button
   • You should see “Mode: Client”
   • Client should be able to move around

Method 3: Command Line Testing #

Windows Command Line #

1. Open Command Prompt
2. Navigate to your build directory
3. Run commands:

# Start Server
"UltraGameCoreTest.exe" -mode server

# Start Client (in another terminal)
"UltraGameCoreTest.exe" -mode client

# Start Host (in another terminal)
"UltraGameCoreTest.exe" -mode host

Mac/Linux Terminal #

1. Open Terminal
2. Navigate to your build directory
3. Run commands:

# Start Server
./UltraGameCoreTest -mode server

# Start Client (in another terminal)
./UltraGameCoreTest -mode client

# Start Host (in another terminal)
./UltraGameCoreTest -mode host

What to Test #

Basic Movement #

• WASD: Forward, backward, left, right movement
• Mouse: Look up, down, left, right
• Space: Jump (should work on ground)
• Left Ctrl: Crouch (should lower character)

Network Synchronization #

• Player Position: Both players should see each other’s movement
• Player Rotation: Both players should see each other’s rotation
• Player Actions: Both players should see each other’s jumping/crouching

UI Elements #

• Network Status: Should display current mode (Host/Client/Server)
• Connection Status: Should show connection state
• Player Count: Should display number of connected players

Expected Results #

Successful Test #

• All controls work smoothly
• Network synchronization is smooth
• No error messages in console
• Players can see each other in multiplayer
• UI displays correct information

Common Issues #

• Input not working: Check Input System configuration
• Network connection failed: Check NetworkManager setup
• Players not visible: Check Network Prefabs List
• Build errors: Check all required packages are included

Troubleshooting #

Input Issues #

Problem: Controls not responding Solutions:

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

Network Issues #

Problem: Cannot connect to server Solutions:

1. Check NetworkManager exists in scene
2. Verify Network Prefabs List is populated
3. Check firewall settings
4. Ensure both instances are using same transport

Build Issues #

Problem: Build fails or doesn’t run Solutions:

1. Check all required packages are installed
2. Verify scene is added to Build Settings
3. Check target platform settings
4. Try building for different platform

Performance Issues #

Problem: Low FPS or lag Solutions:

1. Check Quality settings
2. Verify URP settings
3. Check network tick rate
4. Monitor console for errors

Advanced Testing #

Stress Testing #

1. Multiple Clients: Test with 3-4 clients
2. Long Sessions: Run for extended periods
3. Network Interruption: Test reconnection
4. Performance: Monitor FPS and network usage

Debug Testing #

1. Network Logs: Enable verbose logging
2. Profiler: Use Unity Profiler for performance
3. Console: Monitor for errors and warnings
4. Network Stats: Check network statistics

Next Steps #

Once testing is successful:

1. Core Systems – Learn about character controller features
2. Advanced Features – Explore abilities and inventory
3. Development – Start customizing for your game

Getting Help #

If you encounter issues:

1. Check the Troubleshooting Guide
2. Visit our Discord Community
3. Review the API Reference for technical details

---

Test complete! You now have a working multiplayer setup with UltraGameCore!