Skip to main content

​
Loading into CS2

After building Osiris, you need to inject (load) the library into the running Counter-Strike 2 process. The injection method differs between Windows and Linux.
VAC Detection Risk: Using any injection method carries the risk of VAC (Valve Anti-Cheat) detection. Use at your own risk. A VAC ban is permanent and cannot be removed.

​
Before you begin

Ensure you have:
  1. Successfully built Osiris for your platform
  2. Counter-Strike 2 installed and running
  3. The appropriate injection tool for your platform

​
Windows injection

On Windows, you need a DLL injector to inject Osiris.dll into the CS2 process.

​
Important limitations

Counter-Strike 2 blocks the standard LoadLibrary injection method. You must use a manual mapping (reflective DLL injection) injector.
Known detected injectors:
  • Xenos is detected by VAC
  • Extreme Injector is detected by VAC
Do not use these tools or you will receive a VAC ban.

​
Injection steps

1

Launch Counter-Strike 2

Start the game and wait until you are in the main menu or in a match.
2

Open your injector

Launch your manual mapping DLL injector with administrator privileges.
Administrator privileges are required to inject into game processes.
3

Select the process

In the injector, select the cs2.exe process from the process list.
4

Select the DLL

Browse and select the Osiris.dll file you built in the previous step.Typical location:
x64/Release/Osiris.dll
5

Inject with manual mapping

Ensure your injector is set to use manual mapping or reflective injection mode.Click the inject button.
6

Verify injection

If successful, the Osiris GUI should appear in the game. Press Insert to open the menu.

​
Choosing a safe injector

When selecting a DLL injector:
  • Use injectors that support manual mapping/reflective injection
  • Prefer open-source injectors where you can review the code
  • Avoid injectors known to be detected by VAC
  • Research the injector’s detection history in cheat communities
The developers do not recommend or endorse any specific injector. All injection carries risk.

​
After injection

Once Osiris is successfully loaded:
  1. Press Insert to open the Osiris GUI
  2. Navigate through the tabs: Combat, HUD, Visuals, Sound
  3. Configure features according to your preferences
  4. Settings are automatically saved to disk

​
Configuration location

Settings are stored in:
  • Windows: %appdata%\OsirisCS2\configs\default.cfg
  • Linux: $HOME/OsirisCS2/configs/default.cfg

​
Troubleshooting

​
Injection fails

  • Process not found: Ensure CS2 is running before attempting injection
  • Permission denied: Run the injector with administrator/sudo privileges
  • Wrong architecture: Verify you built the x64 version, not x86

​
Game crashes

  • Incompatible build: Ensure you used the Release build configuration
  • Game update: CS2 updates may break Osiris; wait for an updated version
  • Conflicting software: Disable other overlays or game modifications

​
GUI doesn’t appear

  • Wrong key: Try pressing Insert or Home to open the menu
  • Injection failed: Check injector logs for error messages
  • Panorama issue: Restart the game and try again

​
Next steps

Explore Osiris features:

Build docs developers (and LLMs) love

Get started for freeTalk to us