İNDİR 1 İNDİR 2 İNDİR 3
Çılgın Sultan Papağanı (3D Horror), nostaljik VHS Found Footage (Buluntu Film) estetiğine sahip, gerilim ve hayatta kalma temalı, Three.js ve Electron altyapılı 3D bir korku oyunudur.
Oyunun hikayesi, oynanış mekanikleri, bölümleri ve teknik altyapısının detaylı açıklaması aşağıdadır:

1. Genel Konsept ve Hikaye (Lore)
Oyun, 1998 yılına ait gizemli bir VHS kasetin oynatılmasıyla başlar. Oyuncu olarak, devasa bir sultan papağanının istila ettiği terk edilmiş, karanlık bir şehirde hayatta kalmaya çalışan bir kurbanı (Adam veya Kadın karakterini seçerek) yönetiyorsunuz. Oyundaki amacınız, dev sultan papağanına yem olmadan şehirdeki güvenli bölgelere sığınmak ve kaçmaktır.
Ancak oyunun sonunda oyuncuyu büyük bir ters köşe (plot twist) beklemektedir.

2. Bölümler ve Oynanış Aşamaları
Oyun toplamda 6 ana bölümden (Level) oluşur ve her bölümün kendine has bir teması ve mekaniği vardır:
Bölüm 1: Sokak Karşılaşması (Sokak Keşfi)Amaç: Zifiri karanlık sokaklarda yavaşça ilerleyerek güvenli bir sığınak aramak.
Mekanik: Dev sultan papağanı sokaklarda gezinir. Yaklaştığında kalp atış ritminizi dengelemek için ritim oyununu (Space tuşuna basarak) doğru zamanlamayla oynamalı ve çöp konteynerleri gibi gizlenme noktalarına saklanmalısınız.
Bölüm 2: Süpermarket Sığınağı (Bulmaca ve Görevler)Amaç: Markete sığındıktan sonra market müdürünün verdiği görevleri tamamlamak.
Mekanik: Etraftan konserve mama, süt kutusu gibi ürünleri toplamak, asit sızıntılarını temizlemek ve gücü geri getirmek için elektrik kutusundaki kabloları eşleştirdiğiniz Kablo Bağlama Yapbozu‘nu çözmek. Bölümün sonunda dev papağan market duvarını yıkarak içeri girer!
Bölüm 3: Bisikletle Kaçış (Otoban Aşaması)Amaç: Kaçış bisikletinizi seçip (Bianchi Dağ, Salcano Yol veya Bisan Şehir) otoparka ulaşmak için otobanda son sürat ilerlemek.
Mekanik: Karşıdan gelen trafik arabalarından ve engellerden kaçarak bisikletle şerit değiştirip yol almak. Papağan havadan sizi kovalar.
Bölüm 4: Kapalı Otopark (Jeneratör Aşaması)Amaç: Otopark kapısını açmak için yedek jeneratörü çalıştırmak.
Mekanik: Geniş otoparkta dev kuşa yakalanmadan gizlenerek Akü, Buji ve Yakıt Bidonu parçalarını bulup jeneratöre yerleştirmek.
Bölüm 5: Taksi ve Ters Köşe FinalAmaç: Otoparktan kaçtıktan sonra caddede bekleyen çalışan bir taksiye binmek.
Mekanik: Taksici sizi arabaya alır ve diyaloglar başlar. Taksici size “Bu dev kuş aslında vahşi bir canavar değil… Sadece benim Cici Kuş’um… Kafesinden kaçtığından beri çok acıktı ve en sevdiği yiyecek sensin!” dediği anda dev kuş ön camdan arabaya saldırır.
Bölüm 6: Kaset Sonu ve ZaferAmaç: Hikayenin acı sonla bittiğini gösteren VHS kesintisi sonrası, kazandığınız parlak 3D kupayı (Trophy) döndürerek izlemek.

3. Görsel Tasarım ve Atmosfer (Aesthetics)
VHS Filtresi: Ekranda sürekli oynayan parazitler (glitch), analog TV tarama çizgileri (scanlines) ve renk kaymaları (chromatic aberration) ile tam bir 90’lar VHS kaset havası verilir.
Retro Matrix Yeşili: Arayüzler (HUD), batarya göstergeleri ve sanal kumanda gibi tüm modern paneller parlak neon yeşili çerçeveler ve cam efektiyle (glassmorphic) tasarlanmıştır.
Karanlık ve Gerilim: Düşük sis, sınırlı kamera ışığı (fener bataryası mekaniği vardır) ve ani ses efektleri gerilim seviyesini yüksek tutar.

