How to Set Up and Use the HUD with fpdb‐3 by editing HUD_config.xml - jejellyroll-fr/fpdb-3 GitHub Wiki

How to Set Up and Use the HUD with fpdb-3

Overview

The HUD (Heads-Up Display) in fpdb-3 is included with the main program download. The HUD launches automatically when you start an auto-import in fpdb-3b. The HUD and fpdb-3 share the same configuration file, HUD_config.xml, as well as the fpdb-3 database. The HUD currently only reads from the database.

Running the HUD

  1. Open fpdb-3 and select Auto Import and HUD from the Import menu.
  2. An auto-import window will appear. Check that the hand history directories are correct. If they aren't, select the correct folder. Ensure you select a directory, not an individual file.
  3. Adjust the import interval if necessary. The default is 2 seconds. If unsure, leave it unchanged.
  4. Click Start Auto Import to begin importing hands and start the HUD.

The HUD will overlay statistics on the table windows as hands are imported.

Customizing the HUD

The HUD_config.xml file allows you to customize the layout, colors, opacity, and the stats displayed. By default, the HUD stats are shown in 2 rows and 3 columns, displaying the following information:

Default Stats Meaning
VPIP Voluntarily Put $ In Pot (participation in the pot)
PFR Preflop Raise %
Fold Freq 1 Flop fold frequency
# Hands Number of hands played
WTSD Went To Showdown (frequency of going to showdown)
WMSD Won Money at Showdown (win percentage at showdown)
Customization Examples

Here are some examples of what you can change in the HUD_config.xml file:

  1. Change the number of rows and columns:

         <ss name="draw_default" rows="2" cols="3" xpad="1" ypad="0">
             <stat _rowcol="(1,1)" _stat_name="vpip" popup="default" tip="" click=""/>
             <stat _rowcol="(1,2)" _stat_name="pfr" popup="default" tip="" click=""/>
             <stat _rowcol="(1,3)" _stat_name="ffreq1" popup="default" tip="" click=""/>
             <stat _rowcol="(2,1)" _stat_name="n" popup="default" tip="" click=""/>
             <stat _rowcol="(2,2)" _stat_name="wtsd" popup="default" tip="" click=""/>
             <stat _rowcol="(2,3)" _stat_name="wmsd" popup="default" tip="" click=""/>
         </ss>
  2. Change the background and text colors:

    <aw name="Classic_HUD" module="Aux_Classic_Hud" class="Classic_HUD" bgcolor="#000000" fgcolor="#FFFFFF" font="Sans" font_size="8" opacity="0.8"/>
  3. Change HUD window opacity:

    The opacity attribute can be adjusted to make the HUD windows more or less transparent.

  4. Seat and window layout:

    Here’s an example for a 6-player table:

    <layout max="6" width="792" height="546">
        <location seat="1" x="681" y="119" />
        <location seat="2" x="681" y="301" />
        <location seat="3" x="487" y="369" />
        <location seat="4" x="226" y="369" />
        <location seat="5" x="0" y="301" />
        <location seat="6" x="0" y="119" />
        <location common="1" x="323" y="232" />
    </layout>

    This places stats for each seat around the virtual poker table.

  5. Popup Configuration:

    Each stat can have a popup displayed when clicked. Here’s an example popup configuration:

    <popup_windows>
         <pu pu_name="holdring_main" pu_class="Submenu">
             <pu_stat pu_stat_name="playername"/>
             <pu_stat pu_stat_name="general" pu_stat_submenu="default"/>            
             <pu_stat pu_stat_name="preflop" pu_stat_submenu="hold_pre"/>
             <pu_stat pu_stat_name="flop" pu_stat_submenu="hold_flop"/>
             <pu_stat pu_stat_name="turn" pu_stat_submenu="hold_turn"/>
             <pu_stat pu_stat_name="river" pu_stat_submenu="hold_river"/>
             <pu_stat pu_stat_name="hands seen" pu_stat_submenu="hold_starthands"/>
         </pu>  
    </popup_windows>

    You can create multiple popups and assign them to different stats.

Available Stats

Here is a list of available stats in HUD_config.xml and their meanings for different game formats:

Cash Game Stats (Ring Game):
Stat Description
VPIP Voluntarily Put $ In Pot (participation in the pot)
PFR Preflop Raise %
PF3 3-bet preflop %
PF4 4-bet preflop %
AggFac Aggression Factor
AggFreq Aggression Frequency
ContBet Continuation Bet %
Saw_F Saw Flop %
W$SD Won Money at Showdown
Total Profit Total Profit
BB/100 Big Bets won per 100 hands
Fold to Steal % Folded blinds to steal
Three_Bet % 3-bet preflop
Fold to 3-bet % Folded to 3-bet preflop
AggFreq Flop Aggression Frequency on the Flop
AggFreq Turn Aggression Frequency on the Turn
AggFreq River Aggression Frequency on the River
Fold to ContBet Flop % Folded to continuation bet on the flop
Fold to ContBet Turn % Folded to continuation bet on the turn
Fold to ContBet River % Folded to continuation bet on the river
Tournament Stats:
Stat Description
M Ratio M Ratio (measures stack depth)
BB Stack Stack size in Big Blinds
VPIP Voluntarily Put $ In Pot
PFR Preflop Raise %
3Bet Preflop 3-bet preflop %
4Bet Preflop 4-bet preflop %
AggFac Aggression Factor
AggFreq Aggression Frequency
ContBet Continuation Bet %
Saw Flop % of hands where the player saw the flop
Went to Showdown (WTSD) % of hands where the player went to showdown
Won at Showdown (W$SD) % of money won at showdown
Steal % Steal %
Fold to Steal % Folded to steal
Squeeze % Squeeze preflop
Fold to 3Bet % Folded to 3-bet preflop
Fold to 4Bet % Folded to 4-bet preflop
Profit per 100 hands Profit per 100 hands
Big bets/100 hands Big bets won per 100 hands

These stats can be configured via the HUD_config.xml file, and you can adjust them based on your preferences. For example, for a tournament, you might configure the file like this:

        <ss name="draw_default" rows="2" cols="3" xpad="1" ypad="0">
            <stat _rowcol="(1,1)" _stat_name="vpip" popup="default" tip="" click=""/>
            <stat _rowcol="(1,2)" _stat_name="pfr" popup="default" tip="" click=""/>
            <stat _rowcol="(1,3)" _stat_name="ffreq1" popup="default" tip="" click=""/>
            <stat _rowcol="(2,1)" _stat_name="n" popup="default" tip="" click=""/>
            <stat _rowcol="(2,2)" _stat_name="wtsd" popup="default" tip="" click=""/>
            <stat _rowcol="(2,3)" _stat_name="wmsd" popup="default" tip="" click=""/>
        </ss>

HUD Window and Popup Configuration

To display specific windows for games or poker sites, you can define layouts in the HUD_config.xml file. For example, for PokerStars, you can customize a layout for tournaments and cash games by adding layout sets.

Example for PokerStars:
<site site_name="PokerStars" enabled="True">
    <layout_set game_type="ring" ls="ps_default" />
    <layout_set game_type="tour" ls="ps_default" />
</site>

In this case, ps_default is defined as the default layout for PokerStars for both cash games and tournaments. You can set similar configurations for other sites like PartyPoker, Winamax, etc.

⚠️ **GitHub.com Fallback** ⚠️