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.
CatapultNetWars	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
2DShaderSample	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.
CatapultWars	Classic catapult game mechanics.
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.
ParticleSample	Particle systems and effects.
Primitives	Drawing primitive shapes (lines, points).
RectangleCollisionSample	Rectangle collision detection.
RenderTarget2DSample	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.
BloomSample	Bloom post-processing effects.
Colored3DCube	Renders a colored 3D cube.
Graphics3DSample	Advanced 3D graphics techniques.
LensFlare	Lens flare post-processing effects.
ReachGraphicsDemo	Demonstrates Reach profile graphics features.
ShadowMapping	Demonstrates shadow mapping techniques in 3D.
ShatterEffectSample	3D shatter effect demonstration.

---

Networking Samples

Project	Description
CatapultNetWars	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. (NOT working yet)
NetworkStateManagment	The project template for most of the networked games in this repo, that use a Lobby. Works on LAN
Peer2PeerSample	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.
SamplesContentBuilder	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.