Ethereal Engine is now Infinite Reality Engine and has been moved!

You can find the project now at https://github.com/ir-engine/ir-engine

Manifest your dreams on the open social spatial web.

Table of Contents

• Table of Contents
• Background
• Demos
• Project API
  • Library of EE Projects
  • Create your own projects
• Launch iR Engine with Control Center Install - RECOMMENDED
  • Use Metaverse Control Plane Managment GUI
• Advanced Development Install
  • Pre-Requisites
  • Getting Started
• Usage
  • Documentation
• Contributing
  • Let's build it together
  • Join our Discord
  • Sponsorship
• License

Background

Universal.Volumetric.Video.Web.Player.mp4

We (Infinite Reality Engine) believe that the Metaverse, Web AR, VR, and XR should be easy.

We want a Star Trek future where participating in immersive communication technology and shared simulations should be as easy and natural as making a website.

• Includes a self-deployable platform, UI, worlds, avatars, and games
• Fully customizable for any kind of game, social experience, event or spatial web app
• User management, avatars and inventory with optional blockchain integration (see our Blockchain-in-a-Box repo)
• Social features like chat, groups, friends, blocking and moderation
• Complete world editing and administration
• 2D, 3D and XR Avatars with full inverse kinematics and facial expressions
• Fully networked physics using Rapier Physics
• Voice and video over WebRTC
• Instant login and location sharing with phone number or email
• Modular- Use the engine, server, client, editor and scalable devops infrastructure as needed
• OAuth login with Facebook, Google, Steam, Github or instant login with email or phone
• WebGL client deployable to iOS, Android and desktop
• Free, open source, CPAL licensed

Demos

Guest Demos

• Apartment - CCO from Sketchfab
• Star Station - our dev coommunity hangout
• Globe Concert Hall - collab with WildCapture.io

Host Demos

• Admin Console - Demo Cluster - Request Demo Access on our Discord
• iR Studio - Demo Cluster - Request Demo Access on our Discord

Project API

Library of EE Projects

Create composable plug-ins for iR Engine experiences with the Projects API

Create your own projects

Launch iR Engine with Control Center Install - RECOMMENDED

Use Metaverse Control Plane Managment GUI

Best for simple self hosting, advanced editor content creation, and XRProject Pack Project development.

Advanced Development Install

Pre-Requisites

To install iR Engine locally, the following pre-reqs are required.

• Linux (many of us develop on Ubuntu), Mac OS X, or Windows (we recommend WSL2)
• Node.js v16 or later (we recommend installing via nvm or asdf.)
• C++ (for node-gyp), Python >=3.6 + PIP, make and other build tools, for compiling Mediasoup. Although most of iR Engine is written in TypeScript, it uses a Mediasoup engine for WebRTC conferencing. See the Mediasoup install instructions for more details.
• Docker. (Although Docker is technically optional, running iR Engine requires starting up half a dozen different services, and using Docker Compose will make your life dramatically easier.)
• MariaDB and Redis. (If you're using Docker, containers for MariaDB and Redis will automatically be started up.)

Getting Started

See the Installation instructions for more details.

Usage

Documentation

• General iR Engine documentation
• Auto-generated (typedoc) API reference
• Avatar, Scene & Asset Pipeline
• Why are we building iR Engine?

Contributing

• We expect contributors and community members to follow our Code of Conduct.
• See the Contributing Guide and corresponding wiki entry for more details.
• Version numbering of the iR Engine monorepo follows the Semantic versioning approach.
• We use the Prettier.io formatter for our code style.
• Standard Readme for the README structure.

Let's build it together

We believe that projects like this are extremely complex and difficult, and can only be built when large groups of people work together, out in the open. If you believe that your calling is to build a free, open network that everyone, everywhere can get value from, then you are welcome in our community, and we'll do our best to get you set up.

We are always hiring talented people who want to be leaders in what is to come. Inquire with anyone who seems like they know what's going on and they'll help you find who you need to talk to.

Join our Discord

Sponsorship

License

CPAL - Copyright (c) 2021-2024 Infinite Reality. iR Engine, formerly known as Ethereal Engine and XREngine

If you wish to use iR Engine under the open-source CPAL license, attribution is required. Please see attribution guidelines in the LICENSE file. Other licensing options are available, please contact us for more information.

Release History and Author Archive