Documentation
Everything you need to know about farming, earning, and claiming in CozyFarm.
What is CozyFarm?
CozyFarm is a multiplayer isometric farming game rendered in true 3D with voxel-style visuals. Players roam a shared persistent world, buy land parcels, plant and harvest crops, and earn real devnet SPL tokens for their harvest.
The game runs on a server-authoritative architecture — your farming progress is real and persisted, crops grow even while you're offline, and multiple players share the same world in real time.
How to Play
Getting Started
- Jump in — No wallet needed. Pick a character from 18 voxel variants, choose a display name, and you're in the world.
- Buy a parcel — Click an unowned tile and purchase it for 0.05 SOL. This is your farmland.
- Plant a crop — Select your parcel, choose a crop type, and spend tokens to plant. Crops grow on real-time timers.
- Harvest — When your crop is ready, click to harvest and collect your token reward.
- Expand & upgrade — Buy more parcels (up to 5), upgrade to coops, or customize with cosmetic themes.
Core Loop
Crops grow on absolute timers — even when you're offline. Come back to a ready harvest.
Crops
Four crop types with different effort/reward profiles. Faster crops are cheaper and earn the most per hour — but only if you replant constantly. Longer crops cost more upfront and earn less per hour, but are nearly hands-off.
Wheat
Quick and cheap. Best for active farmers who can replant often.
Corn
Balanced option. Good returns without constant attention.
Pumpkin
Set it and forget it. Higher risk, higher per-harvest payout.
Bamboo
The long game. Biggest single payout for patient farmers.
Land & Upgrades
Parcels
Every parcel costs 0.05 SOL to purchase. You can own up to 5 parcels. Each parcel must be maintained weekly or it degrades and eventually gets abandoned.
Chicken Coop
Convert a farm parcel into a chicken coop for 1,000 tokens. Coops generate 240 tokens/daypassively — no planting or harvesting needed. The tradeoff: you lose that parcel's farming capacity and maintenance doubles to 100/week.
Cosmetic Themes
Customize your parcels with visual themes. Cosmetics are permanent but increase your weekly maintenance cost.
Tokenomics
Two-Token System
CozyFarm uses two tokens that work together: an in-game token (CROP) for gameplay, and a PumpFun token (PFT) that represents real tradeable value.
- Inflationary — minted on withdrawal
- Real SPL token on Solana devnet
- Earned through farming & coops
- Spent on planting, maintenance, upgrades, cosmetics
- Withdrawable to your wallet
- Fixed supply — 1 billion total
- Real SPL token on PumpFun
- Obtained by burning CROP
- Tradeable on open market
- The “cash-out” layer
How It Works
Gameplay runs on a fast off-chain ledger. The blockchain is only touched when you withdraw or redeem — keeping the game responsive while keeping tokens real.
Emissions & Economy
Earning Rates
Net earnings per crop type, assuming 5 active plots with continuous replanting:
| Crop | Cycle | Net per harvest | CROP / hour (5 plots) |
|---|---|---|---|
| Wheat | 2 min | +14 | 2,100 |
| Corn | 10 min | +55 | 1,650 |
| Pumpkin | 30 min | +135 | 1,350 |
| Bamboo | 2 hrs | +420 | 1,050 |
Token Sinks
Every token earned has places to go. These sinks keep the economy balanced by removing CROP from circulation:
| Sink | Cost (CROP) | Type |
|---|---|---|
| Planting seeds | 6 — 180 | Per action |
| Parcel maintenance | 50+ | Weekly recurring |
| Coop upgrade | 1,000 | One-time |
| Cosmetic themes | 200 — 750 | One-time |
| Character change | 50 | Per change |
Redemption: CROP → PFT
Burning CROP gives you PFT from the treasury at a rate that decreases as the treasury depletes — early redeemers get the best rate.
PFT received = CROP burned × 10 × (treasury remaining / treasury initial)| Treasury remaining | Rate (PFT per 1 CROP burned) |
|---|---|
| 100% (full) | 10.0 |
| 75% | 7.5 |
| 50% | 5.0 |
| 25% | 2.5 |
| 10% | 1.0 |
The treasury can never fully drain — the rate approaches zero asymptotically. No cliff, no “sorry, treasury is empty” moment.
Redemption Gates
Safety mechanisms that protect the treasury and keep the economy sustainable:
The 1% daily cap ensures the treasury lasts months regardless of player count. Heavy redemption days just mean each redeemer gets a smaller share of the daily cap.