Yakar Gol

EN: 5v5 neighbourhood football meets dodgeball, played from an over-the-shoulder camera in the browser (Three.js); bots fill empty seats, online rooms for up to ten players.

TR: Tarayıcıda (Three.js) omuz kamerasından oynanan 5v5 mahalle futbolu + yakar pas; boş koltukları botlar doldurur, çevrim içi odada on kişiye kadar.

Play / Oyna: https://yakargol.josephuz.com · Source / Kaynak: https://github.com/JosephUz/yakargol · Android: Google Play

Three.js ile tarayıcıda çalışan, omuz kamerasından oynanan 5v5 mahalle futbolu + yakar pas. Bir insan ve dört takım botu, beş rakip bota karşı; her takımda bir bot kaleci var. Webde çok oyunculu oynanır: oda kurulur, en çok on kişi istediği koltuğa oturur, boş koltukları botlar oynar (bkz. Çok oyunculu).

Başlatma

Baslat.cmd dosyasına çift tıklayın: gerekirse npm install yapar, sunucuyu açar ve oyunu tarayıcıda başlatır. Alternatif: bu klasörde npm install ve npm start, ardından http://127.0.0.1:5186. Node.js gerekir. Port değiştirmek için PowerShell'de $env:PORT=5187; npm start.

Docker ile (compose): docker compose up -d --build; oyun http://localhost:5186 adresinde (yalnızca bu bilgisayardan). docker compose down kapatır. Kaynak değişince yalnızca --build yeter, bağımlılık katmanı önbellekten gelir. Sunucu oyun dosyalarını no-store ile verir; /health yanıtındaki surum alanı ayakta olan yapının damgasıdır.

Yayın: oyun dosyaları Cloudflare Worker'da statik site olarak durur (npm run deploy:web, wrangler.jsonc → yakargol.josephuz.com). Evdeki PC yalnızca çevrim içi sunucudur (WebSocket odaları, çevrim içi sayısı).

Cloudflare Tunnel (yakargol-sunucu.josephuz.com): .env.example dosyasını .env olarak kopyalayıp TUNNEL_TOKEN=... yaz ve docker compose --profile tunnel up -d --build: cloudflared (yakargol-tunnel) oyun sağlıklı olunca tünele bağlanır. Tünel konteyneri oyunun ağ alanını paylaşır (network_mode: service:game), bu yüzden Zero Trust → Networks → Tunnels → tünel → Published application routes içindeki rota yakargol-sunucu.josephuz.com → http://localhost:5186 olarak kalır. .env git'e ve Docker imajına girmez. Güncelleme için aynı komut yeter; tüneli kapatmak için docker compose --profile tunnel down.

Testler: npm test kural ve "ana ekrana ekle" testlerini (Node, tarayıcısız) koşar. Tarayıcı dumanı testi çalışan sunucuya bağlanır: node tests/browser-smoke.mjs (Playwright gerekir; yolu PLAYWRIGHT_MODULE ile verilebilir), ekran görüntüleri artifacts/. Dokunmatik kontroller için node tests/touch-smoke.mjs (yatay telefon taklidi, çoklu parmak). Çevrim içi için node tests/online-smoke.mjs (iki sekme: oda, kodla katılma, koltuk, taşıma, özel oda ayarı, maç, yakar pas nişanı, mola; uygulama kipinde "Yakında"; SAHTE_KILIT=<betik> fare kilidini sahteler). Gösteri kipi için node tests/gosteri-smoke.mjs, rüzgar şutu gösteri sahnesi için node tests/gosteri-ruzgar-smoke.mjs. Üst çubuktaki tam ekran düğmesinin dar yatay telefonda yerini ölçen test kendi sunucusunu açar: npm run test:tamekran (aynı test standart araç çubuğunun sırasını, duraklatma menüsünün dar yatay telefonda kaydırmasız sığdığını ve her satırına dokunulabildiğini de ölçer). Oyun içi müzik için node tests/muzik-smoke.mjs (fare ve dokunmatik, ?muzik=1 ile; audio.currentTime / paused ölçülür, tarayıcı sesi kısık). Bu iki test ortam değişkeni olmadan da koşar: Playwright'ı ve oyun sunucusunu tests/ortam.mjs kendisi bulur / açar.

