forked from MonoGame/docs.monogame.github.io
-
-
Notifications
You must be signed in to change notification settings - Fork 1
[2D Tutorial Bounty] Preface #1
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.
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
Changes from all commits
Commits
Show all changes
8 commits
Select commit
Hold shift + click to select a range
9df357f
Added preface article
AristurtleDev 28e35bc
Updated toc
AristurtleDev 3c34ca9
Move to tutorials directory
AristurtleDev 92bb76d
revert changes so only new doc is in pr
AristurtleDev bd96a34
Reword sentence per recommendation
AristurtleDev bdf4a1d
Add source files column for chapters that will have them
AristurtleDev 4782293
Add introduction paragraph
AristurtleDev f16f296
Expand contractions
AristurtleDev File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,76 @@ | ||
--- | ||
title: Building 2D Games with MonoGame | ||
description: A beginner tutorial for building 2D games with MonoGame. | ||
--- | ||
|
||
This tutorial covers game development concepts using the MonoGame framework as our tool. Throughout each chapter, we will explore game development with MonoGame, introducing new concepts to build upon previous ones as we go. we will create a Snake game, which will serve as the vehicle to apply the concepts learned throughout the tutorial. The goal of this tutorial is to give you a solid foundation in 2D game development with MonoGame and provide you with reusable modules that you can jump start future projects. | ||
|
||
## Who This Is For | ||
|
||
This documentation is meant to be an introduction to game development and MonoGame. Readers should have a foundational understanding of C# and be comfortable with concepts such as classes and objects. | ||
|
||
> [!NOTE] | ||
> If you are just getting started with C# for the first time, I would recommend following the official [Learn C#](https://dotnet.microsoft.com/en-us/learn/csharp) tutorials provided by Microsoft. These are free tutorials that teach you programming concepts as well as the C# languages. Once you feel you have a good foundation with that, come back and continue here. | ||
|
||
## How This Documentation Is Organized | ||
|
||
This documentation will introduce game development concepts using the MonoGame framework while walking the reader through the development of a Snake clone. The documentation is organized such that each chapter should be read sequentially, with each introducing new concepts and building off of the previous chapters. | ||
|
||
> [!CAUTION] | ||
> This is currently a work in progress and is not finished. | ||
|
||
| Chapter | Summary | Source Files | | ||
| ------- | ------- | ------------ | | ||
| | | | | ||
|
||
In additional to the chapter documentation, supplemental documentation is also provided to give a more in-depth look at different topics with MonoGame. These are provided through the Appendix documentation below: | ||
|
||
| Appendix | Summary | | ||
| -------- | ------- | | ||
| | | | ||
|
||
## Conventions Used in This Documentation | ||
|
||
The following conventions are used in this documentation | ||
|
||
### Italics | ||
|
||
*Italics* are used for emphasis, technical terms, and paths such as file paths including filenames and extensions. | ||
|
||
### Inline Code Blocks | ||
|
||
`Inline code` blocks are used for methods, functions, and variable names when they are discussed with the body a text paragraph. | ||
|
||
### Code Blocks | ||
|
||
```cs | ||
// Example Code Block | ||
public void Foo() { } | ||
``` | ||
|
||
Code blocks are used to show code examples with syntax highlighting | ||
|
||
## MonoGame | ||
|
||
If you ever have questions about MonoGame or would like to talk with other developers to share ideas or just hang out with us, you can find us in the various MonoGame communities below | ||
|
||
* [Discord](https://discord.gg/monogame) | ||
* [GitHub Discussions Forum](https://github.com/MonoGame/MonoGame/discussions) | ||
* [Community Forums (deprecated)](https://community.monogame.net/) | ||
* [Reddit](https://www.reddit.com/r/monogame/) | ||
* [Facebook](https://www.facebook.com/monogamecommunity) | ||
|
||
## Note From Author | ||
|
||
> I have been using MonoGame for the past several years (since 2017). It was a time in my game development journey where I was looking for something that I had more control over. I didn't want to spend the time to write a full game engine, but I also wanted to have more control than what the current engines at the time (i.e. Unity) offered. At that time, there was a vast amount of resources available for getting started, but none of them felt like they fit a good beginner series. Even now, the resources available still seem this way. They either require the reader to have a great understanding of game development and programming, or they assume the reader has none and instead focuses on teaching programming more than teaching MonoGame. Even still, some relied too heavily on third party libraries, others were simply very bare bones asking the reader to just copy and paste code without explaining the *what* of it all. | ||
> | ||
> Since then, I have written various small self contained tutorials on different topics for MonoGame to try and give back to the community for those getting started. I also participate regularly in the community discussion channels, answering questions and offering technical advice, so I'm very familiar with the topics and pain points that users get hung up on when first starting out. | ||
> | ||
> With this documentation, I hope to take the lessons I've learned and provide a tutorial series that I wish was available when I first started.. To present using MonoGame in a straight forward way, introducing concepts and building off of them as we go along in a way that makes sense and is easy to follow. | ||
> | ||
> \- Christopher Whitley (Aristurtle) | ||
|
||
## Acknowledgements | ||
|
||
> [!NOTE] | ||
> Acknowledgments will be added at a later time to recognize everyone that assisted with editing and reviewing this documentation. |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.