Catan number pip dots calculator
A 6 or an 8 in Catan carries five pip dots: five of the 36 two-dice rolls pay that hex. Enter any token from 2 to 12 and see its odds, its twin token and its rank before placing a settlement. Free in your browser.
- Free
- Runs in your browser
- No sign-up
- Your data stays on your device
Run — free
Worked example
- Number
- 6
- Pips
- 5
- Ways
- 5
- Total outcomes
- 36
- Probability
- 0.138889
This Catan number pip-dots calculator converts a printed hex token into the exact pip-dot count that shows how often that number pays when two six-sided dice are rolled. Settlers of Catan marks each production chit with one through five dots: those dots are not decoration, they are the number of ways to roll that face with two dice, so a six or an eight (five dots, red ink) pays far more often than a two or a twelve (one dot). You enter a single token from two through twelve except seven, the robber, which has no production chit. The engine returns the pip count, the matching two-dice ways out of thirty-six, a reduced fraction, a percent, whether the token is a red high-frequency number, the complementary face that shares the same odds, a payout rank, and the full ten-token chart. Nothing is sampled and nothing calls a network service.
What Catan pip dots mean and how two-dice odds produce them
Every numbered hex in a standard Catan game carries a circular chit printed with a face from two through twelve, never seven, and a cluster of dots beneath that face. Those dots are a visual frequency scale. Two fair six-sided dice have thirty-six equally likely ordered outcomes.
Exactly one of them sums to two (one plus one) and one sums to twelve (six plus six), so those tokens show a single pip. Two outcomes sum to three, three sum to four, four sum to five, and five sum to six; the high side of the distribution mirrors that ladder, so eight has five dots, nine has four, and so on. The closed formula is pips equals six minus the absolute difference between the printed number and seven.
That is why six and eight sit next to the missing seven and are printed in red: they are the most frequent production numbers that actually pay resources. Seven itself is reserved for the robber and for discarding on an eight-or-more-card hand; it has no pip token because it never produces. This calculator does not roll dice and does not estimate.
It maps one legal token to that exact integer pip count, echoes the same integer as ways, divides by thirty-six for probability and percent with stable rounding, names the complementary token that shares the same pip count (two with twelve, three with eleven, four with ten, five with nine, six with eight), and assigns a rank from one (five pips) down to five (one pip). The response also includes a chart of all ten official tokens so you can read the whole ladder without a second request.
How the token is read, validated, and turned into pips
The required field is number, the integer printed on the chit. Empty strings and missing keys are rejected rather than treated as zero. The engine accepts a finite integer or a whole decimal string; fractions, infinities, and non-numeric objects fail.
Seven is rejected with an explicit robber message because that is the most common honest mistake at the table. Any other integer outside the official set two, three, four, five, six, eight, nine, ten, eleven, twelve is rejected with the list of legal tokens in the message. After validation the library applies the integer identity pips equals six minus the absolute value of number minus seven, which is exactly the two-dice way count for that sum.
Probability is ways divided by thirty-six, rounded to six decimal places; percent is the same ratio times one hundred, rounded to four decimal places; the fraction is left unreduced as ways over thirty-six so it matches the sample space players already know. Complementary number is fourteen minus the face, the other token on the same pip rung. Rank is six minus pips, so the two red tokens share rank one.
Where pip-dot counts fit in play, teaching, and tools
Players meet pip questions when two open intersections look similar until someone counts the dots: a six-nine-four vertex is twelve pips, while an eight-ten-three vertex is ten, even if both sit on wheat. New players often treat every number as equally likely until a five-pip red token pays three times as often as a two. Teachers use the chits as a physical histogram of two-dice sums before anyone writes a sample-space table.
Tournament grinders compare starting spots by adding the three adjacent pip counts, then this tool supplies the per-token building blocks without a house-rule argument about whether eight is luckier than six (it is not: both have five dots). Content creators and rule explainers need a reproducible chart of all ten tokens for overlays and thumbnails. Pair it with a general dice-sum helper when you leave the official two-d6 Catan model, and with other hobby tools when you are assembling a small lab of free, deterministic calculators for games and study.
What you can do with it
Compare hexes before you settle
Look up each adjacent token’s pip-dot count and add them to score an intersection before you place a settlement or city.
Teach two-dice odds with cardboard
Show students that the printed dots are the way-count for each sum, then check six, eight, two, and twelve against the formula.
FAQ
What does the Catan pip-dots calculator cost?
It is free in your browser on this page.
How are pip dots defined?
A six or eight has five dots; a two or twelve has one.
Why is seven rejected?
Seven is the robber. It has no production chit and never pays resources, so there is no pip-dot count to return.
Does this add the three hexes of a settlement?
No. It scores one token at a time and also returns the full ten-token chart. Add the three pip counts yourself for an intersection total.
Which Catan numbers pay out most often?
Six and eight, the two red tokens. Each has five pip dots, so each pays on 5 of the 36 possible two-dice rolls, more often than any other production number on the board.
Related tools
For developers — API access
Everything on this page is available programmatically. This section is for teams who want to wire it into their own systems; everyone else can just use the tool above.
API endpoint
Prefer to automate it? One authenticated POST creates the task; the result comes back by webhook or a signed link. The same capability also runs here on the web, by email and from Telegram — and soon from our app too.
Call it from your stack
curl -X POST https://api.kit.forhosting.com/hobby/game-catan-pips \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"number":6}'const res = await fetch("https://api.kit.forhosting.com/hobby/game-catan-pips", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"number": 6
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/hobby/game-catan-pips",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"number": 6
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/hobby/game-catan-pips", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"number":6}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"number":6}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/hobby/game-catan-pips", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Example request
{
"number": 6
}Example response
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "hobby.game_catan_pips",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}The API is asynchronous: the call returns a task_id immediately and the result arrives by webhook. Polling is capped at 1 req/s per task.
Pricing
Published price — no tokens, no invented credits. A failed task is never charged.
Errors
| HTTP | Code | Meaning |
|---|---|---|
401 | unauthorized | Missing or invalid API key. |
402 | insufficient_balance | Your balance doesn't cover the task price. |
404 | unknown_type | That task type doesn't exist. |
429 | rate_limited | Too many requests. Use the webhook instead of polling. |
Technical notes
What Catan pip dots mean and how two-dice odds produce them
Invalid faces fail closed with invalid_input instead of inventing a silent wrong count.
How the token is read, validated, and turned into pips
Aliases token, face, and value are accepted so spreadsheets, query strings, and typed forms can reuse familiar names without a rename layer. Boolean true or false is never coerced into one or zero. Failed validation is not charged, and nothing is stored after the response returns.
Where pip-dot counts fit in play, teaching, and tools
On this page the work runs entirely in your browser; through the API each successful lookup costs $0.002. That split—free interactive exploration and a priced, identical API—matches the rest of the KIT tier-A catalog and lets you move from a kitchen-table rules argument to an automated pipeline without changing the mathematical result.
Integration use cases
Deterministic fixtures for Catan tools
Generate stable pips, ways, and complementary_number values for unit tests of helpers, bots, and classroom worksheets.
Technical questions
Are six and eight equally likely?
Yes. Both have five two-dice ways out of thirty-six and both are printed in red. complementary_number pairs them with each other.