🛗 Ecosystem Simulator

The Ecosystem Simulator is an advanced 3D interactive environment that simulates a complete DeFi ecosystem with autonomous AI-powered NPCs (Non-Player Characters), smart contracts, DeFi protocols...

Overview: The Living DeFi World

What is the Ecosystem Simulator: The Ecosystem Simulator is an advanced 3D interactive environment that simulates a complete DeFi ecosystem with autonomous AI-powered NPCs (Non-Player Characters), smart contracts, DeFi protocols, and real-time market dynamics. It's a living, breathing virtual world where you can observe, interact with, and learn from realistic blockchain behavior.

Core Purpose:

• Educational: Understand complex DeFi interactions visually

• Interactive: Engage with NPCs, contracts, and protocols

• Realistic: Simulates real market psychology and behavior

• Safe: Experiment without financial risk

• Comprehensive: Covers all aspects of a DeFi ecosystem

What makes it unique:

• 3D Metaverse Environment: Fully explorable 3D space

• AI-Powered NPCs: Autonomous traders with distinct personalities

• Real-Time Simulation: Markets move, traders react, events occur

• Smart Contract Visualization: See contracts execute in 3D

• DeFi Protocol Buildings: Visual representation of Uniswap, Aave, etc.

• Emotional AI: NPCs show emotions based on performance

• Social Dynamics: NPCs form relationships and influence each other

Accessing the Ecosystem:

1. Navigate to "Ecosystem" in the main navigation menu

2. The 3D metaverse loads with the initial environment

3. You'll see NPCs, buildings, tokens, and activity immediately

4. Controls appear at the bottom and right side of the screen

---

The 3D Metaverse Environment

What it displays: A fully rendered 3D world representing the DeFi ecosystem, with visual elements for every blockchain concept.

Visual Elements

1. Ground & Environment

• Grid floor: Represents the blockchain infrastructure

• Ambient lighting: Changes based on market sentiment

• Sky gradient: Reflects overall market conditions

• Particle effects: Show activity and transactions

2. NPCs (Traders) Visual representation:

• 3D Avatars: Unique character models for each NPC

• Customizable appearance: Different styles and colors

• Floating nameplates: Show username and stats

• Emotion indicators: Visual cues for current mood

• Movement patterns: Walk, run, idle based on activity

• Size variations: Whales appear larger than regular traders

3. DeFi Buildings Iconic structures representing protocols:

🔵 Uniswap Building (Blue)

• Appearance: Modern exchange structure

• Color: Signature Uniswap pink/purple

• Function: Token swaps and liquidity pools

• Activity indicator: Glows when transactions occur

• Height: Medium-sized building

🟢 Aave Building (Green)

• Appearance: Lending protocol tower

• Color: Aave's gradient green

• Function: Lending, borrowing, yield farming

• Activity indicator: Pulses with deposits/withdrawals

• Height: Tall tower structure

🟠 Compound Building (Orange)

• Appearance: Financial institution design

• Color: Compound's green-cyan

• Function: Money markets and interest

• Activity indicator: Lights up during interactions

• Height: Medium-height structure

4. Smart Contracts 3D representations of deployed contracts:

• Geometric shapes: Cubes, spheres, or custom models

• Glowing effects: Indicate active contracts

• Floating position: Hover above ground

• Connection lines: Show interactions with NPCs

• Execution animations: Visual feedback when running

5. Tokens Floating token objects:

• Coin models: 3D coins with token logos

• Rotation animation: Gentle spinning

• Value indicators: Size correlates to market cap

• Price labels: Floating text with current price

• Movement trails: Show trading activity

6. Connection Beams Visual transaction indicators:

• Colored lines: Connect entities during transactions

• Particle streams: Flow along the beam

• Color coding:

  • 🔵 Blue: Swaps

  • 🟢 Green: Deposits/Lending

  • 🔴 Red: Withdrawals

  • 🟡 Yellow: Contract executions

• Intensity: Thicker for larger transactions

Camera Controls

Mouse Controls:

• Left Click + Drag: Rotate camera around scene

• Right Click + Drag: Pan camera left/right/up/down

• Scroll Wheel: Zoom in/out

• Double Click: Focus on clicked object

Keyboard Shortcuts:

• Arrow Keys: Move camera position

• W/A/S/D: Alternative camera movement

• R: Reset camera to default position

• F: Focus on selected object

• Space: Pause/resume camera animations

Touch Controls (Mobile):

• One Finger Drag: Rotate view

• Two Finger Pinch: Zoom in/out

• Two Finger Drag: Pan camera

• Tap: Select objects

Camera Modes:

1. Free Camera: Manual control (default)

2. Follow Mode: Tracks selected NPC

3. Orbit Mode: Circles around center

4. Cinematic Mode: Automated camera movement

View Options:

• Toggle 3D/2D: Switch between 3D metaverse and 2D dashboard

• Fullscreen Mode: Maximize the viewport

• Toggle UI: Hide/show interface elements

• Performance Mode: Reduce visual effects for smoother performance

---

NPCs (Non-Player Characters)

What are NPCs: AI-powered autonomous traders that simulate real human behavior in the DeFi ecosystem. Each NPC has a unique personality, trading strategy, emotional responses, and social connections.

NPC Personalities

Four personality types:

1. 🛡️ Conservative

• Risk Tolerance: Low (20-30%)

• Trading Style: Cautious, small positions

• Preferred Assets: Stablecoins, blue chips

• Typical Actions: Long-term holds, minimal trading

• Emotional Range: Calm, rarely excited or fearful

• Win Rate: 65-75% (fewer trades, higher accuracy)

• Example Behavior: Buys ETH when price dips 5%, holds for weeks

2. ⚖️ Moderate

• Risk Tolerance: Medium (40-60%)

• Trading Style: Balanced, diversified

• Preferred Assets: Mix of stable and volatile

• Typical Actions: Regular trading, portfolio rebalancing

• Emotional Range: Normal emotional responses

• Win Rate: 50-65% (balanced approach)

• Example Behavior: Trades daily, takes profits at 20% gains

3. ⚔️ Aggressive

• Risk Tolerance: High (70-85%)

• Trading Style: High-frequency, leveraged

• Preferred Assets: Volatile altcoins, new launches

• Typical Actions: Frequent trades, quick entries/exits

• Emotional Range: Highly reactive, volatile emotions

• Win Rate: 35-55% (many trades, hit-or-miss)

• Example Behavior: Buys meme coins, uses 10x leverage, panic sells

4. 🐋 Whale

• Risk Tolerance: Controlled (50-70%)

• Trading Style: Market-moving positions

• Preferred Assets: Large cap tokens

• Typical Actions: Massive buys/sells, influences prices

• Emotional Range: Confident, rarely fazed

• Win Rate: 60-75% (experience and capital advantage)

• Example Behavior: Buys $1M of BTC, creates price pumps

NPC Traits System

Each NPC has four core traits (0-100 scale):

1. Risk Tolerance (0-100)

• Low (0-30): Avoids volatility, prefers stables

• Medium (31-70): Balanced risk/reward approach

• High (71-100): Embraces volatility, seeks moonshots

Affects:

• Position sizing

• Asset selection

• Use of leverage

• Stop-loss placement

2. Patience (0-100)

• Low (0-30): Impatient, wants quick profits

• Medium (31-70): Normal holding periods

• High (71-100): Long-term holder, diamond hands

