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

# 2 Lore & Brand

> *“Whenever a dream is spoken aloud, a fox-orb glows brighter in the astral forest.”*
>
> The FortuneHunters universe blends **Korean shamanism (무당)** with neon-drenched cyber-Seoul. The result is a myth-punk setting where ancestral spirits guide destiny through 5G auroras and K-POP idols channel prophetic fortunes through AI.

***

## 2.1 Brand Pillars — Deeper Meaning

| Pillar             | Tagline                               | Expanded Narrative                                                                                                                          |
| ------------------ | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **WORLD-FIRST**    | *AI-Powered Oriental Divination*      | First platform where artificial intelligence masters authentic 四柱八字, creating the world's premier **AI + Eastern fortune-telling economy**. |
| **CULTURE FUSION** | Eastern Divination × Machine Learning | Revolutionary fusion of 3000-year-old 天干地支 system with GPT-4 AI, bringing Oriental mysticism to the digital age.                            |
| **SEEKER-OWNED**   | AI-Enhanced Destiny NFTs              | Every AI-interpreted Oriental divination becomes a unique digital asset, 100% owned by seekers in the new economy of wisdom.                |

### Visual Accent — “Five-Directions” (오방색)

Each core colour maps to a cardinal direction in traditional Korean cosmology, grounding the futuristic UI in heritage.

***

## 2.2 Mascot — *Mu-Yeoul* (무여울)

| Aspect      | Detail                                                                                              |
| ----------- | --------------------------------------------------------------------------------------------------- |
| Species     | *Gumiho* (nine-tailed fox) ascended to techno-shaman.                                               |
| Attire      | Indigo *hanbok* with fibre-optic linings, silver *norigae* USB charms.                              |
| Artifact    | **Fox-Orb** that stores dream fragments as voxel fireflies (favicon).                               |
| Personality | Mischievous but wise, speaks in riddles & K-slang.                                                  |
| Utility     | Appears in onboarding screens, error pages (“Dream lost? Let me catch it!”), seasonal festival art. |

> **Animation Cue:** Orb pulses in *dreamGrad* gradient (#FF4DDE→#00F9FF) whenever user earns >80 Dream Score.

***

## 2.3 Palette Usage Guidelines

| Token         | HEX                    | Role           | DO                             | DON’T                             |
| ------------- | ---------------------- | -------------- | ------------------------------ | --------------------------------- |
| midnight      | #0D1B2A                | Background     | 70 % of UI surfaces            | Use as text colour                |
| obang.red     | #C8161D                | Call-to-Action | Primary buttons, danger alerts | More than 10 % per screen         |
| obang.yellow  | #F5C300                | Reward         | Badges, coin icons             | Body text background              |
| obang.blue    | #1572D3                | Informational  | Links, tooltips                | Combine with red gradients        |
| obang.white   | #F2F2F2                | Surface        | Cards, modal backgrounds       | Pure #FFFFFF (breaks night theme) |
| cloudLavender | #D6CCFF                | Neutral        | Charts, secondary buttons      | Pair with yellow text             |
| dreamGrad     | linear #FF4DDE→#00F9FF | Glow accent    | Orb pulses, progress bars      | Use for large blocks of text      |

***

## 2.4 Typography & Voice

* **Primary Font:** Pretendard SemiBold (KR/Hangul) & Inter for Latin.
* **Tone:** Conversational mystic — mix of friendly emoji (🌙) and ritual verbs (“summon”, “ascend”).
* **Copy Rules:**
  1. Replace *earn* with **“harvest”** when describing high Dream Scores.
  2. Avoid Web3 jargon; instead of *gas fee* use **“spirit toll”** in tooltips.

***

## 2.5 Audio & Motion Identity

* **Signature SFX:** Soft *mok-tak* (temple wood block) when a dream is submitted.
* **Background Track:** 120 BPM synthwave fused with *buk* drum samples.
* **Motion Curve:** Cubic bezier (0.25, 0.46, 0.45, 0.94) for elastic, dreamlike easing.

***

## 2.6 Application Examples

1. **Mobile UI** — Neon fox-orb floats behind CTA; scrolling triggers gradient trails.
2. **Merch** — Indigo hoodie with embroidered orb that glows under UV light.
3. **Festival Posters** — Obang palette gradients, Hangul calligraphy overlay.
4. **AR Filter** — Users wear Mu-Yeoul mask; orb reacts to voice pitch.

These guidelines ensure that every Tweet, quest and smart-contract interface feels unmistakably **FortuneHunters**.

| Pillar             | Description                                                      |
| ------------------ | ---------------------------------------------------------------- |
| **WORLD-FIRST**    | Fortune-to-Earn model based on Four Pillars of Destiny readings. |
| **CULTURE FUSION** | Korean shamanism & neon K-POP aesthetics.                        |
| **SEEKER-OWNED**   | Users own 100 % of fortune content, metadata, and NFTs.          |

***

## Mascot — Mu-Yeoul

A cyber-shaman in indigo *hanbok* wielding a glowing fox-orb. This character represents guidance between the subconscious dream realm and the on-chain reality.

## Core Palette

| Token         | HEX                      | Usage                |
| ------------- | ------------------------ | -------------------- |
| midnight      | `#0D1B2A`                | Background & cards   |
| obang.red     | `#C8161D`                | CTA / warnings       |
| obang.yellow  | `#F5C300`                | Rewards / highlights |
| obang.blue    | `#1572D3`                | Links / info         |
| obang.white   | `#F2F2F2`                | Light surfaces       |
| cloudLavender | `#D6CCFF`                | Neutral accents      |
| dreamGrad     | linear `#FF4DDE→#00F9FF` | Glow animations      |


---

# 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://project-49.gitbook.io/fortunehunters/index.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.