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 - 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 / src

• Bouncy ball / src

• Random tests / src

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.

• ** 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.
    • Added manuallyManagedAnimatedSpriteWithOptions

• 2.0 -> 2.1

  • Exposed renderTransparent

• 1.0 -> 2.0

  • Updated to WebGL 2.0.
  • Renamed Vertex attribute a_position to position