> 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**. 
* **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 dynamically by asking a question.

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

```
GET https://docs.battlefrens.fun/welcome-to-battlefrens.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.