- 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.
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.
See Saved/Logs/cef3.log in your Unreal project.
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).
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 the plugin using GitHub releases. See https://github.com/immutable/unreal-immutable-sdk/releases
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.
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.
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:
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.
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.
Immutable Unreal SDK repository is distributed under the terms of the Apache License (Version 2.0).