Goodluck

A hackable template for creating small and fast browser games.

Goodluck is great for:

• Learning game programming and game design.
• Prototyping gameplay ideas.
• Building size-constrained games.
• Experimenting with algorithms and APIs.
• Modeling problems through animated simulations

Getting Started

Goodluck is not a typical library. You don't install it via npm install. Instead, use it as a template: generate a new repository from it, remove features you don't need, and hack away. Consult the README to learn more.

Generate a new repo on GitHub

Guidelines

Goodluck is a template for creating small browser games which fit in a few kilobytes. Apart from the game loop and the rendering pipeline, Goodluck doesn't give you much more code. We like to think of Goodluck as a set of good practices, architecture decisions, and tools.

1. Write code that you need just for this game. Don't design extensible abstractions. Your goal is to ship a game, not to build an engine.
2. Write data-driven code. Goodluck uses the ECS architecture; separate the data (components) from the logic (systems).
3. Prefer simple procedural code and closed type systems. Instead of designing class inheritance hierarchies, use union types and switch between the variants.

Examples

(Size minified and gzipped.)

Starter Templates

• NewProject2D 1.7KB
• NewProject3D 4.0KB
  • WebGL1 for compatibility with Safari

Examples

• Animate 5.1KB
  • Simple animation system
  • Complex transform hierachy
  • Audio source
• DeferredShading 6.4KB
  • Deferred shading pipeline using WebGL2
  • The scene renders to a G-buffer which is then shaded in a postprocess.
• FlatShading 6.4KB
  • WebGL2 with the flat qualifier from GLSL ES 3.0
  • Diffuse materials: flat, Gouraud, Phong
  • Specular materials: flat, Gouraud, Phong
  • Flat-shaded icosphere
• FlyCamera 5.9KB
  • First-person camera
  • Keyboard, mouse, gamepad and touch controls
  • Fullscreen
  • 2D elements drawn in the 3D space, always facing the camera
• Instancing 3.7KB
  • WebGL2
  • Instanced draw using cubes to produce voxel-like graphics
• Monkey 23.3KB
  • Meshes exported from Blender (through OBJ)
  • A smooth shaded mesh, specular material 13.0KB
  • A flat shaded mesh, diffuse material 8.7KB
• Particles 3.2KB
  • Particle emitter using GL_POINTS
• PathFinding 12.3KB
  • A* path finding on a nav mesh
  • Mouse picking (AABB and mesh triangle)
  • Terrain mesh 5.1KB
• RenderTexture1 6.8KB
  • Render to texture
  • Texture 3.9KB
• RenderTexture2 6.8KB
  • Same as RenderTexture1 but in WebGL2
• RigidBody 4.8KB
  • AABB Collisions
  • Rigid collision response
  • Gravity
• Shading 7.2KB
  • Basic materials: points, wireframe, basic
  • Diffuse materials: Gouraud, Phong
  • Specular materials: Gouraud, Phong (with different settings)
  • Smooth-shaded icosphere
• Texture 56.1KB
  • Icosphere with UVs
  • Texture 51KB
• ThirdPerson 6.7KB
  • Third-person camera
  • Keyboard, mouse and gamepad controls
  • Camera damping
• TodoApp 1.2KB
  • Immediate mode UI
• Trigger 5.2KB
  • AABB collisions
  • Trigger on collision
  • Wireframe debug mode
• WebXR 7.5KB
  • WebGL2
  • 6DoF Controller support
  • A simple hand mesh 2.9KB

Games

• Backcountry
  • A hack-and-slash game set in the Wild West.
  • A submission to js13kGames 2019.
  • The entire game fits into 13 KB zipped.
  • E-book: The Making of Backcountry.
• Time Is Money
  • An incremental game about the passage of time.
  • A submission to Gamedev.js Jam 2020.
• Oh No! All The Textures Are 404!
  • A puzzle game inspired by the Nintendo DS.
  • The entire game fits into 13 KB zipped.
  • A submission to js13kGames 2020.
• ROAR
  • A WebXR game about the zen of destruction.
  • The entire game fits into 13 KB zipped.
  • A submission to js13kGames 2020.
  • E-book: The Making of ROAR.
• Mirrorisk
  • An adaptation of the board game classic Risk.
  • A submission to Gamedev.js Jam 2021.

Other

• Social Distancing
  • A simulation made in the early days of the COVID-19 pandemic.
• Chain Reaction
  • One of the first 2D experiments with Goodluck.
  • Click to set off explosions and try to destroy all bouncing balls.
• Breakout
  • A Breakout clone made for a workshop. Follow the tutorial branch to learn about ECS and Goodluck.
  • We also ported it to C and Rust.
• Hej
  • One of the first VR experiments with Goodluck.
  • High five!