Format Library
This library stores GolfToon's supported tournament and game formats. Some formats already use live scoring engines; others are stored now so engines can be added later.
Formats
| Format | Category | Team Size | Scoring Type | Engine | Summary |
|---|---|---|---|---|---|
| Callaway System | Handicap System | 1 | One-Day Handicap | callaway | Temporary handicap system for players without indexes. |
| Peoria System | Handicap System | 1 | One-Day Handicap | peoria | Selected hidden holes are used to calculate a temporary handicap. |
| System 36 | Handicap System | 1 | One-Day Handicap | system36 | Popular event handicap system based on round performance. |
| Individual Stroke Play | Individual | 1 | Gross / Net Stroke Total | stroke_play | Each player plays their own ball. Lowest total gross or net score wins. |
| Net Stroke Play | Individual | 1 | Net Stroke Total | stroke_play_net | Each player plays their own ball. Handicap strokes are applied to produce net score. |
| Team League Match | League | 2 | Match / Points Hybrid | league_match | League team play using match points, best ball, or other scoring. |
| Match Play | Match Play | 1 | Hole-by-Hole Match | match_play | Players or teams compete hole by hole. Most holes won wins the match. |
| Presidents Cup | Match Play | 2 | Mixed Match Formats | ryder_cup | Event structure similar to Ryder Cup. |
| Ryder Cup | Match Play | 2 | Mixed Match Formats | ryder_cup | Event structure combining four-ball, foursomes, and singles match play. |
| Eclectic | Multi-Round | 1 | Best Hole Score Across Rounds | eclectic | Over multiple rounds, best score on each hole counts. |
| Chicago | Points | 1 | Quota / Point Variation | chicago | Point game where starting target is based on handicap. |
| Modified Stableford | Points | 1 | Modified Points vs Par | modified_stableford | Aggressive point system rewarding birdies/eagles and penalizing worse scores. |
| Par / Bogey | Points | 1 | Hole Result vs Fixed Target | par_bogey | Each hole is won, lost, or halved against par or bogey. |
| Quota | Points | 1 | Handicap-Based Points | quota | Players start with a quota based on handicap and earn points for performance. |
| Stableford | Points | 1 | Points vs Par | stableford | Scores are converted to points based on score relative to par. Highest points wins. |
| 3-Club Challenge | Specialty | 1 | Stroke Total with Club Limit | stroke_play | Players are limited to three clubs. Usually scored by stroke play. |
| Bingo Bango Bongo | Specialty | 1 | Per-Hole Bonus Points | bingo_bango_bongo | Points awarded for first on green, closest to pin, and first holed. |
| Blind Bogey | Specialty | 1 | Secret Target Score | blind_bogey | Tournament score compared to hidden bogey target. |
| Flags | Specialty | 1 | Strokes Until Exhausted | flags | Players continue until allotted strokes run out. Farthest progress wins. |
| Golf Marathon / Golf-a-Thon | Specialty | 1 | Multiple-Round Charity Format | marathon | Multiple rounds played for charity or fundraising. |
| Nassau | Specialty | 1 | Front / Back / Overall Matches | nassau | Three separate matches: front nine, back nine, and overall. |
| Skins Game | Specialty | 1 | Hole Winner / Carryover | skins | Lowest unique score on a hole wins the skin. Ties may carry over. |
| Stringball | Specialty | 1 | Stroke Play with String Allowance | stringball | Players use a length of string to move the ball without a stroke. |
| Wolf | Specialty | 4 | Rotating Partner Game | wolf | Rotating player chooses partner or goes alone each hole. |
| Shotgun Start | Starting Method | 4 | Start Type Only | shotgun_start | Not a scoring format; groups start on different holes simultaneously. |
| 1-2-3 Best Ball / Cha-Cha-Cha | Team | 4 | Rotating Best Ball Count | cha_cha_cha | Count 1 best ball on hole 1, 2 on hole 2, 3 on hole 3, then repeat. |
| 2-Man Best Ball | Team | 2 | Lowest Team Score Per Hole | best_ball | Two-player team uses best gross or net score each hole. |
| 4-Man Best Ball | Team | 4 | Lowest Team Score Per Hole | best_ball | Four-player team uses one or more best scores per hole. |
| Alternate Shot / Foursomes | Team | 2 | One Ball Alternate Shots | alternate_shot | Partners play the same ball and alternate shots. |
| Ambrose | Team | 4 | Net Scramble | ambrose | Scramble format with team handicap allowance. |
| Arizona Shuffle | Team | 4 | Variable Scores Count | arizona_shuffle | Number of scores counting varies by hole or rule set. |
| Best Ball | Team | 2 | Lowest Team Score Per Hole | best_ball | Each player plays own ball. Lowest team score on each hole counts. |
| Better Ball | Team | 2 | Lowest Team Score Per Hole | best_ball | Common two-person name for best ball. |
| Bowmaker | Team | 4 | Multiple Best Balls Count | bowmaker | Team format where a set number of best scores count per hole. |
| Bramble | Team | 4 | Best Drive then Best Ball | shamble | All players play from best drive and finish their own ball. |
| Canadian Greensomes | Team | 2 | Greensomes Variation | canadian_greensomes | Both tee off, choose ball, then alternate with local rule variations. |
| Champagne Scramble | Team | 4 | Best Drive then Own Ball | shamble | Another name/variation of shamble. |
| Chapman | Team | 2 | Switch Balls then Alternate | chapman | Both tee off, switch balls for second shots, choose one, then alternate. |
| Devil Ball | Team | 4 | Designated Ball Counts Extra | money_ball | One designated ball must count on each hole. |
| Florida Scramble | Team | 4 | Team Single Score with Dropout | florida_scramble | Player whose shot is selected sits out the next shot. |
| Four-Ball | Team | 2 | Lowest Team Score Per Hole | best_ball | Match-play or stroke-play format where better score of partners counts. |
| Fourball Alliance | Team | 4 | Multiple Best Balls Count | bowmaker | Alliance format using one or more best scores per hole. |
| Greensomes | Team | 2 | Both Tee Off then Alternate | greensomes | Both players tee off, select one ball, then alternate shots. |
| Joker Ball | Team | 4 | Designated Ball Counts Extra | money_ball | Special designated ball worth extra scoring weight. |
| Las Vegas Scramble | Team | 4 | Dice-Selected Scramble | vegas_scramble | Dice or random selection determines which player’s ball is used. |
| Low Ball / High Ball | Team | 4 | Low and High Scores Count | low_high_ball | Team uses both the lowest and highest score on a hole. |
| Maxwell | Team | 5 | Discard Worst Score | maxwell | Five-player team discards worst score each hole. |
| Money Ball / Lone Ranger | Team | 4 | Designated Ball Counts Extra | money_ball | One player’s score is designated as the money ball and counts extra. |
| Orange Ball | Team | 4 | Designated Ball / Mandatory Score | orange_ball | Four-player team format using one special colored ball. The Orange Ball score must count on designated holes or when assigned to a rotating player. |
| Orange Ball Scramble | Team | 4 | Scramble with Mandatory Orange Ball Score | orange_ball_scramble | Team scramble variation where the team score may include the scramble score plus a required Orange Ball score on selected holes. |
| Pinehurst | Team | 2 | Switch Balls then Alternate | chapman | Common alternate name/variation of Chapman. |
| Pro-Am | Team | 4 | Professional + Amateur Team | pro_am | Professional and amateurs play together, usually best ball or modified team scoring. |
| Rotating Partner Scramble - Individual Points | Team | 2 | Rotating team points to individual leaderboard | rotating_partner_scramble | Eight-player two-person scramble. Players are sorted by handicap, placed into balanced foursomes, and partners rotate inside each foursome after each 9-hole segment. Team results award individual points. |
| Scotch Foursomes | Team | 2 | Greensomes / Alternate Variation | greensomes | Often used synonymously with greensomes. |
| Scramble | Team | 4 | Team Single Score | scramble | All players hit, best shot is selected, all play from there. One team score per hole. |
| Shamble | Team | 4 | Best Drive then Own Ball | shamble | All tee off, best drive selected, then each plays own ball in. |
| Step Aside Scramble | Team | 4 | Scramble with Dropout | florida_scramble | Player whose shot is chosen sits out next shot. |
| Team Aggregate | Team | 2 | Sum of Team Scores | aggregate | All selected team member scores are added together. |
| Texas Scramble | Team | 4 | Team Single Score | scramble | Common name for standard scramble format. |
| Yellow Ball / Pink Ball | Team | 4 | Rotating Designated Ball | money_ball | A designated colored ball rotates and counts toward team score. |