🦵 gmcl_rekinect

This is a reimplementation of Kinect support for Garry's Mod, allowing you to do stuff like this on more platforms.

Features

• Support for the Xbox 360 Kinect
• Support for the Xbox One Kinect (thank you @figardo for letting me borrow one!)
• Support for the x86-64 branch of Garry's Mod
• Introduces the following extra bones from the Xbox One Kinect:

SENSORBONE.SPINE_BASE = 20
SENSORBONE.NECK = 21
SENSORBONE.SPINE_SHOULDER = 22
SENSORBONE.HAND_TIP_LEFT = 23
SENSORBONE.THUMB_LEFT = 24
SENSORBONE.HAND_TIP_RIGHT = 25
SENSORBONE.THUMB_RIGHT = 26

I haven't been able to do anything interesting with them yet.

If you make anything with the extra bones, let me know!

Caveats

• gmcl_rekinect does not modify the menu state, so the Kinect icon in the bottom right of the Gmod menu will not be visible.
• motionsensor.GetColourMaterial() is not implemented.

Requirements

• Windows
• For Xbox 360 Kinect users, Kinect for Windows Runtime 1.8
• For Xbox One Kinect users, Windows 10 or Windows 11

Installation

1. Open your Garry's Mod installation directory. You can find this by right clicking Garry's Mod on Steam, clicking "Properties", clicking the "Installed Files" tab, and then clicking "Browse".
2. Navigate into the garrysmod/lua/ folder.
3. Create a new folder called bin. If it already exists, skip this step.
4. Download the latest release of gmcl_rekinect.zip from the Releases page.
5. Drop all of the files inside the .zip file into the garrysmod/lua/bin/ folder you just created.

Your bin folder should now look something like this:

Server Installation

Please note that gmcl_rekinect does not require any server-side installation to work. However, if you want to use the extra bones from the Xbox One Kinect, you'll need to install exbones.lua on your server:

1. Download exbones.lua from the Releases page.
2. Copy it into your server's garrysmod/lua/autorun/server/ directory.

Usage

Using rekinector (recommended)

gmcl_rekinect comes with a custom DLL injection program called rekinector for your convenience.

Just open it and it'll watch for Garry's Mod to open. Once it does, it'll inject gmcl_rekinect into the process.

You'll still need to follow the Installation Instructions above before you can use rekinect.

Download

As a binary module

gmcl_rekinect can be used as a clientside binary module, provided you have followed the Installation Instructions above.

Some servers will allow you to simply run this console command:

lua_run_cl require("rekinect")

in order to load gmcl_rekinect. If nothing is printed in your console after running this command, you'll need to use rekinector (recommended) or DLL injection instead.

DLL injection

gmcl_rekinect can also be directly injected into the Garry's Mod process, allowing you to use it on whatever servers you please.

If you don't know how to do this already, follow these instructions:

1. Make sure you have followed the Installation Instructions above
2. Install Cheat Engine
3. If you're connected to a server - disconnect. DLL injection of gm_rekinect must take place before joining a server.
4. Open Cheat Engine
5. Click "Select a process to open" in the top left
6. Select the "Applications" tab and click "Garry's Mod"
7. Click "Open"
8. Click "Memory View" in the middle left of the Cheat Engine window
9. Click "Tools" at the top of the Memory View window
10. Click "Inject DLL"
11. If you're on the main branch of Garry's Mod (the default branch), inject gmcl_rekinect_win32.dll which you installed to garrysmod/lua/bin/ earlier. Otherwise, x86-64 branch users should inject gmcl_rekinect_win64.dll.
12. Cheat Engine will ask if you want to execute a function of the DLL. Click "No".
13. Join a server.