RUYUI Trait System Hub

Welcome to the RUYUI Trait System

This comprehensive hub provides complete documentation and interactive tools for understanding how all 460 RUYUI traits map to gameplay mechanics in the RUYUI Runner game.

📊 Understanding the Numbers:
• 460 = Total unique trait values across all categories
• 7,000 = Total NFTs in the RUYUI collection
• 15 = Trait categories (Type, Hair, Eyes, Skin, Wings, Weapons, etc.)
• 4 = Featured playable characters (PQ1, M1, PQ2, #5258)
Each NFT combines multiple traits from these 460 available options.

Total Traits

460

NFT Collection

7,000

Abilities

163

Quick Navigation

View Trait Mapping Read Documentation Try Demo

🎯 NFT Ability Trigger Badges

When viewing your RUYUI NFTs in the user profile, abilities are displayed with trigger badges to clarify how they activate:

🟢 Always Active / Passive

No conditions required - always working

Fear Aura +10%
Fire Resistance +20%
Speed +15%

🔵 Probability-Based

Random % chance on trigger

Phase-Through 40%
Crit Bonus 5%
Revive 10%

🟡 Event-Triggered

Activates on specific gameplay event

Stomp Reward
Death Effect
Landing Boost

🔴 Cooldown-Based

Timed cooldown between uses

Flight 10s (15s cooldown)
Burst Attack

Real NFT Examples

RUYUI #4614 (Earrings: Skull - Gold)

🟢 Fear Aura +10%
   Earrings: Skull - Gold • Passive

✅ Shows actual stat with value | ❌ Not "Golden skull design" (that's just the description!)

RUYUI #6763 (Hair: Sleek - Example)

🟢 Air Control +20%
   Hair: Sleek • Passive
🔵 Glide Bonus 15%
   Hair: Sleek • Always Active
🔵 Double Jump Chance 5%
   Hair: Sleek • 5% Probability

✅ Multiple abilities from one trait with different trigger types

📚 Core Stats vs Abilities: To prevent redundancy, the CORE STATS section shows health/speed/jump/attack, while ABILITIES & PASSIVES shows everything else (air control, dodge chance, special abilities, etc.)

Key Features

🎯 Trait Mapping (Tab 2)

Searchable database of all 460 traits
Sort by category, tier, or effect
Filter by rarity and abilities
Export data as CSV

📖 Documentation (Tab 3)

Complete formula calculations
Probability breakdowns
Character stat calculations
Combo system explanations
NEW: Platform colors & coin types explained
NEW: Step-by-step rarity calculations

🎮 Playground (Tab 4)

Test characters in-game
See trait effects in action
Compare character abilities
NEW: Betting system with 4 bet types
NEW: Environmental hazards (spikes, lava)
NEW: Special abilities with cooldown timers

Current Characters

✅ All stats verified and accurate as of 2025-09-27
Stats shown in table match actual gameplay. See CHARACTER_VERIFICATION.md for full details.

Character	Token ID	Type	Key Traits	Special Ability
PQ1	#4614	Human (Legendary)	Angel Wings, Cool Eyes, Cuffed Tails, Crescent Tattoo	Divine Flight (👼 8s cooldown)
PQ2	#6763	Human (Uncommon)	Twin Tail Hair, Happy Eyes, Gold Royal Top, Ancient Fire Tattoo	Twin Dash (💨 6s cooldown)
M1	#5949	Orc (Rare)	Excited Eyes, Wavy Bob, Broken Cape, False Crown	Orc Smash (💪 10s cooldown)

Detailed Character Stats

👼 PQ1 - Phantom Queen #4614

Rarity: Legendary

Health: 120 HP | Speed: 0.9x | Jump: 1.0x

Ability: Divine Flight (8s cooldown)
2 extra jumps + 1s invincibility + golden glow

Key Traits:
• Cool Eyes (Accuracy 1.15x)
• Angel Wings (Divine Flight ability)
• Cuffed Tails, Crescent Tattoo

Best For: Beginners, high survivability

💨 PQ2 - Phantom Queen #6763

Rarity: Uncommon

Health: 80 HP | Speed: 1.0x | Jump: 1.0x

Ability: Twin Dash (6s cooldown)
3x speed for 4s + wall climb + 3 dash charges

Key Traits:
• Happy Eyes (Coin magnet 100px)
• Twin Tail Hair (Wall jump enabled)
• Gold Royal Top (Coin multiplier 1.2x)
• Ancient Fire Tattoo

Best For: Speed runs, advanced players

💪 M1 - Mystic #5949

Rarity: Rare

Health: 100 HP | Speed: 1.1x (fastest) | Jump: 0.85x

Ability: Orc Smash (10s cooldown)
Destroy enemies 400px + heal 50HP + 2s invincibility

Key Traits:
• Excited Eyes (Coin magnet 100px + Spike immunity!)
• Orc Type (Orc Smash ability)
• Wavy Bob, Broken Cape, False Crown

Best For: Coin collection, tank gameplay

🎰 Betting System

Token Economy: Start with 1000 tokens, minimum bet 10 tokens

Completion (1.5x) - Complete the level
Speed Run (2.5x) - Complete in under 60 seconds
Coin Master (3.0x) - Collect 90%+ of coins
Flawless (5.0x) - Complete without taking damage

Combo Betting: Select 2 bet types to multiply multipliers!

Example: Speed Run + Flawless = 12.5x (2.5 × 5.0)

🎮 RUYUI Trait System Hub