three-game-engine

!NPM Version
[![MIT License][license-shield]][license-url]
[![Stargazers][stars-shield]][stars-url]
[![Forks][forks-shield]][forks-url]
[![Contributors][contributors-shield]][contributors-url]
!NPM Downloads

[contributors-shield]: https://img.shields.io/github/contributors/WesUnwin/three-game-engine.svg?style=for-the-badge
[contributors-url]: https://github.com/WesUnwin/three-game-engine/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/WesUnwin/three-game-engine.svg?style=for-the-badge
[forks-url]: https://github.com/WesUnwin/three-game-engine/network/members
[stars-shield]: https://img.shields.io/github/stars/WesUnwin/three-game-engine.svg?style=for-the-badge
[stars-url]: https://github.com/WesUnwin/three-game-engine/stargazers
[license-shield]: https://img.shields.io/github/license/WesUnwin/three-game-engine.svg?style=for-the-badge
[license-url]: https://github.com/WesUnwin/three-game-engine/blob/main/LICENSE.txt

!Logo

About The Project

This library simply ties together several well known, very capable javascript libraries resulting in a powerful yet simple game engine. These dependencies are minimal and fully open-source.

* Three.js - a 3D WebGL-based Graphics Engine
* Rapier - a 3D Physics Engine
* three-mesh-ui - Lets you build 3D user interfaces in Three.js

!Screenshot

Although a web-first game engine, you can very easily package and distribute apps/games using this as desktop apps or mobile using electron, cordova or other libraries (examples of how to do this are included in the examples/ folder).

(back to top)

$3

This engine is open source, light weight, very readable (seriously check out the source code :) ), it's totally free and allows you to use tools and techniques that web developers are familiar with like javascript/typescript/webpack/json files/etc. Furthermore its very actively maintained and gaining momentum. It's great for rapid prototyping, and developers familiar with three.js and web tools will transition into this quickly.

Why not just use Three.js?
- ThreeJS is designed to be a graphics engine, its stops short of providing all the things games need:
- Asset management
- Input aggregation and abstraction
- User interfaces
- Physics
- Other utilities (eg. Character Controllers, A.I. Path Finding, etc.)

Compared to the Three.js scene editor:
- This allows you to compose and manage a game with multiple scenes
- Allows you to generalize GameObjects into types (prefabs)
- Externalizes and allows for re-use of assets like gltfs, textures, sounds, etc.
- Allows you to control the physics characteristics of game engines.

(back to top)

$3

* To provide a web-first game engine, for developers that love javascript/typescript (but with support for building desktop and mobile apps)
* to offer a 100% free engine that can be used by anyone to build personal or comercial apps/games.
* maintain source code that is highly readable, and extendable
* to offer VR support

(back to top)

Scene Editor

This game engine comes with a well-equiped scene editor that allows you to compose scenes with game objects.

Your game and scenes are described by a project folder containing .json files that can be manually edited or opened in the scene editor.

The scene editor also allows you to quickly boilerplate a new project also.

You can run the scene editor locally by cloning this repo and:
``sh
npm install
npm run scene_editor
`

OR

Use the online scene editor here

!Scene Editor

(back to top)

Architecture

Distributed under the MIT License. See LICENSE.txt` for more information.

(back to top)

Contact

Wes Unwin - wes_unwin@hotmail.com

Project Link: https://github.com/WesUnwin/three-game-engine

(back to top)