Skip to main content

League scoring

Every league and every leaderboard uses a scoring system. It is a small formula that says how many points a player gets for one tournament. UHT runs it for every player of every league tournament and adds the results up.

You do not need to be good at maths for this. Most clubs pick one of the ready-made formulas and never touch it again. If you want something of your own, this page explains every building block with poker examples.


Where scoring systems live​

Scoring systems belong to the club, not to a single league, so the Friday league and the Sunday ladder can share one. You manage them in the Scoring system field of the league dialog (New League or Edit league, see Leagues and leaderboards).

The scoring system list in the league dialog

  1. The pencil edits a scoring system.
  2. The bin deletes it. A system that a league, leaderboard or tournament still uses cannot be deleted; UHT tells you which ones use it.
  3. The + creates a new one. Next to it, a pencil edits the system that is selected, the same as the pencil in the list.

Only directors see these buttons. A league admin can pick a system from the list but not change the list.

Harbor Lights has three:

NameFormulaIn words
Classic (players minus place)p - f + 1One point for every player you outlasted, plus one
Bounty Hunter5 + 3 * max(4 - f, 0) + 3 * k5 for showing up, a bonus for the top 3, 3 per knockout
Harbor Points10 * sqrt(p / f) + 2 * k + [if f <= itm]5[if]A field-size curve, 2 per knockout, 5 extra for cashing

The scoring system dialog​

Editing Harbor Points, with the example tournament in the preview

  1. Name of the scoring system.
  2. Points shows your formula the way you would write it on paper, with the placeholders as labelled chips. Hover over a player in the preview and conditions are filled in for that player ("Conditions resolved for Maverick").
  3. Formula: the box where you type.
  4. Show common formulas opens the formula library.
  5. The cheat sheet below the box: functions, operators, two condition examples and every placeholder, grouped into Field, Money, Player and Club & League. Click any chip to insert it at the cursor.
  6. Decimal places: 0 to 5. Points are rounded to this many places.
  7. Preview with chooses the tournament the preview uses.
  8. The preview: every player of that tournament with the points your formula gives them, updated as you type.

Press Save changes (or Save scoring system for a new one) when you are happy. Until then nothing changes for any league.

Typing a formula​

You can type the short names (p, f, k ...) directly. If you do not remember them, press Space in the formula box:

The placeholder list that opens with the space key

  1. The list shows every placeholder with its name and a one-line explanation. Use the arrow keys and Enter to insert one, Esc to close the list.

Upper or lower case does not matter, and spaces are ignored. Line breaks are fine too, which helps with long formulas.

The formula library​

Show common formulas opens a collection of point systems used by real poker leagues.

The Common formulas library

  1. Filter by kind: Simple, Field size, Buy-in & money or Bonuses.
  2. Use formula puts the formula into the editor. If your scoring system has no name yet, it gets the name of the formula. You can still change everything before saving.

What the library offers, with points for a 20-player tournament:

FormulaWinner2nd5th10thLast (20th)
Basic Point Distribution p - f + 1201916111
Show Up & Podium 5 + 3 * max(4 - f, 0)1411555
Square-Root Distribution 10 * sqrt(p / f)44.731.62014.110
Logarithmic Distribution 10 * (ln(p + 1) - ln(f))30.423.514.47.40.5

The other five add money or bonuses: Buy-in Weighted (bigger buy-ins count more), Rebuys Cost Points (every rebuy and add-on lowers the score), Share of the Prize Pool (points equal the percentage of the prize pool someone won), Cash Bonus (a point per player outlasted plus 10 for cashing) and Hunter (a point per player outlasted, 2 per knockout, minus 1 per re-entry).


The placeholders​

A placeholder is a value UHT fills in for each player and tournament. The examples below use one tournament: a Friday Deepstack with 20 players, buy-in 35 EUR, re-entries and add-ons allowed, four paid places. Emma finished 3rd. She re-entered once, took the add-on and knocked out two players.

Field​

