Immutable SDK for Unreal Engine
Documentation
Plugin Maintainers' Guide
Prerequisites
- git
- Unreal Engine installed from the Epic Games Launcher or built from the source code. Make sure to check the list of currently supported Unreal Engine versions.
- Microsoft Visual Studio. It is crucial to have a compatible version of Visual Studio installed. Please refer to the official documentation of Unreal Engine.
Getting Started
See documentation on how to install the plugin, with one caveat: If you want to open the project and plugin in an IDE you'll need to create your Unreal project as a C++ project. If you've already accidentally created your Unreal project as BluePrint-only you can convert it to a BluePrint-and-C++ project by adding any C++ class from the Add New C++ Class option in the Unreal Editor's File menu.
Debugging the Embedded Browser
Embedded Browser Logs
See Saved/Logs/cef3.log in your Unreal project.
JS Console Output
In Unreal Engine 5.1+ the project is set up so that console.log() will pass all the way through to the Unreal console. This isn't available in UE5.0 and earlier but you can still use Chromium's remote debugging (see below).
Remote Debugging
To set up Chromium remote debugging, edit project build/launch configurations in your IDE to add the following program command-line argument to the appropriate configurations: cefdebug=9222
Next, launch the game and then open a separate Chrome/Chromium browser and navigate to chrome://inspect where your app should be listed, sometimes intermittently or after a delay, under the Remote Target #localhost section. Click inspect to launch the remote debugging session.
Release Unreal Immutable SDK Plugin
- Release the plugin using GitHub releases. See https://github.com/immutable/unreal-immutable-sdk/releases
BLUI Plugin
For Unreal Engine versions 4.26, 4.27, and 5.0, we use the BLUI plugin because Epic's WebBrowserWidget plugin is incompatible with this SDK due to its reliance on an older version of CEF.
Please follow the installation instructions to install the Immutable BLUI plugin.
Contributing
Thank you for your interest in contributing to our project! Here's a quick guide on how you can get started:
- Fork this Repository: Fork the repository to your GitHub account by clicking the "Fork" button at the top right of the repository page.
- Create a Branch: Once you've forked the repository, create a new branch in your forked repository where you'll be making your changes. Branch naming convention is enforced according to patterns here.
- Make Changes: Make the necessary changes in your branch. Ensure that your changes are clear, well-documented, and aligned with the project's guidelines.
- Commit Changes: Commit your changes with clear and descriptive messages following commit message pattern here. It follows Conventional Commits specification, which helps maintain a consistent and informative commit history. Read here to learn more about the benefits of Conventional Commits.
- Create a Pull Request (PR): After you've made and committed your changes, create a PR against the original repository. Provide a clear description of the changes you've made in the PR.
- Example Contribution: Refer to this contribution as an example.
Getting Help
Immutable X is open to all to build on, with no approvals required. If you want to talk to us to learn more, or apply for developer grants, click below:
Project Support
To get help from other developers, discuss ideas, and stay up-to-date on what's happening, become a part of our community on Discord.
You can also join the conversation, connect with other projects, and ask questions in our Immutable X Discourse forum.
Still need help?
You can also apply for marketing support for your project. Or, if you need help with an issue related to what you're building with Immutable X, click below to submit an issue. Select I have a question or issue related to building on Immutable X as your issue type.
License
Immutable Unreal SDK repository is distributed under the terms of the Apache License (Version 2.0).