elm-2d-game

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #machine-learning #rust #deep-learning #java #windows #awesome #kubernetes

(★ 97)

A small rendering engine for creating 2d games with elm, based on WebGL.

File Explorer

Download Latest Version (.zip)

- - box.png
  - cloud_bg.png
  - grass.png
  - guy.png
- .gitignore
- BouncyBall.elm
- elm.json
- Example1.elm
- MarioLike.elm
- - Helpers.elm
  - TwoD.elm
.gitignore
elm.json
LICENSE
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Elm render 2D game

This library aims to enable creating 2d games based on WebGL using elm.

TODO: pretty pictures and more examples

## Alternative libraries

Check out https://korban.net/elm/catalog/packages/game-dev/rendering for similar libraries and other approaches to game development.

## Related Libraries

* [game-resources](http://package.elm-lang.org/packages/Zinggi/elm-game-resources/latest) - A library for managing textures

## Goals

My current goal is just to enable users with no WebGL and GLSL knowledge to create simple games.
Hopefully this will eventually grow into something bigger, but currently that's what this is.

This library is for you, if
 * you want to create a simple 2d game as a learning experience
 * you want to use elm
 * you've used elm-graphics, but are looking for a slightly more powerful option without going full WebGL.

If you want to create a "real" game, I strongly recommend other options such as Godot / LÖVE / libGDX / MonoGame / Unreal / Unity etc...

## Examples
 * [Jump and run](https://zinggi.github.io/elm-2d-game-examples/MarioLike.html) / [src](https://github.com/Zinggi/elm-2d-game-examples/blob/master/MarioLike.elm)

* [Bouncy ball](https://zinggi.github.io/elm-2d-game-examples/bouncyBall.html) / [src](https://github.com/Zinggi/elm-2d-game-examples/blob/master/bouncyBall.elm)

* [Random tests](https://zinggi.github.io/elm-2d-game-examples/example1.html) / [src](https://github.com/Zinggi/elm-2d-game-examples/blob/master/example1.elm)

## Vision

The vision for this library is to grow into something bigger.
Currently it only provides a way to render things to the screen.

It does not provide a way to structure your physics/gameplay code,
no resource management, no input management, no sound, no networking, etc.

However, the idea is that each of the mentioned missing topics can be created as a separate package that would live under the same namespace. E.g. a 2d physics engine might live in a package called `elm-game-2d-physics` and provide the namespace `Game.TwoD.Physics`

## Update log

* ** 3.1 -> 4.0 **
    * Upgrade to elm 0.19

* ** 3.0 -> 3.1 **
    * Added `viewportToGameCoordinates` thanks to [@Luftzig](https://github.com/Luftzig).

* ** 2.1 -> 3.0 **
    * **Breaking changes:**
        - Removed `rectangle`. Use `shape rectangle` instead
        - Changed what the pivot affects.
            + Previously, the pivot only affected the center of rotation.
            The pivot now also affects where position refers to.
            For instance, a pivot of (0.5, 0) means that the position parameter of the object now refers to its bottom center.
            + If you want the previous behavior, use `(x + pivotX*w, y + pivotY*h)` instead of `(x, y)` for position.
            + `makeTransform` is also affected by that change.
    * ** New stuff: **
        - Added more prototyping shapes, thanks to [@yourSenchou](https://github.com/yourSenchou).
        - Added `manuallyManagedAnimatedSpriteWithOptions`

* **2.0 -> 2.1**
    * Exposed `renderTransparent`

* **1.0 -> 2.0**
    * Updated to WebGL 2.0.
    * Renamed Vertex attribute `a_position` to `position`

elm-2d-game

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

elm-2d-game

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README