Telefonda adres çubuğu: oyun ana ekrana eklenebilir (manifest.webmanifest, Android'de "Uygulama olarak yükle", iOS'ta Paylaş → Ana Ekrana Ekle) — o kısayoldan açılınca tam ekran ve yatay başlar, adres çubuğu hiç çıkmaz. Simgenin PNG'leri şart: iOS apple-touch-icon SVG kabul etmez, Chrome Android de yükleme için 192/512 px PNG ister. icon-192.png, icon-512.png, icon-maskable-512.png ve apple-touch-icon.png icon.svg'den üretilir (node scripts/ikon-web.mjs; simge değişirse yeniden koştur). Sekmede kalanlar için üst çubukta tam ekran düğmesi var (#yg-full, sarı): maça girerken oyun zaten tam ekrana geçtiği için (src/touch.js → enterFullscreen) düğmenin işi giriş ekranı ile lobidir, maç başlayınca ← josephuz.com gibi gizlenir ve skor tabelasına yer bırakır. Masaüstünde (orada F11 var) ve Play Store uygulamasında (isApp, kaldıracak tarayıcı çubuğu yok) hiç görünmez.

Gösteri kipi (içerik klipleri)

https://yakargol.josephuz.com/?gosteri=1 yalnız tarayıcıda (uygulamada değil) oyunu kendi kendine oynatır: menü ve lobi atlanır, on koltuğun hepsini mevcut bot yapay zekâsı oynar (insan koltuğu dahil), başlama beklemeleri kısalır ve botlar yalnız bu kipte saldırganlaşır (daha çok yakar pas, kayma ve uzaktan şut — bkz. config.js → GOSTERI.bot), yakar top hakkı bollaşır. Kamera topun ve çevresindeki kalabalığın ağırlık merkezini yumuşakça izler, kadraj telefon ekranı için yakındır; yakar pas ağır çekimi bu kipte de çalışır. Arayüz gizlidir (köşede küçük oyun adı kalır), girdi okunmaz, ölçüm olayı gitmez, sunucuya hiç bağlanılmaz ve telefonda titreşim çalışmaz. Maç bitince birkaç saniye sonra yenisi kurulur: kip girdisiz döner durur. Her maç rastgele tohumla kurulur (normal maçta tohum sabittir, MATCH.seed): girdi olmadığı için sabit tohumda her maç birebir aynı maçın tekrarı olur, klipler birbirinin kopyası çıkardı. Normal oyun ve çevrim içi maç bu ayarlardan hiç etkilenmez. Kod: src/gosteri.js.

Rüzgar şutu sahnesi (?gosteri=ruzgar)

https://yakargol.josephuz.com/?gosteri=ruzgar maç değil, rüzgar şutunu anlatan sahnelenmiş bir vuruştur (içerik videosu için). Bir bot orta sahada topla durur; rakipler (kaleci dahil) kaleyle onun arasına, topun yolu üstüne dizilir ve kıpırdamaz — top çalmaz, saldırmaz; takım arkadaşları da yanlarda durup izler. Bot sol tıkı 1 saniye basılı tutmuş gibi rüzgar şutunu yükler (top camgöbeğine döner, çevresine rüzgar kıvılcımları saçılır), sonra kaleye vurur: top yoldaki beş rakibi tek tek savurur ve gol olur. İlk çarpmada ve golde kısa ağır çekim olur; ekranda yalnız bu sahneye özel, büyük bir açıklama yazısı durur (yükleme: "Sol tık 1 sn basılı: RÜZGAR ŞUTU", çarpma: "Önüne çıkanı savurur!"). Yazı bilerek kadrajın orta yatay bandında ve yanlardan içeridedir: içerik betiği 16:9 kaydı dikey videoya keserken yanlardan ~%15 kırpar ve üst / alt kısma kendi yazısını koyar.

Kamera ?gosteri=1den farklı olarak omuz üstüdür (izometrik değil): şutçunun arkasından kaleye bakar, top giderken onu yumuşakça izler. Sahne ~9 saniyede bir yeniden kurulur ve döner; her turda diziliş, şut yönü ve kamera açısı hafif değişir, böylece 25 saniyelik bir klipte en az iki tam gol çıkar ve turlar birbirinin kopyası olmaz. Arayüzün gizli olması, girdinin okunmaması, ölçümün gitmemesi ve sunucuya bağlanılmaması ?gosteri=1 ile ortaktır. ?gosteri=1 ve normal oyun bu sahneden hiç etkilenmez. Kod: src/gosteri-ruzgar.js, ayarlar config.js → GOSTERI_RUZGAR.

Çok oyunculu

Akış josephuz.com oda standardına uyar (josephuz/docs/oda-standardi.md). Giriş ekranı sırası: ADIN · TEK BAŞINA ↗ · ÇEVRİM İÇİ bölümü (● N çevrim içi; HIZLI KATIL →, ODA KUR, ODAYA KATIL → ODA KODU

• KATIL) · AÇIK ODALAR listesi (her satır tek düğme: kuranın adı, 5v5 · 5 dk · n/10 oyuncu, LOBİDE / MAÇTA, KATIL → ya da DOLU; liste sunucudan kendiliğinden gelir). Oda kur odayı hemen herkese açık kurar; hızlı katıl en uygun açık odaya oturtur, yoksa yeni oda kurar. Kod KPRT-4 biçimindedir; küçük harf ve tiresiz (kprt4) de yazılır. Davet linki ?oda=KOD açılınca odaya kendiliğinden girilir; odadayken adres çubuğu ?oda=KOD gösterir, çıkınca silinir. Bekleme odasında iki takımın beşer koltuğu vardır (her takımın beşincisi kaleci): herkes boş koltuğa (Bot · boş koltuk, üstüne gelince Buraya otur) tıklayıp oturur, kuran oyuncuları sürükleyip bırakır ya da oyuncuya sonra koltuğa tıklar; dolu koltukta ikisi yer değiştirir. Oda ayarı ODA: Herkese açık / Özel yalnız kuranda açıktır (özel oda listede görünmez, yalnız kodla girilir). Maçı kuran başlatır (MAÇI BAŞLAT ↗; ötekilerde Kuranın başlatması bekleniyor); kuran çıkarsa kuranlık sıradaki insana geçer. Maç sürerken de odaya girilir (boş bot koltuğuna). Maç içinde mola menüsünde Odadan çık, maç sonunda LOBİYE DÖN. Maçı sunucu koşturur (server/rooms.mjs, tarayıcıdakiyle aynı world.js), sayfa girdiyi yollar, gelen durumu ara değerle çizer, kendi oyuncunu gecikmesiz göstermek için yerel girdiden kısa bir öne kayma ekler (src/net/). Yakar pas nişanı herkes için maçı dondurur, uçuş herkes için ağır çekimdir. Mola maçı durdurmaz; kopan oyuncunun koltuğunu o sürede bot oynar, aynı sekmeyle geri dönünce yerine oturur. Maç bitince oda lobiye döner. Giriş ekranı sunucuya bağlıyken çevrim içi sayısını yazar; sunucu (PC ya da tünel) kapalıysa oda düğmeleri Yakında olur. Android uygulamasında çok oyunculu kapalıdır (config.js → ONLINE), düğmeler hep "Yakında"; uygulama çevrim içi sayısına sinyalle (/presence) katılır.

Android APK (Android Studio gerekmez): JDK 21 ve Android SDK komut satırı araçları yeter. Bu bilgisayarda %USERPROFILE%android altında taşınabilir olarak kurulu (jdk-21…, sdk: platform-tools, platforms;android-36, build-tools;36.0.0); başka yerdeyse JAVA_HOME / ANDROID_HOME ayarla. npm run apk oyun dosyalarını dist/e toplar, Capacitor ile android/ projesine kopyalar, Gradle ile derler: telefona kurulacak imzalı apk/YakarGol.apk, Play Store için apk/YakarGol.aab ve incelemek için apk/YakarGol-debug.apk. Yayın anahtarı android/yakargol-release.jks, şifresi android/keystore.properties (ikisi de git'e girmez; yedeklenmeli, kaybolursa Play Store'da güncelleme yayınlanamaz). APK'yı telefona atıp açmak yeter ("bilinmeyen kaynaklardan yükleme" izni istenir; Samsung'da önce Ayarlar → Güvenlik ve gizlilik → Otomatik Engelleyici kapatılmalı). USB hata ayıklama açık telefona doğrudan kurmak için npm run apk -- --install. Uygulama oyunu kendi içinden açar (internetsiz oynanır), yatay ve tam ekrandır, Android geri tuşu mola / devam olur; çok oyunculu "Yakında", çevrim içi sinyali canlı sunucuya gider. Kimlik com.josephuz.yakargol (Play Store'da değiştirilemez). Simge ve açılış görseli node scripts/icons.mjs ile üretilir; Play Store görselleri store/.

Tuşlar

Tuş	İş
WASD / oklar	Baktığın yöne göre hareket. Topa yaklaşınca otomatik alırsın.
Fare	Bak ve nişan al (fare kilitlenir; nişan ekran ortasındaki nişangah).
Sol tık	Bırakınca nişangaha doğru normal (beyaz) şut.
Sol tık (top sende değilken)	Pas iste: başında "PAS!" çıkar, topu taşıyan bot arkadaşın sana pas verir.
Sol tık basılı (1 sn)	Rüzgar şutu: oyun ağır çekime geçer, 2 sn nişan al, bırak. Durdurulamaz; kaleye nişanlıysa her yerden gol, değilse ilk duvarda biter. Takım başına 5 hak. Nişan alırken rakip kayarak topu alırsa vuruş olmaz.
Sağ tık	Top sendeyken kısa bas: pas, 1 sn basılı tut: yakar pas (oyun ağır çekime geçer, 2 sn nişan al, bırak); topsuzken topa doğru kayma (basılan yön ne olursa olsun).
Shift	3 saniye hızlı koşu (rüzgar çizgileri, geniş kamera açısı), sonra yorulur normale dönersin (enerji koşu bitince dolmaya başlar).
Boşluk	Zıpla; havadayken yakar pas seni yakamaz.
V / 🎥	Kamera: omuz ↔ izometrik (masaüstünde omuzla başlar, seçim hatırlanır). İzometrik futbol yayını gibi sabit yan açıdır (fare / parmak açıyı döndürmez, topa çevrilmez); masaüstünde fare kilitlenmez, şut / pas / yakar pas imlecin sahadaki noktasına gider; telefonda nişan hareket / bakış yönü, rakip kaleye dönüksen kale. Yerde ok gösterir.
F1 / Esc	Yardım / mola (Esc fareyi de bırakır; odak kaybında oyun durur).

Dokunmatik (telefon, tablet, Android uygulaması): dokunmatik ekran algılanınca açılır (?touch=1 ile masaüstünde de). Ekran yatay; dik tutunca "yan çevir" uyarısı çıkar. Tarayıcıda maça girerken tam ekrana geçer.

Dokunuş	İş
Sol yarı	Parmağın değdiği yerde joystick belirir (analog). Hızlı koşu yalnız KOŞ düğmesiyle.
🎥	Telefonda izometrik kamerayla başlar (yukarıdan eğik, oyuncu ortada); nişan koştuğun / baktığın yön, rakip kaleye dönüksen kalenin ortası, yerde ok gösterir. 🎥 omuz kamerasına geçirir (seçim hatırlanır). Masaüstünde omuzla başlar, V ya da 🎥 ile geçilir. Ayarlar CAMERA.iso.
Sağ yarı	Parmak kaydırmak kamerayı çevirir (omuzda bakış / nişan, farenin karşılığı).
ŞUT / PAS İSTE	Top sende değilken PAS İSTE: dokun, pas iste. Top sendeyken dokun: şut; 1 sn basılı tut: rüzgar şutu nişanı (ağır çekim; izometrikte joystick, omuzda parmakla nişan al, bırak).
PAS / KAY	Top sendeyken dokun: pas; 1 sn basılı tut: yakar pas nişanı (izometrikte joystick, omuzda parmakla nişan al, bırak). Topsuzken: topa doğru kay.
ZIPLA / KOŞ	Boşluk / Shift. Düğmelerde enerji dolumu görünür.

Telefonda dolum halkası ve enerji / sersemlik göstergesi karakterin üstünde değil ekranın altındadır. Top ekranda değilse ekranın kenarında topun yönünü gösteren işaret çıkar (yakar pasta kırmızı), top görününce kaybolur. Koşarken karakter gittiği yöne döner, dururken nişana. Mobilde görüntü hafifler (piksel oranı, gölge haritası), önemli anlarda kısa titreşim olur. Ayarlar TOUCH (config.js).

Müzik ve standart araç çubuğu

Şu an oyunda müzik yok (4 Ekim 2026). Sakin sürümler birbirine fazla benzer ve temasız bulundu; müzik ileride yeniden yapılacak. src/muzik.js içindeki SAHNELER listeleri boştur: hiçbir dosya inmez, hiçbir şey çalmaz, MUZIK_VAR / muzik.parcaVar false olur ve Müzik düğmeleri (üst çubuk ve mola menüsü) gizlenir. Eski parçalar silinmedi, muzik/archive/ altında durur (bkz. muzik/archive/NOT.txt; yayına ve uygulamaya girmez). Parça adları SAHNELERe ve tests/muzik.test.mjs PARCALARa geri yazılınca düğmeler, çalma ve parça testleri kendiliğinden döner; o zamana kadar parçaya bakan test adımları "müzik yok: atlandı" yazıp geçer. Aşağıdaki düzen eski parçalarla yazıldı.

Oyun içi müzik muzik/ altındaki parçalardır (kendi bestemiz; 128 kbps, ~2 MB, lisans notu muzik/LISANS.txt). Sahneyi src/muzik.js seçer, geçişler 1,8 saniye çapraz süzülmedir; dosyalar gerektiğinde iner (menüde yalnız sakin parça), yollar görelidir (Capacitor'da da çalışır, sonraki APK'ya kendiliğinden girer).

Sahne	Parça	Nerede
sakin	yakar-6-mactan-sonra · Devre Arası	Giriş ekranı, lobi, mola (devre arası), maç sonu karnesi
mac	yakar-5-soyunma-odasi · Spor Marşı	Maç
doruk	yakar-4-mahalle-sabahi · Son Dakika Golü ↔ Spor Marşı	Son dakika (saatte ≤ 60 sn) ve altın gol; parça bitince sırayla

Müzik ses düzeyi efektlerin altındadır (varsayılan %35) ve Web Audio kazanç düğümünden geçer: iOS Safari'de audio.volume salt okunurdur, orada sürgü ve çapraz geçiş başka türlü çalışmaz. Açık / kapalı ve düzey tarayıcıda saklanır (yg.muzik, yg.muzik.ses); efekt sesinden (yg.sound) bağımsızdır.

Müzik ilk kullanıcı girdisinden sonra başlar ve sekme gizlenince durur. Dinlenen olay parmağın kalktığı andır (pointerup / touchend / click / keydown): dokunmatikte pointerdown ve touchstart tarayıcıya kullanıcı izni saymaz, onlarla beklemek müziği ikinci dokunuşa bırakırdı. O ilk girdide üç parçanın da kilidi bir anlık sessiz sesle açılır (dosyaları inmeden), çünkü maç parçası çizim döngüsünden — yani dokunuşun dışından — başlar ve kilidi açılmamış öğeyi iOS engellerdi. Gösteri kiplerinde (?gosteri=...) ve otomatik tarayıcılarda hiç <audio> kurulmaz — video betiği müziğini kendi ekler; ?muzik=1 müziği elle açar (testler bunu kullanır), ?muzik=0 kapatır.

Standart üst araç çubuğu (bütün JosephUz oyunlarında aynı sıra ve aynı yazılar): ← josephuz.com · Ses: açık/kapalı · Müzik: açık/kapalı · Kontroller F1. Oyuna özgü düğmeler (Duraklat Esc, 🎥 Kamera, ⛶ Tam ekran) bu dörtlünün ardına gelir. Telefonda düğmeler simgeye döner; maç sırasında müzik düğmesi çubuktan çekilir (skor tabelasına yer açılsın diye) ve ☰ duraklatma menüsünden açılıp kapatılır.

Standart duraklatma (Esc) menüsü: DEVAM ET → · Kontroller F1 · Ses: … · Müzik: … (altında müzik ses sürgüsü) · Yeniden başlat (çevrimdışı) · Ana menü / çevrim içinde Odadan çık · josephuz.com'a dön. Menü kısa ekranlarda (max-height:560px) süslerini bırakıp sıkışır: en dar telefonda bile (iPhone 13 yatay, 750×342 CSS px) kaydırmasız sığmalı — kart overflow:auto olduğu için görünen alanının dışında kalan düğmeye dokunulamaz. Kontroller perdesi menünün üstünde açılır ve müziği değiştirmez: perde saydamdır, altındaki ekran neyse müzik onundur.

Kurallar

Maç 5 dakika; yalnız goller puan verir, beraberlikte altın gol. Saha 52×80 birim; aut yok, top duvardan seker.

• Enerji: yalnız kayma ve hızlı koşu enerji kullanır; biri kullanılınca ikisi birden 3 saniye bekler. Geri sayım karakterinin sırtında görünür (dolunca kısa bir "HAZIR"); sol alttaki kart da gösterir. Yakar pas ve rüzgar şutu enerjiden bağımsızdır: yalnız takımın hakkı sayılır. Takımın rüzgar hakkı bittiyse sol tıkı basılı tutarsan şarj dolu bekler, bırakınca normal şut.
• Dolum halkası: sol tık ya da sağ tık basılıyken nişangahın çevresinde halka dolar ve hangi vuruşun hazırlandığını yazar (camgöbeği rüzgar, turuncu yakar pas; yapılamıyorsa gri ve sebebi). Ayaktaki top da vuruşun rengine bürünür.
• Yakar pas hakkı takımındır: her takım maç boyunca 5 kez atar (takımdaki herkes aynı haktan harcar). İki takımın kalan hakları skor tabelasında alev damlalarıyla görünür. Sağ tık 1 saniye dolunca oyun ağır çekime geçer, top ayağında alev alır ve fareyle bir takım arkadaşına nişan alırsın (nişana en yakın arkadaşın başında "YAKAR PAS" yazar); sağ tıkı bırakınca (ya da sol tık / süre dolunca) top çıkar ve o arkadaşa kilitlenir: kaçsa da onu izler, mutlaka ona varır. Botlar da aynı yoldan atar: önce dolum (çevrelerinde alev ya da rüzgar), sonra ağır çekimde kısa nişan; o sırada kayarak topu ayaklarından alabilirsin. Sinema şeritleri arasında top ağır çekimde uçar ve herkesin kamerası onu izler; her çarptığı rakipte çarpma daha da ağır çekimde, vurulan geriye savrulup düşerek gösterilir. Sinema bitince kamera kaldığı yere değil topa dönük olarak sana geçer (kenardan dönüşte ve omuz kamerasına geçişte de). Zıplayan yanmaz: botlar üstlerine gelen yakar pastan çoğu zaman zıplayıp kurtulur.
• Nişan sırasında (yakar pas ya da rüzgar) nişan alan kıpırdamaz, oyun ağır çekimde sürer: rakip kayarak topu ayağından alırsa vuruş olmaz (yürüyerek alınamaz). Botlar rakip nişan alırken üstüne koşup kayar.
• Yakar pas gol olmaz ve durmaz: yol boyunca değdiği her rakibi 4 saniye kenara gönderir, araya giren öbür arkadaşların içinden geçer, yalnız hedef arkadaş yakalar. Dönüşte kısa korunma vardır. Botlar yakar pası arada rakip olan bir arkadaşa atar.
• Pas isteme: top ayağında değilken sol tık (dokunmatikte PAS İSTE) 1,6 saniye başında "PAS!" yazdırır; topu taşıyan bot arkadaşın kısa bir tepkiyle çoğu zaman sana pas verir.
• Rüzgar şutu hakkı da takımındır: maç boyunca 5 kez (skor tabelasında camgöbeği damlalar, yakar pas hakkından ayrı). Sol tık 1 saniye dolunca ağır çekimde 2 saniye nişan alınır, bırakınca çıkar. Top bilerek normal şuttan yavaştır ve hiç yavaşlamaz, herkesin kamerası onu izler. Durdurulamaz: kimse (kaleci ve takım arkadaşları dahil) tutamaz, yolundaki rakipleri kenara savurur. Kaleye nişan alındıysa nereden vurulursa vurulsun gol olur; nişan kaleye değilse ilk duvara çarpınca normal topa döner.

Maç sonunda oyuncu istatistikleri (gol, pas, yakma, top kapma, kurtarış) gösterilir.

Dosyalar

Simülasyon ile görünüm ayrıdır: src/world.js ve ona bağlı modüller DOM ve three.js olmadan (Node'da da) koşar ve olayları w.events'e yazar; tarayıcıda src/view/ dünyayı çizer, src/main.js olayları efekt, ses ve mesaja çevirir.

Dosya	Sorumluluk
index.html, style.css	Tam ekran düzen: sahne, tabela, oyuncu kartı, karakterin sırtındaki gösterge, ekranlar (giriş, yardım, mola, maç sonu)
game.js	Giriş; src/main.js'i yükler (import map: three → /vendor/three.module.js), hata olursa okunur mesaj
server.mjs	Sunucu: oyun dosyaları, src/, /vendor (three paketi), /health, /presence, WebSocket
server/rooms.mjs	Odalar: koltuklar, kuran taşıması, oda ayarı (özel / açık), otoriter maç döngüsü, yakar pas sineması, geri bağlanma
src/net/protocol.js, src/net/snapshot.js, src/net/client.js	Ağ sözlüğü, durum paketi, çevrim içi istemci (ara değer, öne kayma)
src/lobby.js, src/platform.js	Giriş ekranı oda düğmeleri ve lobi; platform (uygulama / web) ve sunucu adresi
src/config.js	Tüm ayar sayıları (saha, maç, hareket, enerji, kayma, hızlı koşu, şutlar, rüzgar, top, yanma, botlar, kamera)
src/world.js	Simülasyon: dünya kurulumu, sabit adım, girdiyi eyleme çevirme (sol tık şarjı), hareket, saat ve altın gol
src/actions.js	Oyuncu eylemleri: zıplama, kayma, hızlı koşu, şut (normal / rüzgar / yakar / pas), pas hedefi seçimi
src/ball.js	Top: taşıma ve kapma, sekme, gol, yakalama, yakma, rüzgarla savurma
src/ai.js	Bot kararları: kaleci, topa koşan (hızlı koşu, kayma), yer tutan; şut / yakar pas / pas; baskı altında kaçış (şut, yakar pas, boştaki arkadaşa pas, duvardan sektirme); yakar pastan kaçış
src/lineup.js	Diziliş: rollere göre ev konumları, hücum yönü, golden sonra rollerin karılması ve yeniden diziliş
src/rng.js, src/math.js	Tohumlu rastgelelik; küçük yardımcılar
src/input.js	Klavye ve fare, fare kilidi, basışların bir kez tüketilmesi; dokunmatik düğmeleri aynı basışlara bağlar

Lisans / License

• Kod: MIT, Copyright (c) 2026 JosephUz. Kodu kullanabilir, değiştirebilir, dağıtabilirsin.
• MIT dışında, tüm hakları saklıdır: "Yakar Gol" ve "JosephUz" adları; muzik/ altındaki müzikler; logo ve simgeler (icon.svg, icon-*.png, apple-touch-icon.png, store/, android/app/src/main/res/). Ayrıntı: TRADEMARKS.md. Müzik için muzik/LISANS.txt.
• Fork'lar başka bir ad ve logo kullanmalı, resmî sürüm olduğunu ima etmemeli.
• Üçüncü taraf: three.js ve ws npm bağımlılığıdır (ikisi de MIT), depoda değil, kendi lisanslarıyla gelir. Müziklerdeki enstrüman örnekleri VSCO 2 Community Edition (CC0).

In English: The code is licensed under MIT. The name "Yakar Gol", the name "JosephUz", the music in muzik/, the logo and icons (icon.svg, icon-*.png, apple-touch-icon.png, store/, android/app/src/main/res/) are not covered by MIT and are all rights reserved; see TRADEMARKS.md. Forks must use a different name and logo.

Katkı / Contributing

Hata bildirimi, öneri ve pull request'e açığız. Büyük bir değişiklikten önce bir issue açıp konuşalım; oyunun dengesi ve yönü JosephUz'da. Kod ve oyun Türkçe: değişken, işlev ve mesaj adları Türkçe, çevresindeki kodun düzenine uy; npm test geçmeli. Gönderdiğin katkı bu deponun MIT lisansıyla yayımlanır. Müzik, ses ya da görsel eklemeden önce issue'da sor. Güvenlik açıklarını issue yerine SECURITY.md'deki yoldan bildir.

In English: Issues and pull requests are welcome; please open an issue before large changes. Contributions are accepted under the MIT license of this repository. Report security issues privately as described in SECURITY.md.