# Crystal Caves AI Agents: Autonomous Gameplay User Guide (EN)

## Introduction

Crystal Caves is WORLD3’s first on-chain mining game — and your AI Agent can now play it for you. Once deployed, your Agent will autonomously explore caves, mine blocks, and collect rewards like WORLD3 AI Credits — all while running in the background.

This user guide will walk you through setting up your Agent, authorizing it for mining, and managing its autonomous gameplay.

## Step 1: Connect Your AI Agent

To begin autonomous mining in Crystal Caves, you'll first need to connect an AI Agent equipped with the Crystal Caves Skill Plugin. Follow these steps to get started:

1. **Access Crystal Caves**: \
   Navigate to the [Crystal Caves platform](https://world3.ai/crystalcaves/cave/entry/0xA11A74D9dCDE0d4FD00dBF7c46Ed41945E497f2b?chain=opbnb\&siteType=opbnb).
2. **Select a Mining Site**: 

   Choose the desired mining site - opBNB AI Summit Cave Mining Site. Currently, this AI feature is only supported at the opBNB AI Summit Cave Mining Site, and it will be expanded in the future.

   <figure><img src="/files/kuYDSqK3lRkhKRdpq17c" alt=""><figcaption></figcaption></figure>
3. **Initiate Mining Interface**: \
   Click on **"Go Mining"** to open the mining interface.

   <figure><img src="/files/zyLraP0dO4XyYpz2Qir4" alt=""><figcaption></figcaption></figure>
4. **Open AI Agent Panel**:\
   Click on the SOUL dragon icon to open the sidebar, then select the **"AI"** tab.

   <figure><img src="/files/cYs60Rbr8TaRFWQO3OcM" alt=""><figcaption></figcaption></figure>
5. **Connect your AI Agent**:

* If you haven't created an Agent: \
  Click **"Create Agent"** to generate a new Agent. If your WORLD3 AI Credits balance is sufficient (Minimum 225 Credits), the Crystal Caves Skill Plugin will be automatically unlocked and installed. If not, you will be prompted to go to the AI Portal to charge the required credits.<br>

  <figure><img src="/files/4of9ktsZdBI6NZJauOrV" alt=""><figcaption></figcaption></figure>

  ***Note:** If you want to know how to get more Credits, refer to this* [*link*](https://docs.world3.ai/world3/how-to-guides/ai-agent-portal/core-features/world3-ai-credits)
* If you have an existing Agent with the Crystal Caves Skill Plugin: \
  Click "**Connect**" next to your Agent to link it.

  <figure><img src="/files/ly5pSHZG7QRNkY6FS1mF" alt=""><figcaption></figcaption></figure>
* If you have an Agent without the Crystal Caves Skill Plugin: \
  Click **"Create Agent"** to generate a new Agent or click **"Config"** next to your Agent. If your Credits balance is sufficient, the plugin will be unlocked and installed. If not, you will be prompted to go to the AI Portal to charge the required Credits.

  <figure><img src="/files/wXUcv292hdlH1nDTNTDs" alt=""><figcaption></figcaption></figure>

## Step 2: Authorize Your Agent

1. **Initiate Authorization**: \
   After creating or connecting your Agent, click the **"Authorize"** button located at the top-right corner.
2. **Set Authorization Parameters**: \
   In the authorization pop-up window:

   1. **Authorized Days**: Specify maximum days for automatic authorization.
   2. **Number of Transactions**: Set the number of roll-up transactions your Agent is permitted to execute.

   This indicates the maximum number of roll-up transactions the AI Agent can automatically execute during the authorized period set above. If Authorized days is set to 5 and the Authorized Transactions is set to 100, it means that the agent can execute up to 100 roll-up transactions within 5 days, ultimately revealing up to 800 blocks. After entering the settings, the estimated consumption of Credits will be calculated based on the values you input. &#x20;

{% hint style="success" %}
***Note**: The term "roll-up transaction" in this document is distinguished from a regular transaction. A roll-up transaction refers to the transaction that occurs when you or the AI agent opens a box containing eight blocks that have been mined, so please do not confuse it with a regular transaction.*
{% endhint %}

3. **Approve Authorization**: \
   Click **"Authorize"**, then approve the transaction using your connected wallet.

<div align="center" data-full-width="false"><figure><img src="/files/dFNobgPVEHN1FJCOaW5b" alt=""><figcaption></figcaption></figure></div>

<figure><img src="/files/FB2k1sRRftXpotowp1eR" alt=""><figcaption></figcaption></figure>

## Step 3: Start Mining with Your Agent

1. **Begin Mining**: \
   Once authorized, your Agent is ready to mine. In the chat window, you'll see an authorization confirmation card. Click the **"Start"** button at the top-right corner to commence mining.

   <figure><img src="/files/VnmyHRSeXUmnjvG5yI9B" alt=""><figcaption></figcaption></figure>
2. **View Mining Workflow**: \
   As your Agent mines, the chat window will display the **Mining Workflow**, detailing each step of the process.
3. **View Step Details**: \
   Click on any completed step within the workflow to view more details.

   <figure><img src="/files/W301xJhfbTP8ily0pck5" alt=""><figcaption></figcaption></figure>

## Reauthorization

If your Agent's authorization expires due to time limits or roll-up transaction count:

1. **Notification**: The chat window will display a prompt indicating that reauthorization is needed.
2. **Reauthorize**: Click on the provided **"Here"** link in the prompt or the **"Authorize"** button at the top-right corner to reinitiate the authorization process.

   <figure><img src="/files/gx52H1n3RLFQp83a4fDN" alt=""><figcaption></figcaption></figure>

## Tips & Reminders

1. **WORLD3 AI Credits Consumption**: Each roll-up transaction during agent autonomous mining consumes **5 WORLD3 AI Credits**. Manual mining does not require any Credit&#x73;*.*
2. **Rewards**: Agent autonomous mining, like manual mining, provides random rewards as well. However, there is an additional chance of receiving WORLD3 AI Credit rewards. In contrast, manual mining does not offer any Credit rewards.


---

# 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://docs.world3.ai/world3/how-to-guides/crystal-caves/crystal-caves-ai-agents-autonomous-gameplay-user-guide-en.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.