> For the complete documentation index, see [llms.txt](https://docs.cybercookie.party/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cybercookie.party/readme.md).

# Introduction

**CyberCookie (CY2)** is a cozy, hand-drawn click-to-earn game: tap the cookie, buy upgrades that earn coins while you sleep, collect cards, trade with other players, duel them, join a guild and climb the leaderboards. You can play it on the web, inside Telegram, as a Discord Activity, or from a browser extension — it is the same account and the same save everywhere.

> Every number in this documentation comes from the game's own code (server and shared libraries), so it matches what runs in production. When a value changes in an update, this documentation changes with it. The latest changes are always listed in the in-game **Settings → Patch notes**.

## Where to start

| I want to…                                          | Read                                                                                                                |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Create my account and understand the screens        | [Getting started](/playing/getting-started.md)                                                                      |
| Understand taps, energy, profit per hour and levels | [Gameplay & progression](/playing/gameplay.md)                                                                      |
| Spend coins wisely                                  | [Upgrades](/playing/upgrades.md) · [Balancers & projects](/playing/balancers.md)                                    |
| Collect cards, open boosters, trade                 | [Cookie Cards](/playing/cards.md) · [Market & trades](/playing/market.md)                                           |
| Play against other players                          | [PvP duels](/playing/pvp.md) · [Casino](/playing/casino.md)                                                         |
| Team up                                             | [Friends, guilds & profiles](/playing/social.md)                                                                    |
| Earn rewards                                        | [Tasks, referrals & rewards](/rewards-and-money/tasks-rewards.md)                                                   |
| Know what Premium and roles give                    | [Premium & roles](/rewards-and-money/premium.md) · [Store](/rewards-and-money/store.md)                             |
| Understand where coins come from and go             | [Economy](/rewards-and-money/economy.md)                                                                            |
| Play from the toolbar or follow the community       | [Browser extension](/platforms-and-community/extension.md) · [Discord bot](/platforms-and-community/discord-bot.md) |
| Follow the rules                                    | [Community rules](/platforms-and-community/rules.md)                                                                |
| Build something with CyberCookie data               | [Public API](/developers/api.md)                                                                                    |
| Know how the game protects itself                   | [Security & fair play](/developers/security.md)                                                                     |

## The game in one minute

1. **Tap** the big cookie: each tap earns coins and costs a little **energy**.
2. **Buy upgrades** in *Earn*: they raise your **profit per hour**, which keeps flowing while you are away (for 2 hours after your last tap at 25 %, up to 6 with Night Shift; in full while you play).
3. Your **level** comes from your profit per hour; higher levels unlock better upgrades, milestone rewards and the casino (level 10).
4. **Open boosters** to collect cards: equipped cards give permanent bonuses and complete collections give big rewards.
5. **Play together**: boost friends, join a guild, trade cards, duel in Connect 4 or Mines, and compete on the leaderboards.

The server is authoritative: it owns your balance, energy and every outcome, so nobody can cheat their way up (see [Security & fair play](/developers/security.md)).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.cybercookie.party/readme.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.