Scar - A Crystal Game Library/Engine with Batteries included

A 2D game engine written in Crystal using crsfml

Motivation

This library aims to offer a simple interface for game programming with less boilerplate code. I mainly create it for my own games, for my own education and of course for the fun.

Features

• Event system
• Configurable input handling
• Universal 2D Vector class
• Entity-Component-System architecture
• Configuration manager
• Asset manager with hot-reloading
• Inbetweening
• Tiled map support
• Some builtin components and systems

Planned Features

• Sound manager
• Video playback

Examples

You can find examples in the examples directory. To run an example, execute the following command in your terminal, while in the root directory of this repo:

crystal run examples/<example-name>/main.cr

# e. g.
crystal run examples/hello_world/main.cr

Installation

Add this to your application's shard.yml:

dependencies:
  scar:
    github: vypxl/scar
    branch: main

If you run into build/linking problems, please check if you have SFML installed properly, as described in the CrSFML Guide. You do not need to add CrSFML as a dependency!

Feature Requests

Feature requests are welcome, just open an issue!

Contributing

1. Create an [Feature Request] Issue
2. Fork it ( https://github.com/vypxl/scar/fork )
3. (optional) Create the git hook checks via $ scripts/create-git-hooks
4. Create your feature branch (git checkout -b my-new-feature)
5. Commit your changes (git commit -am 'Add some feature')
6. Push to the branch (git push origin my-new-feature)
7. Create a new Pull Request and mention your issue

You have to ensure that crystal spec and crystal tool format --check ./src ./spec return 0.

Contributors

• vypxl vypxl - creator, maintainer