Affects:

• Trade frequency

• Holding duration

• Panic selling likelihood

• Taking profits timing

3. Greed (0-100)

• Low (0-30): Takes profits early, satisfied easily

• Medium (31-70): Balanced profit-taking

• High (71-100): Holds for massive gains, rarely sells

Affects:

• Profit targets

• Position holding after gains

• FOMO susceptibility

• Buying tops likelihood

4. Intelligence (0-100)

• Low (0-30): Poor decisions, follows hype

• Medium (31-70): Decent analysis, some mistakes

• High (71-100): Strategic, informed decisions

Affects:

• Trade quality

• Market timing

• Risk management

• Avoiding scams

Example NPC Profile:

Name: "CryptoWhale42"
Personality: Whale
Traits:
  - Risk Tolerance: 65 (Controlled high)
  - Patience: 80 (Very patient)
  - Greed: 40 (Takes profits regularly)
  - Intelligence: 85 (Highly strategic)

Behavior Prediction:
- Makes large, strategic entries
- Holds through volatility
- Takes profits at key levels
- Influences market with size

NPC Emotions System

NPCs display real-time emotions based on their performance and market conditions.

Six emotional states:

1. 😊 Happy

• Trigger: Profitable trades, portfolio gains

• Visual: Green aura, upward movement

• Behavior: More confident trading, larger positions

• Duration: While profitable

2. 😍 Euphoric

• Trigger: Massive gains (>50%), winning streak

• Visual: Bright gold aura, excited animations

• Behavior: Risky decisions, over-leveraging, FOMO

• Duration: Peak of bull runs

3. 😐 Neutral

• Trigger: Break-even or small movements

• Visual: Standard appearance

• Behavior: Normal trading patterns

• Duration: Sideways markets

4. 😟 Anxious

• Trigger: Small losses, market uncertainty

• Visual: Yellow-orange aura, jittery movement

• Behavior: Hesitant trading, reduced positions

• Duration: Minor downturns

5. 😱 Fearful

• Trigger: Significant losses (>20%), bear market

• Visual: Red aura, erratic movement

• Behavior: Panic selling, avoiding new trades

• Duration: During crashes

6. 😤 Angry

• Trigger: Large losses, scam tokens, liquidations

• Visual: Dark red aura, aggressive animations

• Behavior: Revenge trading, irrational decisions

• Duration: After major setbacks

Emotion Influence on Trading:

• Happy/Euphoric: Increased trade frequency, bigger risks

• Neutral: Baseline behavior

• Anxious/Fearful: Reduced trading, smaller positions, earlier exits

• Angry: Impulsive trades, poor decisions

Visual Indicators:

• Aura color: Surrounds NPC avatar

• Facial expressions: If avatar supports it

• Movement speed: Faster when excited, slower when fearful

• Particle effects: Intensity matches emotion

NPC Relationships

NPCs form dynamic social connections that influence behavior.

Relationship Types:

1. 🤝 Allies (Positive)

• Formation: Similar strategies, mutual profits

• Strength: 0-100 (higher = stronger bond)

• Effects:

  • Copy each other's trades

  • Share information

  • Trade together

  • Coordinate buys/sells

• Visual: Green connection line between NPCs

2. ⚔️ Rivals (Negative)

• Formation: Competing strategies, one profits from other's loss

• Strength: 0-100 (higher = stronger rivalry)

• Effects:

  • Counter-trade each other

  • Compete for same opportunities

  • Try to out-perform

• Visual: Red connection line between NPCs

3. 👥 Neutral (No Relationship)

• Formation: No significant interactions

• Effects: Independent behavior

• Visual: No connection line

Relationship Dynamics:

• Form over time: Based on trading interactions

• Decay: Weaken if not reinforced

• Influence trading: Allies amplify each other's strategies

• Create patterns: Whale movements influence followers

Example:

Whale "CryptoKing" buys 100 ETH
↓
Ally "MoonBoy" (Strength: 85) follows with 10 ETH
↓
Ally "DiamondHands" (Strength: 92) follows with 15 ETH
↓
Price increases due to coordinated buying
↓
All three NPCs profit, relationships strengthen

Creating NPCs

Two methods to add NPCs:

Method 1: Quick Create (Preset NPCs)

Step-by-step:

1. Click "Add NPC" button (bottom control panel)

2. Modal opens with preset NPC templates

3. Choose from available templates:

   • Conservative Trader: Low risk, stable approach

   • Moderate Trader: Balanced strategy

   • Aggressive Trader: High risk, active trading

   • Whale Trader: Large positions, market influence

4. Click "Create [Type]" button

5. NPC spawns immediately in the ecosystem

6. Assigned random username (e.g., "Trader_1234")

7. Default avatar style selected

8. Starts trading based on personality

Quick Create Features:

• Instant setup (no customization needed)

• Pre-configured traits

• Balanced default stats

• Random visual appearance

• Immediate activity

Method 2: Custom NPC Creator

Complete customization process:

1. Open Custom Creator

• Click "Create Custom NPC" button

• Or click "+" icon → "Custom NPC"

• Advanced creation panel opens

2. Basic Information

Username:

• Text input field

• 3-30 characters

• Alphanumeric + underscores

• Must be unique

• Examples: "DiamondHands", "Moon_Chaser", "Whale_Alert"

3. Avatar Customization

Avatar Style (6 options):

• Adventurer: Heroic, bold design

• Avataaars: Cartoon style

• Big Smile: Friendly appearance

• Personas: Professional look

• Notionists: Modern, clean

• Lorelei: Artistic, unique

Avatar Seed:

• Unique identifier string

• Generates specific avatar variation

• Random seed button available

• Or enter custom seed

• Same seed = identical avatar

Preview:

• Real-time avatar preview

• Shows selected style with seed

• Updates instantly on changes

4. Personality Selection

Choose from four types:

• 🛡️ Conservative: Safe, cautious

• ⚖️ Moderate: Balanced approach

• ⚔️ Aggressive: High risk/reward

• 🐋 Whale: Market mover

Each displays:

• Icon representation

• Risk level indicator

• Brief description

• Expected behavior

5. Initial Balance

Balance Input:

• Range: $100 - $1,000,000

• Default: $10,000

• Affects:

  • Position sizes

  • Market impact (higher = bigger trades)

  • Whale status (>$100k)

• Slider or manual input

6. Advanced Traits (Optional)

Customize four core traits (0-100):

Risk Tolerance Slider:

• 0 = Ultra-safe

• 50 = Moderate

• 100 = Degen mode

• Visual: Color changes (green → yellow → red)

Patience Slider:

• 0 = Instant gratification

• 50 = Normal holding

• 100 = Diamond hands forever

• Visual: Timer icon intensity

Greed Slider:

• 0 = Takes profits early

• 50 = Balanced

• 100 = Holds for moon

• Visual: Money icon size

Intelligence Slider:

• 0 = Poor decisions

• 50 = Average trader

• 100 = Market genius

• Visual: Brain icon glow

Trait Recommendations:

• Conservative: Risk 20, Patience 80, Greed 30, Intelligence 70

• Moderate: Risk 50, Patience 50, Greed 50, Intelligence 60

• Aggressive: Risk 80, Patience 20, Greed 75, Intelligence 40

• Whale: Risk 60, Patience 70, Greed 40, Intelligence 85

7. Review & Create

Summary Panel Shows:

• Username

• Avatar preview

