# Start Here

Roots of Embervault is a top-down pixel-art RPG set in the Ruyui Universe, live on Abstract Chain with some onchain RNG systems powered by Proof of Play. Build your character, explore dangerous lands, defeat monsters, craft legendary equipment, and shape the future of Embervault.

***

**Core principles:**&#x20;

**(1)** Meaningful progression, your choices matter and they define your character. \
**(2)** Skill-based gameplay: master combat, optimize builds, win through strategy.\
**(3)** Player-driven economy: everything you earn has real value.

Embervault is one of the most important cities in the Ruyui Universe. Through exploration and quests, you'll uncover the lore of this expanding world.

Welcome to Embervault.

*The Ruyui Team*

***

{% hint style="info" %}
**🔥 Season 0: Death Mode**\
Test your skills in our competitive speedrun challenge. Fight waves of monsters and compete for prizes. [<mark style="color:$info;">Learn More →</mark>](/season-0-death-mode/intro)
{% endhint %}


# Account Setup

* Go to [<mark style="color:orange;">**https://embervault.ruyui.com/**</mark>](https://embervault.ruyui.com/)
* Press "Play Now" and connect your **Abstract Global Wallet**&#x20;
* Press "Login" and create a game account.&#x20;
  * Creating a game account requires 0.005 ETH \~ 15 USD
* Game account will be automatically created.&#x20;
* You can use a friend's referral code, if you don't have a referral code, you can skip this step by pressing "Skip". *(More information on referrals can be found*[ *<mark style="color:orange;">here</mark>*](/overview/referrals)*)*
* Create your username
* Enjoy the game!

{% hint style="warning" %}
If this is your first time using **Abstract Global Wallet**, please click [here ](https://abs.xyz)to create a wallet.
{% endhint %}


# Gameplay

#### Core Loops <a href="#account-setup" id="account-setup"></a>

* **Explore:** Engage with the village's founders and inhabitants, complete quests
* **Combat:** Fight monsters real time, collect runes and loot
* **Collect Resources:** Gather resources like wood, ores and herbs.&#x20;
* **Brew & Cook:** Brew potions and cook food for temporary buffs.&#x20;
* **Smith:** Repair, craft, upgrade and maintain your equipment.
* **Character Progression:** Spend runes to create a unique character build shaped entirely by your choices

#### Explore <a href="#account-setup" id="account-setup"></a>

Venture into the world, talk to NPCs, accept quests, and discover new areas.&#x20;

#### **Combat**

The creatures around Embervault are showing unnatural aggression towards the villagers and travelers. To make sure that the village can thrive, you are sent by the guild to make sure that supply routes are clear and the village is safe.&#x20;

<figure><img src="https://1881800036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNdJ63VcquVafLwx1yxII%2Fuploads%2FYor13GWV9XcjFmD22oh8%2FRecording2026-01-25211719-ezgif.com-optimize.gif?alt=media&amp;token=41c2a12b-c4f5-440a-ae36-2493a315b093" alt=""><figcaption></figcaption></figure>

#### **Collect Resources**

Craft tools, weapons, gear, potions and food.&#x20;

<figure><img src="https://1881800036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNdJ63VcquVafLwx1yxII%2Fuploads%2FA41xjCsUP1cv7utdebec%2F9ec6a7c0-8caa-413d-9e7c-c1dfef89ecc1.gif?alt=media&amp;token=ae40b584-0e05-4c1b-bdb1-72f355f9c437" alt=""><figcaption></figcaption></figure>

#### Level Up

Visit the Old Temple, decide your character build and level up.&#x20;

<figure><img src="https://1881800036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNdJ63VcquVafLwx1yxII%2Fuploads%2FoIrrz3b6TWTsfQmpn5ZZ%2Flevel.gif?alt=media&amp;token=e88408e7-d9b7-48d1-a661-511aa8f92ec1" alt=""><figcaption></figcaption></figure>


# Guild Pass

Unlock the full Roots of Embervault experience.

Civillians can play the core RPG systems and learn the game, while Guild Members gain unrestricted access to the world, different tiered equipments, and competitive features.

<figure><img src="https://1881800036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNdJ63VcquVafLwx1yxII%2Fuploads%2FTbaAOFLCZVsO3GMsASOh%2Fimage.png?alt=media&amp;token=5b4ee3e1-cfff-4831-9a7e-76b9afc880b7" alt=""><figcaption></figcaption></figure>

| Feature                                    | Civillians | Guild Member |
| ------------------------------------------ | ---------- | ------------ |
| Core gameplay & combat                     | ✅          | ✅            |
| Character progression & leveling           | ✅          | ✅            |
| Story quests                               | ✅          | ✅            |
| Access to full world map                   | ❌          | ✅            |
| Online marketplace (buy & sell rare items) | ❌          | ✅            |
| All items available                        | ❌          | ✅            |
| All enemies available                      | ❌          | ✅            |
| Global leaderboard eligibility             | ❌          | ✅            |

{% hint style="info" %}
Becoming a Guild Member is done through purchasing Guild Pass via in-game shop.&#x20;
{% endhint %}

<figure><img src="https://1881800036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNdJ63VcquVafLwx1yxII%2Fuploads%2FkBTvZiCBZl3GspGFx0O5%2FGroup%2037.png?alt=media&amp;token=ea393a2c-f74a-44ca-89a5-95ba7f49446d" alt=""><figcaption></figcaption></figure>


# Referrals

The Roots of Embervault referral system lets you earn a fee% of everything your referrals spend. Automatically.

Players get a 10% fee from:

* New player signups
* Guild Pass purchases
* All in-game shop purchases (skins, cosmetics, kits, special items...)&#x20;

every time someone uses their referral to join Roots of Embervault.&#x20;

Paid directly to their wallet.&#x20;

***

### How to Get Your Referral Code

1. Click the referrals icon in your HUD
2. Copy your link (you can also share your username)
3. Share it

When someone joins with your link/username → you start to earn immediately.

***

### Current Rate

Referral rate is currently **10%** and subject to change in the future.


# Level Progression

#### Runes & Leveling&#x20;

Main in-game currency is called "Runes" and can be earned by:

* Defeating enemies
* Completing quests
* Clearing dungeons
* Trading items with merchants<br>

Leveling up requires visiting the Old Temple and spending runes to distribute attribute points.

<figure><img src="https://1881800036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNdJ63VcquVafLwx1yxII%2Fuploads%2FoIrrz3b6TWTsfQmpn5ZZ%2Flevel.gif?alt=media&amp;token=e88408e7-d9b7-48d1-a661-511aa8f92ec1" alt=""><figcaption></figcaption></figure>

***

#### Attributes

Attributes define your build and playstyle.

| <mark style="color:$info;">**Attribute**</mark> | <mark style="color:$info;">**Effect**</mark>                                                                                                                                                                                                                                                                                                                                                   |
| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Vigor                                           | Increases maximum HP                                                                                                                                                                                                                                                                                                                                                                           |
| Endurance                                       | Increases maximum stamina and max carry load                                                                                                                                                                                                                                                                                                                                                   |
| Arcana                                          | <p>Increases maximum mana<br></p><p>Attribute required to perform magic skills and to wield magic armaments.<br></p><ul><li>Not active during Season 0.</li></ul>                                                                                                                                                                                                                              |
| Strength                                        | <p>Attribute required to wield heavy armaments</p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>Boosts attack power and guard of strength-scaling armaments.<br><br>Also Influences player physical defense.</p></div>                                                                                                                           |
| Dexterity                                       | <p>Attribute required to wield advanced and light armaments</p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>Boosts attack power and guard of dexterity-scaling armaments.<br><br>Also reduces casting time of magic skills.</p></div>                                                                                                           |
| Intelligence                                    | <p>Attribute required to perform magic skills and to wield magic armaments.</p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>Additionally enhances the power of magic skills and improves resistance stats. <br><br>Also boosts attack power and guard of intelligence-scaling armaments.</p></div><ul><li>Not active during Season 0.</li></ul> |
| Luck                                            | Improves loot quality and amount, bonus Rune drops, and critical hit chance.                                                                                                                                                                                                                                                                                                                   |

{% hint style="info" %}
Players will be able to redistribute their attribute points in the future.&#x20;
{% endhint %}


# Health & Stamina

***

### Health Management

**Full Health Recovery:**

* **Leveling Up** - Instantly restores health to maximum
* **Sleeping (Player House)** - Fully replenishes health
* **Health Potions**

**Health Buffs:** Some potions and meals provide temporary buffs that increase your maximum health for a limited time.

#### Increasing Maximum Health

To increase your maximum health capacity, distribute attribute points into **Vigor** when leveling up.

***

### Stamina Management

Stamina is only consumed during combat by using the following actions:&#x20;

* **Sprinting** - Drains stamina constantly
* **Dash** - Drains stamina quickly
* **Attack** - Drains stamina with each strike

**When your stamina is low or reaches zero, these actions become limited or unavailable.**

#### Stamina Recovery

Stamina replenishes quickly over time, even during combat, as long as you're not actively sprinting, dashing, or attacking. The regeneration is relatively fast, allowing you to recover quickly between actions.

You can also consume **Stamina Potions** or eat **Cooked Food** for instant stamina recovery. Different consumables restore varying amounts of stamina.

#### Increasing Maximum Stamina

To increase your maximum stamina capacity, distribute attribute points into **Endurance** when leveling up.


# Death

### Rune Recovery

When a player dies:

* <mark style="color:$warning;">All carried</mark> <mark style="color:$warning;"></mark><mark style="color:$warning;">**Runes**</mark> <mark style="color:$warning;"></mark><mark style="color:$warning;">drop at the exact location of death.</mark>
* The player may return to that location to recover the dropped Runes.
* If the player dies again before recovering them, the previously dropped Runes are <mark style="color:$warning;">permanently lost.</mark>

***

### Inventory Loss

Death triggers an RNG-based inventory loss:

* You will lose either **50%** or **100%** of your active inventory items.
* The outcome is determined at the moment of death.

***

### Protected Items

The following are **never deleted** on death:

* Shop-purchased items
* Loot Boxes
* Equipped items
* Quick-slotted items

***

<figure><img src="https://1881800036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNdJ63VcquVafLwx1yxII%2Fuploads%2F2zqEB9vpK6Wqbl8Jvt4f%2Fdown_death-export.gif?alt=media&amp;token=33be31e9-12dc-48b1-9d8d-875741df1091" alt=""><figcaption></figcaption></figure>


# Ruyui NFT Perks

Ruyui NFTs are the core of our ecosystem, and we're committed to rewarding holders with meaningful benefits. Our approach prioritizes long-term sustainability over short-term hype.

### Our Philosophy

We're starting small and scaling up over time. Many web3 games have crashed by over-promising NFT perks from day one, creating unsustainable expectations and breaking game balance. We're taking a different path.

**Why start small?** You can always scale up, but you can't scale down without breaking trust. By building perks gradually, we can:

* Keep gameplay fair for everyone
* Welcome new players without gatekeeping
* Deliver consistent value without compromising balance
* Grow the perk system as the ecosystem grows

### Current NFT Benefits

**Global Leaderboard Multipliers** \
NFT holders receive ranking boosts when tied with non-holders. The more Ruyui NFTs you hold (by amount), the higher your multiplier. This affects leaderboard positioning and related rewards.

#### Multiplier Logic

* Every additional NFT increases your multiplier
* Multiplier growth follows a diminishing returns model
* Tier bonuses unlock at:
  * 1 NFT
  * 7 NFTs
  * 20 NFTs
  * 50 NFTs
  * 100 NFTs
  * 200 NFTs
* Total multiplier is capped at **1.35x**

#### Score Formula

<mark style="color:$primary;">`Level × 1000 × Multiplier`</mark>\
Score is rounded down to the nearest whole number.

#### **Shop Discounts**

Discounts on Guild Passes, skins, loot boxes, and other in-game shop purchases. *(Coming soon)*

#### **Multiplayer Skins**&#x20;

Use your Ruyui NFTs as character skins in multiplayer. *(Releasing with multiplayer features)*

#### **Free Event Entries**&#x20;

Free entries to seasonal competitive events like Death Mode. *(Details TBA)*

#### More Coming

We have many additional perks in development. Each one has a specific time and reason for release, ensuring they enhance your experience without compromising fairness.

{% hint style="warning" %}
**Our Commitment:** Holding Ruyui NFTs will **never** grant advantages in core gameplay or progression. Perks focus on cosmetics, convenience, economic benefits, and exclusive access, rewarding holders without creating pay-to-win scenarios.
{% endhint %}


# Merchant

You can buy and sell items with **Filburt**, using **Runes.**

<figure><img src="https://1881800036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNdJ63VcquVafLwx1yxII%2Fuploads%2Fj8ENhooRnPn8ygimwMUh%2Fmerchant_filburt_idle_front.gif?alt=media&amp;token=2a3e8323-a81f-4e7d-befa-5dfbbd88c681" alt="" width="96"><figcaption><p>Filburt</p></figcaption></figure>

**What You Can Trade:**

* Purchase items from Filburt
* Sell items you've gathered or crafted to Filburt in exchange for **Runes**

**Access:**

* Available to all players (both Civilians and Guild Pass holders)
* Civilians can only trade Common rarity items with Filburt
* Guild Pass holders can trade items of all rarities

<figure><img src="https://1881800036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNdJ63VcquVafLwx1yxII%2Fuploads%2Fs0QjKsQtEkuoOYewgsdE%2Ftma-ezgif.com-video-to-gif-converter.gif?alt=media&amp;token=6f4cbbb1-ce98-48fe-979a-ffe9f682b08d" alt=""><figcaption></figcaption></figure>


# PvP Marketplace

The online marketplace is an integrated onchain marketplace that allows players to trade items with each other using **ETH** easil&#x79;**.**&#x20;

**Features:**

* Filter items by type and rarity
* Real-time ETH to USD value indicator
* View all active listings

**Access:**

* **Civilians:** Can view all listings but can only purchase or sell Common rarity items
* **Guild Pass holders:** Full marketplace access for all rarities

**Transaction Details:**

* All trades are permanent and cannot be reversed

{% hint style="info" %}
Be aware:\
\- It may take time (a minute or so) for items you've purchased to appear in your inventory. \
\- If you're trying to make a purchase and see a transaction error in AGW, there is a high possibility that someone already purchased the item before you.&#x20;
{% endhint %}

{% hint style="warning" %}
PvP Marketplace will go live a few days after mainnet launch.&#x20;
{% endhint %}


# Items & Sinks

Everything you can find, craft, and use in Embervault. Items are obtained through exploration, combat, crafting, trading, or quest rewards.

#### **📦 Resources**

Raw materials used for crafting, brewing, cooking, and upgrading.

**Where to get them:**

* **Trees** → Wood (requires Axe)
* **Ore Nodes** → Ores (requires Pickaxe)
* **Enemies** → Monster loot
* **Merchants** → Purchase basic resources from NPCs

All resources are tradeable on the PvP marketplace and with merchants.

***

#### **⚔️ Equipment**

Gear that can be equipped to improve your character's capabilities.

**Weapons**

* Used for combat damage
* Scale with Strength, Dexterity, or Intelligence

{% hint style="info" %}
v0.0.1 only includes a Short Sword that scales with Dexterity. Updates will include more weapon types and mechanics. &#x20;
{% endhint %}

**Armor**

* 5 equipment slots: Torso, Legs, Helmet, Gloves, Boots
* Increases armor stat to reduce incoming damage
* May provide additional effects

**Tools**

* **Axe** - Chop trees for wood
* **Pickaxe** - Mine ore nodes
* Can be used for combat (less damage output compared to weapons)
* Higher tier items gather faster

***

#### **🧪 Consumables**

Items that restore resources or provide temporary buffs.

**Potions**

* Restore HP, Mana, or Stamina
* Grant temporary buffs (damage, defense, etc.)
* **Multiple potion effects can stack**
* Brewed at the Alchemist

**Food**

* Grant temporary stat buffs
* **Only ONE food buff active at a time**
* Lasts 15 minutes (one full day/night cycle)
* Cooked at the Player House kitchen

***

#### **⚠️ Durability System**

All equipment has durability that decreases with use.

**How durability is lost:**

* **Weapons & Tools** - Lose durability per hit (enemies or resource nodes)
* **Armor & Accessories** - Lose durability when you take damage (all equipped pieces lose durability simultaneously)

**Durability display:**

* Shown as percentage range (0-100%) in item description
* Visual indicator in HUD

**When durability hits 0:**

* Item becomes **broken**
* Cannot be used, equipped, or traded
* Must be repaired at the Blacksmith

***

#### **🎒 Special Items**

Quest items, shop utility items, and unique collectibles that don't fit other categories. Most special items are non-tradeable.


# Monsters

### **Rune Rewards**

**Every mob drops rune rewards.**&#x20;

| Monster         | Min Rune Drop | Max Rune Drop |
| --------------- | ------------- | ------------- |
| Forest Slime    | 10            | 100           |
| Crystal Bat     | 10            | 100           |
| Mushroom Sprite | 50            | 200           |
| Rock Muncher    | 50            | 200           |
| Shadow Wolf     | 250           | 800           |
| Cave Crawler    | 300           | 1000          |
| Wooden Golem    | 600           | 1600          |
| Ore Elemental   | 500           | 2200          |

### Monster Loot

All monsters have 3 different loot types. <br>

Common Loot Quantity : 1-6

Uncommon Loot Quantity: 1-4

Rare Loot Quantity: 1-2&#x20;

<table><thead><tr><th>Luck</th><th>Common  (drop chance%)</th><th>Uncommon (drop chance%)</th><th data-type="number">Rare (drop chance%)</th></tr></thead><tbody><tr><td>0</td><td>35</td><td>8</td><td>0.8</td></tr><tr><td>30</td><td>59</td><td>21.2</td><td>3.3</td></tr><tr><td>50</td><td>75</td><td>30</td><td>5</td></tr><tr><td>75</td><td>95</td><td>41</td><td>7.1</td></tr><tr><td>100</td><td>100</td><td>52</td><td>9.2</td></tr></tbody></table>


# Forging

Visit the Blacksmith in the village to craft, upgrade, repair, and dismantle equipment.

#### **🔨 Crafting Equipment**

Create new weapons, armor, tools, and accessories.

**Requirements:**

* Specific resources + Runes
* Meet minimum player level
* Some recipes require special achievements or discovery

**Recipe unlocking:**

* Most recipes unlock through leveling
* Hidden/legendary recipes require exploration or special mechanics

***

#### **⬆️ Upgrading Equipment**

*Improve weapons and tools through three upgrade levels.*

**Upgrade path:**

1. Base Item (Normal)
2. +1 Upgrade
3. +2 Upgrade
4. +3 Upgrade (Maximum)

**Each upgrade:**

* Increases base stats
* May improve scaling letters (e.g., B → A)
* May add special effects
* Costs resources + Runes

**Why upgrade:**

* +3 items are significantly more powerful than base
* Upgraded items are more valuable for trading

***

#### **🔧 Repairing Equipment**

Restore durability to damaged gear.

**Process:**

* Visit the Blacksmith
* Pay repair cost (resources/Runes)
* Equipment restored to full durability

**Important:**

* Repair costs scale with item tier and quality

***

#### **♻️ Dismantling Equipment**

Break down unwanted equipment to recover crafting materials.

**How it works:**

* Select item to dismantle
* Item is destroyed permanently
* Receive less than **50% of original crafting materials** back

**When to dismantle:**

* Outgrown equipment you won't use
* Need specific materials quickly
* Clearing inventory space


# Brewing & Cooking

Create consumables to enhance your character's performance.

#### **🧪 Brewing Potions (Alchemist)**

Visit the Alchemist in the village to brew potions.

**What potions do:**

* Restore HP, Mana, or Stamina instantly
* Grant temporary buffs (damage, defense, resistance, etc.)
* Provide utility effects

**Key feature:**

* **Multiple potion effects can be active simultaneously**
* Example: Use a health potion + damage buff potion + defense buff potion all at once

**Requirements:**

* Herbs and materials gathered from the world
* Meet minimum player level for each recipe
* Some recipes require special unlocks

**Potion tiers:**

* Higher-tier potions provide stronger effects
* F2P players limited to Common tier
* Guild Pass unlocks all tiers

***

#### **🍳 Cooking Food (Player House)**

Use the kitchen in your Player House to cook food.

**What food does:**

* Grants temporary stat buffs
* Lasts **15 minutes** (one full day/night cycle)

**Key limitation:**

* **Only ONE food buff can be active at a time**
* Eating new food replaces the previous buff

**Strategy:**

* Cook food before heading out for difficult content
* Choose food based on your immediate needs (HP boost, damage increase, etc.)
* 15-minute duration is generous—use it liberally

**Requirements:**

* Ingredients from gathering, merchants, or drops
* Meet minimum player level for recipes
* Some hidden recipes require discovery

***

#### **Recipe System**

Both brewing and cooking recipes:

* Unlock at specific player levels
* May have additional special requirements
* Hidden recipes discovered through exploration or achievements
* Recipes persist once unlocked


# Weight System

Manage your carrying capacity to stay mobile in combat and exploration.

#### **How Weight Works**

**Total Load Calculation:**

* Every item has weight (except Special Items)
* Total Load = Inventory weight + Equipped gear weight

**Max Load:**

* Base Max Load value
* Increases when you level up **Endurance** attribute
* Determines how much you can carry before penalties

***

#### **Load States**

**Below Max Load**

* Move and act freely
* No penalties or restrictions

**Encumbered (Exceeded Max Load)**

When you exceed Max Load, you become **encumbered**:

❌ **Disabled:**

* Cannot run/sprint
* Cannot jump
* Cannot hold block

⚠️ **Limited:**

* Can still parry, but cannot sustain it

***

#### **UI Indicators**

**HUD Indicator:**

* Vertical bar showing load percentage
* Fills based on current weight vs. Max Load

**Inventory Display:**

* Numeric weight display (e.g., "45 / 100")
* Shows current carried weight and Max Load
* Updated in real-time

***

#### **Managing Weight**

**Tips:**

* Store excess items in your Player House chest
* Sell or dismantle unneeded equipment
* Increase Endurance to raise Max Load
* Plan inventory before long expeditions

**Marketplace note:**

* You can purchase items even when at Max Load
* Items go to inventory but you become encumbered
* Return to village to manage weight

***

####


# Intro

### What is Death Mode?

Death Mode is a competitive speedrun challenge where you fight through waves of monsters in a special arena.

**The goal:** Clear as many waves as possible, as fast as you can.

Everyone faces the same arena, same waves, same monsters. Your performance depends on your build, preparation, and execution.

<figure><img src="https://1881800036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNdJ63VcquVafLwx1yxII%2Fuploads%2FnoCY6i2oU2FB2AzqcQmP%2Fgif-4-ezgif.com-video-to-gif-converter.gif?alt=media&amp;token=e6943b57-3d24-44db-80a3-88aaeed5e6fb" alt="Build Preview - Subject to Change "><figcaption><p>Build preview. Doesn't reflect the exact waves; subject to change. </p></figcaption></figure>

***

### Supply Packs

Before each run, you'll choose a supply pack:

* **Health Pack**
* **Stamina Pack**
* **Mixed Pack**

**Unused supplies are kept if you clear all waves. Lost if you fail.**

***

### What Carries Into Death Mode

✅ Your level, stats, and attributes ✅ Your equipped gear ✅ Your active buffs

❌ No durability loss ❌ No equipment breaking

***

*More information coming soon.*


# Leaderboard & Rewards

Death Mode runs on a seasonal leaderboard.

**Rankings are determined by:**

1. Highest wave reached
2. Completion time (if wave is tied)

Your leaderboard entry shows your best run only.

***

### Rewards

Prizes include:

* USDC from the prize pool
* NFTs
* Exclusive in-game items

Top performers each season earn rewards based on their final ranking.

***

{% hint style="warning" %}
More details re: entry requirements and dates will be announced later.&#x20;
{% endhint %}


# Program Intro

Welcome to the Ruyui Creator Program - an official initiative to recognize, support, and reward community members who create content about our game and IP. This is your opportunity to grow with Ruyui from day one while earning rewards and building your reputation on-chain.

The future of gaming is deeply intertwined with content creation. As web3 gaming enters its next era, communities that generate consistent media, engagement, and narrative become the strongest drivers of retention and expansion.

The Creator Program ensures that those who help build this world socially are recognized, supported, and rewarded.<br>

#### **Program Goals**

\
The Creator Program is designed to:

* Empower Creators to grow alongside Ruyui
* Incentivize and Reward Consistent and high quality content
* Strengthen Community Identity and Engagement
* Reward Creators through both in-game and real-world value
* Establish Roots of Embervault as a Culturally Dominant Ecosystem in Web 3 Gaming and beyond

<figure><img src="https://1881800036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNdJ63VcquVafLwx1yxII%2Fuploads%2FdV8GViiMI66h6qLVpog7%2Fdance.gif?alt=media&amp;token=c059904d-c24f-45b0-b455-9df775a59787" alt=""><figcaption></figcaption></figure>

#### **Who it’s for**

The Program is open to all Creators that are genuinely passionate about the Roots of Embervault and express themselves in many different formats:

* Streaming Gameplay&#x20;
* Educational Content&#x20;
* Guides & Tutorials&#x20;
* Information Updates & News
* Lore and storytelling
* Creative/Art
* Long and short form Threads
* Video Gameplay&#x20;
* Graphics&#x20;
* Memes
* Mixed Content

#### Creator Responsibilities

Creators are expected to:&#x20;

* Publish and maintain a Biweekly Posting Schedule (1 Piece of Content every 2 weeks)
* Content must be specifically related to Ruyui: Roots of Embervault&#x20;
* Tag [<mark style="color:$warning;">@RuyuiStudios</mark>](https://x.com/RuyuiStudios) in all content made (Content then gets sent to your Personal Ruyui Hub account for Max engagement from team + other Creators)
* Engage with other creators to build shared reach and mindshare

{% hint style="info" %}
How to Apply: Reach out to [<mark style="color:$warning;">OG</mark>](https://x.com/MindfulMarketOG) on X or Discord to receive the ROE Creators Application Form.&#x20;
{% endhint %}


# Reward System

Designed to reward Creators that are genuinely passionate, creating consistently and meeting set criterias on a monthly basis and beyond through NFTs, monetary value and in-game creator specific items through a tiered benefit system.

\
Creators advance through **4 progressive tiers** based on cumulative performance over time (as evaluated by our team).&#x20;

This system rewards long-term commitment and consistent quality.\
\
**Qualifying Content Creator Rewards:**

* **Roots of Embervault SBT**: our Soulbound Token will be used to track progress, reward consistency, allocate rewards and progress through our Tier System.&#x20;
* **Creator Based Cosmetics:** Official Cosmetics designed ONLY for Creators.
* **In-game Shop items:** Utility based items to help in-game progression and quality of life.
* Engagement from the Official brand account and Ruyui Team members to help with growth and reach.
* Early access to new features and updates
* **Creator Badge** on the Hub Platform w/ Multiplier perks
* Access to giveaway Guild Passes on a weekly time table.
* **$50 USDC** to two Content Creators on a weekly schedule&#x20;
* Top 5 Performers on a Monthly basis will get a Ruyui NFT from the Official Collection

**Tier Benefits (Increasing with Each Level):**

* Priority consideration for **Ambassador** roles
* Direct communication line with the core team
* Rarer cosmetics and exclusive in-game items
* Enhanced odds in Ruyui NFT giveaways (1.5x → 2x → 3x multipliers)
* Tier-specific SBTs (Soulbound Tokens) that serve as on-chain proof of your journey<br>

**Evaluation Metrics:**

\
Creators can base their evaluation on the following:

* **Quality**: Originality, production value, and creativity
* **Engagement**: How well the content resonates with the community
* **Relevance**: How well it aligns with Ruyui’s game and IP
* **Consistency**: Regular output and reliability<br>


# Start Here

**Ruyui** is a character-driven universe built across **animation**, **games**, and interactive **experiences**. At its core, Ruyui focuses on **original worlds**, **storytelling**, and community **participation** that evolves alongside the **IP**.

This guide is here to help you **get started with Ruyui** and understand how our **studio**, **games**, **Hub**, **NFTs**, and **lore** all fit together.

{% content-ref url="/pages/zwtoQjPIa58GzA2ivtfA" %}
[Ruyui Studios](/ruyui-ecosystem/start-here/ruyui-studios)
{% endcontent-ref %}

{% content-ref url="/pages/8x4ydHpyCd7DfNnGdMSr" %}
[How To Get Started](/ruyui-ecosystem/start-here/how-to-get-started)
{% endcontent-ref %}

{% content-ref url="/pages/TN2xHEodJaZbw6hQWTit" %}
[The Ruyui Collection](/ruyui-ecosystem/start-here/the-ruyui-collection)
{% endcontent-ref %}

{% content-ref url="/pages/3QQc8qhh6W93s8cYHH1t" %}
[The Ruyui Hub](/ruyui-ecosystem/start-here/the-ruyui-hub)
{% endcontent-ref %}

{% content-ref url="/pages/8UVeHsQbpWp2YbqYiCqS" %}
[Lore & Universe](/ruyui-ecosystem/start-here/lore-and-universe)
{% endcontent-ref %}

{% content-ref url="/pages/2Xv1aQBkE9WhI1uYJlgS" %}
[FAQ](/ruyui-ecosystem/start-here/faq)
{% endcontent-ref %}


# Ruyui Studios

Everything about **who we are** and **what we build**, all in one place.

<details>

<summary><mark style="color:$warning;"><strong>What is Ruyui Studios?</strong></mark></summary>

**Ruyui Studios** is a Web native **animation** and **gaming studio** with a focus on **character-driven** **storytelling**, **immersive** **lore**, and **long-term** **brand building.**

Everything we create is made **in-house** by our diverse **team of young**, **skilled artists** and **developers** who bring **energy**, **vision**, and **depth** to every story we tell while **bridging the gap between Web2 & Web3**. With a constant pipeline of **original content** and **strong IP** at our core, we're shaping the future of **animated storytelling**, **one frame at a time**.

<figure><img src="https://content.gitbook.com/content/NdJ63VcquVafLwx1yxII/blobs/hSVyRTDQYxeMbDv9FCdh/(Purchasable%20through%20marketplace)%20(4).png" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><mark style="color:$warning;"><strong>Who is Ruyui Studios?</strong></mark></summary>

We are a mid sized studio with **25 creatives** who are **animators**, **directors**, **concept** **artists**, **game** **designers**, **game** **devs** and we are still expanding and **onboarding more talents**. Our studio includes industry professionals who’ve worked on world-renowned productions such as <mark style="color:$warning;">**One Piece**</mark>, <mark style="color:$warning;">**Jujutsu Kaisen**</mark>, <mark style="color:$warning;">**Hunter x Hunter**</mark> and other top-tier global franchises.

{% hint style="warning" %}
To check the talents in our studio, please visit <https://www.ruyuistudios.com/> if you hover on the anime covers, you'll see the name of our artists and the task/episode they worked on. Also you can search for our artists on animenews or IMDB.
{% endhint %}

</details>

<details>

<summary><mark style="color:$warning;"><strong>Studio Services</strong></mark></summary>

Our studio is ready to serve **all creative ideas**, covering **every step** **from script to screen**.

***

<mark style="color:$warning;">**Pre-Production**</mark>

* Character Design, Storyboarding, Animatic, Color Scripts, & Script Writing

<mark style="color:$warning;">**Animation**</mark>

* Music Videos, Trailers, Character Explorations, & Episodic Content

<mark style="color:$warning;">**Illustration**</mark>

* Environment Design, Concept Art, Background Painting, & World Building

<mark style="color:$warning;">**Other Services**</mark>

* Creative Consultation, Project Management, Creative Direction, & Technical Support

{% hint style="warning" %}
For additional **details** and **consultations** please visit <https://www.ruyuistudios.com/>
{% endhint %}

<figure><img src="https://content.gitbook.com/content/NdJ63VcquVafLwx1yxII/blobs/1me2ys2pDYiFEdiPw4wM/broom.gif" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><mark style="color:$warning;"><strong>Ruyui Flywheel</strong></mark></summary>

We designed our ecosystem as a **creative flywheel**, where each component drives the next. It’s the same model used by brands like **Disney**, **Apple**, and **Amazon**. Not a roadmap, but a **business model**.

<figure><img src="https://content.gitbook.com/content/NdJ63VcquVafLwx1yxII/blobs/HR3xf0tcvYeA9X9BlLoT/GgsTkp-acAAPSTn%20(1).jpg" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><mark style="color:$warning;"><strong>Accomplishments</strong></mark></summary>

Every **project**, **product**, and **platform** brings us closer to realizing the full **Ruyui** **universe**, a connected world where **stories**, **games**, and **creativity** converge. Our journey is built through milestones that merge **art**, **code**, and **community**. Each accomplishment marks another step toward a living, evolving world.

***

<mark style="color:$warning;">**Animations**</mark>

* Ruyui Flagship **AMV** / **Promotional Video**
  * Click to Watch <mark style="color:$warning;">→</mark> <a href="https://x.com/RuyuiStudios/status/1982497258227773634?ref_src=twsrc%5Etfw%7Ctwcamp%5Etweetembed%7Ctwterm%5E1982497258227773634%7Ctwgr%5E0072afdbbf0b79e41dffb47f0435c60afde091eb%7Ctwcon%5Es1_&#x26;ref_url=https%3A%2F%2Fwww.notion.so%2FRuyui-Studios-2a692381ef66800b9c24c82578e1b6d8" class="button secondary">AMV/Promo</a>
* Ruyui Studios **Showcase Gallery**
  * Click to View <mark style="color:$warning;">→</mark> <a href="https://ruyui.com/gallery-showcase" class="button secondary" data-icon="pen-paintbrush">Gallery</a>

<mark style="color:$warning;">**Gaming**</mark>

* **Roots of Embervault**, our nostalgic **pixel RPG** set in the founding age of Ruyui.
  * Click to Play <mark style="color:$warning;">→</mark> <a href="https://embervault.ruyui.com/" class="button secondary" data-icon="swords">RoE</a>

<mark style="color:$warning;">**Tech**</mark>

* The **Ruyui Hub**, the center for all things Ruyui
  * Click to Explore <mark style="color:$warning;">→</mark> <a href="https://hub.ruyui.com/" class="button secondary" data-icon="desktop">HUB</a>

{% hint style="warning" %}
The team plans to continue **expanding the Ruyui universe** through:

* Muted short films
* Manga Chapters
* Episodic content exploring world lore
* Collaborative animations with community input
* Potential for longer-form content as the universe grows
  {% endhint %}

</details>

<details>

<summary><mark style="color:$warning;"><strong>Partnerships</strong></mark></summary>

<figure><img src="https://content.gitbook.com/content/NdJ63VcquVafLwx1yxII/blobs/JUFevioCx1i38wVMqwft/image.png" alt="" width="563"><figcaption></figcaption></figure>

* [<mark style="color:$warning;">**Ruyui x VIU**</mark>](https://x.com/RuyuiStudios/status/1965022871975342129) - Partnership with one of **Asias top streaming platforms**
* [<mark style="color:$warning;">**Ruyui x Tenor**</mark>](https://x.com/RuyuiStudios/status/1894051475048841486) - Partnership for ease of access **content** sharing on a **global scale**
* [<mark style="color:$warning;">**Ruyui x BythenAI**</mark>](https://docs.ruyui.com/getting-started/ruyui-101/more-than-a-pfp/game-ready-avatars/bythenai-x-ruyui) - Providing **interoperable 3D avatars** for UGC/gaming platforms
* [<mark style="color:$warning;">**Ruyui x Treasure DAO**</mark>](https://x.com/Treasure_DAO/status/1955695175885578585) - Bringing **AI Agents** for **increased gaming mechanics**
* [<mark style="color:$warning;">**Ruyui x Gigaverse**</mark>](https://x.com/RuyuiStudios/status/1956058515606298730?s=2) - In-game **character/AI Agents** access
* [<mark style="color:$warning;">**Ruyui x Spellborne**</mark>](https://x.com/spellbornegame/status/1967982096254898363) - In-game character **skins**
* [<mark style="color:$warning;">**Ruyui x Goodies**</mark>](https://x.com/goodies_tg/status/1978915142210359374) - Telegram oriented **collectibles** and **content**
* [<mark style="color:$warning;">**Ruyui x MoodyMadness**</mark>](https://discord.com/channels/1310465511833866372/1321892136777678908/1441547528909754470) - Limited edition Ruyui in-game **items** & **rewards**
* [<mark style="color:$warning;">**Ruyui x Tollan Universe**</mark>](https://x.com/TollanUniverse) - In-game character skin for BOB

</details>

<details>

<summary><mark style="color:$warning;"><strong>Official Ruyui Links</strong></mark></summary>

To avoid impersonation and scams, **always verify** that you are using **official Ruyui platforms**.

***

<mark style="color:$warning;">**Primary**</mark>

* **Website** <mark style="color:$warning;">→</mark> <a href="https://ruyui.com/" class="button secondary" data-icon="browser">Ruyui</a>
* **The Hub** <mark style="color:$warning;">→</mark> <a href="https://hub.ruyui.com/" class="button secondary" data-icon="browser">Hub.Ruyui</a>
* **Studio Website** <mark style="color:$warning;">→</mark> <a href="https://www.ruyuistudios.com/" class="button secondary" data-icon="browser">Ruyui Studios</a>
* **Collection** <mark style="color:$warning;">→</mark> <a href="https://opensea.io/collection/ruyui" class="button secondary" data-icon="cart-circle-check">Opensea | Ruyui</a>
* **Game** <mark style="color:$warning;">→</mark> <a href="https://embervault.ruyui.com/" class="button secondary" data-icon="gamepad-modern">RoE</a>

<mark style="color:$warning;">**Socials**</mark>

* **Telegram** <mark style="color:$warning;">→</mark> <a href="https://t.me/ruyui" class="button secondary" data-icon="telegram">t.me/Ruyui</a>
* **X (Twitter)** <mark style="color:$warning;">→</mark> <a href="https://x.com/ruyuistudios" class="button secondary" data-icon="x-twitter">@RuyuiStudios</a>
* **Discord** <mark style="color:$warning;">→</mark> <a href="https://discord.com/invite/ruyuistudios" class="button secondary" data-icon="discord">RuyuiStudios</a>

</details>


# How To Get Started

**New to Ruyui**? This quick-start guide will walk you through everything you need to begin your journey. From **joining the community** to setting up your **wallet** and accessing the **Ruyui Hub**. Whether you’re here for the story, the art, or the gameplay, **this is where it all begins**.

<details>

<summary><mark style="color:$warning;"><strong>Joining the Community</strong></mark></summary>

The best way to experience Ruyui is alongside other curious minds and believers.

* Enter our <a href="https://discord.gg/ruyuistudios" class="button secondary" data-icon="discord">Discord</a> to meet the **team/community** and stay up to date on events
* Follow <a href="https://t.me/ruyui" class="button secondary" data-icon="telegram">Telegram</a>and <a href="https://x.com/RuyuiStudios" class="button secondary" data-icon="x-twitter">X/Twitter</a> for live **updates** and **announcements**.

Every new member strengthens the Ruyui universe, **don’t hesitate to say hello**!

</details>

<details>

<summary><mark style="color:$warning;"><strong>Creating &#x26; Funding a Smart Wallet</strong></mark></summary>

<mark style="color:$warning;">**Creation**</mark>

Your wallet is your **key to interacting with the Ruyui ecosystem** — from collecting avatars to exploring the Hub.

* Create a wallet compatible with the **Abstract Network**.
  * Abstract Global Wallet <mark style="color:$warning;">**→**</mark> <a href="https://portal.abs.xyz/login" class="button secondary" data-icon="wallet">Abstract Portal</a>
    * To **earn XP** on Abstract chain, an **AGW is required**, making it our most recommended wallet option for users.
  * Rainbow Wallet <mark style="color:$warning;">**→**</mark> <a href="https://rainbow.me/en-us/" class="button secondary" data-icon="wallet">Rainbow Install</a>
  * MetaMask <mark style="color:$warning;">**→**</mark> <a href="https://metamask.io/" class="button secondary" data-icon="wallet">MetaMask Install</a>

{% hint style="warning" %}
**Secure your** **recovery phrase** offline and **never share it** with anyone.
{% endhint %}

***

<mark style="color:$warning;">**Funding**</mark>

After creating your wallet, you’ll need to fund it with a **small amount of ETH** on the **Abstract network**. This is used to cover **transactions** and enable **actions** such as **staking**, **claiming** badges, or participating in future **gameplay features**.

**You can fund your wallet by:**

* **Transferring** ETH from another wallet
* **Bridging** funds from another supported network
  * Recommended Bridge <mark style="color:$warning;">**→**</mark> <a href="https://relay.link/bridge" class="button secondary" data-icon="arrows-rotate-reverse">Relay.Link</a>
* Using an **on-ramp service**, if available in your region

Once funded, your wallet is **ready to explore** everything Ruyui has to offer.

</details>

<details>

<summary><mark style="color:$warning;"><strong>Acquiring a Ruyui NFT</strong></mark></summary>

To fully participate in the Ruyui ecosystem, **owning a Ruyui NFT** unlocks access to **staking**, **badges**, **lore** submissions, and **in-game perks/features**.

**NFT ownership** enables progression across the **ecosystem** and access to **features** as they roll out.

**Ruyui NFTs** can be purchased through approved **secondary marketplaces**.

<p align="center"><a href="https://opensea.io/collection/ruyui" class="button secondary" data-icon="cart-circle-check">Opensea</a> <a href="https://market.ruyui.com/collections/0x9ce89a1303f2d52a9d7840fcd5a6870c2a8550c0/networks/abstract" class="button secondary" data-icon="cart-circle-check">Ruyui Market</a> <a href="https://magiceden.io/collections/abstract/0x9ce89a1303f2d52a9d7840fcd5a6870c2a8550c0" class="button secondary" data-icon="cart-circle-check">MagicEden</a> <a href="https://mintify.xyz/abstract/0x9ce89a1303f2d52a9d7840fcd5a6870c2a8550c0" class="button secondary" data-icon="cart-circle-check">Mintify</a><a href="https://www.zkmarkets.com/abstract/collections/0x9ce89a1303f2d52a9d7840fcd5a6870c2a8550c0" class="button secondary" data-icon="cart-circle-check">ZK</a></p>

</details>

<details>

<summary><mark style="color:$warning;"><strong>Accessing the Hub</strong></mark></summary>

* Visit <mark style="color:$warning;">**→**</mark> <a href="https://hub.ruyui.com/" class="button secondary" data-icon="browser">hub.ruyui.com</a> and **connect your wallet** when prompted.
* Once connected, you’ll gain access to your **profile** and **various tools**.

{% hint style="warning" %}
For full details on the hub, please read [The Ruyui Hub](/ruyui-ecosystem/start-here/the-ruyui-hub)
{% endhint %}

</details>

<details>

<summary><mark style="color:$warning;"><strong>Play Roots of Embervault</strong></mark></summary>

**Roots of Embervault** is Ruyui’s RPG experience, letting players explore Embervault, fight monsters, and progress through an evolving world that **expands the Ruyui IP** and its lore. **Create a game account** at [<mark style="color:$warning;">https://embervault.ruyui.com/</mark>](https://embervault.ruyui.com/) to begin your journey and start playing.&#x20;

{% hint style="warning" %}
For full details on RoE, please check out our in-depth game document [Broken mention](broken://spaces/QzkURVfHnM0GwVoEOeCb)
{% endhint %}

</details>

<figure><img src="https://1881800036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNdJ63VcquVafLwx1yxII%2Fuploads%2FMezvDMxbnqrPvwmPnM4t%2F5b3xzqQiSYRVo5B-.gif?alt=media&amp;token=23eb004a-9f10-4653-ae72-082ab565e1a9" alt=""><figcaption></figcaption></figure>


# The Ruyui Collection

**Ruyui** consists of **7,000** unique characters living on the **Abstract Blockchain**. In the Ruyui universe, your **NFT** isn't just a profile picture, it's a **character with a story**, a place in our world, and **evolving utility across multiple experiences**.

<details>

<summary><mark style="color:$warning;"><strong>Holder Benefits</strong></mark></summary>

* Abstract XP Yield
* Staking/RNS Earning *(within ruyui hub)*&#x20;
* Gaming Discounts & Advantages - *Roots of Embervault*&#x20;
* Pixel Sprite Characters - *Spellborne/RoE*&#x20;
* Interoperable 3D Avatars - *BythenAI*
* IP Licensing Agreements - *coming soon*
* AI Agents - *coming soon*&#x20;

</details>

<details>

<summary><mark style="color:$warning;"><strong>Relevant Links</strong></mark></summary>

<a href="https://opensea.io/collection/ruyui" class="button secondary" data-icon="cart-circle-plus">Opensea | Ruyui</a> <a href="https://magiceden.us/collections/abstract/RUYUI" class="button secondary" data-icon="cart-circle-plus">Magic Eden | Ruyui</a>

</details>

***

#### <mark style="color:$warning;">**Resonance Chamber**</mark>

<details>

<summary><mark style="color:$warning;"><strong>Resonance Event/Aura Reveal</strong></mark></summary>

<figure><img src="https://content.gitbook.com/content/NdJ63VcquVafLwx1yxII/blobs/uH1jhSy7LWSQ8UGPK0ow/image%20(8).png" alt=""><figcaption></figcaption></figure>

**The Resonance Chamber** is a future feature designed to unlock deeper potential within select Ruyui NFT(s) tied to their **Aura**. Through limited-time events, holders may reveal **hidden traits**, **visual** **transformations**, or **rare evolutions** that can permanently shape their NFT’s identity and role within the Ruyui universe.

{% hint style="warning" %}
Details on mechanics and timing will be shared closer to release.
{% endhint %}

</details>

***

#### <mark style="color:$warning;">**Trait Breakdown**</mark>&#x20;

<details>

<summary><mark style="color:$warning;"><strong>Type</strong></mark></summary>

There are **four core types** in the collection: **Human, Orc, Elf, and Demon**.

Each type unlocks a corresponding badge and provides a **daily RNS point yield bonus** based on how many are held.

* **Human -** *3,103 in collection*

  0.08 bonus per amount held
* **Elf -** *1,847 in collection*

  0.08 bonus per amount held
* **Orc -** *1,342 in collection*

  0.06 bonus per amount held
* **Demon -** *698 in collection*

  0.05 bonus per amount held

Owning **all four types** unlocks the **Cross Blood Badge**, granting an **additional +2 point bonus**.

</details>

<details>

<summary><mark style="color:$warning;"><strong>Skin</strong></mark></summary>

There are **21 skin types** in the collection, offering a wide range of visual diversity.

The most notable are **Spirit Skins**, which provide both badges and RNS yield bonuses.

Spirit skins grant:

**0.3 bonus per amount held**

* Spirit Orc *(69)*
* Spirit Human *(61)*
* Spirit Demon *(45)*
* Spirit Elf *(23)*

Each Spirit Skin unlocks its **corresponding badge**.

</details>

<details>

<summary><mark style="color:$warning;"><strong>Wings</strong></mark></summary>

There are **six wing variants**, each providing the same RNS yield bonus and a matching badge.

All wings grant:

**0.3 bonus per amount held**

* Angel Wings *(43)*
* Fallen Angel Wings *(41)*
* Demon Lord Wings *(33)*
* Demon Wings *(32)*
* Devil Wings *(24)*
* Archangel Wings *(24)*

Owning any wing unlocks its **corresponding wing badge**.

</details>

<details>

<summary><mark style="color:$warning;"><strong>1/1</strong></mark></summary>

There are **10 unique 1-of-1 characters** in the collection.

Each is fully custom-designed by the art team and plays a pivotal role in Ruyui’s lore.

Owning any 1/1 unlocks the **1/1 Badge** and grants:

**+40 daily points per amount held**

</details>

<details>

<summary><mark style="color:$warning;"><strong>Hair</strong></mark></summary>

There are **68 hair types**, with a wide variety of styles and colors.

The most notable are **Elemental Hairs**, each providing bonuses and badges.

Elemental hair grants:

**0.1 bonus per amount held**

* Fire *(21)*
* Earth *(32)*
* Air *(34)*
* Water *(37)*

Owning any elemental hair unlocks the **corresponding element badge**.

Owning **all four elements** unlocks the **Elemental Badge**, granting a **+2 point bonus**.

</details>

<details>

<summary><mark style="color:$warning;"><strong>Clothing</strong></mark></summary>

There are **81 clothing types**, spanning a wide range of styles and aesthetics.

Two special clothing categories unlock **multipliers**, not flat bonuses:

* **Cape Clothing**

  Unlocks the Cape Clothes Badge

  Applies a **1.3x multiplier** to total daily points
* **Gold Clothing**

  Unlocks the Gold Clothes Badge

  Applies a **1.2x multiplier** to total daily points

Multipliers apply to your **total daily yield**, not per NFT.

</details>

<details>

<summary><mark style="color:$warning;"><strong>Earrings</strong></mark></summary>

There are **27 earring types** in the collection.

* **Gold Earrings** do not qualify for the **Gold Clothes Badge and** are cosmetic only.

</details>

<details>

<summary><mark style="color:$warning;"><strong>Aura</strong></mark></summary>

**Every** **Ruyui NFT** will unlock an **Aura** as the project evolves.

Auras may significantly affect an NFT’s **appearance**, **progression**, and **customization** capabilities.

More details on Aura mechanics will be revealed in future updates.

</details>

<details>

<summary><mark style="color:$warning;"><strong>Eyes</strong></mark></summary>

There are **13 eye types** in the collection, offering a wide range of expressions and visual identity across characters.

At this time, eye traits **do not unlock badges or provide Hub bonuses**, but they contribute to overall character uniqueness and may become relevant in future mechanics.

</details>

<details>

<summary><mark style="color:$warning;"><strong>Pupils</strong></mark></summary>

There are **17 pupil types** in the collection, designed to add depth and variation to character expressions.

Pupil traits currently **do not provide any badge or Hub-related utility**, and exist purely for visual diversification.

</details>

<details>

<summary><mark style="color:$warning;"><strong>Mouths</strong></mark></summary>

There are **27 mouth types** in the collection, representing different expressions, moods, and personality cues.

Mouth traits **do not currently affect badges, bonuses, or multipliers**, but play an important role in character individuality.

</details>

<details>

<summary><mark style="color:$warning;"><strong>Scars</strong></mark></summary>

There are **10 scar types** in the collection, each adding a sense of history and character backstory.

Scars are **cosmetic-only at this time** and do not provide any Hub utility or bonuses.

</details>

<details>

<summary><mark style="color:$warning;"><strong>Tattoos</strong></mark></summary>

There are **12 tattoo types** in the collection, offering additional layers of visual storytelling and style.

Tattoo traits **do not currently unlock badges or yield bonuses**, and exist for customization and rarity expression.

</details>

<details>

<summary><mark style="color:$warning;"><strong>Backgrounds</strong></mark></summary>

There are **6 background types** in the collection, helping define atmosphere and presentation.

Backgrounds are **purely visual** and do not currently affect badges, Hub points, or multipliers.

</details>


# The Ruyui Hub

**The Hub** is the go-to place for **everything Ruyui**. Features evolve as the Ruyui universe grows, introducing new ways to **interact**, **play**, **earn**, and **connect**.

{% embed url="<https://hub.ruyui.com/>" %}

***

#### <mark style="color:$warning;">**Features**</mark>

* **Collect** & earn **Badges** based on traits and amounts of NFTs held
* **Complete tasks** to earn **Resonance Tokens** (RNS)
* Climb the **Ruyui Leaderboard** and track your ongoing progress
* **Stake Ruyui NFT**(s) to earn **daily RNS yield**
* Apply to be a **content creator** and **represent the community**
* **Generate** GM images & custom Gifs/content
* Submit **creative content** for community **tasks**
* Enter the ‘**Roots of Embervault**’ game

<details>

<summary><mark style="color:$warning;"><strong>Staking</strong></mark></summary>

**Stake** your **NFT**(s) in the Hub to unlock exclusive badges and earn a **daily** yield of **Resonance Tokens** (RNS). Your total RNS holdings determine your placement on the Ruyui Leaderboard, reflecting both **activity** and **engagement**.

{% hint style="warning" %}
Users will receive a "Holy Stake" placeholder NFT for each Ruyui NFT staked. These Stake NFT(s) ensure users continue to earn Abstract XP despite no longer having the Ruyui NFT(s) in their wallet.
{% endhint %}

</details>

<details>

<summary><mark style="color:$warning;"><strong>Resonance Tokens</strong></mark></summary>

**Resonance Tokens** (RNS) are earned through staking and **completing Hub tasks**. They’ll play an essential role across the Ruyui ecosystem. From **in-game utility** in upcoming releases to **discounts on official merchandise**, with many additional applications planned for **future activations**.

</details>

<details>

<summary><mark style="color:$warning;"><strong>Badges</strong></mark></summary>

**Badges** represent off and on-chain **achievements** within the **Ruyui ecosystem**.

They are earned through actions such as holding specific **NFT traits**, **staking** **participation**, completing **tasks**, and engaging with **ecosystem features**.

Badges act as a visual record of progression and commitment, and may **unlock additional benefits** as the ecosystem evolves.

</details>

<details>

<summary><mark style="color:$warning;"><strong>Future Expansions</strong></mark></summary>

**The Hub will continue evolving** with every Ruyui release. Each new addition is designed to make the Hub not just a dashboard, but a living part of the Ruyui universe where **creativity**, **progress**, and **connection** all resonate together.

**Some upcoming activations in the hub include:**

* Create and submit **Lore** (coming soon)
* Acquire official Ruyui **merchandise** (coming soon)
* Apply for **Licensing** opportunities (coming soon)

More features will roll out as the Ruyui ecosystem grows.

</details>

***

#### <mark style="color:$warning;">**First Actions**</mark>

Once you’ve joined the Hub, start by **connecting your wallet** and **verifying your NFT**(s). From there, you can **set up** and explore your **profile**, **stake** your assets, and begin **earning RNS** through daily actions or featured tasks.

**New users** are encouraged to complete introductory tasks and collect their first badges to begin climbing the **leaderboard**.


# Lore & Universe

The Ruyui Universe is a **living narrative**. Shaped by the **worlds**, **characters**, and **creators** who inhabit it. Each story, animation, and game expands a **shared history** that continues to evolve over time.

***

#### <mark style="color:$warning;">**Character Spotlights**</mark>

At the heart of Ruyui lies a **core cast** whose stories intertwine across worlds; **Bob, Crash, Kaya, and Lia**. Their journeys form the emotional core of the universe, blending courage, curiosity, and friendship as they explore the mysteries that connect every realm.

<details>

<summary><mark style="color:$warning;"><strong>Bob</strong></mark></summary>

The most recent addition to the group, Bob joined after the team’s **accidental** **arrival on his home planet**. Goofy, resourceful, and **insatiably curious**, he approaches every challenge with a smile and a hundred questions. He’s **quick to protect his friends** and swears that “candy clouds” are his favorite food, even though no one’s ever seen him eat one.

<figure><img src="https://1881800036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNdJ63VcquVafLwx1yxII%2Fuploads%2FnIeAulMOX1P0l9d9iato%2FGmqOhuHaoAAdYA2.jpeg?alt=media&amp;token=74591200-d537-4448-b7cb-17f93688b064" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><mark style="color:$warning;"><strong>Crash</strong></mark></summary>

An **orc** raised in Embervault’s public orphanage, Crash is open-hearted, strong, and endlessly loyal. He dreams of **proving his strength** through with the group and protecting those he calls family. When he isn’t training or fighting, he’s cooking for friends.

<figure><img src="https://1881800036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNdJ63VcquVafLwx1yxII%2Fuploads%2FUGzVBOHCuQ77dbLYsBFP%2FGmZqatLW8AAqqF7.jpeg?alt=media&amp;token=8fa6e832-efd4-4ba3-8d97-1f88e58aedb1" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><mark style="color:$warning;"><strong>Kaya</strong></mark></summary>

A sharp-minded and curious **oni**, Kaya grew up alongside Crash in the same orphanage. Reserved but fiercely protective, she finds purpose in **uncovering the hidden truths of Ruyui’s history**. Her intellect and intuition make her a cornerstone of the group.

<figure><img src="https://1881800036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNdJ63VcquVafLwx1yxII%2Fuploads%2F9t3LNvyelJztuJ4RkOl5%2FGmeq9zuXAAAVbBM.jpeg?alt=media&amp;token=f2119b64-e092-4bc6-a483-8fed13307ffc" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><mark style="color:$warning;"><strong>Lia</strong></mark></summary>

An **elf** of immense age and wisdom, Lia serves as both **scholar** and **mage**. Though calm and insightful, she’s easily distracted by the natural world, especially by small, furry creatures that she can’t resist studying. To Crash and Kaya, she’s more than a mentor, she’s family.

<figure><img src="https://1881800036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNdJ63VcquVafLwx1yxII%2Fuploads%2F4ByjdQu4d7o8hejpVifi%2FGmlL4x0bAAAR_Gm.jpeg?alt=media&amp;token=e5741fb4-44de-4ce7-ab93-c79885494187" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><mark style="color:$warning;"><strong>Other Notable Characters</strong></mark></summary>

Alongside the core cast, there exist **6 other key characters** whom play a pivotal role within the Ruyui universe and its storylines.

<figure><img src="https://1881800036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNdJ63VcquVafLwx1yxII%2Fuploads%2Fo8YUqw4vV9gpFeKsp9f3%2FBazaart_3EAAEE29-76C4-476D-861D-790ABF61FF6A.jpg?alt=media&amp;token=488c69e8-0bae-4d85-96a6-363e554f8f83" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Names in order of appearance: *(left to right, top to bottom)*\
Claire, Alvius, REDACTED, Muriel, Lucy, Sarge
{% endhint %}

</details>

***

#### <mark style="color:$warning;">**The Lore Library**</mark>

The Lore Library is Ruyui’s living archive, a **collection of official stories and community-made tales** that shape the universe over time. It documents the world’s history, characters, and mythology while inviting Ruyui holders to expand its horizons.

<mark style="color:$warning;">**Holders Can:**</mark>

* Create **backstories** and side adventures for their **NFTs**
* Collaborate on **shared lore** with others
* Earn recognition for **standout submissions**
* **Influence canon,** with selected works becoming part of **official history**

Every contribution to the Lore Library helps define what Ruyui becomes next.

<details>

<summary><mark style="color:$warning;"><strong>Official Lore Entries</strong></mark></summary>

* Entry #1 <mark style="color:$warning;">**→**</mark> <a href="https://x.com/RuyuiStudios/status/1973059952710459604" class="button secondary">Embervault</a>
* Entry #47 <mark style="color:$warning;">**→**</mark> <a href="https://discord.com/channels/1310465511833866372/1423326011155681331/1423327076613623808" class="button secondary">The Old Temple</a>
* Entry #84 <mark style="color:$warning;">**→**</mark> <a href="https://x.com/ruyuistudios/status/1974142405084627348?s=46&#x26;t=FztIB3P58V3ucgQHTQVNpA" class="button secondary">Noctan</a>
* Entry #134 <mark style="color:$warning;">**→**</mark> <a href="https://x.com/RuyuiStudios/status/1974504791788425466" class="button secondary">Slimes</a>
* Entry #256 <mark style="color:$warning;">**→**</mark> <a href="https://x.com/RuyuiStudios/status/1974867174717309168" class="button secondary">Mountain Peaks</a>
* Entry #312 <mark style="color:$warning;">**→**</mark> <a href="https://x.com/RuyuiStudios/status/1975199365468660194" class="button secondary">Tavern</a>
* Entry #398 <mark style="color:$warning;">**→**</mark> <a href="https://x.com/ruyuistudios/status/1975274862588334480?s=46&#x26;t=FztIB3P58V3ucgQHTQVNpA" class="button secondary">Mushroom Sprites</a>
* Entry #441 <mark style="color:$warning;">**→**</mark> <a href="https://x.com/ruyuistudios/status/1975607049578041569?s=46&#x26;t=FztIB3P58V3ucgQHTQVNpA" class="button secondary">Sela & Rava</a>
* Entry #507 <mark style="color:$warning;">**→**</mark> <a href="https://x.com/RuyuiStudios/status/1975954345087627343" class="button secondary">Woodlands</a>
* Entry #573 <mark style="color:$warning;">**→**</mark> <a href="https://x.com/RuyuiStudios/status/1976355661350056082" class="button secondary">Shadow Wolves</a>
* Entry #628 <mark style="color:$warning;">**→**</mark> <a href="https://x.com/RuyuiStudios/status/1978491138282774712?s=20" class="button secondary">Guild HQ</a>
* Entry #628 <mark style="color:$warning;">**→**</mark> <a href="https://x.com/RuyuiStudios/status/1987953288319524985?s=20" class="button secondary">Filburt</a>

</details>

<details>

<summary><mark style="color:$warning;"><strong>Embervault Lore Connections</strong></mark></summary>

**Embervault** is the first world revealed within the **Ruyui Universe**. A realm where ancient energy once flowed freely, and remnants of that power still shape life today.

Many of Ruyui’s **core characters** trace their origins to Embervault, and the events that unfold there will ripple outward into other worlds and timelines.

As the story expands, discoveries made within Embervault will uncover **new connections between realms**, revealing how every part of Ruyui’s universe is bound by shared history and hidden purpose.

**For now**, Embervault stands as the heart of Ruyui’s unfolding story.

<figure><img src="https://1881800036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNdJ63VcquVafLwx1yxII%2Fuploads%2FauNfB3I2RRMgKI77nGAL%2Fba3292b0-3919-40ed-8c2c-7a9431ac3dff.gif?alt=media&amp;token=8edbd48b-7c0c-428d-abb8-36b545e58449" alt=""><figcaption></figcaption></figure>

</details>


# FAQ

The **Ruyui FAQ** serves as your reference **guide for everything within the project**. From how the studio operates to the technology, gameplay, and ecosystem that powers it. Whether you’re a **fan**, **collector**, **player**, or **creator**, this section breaks down how it all connects.

<details>

<summary><mark style="color:$warning;"><strong>General &#x26; Studio</strong></mark></summary>

<mark style="color:$warning;">**1.**</mark>**&#x20;What is Ruyui Studios and what kind of projects does it create?**

{% hint style="warning" %}
Ruyui Studios develops interconnected worlds through games, animation, and storytelling. While also serving as an integral animation studio providing work for talented artists and creating content for global IP’s.
{% endhint %}

<mark style="color:$warning;">**2.**</mark>**&#x20;How does Ruyui connect its games, animation, and storytelling under one IP?**

{% hint style="warning" %}
Each project expands the same lore and characters, allowing fans and creators to experience and shape the Ruyui universe across multiple mediums.
{% endhint %}

<mark style="color:$warning;">**3.**</mark>**&#x20;Where can I follow official Ruyui updates and community announcements?**

{% hint style="warning" %}
All updates are shared on the official Ruyui [<mark style="color:$warning;">Twitter</mark>](https://x.com/ruyuistudios), [<mark style="color:$warning;">Telegram</mark>](https://t.me/ruyuistudios), and [<mark style="color:$warning;">Discord</mark>](https://discord.gg/ruyuistudios) channels.
{% endhint %}

<mark style="color:$warning;">**4.**</mark>**&#x20;Where can I inquire about having the Studio take on work?**

{% hint style="warning" %}
For animation, creative, or collaboration inquiries, contact the studio through the official site or community channels. <https://www.ruyuistudios.com/>
{% endhint %}

</details>

<details>

<summary><mark style="color:$warning;"><strong>NFT Utility &#x26; Ecosystem</strong></mark></summary>

<mark style="color:$warning;">**1.**</mark>**&#x20;What makes Ruyui NFTs different from standard collectibles?**

{% hint style="warning" %}
Ruyui NFTs are playable avatars tied to both lore and in-game progression, bridging art, story, and function.
{% endhint %}

<mark style="color:$warning;">**2.**</mark>**&#x20;How do Ruyui NFTs gain new traits or evolve over time?**

{% hint style="warning" %}
NFTs can transform visually through Resonance Events, and all Ruyui NFT will gain Aura attributes. More details to come.
{% endhint %}

<mark style="color:$warning;">**3.**</mark>**&#x20;What does owning a Ruyui NFT allow me to do?**

{% hint style="warning" %}
Ownership unlocks gameplay perks/discounts, daily resonance token yields, lore creation rights, and future licensing opportunities.
{% endhint %}

</details>

<details>

<summary><mark style="color:$warning;"><strong>Hub &#x26; Staking</strong></mark></summary>

<mark style="color:$warning;">**1.**</mark>**&#x20;What is the Ruyui Hub and how do I access it?**

{% hint style="warning" %}
The Hub is Ruyui’s central platform for staking, quests, badges, features/tools, and updates. Accessible via the official site <https://hub.ruyui.com/>
{% endhint %}

<mark style="color:$warning;">**2.**</mark>**&#x20;How does staking work within the Ruyui ecosystem?**

{% hint style="warning" %}
Holders can stake NFTs to earn Resonance Tokens, badges, yield multipliers, and gain access to special Hub features.
{% endhint %}

<mark style="color:$warning;">**3.**</mark>**&#x20;What are Resonance Tokens, and how are they earned?**

{% hint style="warning" %}
Resonance Tokens are awarded for staking participation and in-Hub activity, these tokens are related towards gameplay and will be relevant towards merchandise discounts. However, their use-case is not limited to these things, resonance tokens will be a vital element for other future activations within the Ruyui ecosystem.
{% endhint %}

<mark style="color:$warning;">**4.**</mark>**&#x20;What are Badges, and how are they obtained?**

{% hint style="warning" %}
Badges reflect traits owned on Ruyui NFTs as well as recognize engagement and activity milestones within the Project, from early participation to event contributions.
{% endhint %}

</details>

<details>

<summary><mark style="color:$warning;"><strong>Gaming (RoE)</strong></mark></summary>

<mark style="color:$warning;">**1.**</mark>**&#x20;What is Roots of Embervault and how does it fit into the Ruyui universe?**

{% hint style="warning" %}
Roots of Embervault is Ruyui’s flagship pixel RPG, serving as the first game set within the shared universe.
{% endhint %}

<mark style="color:$warning;">**2.**</mark>**&#x20;Is NFT ownership mandatory to play RoE and is there a free play option?**

{% hint style="warning" %}
No, NFT ownership is not required to play Roots of Embervault. There is a minor account creation fee of 0.005 ETH (ETH price will be fixed to \~15 USD) which grants access to the game for users to enjoy. If a user wishes to unlock exclusive features in game, they can purchase a guild pass to unlock these features. More details can be found in [Broken mention](broken://spaces/QzkURVfHnM0GwVoEOeCb)
{% endhint %}

<mark style="color:$warning;">**3.**</mark>**&#x20;Are Ruyui NFT avatars playable in Embervault and other partnered games?**

{% hint style="warning" %}
Yes. Ruyui avatars are interoperable across multiple titles, including Embervault and partner games on Abstract. **Note:** Embervault is starting out as a fixed main character journey, but through future updates, users will be able to utilize their own Ruyui assets.
{% endhint %}

<mark style="color:$warning;">**4.**</mark>**&#x20;What types of progression or achievements exist in the Ruyui gaming ecosystem?**

{% hint style="warning" %}
Players earn materials, achievements, and leaderboard recognition through skill-based, non-pay-to-win progression. However, there is a live marketplace integrated throughout the game where uses can buy and sell in-game items using native cryptocurrency tokens.
{% endhint %}

</details>

<details>

<summary><mark style="color:$warning;"><strong>Lore &#x26; World Building</strong></mark></summary>

<mark style="color:$warning;">**1.**</mark>**&#x20;How can community members contribute to Ruyui’s lore?**

{% hint style="warning" %}
Through the Lore Library (not yet released), the community can submit stories, backstories, or concepts tied to Ruyui characters and settings.
{% endhint %}

<mark style="color:$warning;">**2.**</mark>**&#x20;How does lore evolve as the Ruyui universe expands?**

{% hint style="warning" %}
Every new release, whether a game, animation, or event, adds layers to the existing timeline, deepening the interconnected narrative.
{% endhint %}

<mark style="color:$warning;">**3.**</mark>**&#x20;Are fan stories or character backstories eligible for official inclusion in Ruyui media?**

{% hint style="warning" %}
Yes, standout submissions may be adapted into official lore, with full credit to their creators.
{% endhint %}

</details>

<details>

<summary><mark style="color:$warning;"><strong>Resonance Chamber</strong></mark></summary>

<mark style="color:$warning;">**1.**</mark>**&#x20;What is the Resonance Chamber and what happens during a Resonance Event?**

{% hint style="warning" %}
A mysterious location that will unlock new potential for your characters:

* Character Empowerment - Utilize staking points and in-game gold to power up your characters
* Aura Revelation - Discover and reveal your character's unique aura
* Ancient Gods - Hidden within the aura traits are 13 Ancient Gods tied to the backbone of Ruyui lore
* Exclusive Transformations - With luck, holders will have the chance to turn their NFTs into legendary 1/1s (excluding existing 1/1s)
  {% endhint %}

<mark style="color:$warning;">**2.**</mark>**&#x20;How does aura transformation affect an NFT’s appearance or attributes?**

{% hint style="warning" %}
Your NFT's metadata will change according to your unique aura reveal, manifesting in both metadata updates and visual transformations.

Some holders will receive common aura traits, while others may discover extraordinary and rare traits that significantly distinguish their character. After Season 2 is concluded, these aura traits will become a permanent part of your NFT's identity, influencing its abilities and appearance across the Ruyui ecosystem.
{% endhint %}

<mark style="color:$warning;">**3.**</mark>**&#x20;Are there any risks in participating in the Resonance process?**

{% hint style="warning" %}
There are no inherit risks to your assets when partaking in the Resonance process, however the traits held or art found may be altered based upon the results of the Aura reveal.
{% endhint %}

</details>

<details>

<summary><mark style="color:$warning;"><strong>Rights &#x26; Licensing</strong></mark></summary>

<mark style="color:$warning;">**1.**</mark>**&#x20;What rights do I have when owning a Ruyui NFT?**

{% hint style="warning" %}
You hold full personal rights for use, display, and non-commercial projects related to your NFT. Full licensing terms and conditions will be made available for users to read and apply for in the near future.
{% endhint %}

<mark style="color:$warning;">**2.**</mark> **Can I use my NFT’s likeness for personal or commercial projects?**

{% hint style="warning" %}
Personal projects are fully permitted; commercial will require coordination with Ruyui for permission and to ensure consistent brand alignment.
{% endhint %}

<mark style="color:$warning;">**3.**</mark> **How does Ruyui handle the inclusion of community NFTs in official productions?**

{% hint style="warning" %}
Select NFTs may appear in animations or games with the owner’s consent and proper attribution. — Exact processes for an event of this nature will be further defined soon for holders.
{% endhint %}

</details>

<details>

<summary><mark style="color:$warning;"><strong>Technical</strong></mark></summary>

<mark style="color:$warning;">**1.**</mark> **Which network and wallet are required to use Ruyui products?**

{% hint style="warning" %}
Ruyui operates on the Abstract Chain and encourages Abstract Global Wallet, while also supporting wallets that are able to utilize the Abstract Network. However for Roots of Embervault, an AGW is mandatory.
{% endhint %}

<mark style="color:$warning;">**2.**</mark> **What should I do if I encounter issues connecting to or using my wallet within the Hub?**

{% hint style="warning" %}
Ensure your browser wallet is updated and permissions enabled; if issues persist, contact support through Discord.
{% endhint %}

<mark style="color:$warning;">**3.**</mark> **Are Ruyui’s systems fully on-chain, and what’s planned for future integrations?**

{% hint style="warning" %}
Core gameplay and progression are on-chain, with wallet delegation and deeper cross-chain support in development for future adoption on a grand scale.
{% endhint %}

</details>

{% hint style="warning" %}
For further questions and inquiries about the project or its products, reach out to the team 24/7 in the Ruyui designated discord server <https://discord.com/invite/ruyuistudios>
{% endhint %}


# Abstract XP

Users can interact with Abstract Chain and earn XP by exploring the Abstract ecosystem. This includes upvoting interesting apps and performing trades, where users are rewarded with badges and XP for interacting with the Abstract ecosystem.

XP can be earned in several ways on Abstract, such as using apps, trading, minting, holding...\
The exact XP calculation formula is not public and it is dynamic, subject to change every week.&#x20;

Within Ruyui, there two main ways to earn Abstract XP:

* **Active**: Playing Roots of Embervault, trading in the PvP marketplace + \[REDACTED]
* **Passive**: Hold Ruyui NFTs for Abstract XP. *(Staked Ruyuis also earn Abstract XP)*


# Patch 0.0.1.1

Major changes to progression, combat, economy, death mechanics, rune rewards, and NFT scaling are now live.

***

### 🔃 Reload & Sleep Changes

* Reloading spawns you at your <mark style="color:$primary;">last save position</mark>
* Reloading does <mark style="color:$primary;">NOT</mark> replenish player health
* Reloading or sleeping in player house <mark style="color:$primary;">fully restores all monster health</mark>

***

### 💀 Death System Overhaul

#### Rune Recovery

* All carried Runes drop at your death location
* You may return to recover them
* Dying again before recovery permanently deletes them

#### Inventory Penalty

* On death, an RNG roll removes either:
  * 50% of active inventory items
  * or 100% of active inventory items

#### Protected Items (Never Deleted)

* Equipped gear
* Quick-slot items
* Shop-purchased items
* Loot Boxes

***

### 💰 Rune System Update

* Runes can <mark style="color:$primary;">no longer be stored</mark> in chests

#### Rune Rewards

* Each monster now has its own Rune drop range
* Rune rewards are determined by RNG within that range
* Higher Luck biases the roll toward the higher end of the Rune range

Rune drops are no longer fixed values and are no longer based on separate bonus rolls.

***

### 🍀 Luck Stat Update

Luck now affects:

* Rune drop roll bias (higher Luck increases the probability of landing higher Rune outcomes over time)
* Critical hit chance
* Bonus loot drop chance

Luck does not guarantee maximum Rune rewards.

Even at <mark style="color:$primary;">low Luck</mark>, players can still roll <mark style="color:$primary;">high Rune</mark> or <mark style="color:$primary;">loot outcomes</mark>. Higher Luck simply increases the statistical likelihood of better results over multiple encounters.

***

### 🧩 NFT Multiplier Rework

NFT scaling has been redesigned for smoother progression and balanced leaderboard impact.

#### Multiplier Logic

* Every additional NFT increases your multiplier
* Multiplier growth follows a diminishing returns model
* Tier bonuses unlock at:
  * 1 NFT
  * 7 NFTs
  * 20 NFTs
  * 50 NFTs
  * 100 NFTs
  * 200 NFTs
* Total multiplier is capped at **1.35x**

#### Score Formula

<mark style="color:$primary;">`Level × 1000 × Multiplier`</mark>\
Score is rounded down to the nearest whole number.

***

### ⚔ Combat & Gear Updates

#### Weapon Scaling

* Short Sword → Strength + Dexterity

#### Armor Scaling

* Heavy Armor → Strength
* Medium Armor  → Strength + Dexterity
* Light Armor → Dexterity

#### Durability Adjustments

* Updated durability values for weapons, armor, and tools
* Durability loss correctly applies per hit used

***

### 🧪 System Fixes

* Monster collider and bridge issues resolved
* <mark style="color:$primary;">Players can no longer attack monsters on different ground levels</mark>

***

### 📈 Leveling & UI

* Multi-level leveling enabled
* Level progression logic fixed
* Consumable duration issues fixed

***

### 📜 Quest System

* Civilians: 5 quests per 24 hours
* Guild Members: 15 quests per 24 hours
* Quests are stackable
* Cooldown automation fixed

***

### 🛒 Marketplace & Shop

* Item sell/repair selection bug fixed
* Only copper equipment purchasable at Filburt’s shop

***

### 🏆 Rebalance Event Implementation

* All player stats resetted during maintenance

#### Rune Redistribution

* Players received <mark style="color:$primary;">**10% of total cumulative Rune spend**</mark>
* If all redistributed Runes are used for leveling, players reach approximately <mark style="color:$primary;">**50% of their former level**</mark>
* Free attribute reset granted

#### Equipment Crafting Allocation

* Players receive crafting resources corresponding to their new reachable level

***

### 🎁 Season 0 Care Package

#### Equipment Package (Crafting Resources)

Materials provided for:

* Full Heavy Armor set
* Short Sword
* Axe
* Pickaxe

**Material Tier Based on Reachable Level**

* 1–10 → Copper
* 10–20 → Iron
* 20–30 → Silver
* 30–40 → Gold
* 40–50 → Titanium
* Above 50 → Crystal

#### Exclusive Season 0 Skins (Loot Boxes)

* Distributed based on leaderboard rank at snapshot

####


# Patch 0.0.0.9

#### Loot & Economy <br>

* Drop tables adjusted and rebalanced.
* Resources and monsters now respawn correctly after their cooldowns.

#### &#x20;Inventory & Chest Updates<br>

* Send to Chest option removed from the inventory UI. Players must now actively interact with a chest to deposit items.
* Added additional chest access points in Forest campsites. 

#### **Equipment & Quick Slot Improvements** <br>

* Added tooltips to Equipment and Quick Slots.
* Added right-click dropdown menus to Equipment and Quick Slots.
* Fixed an issue where equipment would unequip and Quick Slots would reset after death, reload, or leveling up. 

#### Combat & Stats <br>

* Improved Vigor stat effect and overall attribute consistency.
* Reviewed and corrected combat-related formulas for damage and armor scaling.
* Fixed Critical Hit system, now functions correctly in combat.
* Fixed invisible monster attacks during combat. 

#### Gameplay Systems <br>

* Fixed persistent respawn issues.
* Fixed upgrade times incorrectly matching crafting times.
* Fixed quests not appearing for some players and improved quest spawning consistency.
* Fixed item repairs returning incorrect item types (e.g., axes becoming pickaxes).
* Fixed duplicate items appearing in inventories.
* Fixed issues caused by incorrect local system time affecting game behavior. 

#### UI / UX Fixes <br>

* Fixed inventory drag & drop getting stuck mid-action.
* Fixed merchant (Filburt) issue where selling stackable items could remove the entire stack despite slider selection.
* Marketplace transaction history now opens in a new tab.
* Fixed Settings icon positioning when Minimap is hidden inside buildings. 

#### Stability <br>

* Fixed rare game freezes.

#### &#x20;Global Leaderboard<br>

* The general leaderboard released.


# Security Audit

You can check the Audit Report for Roots of Embervault smart contracts [<mark style="color:orange;">here</mark>](https://github.com/shieldify-security/audits-portfolio/blob/main/reports/RootsofEmbervault-Ruyui-Security-Review.pdf)

<figure><img src="https://1881800036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNdJ63VcquVafLwx1yxII%2Fuploads%2F7HncD67QUAnrpYyi76DO%2Fimage.png?alt=media&amp;token=f93acb0c-1d3b-4775-97ba-168c5c799a1e" alt=""><figcaption></figcaption></figure>


