Skip to content

Updated samples page #149

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jun 21, 2025
Merged

Updated samples page #149

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
fee4d09
Add samples section to main docs links
SimonDarksideJ Jun 21, 2025
48cedb7
Updated samples page
SimonDarksideJ Jun 21, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
179 changes: 162 additions & 17 deletions articles/samples.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,28 +1,173 @@
---
title: Samples & Demos
description: Recommended samples and demos for learning how to use MonoGame.
description: The recommended samples and demos for learning how to use MonoGame.
---

The samples and demos below are recommended for learning how to use MonoGame.

## Official MonoGame tutorial source

- [Building 2D Games](https://github.com/MonoGame/MonoGame.Samples/tree/3.8.4/Tutorials/learn-monogame-2d)

## Official MonoGame Samples

These are [the official samples](https://github.com/MonoGame/MonoGame.Samples) that contain the following:
These are [the official samples](https://github.com/MonoGame/MonoGame.Samples):

## 2D Samples

<section class="container-xxl mb-5">
<div class="row">
<div class="col-12 col-lg-4 mb-5">
<div class="mg-card mg-box-shadow h-100">
<a target="_self"
href="https://github.com/MonoGame/MonoGame.Samples/tree/3.8.4/AutoPong"
class="mg-no-link">
<div class="mg-card-body d-flex flex-column h-100">
<div class="mg-card-title"><i class="bi bi-arrow-bar-right"></i> AutoPong Sample 2D</div>
<p>
This project shows you how to make the classic game of pong, with basic soundfx, in 300 lines of code.
The sample has no content and no content manager use, just code!
</p>
<p class="mt-auto">Check out the AutoPong sample</p>
</div>
</a>
</div>
</div>
<div class="col-12 col-lg-4 mb-5">
<div class="mg-card mg-box-shadow h-100">
<a target="_self"
href="https://github.com/MonoGame/MonoGame.Samples/tree/3.8.4/Platformer2D"
class="mg-no-link">
<div class="mg-card-body d-flex flex-column h-100">
<div class="mg-card-title"><i class="bi bi-body-text"></i> Platformer Sample 2D</div>
<p>
The Platformer Starter Kit is a near-complete, self-contained game solution that includes both game code and game assets. The game is a standard 2D platformer with levels, enemies, and collectable gems.
\nThis sample is also available as a full cross-platform project template `mg2dstartkit`.
</p>
<p class="mt-auto">Check out the Platformer sample</p>
</div>
</a>
</div>
</div>
<div class="col-12 col-lg-4 mb-5">
<div class="mg-card mg-box-shadow h-100">
<a target="_self"
href="https://github.com/MonoGame/MonoGame.Samples/tree/3.8.4/NeonShooter"
class="mg-no-link">
<div class="mg-card-body d-flex flex-column h-100">
<div class="mg-card-title"><i class="bi bi-battery-charging"></i> NeonShooter Sample 2D</div>
<p>
This project shows you how to make a Geometry Wars-inspired twin-stick shooter, with neon graphics, crazy particle effects, and awesome music.
</p>
<p class="mt-auto">Check out the NeonShooter sample</p>
</div>
</a>
</div>
</div>
</div>
</section>

## 3D Samples

<section class="container-xxl mb-5">
<div class="row">
<div class="col-12 col-lg-4 mb-5">
<div class="mg-card mg-box-shadow h-100">
<a target="_self"
href="https://github.com/MonoGame/MonoGame.Samples/tree/3.8.4/FuelCell"
class="mg-no-link">
<div class="mg-card-body d-flex flex-column h-100">
<div class="mg-card-title"><i class="bi bi-bandaid-fill"></i> FuelCell Sample 3D</div>
<p>
FuelCell is designed around a central concept providing basic gameplay mechanisms that are easily extensible. The FUelCell sample also includes a complete developer diary documenting its construction.
</p>
<p class="mt-auto">Click to view 3D FuelCell sample</p>
</div>
</a>
</div>
</div>
<div class="col-12 col-lg-4 mb-5">
<div class="mg-card mg-box-shadow h-100">
<a target="_self"
href="https://github.com/MonoGame/MonoGame.Samples/tree/3.8.4/ShipGame"
class="mg-no-link">
<div class="mg-card-body d-flex flex-column h-100">
<div class="mg-card-title"><i class="bi bi-rocket-takeoff-fill"></i> ShipGame Sample 3D</div>
<p>
Ship Game is a 3D spaceship combat game set inside a complex tunnel system featuring advanced lighting and textures, a full GPU particle system, and physics.
</p>
<p class="mt-auto">Click to view 3D ShipGame sample</p>
</div>
</a>
</div>
</div>
<div class="col-12 col-lg-4 mb-5">
<div class="mg-card mg-box-shadow h-100">
<a target="_self"
href="/articles/samples.html"
class="mg-no-link">
<div class="mg-card-body d-flex flex-column h-100">
<div class="mg-card-title"><i class="bi bi-lightbulb"></i> Coming Soon</div>
<p>
More 3D sample projects coming soon.
</p>
<p class="mt-auto">See what is coming</p>
</div>
</a>
</div>
</div>
</div>
</section>

## Community delivered full sample projects

<section class="container-xxl mb-5">
<div class="row">
<div class="col-12 col-lg-4 mb-5">
<div class="mg-card mg-box-shadow h-100">
<a target="_self"
href="https://github.com/FlyingOakGames/GreedyKid"
class="mg-no-link">
<div class="mg-card-body d-flex flex-column h-100">
<div class="mg-card-title"><i class="bi bi-files"></i> GreedyKid</div>
<p>
The repository for "Boo! Greedy Kid" on all platforms (Windows, macOS, and Linux) and its level editor (Windows-only).
</p>
<p class="mt-auto">Click to browse the GreedyKid Source</p>
</div>
</a>
</div>
</div>
<div class="col-12 col-lg-4 mb-5">
<div class="mg-card mg-box-shadow h-100">
<a target="_self"
href="https://github.com/ZenithMoonStudios/OldSchoolAdventure"
class="mg-no-link">
<div class="mg-card-body d-flex flex-column h-100">
<div class="mg-card-title"><i class="bi bi-badge-ad-fill"></i> Old School Adventure</div>
<p>
The repository for "Old School Adventure" which was originally published using XNA on Xbox (XBLIG) and Windows Phone.
</p>
<p class="mt-auto">Click to browse the Old School Adventure Source</p>
</div>
</a>
</div>
</div>
<div class="col-12 col-lg-4 mb-5">
<div class="mg-card mg-box-shadow h-100">
<a target="_self"
href="/articles/samples.html"
class="mg-no-link">
<div class="mg-card-body d-flex flex-column h-100">
<div class="mg-card-title"><i class="bi bi-lightbulb"></i> Coming Soon</div>
<p>
More full sample projects coming soon.
</p>
<p class="mt-auto">See what is coming</p>
</div>
</a>
</div>
</div>
</div>
</section>

### 2D Samples

- [AutoPong](https://github.com/MonoGame/MonoGame.Samples/tree/3.8.4/AutoPong)
- [Platformer 2D](https://github.com/MonoGame/MonoGame.Samples/tree/3.8.4/Platformer2D)
- [NeonShooter](https://github.com/MonoGame/MonoGame.Samples/tree/3.8.4/NeonShooter)

### 3D Samples
## Official MonoGame tutorial source

- [FuelCell](https://github.com/MonoGame/MonoGame.Samples/tree/3.8.4/NeonShooter)
- [ShipGame](https://github.com/MonoGame/MonoGame.Samples/tree/3.8.4/ShipGame)
- [Building 2D Games](https://github.com/MonoGame/MonoGame.Samples/tree/3.8.4/Tutorials/learn-monogame-2d)

## XNA Game Studio Archive

Expand Down
21 changes: 19 additions & 2 deletions index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,11 @@ description: MonoGame Documentation Hub
<section class="container-xxl my-5">
<h1 id="monogame-documentation" class="fw-bold"><a href="#monogame-documentation">MonoGame Documentation</a></h1>
<p>
Whether you are just starting out with MonoGame or you've been using it for years, you can find all documentation and
Whether you are just starting out with MonoGame or you have been using it for years, you can find all documentation and
tutorials here.
</p>
</section>
<section class="container-xxl mb-5">
<section class="container-xxl mb-5" >
<div class="row">
<div class="col-12 col-lg-4 mb-5">
<div class="mg-card mg-box-shadow h-100">
Expand Down Expand Up @@ -44,6 +44,8 @@ description: MonoGame Documentation Hub
</a>
</div>
</div>
</div>
<div class="row">
<div class="col-12 col-lg-4 mb-5">
<div class="mg-card mg-box-shadow h-100">
<a target="_self"
Expand All @@ -60,6 +62,21 @@ description: MonoGame Documentation Hub
</a>
</div>
</div>
<div class="col-12 col-lg-4 mb-5">
<div class="mg-card mg-box-shadow h-100">
<a target="_self"
href="/articles/samples.html"
class="mg-no-link">
<div class="mg-card-body d-flex flex-column h-100">
<div class="mg-card-title"><i class="bi bi-arrow-down-circle"></i> Samples</div>
<p>
Check out the MonoGame samples collection, showcasing some awesome projects made with MonoGame.
</p>
<p class="mt-auto">Click to view samples</p>
</div>
</a>
</div>
</div>
</div>
</section>
<section class="container-xxl mb-5">
Expand Down