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 risk/reward profiles. Faster crops are cheaper but earn less per hour. Longer crops require more upfront investment but yield higher returns.
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 120 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 | +10 | 1,500 |
| Corn | 10 min | +40 | 1,200 |
| Pumpkin | 30 min | +125 | 1,250 |
| Bamboo | 2 hrs | +450 | 1,125 |
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 | 5 — 150 | 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.