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

# The Lore

> **Rob the block. Share the wealth.**

Every mechanic in HOODLOOT is a piece of an old story. This is that story — and where each beat of it lives in the game.

***

## The Setting: Sherwood

The forest is deep and the law is thin. Out past the King's road, under the roots and inside the hollow oaks, a band of outlaws makes its home. This is **Sherwood** — your world, and the place your [Hideouts](/game-assets-and-token/hideouts.md) are carved into. You begin in a damp **Forest Hollow** and, if you loot well enough, you end crowned on the **Sherwood Throne**.

Sherwood isn't just scenery. Your Hideout is your ceiling: it decides how many outlaws you can field and how much they can carry. Climbing from the Hollow to the Throne *is* the arc of the story, told in slots and upkeep.

***

## The Rich Block

Somewhere at the heart of the story sits the wealth — hoarded, concentrated, guarded. In the old tale it's **Prince John's treasury** and the **Sheriff of Nottingham** stands over it. In HOODLOOT it's **the rich block**: every Robinhood Chain block emits fresh $SHARE, and that emission is the loot waiting to be taken.

**Robbing the rich block = mining.** Each block, the protocol releases new $SHARE and splits it among everyone doing the work, in proportion to their [Loot Rate](/game-mechanics/virtual-mining.md). You don't swing a pickaxe or run an ASIC — your outlaws take the block's loot, block after block, \~100ms at a time. The Sheriff never runs out of blocks to rob, and neither do you.

***

## The Merry Men

No outlaw robs alone. You recruit a band — the [**Merry Men**](/game-assets-and-token/outlaws.md) — and each one pulls their weight in loot. The story starts with a **Ragged Peasant** (free, one good arm and a bad bow) and builds, recruit by recruit, toward the legend himself: **Robin Hood, the Golden Arrow**.

Each Merry Man carries two truths of the tale:

* **Loot Rate (LR)** — how much of the block's take they can grab. The Golden Elf-Archer never misses; the Ragged Peasant barely does.
* **Upkeep (U)** — even outlaws must be fed and sheltered. Your Hideout can only support so much upkeep, so a bigger band needs a better base.

The first four recruits are humble humans of the villages — the Ragged Peasant, the Poacher, the Barefoot Archer, Much the Miller's Son. But the greenwood is old, and it is watching. From the mid-tiers upward **the elves of Sherwood answer Robin's call**: it begins with a lone **Elf Scout**, then an **Elven Ranger** cloaked in living leaves, and grows grander with every recruit — **Will Scarlet, Elf-Trained**, **Little John, Oakheart**, **Maid Marian, Elf-Blessed**, a **Sylvan Elf-Knight** in gilded leaf-armour, the **Golden Elf-Archer**, and the **Elf-Lord of Sherwood** crowned in silver and gold. The old magic wakes as the band grows, until Robin himself stands **elf-crowned and blazing** at the apex. Stacking the best of them into your best Hideout is how the legend is built.

***

## Giving to the Poor

Here's the part that makes it Robin Hood and not just a heist: the take doesn't stay hoarded.

Every time you spend $SHARE — recruiting a Merry Man, upgrading a Hideout, or ascending a rank — **75% of it is Given to the Poor**. In the story, that's the loot handed back to the villages the Sheriff bled dry. On-chain, that $SHARE is **burned** — removed from the supply, permanently, at the contract level. It never comes back.

The remaining **25%** goes to the [**War Chest**](/game-assets-and-token/share-token.md) — Robin's own treasury, the fund that keeps the cause running. So every spend does two Robin Hood things at once: it thins the hoard (burn) and it funds the fight (treasury).

{% hint style="success" %}
This is why $SHARE shrinks as the band grows. The more the outlaws take and spend, the more is given away — and the scarcer the loot becomes. Generosity is the deflation. Read the flywheel on [$SHARE Token](/game-assets-and-token/share-token.md).
{% endhint %}

***

## Becoming a Legend

Some outlaws pass into legend — sung by the elves of the greenwood, feared by the Sheriff, remembered long after the run is over. In the game, that's [**ascension**](/game-mechanics/legend-ranks.md): you give up your current run (a fresh start) in exchange for a **permanent multiplier** on everything you loot thereafter.

Each step into legend will demand a real sacrifice — and reward the outlaws who give the most and endure the longest with a multiplier that follows them forever. *(Legend Ranks are coming soon — the full path is revealed at launch.)*

***

## Tolls on the Road & Recruiting Outlaws

Not every gate in Sherwood opens for free. Milestone Hideouts and every Legend rank charge an **ETH toll** — the bribes and passage-money of the road, valued in USD via Chainlink and paid to the War Chest. They mark the moments the story turns.

And no band grows without word of mouth. [**Recruiting a Merry Man**](/game-mechanics/referrals.md) — sharing your address so others join the cause — earns you 2.5% of everything they loot, forever. The band grows; everyone eats.

***

## The Lore ↔ Mechanic Map

| The story            | The mechanic                                              |
| -------------------- | --------------------------------------------------------- |
| Rob the rich         | Mine the block reward each Robinhood Chain block          |
| Give to the poor     | 75% of every $SHARE spend is burned                       |
| Robin's war chest    | 25% of every spend routes to the treasury                 |
| The Merry Men        | 13 outlaws, Ragged Peasant → Robin Hood, the Golden Arrow |
| Hideouts in Sherwood | 9 Hideout tiers, Forest Hollow → Sherwood Throne          |
| Passing into legend  | Legend Ranks — a prestige multiplier, coming soon         |
| Tolls & bribes       | ETH tolls at milestone tiers (Chainlink ETH/USD)          |
| Recruiting outlaws   | 2.5% referral, forever                                    |

***

> The Sheriff hoards. The block is fat. The forest is watching. **Rob the block. Share the wealth.**


---

# 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.hoodloot.com/story/lore.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.