4. Teknik ve Donanımsal Altyapı
Three.js (3D Motoru): Nesneler, binalar, yollar, karakterler ve dev kuş tamamen Three.js kütüphanesi kullanılarak tarayıcı üzerinde 3D olarak çizilir.
Electron: Oyunun masaüstünde çift tıklamayla çalışabilen bir masaüstü uygulaması (.exe) olmasını sağlar.
Prosedürel Dokular: Boyutun küçük olması ve hızlı yüklenmesi için asfalt, tuğla duvar ve beton gibi dokular resim dosyası indirmek yerine kodla dinamik olarak (canvas üzerinde) üretilir.
Dokunmatik Desteği (Yeni): Eklenen sanal joystick ve retro eylem butonları sayesinde oyun artık tablet veya telefon gibi dokunmatik cihazlarda da tamamen oynanabilir durumdadır. Eğer telefondan oynayacaksanız İndex.html dosyasından açınız.

YENİ README DOSYASI (KLASÖRDEKİ ESKİDİR…)

# 🦜 ÇILGIN SULTAN PAPAĞANI: 3D Horror Game

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![Three.js](https://img.shields.io/badge/Three.js-r128-green.svg)](https://threejs.org/)

[![Electron](https://img.shields.io/badge/Electron-v25.3.0-blue.svg)](https://www.electronjs.org/)

**Çılgın Sultan Papağanı**, nostaljik **VHS Found Footage (Buluntu Film)** estetiğine ve yoğun gerilim atmosferine sahip 3D hayatta kalma-korku oyunudur. Devasa bir sultan papağanının istilası altındaki karanlık bir şehirde, gizemli bir video kasetin kaydettiği korku dolu anları yaşayın!

—

## 🚀 OYUNU HEMEN OYNAMAK İÇİN (QUICK PLAY)

Eğer bu klasörü direkt olarak indirdiyseniz ve oyunu kurmadan hemen oynamak istiyorsanız şu adımları izleyin:

1. **`dist`** klasörüne girin.

2. **`CilginSultanPapagani-win32-x64`** klasörüne girin.

3. İçindeki **`CilginSultanPapagani.exe`** dosyasına çift tıklayarak oyunu hemen başlatın!

*(Not: Oyunu oynamak için Node.js yüklemenize veya kurulum yapmanıza gerek yoktur, direkt EXE dosyasından açabilirsiniz.)*

### 📱 Telefon veya Tabletlerden (Mobil) Oynamak İçin:

*   Mobil cihazlarda `.exe` dosyası çalışamayacağı için oyunu web tarayıcısı üzerinden çalıştırmanız gerekir.

*   Bunun için projenin ana dizininde bulunan **`index.html`** dosyasını doğrudan mobil tarayıcınızla açabilir veya tüm klasör yapısını koruyarak bir web sunucusuna (GitHub Pages, itch.io, Netlify vb.) yükleyip cep telefonunuzdan giriş yapabilirsiniz.

*   Oyun dokunmatik bir cihaz algıladığında **sanal kumanda (joystick & butonlar) otomatik olarak aktif olacaktır.**

TELEFONDA DOSYA AÇILMAZSA YADA BOZUK ÇIKARSA BU YÖNTEMİ UYGULAYIN

Telefonun tarayıcısının güvenlik engelini aşmak için dosyaları telefonun içinde sanal bir sunucu olarak çalıştırmaktır.

  • Android Telefonlar İçin:
    1. Google Play Store’dan “Simple HTTP Server” veya “Web Server” araması yaparak ücretsiz bir uygulama indirin.
    2. Uygulamayı açıp oyun klasörünü (CilginSultanPapagani klasörünü) ana dizin olarak seçin ve “Start/Başlat” butonuna basın.
    3. Telefonun internet tarayıcısını (Chrome vb.) açıp uygulamanın verdiği adresi (genellikle http://localhost:8080 veya http://127.0.0.1:8080) yazın. Oyun sesleri ve grafikleriyle tamamen sorunsuz açılacaktır.
  • iOS (iPhone) İçin:
    1. App Store’dan “Web Server” veya “Local HTTP Server” benzeri bir uygulama indirip aynı adımları uygulayabilirler.

—

## 📼 Hikaye & Konsept

1998 yılına ait hasarlı bir VHS kayıt bandı kurtarıldı. Bantta, şehrin sokaklarında beliren devasa bir sultan papağanından kaçmaya çalışan bir kurbanın son anları kayıtlı. Şehir tahliye edilmiş, sokaklar karanlığa gömülmüş ve tek umudunuz gizlenerek kaçış yolları bulmak.

Ancak dikkat edin, sizi kurtaracağını sandığınız taksinin şoförünün gizlediği korkunç bir sır var…

—

## 🎮 Bölümler & Görevler

Oyun, kasetin ilerleyişini simüle eden **6 farklı bölümden** oluşmaktadır:

1. **Bölüm 1 (Sokak Karşılaşması):** Karanlık sokakları keşfedin, çöp konteynerlerine saklanarak dev papağandan kaçın ve kalp ritminizi dengede tutun.

2. **Bölüm 2 (Süpermarket Sığınağı):** Sığındığınız markette temizlik ve malzeme toplama görevlerini yapın, jeneratör kablolarını bağlayarak gücü açın.

3. **Bölüm 3 (Bisikletle Kaçış):** Bianchi, Salcano veya Bisan bisikletinizle otobanda engellerden kaçarak son sürat pedal çevirin.

4. **Bölüm 4 (Kapalı Otopark):** Otopark kapısını açabilmek için etrafa saçılmış Akü, Buji ve Yakıt Bidonu parçalarını toplayarak jeneratörü çalıştırın.

5. **Bölüm 5 (Taksi Kaçışı & Ters Köşe):** Otoyolda sizi alan bir taksi şoförüyle konuşun ve korkunç gerçeği öğrenin!

6. **Bölüm 6 (Kaset Sonu):** Hikayenin sonunu öğrenin ve kazandığınız 3D kupayı inceleyin.

—

## ⌨️ Kontroller

### 🖥️ Klavye & Fare Kontrolleri:

*   **W, A, S, D / Yön Tuşları:** Hareket Etme

*   **Fare Hareketi (Mouse):** Etrafa Bakma (Kamera Dönüşü)

*   **Sol Tık (Click):** Kamera kilidini etkinleştirir (Oyuna odaklanma)

*   **E / Space (Diyaloglarda):** Etkileşim (Kapı açma, kablo bağlama, diyalogu ilerletme)

*   **Space (Zıplama / Kalp Ritmi):** Zıplama yapma, kalp ritmi alanında çizgiyi yakalama

*   **Shift (Sol/Sağ):** Sessiz Yürüme (Papağanın sizi duymasını engeller)

*   **F / Sol Fare Tıkı:** Kamera Gece Görüş Işığı (Aç/Kapat)

*   **Q:** Kuş Yemi Fırlatma (Papağanın dikkatini dağıtmak için)

*   **ESC:** Oyundan Çıkış

*   **F11:** Tam Ekran Modu (Aç/Kapat)

### 📱 Mobil & Dokunmatik Kontroller (Sanal Kumanda):

*Dokunmatik bir ekran algılandığında veya tarayıcının mobil modu açıldığında retro neon kumanda otomatik belirir.*

*   **Sanal Joystick (Sol Alt):** 360 derece karakter hareketi.

*   **Ekran Kaydırma (Swipe):** Parmağınızı boş ekranda sürükleyerek etrafa bakma.

*   **SESSİZ Butonu (SHIFT):** Sessiz yürüme modunu açar/kapatır (Aktifken yeşil renkte yanık kalır).

*   **Q Butonu:** Kuş yemi fırlatır.

*   **F Butonu:** Kamera fenerini açar/kapatır.

*   **E Butonu:** Nesnelerle etkileşim kurar.

*   **JUMP Butonu:** Zıplama yapar veya diyalogları ilerletir.

—

## 🛠️ Teknik Özellikler & Altyapı

*   **Motor:** [Three.js](https://threejs.org/) (JavaScript WebGL kütüphanesi)

*   **Çerçeve:** [Electron](https://www.electronjs.org/) (Masaüstü uygulaması paketleme için)

*   **VHS Post-Processing:** Özelleştirilmiş renk kayması, VHS parazit çizgileri ve statik televizyon efektleri.

*   **Prosedürel Doku Üretimi:** Oyun boyutu optimize edilmiş olup; tuğla, beton, asfalt ve uyarı şeritleri gibi tüm çevre dokuları kod yardımıyla `HTML Canvas` üzerinde oluşturulmaktadır.

—

## 🚀 Kurulum ve Çalıştırma (YAPMANZA GEREK YOK)

Oyunu yerel bilgisayarınızda çalıştırmak için aşağıdaki adımları izleyin:

### Gereksinimler:

*   [Node.js](https://nodejs.org/) (Sisteminizde yüklü olmalıdır)

### Kurulum Adımları:

1. Proje dizinine terminal üzerinden geçiş yapın:

   “`bash

   npm install

   “`

2. Oyunu başlatın (Electron üzerinde çalışacaktır):

   “`bash

   npm start

   “`

3. Oyunu paketlemek (.exe haline getirmek) için:

   “`bash

   npm run pack

   “`

—

## 📄 Lisans

Bu proje **MIT Lisansı** altında lisanslanmıştır. Detaylar için `LICENSE` dosyasına göz atabilirsiniz.