# 🏙️ GridCity - Build Your Discord Economic Empire

**The most advanced city-building economy game for Discord.**

Transform from a humble 10x10 plot into a sprawling **20x20 metropolis** with
40+ unique buildings, complex resource chains, and infinite progression.
**Pure strategy. Deep gameplay. Endless possibilities.**

---

## ✨ Why GridCity Stands Out

### 🎮 Play Anywhere

**Discord Commands** - Manage your city without leaving your server

![Discord City View](https://gridcity.app/discord-city.png)

**Web Dashboard** - Beautiful visual interface at [gridcity.app](https://gridcity.app)

![Web City View](https://gridcity.app/web-city.png)

**Seamless Sync** - Your city, your choice of platform! Switch between Discord and web anytime.

### 💰 Passive Income That Actually Works
- Earn money while offline (up to 24 hours)
- Automatic resource production from 8 different buildings
- Collect every 30 minutes or let it stack
- **Never lose progress** - your city grows even when you sleep

### 🏗️ 40+ Buildings Across 8 Categories
- **Residential** - Houses, Apartments (population & income)
- **Commercial** - Shops, Department Stores (high earnings)
- **Industrial** - Factories, Machine Shops (resource processing)
- **Production** - Sawmills, Mines, Research Labs (5 resource types)
- **Infrastructure** - Schools, Hospitals, Fire Stations (city-wide bonuses)
- **Entertainment** - Theaters, Arcades (proximity boosts)
- **Culture** - Museums, Opera Houses (prestige buildings)
- **Special** - Town Halls, Monuments (game-changing multipliers)

### ⚙️ Resource Processing Chains
Produce AND transform resources through multi-tier crafting:
- 🪵 Wood → Lumber (Lumber Workshop)
- 🪨 Stone → Bricks (Brick Kiln)
- ⚙️ Steel → Machinery (Machine Shop)
- 💰 Gold → Jewelry (Goldsmith)
- 💎 Diamond → Cut Diamonds (Gem Cutter)

**Processing happens automatically during collection** - set it and forget it!

### 🌍 Dynamic Seasonal Economy
Real-world seasons affect your production:
- 🌸 **Spring**: +20% Wood, -20% Stone
- ☀️ **Summer**: +25% Gold, -15% Wood
- 🍂 **Autumn**: +30% Stone, -25% Steel
- ❄️ **Winter**: +40% Diamond, -30% Gold

**Adapt your strategy** to seasonal changes for maximum profit!

### 📜 NPC Contract System
Take on time-limited quests from NPCs:
- 🟢 **Easy Contracts** - Quick resource deliveries
- 🟡 **Medium Contracts** - Balanced challenges
- 🔴 **Hard Contracts** - Big risks, big rewards
- ⏰ **Deadlines** - Complete before time expires!
- 💰 **Rewards** - Money, resources, and achievement progress

### 🔄 Infinite Prestige Progression
Never hit a ceiling - **prestige for permanent bonuses**:
- Reset your city at Level 15 + $75,000
- Gain **+8% income FOREVER** (stacks infinitely)
- Keep your money, start fresh with compound growth
- Prestige 1 = +8%, Prestige 10 = +80%, **no limit!**

### 🏪 Player-Driven Marketplace
Safe trading with built-in escrow system:
- Trade resources OR money (not just one-way)
- **Wood for Steel**, **Gold for Cash**, anything!
- Escrow protection - items locked until completion
- Market analytics with 7-day price trends
- Volume metrics and trend indicators (↑↓)
- Max 5 active listings to prevent spam
- Donation system to help friends

### 🏆 8 Competitive Leaderboards
Climb the ranks in multiple categories:

1. 💰 **Net Worth** - Richest players
2. 💵 **Total Income Earned** - Lifetime earnings
3. 🏙️ **City Value** - Most valuable cities
4. 🏗️ **Building Count** - Largest cities
5. ⭐ **Level** - Highest experience
6. 🌟 **Prestige** - Most resets
7. 🏆 **Achievements** - Completionists
8. 📦 **Resources** - Resource hoarders

**Top 3 get medals** 🥇🥈🥉 - **your rank always shows!**

### 🎯 Achievement System
Unlock **100+ achievements** across 6 categories:

- 🎯 Progression - City milestones
- 💰 Economy - Wealth goals
- 🏗️ Building - Construction challenges
- ⭐ Level - Experience tiers
- 🌟 Prestige - Reset rewards
- ✨ Special - Hidden secrets!

**Each unlock grants money rewards** - achievements pay you!

### 🎨 Beautiful Visualizations
See your city come to life:

- PNG rendering with emoji buildings
- Color-coded bonuses (purple = boosted)
- Detailed stat overlays
- Web dashboard with drag-and-drop building
- Real-time income calculations

### 🌍 Multi-Server System
Play in multiple Discord communities:

- **One city per Discord server**
- Different economies per server
- Server-specific leaderboards
- Compete with your local community

---

## 🚀 Core Features

✅ **12 Command Groups** - City, building, resources, trading, achievements, prestige, contracts, stats, leaderboards
✅ **Building Upgrades** - Level buildings 1-5 for increased output
✅ **Grid Expansion** - Grow from 10x10 to 20x20 (400 plots!)
✅ **Resource Cap System** - 10,000 per resource (collect or lose overflow)
✅ **Donation System** - Gift resources/money to friends
✅ **Detailed Statistics** - Track every aspect of your city
✅ **Income Breakdown** - See exactly where money comes from
✅ **Social Features** - View other players' cities, compare stats
✅ **Per-Guild Isolation** - Fresh economy per Discord server
✅ **Active Development** - Regular updates and new features

---

## 📈 Progression Path

### Early Game (Level 1-5)

Build your first houses and shops, learn resource production, unlock basic achievements

### Mid Game (Level 5-10)

Start processing chains, dive into trading marketplace, accept NPC contracts

### Late Game (Level 10-15)

Advanced buildings, market mastery, optimization for prestige

### Endgame (Level 15+)

Infinite prestige scaling, leaderboard competition, maximum income optimization

---

## 🎮 Getting Started

1. **Invite GridCity** to your Discord server
2. Run `/city` to create your first city
3. Use `/build` to place your first buildings
4. Run `/collect` every 30 minutes to claim income
5. Check `/leaderboard` to see where you rank
6. Visit **gridcity.app** for the visual dashboard

---

## 💡 Perfect For

- 🎮 Idle/incremental game fans
- 🏗️ City-building strategy lovers
- 📈 Economics simulation enthusiasts
- 🏆 Competitive Discord communities
- 🤝 Social gamers who love trading
- ♾️ Players who want infinite progression

---

## 🔥 What Players Love

> "The prestige system gives me a reason to keep playing forever!"

> "Trading with my server friends makes this feel like a real economy"

> "Seasonal production changes keep the strategy fresh"

> "Love that I can play in Discord or switch to the web dashboard"

> "NPC contracts add a fun quest layer on top of city building"

---

## 🎯 Ready to Build Your Empire?

**Start your journey from zero to economic domination.**

Whether you're playing casually or competitively, GridCity offers endless strategic depth.
Invite the bot to your Discord server and begin building your metropolis today!

🏙️ **Build. Earn. Dominate.** 🏙️

GridCity

Build your Discord city empire! 40+ buildings, resource chains, trading, prestige system. Earn passive income. Play now! 🏙️

Voting for GridCity

Do you want to support us?