JavaScript HTML CSS
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md




Blacksmith 2D




BLACKSMITH 2D

Black is a highly optimized 2D framework for web, mobile games, and playable ads.

Most valuable when size matters
All engine code is written in ES6, fully GCC typed, allowing to eliminate all dead code from your app. For example the size of Donuts game is only 33KB gzipped for both engine and game code.

Advanced scene graph and rendering pipeline
Dirty flag tracks scene changes and avoids unnecessary calculations and context calls. If no changes were made to the scene since last frame, no rendering will be done. Battery efficient.

Cache as bitmap
Automatically detects changes and updates bitmap cache. Allows to gain even more performance on heavy scenes and runs smoothly on old devices.

For more information about how to use Black Engine, please check the Blacksmith 2D website.

FEATURES

✔️ Extra lightweight
✔️ Display Resolution Awareness
✔️ Tweens
✔️ Message Dispatcher
✔️ Advanced Particle System
✔️ Sprite Animations
✔️ Asset Manager
✔️ Advanced Font Rendering and font metrics
✔️ Texture Atlas
✔️ Input
✔️ Clipping Rectangle
✔️ Component System
✔️ Audio Support
✔️ Audio Atlases
✔️ Bitmap Fonts
✔️ Graphics
✔️ Battery Efficient
✔️ Smart Cache As Bitmap
✔️ Render Texture
✔️ GCC Ready

GETTING STARTED

The easiest way to start using Black Engine is by downloading ready-up game template:

git clone https://github.com/MassiveHeights/Black-Template
cd Black-Template
npm install
npm start

Then open http://127.0.0.1:4245 in browser!

SIZE AND PERFORMANCE COMPARISON

A Piggy Mark was made to compare basic sprite rendering performance and build size.

Engine 60 FPS 50 FPS 40 FPS 30 FPS Size kB Load Time sec.*
Black 4410 5070 6285 9210 40 2,2
Phaser v2 3265 3750 4580 6210 207 17.7
Phaser v3 2970 3470 4530 6190 217 17.8

All tests are made on iPhone 6s Safari.
* How much time it takes to load a test. Tested using UPTRENDS on iPhone 8 with bandwidth of 3G.

SUPPORT

Feel free to chat with developers directly on Facebook, Discord or Telegram. Have other questions? Feel free to contact support by email. Remember to check Documentation before asking questions.

CONTRIBUTING TO BLACK ENGINE

Written something cool using Black Engine? Please tell us about it via email.
Found a bug or issue — post them on Issues page.

QUICK LINKS

Getting StartedExamplesGame TemplateEULA