Hello Mario Engine

The Hello Mario Engine is an open source Mario engine for GameMaker: Studio that is feature packed, and designed to be easy to expand upon with user friendliness as a priority. The engine is fully documented with thousands of code comments, and includes tons of different powerups, over a hundred different enemies, and much, much more!


Making a Mario game is as easy as 1-2-3!


Download and extract the Hello Mario Engine Source.


Download and install GameMaker: Studio 1.4 if you don't already have it. The free version of 1.4 is not compatible with the Hello Mario Engine unless you have the free "Standard" version from before March 2017.


After you start GameMaker: Studio, you will see an import tab. Click on it, and import the HelloMarioEngine.gmz file that you downloaded. For additional help, check out the tutorials page.

"I love making games using the Hello Mario Engine. No programming needed! It can just be used like an editor to make Mario games effortlessly! Wheee!"

Mario Editor

Looking for an easy to use level editor? Don't want to program or customize the engine? If so, check out Mario Editor, a level editor powered by Hello Mario Engine!


Latest version: v6.2.2

Hello Mario Engine Source

GMZ project for GameMaker: Studio 1.4. Make sure your copy of GameMaker: Studio is up to date before importing. Otherwise, you will experience problems.


Hello Mario Engine Preview

EXE preview for Windows. Showcases the various features included in the Hello Mario Engine. Compiled with the YoYoCompiler for maximum performance.


Hello Mario Engine v6.2.2 (December 16, 2019)

Large question blocks can now contain any item.
Grey Female Blocks: Can be broken by Super Crown Mario
Bug fixes.

Hello Mario Engine v6.2.1 (November 25, 2018)

On screen controls for Android and iOS.
Bug fixes.

Hello Mario Engine v6.2 (November 7, 2018)

Seven New Powerups: Added Acorn, Cloud Flower, Rock Shroom, Pyre Flower, Swooper Suit, Karate Suit, and Super Crown.
All Seven Koopalings: Added Morton, Iggy, Roy, Lemmy, and Ludwig.
Various bug fixes and tweaks.

Hello Mario Engine v6.1.6 (December 15, 2017)

Improved Gamepad support.
Bug fixes.

Hello Mario Engine v6.1.5 (November 17, 2016)

New rain effect.
Bug fixes.

Hello Mario Engine v6.1.4 (June 22, 2016)

Bug fixes.

Hello Mario Engine v6.1.3 (October 1, 2015)

Ability to add new slope shapes without touching any code.
Bug fixes.

Hello Mario Engine v6.1.2 (June 30, 2015)

Bug fixes.

Hello Mario Engine v6.1.1 (April 24, 2015)

Collision events with obj_solidtop removed from most objects.
Bug fixes.

Hello Mario Engine v6.1 (February 15, 2015)

16:9 Widescreen Default Resolution
New Powerup: Wall Jump Shroom
Various New Features: Bomb Bricks, Propeller Blocks, Blue POW Blocks, New Net Koopa and Piranha Plant Variations, etc.
Various Bug Fixes: This includes all YoYoCompiler related issues, so you can use YYC export options without encountering any problems.

Hello Mario Engine v6.0.4 (October 25, 2014)

Bug fixes.

Hello Mario Engine v6.0.3 (June 30 2014)

Bug fixes.

Hello Mario Engine v6.0.2 (June 7, 2014)

Bug fixes.

Hello Mario Engine v6.0.1 (May 25, 2014)

Bug fixes.

Hello Mario Engine v6.0 (May 12, 2014)

Code Rewrite: Newer, cleaner, fully commented code.
High Resolution Filtering: Choose between HQ4X, HQ2X, and no filtering.
Better Checkpoints: Supports infinite checkpoints per level.
New Powerups: Propeller Shroom and Boomerang Flower.
New Features: Mechakoopas, green bricks, triple wide question mark blocks, and more!
Many Changes to Existing Features: Better world map level blocking, keyhole animation, convex corner support for wall triangles, and more!

Hello Mario Engine Legacy

GMK source for GameMaker 8.x. The legacy version is inferior to the main version and is no longer being updated. If you want the optimal Hello Mario Engine experience, use the main version instead.



Examples of games created using the Hello Mario Engine.

The Shroom Project

Mario with guns, blood, and an epic tale.

Hello Fangaming Collection

10th anniversary level collection.

Super Mario Dynamo

Challenging Mario platforming with hardcore wall-jumps.

Super Mario Eclipse

Colorful Mario platforming with challenging puzzles.


Anyone can make a Mario game. Even you!

Easy to Use

Creating your own Mario game is easy. All you need is a copy of GameMaker: Studio, and the Hello Mario Engine source, and you're good to go! Use GameMaker: Studio's built in room editor to piece together your own Mario levels using the engine's hundreds of pre-made features.

User Friendly

The Hello Mario Engine's code includes thousands of code comments. Everything is fully documented and organised in an intuitive manner in order to allow you to customise the engine's code base and add in your own features with minimal code and effort.

Feature Packed

The Hello Mario Engine includes hundreds of features taken from various 2D Mario games. A huge number of pre-made powerups, enemies, and items can be used in the levels you create. The player physics are a close replica of the ones in official Mario games.

"The number of stuff packed into the Hello Mario Engine is HUGE! If you used all of its features in one level, that level would be either really long, or a cluttered mess!"

Hello Mario Assets

Want to try making 3D fangames instead? Check out Hello Mario Assets, an asset pack for Unity!

Learn More

Code Repository

The Hello Mario Engine is on GitHub. Click here to view this project's repository!

New Stuff

You can download the latest version of the engine at all times, and see the latest code changes made to the engine as they happen! If you just want the latest stable version, you can use the download link on this page instead.


Forking the repository is an easy way to start your own fan-made update to the engine!


Want to show your support? Click the star button to star the project!


Version Control

See the line by line changes made to the engine. You can copy bug fixes over to a game you've already started!

Issue Tracker

Did you find a bug in the engine? Do you have any suggestions? Post them on the issue tracker!


The engine is licensed under the New BSD License, which gives you permission to do whatever you want with the engine, as long as you give credit.


Do you like the Hello Mario Engine? Let others know! Show your support for the Hello Mario Engine using these banners!

"It's silly to re-invent the wheel, right? That is why using a pre-made engine is a good idea! It really is a time saver!"


Leave your feedback here!