Skip to content

[PAID BOUNTY][LOCKED] A better 3D onboarding tutorial #8318

Description

@SimonDarksideJ

MonoGame needs a better 3D onboarding tutorial to explain the basics of the framework, from its installation to using its core concepts, all the way down to making a developer's first simplistic game.

( A separate bounty for a 2D onboarding tutorial is also be available)

📃Full details

MonoGame lacks a good 3D onboarding tutorial that is both accessible and entertaining to read or watch. The current getting started documentation is a bit rough in that regard and it could be better at assisting newcomers to get into MonoGame, understand its concepts, and getting interested through a more modern take on tutorials.

Ideally, this onboarding would cover a basic history of the framework and a description of what it is, a walkthrough to create their first project, explaining a project built with MonoGame from its core concept through the creation of a first basic game, as well as tips for how to then take the game forward to publish it to itchio (as an example).

This new onboarding can take the shape of a written tutorial. (A separate bounty will be created to turn it into a video tutorial)

It is expected that the assets used are open and free to use (and properly licensed/credited), and if original assets should be contributed, it is also expected that they abide by the same rule.

If the builder of the tutorial also wants to publish the title and gain revenue with it, that is fine, so long as the source is available for developers to walk through.

External libraries are allowed, so long as their use and the reasons for their use are explained fully, the tutorial creator is not limited to ONLY the MonoGame Framework if tools to accelerate game development are available (including highlighting the use of these addons), again, so long as the access to those tools is free to use (no paid add-ons).

Content must be applicable to all age groups, so please keep this in mind for the sample, to ensure there is no gore, age-inappropriate or sexual content

💰 Bounty

2000 USD.

✋ Requirements to apply

Standard requirements from our generic bounty requirements.

📦 Expected delivery content

A written onboarding tutorial covering the following:

To avoid duplication of effort, basic 2D topics can be skipped so long as links will be available to link back to them

  • Provide a high-level explanation of the Game class (and briefly describe its services, most notably the graphics device and window). - short, as already detailed in 2D bounty, focus on how it is used by 3D.
  • Introduce the content pipeline and its advantages/extensions for 3D elements.
  • Detail the sprite batcher and graphical operation, with a focus on Drawing states and requirements when doing 3D.
  • Brief overview of Effects.
  • A high-level overview of Cameras, projection, and 3D positioning.
  • Basic 3D physics and collisions.
  • An introduction to input via keyboard, gamepad, mouse, and touch.
  • Showing how to add audio, both effects and music.
  • Putting everything together to make a small first game (e.g. an asteroid game, or anything else that covers movements, generating sprites...)
  • Adding a simple menu system.
  • Building and shipping your game. (only a basic flow, a future bounty will focus on Platform "x" deliveries)

The Sample project/tutorial created for the Fuel Cell sample, is a good guide for the expectations for the project, showing the final code and all the steps needed to both recreate the project AND understand how it was built.

📅 Delivery timeline

Not urgent. (but ideally by the end of March 2025)
Ideally targeted at the upcoming 3.8.3 release.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions