• Register

A fresh, modern & lightweight HTML5 game engine


melonJS 2 is a modern version of the melonJS game engine that was first released in 2011. It has been rebuilt entirely using ES6 class, inheritance and semantic, and bundled using Rollup to provide modern features such as transpiling and tree-shaking.

Note: migrating an existing project to melonJS 2 (version 10.0 and higher) will definitely break your game (ES6 semantic and inheritance, nodeJS event emitter, and no backward compatibility with deprecated legacy APIs), and you might want to read first this small step by step guide on upgrading to melonJS 2. If you are looking at the legacy version (9.x and lower) of melonJS, you can find it here under the legacy branch.

melonJS is open-source, licensed under the MIT License, and actively developed and maintained with the help of a small team of enthusiasts at AltByte in Singapore.

About melonJS

melonJS is a fully featured game engine :


  • Standalone library (does not rely on anything else, except a HTML5 capable browser)
  • Compatible with all major browsers (Chrome, Safari, Firefox, Opera, Edge) and mobile devices


  • 2D sprite-based graphic engine
  • Blazing Fast WebGL renderer for desktop and mobile devices with fallback to Canvas rendering
  • High DPI resolution & Canvas advanced auto scaling
  • Sprite with 9-slice scaling option, and animation management
  • built-in effects such as tinting and masking
  • Standard spritesheet, single and multiple Packed Textures support
  • System & Bitmap Text


  • Web Audio support with spatial audio or stereo panning based on Howler
  • fallback to Multi-channel HTML5 audio for legacy browsers


  • Polygon (SAT) based collision algorithm for accurate detection and response
  • Fast Broad-phase collision detection using spatial partitioning
  • Collision filtering for optimized automatic collision detection


  • Mouse and Touch device support (with mouse emulation)
  • Device motion & accelerometer support

Level Editor

  • Tiled map format version +1.0 built-in support for easy level design
    • Uncompressed and compressed Plain, Base64, CSV and JSON encoded XML tilemap loading
    • Orthogonal, Isometric and Hexagonal maps (both normal and staggered)
    • Multiple layers (multiple background/foreground, collision and Image layers)
    • Animated and multiple Tileset support
    • Tileset transparency settings
    • Layers alpha and tinting settings
    • Rectangle, Ellipse, Polygon and Polyline objects support
    • Tiled Objects
    • Flipped & rotated Tiles
    • Dynamic Layer and Object/Group ordering
    • Dynamic Entity loading
    • Shape based Tile collision support


  • Asynchronous asset loading
  • A fully customizable preloader

And Also

  • A state manager (to easily manage loading, menu, options, in-game state)
  • Tween Effects, Transition effects
  • Pooling support for object recycling
  • Basic Particle System
  • nodeJS EventEmitter based event system

Tools integration

melonJS is supporting the below tools and frameworks natively or through our official plugin(s) :

Free Texture Packer TexturePacker PhysicsEditor ShoeBox Tiled Cordova Spine aseprite

Tools integration and usage with melonJS is documented in our Wiki.

Post article RSS Related Articles

Vibrant Recycling 1.1.2 is launched, with several tweaks and better compatibility with smartphones and tablets!

Check the new version in the sites below:

Cian Games
Chrome Web Store
Firefox Marketplace


Master Spy now on Steam!

Master Spy now on Steam!

Master Spy

Master Spy, Stealth Precision Platformer, is now out on Steam!

Master Spy coming to Steam 09/08 + Release Trailer!

Master Spy coming to Steam 09/08 + Release Trailer!

Master Spy 2 comments

Master Spy, cinematic stealth platformer, is hitting Steam 09/08!

Master Spy - On Cutscenes

Master Spy - On Cutscenes

Master Spy

A look at the process we use to implement retro cinematic cutscenes into Master Spy.

Demo Update + New PreBeta Trailer

Demo Update + New PreBeta Trailer

Master Spy

Updated Demo with brand new background art + new teaser trailer.

Add game Games
Team Battle 2D

Team Battle 2D

Third Person Shooter

Team Battle 2D: Jin Conception or tb2d for short, is a free to play online multiplayer competitive 2D shooter game.

Vibrant Recycling

Vibrant Recycling


Vibrant Recycling is a Ecological and Educative game using HTML5 where you should help fun bins to collect and recycle wastes thrown during various levels...

Master Spy

Master Spy


A stealth-based precision platformer with old school cutscenes and OST by RAC. You are Master Spy. In a world of corruption and decay, you're not just...

Pipe Animus

Pipe Animus

Role Playing

Pipe Animus will be a full length Indie RPG game that doesn't just appeal to nostalgia. There'll be many, interesting characters, locations and useable...

Neverwell Moor

Neverwell Moor

Role Playing

An entry for the Liberated Pixel Cup 2012. Source code is available under a dual license: MIT and GPL3. Assets are available under CC-BY-SA and GPL3...

Post a comment
Sign in or join with:

Only registered members can share their thoughts. So come on! Join the community today (totally free - or sign in with your social account on the right) and join in the conversation.