GML Unit Test Framework

GML Unit Testing Framework is a lightweight, easy-to-integrate tool that brings automated testing to GameMaker projects. It allows you to validate game logic, core systems, and utility scripts using simple, script-based test cases — helping you prevent bugs and regressions as your game evolves.

Whether you're a solo developer or working on reusable systems (e.g., procedural generation, combat logic, inventory mechanics), this tool helps you stay confident in your code without manual testing loops.

How it works:

1. Define your unit tests as individual scripts/functions (examples included)
2. Run all tests via a single script call
3. View the results instantly in the output console

You can also configure:

• Custom trigger logic (e.g., per key press, per step)
• Conditional test execution (e.g., only in debug mode)
• Grouped test categories (e.g., movement, inventory, math)

Features:

• Script-based testing system using plain GML
• Outputs pass/fail results in GameMaker's output consolee
• Easily extendable with new tests and assertion types 
• Integrates with build configurations (e.g., only runs in TEST configuration)
• Using preprocesor directives to keep your production code clean (compile only  in TEST configuration)
• Triggers at the start of the game, but can be easily triger it in any event by simply call single function

Requirements:

• Only basic GML scripting knowledge is required
• Recommended basic understanding of unit testing concepts
• Compatible with GameMaker version that supports functions and macros (2.3+)

This tool is ideal for intermediate to advanced GameMaker users who want to bring better development practices into their solo or small team workflow. It works well with complex gameplay systems, tool development, or shared code libraries