Platform support
Awaken for Unreal has been built and checked on one configuration: macOS on Apple silicon with Unreal Engine 5.9. This page states what works there, what is known not to work elsewhere, and what has not been verified.
Summary
| Part | macOS (Apple silicon) | Windows | Linux |
|---|---|---|---|
| AwakenDebug plugin: HUD and NPC file | Tested with Unreal Engine 5.9 | Not yet verified | Not yet verified |
Project daemon publishing the npcs slice | Tested end to end | Not yet verified | Not yet verified |
| Awaken app: roster and inspector | Tested | Not yet verified | Not yet verified |
| Awaken app: overlay attached to the game window | Yes | Not supported yet | Not supported yet |
| Awaken app: mouse reaches the game outside Awaken’s panels | Yes | No. Pin the overlay to play. | No. Pin the overlay to play. |
| Awaken app: Browse… folder picker | Yes | No | No |
The overlay by platform
| Platform | Attach to the game window | Mouse |
|---|---|---|
| macOS | Yes. | Clicks reach the game everywhere except over Awaken’s own panels. Pin makes the whole overlay click-through. |
| Windows, Linux | Not supported yet. The overlay is a floating always-on-top panel on the primary monitor, and says so. | While interactive, the overlay takes all mouse input on that monitor. Pin it to play. |
On macOS the overlay is also a floating panel whenever no editor or game is running the project, or its window is not on screen. It attaches by itself when the window appears.
What was checked, and how
| Check | How |
|---|---|
| Game to file to daemon | A repeatable script on a real Unreal Engine 5.9 game, with no window: it builds the Floppy Bird tutorial, runs it headless with its pilot, checks the file on every read for six seconds, compares the daemon’s npcs slice with the file, then stops the game and waits for the slice to empty. |
| In-game HUD | By hand, in a 960 by 540 -game window of Floppy Bird on macOS. |
| Overlay attaching to the game window | By hand on macOS. |
Not yet verified
- Windows and Linux, for every part.
- Unreal Engine 5.8 with AwakenDebug.
- Packaged development builds. A packaged game writes under its own project directory, which may not be where Awaken looks.
- The editor’s Awaken NPCs tab contents.
- The Gameplay Debugger’s Awaken category on screen.
Awaken.Dumpwith live rows.- A populated QA strip in the overlay.
- The overlay following a window during a live drag.
- The HUD’s automatic text scale on a 4K display.
Packages
Awaken can be packaged from source for each platform. The packages have these limits:
| Platform | Output | Limit |
|---|---|---|
| macOS | Awaken.app, a .dmg and a .zip | Signed ad hoc only and not notarized, so Gatekeeper warns on other Macs. |
| Linux | A folder and a .tar.gz | No installer. |
| Windows | A folder and a .zip | No installer. |
Next steps
Last updated on