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

# Welcome to Battlefrens

**Battlefrens** is a turn-based combat PVP game built on **free-to-play** and **battle-to-earn** models. Players compete for victory and earn different types of **on-chain rewards on Solana**, which can be used to craft new items, enhance future builds, and awaken even more powerful Frens.

Frens are inspired by the mascots of famous memecoins, brought into a world that blends medieval fantasy with futuristic elements.

***

### ⚔️ Awaken and collect powerful Frens

* Turn-based combat inspired by Rock, Paper, Scissors (RPS)
* Challenge other players and earn **$SOL** as rewards
* Progress to gather resources, craft powerful items, upgrade them, and awaken new Frens through the minting system.

***

### 🌍 Battles are at the core of the economy

* Every item is fully **on-chain**, including your inventory, tied directly to your wallet
* Your wallet = your login. No emails, no middlemen, no nonsense
* True F2P where free players can take part in the game economy
* Crafting & Forging system to create unique items

***

### 🏪 Freely trade Frens, items, and materials in a decentralized economy

* **MarketFray** → The main hub for buying and selling **Frens, equipment, essences, and other NFTs**.&#x20;
* **Materialia** → A specialized secondary marketplace for **valuable crafting materials**. Here, players exchange essential resources needed to forge and upgrade items.

***

### 💎 Key Features

| Feature                   | Description                              |
| ------------------------- | ---------------------------------------- |
| **P2E + F2P**             | Monetized and free gameplay options      |
| **$SOL Rewards**          | Earn rewards in Solana                   |
| **NFT Tiers (C → S)**     | Collect and upgrade NFTs                 |
| **Player-Driven Economy** | Entirely controlled by players           |
| **Full Web3**             | On-chain features and wallet integration |
| **Responsive**            | Works on any device                      |


---

# 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.battlefrens.fun/welcome-to-battlefrens.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.
