# Awesome DragonRuby

![](./dragonruby-logo.png)

[DragonRuby Game Toolkit](http://dragonruby.org/toolkit/game) DragonRuby Game Toolkit is a professional grade 2D game engine. It's tiny (~3.5MB), fast, and cross-platform (including consoles and mobile). The managing members of DragonRuby are Ryan C. Gordon (core contributor of SDL), Amir Rajan (critically acclaimed indie game dev), Aaron Lasseigne (author, presenter, and a powerhouse Ruby developer), and Alex Denisov (LLVM specialist).

See [a 5-minute intro to DragonRuby](https://www.youtube.com/embed/DYBRzglsEzU).

This list is a categorized community-driven collection of awesome [DragonRuby GTK](https://dragonruby.org/toolkit/game) example apps, libraries, tools, frameworks, software and resources.
Sharing, suggestions and contributions are always welcome!

## Contents

  - [Samples](#samples)
  - [Games](#games)
  - [Apps](#apps)
  - [Developer Tools](#developer-tools)
  - [Libraries, Frameworks and Wrappers](#libraries-frameworks-and-wrappers)
  - [Documents & Tutorials & Presentations & Videos](#documents--tutorials--presentations--videos)
  - [Resources](#other-resources)
  - [Contributing](#contributing)

## Samples
_All samples in this section must link to freely available source code with an [open source license](https://choosealicense.com/)._

* [DragonRuby Samples Site](https://samples.dragonruby.org) - A showcase of code samples and complete games provided by DragonRuby, along with video recordings and live, in-browser samples.
* [DragonRuby Documentation](https://docs.dragonruby.org) - DragonRuby documentation contains code for all the samples that ship with DragonRuby.


## Games

* [DragonOS](https://dragonridersunite.itch.io/dragon-os) - Interactive showcase of open source games made with DragonRuby GTK
* [DragonRuby Collection](https://itch.io/c/1043933/dragonruby) - A collection of all known DragonRuby games on itch.io, maintained by Akzidenz.
* [DragonRuby Treasure](https://itch.io/c/2785336/dragonruby-treasure) - A curated collection of DragonRuby games on itch.io, maintained by Akzidenz.
* [Tagged with DragonRuby on itch.io](https://itch.io/games/tag-dragonruby) - Games on itch.io tagged 'dragonruby' by their creators.

* Open source games
  * [Engine samples](https://github.com/DragonRuby/dragonruby-game-toolkit-contrib/tree/master/samples)
  * [Crashball](https://github.com/awfulcooking/Crashball) by awfulcooking
  * [Dino Jump](https://github.com/presidentbeef/dino_jump) by presidentbeef
  * [Dragon Shooter](https://github.com/pusewicz/dragon-shooter) by pusewicz
  * [Luckpaint](https://github.com/Rabios/luckpaint) by Rabios
  * [Tank Vs Zombies](https://github.com/shanshaji/Tank-Vs-Zombie-Game-Ruby) by shanshaji
  * [XENO.TEST](https://github.com/brettchalupa/xeno.test) by brettchalupa

## Apps

* [chart-global-temp](https://github.com/jasemagee/chart-global-temp/) - A line chart showing global temperature written using DragonRuby
* [dragon-ruby-documenter](https://github.com/ediathome/dragon-ruby-documenter) - This small app dumps a basic DragonRuby documentation to a Markdown file

## Developer Tools

* [DragonRuby Game Toolkit](https://dragonruby.itch.io/dragonruby-gtk)
* [Palantir](https://kfischer-okarin.itch.io/palantir) - A DragonRuby Game Toolkit state inspector by kfischer_okarin

## Libraries, Frameworks and Wrappers

* [Draco](https://github.com/guitsaru/draco) - An Entity Component System for DragonRuby GTK
* [LDtkBridge](https://github.com/LittleB0xes/LDtkBridge) - A bridge between LDtk (level editor) and DragonRuby
* [Scale](https://github.com/DragonRidersUnite/scale) - Lightweight starter template with common helpers
* [Smaug](https://smaug.dev/) - Installation and package manager for DragonRuby
* [Wave Function Collapse](https://github.com/pusewicz/wave-function-collapse-dragonruby) - An implementation of the tiled [Wave Function Collapse](https://en.wikipedia.org/wiki/Wave_function_collapse) algorithm in DragonRuby
* [Zif](https://github.com/danhealy/dragonruby-zif) - A Drop-in Framework for DragonRuby Game Toolkit

## Documents & Tutorials & Presentations & Videos

### Books

* [Building Games with DragonRuby](https://book.dragonriders.community/) - Free book by Brett Chalupa on getting started with DragonRuby Game Toolkit

### Documents

* [Ruby for Dragons](https://ejectdrive.com/Ruby_for_Dragons/) - Alternative community supported wiki
* [Dragon Riders Community](https://www.dragonriders.community) - Community website with recipes, news, and more

### Courses

* [DragonRuby Game Toolkit Tutorial](http://dragonruby.school) by WNDX School
* [Interactive Online Fiddle Course](fiddle.dragonruby.org/)

### Videos

* [Coding Workshop for Aspiring Game Developers](https://www.youtube.com/watch?v=S3CFce1arC8) by Amir Rajan
* [DragonRuby Game Toolkit 3.0 Performance vs Unity](https://www.youtube.com/watch?v=MFR-dvsllA4) by Amir Rajan
* [Game Development using DragonRuby Game Toolkit](https://www.youtube.com/watch?v=ILdmGv_PY-0) by Amir Rajan
* [Intro to DragonRuby Game Toolkit](https://www.youtube.com/watch?v=DYBRzglsEzU) by Ryan C Gordon

### Written Tutorials

* [Roguelike Tutorial](https://github.com/Craggar/dragonruby_tutorials) by [Craggar](https://github.com/Craggar)
* [presidentbeef's DragonRuby Game Toolkit notes](https://dev.to/presidentbeef/api-levels-in-dragonruby-game-toolkit-4jb4)

## Other Resources

### Game Development

* [Open Game Art](https://opengameart.org)

## Community Resources

* [DragonRuby Discord](http://discord.dragonruby.org)
* [Forum on itch.io](https://dragonruby.itch.io/dragonruby-gtk/community)
* [GitHub Topic](https://github.com/topics/dragonruby)
* [Newsletter](dragonrubydispatch.com/)
* [Stack Overflow](https://stackoverflow.com/questions/tagged/dragonruby)

## Contributing

Please take a look at the [contribution guidelines and quality standard](https://github.com/DragonRidersUnite/awesome-dragonruby/blob/master/CONTRIBUTING.md) first.

Thanks to all [contributors](https://github.com/DragonRidersUnite/awesome-dragonruby/graphs/contributors), you're awesome and this wouldn't be possible without you!

## License

[![CC0](http://mirrors.creativecommons.org/presskit/buttons/88x31/svg/cc-zero.svg)](https://creativecommons.org/publicdomain/zero/1.0/)