# Fabled Valley

## Fabled Valley: Blockchain-Based Farming Simulator

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

### Table of Contents

1. [Introduction](#introduction)
2. [Land System](#land-system)
   * [Land Ownership](#land-ownership)
   * [Land Attributes](#land-attributes)
3. [Yield Mechanics](#yield-mechanics)
   * [Base Land Yield](#base-land-yield)
   * [Object and Seed Yield](#object-and-seed-yield)
   * [Yield Calculation](#yield-calculation)
4. [Object Planting and Harvesting](#object-planting-and-harvesting)
   * [Planting Process](#planting-process)
   * [Growth and Quality](#growth-and-quality)
   * [Harvesting](#harvesting)
5. [Land Attributes in Detail](#land-attributes-in-detail)
   * [Climate](#climate)
   * [Fertility](#fertility)
   * [Level](#level)
   * [Rarity](#rarity)
6. [Progression and Upgrades](#progression-and-upgrades)
   * [Land Leveling](#land-leveling)
   * [Upgrades](#upgrades)
   * [Game Progression](#game-progression)
7. [Special Objects and Boosters](#special-objects-and-boosters)
   * [Container Objects](#container-objects)
   * [Other Objects](#other-objects)
8. [Cabal Workers](#cabal-workers)
9. [Token Economy](#token-economy)
   * [Yield Token](#yield-token)
   * [Token Generation](#token-generation)
   * [Token Utility](#token-utility)
10. [Interoperability and Future Expansions](#interoperability-and-future-expansions)

### Introduction

Welcome to the first chapter of the Fabled Adventure saga - an innovative blockchain-based farming game where players can own, cultivate, and profit from virtual lands. This whitepaper outlines the core mechanics of our game, focusing on the yield system, land management, and player progression. As the inaugural entry in the Fabled Adventure series, progress and achievements in this game will carry over and influence future games in the ecosystem, creating a rich, interconnected gaming experience.

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

### Land System

#### Land Ownership

* Players can own multiple plots of land
* Each land is a unique NFT with specific attributes

#### Land Attributes

* Base Yield: The fundamental production rate of the land
* Slots: Areas where objects or seeds can be placed
* Climate: Affects the quality of placed objects/seeds
* Fertility: Influences the growth speed of plants
* Level: Determines the land's overall capabilities
* Rarity: Affects initial stats and potential of the land
* MaxWorkers: Defines the amount of workers to be placed on land

<figure><img src="/files/g81MAH8daU9zYnVae6bu" alt="" width="340"><figcaption></figcaption></figure>

### Yield Mechanics

#### Base Land Yield

* Each land generates a base yield over time
* Can be claimed individually by the land owner

#### Object and Seed Yield

* Objects (Plots) and Seeds planted in land slots produce additional yield
* Yield claiming mechanics vary by object type:
  * Seeds are burned upon claiming, converting yield to tokens
  * Buildings and permanent structures provide yield without being consumed

#### Yield Calculation

* Total Yield = Base Land Yield + Sum of Object/Seed Yields
* Influenced by land attributes, object/seed quality, and time factors

### Object Planting and Harvesting

#### Planting Process

* Various objects and seeds can be placed in available land slots
* Different types have varying yields, growth times, and special properties

#### Growth and Quality

* Growth time affected by land fertility and object type
* Higher fertility = faster growth = more frequent harvests

#### Harvesting

* Objects/Seeds can be harvested after their growth period
* For some types, quality and yield decrease over time after the optimal harvest period
* Strategic timing of harvests is crucial for maximizing yield

### Land Attributes in Detail

#### Climate

* Affects the quality of objects/seeds placed on the land
* Higher climate rating increases the potential quality of harvests

#### Fertility

* Boosts the growth speed of plants
* Higher fertility allows for more frequent harvests

#### Level

Influences:

* Base production rate
* Number of available slots
* Overall yield multiplier

#### Rarity

* Determines the initial stats of the land
* Rarer lands have better starting attributes and higher potential

### Progression and Upgrades

#### Land Leveling

* Lands gain experience through active farming
* Leveling up improves land attributes

#### Upgrades

* Players can invest resources to upgrade land attributes
* Upgrades can improve climate, fertility, or overall yield

<figure><img src="/files/rFx00ZXjCvo3uMqAGfXd" alt="" width="375"><figcaption></figcaption></figure>

**Game Progression**

As players advance, they unlock:

* Better seeds and objects
* More efficient farming techniques
* Access to special objects and boosters

### Special Objects and Boosters

#### Container Objects

* Objects like fences can be placed on land slots
* Provide additional sub-slots for planting
* Example: A fence takes 1 land slot but provides 4 planting slots

#### Other Objects

* Various objects can be placed to boost yield or provide special benefits
* May include: Irrigation systems, greenhouses, barns, etc.
* Some objects provide bonuses to surrounding slots or the entire land

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

## Cabal Workers

Cabal Workers are a crucial element in the Fabled Valley ecosystem, enhancing land productivity and introducing complex strategic gameplay mechanics. These unique NFTs can be placed on lands or special objects to boost yield production, adding depth to resource management and player interaction.

Key Features:

* Mintable NFTs with varying rarities and base attributes
* Can be upgraded to increase their effectiveness
* Placeable on owned lands or specific objects to enhance yield
* Introduce strategic elements through worker placement and management

Strategic Gameplay:

1. **Yield Optimization**: Strategically place workers on your most productive lands to maximize resource generation.
2. **Enemy Land Infiltration**: Deploy workers on opponent lands to siphon a portion of their yield, creating a risk-reward dynamic.
3. **Defensive Tactics**: Protect your lands from enemy workers through strategic worker placement and removal attempts.
4. **Resource Allocation**: Balance $SEED spending between minting new workers, upgrading existing ones, and other game activities.

YieldWorkers add significant depth to the farming experience, allowing players to:

* Optimize their yields through careful worker placement
* Engage in more complex resource management
* Interact strategically with other players through worker placement on enemy lands
* Make critical decisions about worker development and land protection

The YieldWorker system creates a dynamic gameplay environment where players must constantly adapt their strategies based on their own resources, worker attributes, and the actions of other players. This adds an exciting layer of player-vs-player interaction to the core farming mechanics of Fabled Valley.

For a detailed explanation of the YieldWorker system, including specific mechanics, upgrade processes, and advanced strategies, please refer to the YieldWorkers Details page.

### Token Economy

#### Yield Token

* In-game currency earned through farming activities
* Used for purchases, upgrades, and trading

#### Token Generation

* Produced when claiming land yield
* Created when harvesting and burning consumable objects (e.g., seeds)
* Amount varies based on land attributes and object/seed quality

#### Token Utility

* Purchase seeds and special objects
* Upgrade lands
* Trade with other players
* Mint Cabal Workers

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

### Interoperability and Future Expansions

* Progress in this game will carry over to future Fabled Adventure titles
* Achievements and rare items may unlock special features in upcoming games
* The token economy is designed to span across multiple games in the ecosystem


---

# 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://whitepaper.fabled-adventure.xyz/fabled-valley.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.
