/taro

Taro is a multi-player-first, cross-platform 2D HTML5 game engine.

Primary LanguageJavaScriptMIT LicenseMIT

Taro Engine logo

2D HTML5 Multiplayer Game Engine.

Taro is a multi-player-first, cross-platform 2D HTML5 game engine. It can support up to 64 concurrent players hosted on a $5/month VM while running box2d physics. Join us on Discord or support us on Patreon

Demo

demo

What's included in the box

  • Box2D Physics
  • Netcode using UWS and LZ-string compression
  • Inventory & item system
  • Unit attributes (HP, Energy, etc)
  • Weapon system (melee & projectile)
  • Dialogues
  • Shops
  • Unit control (top-down WASD or platformer)
  • Client-side predicted projectile + unit movement (optional)
  • Basic AI
  • Mobile controls
  • and more!

Node version

Node versions above 12 are not currently supported due to a downstream dependency (clusterws)

How to run a game server

Taro engine will run games made using modd.io.

To run the game server, execute the following command:

npm run server --game=<gameID>

*if the gameID argument is not provided, then the engine will use game.json stored in root directory instead.

Your game's Game ID can be found in your modd.io's game's sandbox (example). Go to menu -> about.

How to get game id

Quick start example - Run "Two Houses" locally

Install Node 12 and then...

git clone https://github.com/moddio/taro.git
cd taro
npm install
npm run server --game=5a7fd59b1014dc000eeec3dd

Connecting to the game server

Visit http://localhost:2000 to start testing game.

How to customize game client UI

Game client's user interface is rendered by /src/index.ejs file and the theme files in /src/templates/

How to make games on modd.io

Please visit https://www.modd.io/tutorials for more information

We need contributors, and we are also hiring

Performance optimization is a hard problem that takes aeons to solve. We are always looking for more developers to help us. To be a contributor, please contact m0dE in our Discord If you find yourself enjoying working with us, then we should seriously consider working together.

Taro is completely free and open source under MIT license.

Taro Engine was originally forked from Isogenic Game Engine back in 2016