Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cocoatoucher/Glide

Game engine for making 2d games on iOS, macOS and tvOS, with practical examples and tutorials
https://github.com/cocoatoucher/Glide

2d-game-engine apple game-development game-engine gamedev gameplaykit games ios macos platformer platformer-engine side-scroller spritekit tiled-map-editor tilemap tvos

Last synced: 3 days ago
JSON representation

Game engine for making 2d games on iOS, macOS and tvOS, with practical examples and tutorials

Awesome Lists containing this project

README 

        


glide




# Glide Engine



Glide is a SpriteKit and GameplayKit based engine for building 2d games easily, with a focus on side scrollers. Glide is developed with Swift and works on iOS, macOS and tvOS.





glide devices




- Download the macOS demo app [here](https://github.com/cocoatoucher/Glide/raw/master/Docs/GlideDemo.zip) to give it a try. 

- or watch a video of the features [here](https://vimeo.com/334243593). 

- [Documentation](https://cocoatoucher.github.io/Glide/index.html)







A glimpse of the Glide's features










Package Build status





iOS 14.0 / macOS 11.0 / tvOS 14.0





















- Make a simple 2d platformer in half an hour, tutorial on YouTube:







Starter Tutorial






- Tutorial 2: Touch buttons and introduction to input management, watch on YouTube:







Tutorial 2






- More tutorials are on the way! Stay tuned for updates in a couple of weeks. (Updated 3rd June 2019) [Follow on YouTube](https://www.youtube.com/channel/UCKB7inlaMD2CvyaQKQ2snZw)



## What is in Glide?



### 1. Entity component system

Glide is developed with [Entity-Component-System architecture](https://en.wikipedia.org/wiki/Entity_component_system). In short, this makes it easy to manage the code of your game, which might quickly get messy as you add more stuff. In addition to that, loads of building components common to 2d platformers that will get you quickly started is also included in the engine. 



#### See all the components [here](https://github.com/cocoatoucher/Glide/blob/master/Docs/Components.md). 👾



### 2. Tight collisions and contacts

Glide has its own collision and contact algorithms which is more suitable for precise platformer mechanics compared to using SpriteKit's physicsBody.



### 3. Input 🎮⌨️🖱🔲

Support for Bluetooth and USB game controllers, keyboard, mouse, and touch controls comes out of the box with Glide and it is pretty intuitive to use them. Learn more about supported input methods [here.](https://github.com/cocoatoucher/Glide/blob/master/Docs/InputMethods.md)



### 4. Native game menus










You can't imagine a game without menus in most cases. A UIKit / AppKit based user interface library for making game menus is included in Glide, so you don't have to give up from native Apple components in your games. Of course, those menus are controllable via game controllers on iOS, macOS and tvOS 🎮💃



## Inspiration

Glide naturally draws inspiration from the approaches of other popular and smaller game engines on different platforms. Those inspirations are also rooted in the usage of certain architectural patterns like entity-component-system. On top of that, Glide has a bunch of tailored solutions towards making it easier to create more professional platformers and 2d games in general on Apple platforms.



## Get your hands on Glide



### Demo scenes

Glide comes with a fully fledged demo project. Download this repository and run it in your favorite platform. Running on release configuration with a real device is recommended for experiencing the actual performance.



### Quick start guide

Create your first scene with your first entity [here.](https://github.com/cocoatoucher/Glide/blob/master/Docs/QuickStartGuide.md)



### Update loops

Here are the update loop charts of Glide that you might need as a handy reference.



Scene update loop       |  Entity update loop     |  Component update loop

:-------------------------:|:-------------------------:|:-------------------------:

![alt text](https://github.com/cocoatoucher/Glide/raw/master/Docs/glide-update-cycle-scene.png "Update cycle of a scene")  |  ![alt text](https://github.com/cocoatoucher/Glide/raw/master/Docs/glide-update-cycle-entity.png "Update cycle of an entity")  |  ![alt text](https://github.com/cocoatoucher/Glide/raw/master/Docs/glide-update-cycle-component.png "Update cycle of a component")



### Game genres

Supporting other types of 2d games(e.g. top down) with Glide is totally possible. However, that is not tested with enough demos yet, and side scrollers are the initial focus for the engine. Please feel free to contribute with your own demos and changes to Glide for supporting other genres.



### 🐞🐜

Bugs are expected since Glide is in its early days and this is currently a solo developer project. Please report the bugs you find and give some patience 🙏



### Credits:



- Animated Pixel Adventurer: [https://rvros.itch.io/animated-pixel-hero](https://rvros.itch.io/animated-pixel-hero)

- Classical ruin tiles: [https://opengameart.org/content/classical-ruin-tiles](https://opengameart.org/content/classical-ruin-tiles)

- Original trailer video music by John Walden: [https://soundcloud.com/jwaldenmusic](https://soundcloud.com/jwaldenmusic)

- [All credits](https://github.com/cocoatoucher/Glide/blob/master/Docs/AssetCredits.md)