• Personality type

• Initial balance

• All trait values

• Expected behavior description

Actions:

• Back: Return to edit

• Reset: Clear all customization

• Create NPC: Finalize and spawn

8. NPC Spawns

After creation:

• NPC appears in 3D world

• Assigned random spawn position

• Begins trading immediately

• Starts with configured balance

• Follows personality/traits

• Forms initial strategy

Post-Creation:

• Cannot edit after spawning

• Can delete and recreate

• Stats update in real-time

• Visible in NPC list

Managing NPCs

NPC List View:

Access via:

• Side panel → "NPCs" tab

• Bottom panel → NPC section

• Main dashboard view

Information Displayed:

• Avatar thumbnail

• Username

• Personality type icon

• Current balance ($)

• Total trades count

• Win rate percentage

• Active/Inactive status

• Current emotion indicator

Sorting Options:

• By balance (highest first)

• By win rate (best first)

• By activity (most active first)

• By name (alphabetical)

Filtering:

• Show only active

• By personality type

• By profit/loss status

• By emotion state

Interacting with NPCs

Click on NPC (in 3D view):

• NPC gets highlighted

• Detail panel opens on right

• Camera focuses on NPC

• Shows real-time stats

Detail Panel Contents:

1. Header Section

• Large avatar display

• Username (bold, prominent)

• Personality badge

• Current emotion status

2. Statistics

• Current Balance: $X,XXX.XX

• Initial Balance: $X,XXX.XX

• Profit/Loss: +$XXX (+XX%)

  • Green if profitable

  • Red if losing

• Total Trades: XXX

• Win Rate: XX%

• Best Trade: +$XXX (XX%)

• Worst Trade: -$XXX (XX%)

3. Trait Display Visual bars showing:

• Risk Tolerance: ████████░░ 80/100

• Patience: ████░░░░░░ 40/100

• Greed: ██████░░░░ 60/100

• Intelligence: ███████░░░ 70/100

4. Current Holdings List of owned tokens:

• Token symbol

• Amount held

• Current value

• Profit/loss on position

5. Recent Activity Last 10 trades:

• Action (Buy/Sell)

• Token

• Amount

• Price

• Profit/Loss

• Timestamp

6. Relationships Shows connections:

• Allies (green names)

• Rivals (red names)

• Relationship strength bars

• How they formed

7. Current Status

• Strategy: What they're planning

• Next Action: Upcoming trade

• Emotion: Why they feel that way

• Performance: Last 24h summary

Actions Available:

• Follow: Track this NPC with camera

• Copy Trades: Mirror their strategy

• Remove: Delete NPC from simulation

• Export Data: Download their trade history

NPC Trading Behavior

Decision-Making Process:

1. Market Analysis

• Check current prices

• Review portfolio

• Calculate profit/loss

• Assess market conditions

2. Emotional State

• Determine current emotion

• Adjust confidence

• Modify risk tolerance

• Influence decisions

3. Strategy Selection Based on personality + emotion:

• Conservative + Happy: Small buys of stable assets

• Aggressive + Euphoric: Large risky buys

• Whale + Fearful: Selling to protect capital

• Moderate + Neutral: Regular rebalancing

4. Trade Execution

• Select token

• Determine position size

• Place order

• Update portfolio

5. Post-Trade

• Evaluate result

• Update emotions

• Adjust strategy

• Influence relationships

Trading Patterns:

Conservative NPCs:

• Trade frequency: Low (1-3 per hour)

• Position size: Small (1-5% of balance)

• Assets: BTC, ETH, stablecoins

• Leverage: Never

• Stop losses: Always set

Moderate NPCs:

• Trade frequency: Medium (3-8 per hour)

• Position size: Medium (5-15% of balance)

• Assets: Mix of major and mid-cap

• Leverage: Rarely (2-3x max)

• Stop losses: Usually set

Aggressive NPCs:

• Trade frequency: High (8-20+ per hour)

• Position size: Large (15-40% of balance)

• Assets: Altcoins, meme tokens, new launches

• Leverage: Often (5-10x)

• Stop losses: Sometimes ignored

Whale NPCs:

• Trade frequency: Low (1-5 per hour)

• Position size: Massive (20-50%+ of balance)

• Assets: All types, focuses on liquidity

• Leverage: Strategic (2-5x)

• Stop losses: Sophisticated risk management

Market Impact:

• Whales move prices significantly

• Aggressive traders create volatility

• Conservative traders provide stability

• Moderate traders follow trends

---

Smart Contracts

What are Smart Contracts in the Simulator: Visual representations of deployed blockchain smart contracts. They appear as 3D objects in the metaverse and can be interacted with to perform various DeFi operations.

Contract Types

1. 🪙 Token Contracts

• Function: Create and manage ERC-20 tokens

• Visual: Rotating coin with token symbol

• Color: Matches token brand

• Size: Based on market cap

• Interactions:

  • Transfer tokens

  • Check balance

  • View total supply

  • See holder count

2. 🔄 DEX Contracts (AMM)

• Function: Automated Market Maker for swaps

• Visual: Connected spheres (liquidity pools)

• Color: Blue-purple gradient

• Interactions:

  • Add liquidity

  • Remove liquidity

  • Swap tokens

  • View pool stats

3. 💰 Lending Contracts

• Function: Borrow/lend assets

• Visual: Vault-like structure

• Color: Green gradient

• Interactions:

  • Deposit collateral

  • Borrow assets

  • Repay loans

  • Earn interest

4. 🏦 Staking Contracts

• Function: Lock tokens to earn rewards

• Visual: Pillar with token symbol

• Color: Gold/yellow

• Interactions:

  • Stake tokens

  • Unstake tokens

  • Claim rewards

  • View APY

5. 🎮 NFT Contracts

• Function: Mint and trade NFTs

• Visual: Floating gallery frame

• Color: Rainbow gradient

• Interactions:

  • Mint NFTs

  • Transfer ownership

  • View metadata

  • Check rarity

6. 🎯 Custom Contracts

• Function: User-deployed contracts

• Visual: Customizable geometric shape

• Color: User-selected

• Interactions: Based on contract logic

Contract Visualization

3D Appearance:

• Geometry: Unique shape per contract type

• Materials: Glowing, metallic, or transparent

• Animations:

  • Idle: Gentle rotation or pulse

  • Active: Bright glow and particles

  • Execution: Flash and energy beam

• Labels: Floating text with contract name

Activity Indicators:

• Glow intensity: More activity = brighter

• Particle effects: Show current interactions

• Connection beams: Link to users executing functions

• Sound effects: Optional audio feedback

Size & Position:

• Size relates to total value locked (TVL)

• Position randomized at spawn

• Can be selected and focused

• Move in response to major interactions

Deploying Contracts

Access Contract Deployment:

1. Click "Deploy Contract" button (side panel)

2. Or use keyboard shortcut "C"

3. Contract deployment modal opens

Deployment Process:

Step 1: Select Contract Type

• Choose from 6 contract types

• View template description

• See gas cost estimate

• Preview 3D model

Step 2: Configure Parameters

For Token Contracts:

• Token Name: Full name (e.g., "MyToken")

• Symbol: Ticker (e.g., "MTK")

• Total Supply: Number of tokens (e.g., 1,000,000)

• Decimals: Precision (default: 18)

• Initial Price: Starting value

For DEX Contracts:

• Token Pair: Select two tokens (e.g., ETH/USDT)

