Skip to content

A robust, pixel-perfect collision engine for GameMaker Studio 2.3.

License

Notifications You must be signed in to change notification settings

Lojemiru/Loj-Hadron-Collider

Repository files navigation

Deprecation

I am moving on from GameMaker in general. I will provide support for this library as best possible if people still express interest in it, but I will not be actively using it and will be unlikely to add new features to the LHC.

Pull requests and issues will still be addressed, but you may get better long-term mileage with a fork.

Loj Hadron Collider

A robust, pixel-perfect collision engine for GameMaker Studio 2.3.

Need support? Want to ask a question about the extension in general, or just to pester the developer? Join the Lojcord, or open an issue.

Documentation

https://github.com/Lojemiru/Loj-Hadron-Collider/wiki

Why build a custom collision engine?

GameMaker's default collision events, while useful, are very barebones and lead to a large amount of boilerplate collision code - especially for pixel-perfect collisions. This usually results in projects having an odd mix of imprecise hit detection using built-in collision events and precise movement checks using for loops for solid collisions only. On top of that, additional checks are usually required to get the colliding side, colliding instance, etc. This all adds up to collision systems that are inconsistent, inefficient, inaccurate, and inflexible.

Furthermore, GameMaker does not offer any form of collision priority definition; collision event order is handled by the engine itself, usually based on instance creation time. Subpixel movement also requires overhead handling that quickly becomes copypasted across entire projects. Another personal gripe that I have is that GameMaker offers no intuitively accessible equivalent for interfaces (without extensive use of tag functions), mandating the use of "stacked" objects to achieve multiple collision behaviors against a single object without massive headaches.

I needed a collision engine that handles all of the above in a reasonably efficient manner, so I wrote the Loj Hadron Collider. Maybe you'll find some use out of it too.

Methodology

So how do you go about creating reasonably fast but precise collisions? My methodology for the LHC is to do a single collision check for the whole area the target instance is moving through, and only run per-pixel collision checks if an instance registered in the interface list was found. This means that we only iterate over each pixel when it's absolutely necessary to get the exact point of impact, saving many cycles when instances are moving through empty space.

In reality it's a lot more complicated than that, particularly thanks to the whole pixel-perfect setup requiring axis evaluation switching. Suffice it to say that it's not worth droning on about here; feel free to join the Lojcord if you want to hear me rant about it and/or want an explanation.

Beyond that, it's mostly internal sorting and looping optimizations. repeat(x) is used everywhere possible rather than other loops for maximum performance. As a result, the LHC is YYC-optimized, assuming what I've been told about internal loop evaluation holds true.

Special thanks

Martin Piecyk, for writing arguably the most famous GameMaker platforming engine that taught me the basics of pixel-perfect collision.

That one l33t Russian hax0r (you know who you are), for giving some technical knowledge on looping optimization per-compiler target.