■ DOCS // v0.1

HOW TO PLAY HARVY

Everything you need to go from your first carrot to a thriving farm in one shared world. A cozy farming MMO in your browser, powered by the live $HARVY token on Solana.

BROWSER-BASEDMULTIPLAYER MMOLIVE ON SOLANAHOLDER-GATED

01 · What is Harvy

Harvy is a cozy isometric farming MMO that runs entirely in your browser. Think Harvest Moon, but online — every player shares one living world, farming side by side in real time.

You till soil, plant seeds, raise animals, craft goods, and trade in a player-driven economy. The whole world is rendered in a warm PlayStation-era style: pixel fonts, soft CRT glow, and the quiet charm of a game you can lose hours in.

It is built on Solana, and its in-game currency is $HARVY — a live token on Solana mainnet. The game is fully playable today: you can deposit $HARVY into your farm, earn more by playing, and claim it back out to your wallet on-chain.

▲ NOTEHarvy is built for nostalgia, not hype. The game comes first — playable now, with a real, working token economy behind it.

02 · Getting Started

Harvy is holder-gated: to play the real game you connect a Solana wallet that holds at least 1,000 $HARVY. Prefer to look around first? Jump in as a guest in demo mode — no wallet, no token needed.

  1. 1
    Open the game
    Go to play.harvy.gg in any modern browser — desktop or mobile. Nothing to install.
  2. 2
    Connect your wallet
    Connect Phantom or Solflare and approve a quick signature to prove you own the wallet. If it holds 1,000+ $HARVY, you're in.
  3. 3
    Or try the demo
    No $HARVY yet? Click "Play as Guest (Demo)" to explore with a dummy balance. Demo progress can't be deposited or claimed on-chain.
  4. 4
    Pick your look & spawn in
    Create your character and you'll spawn in Hometown — the central hub where buying, selling, and trading happen.
  5. 5
    Head to the Farm
    Walk to the west gate portal and travel to the Farm world to claim your private plot and start growing.
▲ NOTEPlaying on a phone? Turn it landscape for the best experience — the touch joystick and action button are built in.

03 · Controls

ActionDesktopMobile
MoveWASD / Arrow keysOn-screen joystick (left)
Interact / ActClick or action keyAction button (right)
Travel through portalWalk close → press EWalk close → tap prompt
Zoom cameraMouse scrollPinch
Open shop / craft panelsWalk near a buildingWalk near a building
Ride / dismount horseToggle mount keyMount button
Sleep (restore energy)Near cottage in Hometown → Sleep😴 Sleep button
Deposit / Claim $HARVY💰 Wallet button💰 Wallet button

Harvy is server-authoritative: everything you do is validated on the server. There is no client-side cheating — what you see is the real, shared world state.

04 · The Four Worlds

Harvy is split into four connected worlds. Walk to a glowing portal at the edge of a world to travel between them. Your balance, inventory, and progress follow you everywhere.

🏘️ Hometown

The social hub. Shops, the marketplace, the well, and other players. This is where you buy seeds and sell your harvest.

🌱 Farm

Where you grow. Claim a private plot, till the soil, plant, water, and harvest. Only you can farm your own plot.

🐄 Ranch

Where you keep animals. Raise cows, chickens, and sheep in your private pen, feed them, and collect their produce.

⛏️ Mine

Where you dig. Break rocks with your pickaxe (hotkey 6) to mine ore — copper, silver, or gold — then sell it back in Hometown.

Ore (from the Mine)

Each rock takes 45 hits to break and drops one ore. Rarer ore is worth more. Sell ore to the Hometown NPC at a fixed price per ore (rarer ore = more $HARVY).

OreDrop RateBase Sell
🟤 Copper Ore60%6
⚪ Silver Ore35%18
🟡 Gold Ore5%60

05 · Farming Loop

The core loop is simple, satisfying, and endlessly repeatable:

  1. 1
    Buy seeds
    Visit a shop in Hometown and buy seeds with $HARVY.
  2. 2
    Till the soil
    On your Farm plot, turn grass into tilled soil ready for planting.
  3. 3
    Plant
    Sow your seeds into the tilled soil.
  4. 4
    Water
    Crops only grow while watered. Refill your watering can at the well. Rain waters everything for free.
  5. 5
    Harvest
    When a crop reaches its final growth stage, harvest it — sometimes at silver or gold quality.
  6. 6
    Sell or craft
    Sell raw to an NPC for quick cash, list it on the marketplace, or craft it into something worth more.

06 · Crops & Quality

CropSeed CostGrow TimeBase Sell
🥕 Carrot5 $HARVY~20s14
🌽 Corn8 $HARVY~35s18 (×2 yield)
🥬 Cauliflower12 $HARVY~50s44

Every harvest can roll a quality tier based on your land's fertility, your tool tier, and a little luck. Higher quality sells for much more:

QualitySell Multiplier
Normal×1.0
Silver×1.5
Gold×2.5
▲ NOTETip: upgrade your tile's fertility and your tools to raise your odds of silver and gold harvests.