• Initial Liquidity: Amount to seed pool

• Fee Tier: 0.05%, 0.3%, or 1%

For Lending Contracts:

• Supported Assets: Select collateral tokens

• Interest Rate Model: Fixed or variable

• Liquidation Threshold: e.g., 75%

• Loan-to-Value: e.g., 80%

For Staking Contracts:

• Stake Token: Token to be staked

• Reward Token: Token given as reward

• APY: Annual percentage yield

• Lock Period: Optional time lock

For NFT Contracts:

• Collection Name: e.g., "Cool Apes"

• Symbol: e.g., "CAPE"

• Max Supply: Total NFTs (e.g., 10,000)

• Mint Price: Cost per NFT

• Royalty: Creator fee percentage

For Custom Contracts:

• Contract Name: Identifier

• Function List: Define callable functions

• State Variables: Data stored

• Access Control: Who can call functions

Step 3: Visual Customization

Choose Appearance:

• 3D Model: Select from templates or upload

• Primary Color: Main color scheme

• Secondary Color: Accent color

• Glow Color: Activity indicator color

• Size: Small, Medium, Large, Extra Large

• Special Effects: Particles, trails, auras

Step 4: Review & Deploy

Deployment Summary:

• Contract type and name

• All configured parameters

• Visual preview

• Estimated gas cost (simulated)

• Deploy button

Click "Deploy Contract":

• Loading animation (simulated deployment)

• Progress: Compiling → Deploying → Confirming

• Success notification

• Contract spawns in 3D world

• Added to contract list

Post-Deployment:

• Contract is live immediately

• NPCs can interact with it

• You can manage it

• Visible in ecosystem

Interacting with Contracts

Select a Contract:

• Click on 3D model in metaverse

• Or select from contract list

• Contract highlights

• Detail panel opens

Contract Detail Panel:

Header:

• Contract name and type

• 3D preview thumbnail

• Deployment address (simulated)

• Creator badge

Statistics:

• Total Value Locked: $XXX,XXX

• Total Transactions: X,XXX

• Active Users: XXX

• Created: Date and time

• Gas Used: Total gas spent

• Status: Active/Paused/Deprecated

Functions Available: Lists all callable functions with:

• Function name

• Parameters needed

• Expected result

• Gas cost estimate

• Call button

Recent Activity:

• Last 20 interactions

• Who called what function

• Parameters used

• Result/output

• Gas cost

• Timestamp

Execute Function:

1. Select function from list

2. Fill in required parameters

3. Review transaction details

4. Click "Execute"

5. Confirmation modal appears

6. Confirm execution

7. See result in real-time

8. 3D animation plays

9. Transaction added to history

Example - Execute Swap on DEX:

Function: swap(tokenA, tokenB, amount)

Parameters:
- Token A: ETH
- Token B: USDT
- Amount: 1.5 ETH

Expected Output: ~5,205 USDT
Gas Cost: 0.003 ETH (simulated)

[Execute Swap] Button

Result:
✅ Swap successful
Received: 5,203.45 USDT
Slippage: 0.03%
Gas Used: 0.003 ETH

Contract Analytics

View Contract Performance:

• Total volume processed

• Number of unique users

• Revenue generated (fees)

• TVL over time chart

• Activity heatmap

• Top users ranking

Advanced Metrics:

• Transaction success rate

• Average gas cost

• Peak usage times

• Efficiency score

• Security audit status (simulated)

---

DeFi Protocol Buildings

What are DeFi Buildings: Large 3D structures representing major DeFi protocols like Uniswap, Aave, Compound, etc. They serve as visual landmarks and interaction hubs in the metaverse.

Available Protocol Buildings

1. 🦄 Uniswap Exchange

Appearance:

• Structure: Modern exchange building

• Color Scheme: Pink and purple gradient

• Logo: Prominent Uniswap unicorn

• Size: Large, 3-story building

• Special Effects: Swirling particles around entrance

Functions:

• Token swaps (any ERC-20)

• Liquidity provision

• Pool creation

• Yield farming

• Governance voting

Statistics Displayed:

• 24h volume

• Total liquidity

• Active pools

• Swap count

• Average APY

Interaction:

• Click building to enter

• View active pools

• Perform swaps

• Add/remove liquidity

• See pool analytics

2. 👻 Aave Lending Protocol

Appearance:

• Structure: Tall lending tower

• Color Scheme: Gradient green-blue

• Logo: Aave ghost mascot

• Size: Extra large, tallest building

• Special Effects: Floating coins around exterior

Functions:

• Supply assets (earn interest)

• Borrow assets (collateralized)

• Flash loans

• Liquidations

• Rate switching (stable/variable)

Statistics Displayed:

• Total supplied

• Total borrowed

• Available liquidity

• Borrow rate

• Supply APY

Interaction:

• Click to open lending interface

• Supply collateral

• Borrow against collateral

• Monitor health factor

• Execute flash loans

3. 🏛️ Compound Money Market

Appearance:

• Structure: Classical financial institution

• Color Scheme: Green and cyan

• Logo: Compound "C" symbol

• Size: Large, multi-level

• Special Effects: Data streams flowing

Functions:

• Lend assets

• Borrow assets

• Earn COMP rewards

• Governance participation

• Market analytics

Statistics Displayed:

• Supply APY per asset

• Borrow APY per asset

• Total market size

• COMP rewards rate

• Collateral factors

Interaction:

• Enter lending markets

• Supply various assets

• Borrow with collateral

• Claim COMP rewards

• Vote on proposals

4. 📊 Other Protocol Buildings

Curve Finance (Stablecoin DEX):

• Focuses on stablecoin swaps

• Low slippage pools

• High TVL display

SushiSwap (Community DEX):

• Fork of Uniswap

• Additional features

• Sushi rewards

Balancer (Multi-token Pools):

• Weighted pools

• Custom ratios

• Portfolio rebalancing

Yearn Finance (Yield Optimizer):

• Automated yield farming

• Vault strategies

• Maximized returns

Building Interactions

Approaching a Building:

• Camera zooms toward building

• Entrance highlights

• Function menu appears

• Background blurs

Inside View:

• Interface overlay

• Protocol dashboard

• Available functions

• Live statistics

• Exit button

Using Protocol Functions:

1. Select function (e.g., "Swap")

2. Configure parameters

3. Preview outcome

4. Confirm transaction

5. See execution in 3D

6. Transaction complete

Building Analytics:

• Click info button

• View full protocol stats

• Historical data charts

• Top users leaderboard

• Recent transactions

• TVL over time

Visual Feedback:

• Building glows during activity

• Particle effects for transactions

• Size changes with TVL

• Color intensity = activity level

---

Market Events System

What are Market Events: Dynamic, real-time events that simulate real-world market occurrences, affecting the entire ecosystem. Events trigger changes in prices, NPC behavior, and overall sentiment.

Event Types

1. 🚀 Bull Run

• Description: Strong upward price movement

• Duration: 2-5 minutes

• Effects:

  • All token prices increase 10-30%

  • NPCs become euphoric

  • Trading volume spikes

  • FOMO buying increases

  • Green visual effects

• NPC Behavior: Aggressive buying, over-leveraging

• Sound: Uplifting music

2. 📉 Bear Market Crash

• Description: Severe price decline

• Duration: 3-7 minutes

• Effects:

  • Token prices drop 20-50%

  • NPCs become fearful/angry

  • Panic selling

  • Liquidations occur

  • Red visual effects

