steveyen / moddio2

HTML5 multiplayer game engine

Moddio Game Engine 2

Moddio is a multiplayer-first game engine. It can support up to 64 concurrent players hosted on a $5 / month VM while running Box2D physics. Join us on Discord

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)
• Unit AI including A* pathfinding
• Mobile controls
• and more!

Running a game server

Moddio will run games made using modd.io game editor.

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.

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

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 18 or later and then...

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

Connecting to the game server

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

How to create & edit games on modd.io

You must use Moddio Game Editor which is available at https://www.modd.io. To learn how to use the game editor, visit here: https://learn.modd.io

How to contribute

Moddio is completely free and open source under the MIT license, and we are always looking for more contributors. To learn about how to become a contributor, please visit how to contribute page

Credits

Isogenic Game Engine

Phaser

PlanckJS

uWebsocket

Box2D

Kenney Assets

Hero Icons