MonadCity: Son Entropi Kalkanı

"Antigravity titriyor. Ağ zorlanıyor. Seçim senin."

MonadCity, Monad Ağı'nın kavramsal çerçevesi üzerine inşa edilmiş, gerçek zamanlı, hikaye odaklı, siberpunk bir toplum simülasyonudur. Yapay zeka destekli hikaye anlatımını (OpenAI GPT aracılığıyla) estetik, etkileşimli bir React arayüzü ile birleştirerek 2099 yılındaki dijital bir metropolün hayatta kalma mücadelesini simüle eder.

Oyuncular şehrin kaynaklarını yöneten, temel toplumsal direkleri dengeleyen ve "Büyük Entropi" adlı acımasız kozmik güce karşı kritik kararlar alan Mimar (The Architect) rolünü üstlenirler.

---

📖 Hikayenin Arka Planı (The Lore)

Yıl 2099. Fiziksel dünya, "Büyük Entropi" adı verilen kozmik bir bozulma nedeniyle çöktü. İnsanlık hayatta kalmak için ortak bilincini Antigravity adındaki devasa bir süper bilgisayara yükledi.

Bu dijital sığınakta zaman normalden binlerce kat daha hızlı akıyor.

Şehri kaosa sürüklenmekten koruyan tek şey, saniyede on binlerce paralel işlemi yürütebilen Monad Ağı. Milisaniyelik bir gecikme bile tam bir yok oluş anlamına geliyor. Entropi (Kader Motoru / GPT ile temsil edilir), doğal afetler, dijital virüsler, vatandaş isyanları ve ekonomik çökmelerle şehre sürekli saldırıyor.

Sen sadece bir oyuncu değilsin; sen Mimar'sın. Cüzdanınla imzaladığın her karar bu dijital gerçekliği büküyor. Para birimin BLITZ (Güç)—Ağı ayakta tutmak, dijital kalıntıların (vatandaşların) akıl sağlığını korumak ve sistemin çökmesini engellemek için onu akıllıca kullan.

---

🌟 Temel Özellikler

1. Güç Ekonomisi (Blitz Sistemi)

Eski "bütçe" sistemi artık yok. Ağa bağlanmak için 5 MON ücret ödedikten sonra 5000 BLITZ ile başlıyorsun. Verdiğin her kararın bir BLITZ bedeli var. Dahası, her gün Altyapı verimliliğine ve Milli İradeye (Vatandaş Mutluluğu) bağlı olarak pasif BLITZ üretirsin. Canlı Akışı İzle: Mimar olarak canlı işlemler menüsünden vergilerden, lisans ücretlerinden ve anonim vatandaş bağışlarından sürpriz BLITZ kazanabilirsin!

2. Yapay Zeka Destekli Kader Motoru

Antigravity simülasyonundaki her "Gün", GPT-4o-mini kullanılarak yapay zeka tarafından oluşturulan bir olayı tetikler. Bu olaylar distopik hikayeyle derinden bağlantılıdır. Sana 3 farklı stratejik seçenek (Alfa, Beta, Gama) sunulur. "Kusursuz" bir seçenek yoktur—her kararın Gücünü, Mutluluğunu, Güvenliğini, Sağlığını ve Altyapını etkileyen bedelleri vardır.

3. Canlı 100 Vatandaş Simülasyonu

Şehir, isimleri, meslekleri ve sektörleri olan özenle oluşturulmuş 100 "Dijital Kalıntı" (Vatandaş) ile doludur.

• Duygu Senkronizasyonu: Şehrin genel mutluluğu, bu 100 vatandaşın bireysel mutluluğuna doğrudan bağlıdır.
• İnteraktif Harita: Nüfusunun durumunu gerçek zamanlı incelemek ve Vatandaşlar Panelini açmak için radardaki parlayan VATANDAŞLAR düğümüne tıkla.

4. Dinamik Canlı İşlemler (Action Feed)

Gerçek zamanlı işlem akışı, dijital ajanlar (örn. The Sentinel, The Oracle, The Forge) ile vatandaşlar arasındaki simüle edilmiş etkileşimleri gösterir. Bu canlı akış oldukça çeşitlidir ve özel olaylar, vergi kesintileri, ağ güncellemeleri ve Mimar ile vatandaşlar arasındaki ticaret işlemleri gibi sürpriz ticaretleri barındırır.

5. Sonsuz Liderlik Tablosu

Sahip olduğun anlık BLITZ gücüne göre yapay zeka tarafından üretilmiş sahte oyuncularla (ve kendinle) küresel sıralamada yarış.

---

🛠️ Teknoloji Yığını

• Frontend: React, Vite, Tailwind CSS
• Backend: Node.js, Express, JavaScript
• AI Motoru: OpenAI API (GPT-4o-mini)
• Gerçek Zamanlı Veri: Canlı arayüz (İşlemler ve Radar) güncellemeleri için Server-Sent Events (SSE)

---

🚀 Kurulum ve Çalıştırma

1. Repoyu Klonla:

   git clone https://github.com/hsankc/MonadCity.git
   cd MonadCity

2. Backend Kurulumu (.env): Ana dizinde bir .env dosyası oluştur ve OpenAI Anahtarını ekle:

   OPENAI_API_KEY=senin_openai_api_anahtarin
   PORT=3001

3. Bağımlılıkları Kur: Biri backend, diğeri frontend için olmak üzere iki terminal aç.

   # Terminal 1 (Backend)
   npm install
   
   # Terminal 2 (Client)
   cd client
   npm install

4. Uygulamayı Çalıştır:

   # Terminal 1 (Backend'i Çalıştır)
   node backend/server.js
   
   # Terminal 2 (Frontend'i Çalıştır)
   cd client
   npm run build # (Opsiyonel: Client'ı derlemek istersen)
   npm run dev   # http://localhost:5173 adresinde çalışır

   Alternatif olarak, doğrudan backend sunucusu üzerinden kontrol paneline http://localhost:3001 adresinden erişebilirsin.

---

🎮 Nasıl Oynanır

1. Web3 bağlantısını simüle etmek için **"Cüzdan Bağla"**ya tıkla.
2. Antigravity motorunu başlatmak için "5 MON ÖDE VE SİMÜLASYONU BAŞLAT" butonuna tıkla.
3. İstatistiklerini gözlemle. Kader Motorunu tetiklemek için "SONRAKİ KADERE GEÇ" butonuna bas.
4. Gelen Entropi dalgasını oku ve 3 kart arasından bir karar ver. İlgili BLITZ bedelini öde.
5. Olabildiğince uzun süre hayatta kal. Herhangi bir temel istatistik (Mutluluk, Güvenlik, Sağlık, Altyapı) veya Gücün (Blitz) 0'a ulaşırsa Sistem Çöker!

---

Monad Ekosistemi için ❤️ ile geliştirildi.