• NPC Behavior: Selling positions, avoiding new trades

• Sound: Tense, ominous music

3. 🐋 Whale Alert

• Description: Large whale makes massive trade

• Duration: 1-2 minutes

• Effects:

  • Single token moves 15-25%

  • Other NPCs react

  • Market volatility increases

  • Copy-trading surge

  • Blue particle effects

• NPC Behavior: Following or countering whale

• Sound: Alert notification

4. 📰 News Flash

• Description: Major announcement or development

• Duration: 5-10 minutes

• Effects:

  • Specific token(s) affected

  • Sentiment shifts

  • Volume increases

  • Strategic positioning

  • Yellow info displays

• NPC Behavior: Reacting to news, repositioning

• Sound: News alert tone

5. 🎉 Token Launch

• Description: New token hits the market

• Duration: Continuous (token stays)

• Effects:

  • New tradeable asset

  • Speculation surge

  • High volatility

  • Early buyer advantage

  • Rainbow celebration effects

• NPC Behavior: Early entries, price discovery

• Sound: Launch celebration

6. ⚠️ Flash Crash

• Description: Sudden, brief price drop

• Duration: 30-60 seconds

• Effects:

  • Instant 30-60% drop

  • Immediate recovery to 80-90%

  • Liquidation cascade

  • Opportunity for quick buys

  • Orange warning effects

• NPC Behavior: Smart ones buy dip, others panic

• Sound: Alarm sound

7. 💰 Airdrop Announced

• Description: Free tokens distributed

• Duration: 2-3 minutes

• Effects:

  • Eligible NPCs receive free tokens

  • Token price increases

  • Hype and excitement

  • Trading volume surges

  • Gold particle shower

• NPC Behavior: Immediate trading of airdrop

• Sound: Coins dropping sound

8. 🏦 Protocol Hack

• Description: DeFi protocol security breach

• Duration: 5-10 minutes

• Effects:

  • Affected protocol tokens crash

  • Fear spreads to similar tokens

  • Funds withdrawn from protocols

  • Market-wide uncertainty

  • Flashing red alerts

• NPC Behavior: Withdrawing funds, fleeing to safety

• Sound: Emergency siren

9. 🎊 Halving Event

• Description: Bitcoin halving simulation

• Duration: 10+ minutes

• Effects:

  • BTC price surge

  • Altcoin rally follows

  • Long-term bullish sentiment

  • Increased speculation

  • Blue-gold visual theme

• NPC Behavior: Accumulation, long-term positioning

• Sound: Celebration fanfare

10. 🌊 Liquidity Crisis

• Description: Lack of liquidity in markets

• Duration: 3-5 minutes

• Effects:

  • High slippage on swaps

  • Wide bid-ask spreads

  • Difficulty executing large orders

  • Increased volatility

  • Orange warning indicators

• NPC Behavior: Providing liquidity to earn fees

• Sound: Warning beeps

Event Notifications

Visual Notification:

• Banner: Appears at top of screen

• Icon: Event type icon

• Title: Event name

• Description: Brief explanation

• Duration: Countdown timer

• Multiplier: Price impact indicator

Example Notification:

🚀 BULL RUN STARTED!

Market sentiment extremely positive. All major tokens
surging. NPCs entering FOMO buying phase.

Duration: 3:45 remaining
Price Multiplier: 1.25x
Volatility: High

[View Details] [X]

In-World Indicators:

• Sky color change: Reflects event type

• Global particle effects: Match event theme

• Ambient lighting: Intensifies during events

• Sound/Music: Event-specific audio

• NPC auras: Change to match sentiment

Side Panel Event Log:

• List of all active events

• Past event history

• Event frequency settings

• Manual event trigger (advanced)

Event Multipliers

Price Multiplier:

• Affects all token prices during event

• Range: 0.5x (crash) to 2.0x (mega pump)

• Applied in real-time

• Shown in event notification

Volume Multiplier:

• Increases trading activity

• Range: 1.5x to 5x normal

• NPCs trade more frequently

• More transactions visible

Emotion Multiplier:

• Amplifies NPC emotional responses

• Range: 1.2x to 3x normal

• Extreme reactions during big events

• Faster emotion state changes

Example:

Event: Bear Market Crash
- Price Multiplier: 0.6x (40% drop)
- Volume Multiplier: 3x (panic selling)
- Emotion Multiplier: 2.5x (extreme fear)

Result:
- Tokens drop 40% on average
- Trading volume triples
- Most NPCs become fearful or angry
- Liquidations trigger
- Market chaos ensues

Event Frequency Settings

Control Event Rate:

• Very Rare: Event every 10-15 minutes

• Rare: Event every 5-10 minutes

• Normal: Event every 3-5 minutes (default)

• Frequent: Event every 1-3 minutes

• Constant: Multiple overlapping events

Manual Event Trigger:

• Admin/Creator mode

• Select specific event type

• Set custom multipliers

• Set duration

• Trigger immediately

• Useful for testing scenarios

---

Launched Tokens

What are Launched Tokens: Tradeable cryptocurrencies within the ecosystem. They include both established tokens (BTC, ETH, etc.) and custom tokens you can launch.

Pre-Loaded Tokens

Default tokens in ecosystem:

1. Bitcoin (BTC)

• Starting price: ~$95,000

• Volatility: Low-Medium

• Holder count: 48M+

• Volume: $28B daily

• Characteristics: Store of value, follows real BTC trends

2. Ethereum (ETH)

• Starting price: ~$3,500

• Volatility: Medium

• Holder count: 120M+

• Volume: $15B daily

• Characteristics: Smart contract platform, DeFi hub

3. Neiro (NEIRO)

• Starting price: ~$0.0018

• Volatility: High

• Holder count: 45K

• Volume: $15M daily

• Characteristics: Meme coin, community-driven

Additional pre-loaded:

• USDT (Tether): Stablecoin at $1.00

• BNB (Binance Coin): Exchange token

• SOL (Solana): Fast blockchain

• ADA (Cardano): Proof-of-stake platform

• DOT (Polkadot): Interoperability chain

• MATIC (Polygon): Layer 2 scaling

Launching Custom Tokens

Access Token Launch Pad:

1. Click "Launch Token" button

2. Or navigate to side panel → "Tokens" → "Launch New"

3. Token creation interface opens

Token Launch Process:

Step 1: Token Economics

Token Name:

• Full project name

• Example: "MoonShot Token"

• 3-50 characters

Symbol:

• Trading ticker

• Example: "MOON"

• 2-10 characters

• Uppercase recommended

Total Supply:

• Number of tokens to create

• Range: 1,000 to 1,000,000,000,000

• Consider scarcity vs utility

• Cannot change after launch

Decimals:

• Precision of token divisions

• Default: 18 (same as ETH)

• Range: 0-18

• Lower = larger minimum trade size

Initial Price:

• Starting price per token

• Set in USD

• Range: $0.000001 to $1,000,000

• Affects initial market cap

Step 2: Token Metadata

Description:

• Project explanation

• Use case

• Target audience

• Up to 500 characters

Website:

• Optional project URL

• Builds credibility

• Shows in token details

Logo Upload:

• Image file (PNG, JPG, SVG)

• Recommended size: 512x512px

• Appears in ecosystem

• Shown on token card

Social Links:

• Twitter/X handle

• Telegram group

• Discord server

