⭐ 31 — Mastery Stars

Mastery Stars are the long-term engagement system that rewards dedicated players for specialising in specific products, crops, and animals. There are two parallel mastery tracks: Store Mastery and Farm Mastery.


🏪 Store Mastery

Each display type earns mastery through total customer purchases from that display.

Mastery Level Purchases Required Bonus
⭐ 1 Star 100 purchases +5% coins per sale
⭐⭐ 2 Stars 500 purchases +10% coins, chance of bonus coins
⭐⭐⭐ 3 Stars 2,000 purchases +20% coins, exclusive display skin unlocked

Display Mastery Benefits Stack:

A Bread Shelf at 3-star mastery earns 20% more than a fresh Bread Shelf.
Combined with Farm Mode (+40%) and a Grand Sale campaign (+50%):
Total multiplier: 1.20 × 1.40 × 1.50 = 2.52× base value


🌾 Farm Mastery

Farm Mastery covers crops, animals, and processing buildings (detailed in 13-farm-mastery.md).

Farm Mastery Summary:

Track Metric 3-Star Requirement
Crops Harvests 300 per crop
Animals Collections 500 per animal
Buildings Jobs completed 500 per building

🌟 Combined Mastery Score

The Total Mastery Score combines store and farm mastery:
- 1 mastery star = 1 point
- Maximum possible stars: ~200 (70+ display types + 19 crops + 9 animals + 16 buildings) × 3 stars each

Mastery Rank Titles:

Score Title
0–25 Trainee Shopkeeper
26–50 Junior Manager
51–100 Store Manager
101–150 Senior Manager
151–200 Area Director
201–300 Regional Executive
301–400 Master Merchant
401–500 Grand Master
500+ Legendary Tycoon

🎨 Mastery Skins

Reaching 3-star mastery on a display unlocks an exclusive display skin — a visual reskin that makes the display look premium/themed.

Display 3-Star Skin
Bread Shelf Artisan Bakery Display
Wine Rack Crystal Wine Cellar
Luxury Fashion Gold-Trimmed Boutique
Royal Feast Counter Royal Banquet Table
Beer Fridge Craft Brewery Tap Wall
Perfume Display Jewelled Perfume Cabinet

📈 Mastery XP Acceleration

Higher mastery levels also speed up future leveling:
- Each 3-star display: +2% XP from all customer purchases
- Each 3-star crop: +1% XP from all harvests
- Full Farm Mastery (all 3 stars): +50 FT bonus per day
- Full Store Mastery (all 3 stars on all displays): +5% all coin earnings permanently


🏆 Mastery Achievements

Achievement Requirement Reward
Star Pupil First display at 1 star 50 XP
Five Star Store 3 stars on 10 displays 1,000 XP + 5 Cash
Master Farmer 3 stars on 10 crops 500 XP + 50 FT
Old MacDonald All 9 animals at 1 star 300 XP + 30 FT
Supply Chain King 5 farm-stocked displays at 2+ stars 800 XP + 10 Cash
Legendary Tycoon Total mastery score 500+ 10,000 XP + 50 Cash