Taro

A lightweight 3D game engine for the web.

Cloud9c/tarowww.echou.xyz/taro/

README

Taro


GIF

A lightweight 3D game engine for the web. Built with three.js and cannon-es.

⚛️ Physics - Full integration with a 3D rigid-body physics engine.
🔌 Entity Component System - Write efficent and extendable code.
🔊 Sound - 3D positional sounds built on the Web Audio API.
📜 Scripts - Design game behaviors in JavaScript.
⚡ Performance - Taro is a thin framework on top of three.js.

Documentation


You can find the Taro documentation on the website.

Usage


There are several examples on the website. Here is an example to get started:
  1. ``` js
  2. var app = new TARO.App();
  3. document.body.appendChild( app.domElement );

  5. var scene = new TARO.Scene();
  6. app.setScene(scene);

  8. class CubeController {
  9.   init() {
  10.     // fires when the component is attached to an entity
  11.     this.rotation = this.entity.rotation;
  12.   }

  14.   update() {
  15.     // fires once per frame
  16.     this.rotation.x += 0.01;
  17.     this.rotation.y += 0.01;
  18.   }
  19. }

  21. TARO.registerComponent('cubeController', CubeController);

  23. var cube = new TARO.Entity('cube');
  24. cube.addComponent('material', { color: 0x00ff00 });
  25. cube.addComponent('geometry', { type: 'box' });
  26. cube.addComponent('cubeController');

  28. var camera = new TARO.Entity('camera');
  29. camera.position.z = 5;
  30. camera.addComponent('camera');

  32. app.start();
  33. ```

This example will display a spinning cube on the canvas.

Builds


* (ESM)* (UMD)* (UMD minified)

Editor


In addition to the engine, there is a visual editor available to get a taste of Taro.

License

MIT License