1.74.0-custom.4 • Published 9 months ago

@the-mirror-gdp/mirror-core v1.74.0-custom.4

Weekly downloads
-
License
MIT
Repository
github
Last release
9 months ago

Mirror Core: Game Engine

Open-source game engine built on PlayCanvas. It uses HTML5, WebGL, and WebGPU to run games and other interactive 3D content in any mobile or desktop browser.

Project Showcase

Many games and apps have been published using the underlying engine, PlayCanvas. Here is a small selection:

Seemore After The Flood Casino
Swooop dev Archer Flappy Bird
Car Star-Lord Global Illumination

Users

The underlying engine is used by leading companies in video games, advertising and visualization such as:
Animech, Arm, BMW, Disney, Facebook, Famobi, Funday Factory, IGT, King, Miniclip, Leapfrog, Mojiworks, Mozilla, Nickelodeon, Nordeus, NOWWA, PikPok, PlaySide Studios, Polaris, Product Madness, Samsung, Snap, Spry Fox, Zeptolab, Zynga

Features

Fully featured:

  • 🧊 Graphics - Advanced 2D + 3D graphics engine built on WebGL 1 & 2.
  • 🏃 Animation - Powerful state-based animations for characters and arbitrary scene properties
  • ⚛️ Physics - Full integration with 3D rigid-body physics engine ammo.js
  • 🎮 Input - Mouse, keyboard, touch, gamepad and VR controller APIs
  • 🔊 Sound - 3D positional sounds built on the Web Audio API
  • 📦 Assets - Asynchronous streaming system built on glTF 2.0, Draco and Basis compression
  • 📜 Scripts - Write game behaviors in Typescript or JavaScript

Usage

Here's a super-simple Hello World example - a spinning cube!

import * as mc from 'the-mirror-gdp/mirror-core';

const canvas = document.createElement('canvas');
document.body.appendChild(canvas);

const app = new mc.Application(canvas);

// fill the available space at full resolution
app.setCanvasFillMode(mc.FILLMODE_FILL_WINDOW);
app.setCanvasResolution(mc.RESOLUTION_AUTO);

// ensure canvas is resized when window changes size
window.addEventListener('resize', () => app.resizeCanvas());

// create box entity
const box = new mc.Entity('cube');
box.addComponent('model', {
  type: 'box',
});
app.root.addChild(box);

// create camera entity
const camera = new mc.Entity('camera');
camera.addComponent('camera', {
  clearColor: new mc.Color(0.1, 0.2, 0.3),
});
app.root.addChild(camera);
camera.setPosition(0, 0, 3);

// create directional light entity
const light = new mc.Entity('light');
light.addComponent('light');
app.root.addChild(light);
light.setEulerAngles(45, 0, 0);

// rotate the box according to the delta time since the last frame
app.on('update', (dt) => box.rotate(10 * dt, 20 * dt, 30 * dt));

app.start();

How to build

Ensure you have Node.js 18+ installed. Then, install all of the required Node.js dependencies:

npm install

Now you can run various build options:

CommandDescriptionOutputs To
npm run buildBuild all engine flavors and type declarationsbuild
npm run docsBuild engine API reference docsdocs