ShortOn screenWhat it meansEmma's example
pNumber of PlayersHow many different people played. A player who re-entered still counts once.20
pePlayers EnteredAll entries, re-entries and rebuys included.24 (20 players + 4 re-entries)
prPlayers Re-EnteredHow many re-entries or rebuys were made in total, by everyone.4
paAdd-On CountHow many add-ons were taken in total.6
itmITM PlacesHow many places were paid. 0 if the tournament paid no prizes.4

Money​

ShortOn screenWhat it meansEmma's example
tbBuy-in PriceThe buy-in, rake included.35
taAdd-On PriceThe add-on price, rake included. 0 without add-ons.20
trRe-Entry PriceThe re-entry or rebuy price, rake included. 0 without re-entries.35
tpPrize PoolThe total prize pool.960
tpbBounty Prize PoolThe money in bounties. 0 without bounties; for mystery bounties, the mystery bounty pool.0
ptsPlayer Total SpentWhat this player paid: buy-in, re-entries and add-ons.90 (35 + 35 + 20)
pwWinningsThe prize money this player won, without bounties. A chop counts with the amount agreed.150

Player​

ShortOn screenWhat it meansEmma's example
fFinish PositionThe place the player finished. 1 is the winner. Everyone in a chop counts as 1st.3
pbPlayer Re-EntriesHow often this player re-entered or rebought.1
kKnockoutsHow many players this player eliminated. Needs knockout tracking in the tournament.2

Club & League​

ShortOn screenWhat it meansEmma's example
kcClub KnockoutsHow many club members this player knocked out. Guests do not count.2
klLeague KnockoutsHow many players of this league this player knocked out.1
cpClub PlayersHow many club members played.18 (2 guests)
lpLeague PlayersHow many league players played.15
ltLeague ParticipationsHow many tournaments of this league this player has played so far, this one included.6
lnLeague TournamentWhich tournament of the league this is: 1 for the first, 8 for the eighth.8

A few details worth knowing:

  • Club members are today's members. If somebody leaves the club, they stop counting as a club member for old tournaments as well.
  • lt and ln count in the order the tournaments were played, and a tournament's value never changes later. Emma's 6th tournament stays her 6th, even after she plays her 7th.
  • In a tournament without a league, kl, lp, lt and ln are all 0.
  • In a leaderboard everyone listed counts as a club and league player, so cp and lp equal p, and kc and kl equal k. When you type in a result by hand, UHT only asks for the values your formula actually uses.

Building a formula​

Arithmetic​

WriteMeansExample
+ -plus, minusp - f + 1
* /times, divided by2 * k, p / f
^to the power of2 ^ 3 is 8
%what is left over after dividing7 % 3 is 1
( )do this part first(p - f) * 2

Multiplication and division happen before plus and minus, as at school. When in doubt, use brackets.

Functions​

FunctionWhat it doesExample
sqrt(x)square rootsqrt(16) is 4
max(a, b, ...)the largest of the valuesmax(4 - f, 0) never goes below 0
min(a, b, ...)the smallest of the valuesmin(k, 3) counts at most 3 knockouts
round(x), floor(x), ceil(x)round to the nearest whole number, down, upfloor(p / 10)
abs(x)drop the minus signabs(-5) is 5
log(x), ln(x), exp(x), pow(x, y), mod(x, y)for the maths fans; the library uses themlog(100) is 2

ln written alone, without brackets, is the League Tournament placeholder. ln(x) with brackets is the function.

Conditions​

A condition gives points only when something is true. It has the shape

[if CONDITION]POINTS[else]OTHER POINTS[if]

The [else] part is optional; without it the condition gives 0 when it is not true.

You wantWrite
10 points for the top 3, nothing for the rest[if f <= 3]10[if]
5 extra points for cashing[if f <= itm]5[if]
25 for the winner, 10 for everybody else[if f = 1]25[else]10[if]
Double points in the last tournament of an 8-game season(p - f + 1) * [if ln = 8]2[else]1[if]
3 extra points in every third league tournament[if ln % 3 = 0]3[if]
A bonus only for knocking out 3 or more and making the final table[if k >= 3 and f <= 9]5[if]

