🌱 Welcome to Farville!

Farville is a cozy, strategic farming game where you plant seeds, harvest crops, and collaborate with Farcaster friends to grow your dream farm. Your main loop looks like this:

Plant Seeds 🌾 – Choose from a variety of crops with different growth times and XP yields.
Boost Growth 🚀 – Use fertilizers or boosters to accelerate your crop production.
Harvest Crops 🌽 – Collect your ready crops to yield XPs and sell them to earn coins.
Sell or Donate 💰🎁 – Sell your crops in the market or donate to friends for rewards.
Complete Quests 📋 – Daily and weekly challenges give you extra XP and rewards.
Level Up ⬆️ – Unlock new crops and farmland expansions as you progress.
Stay Consistent 🔥 – Maintain your streak to earn bonus rewards and preserve momentum.
Flex on Farcaster ⚡ – Show off your rank, your streaks, your achievements, and more!

And the endgame..... 🥁🥁🥁

Compete 🏆 – Go on top of the Leagues (you can earn USDC on the Gold League!).

Whether you're a casual tapper or a farming fanatic, Farville offers something for everyone.

Now let’s dig deeper into the features!

📈 Game Progress

Level Up: Earn XP harvesting, donating, and from daily/weekly quests to level up your farm 🚀
Unlock new seeds: Start with common seeds, then unlock more complex ones as you level up. 11 seeds in total.
Farmland Expansions: Expand up to a 6×6 plot as you progress through levels.

ℹ️ For more details on leveling and expansions, check the Items & Progress section.

🌾 Farming Strategy

Choose your crops wisely based on growth times and rewards:

Short Seeds (Wheat, Carrot): 6h grow time ⏱️, low cost 💰, quick XP ⚡. Perfect for frequent visits!
Medium Seeds (Potato, Corn): 12h cycles, moderate cost, balanced XP/coin returns 💎.
Long Seeds (Pumpkin, Watermelon): 36–48h 🕰️, massive yields 🍉, ideal for larger farmland expansions 🌱.

This also depends on your playstyle:

Casual Farmer 🌱 – Plant short crops for quick XP and coins. Use boosters to speed up growth.
Competitive Farmer 🏁 – Focus on finishing quests and maximizing XP. Use long crops for high rewards and coins when you can’t do more quests.
Social Farmer 🤝 – Donate crops to friends for bonus XP and help them out. Use short crops to keep your farm active.

🏪 Market

Explore the marketplace where you can buy, sell, and expand your farming empire! 🌾💰

📱 Farcaster Social Interactions

The social features of Farville are designed to enhance your farming experience and foster a sense of community among players.

Key Interactions

Donate & Request: Within Farcaster, send or request crops and seeds to support fellow farmers 🤝
Flex Your Farm: Show off your streak, leaderboard rank, rare collectibles, and more to your followers 🔥

Teamwork makes the green dream work! 🌾

🎁 Donations

You can donate to farmers who request help in Farcaster. For each item you donate, you'll gain 5 XPs.

Donations have daily limits, which reset at 00:00 UTC. You can donate up to:

5 farmers per day 🧑‍🌾
2 times per farmer per day 🌽

These limits have been introduced to prevent farmers to climb the leaderboards by only donating.

📋 Daily & Weekly Quests

Every day, check your Quests log for fresh challenges:

Standard Quests: Plant 🌾, harvest 🌽 or sell surplus.
Social Quests: Donate or Receive seeds and crops 🎁.

And challenge yourself completing the Weekly quests which are more rewarding and difficult to achieve.

👉 Tip: Completing daily quests nets you extra XP and keeps you on track!

🧬 Quests Generation

Quests are generated pseudo-randomly each day and week, based on predefined types and completion amounts.

Structure

Players receive:
- 🗓️ 3 Daily Quests every day
- 📅 3 Weekly Quests every week
Quests are tied to a pool of possible crop tasks (e.g., plant, harvest, boost).
Amounts required vary within balanced ranges to fit casual and active playstyles.

