Overview

Liar's Dice (wikipedia) is a dynamic game of exposure and deception. Each participant begins with five dice, all shaken and kept secret. Before the game starts, a fixed wager is agreed upon, and players must place this wager with every bid they make. The core of the game involves players making successively higher bids on the total quantity of dice that show a specific face value across all players' dice.

• The face values are ordered from smallest to largest: 2, 3, 4, 5, 6, with 1 being the highest denomination.
• The face value of "1" can represent any number when making a bid.

For example, a player might bid "three fours" and put the required wager in the pot. The next player then has two choices: they must either raise the bid or challenge it.

• If the challenge is correct (the actual dice total is lower than the bid), the player who made the bid loses the pot.
• If the challenge is incorrect (the actual dice total meets or exceeds the bid), the challenger loses the pot.

🚀 Getting Started

1. Registration: Prior to playing Liar's Dice for the first time, every player is required to complete a one-time registration for the referral system. This process establishes a data account on the Solana blockchain to save basic inforamtion.
2. Creating Profile: Prior to playing Liar's Dice for the first time, every player is required to create a data account on Solana to store game-specific data.

Both operations require paying a PDA rent to create data accounts on Solana.

🎮 How to Play

Step 1: Pre Game Setup

Before starting the game, you need to set two parameters:

1. Bet Amount Per Bid: Select bet amount per bid from the five available levels: 0.02, 0.04, 0.08, 0.16, 0.32 SOL.
2. Lucky Words: Lucky words are used in games to generate randomness and ultimately determine the game's outcome.

To prevent cheating and protect the integrity of the game, follow these best practices:

• Use a longer lucky word.
• Make it highly complex by including a combination of numbers, upper/lowercase Latin letters, symbols, and characters from any language.
• Guard your lucky word carefully to prevent any exposure.

After player clicking the "Bet to Continue" button, your wager will be sent to custodian address through self-custody wallet such as Phantom, Backpack.

Step 2. Waiting page

The first player to enter the game room is designated as Player 1, and the second player to join is Player 2. Player 1 may withdraw their wager and leave the room at any time before Player 2 joins.

Step 3. Operation page

After the game begins, each player receives 5 dice. The game proceeds with Player 1 and Player 2 taking turns to either make a bid on the total number of dice (across all 10 dice) showing a specific face value, or challenge the previous bid. Please note that Player 2 must wait for Player 1 to make the initial bid before viewing his/her own dice face.

The rules for this stage:

1. Time Limit: Each player has a 2-minute time limit for their turn (either making a bid or challenging). If a player times out, he/she immediately loses the game.

2. Making a Bid: State a quantity and a die face (e.g., "four 5s") that you believe are currently hidden. Your new bid must be higher than the last one (either more dice or the same number of a higher face value).

3. Challenging the Previous Bid: If player 2 choose to challenge, player 2 must match wager of player 1. If player 1 chooses to challenge, player 1 is exempt from paying an addtional wager.

4. The dice face value of "1" has a dual function:

• During the reveal phase (when a challenge is made), any "1" counts as any number needed to meet the bid.

• In the bidding sequence, "1" holds the highest face value. The full bidding order for face values is: 2 < 3 < 4 < 5 < 6 < 1.

Step 4. Settlement page

1. Game Termination:

• Game Ends by Challenge: If the last bid is proven false, the challenger wins. If the last bid is proven true, the challenger loses. The dice of both players will be displayed on the settlement page.

• Game Ends by Timeout: The player who timed out loses the game instantly, and the players' dice will not be displayed on the settlement page.

2. Post-Game Actions:

• Winning Player: The winner can click the "Withdraw" button to collect both players' wagers, after the deduction of the game fee.

• Losing Player: The loser can click the "Go Back to Restart" button to start a new game.