• GitHub repository

Step 3: Tokenomics Distribution

Allocation Breakdown:

Total Supply: 1,000,000 MOON

Public Sale:     400,000 (40%)
Team:            200,000 (20%)
Development:     150,000 (15%)
Marketing:       100,000 (10%)
Liquidity Pool:  100,000 (10%)
Reserved:         50,000 (5%)

Vesting Schedule:

• Team tokens: 2-year vesting

• Advisors: 1-year vesting

• Public: Immediate

• Custom vesting rules

Step 4: Launch Configuration

Initial Liquidity:

• Amount to add to DEX pool

• Paired with stable coin or ETH

• Higher = lower slippage

• Locks for specified duration

Launch Style:

• Fair Launch: Equal access for all

• Presale: Early buyer discount

• Airdrop: Free distribution first

• ICO: Crowdfunding style

Price Discovery:

• Fixed Price: Set initial price

• Bonding Curve: Price increases with buys

• Auction: Let market decide

Launch Date:

• Immediate

• Or schedule for future

• Countdown timer if scheduled

Step 5: Advanced Features (Optional)

Burn Mechanism:

• Enable token burning

• Burn percentage per transaction

• Deflationary tokenomics

Reflection/Rewards:

• Holders earn passive income

• Percentage of each transaction

• Distributed automatically

Anti-Whale Measures:

• Max transaction size limit

• Max wallet size limit

• Prevents large dumps

Trading Tax:

• Buy tax percentage

• Sell tax percentage

• Tax distribution (marketing, dev, holders)

Blacklist/Whitelist:

• Blacklist suspicious addresses

• Whitelist for presale/early access

Step 6: Review & Launch

Launch Summary:

• All token details

• Distribution breakdown

• Initial liquidity

• Launch style

• Visual preview

Gas Cost Estimate:

• Simulated deployment cost

• Based on complexity

• Shown in ETH and USD

Launch Checklist:

• ✅ Token details complete

• ✅ Logo uploaded

• ✅ Distribution allocated

• ✅ Liquidity provided

• ✅ Terms accepted

Click "Launch Token":

• Deployment animation plays

• Progress: Deploying → Adding Liquidity → Listing

• Success confirmation

• Token appears in ecosystem

• Trading begins immediately

Post-Launch Management

Token Dashboard:

Statistics:

• Current price

• 24h change (%)

• Market cap

• 24h volume

• Holder count

• Total transactions

Price Chart:

• Real-time price history

• Multiple timeframes (1h, 24h, 7d, 30d)

• Volume bars

• Annotations for events

Holder Distribution:

• Top 10 holders

• Ownership percentages

• Distribution chart

• Whale alerts

Trading Activity:

• Recent buy/sell orders

• Transaction amounts

• Wallet addresses

• Timestamps

Management Actions:

• Update metadata

• Add liquidity

• Adjust parameters (if enabled)

• Burn tokens

• Airdrop to holders

• Pause/unpause trading (emergency)

Marketing Tools:

• Generate shareable chart

• Tweet integration

• Community announcements

• Holder rewards campaigns

Token Interactions in 3D

Visual Representation:

• 3D coin model with logo

• Rotates slowly

• Size based on market cap

• Glows based on trading activity

When NPCs Trade:

• Beam connects NPC to token

• Particles flow along beam

• Token pulses

• Price updates in real-time

Price Movement Animation:

• Token rises with price increase

• Token sinks with price decrease

• Speed correlates to volatility

• Leaves particle trail

Click on Token:

• Token enlarges and centers

• Detail panel opens

• Statistics display

• Trade interface available

Trade from 3D View:

1. Select token in world

2. Click "Trade" button

3. Choose buy or sell

4. Enter amount

5. Confirm transaction

6. See execution in 3D

---

Simulation Controls

What are Simulation Controls: The command center for managing the entire ecosystem simulation. Adjust speed, visibility, add entities, and monitor performance.

Main Control Panel (Bottom)

Location: Bottom of screen, always visible

Buttons from left to right:

1. ▶️ Play/Pause

• Play: Simulation runs, NPCs trade

• Pause: Freezes all activity

• Keyboard: Spacebar

• Visual: Icon changes

• Use case: Observe specific moment

2. ⏩ Speed Control

• 1x: Normal speed (default)

• 2x: Double speed

• 5x: Five times faster

• 10x: Maximum speed

• Keyboard: +/- keys

• Visual: Speed multiplier shown

• Use case: Fast-forward boring periods

3. 🔄 Reset Simulation

• Function: Restart from beginning

• Effect: Clears all NPCs, trades, events

• Confirmation: Modal asks to confirm

• Keyboard: R

• Warning: Cannot undo

• Use case: Start fresh scenario

4. ➕ Add NPC

• Function: Quick create NPC

• Opens: Preset NPC modal

• Keyboard: N

• Use case: Populate ecosystem quickly

5. 🎨 Custom NPC

• Function: Advanced NPC creator

• Opens: Full customization panel

• Keyboard: Shift + N

• Use case: Create specific NPC types

6. 🚀 Launch Token

• Function: Create new token

• Opens: Token launch pad

• Keyboard: T

• Use case: Add tradeable assets

7. 📄 Deploy Contract

• Function: Create smart contract

• Opens: Contract deployment

• Keyboard: C

• Use case: Add DeFi functionality

8. 🎭 Trigger Event

• Function: Manually start market event

• Opens: Event selection menu

• Keyboard: E

• Use case: Test specific scenarios

9. 📊 Analytics

• Function: Open full statistics dashboard

• Opens: Detailed analytics panel

• Keyboard: A

• Use case: Review performance

10. ⚙️ Settings

• Function: Simulation configuration

• Opens: Settings modal

• Keyboard: S

• Use case: Adjust preferences

Side Panel (Right)

Location: Right edge, collapsible

Tabs:

1. 📊 Overview

• Real-time statistics

• Key metrics

• Active entities count

• Performance indicators

2. 👥 NPCs

• List of all NPCs

• Sortable by various metrics

• Quick actions per NPC

• Creation button

3. 🪙 Tokens

• All tradeable tokens

• Price and market cap

• Launch new token button

• Market overview

4. 📜 Contracts

• Deployed smart contracts

• Activity status

• Interaction buttons

• Deploy new button

5. 🏛️ DeFi Protocols

• Protocol buildings list

• TVL and statistics

• Quick access buttons

6. 📈 Events

• Active events

• Event history

• Frequency settings

• Manual trigger

7. 🏆 Achievements

• Unlocked achievements

• Progress to next

• Achievement list

• Rewards claimed

Visibility Settings

Toggle UI Elements:

Access via Settings → Visibility

NPCs:

• ✅ Show NPCs

• ✅ Show NPC names

• ✅ Show NPC emotions

• ❌ Show NPC stats overlay

• ✅ Show NPC relationships

Tokens:

• ✅ Show tokens

• ✅ Show token prices

• ❌ Show price charts

• ✅ Show volume indicators

Contracts:

• ✅ Show contracts

• ❌ Show contract labels

• ✅ Show activity beams

• ✅ Show execution effects

Buildings:

• ✅ Show DeFi buildings

• ✅ Show building names

• ✅ Show TVL stats

• ❌ Show interior views

Effects:

• ✅ Particle effects

• ✅ Connection beams

• ✅ Glow effects

• ❌ Screen shake

• ✅ Sound effects

UI:

