MonoGame.Samples

MonoGame Samples

This repository contains a collection of cross-platform MonoGame samples and game projects that should compile on Windows, macOS, Linux, iOS and Android. Each sample demonstrates different game development concepts, features, or genres. For detailed information about each sample, see the linked README in each sub-directory.

---

How to Contribute

I welcome contributions to the MonoGame Samples repository! Here's how you can get involved:

1. Report Issues: If you find a bug or have a suggestion, please open an issue in the repository.
2. Submit Pull Requests: Fork the repository, fix bugs and modernise the samples, and submit a pull request. Be sure to follow the coding standards and include detailed descriptions of your changes or enhancements.
3. Improve Documentation: Help me improve the documentation by editing or adding to the README files.
4. Share Your Samples: If you have a MonoGame sample you'd like to share, feel free to contribute it to the repository. Alternatively help port the older XNA samples, so we have a centralised resource for all MonoGame game developers.
5. Donate to the MonoGame Foundation: If these samples have helped you create your game, release it and your made some money off it it, conside donating to the MonoGame Foundation, so we can continue to keep it FREE for everyone else to have a hit game with :)

---

Quick Links

• Game Samples
• 2D Samples
• 3D Samples
• Networking Samples
• Miscellaneous Samples

---

Game Samples

Project	Description
AsteroidBeltAssault
Cards Starter Kit	Card framework showing how to implement a Blackjack game.
FloodControl
HoneycombRush	Arcade-style honeycomb collection game.
CatapultWars	Single Player and Networked multiplayer catapult game. Works on LAN
PacMan	Cross-platform Pac-Man clone.
RobotRampage
RockRain	Arcade-style falling rocks game.
RolePlayingGame	RPG sample with tile engine and menus.
StarWarrior	Classic space shooter sample.

---

2D Samples

Project	Description
Shaders2D	Custom 2D shader effects in MonoGame.
Aiming	Aiming mechanics and input handling.
BouncingBox	Simple physics sample with bouncing boxes.
Cards Starter Kit	Card framework showing how to implement a Blackjack game.
ChaseAndEvade	AI sample showing chase and evade behaviors.
CollisionSample	Collision detection techniques.
Draw2D	Basic 2D drawing and sprite rendering.
FarseerPhysics	Physics engine integration sample.
Flocking	Flocking AI behaviors.
GameDevelopmentbyExample	4 2D samples from the "XNA Game Development by Example" book. Namely: AsteroidBeltAssault, FloodControl, GemstoneHunter, RobotRampage
GameStateManagement	Sample for managing game states and screens.
GooCursor	Custom cursor rendering and effects.
HoneycombRush	Arcade-style honeycomb collection game.
Input	Input handling for keyboard, mouse, and gamepad.
InputReporter	Displays live input values for controllers.
MultiTouch	Multi-touch input support.
PacMan	Cross-platform Pac-Man clone.
Particle2D	Particle systems and effects.
Primitives	Drawing primitive shapes (lines, points).
RectangleCollision	Rectangle collision detection.
RenderTarget2D	Render-to-texture techniques.
RockRain	Arcade-style falling rocks game.
RolePlayingGame	RPG sample with tile engine and menus.
StarWarrior	Classic space shooter sample.
TouchGesture	Touch gesture and mouse support.
Waypoint	AI navigation and waypoint sample.

---

3D Samples

Project	Description
Audio3D	3D audio positioning and effects.
BloomEffect	Bloom post-processing effects.
Colored3DCube	Renders a colored 3D cube.
Graphics3D	Advanced 3D graphics techniques.
LensFlare	Lens flare post-processing effects.
ReachGraphicsDemo	Demonstrates Reach profile graphics features.
ShadowMapping	Demonstrates shadow mapping techniques in 3D.
ShatterEffect	3D shatter effect demonstration.

---

Networking Samples

Project	Description
CatapultNetWars	Single Player and Networked multiplayer catapult game. Works on LAN
MonoGame.Xna.Framework.Net	Networking API compatibility sample. Partially implemented for Peer 2 Peer, LAN games
NetRumble	Networked multiplayer space shooter. (NOT working yet)
NetworkPrediction	Networked gameplay prediction and synchronization. Works on LAN
NetworkStateManagment	The project template for most of the networked games in this repo, that use a Lobby. Works on LAN
Peer2Peer	Peer-to-peer multiplayer tank demo. Works on LAN

---

Miscellaneous Samples

Project	Description
AdMob	Integrate AdMob ads into a MonoGame project.
BackgroundThreadTester	Using background threads in game logic.
BatteryStatus	Battery status and power management.
CompiledContent	Pre-built content files for other samples.
GameComponents	Using and managing game components.
ContentBuilder	Build and load content assets using MonoGame's content pipeline.
Sound	Cross-platform sound playback.

---

For platform-specific details, build instructions, and troubleshooting, see each sample's README.