Mapsai / Croupier

Live roulette spin generator for Hitman 3

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Croupier

Live generator for roulette spins in Hitman 3. Automatically generates kill condition and disguise combinations for mission targets on mission planning screen and tracks completion of the mission.

Preview Preview

Features

Automatic Mission Detection

Spins are automatically generated for the mission currently active in-game. Play through the entire trilogy without needing to Alt-TAB to generate spins.

This feature requires being in online mode.

All Main Missions

Supports every mission in the main campaign, including tutorial missions (Freeform Training, The Final Test, Nightcall), Untouchable and Shadows in the Water.

Support for bonus missions and special assignments is WIP.

Completion Detection

Croupier can detect completion of the current mission. New spins will not be generated for mission replans/restarts until the current mission is completed.

Support for live validation of target kills is WIP.

In-Game UI

Allows manual selection of mission, respins, and going back through previous spins, as well as some customisation options.

Roulette Rivals Ruleset

Spins are generated to comply with the current (as of RR11) standard ruleset of Roulette Rivals tournaments, preventing conditions that are known to be impossible, unbalanced or bugged.

Support for alternative rulesets is WIP.

Stream Friendly

External window displays the spins with images and is perfect for window capturing in OBS (use #000000 colour key with similarity and smoothness set to 1).

Additional support for layout customisation is WIP.

Installation Instructions

  1. Download the latest version of ZHMModSDK and install it.
  2. Download the latest version of Croupier and copy it to the ZHMModSDK mods folder (e.g. C:\Games\HITMAN 3\Retail\mods).
  3. Run the game and once in the main menu, press the ~ key (^ on QWERTZ layouts) and enable Croupier from the menu at the top of the screen.
  4. Use the in-game ZHMModSDK UI for respins, manual mission selection and configuration changes.

Building

1. Clone this repository locally with all submodules.

You can either use git clone --recurse-submodules or run git submodule update --init --recursive after cloning.

2. Install Visual Studio (any edition).

Make sure you install the C++ and game development workloads.

3. Open the project in your IDE of choice.

See instructions for Visual Studio or CLion.

About

Live roulette spin generator for Hitman 3

License:GNU General Public License v3.0


Languages

Language:C++ 99.9%Language:CMake 0.1%Language:C 0.0%