Sanktzee
HomeRulesLeaderboard

YAHTZEE – RULES AND SCORING

How to play Sanktzee (Yahtzee on-chain) and how scoring works

At a Glance

  • Players: 2–4 per game
  • Rounds: 13 turns per player
  • Objective: Highest total score wins
  • Randomness: Pyth Entropy on-chain; UI animation is visual only
  • Rolls: Up to 3 rolls per turn with keepable dice

Starting a Game

  • Click CREATE GAME, choose token and bet within configured limits.
  • Select 2–4 players; optionally invite addresses for a private game.
  • The lobby auto-starts when full; start order is randomly assigned on-chain.
  • There is a limited join window; expired lobbies cannot be joined.

Game Flow (Turns & Rolls)

  • Each turn consists of up to 3 rolls.
  • First roll: Roll all 5 dice.
  • If you achieve the combo you want, you may score immediately.
  • Second roll: Set aside any keepers and re-roll the rest (or re-roll all).
  • If you achieve the combo you want, you may score now.
  • Third and final roll: Roll any number of dice, including previous keepers.
  • You must enter a score this turn in exactly one empty box, even if it’s 0.

Scoring Rules (General)

  • Each turn, you must fill exactly one empty box on your scorecard.
  • You can complete boxes in any order across upper or lower sections.
  • If no valid scoring option fits, you must enter a 0 in one empty box.
  • Once a box is filled, it cannot be used again.
  • Summary of scoring is printed on the scorecard.

Upper Section

  • Aces (1s), Twos (2s), Threes (3s), Fours (4s), Fives (5s), Sixes (6s).
  • Score = sum of dice showing that face value.
  • Example: 3 Threes = 9 points in Threes box.
  • Example: 2 Aces = 2 points in Aces box.
  • Upper Section Bonus: If your total in the upper section exceeds 63 points, add 35 points.
  • Tip: Rolling three of each number (3x1 + 3×2 + … + 3×6 = 63) reaches the threshold.

Lower Section

  • Three of a Kind: Total of all 5 dice. Requires at least 3 dice showing the same number.
  • Four of a Kind: Total of all 5 dice. Requires at least 4 dice showing the same number.
  • Full House: Set score 25 points. Any 3 of a kind + any pair.
  • Small Straight: Set score 30 points. Any 4 consecutive values (e.g., 1-2-3-4, 2-3-4-5, 3-4-5-6).
  • Large Straight: Set score 40 points. Any 5 consecutive values (1-2-3-4-5 or 2-3-4-5-6).
  • Chance: Total of all 5 dice. No combo required.
  • Yahtzee: Set score 50 points. Five of a kind.

Yahtzee Bonus (Joker Rule)

After you have scored Yahtzee (50) positively, each additional Yahtzee in later turns grants a 100‑point bonus. Placement follows the Joker rule enforced on-chain:

  • If the matching upper box (same face value) is empty, you must score the sum of the five dice there.
  • Otherwise, you may score in one of these lower categories: Three of a Kind, Four of a Kind, Full House, Small Straight, Large Straight, or Chance (using the normal scoring for that category).

Important: If you have already scored 0 in the Yahtzee box, the 100‑point bonus is not available.

Winning

  • After all players complete 13 turns, sum the upper and lower sections, add any bonuses.
  • The highest Grand Total wins.
  • Don’t forget to add the 35-point upper section bonus if your upper total exceeds 63.

Strategy Tips (Optional)

  • Choose which box to fill each turn; some combos are easier to roll than others.
  • You may need to enter a 0—plan which box is least valuable to sacrifice.
  • Balance scoring between upper and lower sections to maximize total.
  • Save Chance for later when options are limited.
  • Success isn’t just high rolling; it’s choosing the right box at the right time.

Edge Cases and Clarifications

  • Large Straight qualifies as Small Straight if you choose to score it there.
  • Use Chance when no other valid option fits and you must avoid a 0.

About Dice Animation & On‑Chain Randomness

Sanktzee uses on-chain randomness via Pyth Entropy to generate dice outcomes. The roll animation in the UI is just a visual effect and does not decide the result.

Occasionally, the animation can desync or appear stuck. This doesn’t affect fairness: final dice values are committed on-chain and emitted by contract events.

If you see a glitch, the correct values are already recorded. Reloading or re-entering the game will reflect the authoritative on-chain state.

Randomness & Rolling

  • First roll in a turn requests fresh entropy on-chain (Pyth Entropy). A fee may be required for that request.
  • Subsequent rolls in the same turn derive randomness from the stored entropy; no new request is needed.
  • The contract emits events with the actual dice values for each roll; these are the source of truth.

Turn, Start Order & Timeouts

  • At game start (when the table fills), the starting player is chosen using a simple on-chain pseudo-random shuffle. This only affects order, not dice results.
  • Players take turns and may keep any subset of dice between rolls.
  • There are time limits for joining and for moves; timing out can end the game with winners among remaining players.

Scoring Enforcement & Joker Rule

  • The contract validates category placement and enforces the official Yahtzee “Joker” rule when a Yahtzee is rolled after the Yahtzee box has a positive score.
  • Used categories cannot be reused; totals and bonuses are computed on-chain.

Bets, Fees, and Rewards

  • Games can be created with native or ERC‑20 tokens within configured bet limits.
  • A house fee is taken from the pot and the remainder is paid out to winner(s); ties split evenly.
  • On cancellation after cooldown or on timeout, funds are distributed per the rules defined in the contract.