• ✅ Control panel

• ✅ Side panel

• ✅ Event notifications

• ✅ Live metrics overlay

• ❌ Performance stats

Performance Mode:

• Reduces visual effects

• Lower polygon counts

• Fewer particles

• Better FPS on slower devices

Simulation Statistics

Real-Time Metrics:

General Stats:

• Total Volume: $XXX,XXX,XXX

• Total Transactions: X,XXX,XXX

• Active Traders: XXX

• Average Profit: +XX%

• Top Performers: XX

Market Stats:

• Total Market Cap: $XX.XB

• 24h Volume: $XXX.XM

• Number of Tokens: XX

• Active Pools: XX

• Total Liquidity: $XX.XM

Contract Stats:

• Deployed Contracts: XX

• Total Interactions: X,XXX

• Gas Used: XXX ETH (simulated)

• Success Rate: XX%

NPC Stats:

• Total NPCs: XXX

• Active NPCs: XXX

• Average Win Rate: XX%

• Profitable NPCs: XX%

• Biggest Winner: +$XXX,XXX

• Biggest Loser: -$XX,XXX

Event Stats:

• Total Events: XXX

• Current Event: [Event Name]

• Event Impact: [Multiplier]

• Time Since Last: X:XX

Charts Available:

• Volume over time

• Price movements

• Active users

• Transaction count

• Market cap growth

• NPC performance distribution

Keyboard Shortcuts

Essential Shortcuts:

• Space: Play/Pause simulation

• +/-: Increase/decrease speed

• R: Reset simulation (with confirmation)

• N: Add NPC quickly

• Shift+N: Custom NPC creator

• T: Launch new token

• C: Deploy contract

• E: Trigger market event

• A: Open analytics

• S: Open settings

• F: Toggle fullscreen

• V: Cycle visibility presets

• H: Show/hide all UI

• I: Toggle info panels

• L: Toggle live metrics

• M: Toggle minimap (if available)

• 1-9: Quick select NPC 1-9

• ESC: Close modals/deselect

Camera Shortcuts:

• Arrow Keys: Move camera

• W/A/S/D: Alternative movement

• Q/E: Rotate left/right

• Home: Reset camera position

• End: Center on origin

• PgUp/PgDn: Zoom in/out

Advanced Shortcuts:

• Shift+R: Hard reset (no confirmation)

• Shift+E: Random event

• Shift+T: Quick token launch

• Shift+C: Quick contract deploy

• Ctrl+A: Select all NPCs

• Ctrl+D: Deselect all

• Ctrl+S: Save simulation state

• Ctrl+L: Load simulation state

---

Achievements System

What are Achievements: Gamification elements that reward you for reaching milestones and exploring ecosystem features. Unlocking achievements provides recognition and sometimes special perks.

Achievement Categories

1. 🏁 Getting Started

First Steps:

• Create First NPC: Add your first AI trader

• Launch First Token: Create a custom token

• Deploy First Contract: Deploy a smart contract

• First Trade: Execute a transaction

• Welcome to DeFi: Complete tutorial

2. 👥 NPC Management

Population Milestones:

• Small Community: Have 5 active NPCs

• Growing Ecosystem: Have 25 active NPCs

• Thriving Metaverse: Have 50 active NPCs

• Mega City: Have 100+ active NPCs

NPC Diversity:

• Personality Mix: Have all 4 personality types

• Emotional Range: Witness all 6 emotions

• Relationship Builder: Create 10 alliances

• Rivalry King: Create 10 rivalries

3. 💰 Trading & Profits

Volume Achievements:

• First Million: Reach $1M total volume

• High Roller: Reach $10M total volume

• Market Maker: Reach $100M total volume

• Whale Status: Reach $1B total volume

Profitability:

• First Profit: Any NPC makes profit

• Profitable Trader: NPC makes $10K profit

• Master Trader: NPC makes $100K profit

• Legendary Gains: NPC makes $1M+ profit

4. 🪙 Token Success

Token Launches:

• Token Creator: Launch first custom token

• Portfolio Builder: Have 10 different tokens

• Token Empire: Launch 20+ tokens

• Token Mogul: Launch 50+ tokens

Market Cap Milestones:

• Thousand Dollar Token: Token reaches $1K market cap

• Million Dollar Token: Token reaches $1M market cap

• Moonshot: Token reaches $10M market cap

• To the Moon: Token reaches $100M+ market cap

Price Movements:

• 10x Gains: Token increases 10x from launch

• 100x Moon: Token increases 100x from launch

• 1000x Legend: Token increases 1000x from launch

5. 📜 Smart Contracts

Contract Deployment:

• Smart Contract Pioneer: Deploy first contract

• Contract Collector: Deploy 10 contracts

• Contract Master: Deploy 50+ contracts

Contract Usage:

• First Interaction: Execute contract function

• Power User: 100 contract interactions

• Contract Whisperer: 1,000+ interactions

6. 🎭 Market Events

Event Experience:

• Market Observer: Witness first event

• Event Veteran: Experience all event types

• Chaos Manager: Survive 50 events

• Event Master: Trigger 100+ events

Specific Events:

• Bull Run Rider: Profit during bull run

• Bear Market Survivor: Stay profitable in crash

• Flash Crash Buyer: Buy the dip successfully

• Whale Watcher: Observe whale making big trade

7. 🏛️ DeFi Protocols

Protocol Usage:

• DeFi Explorer: Use all protocol buildings

• Liquidity Provider: Add liquidity to pools

• Borrower: Take out a loan

• Lender: Supply assets for interest

• Flash Loan Expert: Execute flash loan

TVL Achievements:

• First Liquidity: Add first liquidity

• Big Liquidity: $100K TVL across protocols

• Whale Liquidity: $1M+ TVL

8. 🎓 Educational

Learning Milestones:

• Knowledge Seeker: Read all tooltips

• Tutorial Master: Complete all tutorials

• Help Yourself: Use help system 10 times

• DeFi Scholar: Unlock all educational content

9. 🕐 Time-Based

Dedication:

• First Hour: Simulate for 1 hour

• Marathon Runner: Simulate for 10 hours

• Ecosystem Devotee: Simulate for 100 hours

• Lifetime Achievement: Simulate for 1,000 hours

Consistency:

• Daily User: Use 7 days in a row

• Weekly Warrior: Use 30 days in a row

• Year-Long Journey: Use 365 days in a row

10. 🏆 Special Achievements

Rare Achievements:

• Perfect Timing: Execute trade at exact price target

• Zero Loss: All NPCs profitable simultaneously

• Market Manipulator: Move token price 50%+ with single NPC

• Community Leader: Have NPC with 20+ allies

• Contrarian: Profit when everyone else loses

• Speed Demon: 10,000 transactions in 1 hour

• Diversified: Hold 50+ different tokens

• Long-Term Holder: Hold token for 30+ simulated days

Hidden Achievements:

• Easter Egg Hunter: Find hidden feature

• Bug Reporter: Submit helpful feedback

• Name Master: Create NPC with clever name

• Chaos Creator: Trigger 5 events simultaneously

Achievement Rewards

Visual Rewards:

• Badges: Display on profile

• Titles: Special name prefixes

• Particle Effects: Unique visual effects

• Avatar Borders: Colored frames

• Custom Themes: Unlock color schemes

Functional Rewards:

• Unlock Features: Access advanced tools

• Boost Multipliers: Increased gains