You can compare with =, != (not equal), <, >, <= and >=, and combine conditions with and / or. Brackets are not allowed inside a condition; write [if f <= 3 and k > 0] rather than [if (f <= 3) and (k > 0)].


Worked examples​

"100 for the win, less for every place below, 5 per knockout"​

max(110 - 10 * f, 10) + 5 * k

PlaceKnockoutsPoints
1st3100 + 15 = 115
2nd190 + 5 = 95
5th060
10th and below010 (the max keeps everyone at 10 at least)

"Bigger tournaments are worth more"​

10 * sqrt(p / f) is the classic league curve. Winning against 30 players gives 10 * sqrt(30) = 54.8 points, winning against 10 gives 31.6. Finishing last always gives 10.

Harbor Points adds two things to it: + 2 * k for knockouts and + [if f <= itm]5[if] for cashing. In a 20-player Friday Deepstack with four paid places, Emma (3rd, two knockouts) gets 10 * sqrt(20 / 3) + 4 + 5 = 34.8 points.

"Reward people for coming"​

5 + 3 * max(4 - f, 0) gives everyone 5 points just for playing. The top three get 9, 6 and 3 on top. Players who come every week stay in the race even if they rarely win.

"Rebuys should cost you"​

p - f + 1 - 2 * pb takes 2 points off for every re-entry. A player who wins after buying in three times is not worth more than one who won with a single stack.


The preview​

The preview on the right is the best way to check a formula. It shows what every player of a real tournament would get.

Preview with offers an Example Bounty Tournament and every finished tournament of your club:

The Preview with list

  1. Example Bounty Tournament is a made-up 25-player tournament with bounties, re-entries and add-ons. It changes a little each time you open the dialog.
  2. League tournaments carry the name of their league. Pick one of those to see exactly what your league players would get.

The preview for a Friday Deepstack of the Autumn League

  1. The formula with conditions filled in for the player you point at.
  2. The tournament the preview uses.
  3. The League tag marks league players.
  4. Under each name: bounty, eliminations, entries and add-ons, the values most formulas use.
  5. The points this player would get.

Clicking the Place or Points column header sorts the list.

Club, league and struck-through points​

Club and league players in the preview

  1. Club: a club member who does not play in this league.
  2. Their points are struck through. Only league players score; the number shows what they would have got.
  3. League: a league player. These points count.

Players without a tag are guests.

When the formula has a mistake​

A formula with a missing bracket

  1. Below the box UHT says what is wrong, here A closing ")" is missing. You cannot save until it is fixed.
  2. The preview shows no points while the formula cannot be read.

A formula can also be correct but impossible for some players, for example 100 / k for someone with no knockouts (you cannot divide by zero). Then those players show a dash and a warning appears above the preview. You can still save, but those players get no points for that tournament, so it is better to fix it, for example with 100 / max(k, 1).


Decimal places​

Decimal places decides how points are rounded and shown. Each tournament's points are rounded first, then added up.

  • 0 gives whole numbers: easy to read on a display and to announce at the table.
  • 1 or 2 avoids ties when the formula uses square roots or divisions. Harbor Points uses 1.

Ties share a rank: two players with 51 points are both 8th, the next player is 10th.

A league can also add up only each player's best results instead of all of them. That is a setting of the league, not of the formula: see Only count the best results.


Changing a formula during a season​

UHT does not store the points of past tournaments. It calculates the whole season again each time somebody opens the league. That has two consequences:

  • A change counts for the whole season. If you add a knockout bonus in October, players get it for their August and September knockouts too. The table can look very different the next time it is opened.
  • Every league using the system changes. If the Friday league and the Sunday ladder share a scoring system, editing it changes both.

That is usually what you want when you fix a mistake. If you want a new rule to apply only from now on, use a condition such as [if ln >= 6]...[if] (from the sixth league tournament), or create a new scoring system for next season.

Manual corrections made with Adjust points stay as they are when you change the formula. See Point adjustments.

To score only one tournament differently, for example a season final with 1.5 times the points, give it its own scoring system instead of changing the league's. See A different scoring system for one tournament.