Ambient

Ambient is a WebAssembly runtime for building high-performance online games and 3D applications.

Features

• Seamless networking: Ambient is both your server and client. All you need to do is to build your server and/or client-side logic: the runtime handles synchronization of data for you.
• Isolation: Projects you build for Ambient are executed in isolation through the power of WebAssembly - so that if something crashes, it won’t take down your entire program. It also means that you can run untrusted code safely.
• Data-oriented design: The core data model of Ambient is an entity component system which each WASM module can manipulate.
• Multilingual: You will be able to build Ambient modules in any language that can compile to WebAssembly. At present, Rust is the only supported language, but we are working on expanding to other languages.
• Single executable: Ambient is a single executable which can run on Windows, Mac and Linux. It can act as a server or as a client.
• Interoperability: Ambient allows you to define custom components and "concepts" (collections of components). As long as your Ambient projects use the same components and concepts, they will be able to share data and interoperate, even if they have no awareness of each other.
• Asset pipeline and streaming: Ambient has an asset pipeline that is capable of compiling multiple asset formats, including .glb and .fbx. The assets are always streamed over the network, so your clients will receive everything they need when they join.
• Powerful renderer: The Ambient renderer is GPU-driven, with both culling and level-of-detail switching being handled entirely by the GPU. By default, it uses PBR. It also supports cascading shadow maps and instances everything that can be instanced.

See the documentation for a getting started guide, or browse the examples.

Installing

If you have a recent Rust toolchain (stable is sufficient), you can install Ambient using the following command:

sh cargo install --git https://github.com/AmbientOrg/Ambient.git --tag v0.0.16 ambient

At present, a Git-based cargo install is required for the runtime. We are working on removing this requirement.

See installing for more details.

Roadmap

Note: Ambient is in an alpha stage and the API will be iterated on heavily. We are working towards a stable release.

| Feature | Status | Notes | | ----------------------- | ------ | -------------------------------------------------------------------------------------------------------------------- | | ECS | ✅ | | | WASM API | ✅ | Rust is the only supported client language right now. | | Multiplayer/networking | ✅ | | | GPU-driven renderer | ✅ | | | FBX & GLTF loading | ✅ | | | Physics (through PhysX) | ✅ | | | Animations | ✅ | | | Skinmeshing | ✅ | | | Shadow maps | ✅ | | | Decals | ✅ | | | GPU culling and LoD | ✅ | | | Multi-platform | ✅ | Windows, Mac and Linux so far. | | Run on Web | 🚧 | | | Client-side API | 🚧 | | | Multithreading API | 🚧 | Multithreading is used internally already, but we want to expose multithreading functionality within the WASM API. | | UI API | 🚧 | A React-like UI library already exists in the repo, and we're working on exposing it through the WASM API. | | Custom shaders | 🚧 | Custom shaders are supported by the renderer, but not yet exposed in the API. | | Hot-reloading assets | 🚧 | | | Audio | 🚧 | Audio is supported, but not currently exposed. | | ECS save/load | 🚧 | |

Examples

Each example in the examples directory can be run with Ambient:

• cd guest/rust/examples/tictactoe
• ambient run

Every example can also be run in multiplayer mode, but may not have any multiplayer-specific behaviour. To do so:

• cd guest/rust/examples/tictactoe
• ambient serve

This will start a server that other people can join:

• ambient join [IP_OF_SERVER]

Note that content is always streamed so the only thing the joining user requires is Ambient itself to join the session.

Contributing

We welcome community contributions to this project.

Please talk with us on Discord beforehand if you'd like to contribute a larger piece of work.

License (MIT)

Ambient is licensed under MIT. See the LICENSE.