Game guide · everything you need to play

VoxelValley Docs

Your friendly field guide to the valley, how to sign in, what to do, where the rare fish hide, how the money works, and what's actually on-chain. Skim the sidebar, or read it cover to cover.

Getting started

VoxelValley plays right in your browser, no download, no install. Open the game and you're in the valley in under a minute.

Launch the game →

Sign in with Phantom

To play and keep your progress, connect a Phantom wallet set to Solana Devnet. This is a devnet test build, so there's no real money involved, only test SOL. You'll sign a one-time message to prove the wallet is yours; that's your sign-in. From then on, your progress is saved to the cloud per wallet, so your valley follows you wherever you log in.

Heads up

New to Phantom? Install the Phantom browser extension, create a wallet, then switch the network to Devnet in Phantom's settings. You can grab free test SOL from a devnet faucet, none of it is real.

Just want to look around?

Click Spectate, no wallet required. You'll roam the Plaza and the gather map with a free camera, watching the world (and other players) go by. It's the easiest way to get a feel for the valley before you commit.

Spectate now →


Controls

Movement is built for both keyboard and touch, pick whatever's comfy.

  • Move: W A S D or the arrow keys, or simply click-to-move where you want to go.
  • Action: Space to interact, fish, talk to NPCs, gather, till, harvest, and confirm prompts. It also opens your storage chest, shipping bin, and house when you stand next to them.
  • Set Sail: at the water's edge a Set Sail button appears, click it, or press the rebindable Sail key (B by default), to launch your boat. While sailing near a shore, a Go Ashore button appears to land.
  • Decorate: at your home plot, a Decorate button opens the decor editor for placing home decorations (see Home & decor).
  • Zoom: scroll the mouse wheel to pull the camera in and out.
  • Touch devices: an on-screen joystick and an action button appear automatically, no keyboard needed.
Tip

The action key is context-aware: stand near water and it casts a line; stand by a crop and it harvests; stand by an NPC and it opens a chat. Walk up, tap Space, see what happens. To sail, though, you'll want the Set Sail button or the B key.


The world

The valley is made of a few distinct areas you'll travel between as you play.

The Plaza

The social hub. Market stands, the auction house, a Boat Shop on the south shore by the docks, a Home & Garden shop, a pond, and crowds of other players. Most journeys start here.

Your Home Plot

Your private farm and animal pen. Till and plant the land, raise livestock, and sell produce from the shipping bin.

Stonebrook Hollow

The gather map. Forage wood, stone, fibre, clay, coal, herb, plus iron ore and gemstones for crafting.

The Open Sea & Islands

Sail out across open water to four islands, the Cove, the Reef, and the Ruins, where the rarest fish live, plus Sundune, a huge desert island far to the south, home of the Crystal Bazaar.


Farming & ranching

Crops

On your home plot you'll till the soil, plant seeds, water them, and come back to harvest when they're grown. Watered crops grow faster, so keep your rows topped up. Each planted tile shows a countdown timer, watch it tick down to Ready.

Don't let it rot! A ripe crop left in the ground too long (more than 12 hours past ripening) will rot away, the plant wilts brown and the harvest is lost, freeing the soil to replant. The timer warns you how long until it spoils. Equip the Plow for a chance to recover seeds when you harvest in time.

Animals

Raise a cow, chicken, sheep, and pig in your pen. The key rule: animals must be fed before they'll produce, and they eat crops you grow on your own farm. Chicken, sheep, and cow eat grass; pig eats turnips. So grow grass and turnips alongside your other crops to keep the pen fed. A fed cow gives milk, a fed chicken gives eggs, a fed sheep gives wool, and so on. Hungry animals produce nothing.

Chicken → Eggs Cow → Milk Sheep → Wool Pig → Truffles
Rare find

A rare Dragon Hatchling can join your pen too, bought at Sundune's Crystal Bazaar for crystal. It eats grass like the others, and sheds prized Dragon Scales.

The shipping bin

Drop crops and produce into the shipping bin to sell them for Gold. It's the steady, reliable way to turn your farm into income while you're off doing other things.

Daily login reward

Log in each day to claim a daily reward, gold plus the occasional seed bundle. Keep a streak going and the rewards escalate over the week to a day-7 jackpot, then cycle. Miss a day and the streak resets, so pop in daily!

