Skip to content

Latest commit

 

History

History
168 lines (122 loc) · 5.4 KB

README.md

File metadata and controls

168 lines (122 loc) · 5.4 KB

NetworkPrediction - MonoGame Sample

A MonoGame sample demonstrating network prediction and smoothing techniques to compensate for network latency and low packet send rates.

Project Overview

This sample shows how to use prediction and smoothing to compensate for the effects of network latency, and for the low packet send rates needed to conserve network bandwidth. The project has been modernized to use:

  • .NET 8.0 SDK-style projects
  • MonoGame 3.8.* NuGet packages
  • NetRumble MonoGame.Xna.Framework.Net library for full XNA 4.0 networking compatibility

Platform Support

The project includes support for multiple platforms, each with its own folder and entry point:

  • Windows (Platforms/Windows/NetworkPrediction.Windows.csproj, Program.cs) - Uses DirectX backend
  • DesktopGL (Platforms/Desktop/NetworkPrediction.DesktopGL.csproj, Program.cs) - Cross-platform OpenGL backend
  • Android (Platforms/Android/NetworkPrediction.Android.csproj, Program.cs) - Android mobile platform
  • iOS (Platforms/iOS/NetworkPrediction.iOS.csproj, Program.cs) - iOS mobile platform

All platform projects reference the shared core logic in Core/NetworkPrediction.Core.csproj.

Folder Structure:

NetworkPrediction.sln
README.md
Core/
    NetworkPrediction.Core.csproj
    NetworkPredictionGame.cs
    RollingAverage.cs
    Tank.cs
    Content/
Platforms/
    Windows/
        NetworkPrediction.Windows.csproj
        Program.cs
    Desktop/
        NetworkPrediction.DesktopGL.csproj
        Program.cs
    Android/
        NetworkPrediction.Android.csproj
        Program.cs
    iOS/
        NetworkPrediction.iOS.csproj
        Program.cs

Current Status

✅ Completed:

  • Modernized all project files to SDK-style format
  • Updated to use MonoGame 3.8.* NuGet packages
  • Integrated NetRumble MonoGame.Xna.Framework.Net for full XNA 4.0 networking compatibility
  • Consolidated all XNA networking APIs - no code duplication
  • Created VS Code tasks and launch configurations
  • Removed obsolete macOS project (no longer supported in MonoGame 3.8.*)
  • Updated solution file with new project structure
  • Fixed all critical build errors and platform compatibility issues
  • All platforms build successfully (Windows, DesktopGL, Android, iOS)

✅ XNA 4.0 API Compatibility:

  • Full Microsoft.Xna.Framework.GamerServices support (SignedInGamer, Guide, etc.)
  • Full Microsoft.Xna.Framework.Net support (NetworkSession, NetworkGamer, PacketReader/Writer, etc.)
  • All networking APIs match XNA 4.0 specifications
  • Shared implementation eliminates duplicate code

⚠️ Minor Notes:

  • Content pipeline warnings (no .mgcb file, using prebuilt .xnb files - this is intentional)
  • iOS platform compatibility warnings (CA1416 - informational only, builds successfully)
  • Game.Exit() disabled on iOS per platform policy

Building the Project

Prerequisites

  • .NET 8.0 SDK or later
  • Visual Studio 2022 or VS Code with C# extension

Command Line Build

# Build Windows version
dotnet build NetworkPrediction.Windows.csproj

# Build DesktopGL version
dotnet build NetworkPrediction.DesktopGL.csproj

# Build Android version
dotnet build NetworkPrediction.Android.csproj

# Build iOS version
dotnet build NetworkPrediction.iOS.csproj

# Build all projects
dotnet build NetworkPrediction.sln

Visual Studio

Open NetworkPrediction.sln in Visual Studio and build the solution.

VS Code

Use the Command Palette (Ctrl+Shift+P) and run:

  • Tasks: Run Task → build-windows or build-desktopgl
  • Debug: Start Debugging → Choose "Launch Windows" or "Launch DesktopGL"

Running the Project

Windows

dotnet run --project NetworkPrediction.Windows.csproj

DesktopGL (Cross-platform)

dotnet run --project NetworkPrediction.DesktopGL.csproj

Android & iOS

Use platform-specific deployment tools (Android Studio, Xcode) or dotnet publish commands for mobile platforms.

Content

The project uses pre-built XNB content files located in the Content/ directory:

  • Font.xnb - Sprite font for UI text
  • Tank.xnb - Tank sprite texture
  • Turret.xnb - Turret sprite texture

Controls

  • Arrow Keys / WASD - Move tank
  • Mouse / Right Stick - Aim turret
  • A - Create network session
  • B - Join network session
  • Escape - Exit game

Networking

The project uses the NetRumble MonoGame.Xna.Framework.Net library which provides a fully compatible implementation of the Microsoft.Xna.Framework.Net and Microsoft.Xna.Framework.GamerServices namespaces. This shared implementation:

  • Maintains full XNA 4.0 API compatibility
  • Eliminates code duplication across projects
  • Provides all required networking classes (NetworkSession, NetworkGamer, PacketReader/Writer, etc.)
  • Includes gamer services functionality (SignedInGamer, Guide, etc.)

Architecture

The project follows a consolidated architecture:

  • NetworkPrediction - Main game sample (this project)
  • NetRumble\MonoGame.Xna.Framework.Net - Shared XNA 4.0 networking implementation
  • No duplicate networking code between projects

Contributing

To contribute to this project:

  1. Test networking functionality in real multiplayer scenarios
  2. Add additional platform-specific optimizations
  3. Enhance the prediction algorithms
  4. Add more comprehensive error handling

License

This project is based on the original Microsoft XNA Community Game Platform samples and follows the same licensing terms.