07 · Livestock

Head to the Ranch to raise animals. Feed them harvested carrots and they'll produce goods on a timer. You can keep up to 6 animals.

AnimalCostFeedProducesSell
🐔 Chicken30 $HARVY1 carrot🥚 Egg12
🐄 Cow80 $HARVY2 carrots🥛 Milk26
🐑 Sheep60 $HARVY2 carrots🧶 Wool34

Want to get around faster? Buy a horse (500 $HARVY) at the stable. Mounted, you move 1.7× faster across every world.

08 · Crafting

Raw goods are worth more once processed. Crafting always beats selling ingredients raw — it's the smart farmer's edge.

RecipeIngredientsSells For
🧃 Carrot Juice3 carrots60
🧀 Cheese2 milk70
🥫 Mayonnaise3 eggs56

09 · Economy & $HARVY

$HARVY is the currency that runs the world. The economy is designed to last — to reward steady farmers and resist the farm-and-dump cycle that kills most game tokens.

Two ways to sell

NPC — the safety net

Instant sale at a fixed price per item — reliable and predictable. The marketplace usually pays more.

Marketplace — the smart play

List goods for other players at your own price. More profit, and tokens circulate between farmers instead of draining the pool.

Fixed NPC prices

NPC sell prices are fixed per item (see the tables above) — what you see is what you get, no matter the pool. Want more profit? The marketplace lets you set your own price and trade with other farmers, and a small 5% marketplace fee recycles into the reward pool.

Deposit & Claim (on-chain)

Your in-game balance is backed by real $HARVY. Open the 💰 Wallet panel in game to move tokens across the boundary:

Deposit

Send $HARVY from your Phantom wallet into the game's pool. It credits your in-game balance automatically once the transfer confirms on-chain.

Claim

Withdraw your in-game balance back to your wallet as real $HARVY. The server signs an on-chain transfer straight to your address.

▲ NOTEGameplay is off-chain and instant; only deposits and claims touch the blockchain. Guests play with a dummy balance and can't deposit or claim.

10 · Progression

Leveling

You earn XP from farming (+10 per harvest) and mining (+5 per rock broken). Every 5 levels grants a permanent +1 bonus to your harvest yield.

Tool upgrades

TierWork AreaUpgrade Cost
Copper1 tile
Silver3×350 $HARVY
Gold5×5150 $HARVY

Land fertility

Fertilize your tiles (20 $HARVY per tier, up to 3 tiers) to make crops grow faster — each tier adds ~50% growth speed — and improve your chances of silver/gold harvests. A cheaper Fertilizer item (8 $HARVY) is also sold in the seed shop.

Energy

Every farm action (till, plant, water, harvest, feed) and each pickaxe swing costs a little energy (out of 100). When you run low, sleep in Hometown to restore to full.

Achievements

Seven goals to chase — from your First Harvest to becoming a Tycoon (hold 500 $HARVY) or mastering your tools. Track them in the Goals panel.

11 · Wallet & Token

$HARVY is live on Solana mainnet. It's a Token-2022 asset with 6 decimals — the same token you hold in your wallet is what powers the game.

DetailValue
NetworkSolana mainnet
StandardToken-2022
Decimals6
Hold to play1,000 $HARVY minimum
Mint23xZrAXQTRLsuH5KXyv3CiEHmWLL2vKbG6C9PpGHARVY

▶ View $HARVY on Solscan

Connect Phantom or Solflare to play. You'll sign a quick message (free, not a transaction) so the server can verify you own the wallet and that it holds enough $HARVY. From there, deposit tokens into your farm and claim your earnings back out anytime.

▲ NOTEWe'll never ask you to share your seed phrase or sign a blind transaction. The only transactions you approve are your own deposits. Always double-check you're on play.harvy.gg.

12 · FAQ

Q.Do I need to download anything?
A.No. Harvy runs in your browser on desktop and mobile.
Q.Do I need $HARVY to play?
A.To play the real game, yes — connect a wallet holding at least 1,000 $HARVY. You can also explore in guest demo mode with no wallet, but demo progress can't be deposited or claimed.
Q.Is the token live? Can I get $HARVY?
A.Yes. $HARVY is live on Solana mainnet (Token-2022). Acquire it on Solana, hold 1,000+, and connect your wallet to play.
Q.How do I get my earnings out?
A.Open the 💰 Wallet panel and use Claim. The server sends your in-game balance to your wallet as real $HARVY on-chain.
Q.Can I play on my phone?
A.Yes. Play in landscape for the best layout — touch controls are built in.
Q.Is my progress saved?
A.Yes. Your balance, inventory, and progress persist across worlds and server restarts, tied to your wallet.
Q.Can other players steal my crops?
A.No. Farming is restricted to your own private plot — the server enforces it.

READY TO FARM?

No download. Connect your wallet and start growing.

START FARMING

■ HARVY.inc // a cozy farming MMO on Solana