feat: consistent wager outcome table across casino games

1 files changed, 15 insertions, 1 deletions

diff --git a/data/help/casino.yaml b/data/help/casino.yaml
index 5f4e527..e361a47 100644
--- a/data/help/casino.yaml
+++ b/data/help/casino.yaml
@@ -18,10 +18,24 @@ description: |
 
   Profit odds exclude your returned stake: a 10-credit win at 2:1
   returns 30 total (20 profit + 10 stake). A push returns the stake;
-  a loss returns nothing. Slots and video poker report total returns, not profit odds.
+  a loss returns nothing. Slots and video poker paytables use total-return
+  multipliers; the shared payout receipt uses profit odds instead.
   Fractional table-game returns round down to whole credits, except
   craps which requires exact payout units (commission rounds up).
 
+  Every game uses the same payout receipt: Wager, Staked, Odds, Result, Net.
+  All amounts are credits. Returned includes any returned stake; Net is
+  Returned minus the stake settled. WIN/LOSS/PUSH describes the game result;
+  a winning machine combination can still have zero or negative net profit.
+  Varies means there is no single fixed payout rate. Odds marked 'fee' are
+  before commission; the actual returned amount and net include that fee.
+
+  Active bets appear as UNRESOLVED with no net amount. They are excluded
+  from settled totals and listed in the Active subtotal. Craps free odds
+  have their own rows. Slot free-spin features remain unresolved until
+  their banked winnings are paid. Failed payments are reported separately;
+  a receipt never claims that an uncredited payout has been paid.
+
   help roulette      Number, color and combination bets.
   help racetrack     Voisins, Tiers, Orphelins, Zero and Neighbors.
   help blackjack     Beat the dealer without going over 21.