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

# CowGalaxy · Player Handbook

Welcome to **CowGalaxy**! This is the shared handbook for all three games: wallet login, tokens and assets, the NFT marketplace, the portal, Open Beta XP, airdrops, and AI Agent Authorization live here as **common content**, while each game has its own handbook for gameplay.

***

## The three games

| Game                       | Status                          | What you do                                                                                                                                 | Handbook                                                                                             |
| -------------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **Interstellar Rangeland** | Open beta                       | Raise cattle, milk, fight in the Arena, breed, join planet guilds and guild battles                                                         | [Interstellar Rangeland · Player Handbook](https://cowgalaxy.gitbook.io/cowgalaxy-docs/rangeland/en) |
| **Interstellar Trek**      | Open beta (alongside the ranch) | Take the same cows aboard a flagship, clear 39 outposts across 5 constellations and claim on-chain loot                                     | [Interstellar Trek · Player Handbook](https://cowgalaxy.gitbook.io/cowgalaxy-docs/trek/en)           |
| **Interstellar Sandbox**   | Sepolia open beta               | Build guild planets and Private Coordinates, turning Rangeland and Trek assets into Timber, Alloy, flagship Modules, and cross-game bonuses | [Interstellar Sandbox · Player Handbook](https://cowgalaxy.gitbook.io/cowgalaxy-docs/sandbox/en)     |

***

## Common chapters

| What you want to know                                                  | Read                                                                                |
| ---------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| IRT / IRG, cattle stats and lifespan, star multipliers, blind boxes    | [01 Tokens & Core Assets](/cowgalaxy-docs/handbook/en/01-tokens-and-assets.md)      |
| How to buy and sell cattle / boxes / planets, which cattle can be sold | [02 NFT Marketplace](/cowgalaxy-docs/handbook/en/02-market.md)                      |
| Portal: wallet, profile, Agent Authorization, events, social and forum | [03 Portal](/cowgalaxy-docs/handbook/en/03-portal.md)                               |
| Beta rules, asset packs, invite / social / Play XP, airdrop            | [04 Open Beta Guide · Packs · XP · Airdrop](/cowgalaxy-docs/handbook/en/04-beta.md) |

***

## Six entrances

| Entrance                                         | Purpose                                                                                                                                                                          |
| ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Interstellar Rangeland** (ranch.cowgalaxy.com) | Raising, combat, guilds, quests — core gameplay                                                                                                                                  |
| **Interstellar Trek** (trek.cowgalaxy.com)       | The second game: take cows on expeditions, clear outposts, claim on-chain loot ([→](https://cowgalaxy.gitbook.io/cowgalaxy-docs/trek/en))                                        |
| **Interstellar Sandbox** (sandbox.cowgalaxy.com) | The third game: choose land, build, lumber, refine, craft flagship Modules, and build and defend a planet together ([→](https://cowgalaxy.gitbook.io/cowgalaxy-docs/sandbox/en)) |
| **Portal** (cowgalaxy.com)                       | Wallet and profile, Agent Authorization, NFT marketplace, beta assets, XP, events, vouchers, and social data                                                                     |
| **Forum** (bbs.cowgalaxy.com)                    | Bug reports, discussion, guides (wallet login)                                                                                                                                   |
| **Wallet / block explorer**                      | Check on-chain assets, approvals, claim transactions                                                                                                                             |

***

## Quick wallet connection

The portal uses **Reown AppKit**:

* **Desktop**: click **Connect Wallet** and choose a browser wallet extension; or choose WalletConnect and scan with a mobile wallet.
* **Mobile**: open the portal in a wallet's in-app browser, or use WalletConnect to open an installed wallet.
* Open Beta runs on **Sepolia**. When prompted to switch networks, verify the domain and target network first.
* A **sign-in signature** only proves that you control the address; it is off-chain and costs no gas. Token / NFT approvals, asset claims, and trades are on-chain transactions.

The portal sign-in can normally be reused for **7 days**. The team will never ask for your seed phrase or private key.

***

## Official channels

| Channel     | Link                                               |
| ----------- | -------------------------------------------------- |
| Website     | [cowgalaxy.com](https://cowgalaxy.com/)            |
| Telegram    | [t.me/cowgalaxy](https://t.me/cowgalaxy)           |
| X / Twitter | [x.com/cowgalaxy2026](https://x.com/cowgalaxy2026) |
| Forum (BBS) | [bbs.cowgalaxy.com](https://bbs.cowgalaxy.com)     |

***

## Background (optional)

In the CowGalaxy, cattle split by belief into two interstellar federations — the **Galactic Empire** and the **Explorer Alliance**.\
Planets come in three kinds: Home, Federation, and Frontier. Players build ranches, raise cattle, and fight for resources and glory. Interstellar Rangeland covers raising and production, Interstellar Trek flies a flagship to light constellations, and Interstellar Sandbox turns those cattle, resources, and constellations into land that can be built and defended.

***

## Important notes

* Open Beta runs on testnet; beta assets will not migrate to mainnet. Real play, invites, social tasks, and feedback enter the beta XP ledger — see [04](/cowgalaxy-docs/handbook/en/04-beta.md).
* Keep your private key safe; the team will never ask for your seed phrase or private key.
* Most on-chain actions require an **approve** first, then a transaction; read the contract and amount before confirming.
* CowGalaxy Play Agent Keys authorize AI battles only; claims, transfers, and on-chain actions still require your wallet signature.

May your ranch prosper!


---

# 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://cowgalaxy.gitbook.io/cowgalaxy-docs/handbook/en/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.