Tip

Feed your animals before you head out fishing or sailing, they'll have produce waiting for you when you get back.


Home & decor

Upgrade your house

Your home grows with you. Upgrade your house through four tiers, Cottage → Log Cabin → Stone Farmhouse → Crystal Villa, at the Home & Garden shop in the Plaza, or by clicking your house at the home plot.

Each upgrade now grants real advantages that stack as you climb the tiers: +5-15% sell gold, faster crop growth, and faster animal produce. Worth the investment.

Builds take time. Starting an upgrade kicks off a 12-hour build, pay the gold + materials, then come back when it's done to move in. In a hurry? Burn $VXL to rush it: each 1,000 $VXL skips an hour, and that $VXL is permanently burned (deflationary, it leaves the supply for good). Pick how many hours to skip and approve the burn in your wallet.

Cottage Log Cabin Stone Farmhouse Crystal Villa

Place decor

Buy placeable decor, lamp posts, benches, flower beds, fountains, gnomes, topiary, and more, at the same Home & Garden shop. Then head home and hit the Decorate button to open a simple editor: pick an item, a ghost preview shows where it'll land, and you click to place it. A Remove tool picks pieces back up whenever you fancy a rearrange.

Tip

Decor is yours to move around freely, experiment with layouts, then pull pieces back up with the Remove tool and try again.


Fishing & the Fishdex

Fishing is a two-phase minigame. First you cast your line and wait for a bite; then comes the reel / drill phase, where you fight to land the catch. Nail it and the fish is yours.

39 species, six rarities

There are 39 species to catch, spanning rarities from Common all the way to Mythic. Where you fish matters:

  • Legendary fish appear only at the island regions, the Cove, the Reef, and the Ruins.
  • Mythic fish appear only at the Ruins, and they are very rare, a genuine long-haul chase.
  • Sundune is not a fishing island, it's the desert bazaar and sunstone spot, not a place to cast a line.

Fishing rods, boost your luck

A better rod raises your odds of rare catches and makes the reel-in easier. There are four tiers, each with a distinct look in your hands:

  • Cane Pole, the starter rod.
  • Sturdy Rod, craft it at a Workbench (+10% rare-catch luck).
  • Angler's Rod, buy with gold at the Boat Shop's Rods tab (+20%).
  • Mariner's Rod, the top rod, bought by burning $VXL at the Boat Shop (+30% luck and a much easier reel-in; glowing tip).

Equip rods at the Boat Shop's Rods tab. The luck stacks on top of the location bonus, so the best rod at the Ruins on a full moon is the optimal Mythic-hunting setup.

Common Uncommon Rare Epic Legendary Mythic

The Fishdex & the Master Angler's Crown

Every species you catch is logged in your Fishdex. Catch all 39 to complete it and earn the exclusive Master Angler's Crown, the ultimate bragging right for completionists.

River Carp
CommonRiver Carp
Reef Angelfish
RareReef Angel
Crystal Leviathan
LegendaryLeviathan
Abyssal Serpent
MythicAbyssal Serpent
Tip

Want the rarest catches? You'll need a boat. Common and Uncommon fish are everywhere, but Legendary and Mythic only surface out at the islands, see Sailing & islands.


Sailing & islands

To reach the rare-fish waters, you'll need a boat. Build your first boat at the Boat Shop, a storefront on the south shore of the Plaza, then walk to the dock, where you actually set sail (click Set Sail or press B). The Boat Shop is where you build, upgrade, and skin your boat; the dock is just the launch point.

Set out across the open sea to the four islands, the Cove, the Reef, the Ruins, and Sundune. When you're sailing near a shore, a Go Ashore button lets you land and explore on foot.

Island foraging

Once ashore, you can gather each island's signature resource on foot. These feed exclusive island crafts (see Gathering & crafting).

  • Cove → coconuts
  • Reef → coral
  • Ruins → relic shards
  • Sundune → sunstone
  • Rare pearls can also turn up at the water islands.

Sundune & the Crystal Bazaar

