Skip to content
A small rendering engine for creating 2d games with elm, based on WebGL.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src/Game
.gitignore
LICENSE
README.md
elm.json

README.md

Elm render 2D game

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

TODO: pretty pictures and more examples

Related Libraries

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

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.0.0 -> 3.1.0 **

    • Added viewportToGameCoordinates thanks to @Luftzig.
  • ** 2.1.0 -> 3.0.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.
      • Added manuallyManagedAnimatedSpriteWithOptions
  • 2.0.0 -> 2.1.0

    • Exposed renderTransparent
  • 1.0.1 -> 2.0.0

    • Updated to WebGL 2.0.
    • Renamed Vertex attribute a_position to position
You can’t perform that action at this time.