Skip to content
DirectX API-hooking framework
C++ C PowerShell Shell C#
Branch: master
Clone or download
Pull request Compare This branch is 433 commits ahead, 16 commits behind agrippa1994:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

Indicium-Supra

API-Hooking and rendering framework for DirectX-based games.

Build status Discord Website PayPal Donate Support on Patreon GitHub followers Twitter Follow

About

Indicium-Supra consists of a self-contained library (DLL) which exposes a minimalistic API for rendering custom content in foreign processes eliminating the need for in-depth knowledge about Direct3D and API-hooking. The most common use-case might be drawing custom overlays on top of your games. The framework takes care about pesky tasks like detecting the DirectX version the game was built for and supports runtime-hooking (no special launcher application required).

Supported DirectX versions

  • DirectX 9.0
  • DirectX 9.0 Extended (Vista+)
  • DirectX 10
  • DirectX 11
  • DirectX 12 (implemented but untested)

How to build

Prerequisites

  • Visual Studio 2017 (Community Edition is just fine)
  • Windows SDK
  • .NET Core SDK 2.1 (or greater, required for building via CLI only)
  • Follow the Vcpkg Quick Start and install the following packages:
    • .\vcpkg install spdlog:x86-windows-static spdlog:x64-windows-static detours:x86-windows-static detours:x64-windows-static
    • For the ImGui sample to build you'll also need:
      • .\vcpkg install imgui:x86-windows-static imgui:x64-windows-static

Building should be pretty straight-forward since the dependencies get installed via Vcpkg. You have multiple choices for getting things done.

Visual Studio

Just open the solution file Indicium-Supra.sln and start the build from there.

Command Line

Navigate to the solution directory on the command line and invoke:

powershell .\build.ps1

The lazy way

Now if you're really in a hurry you can grab pre-built binaries from the buildbot. Boom, done.

How to use

Inject the resulting host library (e.g. Indicium-ImGui.dll) into the target process first using a DLL injection utility of your choice (you can ofc. use mine as well). The following example loads the imgui sample:

.\Injector -i -n hl2.exe Indicium-ImGui.dll

Just make sure your host library doesn't require any external dependencies not present in the process context or you'll get a LoadLibrary failed error.

Diagnostics

The core library logs its progress and potential errors to the file %TEMP%\Indicium-Supra.log.

Demos

The following screenshots show imgui getting rendered in foreign processes using different versions of DirectX.

DirectX 9

Half-Life 2, 32-Bit

Half-Life 2

DirectX 9 Ex

Castlevania: Lords of Shadow, 32-Bit

Castlevania: Lords of Shadow

DirectX 10

Bioshock 2, 32-Bit

Bioshock2_2017-08-10_14-48-38.png

DirectX 11

Ryse: Son of Rome, 64-Bit

Ryse_2017-08-09_21-48-57.png

Road Redemption, 64-Bit

RoadRedemptionEarlyAccess_2017-08-14_14-06-21.png

Sources

You can’t perform that action at this time.