SkyLoader is an open-source Windows launcher, injector, and local DLL manager for Sky: Children of the Light. It manages plugin lifecycle, process watching, and rapid in-game UI prototyping.
SkyLoader.exe
├── Win32 settings UI & process watcher
├── LoaderController & injector
└── SkyLoader.ini
Sky.exe
├── Native Vulkan Engine (Untouched presentation path)
└── SkyBootstrap.dll (Core In-Process Kernel)
├── Named-pipe IPC server & VEH exception shield
└── Loaded plugin DLLs
├── SkyOverlay.dll (Open-source D3D11 + ImGui canvas & mod hub)
│ ├── In-game Plugin Manager UI
│ ├── Per-plugin dedicated hotkeys & auto-wakeup
│ └── Community plugin ImGui render callbacks
└── Independent / native plugins (e.g., SkyToolkit)
git clone https://github.com/HerokeyVN/SkyLoader.git
cd /SkyLoader
mingw32-make clean
mingw32-make allOutputs:
dist\SkyLoader.exe
dist\SkyBootstrap.dll
dist\SkyOverlay.dll
To create the installer after building:
iscc installer\SkyLoader.iss- Run
SkyLoader.exe. - Verify the Sky path, then add 64-bit plugin DLLs (such as
SkyOverlay.dllor custom mods). - Select Launch Sky. SkyLoader starts the game through Steam and waits for
Sky.exe. - Bootstrap is injected and loads registered plugins via named pipes.
SkyLoader's process watcher also catches Sky started directly from Steam. Use Inject selected to ask the running Bootstrap host to load one plugin again.
SkyLoader checks the latest GitHub release on startup and also exposes Check Updates in the toolbar. When a newer release exists, it downloads the release .exe into %LocalAppData%\SkyLoader\updates and can start that downloaded updater directly.
For plugins requiring an in-game user interface (Dear ImGui), SkyLoader bundles SkyOverlay, an open-source companion library providing:
- A non-invasive transparent Direct3D 11 canvas with zero Vulkan hooking (safe on all GPU architectures, including AMD Radeon).
- An in-game SkyOverlay Plugin Manager for per-mod toggles (
[x]) and hotkey rebinding (F1-F12,Home,NumPad). - Public C ABI (
skyoverlay_api.h) allowing plugins to register ImGui render callbacks in just a few lines of code.
The kernel contract is defined in libraries/SkyBootstrap/include/skybootstrap_api.h.
Every plugin must export:
SkyPluginInit(const SkyBootstrapApi*)SkyPluginShutdown() is optional.
SkyLoader identifies managed plugins by a stable SkyPluginId in the DLL's
Windows VERSIONINFO resource, not by its filename. This lets a new build such
as my-mod-1.4.dll automatically replace an installed release.dll when both
declare the same ID.
Add these string values to the plugin's version resource:
VALUE "SkyPluginId", "example.author.my-mod\0"
VALUE "Version", "1.4.0\0"
SkyPluginId is case-insensitive and may contain letters, numbers, ., _,
and -. It is the permanent package identity: never change it between
releases. SkyLoader reads this resource directly from disk and never loads a
DLL while importing it. A matching ID with an equal or newer version replaces
the managed entry automatically and removes the previous managed DLL after the
new copy succeeds. A lower version is not installed automatically. DLLs without
this metadata retain the legacy filename-based replace prompt.
The display fields are PluginName, Version, Author, and Description.
SkyLoader continues to read the older Windows names (ProductName,
ProductVersion, CompanyName, and FileDescription) as a compatibility
fallback.
See Creating a SkyLoader plugin for a complete DLL, resource, build, import, and update example.
Bootstrap writes SkyBootstrap.log to %LOCALAPPDATA%\SkyLoader\logs\SkyBootstrap.log. If that directory cannot be created, it falls back to writing the log next to SkyBootstrap.dll. If a plugin fails to load, check that the managed DLL exists at the path recorded in SkyLoader.ini, that both DLLs are 64-bit, and that the configured GamePath is the running Sky executable.
SkyLoader builds upon ideas and pioneering research from the Sky PC modding community:
- Lukas (
sml-pc): Original Sky mod loader research, early injection concepts, and DLL proxy architecture. - XeTrinityz (
ThatSkyLoader): Rapid ImGui plugin rendering concept, in-game menu workflow, and community modding ergonomics. - MrGatto: Named Pipe IPC design and robust remote injection patterns.
- HerokeyVN: Multi-architecture loader design, SkyLoader orchestration, and SkyOverlay architecture.
- Dear ImGui (Omar Cornut): Bloat-free immediate mode graphical user interface library for C++.
Made with ❤️ for the Sky: Children of the Light community.