League-Based Fairness

Quests are league-specific 🏆
- All players within the same league receive the same quests.
This ensures:
- A fair playing field 🟰
- Better competition among peers ⚔️

XP Reward Balancing

Quests with low-XP crops (🥕 carrots, 🌽 corns, 🥬 lettuces)
→ reward more XP.
Quests with high-XP crops (🎃 pumpkins, 🍉 watermelons)
→ reward less XP per unit.

💡 This balancing encourages players to diversify their crop usage, rather than focusing only on the most profitable ones. This means that if you farm the whole week pumpkins, without considering quests, you'll earn way less XPs.

🏆 Ranking

Compete with other players in weekly Leagues to climb the ranks and win juicy rewards! 🍓

🛡️ Leagues

Leagues are the competitive backbone of Farville, where players can showcase their skills and earn rewards.

They happen every week, and they're based on your level. Reach the top 50 players in your league to earn awesome prizes! 🏆

League Tiers

Wood League: Levels 5–9 🌱
Iron League: Levels 10–14 🔩
Gold League: Levels 15+ 🏅

Weekly Resets

Every week, your Green Thumbs (GT) score resets, keeping the competition fresh! 🍀

1 XP = 1 GT
XP adds to your permanent level
GT resets weekly for the leaderboard

Rewards

Top 50 players in each league earn sweet prizes!
- Wood & Iron: In-game items and boosters 🎒✨
- Gold: Rewards in USDC 💸

League-Synced Quests

All players in the same league get the same daily and weekly quests, so it's always a fair fight ⚔️ (see the quests generation section)

Pro Tips to Dominate

Start your week with crops ready to harvest 🚀
Crush your daily & weekly quests ✅
Use boosters and fertilizers as much as you can 🌾
Donate crops to friends for bonus XP 🤝

Let the farming frenzy begin! 🌻

👑 Leaderboards

There are two types of leaderboards in Farville:

Quests Leaderboard – Tracks how many quests you complete 📜
XP Leaderboard – Ranks players based on total XP earned ⚡

Each leaderboard comes in two flavors:

Global 🌍 – Compete with all Farville players
Friends 👥 – See how you stack up against your friends

Complete as many quests as possible and rack up that XP to climb the charts! 📈

Check if you’re leading your crew, catching up to rivals, or rising among the best farmers of Farcaster.

🔥 Streaks

Keep your farming habit strong with the Daily Streak system!

How it works: Each day, perform at least one of the following actions: Plant, Harvest, or Boost.
Rewards: Daily rewards grow from Day 1 to Day 28 📈, and then the cycle restarts. Don’t miss a day to keep climbing!
Streak Frosts:
- If you miss a day, a Frost ❄️ (if you have any) will be automatically applied to your streak.
- You can hold up to 2 Frosts at a time.
- You get the first Frost for free, and can buy more for 10,000 🪙 in the Streaks section.
Reset Time: Days reset at 00:00 UTC ⏰, so time your farming carefully!

🧑‍🌾 Harvest Honours

Show the world you're a true farming legend! 🌾

As you harvest crops, you unlock special achievements called Harvest Honours.
Each crop type has 4 badges you can earn by hitting key harvest milestones. 🏅
These badges are your bragging rights — flex them to show off your mastery of each crop!
Minting (coming soon) so you can take your honours onchain 🔗

Keep harvesting and start building your legacy! 💪🌱

🌟 Gold Crops

Gold Crops are the rarest and most exclusive crops in Farville. ✨

While you're casually harvesting, there's a tiny chance you'll discover a shiny Gold Crop! 🌾💫

Base chance: 0.001% per harvest
Boosted chance: +0.0025% for each Harvest Honour you've unlocked for that crop

So yeah, they’re crazy rare — but if you manage to find one...
🥇 Your status? Legendary.