# Game Overview

At its core, Jammy offers a competitive bingo experience played in real-time. The game design prioritizes simplicity, strategy, and provable fairness.

### 🎟️ **Card & Game Matching Logic**

* Players must select one of the four card types to join a game: Bronze, Silver, Gold, Diamond.
* Each card type corresponds to a specific game type — i.e., a game accepts only one card tier.
* Players cannot mix multiple card types in the same game.
* Each type has a different chip cost. Higher-tier cards don’t change the odds of winning, but allow for larger strategic chip investments.
* VIP Cards are available during limited-time events or sponsor campaigns.

### 🎮 **Game Entry Mechanics**

* Before entering a game, players choose how many cards (1–4) they wish to use. Upon joining the game, they cannot change the number of cards.
* Upon joining the game, they cannot change the number of cards.
* Once players join a game, a countdown timer starts.
* During the countdown period:
  * Players change the specific cards assigned or can review the transaction hash of the cards.
  * Each card’s composition is generated in a fully random manner by a smart contract using Chainlink VRF.
  * The transaction hash for each card's generation is publicly displayed and accessible from the interface, ensuring provable fairness.

### 🕹️ **Gameplay Flow**

* When the countdown ends, number drawing begins.
* At fixed intervals, new numbers are drawn on-chain and automatically matched to player cards. Cards visually update with highlighted numbers to show progress.
* Players must follow the game flow and, upon completing a valid pattern, click the corresponding Jam/Jammy button to submit it for verification. If the button is not clicked, the pattern will not be validated by the smart contract, and the player will not receive the reward.
* Every drawn number is also generated using VRF randomness, with its transaction hash openly published in the game panel for public auditability.

### 🚀 **Win Pattern & Jam Buttons**

* Once a player completes 1, 2, 3, or 4 horizontal lines, or a full card, the corresponding Jam/Jammy button (e.g., “1st Jam”, “2nd Jam”, “Jammy”) becomes clickable.
* Players who have completed the required number of lines and click the respective button before the next number is drawn successfully claim the reward.
* Multiple players can claim the same Jam level, as long as they do so before the next draw. The reward is equally split among them.
* Every pattern level can only be claimed once per game. For example, once the First Jam is completed by one or more players and new numbers are drawn, no other player can claim the First Jam reward during the same game. From that point on, players can only compete for the Second Jam.

### 📝 Game Records & Refund Policy

Jammy prioritizes transparency and user control even beyond gameplay:

* If a game is cancelled or terminated for any reason (e.g. insufficient players, system timeout), players can claim back their entry chips from the “Game Hash” section in their profile. Cancelled games will appear with the name "Game Refund" and a Claim button for eligible refunds.
* Players can also review detailed logs of all past games\*\* they’ve participated in by visiting the same Game Hash tab. This includes:
  * Creation date
  * Winners
  * Total pot
  * The amount of chips the player paid
  * The amount of prize money the player won
  * The total number of players at the game
  * The total number of cards on the game
  * Game transaction hash

This allows complete traceability of performance, fairness, and fund flows in every session.

### 🏆 Jam Levels and Reward Distribution

* The total reward pot consists of all chips paid by participants to join the game.
* Rewards are distributed instantly and automatically on-chain once the game ends.

| Jam Level | Condition               |
| --------- | ----------------------- |
| 1st Jam   | One full line completed |
| 2nd Jam   | Two full lines          |
| 3rd Jam   | Three full lines        |
| 4th Jam   | Four full lines         |
| Jammy     | Full card completed     |
| House Fee | Platform revenue        |

### 🔐 **Provable Fairness & Transparency**

Jammy’s entire game infrastructure is built on top of verifiable smart contracts with randomness sourced via VRF (Verifiable Random Function). This guarantees:

* Cards and number draws are provably random
* Every card and number can be independently verified on-chain via transaction hash
* All randomness and prize claims are transparent and tamper-proof
* Full on-chain auditability creates unmatched trust for both users and partners

This isn’t just a game. It’s a 100% verifiably fair gaming protocol.

### 💸 Earning More Chips: Incentives for Engagement

Jammy offers multiple reward mechanisms outside of the core game loop. These chip income sources allow players to participate in more games and climb the leaderboard:

1. **Playing the Game**\
   Win rewards by successfully claiming Jam levels during games. The more cards you play with, the higher your chances of winning.
2. **Daily Quests**\
   Complete tasks to earn chip rewards. Rewards vary by quest tier and staking status.
3. **Daily Entrance Bonuses**\
   Earn daily chips by logging in regularly.
4. **Staking Rewards**\
   Players who stake $JAM tokens receive daily chip rewards and boosted quest earnings, both determined by their staking tier, locked amount, and pool duration.
5. **Leaderboard Prizes**\
   Compete in 15-day rank leaderboards and 45-day season leaderboards to win token, NFT, airdrop rewards and more.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://jammy-1.gitbook.io/jammy/game-mechanics/game-overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