• Special NPCs: Unique personality types

• Custom Assets: Exclusive tokens/contracts

• Priority Access: New features early

Example Achievement:

🏆 ACHIEVEMENT UNLOCKED!

"Bull Run Rider"

Successfully profited during a bull run event
with at least 3 NPCs simultaneously.

Reward:
- Unlocked "Golden Bull" NPC avatar
- +10% profit multiplier for 24 hours
- "Bull Market Expert" title

[Claim Reward]

Achievement Tracking

Progress View:

• See all achievements

• Track completion percentage

• View locked vs unlocked

• Sort by category or rarity

• Filter by type

Notifications:

• Pop-up when unlocked

• Sound effect

• Animation

• Added to achievement log

Leaderboard:

• Total achievements unlocked

• Rarest achievements

• First to unlock

• Community rankings

---

Advanced Features

Analytics Dashboard

Comprehensive Statistics:

Market Overview:

• Total ecosystem value

• 24h volume changes

• Active traders count

• Transaction heatmap

• Asset distribution pie chart

NPC Performance:

• Win rate distribution

• Profit/loss breakdown

• Trading frequency graph

• Personality effectiveness

• Emotion timeline

Token Metrics:

• Price correlation matrix

• Volume leaders

• Holder growth charts

• Liquidity depth

• Volatility rankings

Contract Analytics:

• Function call frequency

• Gas usage patterns

• Success/failure rates

• Popular contracts

• TVL trends

Historical Data:

• Customizable date ranges

• Export to CSV

• Chart sharing

• Comparison tools

• Trend analysis

Data Export

Export Options:

• NPCs: Complete trade history

• Tokens: Price and volume data

• Contracts: Interaction logs

• Events: Timeline and impacts

• Full Simulation: Everything

Formats:

• CSV (spreadsheet)

• JSON (programming)

• PDF (reports)

• Images (charts)

Use Cases:

• Portfolio analysis

• Strategy backtesting

• Educational presentations

• Research papers

• Personal records

Simulation Scenarios

Preset Scenarios:

1. Bull Market

• All tokens trending up

• High NPC confidence

• Frequent positive events

• Easy profits

• Learn in favorable conditions

2. Bear Market

• Declining prices

• Fearful NPCs

• Liquidation cascades

• Survival challenge

• Learn risk management

3. High Volatility

• Rapid price swings

• Emotional NPCs

• Frequent events

• High-risk/reward

• Learn quick decision-making

4. Stable Market

• Low price movement

• Calm NPCs

• Rare events

• Strategic focus

• Learn patience

5. Whale Manipulation

• Large players dominate

• Price manipulation

• Copy-trading dynamics

• Learn to spot whales

6. DeFi Summer

• All protocols active

• High yields

• Token launches frequent

• Bull market + innovation

7. Market Crash

• Severe downturn

• Panic everywhere

• Liquidations

• Test resilience

8. Custom Scenario

• Set all parameters

• Choose events

• Configure NPCs

• Design your test

Save & Load States

Save Simulation:

• Click Settings → Save State

• Name your save

• Preserves:

  • All NPCs and their states

  • Token prices and history

  • Contract deployments

  • Relationships

  • Events

  • Achievements progress

• Multiple save slots

Load Simulation:

• Click Settings → Load State

• Select from saves

• Restores exact moment

• Continue from there

• Useful for:

  • Testing strategies

  • Comparing outcomes

  • Showing specific scenarios

  • Tutorials

Performance Optimization

Graphics Settings:

• Quality: Low/Medium/High/Ultra

• Particle Count: Adjust density

• Shadow Quality: Performance impact

• Anti-aliasing: Smooth edges

• V-Sync: Screen tearing prevention

Simulation Settings:

• Max NPCs: Cap total count

• Update Frequency: Trade calculation rate

• Event Frequency: How often events occur

• Relationship Updates: Social calculation rate

Recommended Settings:

For Low-End Devices:

• Quality: Low

• Particles: Minimal

• Shadows: Off

• Max NPCs: 25

• Events: Rare

For High-End Devices:

• Quality: Ultra

• Particles: Maximum

• Shadows: High

• Max NPCs: Unlimited

• Events: Frequent

Mobile & Touch Support

Touch Controls:

• Single tap: Select

• Double tap: Focus

• Drag: Rotate camera

• Pinch: Zoom

• Two-finger drag: Pan

• Long press: Context menu

Mobile Interface:

• Simplified UI

• Larger buttons

• Bottom sheet panels

• Gesture navigation

• Performance optimized

Responsive Design:

• Adapts to screen size

• Portrait/landscape support

• Touch-friendly controls

• Readable text scaling

---

Use Cases & Learning Scenarios

How to Learn from the Ecosystem:

1. Understand Market Psychology

• Watch NPC emotions change

• See how fear causes selling

• Observe FOMO buying

• Learn emotional trading pitfalls

2. Practice Risk Management

• See what happens with high leverage

• Watch liquidations occur

• Observe diversification benefits

• Learn position sizing

3. Learn DeFi Protocols

• Interact with Uniswap visually

• Understand lending/borrowing

• See how liquidity pools work

• Practice without risk

4. Study Market Events

• Experience bull/bear markets safely

• Understand crash dynamics

• Learn to identify opportunities

• Build mental models

5. Test Trading Strategies

• Create NPCs with different approaches

• Compare results

• Identify what works

• Refine strategies

6. Understand Tokenomics

• Launch tokens with different parameters

• See supply/demand dynamics

• Observe price discovery

• Learn what makes tokens valuable

7. Smart Contract Education

• Deploy and interact with contracts

• Understand gas costs

• See contract execution

• Learn blockchain fundamentals

8. Social Dynamics

• Watch whale influence

• See copy-trading effects

• Understand market sentiment

• Learn crowd psychology

---

Tips & Best Practices

Getting Started:

1. Start with 5-10 NPCs (diverse personalities)

2. Use normal simulation speed initially

3. Watch a full market cycle

4. Enable all visual indicators

5. Trigger events manually to learn

Creating Balanced Ecosystems:

• Mix personality types (25% each)

• Include at least one whale

• Have variety in risk tolerance

• Different initial balances

• Enable relationships

Learning Effectively:

• Pause to analyze situations

• Use detail panels extensively

• Track specific NPCs

• Compare strategies

• Export data for review

Experimentation:

• Save before major changes

• Try extreme scenarios

• Break things intentionally

• Test edge cases

• Document learnings

Performance:

• Start small, scale up

• Use performance mode if laggy

• Close other applications

• Reduce visual effects if needed

• Monitor FPS counter

---

Troubleshooting

Common Issues:

Simulation Running Slow:

• Reduce NPC count

• Lower graphics quality

• Disable particles

• Use performance mode

• Close detail panels

NPCs Not Trading:

• Check if simulation paused

• Verify NPCs have balance

• Ensure tokens exist

• Check for market events affecting behavior

3D View Not Loading:

• Check WebGL support in browser

• Update graphics drivers

• Try different browser

• Disable browser extensions

• Reduce quality settings

Data Not Updating:

• Refresh page

• Check internet connection

• Clear browser cache

• Disable ad blockers

Achievements Not Unlocking:

• Verify requirements met

• Check achievement log

• Restart simulation

• Report bug if persistent

Getting Help:

• Read tooltips (hover info icons)

• Check FAQ section

• Access tutorial mode

• Contact support

• Community forums