MonoGame.Samples/StencilsCratersTutorial

StencilCraters

A cross-platform MonoGame 3.8.* sample demonstrating stencil buffer craters on a planet surface. Supports Windows, DesktopGL, Android, and iOS using .NET 8.0 SDK-style projects.

Project Structure

• Core/ — Shared game logic (Game1.cs), cross-platform code, and assets
• Core/Content/ — Game content (textures, icons, etc.)
• Platforms/Windows/ — Windows-specific entry point and project (StencilCraters.Windows.csproj)
• Platforms/DesktopGL/ — DesktopGL-specific entry point and project (StencilCraters.DesktopGL.csproj)
• Platforms/Android/ — Android entry point, project, and manifest (StencilCraters.Android.csproj)
• Platforms/iOS/ — iOS entry point, project, and Info.plist (StencilCraters.iOS.csproj)
• Documentation/ — Tutorials, images, and technical docs

Building and Running

Prerequisites

• .NET 8.0 SDK or later
• Visual Studio 2022+ or VSCode (with C# Dev Kit recommended)
• For Android/iOS: Xamarin/MAUI workload and platform SDKs

Windows & DesktopGL

• Open StencilsCraters.sln in Visual Studio, or use VSCode tasks/launch.
• Build and run either the Windows or DesktopGL project.

Android

• Open solution in Visual Studio (Windows or Mac) with Android workload.
• Build and deploy StencilCraters.Android to an emulator or device.

iOS

• Open solution in Visual Studio for Mac with iOS workload.
• Build and deploy StencilCraters.iOS to a simulator or device.

Notes

• All platform projects reference the shared Core project.
• Content is loaded directly from .xnb files in the Core/Content/ directory.
• No Content.mgcb file is required.

Documentation

• See Documentation/Stencil Buffer Craters.md for a detailed tutorial on stencil buffer craters and GPU texture modification.

Additional images and reference material are in the Documentation/ folder.