AlphaRing - kirklandsig Fork

This is a personal fork of thejackbitt/AlphaRing for testing and development.

Based on: JackBitt's AlphaRing v1.2.1 (commit bdad7eb)

For the original project, see WinterSquire/AlphaRing

---

What's New in This Fork

Features Added

1. Controller-to-Player Binding (Splitscreen)

• Each player now has a "Bind" button next to the controller dropdown
• Click "Bind" → Press any button on a controller → Automatically assigns that controller to the player
• No more guessing which controller is "Controller 1" vs "Controller 2"

2. Button-to-Action Binding (Gamepad Mapping)

• Each action in the Gamepad Mapping section has a "Bind" button
• Click "Bind" → Press a button → That button is assigned to the action

3. Fixed Default Gamepad Mappings

• Bug fixed: Previously, all actions defaulted to "Left Trigger" due to uninitialized memory
• Now: New profiles initialize with standard Xbox Halo controls:

Action	Button
Jump	A
Melee	B
Action/Interact	X
Change Weapon	Y
Reload	RB
Switch Grenades	LB
Shoot	RT
Throw Grenade	LT
Flashlight	D-pad Up
Crouch	Left Stick Click
Zoom	Right Stick Click

---

Original Alpha Ring

A Modding Tool for MCC

Showcase

Camera Tool (H3)	Object Browser (H3)
8 Players Campaign	Splitscreen With Mod (By Priception)

Features

• Splitscreen (all games)
• Camera Tool (H3)
• Object Browser (H3)

Installation

Make sure you have the latest Microsoft Visual C++ Redistributable installed.

Download the latest stable build from the Releases page.

Place the DLL into the "Halo The Master Chief Collection\mcc\binaries\win64" directory and launch the game with EAC off.

For Running on Steam Deck/Linux, add the following command in the Steam Game Launch Options:

WINEDLLOVERRIDES="WTSAPI32=n,b" %command%

Batocera Linux

For Batocera Linux users, additional setup is required:

1. Download Proton GE: Get the latest tar.gz from the Proton GE releases page (Proton GE 10-15 recommended)

2. Install Proton GE: Unpack the archive to your Steam compatibility tools folder:

   ~/.steam/root/compatibilitytools.d/
   

3. Restart Steam: Close and reopen the Steam client for it to detect the new Proton version

4. Configure the game:

   • Right-click MCC → Properties → Compatibility
   • Enable "Force the use of a specific Steam Play compatibility tool"
   • Select Proton GE 10-15 (or your installed version)

5. Set launch options: Add the following to Steam Launch Options:

   WINEDLLOVERRIDES="WTSAPI32=n,b" %command%
   

6. Controller Setup (Important for non-Xbox controllers):

   • For 8BitDo and other third-party controllers, enable Steam Input for the controller
   • Go to Steam → Settings → Controller → Enable "Xbox Configuration Support"
   • This allows Steam to translate your controller inputs to XInput, which MCC and AlphaRing expect
   • Without this, some buttons (like A or stick clicks) may not be detected

Note: The unofficial Batocera add-ons version of the Steam client has been tested and works with this setup.

Usage

Toggle menu: F4 or Controller Back + Controller Start

To navigate using Controller use the Right Stick to move the mouse and RB to click.

When the menu is open, game input is disabled.

---

Building from Source

Prerequisites

• Visual Studio 2022 Build Tools
• CMake 3.27+

Build Commands

# First time setup
mkdir build && cd build
cmake .. -G "Visual Studio 17 2022" -A x64

# Build
"C:/Program Files (x86)/Microsoft Visual Studio/2022/BuildTools/MSBuild/Current/Bin/MSBuild.exe" WTSAPI32.vcxproj -p:Configuration=Release -p:Platform=x64

Output: build/Release/WTSAPI32.dll

---

Credits

• Original AlphaRing: WinterSquire
• Profile Tweaks Fork: thejackbitt
• This Fork: kirklandsig (controller binding features)
• Assembly for the tag group research.
• Blender for the bezier curve calculation.
• Priception for adding UI controller support and helping with the interface and crash issue.