How dpjudas/surrealengine works
Project type and purpose
• Surreal Engine is a monolithic, cross-platform C++ game engine meant to reimplement Unreal Engine 1. It can load UE1 game packages, run the Unrealscript VM, render maps via Vulkan, play audio, and host editor/debugger tools.
File structure
• Top‐level build: CMakeLists.txt, .github/workflows, LICENSE, README.
• Engine code under “SurrealEngine/”: modular subsystems—Audio, Collision (physics), Commandlet (batch tools), DebuggerApp, Editor, GC (garbage collection), Math, Native (C++ side of Unreal objects), Package (I/O), Render (scene traversal), RenderDevice/Vulkan (low-level GPU), UObject (game object model), Utils (helpers), VM (Unrealscript interpreter).
• UI layer under “SurrealEngine/UI/”: Launcher, Editor windows, error dialogs built on ZWidget (third-party).
• Executables produced: SurrealEngine (game runtime), SurrealEditor, SurrealDebugger.
• Third-party libraries: ZVulkan (Vulkan loader + GLSLang), ZWidget (UI toolkit), OpenAL-Soft (audio backend), SDL2/Wayland/DBus (windowing), mux of codecs (dr_flac, stb_vorbis, miniz, etc).
README for additional insights
• Confirms use of Vulkan, SDL2 (windowing), optional Wayland or native backends.
• Lists command-line interface for selecting maps, engine version, game folder.
• Describes three executables and runtime dependencies.
Elements
• Green for engine subsystems
• Blue for UI/tools
• Gray for third-party dependencies
• Orange for core foundation (PackageManager, VM, GC)