Dzoge / hero-engine

Open-source HTML5 adventure game engine

Hero Engine

The Hero Engine aims to be an open-source HTML5 adventure game creation engine based on Tiled and Phaser3.

We're calling it a meta-engine because it is not a full game engine on it's own, but a layer on top of Phaser3 that makes it easy to create Adventure Games. The engine will provide game developers with an integration between Tiled and Phaser3 that will allow for easy adventure-game-like level creation. As well as common functions and UI elements that are common among all adventure games. If you're not sure what an adventure game is, Monkey Island, is a great example of the adventure game genre.

This engine will be used to create "Command Line Heroes: The Game" announced on Episode 1 of Season 2 of the Command Line Heroes Podcast. See more about the game below.

We are creating a new engine because we couldn't find any existing open source HTML5 adventure game creators out there. But if you know of any open source adventure game engines for the web let us know!

Install

npm install

Examples

npm run examples

Contribute

Everyone is invited to contribute to this project. All types of contributions are welcome. We share the same inclusivity values of the P5.js community.

Before we can start work on the actual Command Line Heroes adventure game we need to complete at least the first two milestones listed below. The best way you can help right now is by working on one of the issues in the Reference Room milestone.

We are also learning Phaser3 and Tiled as we go so the The Reference Room is a proof of concept for the base level features we need for a bare bones adventure game organized into a series of examples.

Milestones

1. Reference Room - Base level room
2. UI Functions - common functions across adventure games
3. Advanced functions - Dialogs, command line interpreter, transitions

Guides & Docs

This project is built on top of two main tools: Tiled and Phaser3. Here are some useful guides and docs for each.

Tutorials:

• Tiled tutorial series
• Phaser3 Tutorial
• Phaser3 Examples

Docs:

• Tiled Docs
• Phaser3 Docs

How to get Help

1. Post a question in the repo issues
2. Ask a question in real-time in our public Discord server
3. Send a tweet to one of the twitter links below social

Community

Join our public Discord server!

Social

• Jared Sprague @caramelcode
• Michael Clayton @mwcz
• Command Line Heroes
• #CommandLinePod

Command Line Heroes: The Game

The Hero Engine is being built alongside Command Line Heroes: The Game, an adventure game based on themes from the Command Line Heroes podcast.

• Future git repo for the game: clh-the-game
• Interview about the game: https://www.redhat.com/en/blog/command-line-heroes-game