{"id":34787220,"url":"https://github.com/jambolo/i-luv-suits","last_synced_at":"2026-05-27T14:09:03.139Z","repository":{"id":315986813,"uuid":"1060690771","full_name":"jambolo/i-luv-suits","owner":"jambolo","description":"A statistical analysis tool that simulates hands of the casino game \"I Luv Suits\" and calculates the expected return for each type of bet.","archived":false,"fork":false,"pushed_at":"2026-01-06T04:32:12.000Z","size":1130,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-26T20:50:09.462Z","etag":null,"topics":["casino-games","github-spark","i-luv-suits","simulation","typescript"],"latest_commit_sha":null,"homepage":"https://i-luv-suits-simulati--jambolo.github.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jambolo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-20T11:52:17.000Z","updated_at":"2026-01-05T06:52:00.000Z","dependencies_parsed_at":"2025-10-18T09:04:55.310Z","dependency_job_id":"549800b8-9c12-425e-81af-d6bd2fcd6b49","html_url":"https://github.com/jambolo/i-luv-suits","commit_stats":null,"previous_names":["jambolo/i-luv-suits-casino","jambolo/i-luv-suits"],"tags_count":0,"template":false,"template_full_name":"github/spark-template","purl":"pkg:github/jambolo/i-luv-suits","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jambolo%2Fi-luv-suits","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jambolo%2Fi-luv-suits/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jambolo%2Fi-luv-suits/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jambolo%2Fi-luv-suits/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jambolo","download_url":"https://codeload.github.com/jambolo/i-luv-suits/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jambolo%2Fi-luv-suits/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33569090,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-27T02:00:06.184Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["casino-games","github-spark","i-luv-suits","simulation","typescript"],"created_at":"2025-12-25T09:30:51.074Z","updated_at":"2026-05-27T14:09:03.135Z","avatar_url":"https://github.com/jambolo.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# I Luv Suits Poker — Simulator\n\nA lightweight simulator and UI for \"I Luv Suits Poker\" — a 7-card casino poker variant focused on flushes. This project lets you configure bonus-payout tables and play strategy, then run large Monte Carlo simulations (default: 1,000,000 hands) and view expected-return metrics for base bets and optional side bets.\n\n## Overview\n\nThis app simulates head-to-head play between a player and dealer. It computes:\n- Expected return (percentage) for the base game (Ante / Play) assuming $1 Ante and the maximum Play according to strategy.\n- Expected return for the two optional side bets: Flush Rush and Super Flush Rush (configurable payouts).\n- Win/loss counts, win rates, and a three-card-flush analysis broken down by high card (9, 10, J, Q, K, A).\n- Hand distribution statistics showing how often the player will play vs fold given a configurable minimum 3-card flush high-card threshold.\n\nThe UI provides controls for number of simulated hands, minimum 3-card flush high-card to play, and editable payout tables for the two side bets.\n\n## What the results mean\n\n- Total Bet: Sum of wager amounts placed across all simulated hands for a given bet type (e.g., Ante, Play, Flush Rush).\n- Total Won: Total payouts received for that bet type across all hands.\n- Hands Won: Number of hands that produced a win for that bet type.\n- Win Rate: Percentage of hands that won for that bet type.\n- Expected Return: The percentage return on the total bet for that bet type (positive = player profit, negative = house edge). The UI shows it as a percentage with an up/down indicator.\n\nHand Distribution analysis breaks out how many hands are above/below the player’s play threshold. This is used to compute how often the player chooses to Play (bet the Play wager) vs Fold.\n\n## How to use the app (local)\n\nUsing the UI:\n- Number of Hands: Set how many Monte Carlo hands to simulate (min 1,000; default 1,000,000).\n- Min 3-Card Flush High Card: Configure the minimum high-card required for the simulated player to \"play\" a 3-card flush (9 is the default). \"None\" means always play any 3-card flush. Smaller flushes are never played. Larger flushes are always played.\n- Run Simulation: Starts the simulation. A progress bar shows progress and estimated hands processed.\n- Payouts: Toggle the Payout Configuration panel to edit Flush Rush and Super Flush Rush payout tables (odds-to-1). Changes apply to subsequent simulations.\n\nInterpretation tips:\n- Results assume $1 Ante and $1 side bets each hand. The Play wager is chosen by the strategy rules described below.\n- For accurate estimates of expected return, use large sample sizes (1,000,000 preferred). Smaller runs are useful for quick experimentation.\n\n## Rules of the game (I Luv Suits Poker)\n\nBase-play rules:\n- Players makes an Ante wager and may optionally place two side bets: Flush Rush and Super Flush Rush.\n- Players and Dealer receive 7 cards from a standard 52-card deck. The deck is reshuffled between hands.\n- After receiving 7 cards, the player must choose to either place a Play wager or fold (and lose the Ante):\n\t- Maximum Play wager size depends on the player's number of flush cards:\n\t\t- 2, 3, or 4 flush cards: up to 1 × Ante\n\t\t- 5 flush cards: up to 2 × Ante\n\t\t- 6 or 7 flush cards: up to 3 × Ante\n- Dealer qualification: Dealer must have a 4+ card flush, or a 3-card flush with high-card 9 or higher, to qualify.\n- Payout resolution:\n\t- If dealer does NOT qualify: Ante pays even money (1:1); Play pushes.\n\t- If dealer qualifies and player's flush beats dealer's flush: Ante and Play both pay even money.\n\t- If dealer qualifies and dealer's flush beats player's: Ante and Play lose.\n\t- Ties push Ante and Play (no win/loss on those wagers).\n\nHand comparison:\n- When evaluating a 7-card hand, only the single \"best\" flush is considered for comparison: the flush with the most cards in the same suit.\n- If a hand contains multiple flushes of the same size (for example two different 3-card flushes), the flush whose ranks are highest is used (compare highest card, then next highest, etc.).\n- Flushes are compared first by number of cards (more cards wins). If both flushes have the same number of cards, compare the flush cards by rank from highest to lowest; the higher rank at the first difference wins.\n- If both flush size and all ranked cards are identical, the hand is a tie.\n\nSide bet rules (Flush Rush and Super Flush Rush):\n- Side bets are evaluated only on the player's 7 cards (they win or lose regardless of base game outcome).\n- Flush Rush: Pays based on the total number of flush-suited cards in the player's 7-card hand (typically wins for 4+ flush cards).\n- Super Flush Rush: Pays when the player's flush cards also form a straight flush sequence (3+ to win depending on table).\n\n## Steps the simulator performs (per hand)\n\n1. Build and shuffle a standard 52-card deck.\n2. Deal 7 cards to the player and 7 cards to the dealer (no shared community cards; independent 7-card hands).\n3. Evaluate both hands to determine:\n\t - The best flush for each hand (the flush with the most cards; if multiple equal-size flushes exist, choose the one with the highest ranks).\n\t - Whether any flush cards form straight flush sequences relevant to the Super Flush Rush bonus.\n4. Determine player action using configured strategy:\n\t - Always ante and place side bets (Flush Rush \u0026 Super Flush Rush) of $1 each.\n\t - Decide Play vs Fold: If the hand qualifies as \"above minimum\" (4+ flush cards OR a 3-card flush meeting the configured high-card threshold), the player plays the maximum allowed Play wager for that hand; otherwise the player folds (loses the Ante only).\n5. Determine dealer qualification (3-card 9-high+ required). If dealer fails to qualify, base-play resolution follows the non-qualifier rules.\n6. Resolve wagers:\n\t - Compute outcomes for Ante and Play according to comparison and qualification.\n\t - Compute side-bet payouts independently using the configured payout tables.\n7. Record per-hand statistics (bets placed, payouts received, win/loss counts) and update running totals.\n8. Optionally report progress back to the UI so the progress bar shows completion percentage.\n\n## Defaults \u0026 configuration\n\nDefault side-bet payout tables included in the UI and simulation code:\n\n- Flush Rush (odds-to-1):\n\t- 7 Card Flush: 100\n\t- 6 Card Flush: 20\n\t- 5 Card Flush: 10\n\t- 4 Card Flush: 2\n\n- Super Flush Rush (odds-to-1):\n\t- 7 Card Straight Flush: 500\n\t- 6 Card Straight Flush: 200\n\t- 5 Card Straight Flush: 100\n\t- 4 Card Straight Flush: 50\n\t- 3 Card Straight Flush: 9\n\nMinimum hands recommended for stable expected-return estimates: 1,000,000.\n\n---\n\nLicense: See `LICENSE` in repository root.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjambolo%2Fi-luv-suits","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjambolo%2Fi-luv-suits","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjambolo%2Fi-luv-suits/lists"}