Sundune is a huge desert island far to the south. Its Crystal Bazaar trades exotic goods for rare materials, crystal and gemstone rather than Gold. Stock includes a Dune Dragon mount, desert outfits, and the rare Dragon Hatchling farm animal.

Boat skins

Boat skins are purely cosmetic, they change how your boat looks, not how it sails. Craft them at the Boat Shop, and equip owned skins either there or in your Wardrobe → Boat tab (the wardrobe now has separate Character and Boat tabs).

Heads up

Mythic fish live only at the Ruins. If you're chasing a complete Fishdex, that's where the final, hardest catches are waiting. Sundune is for the bazaar and sunstone, not for fishing.


Gathering & crafting

Out in Stonebrook Hollow you'll gather raw materials: wood, stone, fibre, clay, coal, herb, plus the more valuable iron ore, gemstones, and the top-tier crystal. Bring them back and turn them into useful things at tiered crafting stations.

Equip a tool

You carry one equipped tool at a time. Craft a tool, then open your Inventory and hit Equip (the tool also appears in your character's hand). The equipped tool decides what you can gather and gives a yield bonus, with no tool equipped you can still gather the basics (wood, stone, clay, fibre), but none of the rarer materials. Swap tools to switch jobs:

  • Stone Pickaxe → mine iron ore (+1 stone).
  • Iron Pickaxe → mine gemstones (+1 stone).
  • Gem Pickaxe → mine crystal, the top-tier material (+2 stone).
  • Stone Axe → fell hardwood (+1 wood).
  • Iron Axe → the best wood yield (+2 wood, plus hardwood).
  • Plow → a farming tool: harvesting has a chance to return the crop's seed for a free re-plant.

Bench

The starter station. Makes planks, rope, tools, and backpacks (more inventory space).

Smelter

Combines ore + coal into iron bars, plus bricks and glass for bigger builds.

Workshop

Crafts lanterns, furniture, barrels, and decor to dress up your space.

Jeweler

Refines a gemstone → polished gem → gem ring, and forges the Gem Pickaxe, the high-end crafting chain.

Endgame & island crafts

The deepest crafts reward your rarest materials and your island travels:

  • Gem Pickaxe (at the Jeweler), the tool that unlocks crystal mining.
  • Crystal Knight armor set, a helm and armor crafted at the Workshop, both needing crystal.
  • Exclusive island crafts made from forage, the Castaway Totem, Relic Idol, and Mariner's Ring.
Tip

Craft a backpack at the Bench early, more inventory slots make gathering trips far less fiddly.


Economy & currencies

There are three currencies in VoxelValley, and they each do a different job. The big one to remember: Gold is what you spend in shops, while $VXL powers the auction house.

Gold The in-world currency

Earned just by playing, selling crops, produce, fish, and crafts at the shipping bin. It's what you spend on cosmetics, supplies, and almost everything in the shops. Since the auction house runs on $VXL only, Gold is effectively a player-traded commodity too: you can list Gold on the auction and sell it for $VXL.

$VXL The auction & reward token

$VXL is earned through play, there's a testing faucet, and you get a small bonus when you sell fish NFTs. Crucially, $VXL is also what you spend to bid on and buy listings at the auction house. So you both earn it and spend it.

SOL Devnet test SOL

The SOL in your wallet is plain devnet test SOL, no real money. It's used for on-chain gas and signing, but it is not used to buy Gold and it's not the marketplace currency; the auction house settles in $VXL.


Auction house

The auction house in the Plaza is a player-run marketplace. List your catches, crops, crafts, even Gold, as timed ascending auctions, and let other players bid them up. Everything is bid on and bought with $VXL.

Fees & payout

A flat 5% sale fee applies, all in $VXL, split as:

  • 2% to the treasury.
  • 3% directed to a $VXL buyback-and-burn.
  • Sellers net 95% of the final sale price in $VXL.

Fish NFTs

Your best catches become real, ownable collectibles. Epic, Legendary, and Mythic fish mint to your wallet (on devnet) as compressed NFTs (cNFTs), which are far cheaper on-chain than regular NFTs. Everything else stays in your regular inventory. In the Vault, each fish shows a cNFT/NFT badge that links straight to the Solana explorer.

The Fish NFT Vault

Open the Fish NFT Vault to manage your minted catches. From there you can:

  • Sell a fish for Gold, plus a small $VXL bonus.
  • Trophy trades, burn rare fish for exclusive angler cosmetics you can't buy any other way:
    • 3 Epic → Tidecaller Cap
    • 5 Epic → Angler's Chain
    • 2 Legendary → Leviathan Crown
    • 3 Legendary → Coral Cape
  • 3 Mythic → a rideable mount.

Selling and trophy trades both burn the fish, and every burn is verified on-chain, so a traded-away catch really is gone.

Note

Selling or trading a fish NFT is permanent. If you're going for a complete Fishdex, the catch is already logged the moment you reel it in, burning the NFT later doesn't un-log it.


Cosmetics, mounts & companions

Wardrobe

Customize your character with a wardrobe of hats, outfits, and accessories, and pick a boat skin from the dedicated Boat tab. Most items are bought with Gold; some are premium or earned through play.

Mounts

Rideable mounts let you roam the valley in style. There's a pony, frog, and snail bought with Gold; a premium alpaca and dragon via your wallet; and Sundune's Dune Dragon from the Crystal Bazaar. You can also earn a mount through the trophy trades, for example by trading 3 Mythic fish (see Fish NFTs).

Companions

Companions are little pets that follow you around, and each carries a buff. Depending on the pet you might get better selling, faster gathering, gather luck, or faster crop growth. You can get them via Gold, crafting, achievements, or as premium wallet NFTs.


Social & multiplayer

VoxelValley is a living, shared world, you'll see other players going about their day.

  • Live players: see others in real time in the Plaza and Stonebrook Hollow, complete with their names and custom looks.
  • World Chat: a global chat channel to talk with everyone online.
  • Emotes: express yourself with quick emotes.
  • Leaderboard: climb the ranks for Gold, Fishdex completion, and rare catches.
  • Visit neighbours: take read-only tours of other players' home plots.

Web3 details

VoxelValley runs on Solana devnet and uses Phantom for sign-in. Here's what's actually on the blockchain versus what lives off-chain.

On-chain

The $VXL token, your fish cNFTs (and their burns), and $VXL settlement on the auction house.

Off-chain

Your game save, farm, inventory, Fishdex progress, is stored in the cloud, keyed to your wallet.

Reassurance

This is a devnet demo. Everything uses test SOL, there is no real money at stake. Connect freely and experiment.


FAQ

Do I need a wallet?

To play and save progress, yes, connect Phantom on devnet. To just watch, no, hit Spectate and roam with a free camera, no wallet needed.

Is this real money?

No. It's a Solana devnet build using test SOL only. Nothing here costs or pays out real money.

How do I get Gold fast?

Sell your crops, produce, fish, and crafts at the shipping bin, and trade on the auction house, you can even list Gold there for $VXL, or sell other goods to build up a stash.

Where are boat skins?

At the Boat Shop on the Plaza's south shore, craft them there and equip them at the shop or in your Wardrobe → Boat tab. They're cosmetic only.

How do I set sail?

Build a boat at the Boat Shop, then stand at the dock (water's edge) and click Set Sail or press B. While sailing near a shore, a Go Ashore button lets you land.

How do I place decor?

Buy decor at the Home & Garden shop, head to your home plot, and hit the Decorate button. Pick an item, a ghost preview shows where it'll go, then click to place, and use the Remove tool to pick pieces back up.

How do I get rare fish?

Sail to the islands. Legendary fish appear only at the island regions (Cove / Reef / Ruins), and Mythic appear only at the Ruins, and they're very rare.

What can I do with $VXL?

Spend it on the auction house. $VXL is the marketplace currency, you bid on and buy listings with it. You earn it through play (a testing faucet, plus a small bonus when you sell fish NFTs).

How do I complete the Fishdex?

Catch all 39 species. You'll need a boat to reach the islands for the Legendary and Mythic tiers. Finish it to earn the Master Angler's Crown.

My animals aren't producing anything?

They need to be fed first, and they eat crops you grow. Chicken, sheep, and cow eat grass; pig eats turnips. A hungry animal won't give eggs, milk, or wool, so grow grass and turnips to keep them fed.

Ready to dig in?

Jump in now, or watch a while first, no wallet needed.