/taro2

Primary LanguageJavaScriptMIT LicenseMIT

Taro Engine logo

HTML5 Game Engine

Taro is a multiplayer 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


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 below 14 are not supported due to package incompatibility and degraded performance.

Running a game server

Taro engine will run games made using modd.io.

To run the game server, execute the following command:

npm run server

*The engine will use game.json stored in /src directory.

You can download Game JSON from your modd.io's game's in-game editor. Go to Editor -> Click Export JSON.

How to get game json in game's in-game editor

Alternatively, you can download Game JSON from your modd.io's game's sandbox. (example). Go to Menu -> Click Export JSON.

How to get game json in game's sandbox

Next, rename the downloaded Game JSON as game.json and move it to the ./src directory.

Quick start example - Run "Two Houses" locally

Install Node 14 or later and then...

git clone https://github.com/moddio/taro2.git
cd taro2
npm install
npm run server

Connecting to the game server

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

Compiling game.js for faster loading

Once you make changes, run

npm run build

and edit /src/index.ejs file, and comment

<script type="text/javascript" src="/engine/loader.js"></script>

and uncomment

<script type="text/javascript" src="./game.js"></script>

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 the MIT license.

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