MCPcopy
hub / github.com/KilledByAPixel/LittleJS

github.com/KilledByAPixel/LittleJS @v1.18.15 sqlite

repository ↗ · DeepWiki ↗ · release v1.18.15 ↗
2,093 symbols 6,114 edges 135 files 871 documented · 42%
README

LittleJS - The Tiny Fast JavaScript Game Engine

LittleJS Logo

NPM Package Build Size NPM Downloads DeepScan MIT License Discord

🚂 All Aboard!

LittleJS is a fast, lightweight, and fully open source HTML5 game engine designed for simplicity and performance. Its small footprint is packed with a comprehensive feature set including rendering, physics, particles, sound, and input handling. The code is very clean and well documented with many examples to get you started quickly.

🚀 Join the LittleJS Game Jam

The Third Annual LittleJS Game Jam will take place From Oct 2 to Nov 2! Unleash your creativity and develop amazing games using the LittleJS game engine. 🕹️🎮 Sign up today and get more info about the jam on itch.io!

Demos | Docs | Reference | FAQ | Trailer | Discord

LittleJS Screenshot

LittleJS Features

✨ Graphics

  • Blazing fast WebGL2 + Canvas2D hybrid rendering system
  • Apply Shadertoy style shaders for post-processing effects
  • Robust particle effect system and effect design tool

🔊 Audio

  • Sound and music with mp3, ogg, or wave files
  • Use ZzFX sound generator to play sounds without asset files
  • Spatial audio stereo panning

🎮 Input

  • Comprehensive input handling for mouse, keyboard, gamepad, and touch
  • Customizable on screen gamepad designed for mobile devices

💥 Physics

  • Robust arcade physics system with collision handling
  • Fast tilemap collision and raycasting
  • Full Box2D integration for realistic physics using Box2D v2.3.1 wasm
  • Grid-based A* pathfinding plugin with optional path smoothing

🚀 Flexibility

  • Compatible with all modern web browsers and mobile devices
  • Full TypeScript and Module support with example projects for both
  • Vite starter template for instant dev server with hot reload
  • Great for size coding competitions like Js13kGames
  • Open Source and MIT licensed

🛠️ Developer Tools

  • Live example browser with code editor
  • Import level editor data from Tiled or other JSON
  • Debug overlay and primitive rendering system
  • Medal tracking system with Newgrounds support
  • Node.js build system

How To Use LittleJS

To get started download the latest LittleJS package from GitHub or install via npm: 

npm install littlejsengine

or use degit for an empty Vite template

npx degit KilledByAPixel/LittleJS/examples/vite-starter my-game
cd my-game
npm install
npm run dev

Here is a minimal Hello World example game.

<!DOCTYPE html>
<script src="https://github.com/KilledByAPixel/LittleJS/raw/v1.18.15/dist/littlejs.js"></script>
<script>
function gameInit() {}
function gameUpdate() {}
function gameUpdatePost() {}
function gameRender() {}
function gameRenderPost() { drawTextScreen('Hello World!', mainCanvasSize.scale(.5), 80); }
engineInit(gameInit, gameUpdate, gameUpdatePost, gameRender, gameRenderPost);
</script>

Tutorials

Examples

LittleJS comes with several demos both for learning and using as starter projects to create new games.

  • Example Browser - Live example browser with all examples and editable source
  • Short Examples - 60+ single-file demos showing off individual engine features
  • Breakout - Block breaking game with post-processing effects
  • Puzzle Game - Match 3 puzzle game with HD rendering and high score tracking
  • Platformer - Platformer/shooter demo that loads level data
  • Box2D Demo - Box2D plugin demonstration and testbed
  • Stress Test - Sprite rendering benchmark and music system demo
  • Particle System Designer - Particle system editor and visualizer

Builds

File Mode Module Use case
littlejs.js Debug No Debug mode with asserts
littlejs.release.js Release No Optimized for release
littlejs.min.js Release No Optimized for release and minified
littlejs.esm.js Debug ESM Debug mode with asserts
littlejs.esm.min.js Release ESM Optimized for release and minified

Games Made With LittleJS

Here are a few of the many amazing games created with LittleJS...

A collage of screenshots from games made with LittleJS

A sample of games built with LittleJS.

LittleJS pixel-art favicon

Core symbols most depended-on inside this repo

vec2
called by 1209
src/engineMath.js
ASSERT
called by 333
src/engineDebug.js
h
called by 229
plugins/box2d.wasm.js
assert
called by 215
plugins/box2d.wasm.js
hsl
called by 164
src/engineMath.js
add
called by 135
src/engineMath.js
rgb
called by 111
src/engineMath.js
scale
called by 105
src/engineMath.js

Shape

Function 1,126
Method 737
Class 230

Languages

TypeScript100%

Modules by API surface

plugins/box2d.js256 symbols
docs/scripts/third-party/hljs-original.js141 symbols
plugins/uiSystem.js110 symbols
src/engineMath.js107 symbols
plugins/box2d.wasm.js90 symbols
docs/scripts/third-party/hljs.js83 symbols
docs/scripts/third-party/tippy.js66 symbols
src/engineDraw.js54 symbols
examples/box2d/gameObjects.js53 symbols
src/engineInput.js49 symbols
src/engineSettings.js48 symbols
src/engineTileLayer.js46 symbols

Dependencies from manifests, versioned

bestzip2.2.1 · 1×
electron38.2.0 · 1×
electron-packager17.1.2 · 1×
google-closure-compiler20230502.0.0 · 1×
littlejsengine1.18.0 · 1×
roadroller2.1.0 · 1×
typescript5.1.6 · 1×
uglify-js3.17.4 · 1×
vite7.3.1 · 1×

For agents

$ claude mcp add LittleJS \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact