Gnarly's Poker Table Robbery

[line]
[heading][size=3][color=#D4D4D8]Features[/color][/size][/heading]
[list]
[][color=#D4D4D8]Tracks your actual net poker loss.[/color][/]
[][color=#D4D4D8]Supports larger poker buy-ins and increased-bet mods that use the normal Story Mode wallet.[/color][/]
[][color=#D4D4D8]Remembers the NPCs who were playing at the table.[/color][/]
[][color=#D4D4D8]Requires a drawn weapon and direct aim before a robbery can begin.[/color][/]
[][color=#D4D4D8]Poker players may surrender or fight back.[/color][/]
[][color=#D4D4D8]Money is only returned after the robbery interaction is completed.[/color][/]
[][color=#D4D4D8]Divides the recoverable loss between the tracked poker players.[/color][/]
[][color=#D4D4D8]Includes configurable keyboard controls.[/color][/]
[][color=#D4D4D8]Includes an on-screen status and diagnostic system.[/color][/]
[][color=#D4D4D8]Creates a log file showing poker cash-outs and mod payouts.[/color][/]
[][color=#D4D4D8]Does not automatically refund money when Arthur stands up.[/color][/]
[][color=#D4D4D8]Story Mode support only.[/color][/]
[/list][line]
[heading][size=3][color=#D4D4D8]How It Works[/color][/size][/heading]
[list=1]
[][color=#D4D4D8]Join a poker game normally.[/color][/]
[][color=#D4D4D8]Play until you lose money.[/color][/]
[][color=#D4D4D8]Leave the poker table.[/color][/]
[][color=#D4D4D8]Wait for the mod to calculate your final net loss.[/color][/]
[][color=#D4D4D8]Draw a weapon.[/color][/]
[][color=#D4D4D8]Aim directly at one of the players from the poker table.[/color][/]
[][color=#D4D4D8]Press the configured robbery key.[/color][/]
[][color=#D4D4D8]Keep the weapon aimed while the hold-up takes place.[/color][/]
[/list][color=#D4D4D8]The targeted player may surrender and return their share of the money. They may also resist and start a fight.
Only money that was actually lost is recoverable. Any unused poker chips returned when Arthur leaves the table are treated as a normal poker cash-out and are not counted as lost money.
Example[/color]

[code]Cash before poker:     $100.00
Poker buy-in:           $15.00
Cash returned on exit:   $4.00
Final cash:             $89.00
Recoverable loss:       $11.00[/code][color=#D4D4D8]The mod records [b]$11.00[/b], not the entire $15.00 buy-in.[/color]

[line]
[heading][size=3][color=#D4D4D8]Requirements[/color][/size][/heading]
[list]
[][color=#D4D4D8]Red Dead Redemption 2 for PC[/color][/]
[][color=#D4D4D8]Story Mode[/color][/]
[][color=#D4D4D8]ScriptHookRDR2[/color][/]
[][color=#D4D4D8]A working ASI loader, normally [/color]

[code]dinput8.dll[/code][/]
[/list][color=#D4D4D8]This mod is not intended for Red Dead Online.[/color]

[line]
[heading][size=3][color=#D4D4D8]Installation[/color][/size][/heading]
[color=#D4D4D8]Place these files inside the main Red Dead Redemption 2 game directory:[/color]

[code]PokerTableRobbery.asi
PokerTableRobbery.ini[/code][color=#D4D4D8]They should be installed in the same folder as:[/color]

[code]RDR2.exe
ScriptHookRDR2.dll
dinput8.dll[/code][line]
[heading][size=3][color=#D4D4D8]Default Controls[/color][/size][/heading]
[code]G   — Start the poker-player robbery
F7  — Display mod status
F8  — Reset the current session
F9  — Manual tracking fallback
F10 — Reload the configuration file[/code][color=#D4D4D8]Controls can be changed in:[/color]

[code]PokerTableRobbery.ini[/code][line]
[heading][size=3][color=#D4D4D8]Configuring Keybinds[/color][/size][/heading]
[color=#D4D4D8]The INI uses Windows virtual-key codes.
Default configuration:[/color]

[code][RobKey]
Hold=0
Press=71

[StatusKey]
Hold=0
Press=118

[ResetKey]
Hold=0
Press=119

[ManualKey]
Hold=0
Press=120

[ReloadKey]
Hold=0
Press=121[/code][code]Hold=0[/code][color=#D4D4D8]means no modifier key is required.
For example, to use [b]Left Ctrl + G[/b]:[/color]

[code][RobKey]
Hold=162
Press=71[/code][color=#D4D4D8]After changing the configuration, press [b]F10[/b] in-game to reload the INI.
When the robbery key is changed from G, the configured keyboard key will still work, although the standard graphical G prompt may be hidden to avoid displaying the wrong control.[/color]

[line]
[heading][size=3][color=#D4D4D8]Status Display[/color][/size][/heading]
[color=#D4D4D8]Press [b]F7[/b] to display the current state of the mod.
The status can show:[/color]

[list]
[][color=#D4D4D8]Current poker-tracking state[/color][/]
[][color=#D4D4D8]Starting cash balance[/color][/]
[][color=#D4D4D8]Current cash balance[/color][/]
[][color=#D4D4D8]Lowest detected balance[/color][/]
[][color=#D4D4D8]Recoverable debt[/color][/]
[][color=#D4D4D8]Number of tracked poker players[/color][/]
[][color=#D4D4D8]Poker cash-out amount[/color][/]
[][color=#D4D4D8]Number of payouts issued by the mod[/color][/]
[/list][color=#D4D4D8]This is useful when testing compatibility with another poker mod.[/color]

[line]
[heading][size=3][color=#D4D4D8]Poker Cash-Out vs. Mod Payout[/color][/size][/heading]
[color=#D4D4D8]RDR2 normally returns the value of Arthur’s remaining poker chips when he leaves the table. This can look like a refund, but it is part of the game’s normal poker settlement.
The status display separates these values:[/color]

[code]GameCashout[/code][color=#D4D4D8]Money returned by the poker game when leaving the table.[/color]

[code]PTRPays[/code][color=#D4D4D8]The number of payouts issued by Poker Table Robbery.
The mod also creates:[/color]

[code]PokerTableRobbery.log[/code][color=#D4D4D8]Normal poker settlement is recorded as:[/color]

[code]event=GAME_POKER_CASHOUT[/code][color=#D4D4D8]Money added by this mod is recorded as:[/color]

[code]event=PTR_PAYOUT[/code][color=#D4D4D8]If money is returned while [/color]

[code]PTRPays[/code][color=#D4D4D8]remains at zero, Poker Table Robbery did not issue that payment.[/color]

[line]
[heading][size=3][color=#D4D4D8]Manual Tracking[/color][/size][/heading]
[color=#D4D4D8]Automatic tracking should be used under normal conditions.
F9 is provided as a fallback for poker mods that significantly alter the normal poker scripts or wallet behavior. Manual tracking should only be used when automatic detection fails.
Press [b]F8[/b] to clear an incorrect or stuck session before beginning another game.[/color]

[line]
[heading][size=3][color=#D4D4D8]Compatibility[/color][/size][/heading]
[color=#D4D4D8]The mod should work with increased-bet or larger-buy-in mods when those mods continue using the normal Story Mode cash balance.
Compatibility may be limited when another mod:[/color]

[list]
[][color=#D4D4D8]Uses a completely separate poker wallet.[/color][/]
[][color=#D4D4D8]Replaces the standard poker scripts.[/color][/]
[][color=#D4D4D8]Changes the player’s money after a long delay.[/color][/]
[][color=#D4D4D8]Automatically refunds poker losses.[/color][/]
[][color=#D4D4D8]Alters poker NPCs after Arthur leaves the table.[/color][/]
[][color=#D4D4D8]Uses the same keyboard controls.[/color][/]
[][color=#D4D4D8]Changes the normal weapon-aiming or interaction system.[/color][/]
[/list][color=#D4D4D8]Use F7 and the generated log file when diagnosing compatibility problems.[/color]

[line]
[heading][size=3][color=#D4D4D8]Troubleshooting[/color][/size][/heading]
[color=#D4D4D8]The mod does not load
Confirm that ScriptHookRDR2 and the ASI loader are correctly installed. The ASI must be placed beside [/color]

[code]RDR2.exe[/code][color=#D4D4D8].
No robbery prompt appears
Confirm that:[/color]

[list]
[][color=#D4D4D8]A real poker loss was recorded.[/color][/]
[][color=#D4D4D8]Arthur has completely left the poker game.[/color][/]
[][color=#D4D4D8]A weapon is drawn.[/color][/]
[][color=#D4D4D8]Arthur is aiming directly at one of the original poker players.[/color][/]
[][color=#D4D4D8]The NPC has not already been robbed.[/color][/]
[][color=#D4D4D8]F7 shows a recoverable debt greater than zero.[/color][/]
[/list][color=#D4D4D8]Pressing the robbery key does nothing
Check the configured key code inside [/color]

[code]PokerTableRobbery.ini[/code][color=#D4D4D8], then press F10 to reload it.
Also verify that another mod is not using the same key.
The entire buy-in appears to return
Press F7 and check [/color]

[code]PTRPays[/code][color=#D4D4D8].
If [/color]

[code]PTRPays[/code][color=#D4D4D8]is zero, the payment came from RDR2 or another poker mod—not Poker Table Robbery.
Review [/color]

[code]PokerTableRobbery.log[/code][color=#D4D4D8]for confirmation.
The mod remains stuck
Press F8 to reset the current tracking session.
Multiple status messages appear
Search the game directory for every file matching:[/color]

[code]PokerTableRobbery*.asi[/code][color=#D4D4D8]Delete all old copies and keep only the newest version.[/color]

[line]
[heading][size=3][color=#D4D4D8]Uninstallation[/color][/size][/heading]
[color=#D4D4D8]Delete:[/color]

[code]PokerTableRobbery.asi
PokerTableRobbery.ini
PokerTableRobbery.log[/code][color=#D4D4D8]The log file is optional and may not exist until the mod has been used.[/color]

[line]
[heading][size=3][color=#D4D4D8]Important Notes[/color][/size][/heading]
[list]
[][color=#D4D4D8]Story Mode only.[/color][/]
[][color=#D4D4D8]Do not use this mod in Red Dead Online.[/color][/]
[][color=#D4D4D8]Save your game before testing new ASI mods.[/color][/]
[][color=#D4D4D8]Poker modifications may behave differently depending on other installed mods.[/color][/]
[][color=#D4D4D8]The recoverable amount is based on net wallet loss, not automatically the entire buy-in.[/color][/]
[][color=#D4D4D8]NPC reactions may create witnesses, violence, law responses, or other normal gameplay consequences.[/color][/]
[/list][line]
[heading][size=3][color=#D4D4D8]Version 0.7[/color][/size][/heading]
[color=#D4D4D8]Version 0.7 introduces:[/color]

[list]
[][color=#D4D4D8]Configurable keyboard controls.[/color][/]
[][color=#D4D4D8]Runtime configuration reloading.[/color][/]
[][color=#D4D4D8]Poker cash-out auditing.[/color][/]
[][color=#D4D4D8]Separate mod-payout auditing.[/color][/]
[][color=#D4D4D8]Additional status information.[/color][/]
[][color=#D4D4D8]A hard lock preventing payouts from being authorized merely by standing up.[/color][/]
[][color=#D4D4D8]Improved compatibility diagnostics for larger-bet poker mods.[/color][/]
[/list]