> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zonely.gen.tr/llms.txt
> Use this file to discover all available pages before exploring further.
# Minigame Stüdyosu
> Oyun bilgilerini, HTML kodunu, şemayı ve ödülleri hazırlayın; önizleme ve konsoldan kontrol edin.
**Minigame Stüdyosu** ekranını açıp **Minigame Ekle** düğmesine basın. Oyun bilgileri, kod, şema, ödüller ve test araçları aynı düzenleyicide bulunur.
HTML, CSS ve JavaScript ile bulmaca, refleks, platform, kart veya arena gibi farklı türlerde tarayıcı oyunları hazırlayabilirsiniz. Oyun fikrinizi ve kontrolleri yapay zekâya anlatıp **tek sayfalık HTML kodu** oluşturmasını isteyebilir, sonucu stüdyonun kod görünümüne ekleyip canlı önizlemede deneyebilirsiniz.
Gerçek zamanlı odalar, oyuncu işlemleri ve ödüller eklemek için **Geliştirici** sekmesindeki bağlantı rehberini de oyun kodunu hazırlarken kullanın.
## Oyun bilgilerini doldurun
**Oyun Bilgileri** sekmesinde adı, açıklamayı, kapak görselini ve aktiflik tercihini hazırlayın. Aşağıdaki **Işık Avı** örneğinde oyuncu ışıkları toplar ve kırmızı kürelerden kaçar. Oyunun içinde yazı bulunmaz; ilerleme çubuğu ve üç can simgesi kullanılır.
[](https://docs.zonely.gen.tr/images/panel/tools-integrations-guide-20261027/mini-oyunlar-01.png)
> [card] 1. Genel bilgiler
>
> Adı, açıklamayı, kapak görselini ve aktif durumunu belirleyin.
> [card] 2. Bağlantı modu
>
> Zonely Public Server hazır tarayıcı köprüsünü kullanır. Özel sunucu farklı bir seçenektir.
**Bağlantı Modu** listesinden oyunun kullanacağı çalışma ortamını seçin.
| Mod | Kullanımı |
| - | - |
| Zonely Public Server | Hazır tarayıcı çalışma ortamı ve oyun köprüsü. |
| Zonely Minigame Server | Kendi Zonely oyun sunucunuzun çalışma ortamı. |
| Özel Socket.IO | Kendi Socket.IO sunucunuzun bağlantısı. |
| Özel WebSocket | Kendi WebSocket sunucunuzun bağlantısı. |
Özel bağlantı seçtiğinizde açılan adres ve yol alanlarını kendi sunucunuza göre doldurun. Hazır bağlantıda oyunun kullanacağı yöntemleri **Geliştirici** sekmesinden inceleyin.
## Oyun kodunu ekleyin
**Minigame Kodları** sekmesinin kod görünümünü açın. Aşağıdaki örneğin tamamını kopyalayıp bu alana yapıştırın; HTML, CSS ve JavaScript aynı kod içinde yer alır.
```html title="Işık Avı — Minigame Kodları" theme={"theme":"css-variables"}
```
Fareyi hareket ettirerek, ekrana dokunarak veya **WASD / ok tuşlarıyla** mor küreyi yönetin. Yeşil ışıkları toplayın ve kırmızı kürelerden kaçın. On iki ışık toplandığında tur tamamlanır; üç can biterse tur sona erer. Ortadaki oynat simgesine basarak yeniden başlayın.
## Oyun şemasını düzenleyin
**Oyun Şeması** sekmesinde düğümleri ekleyip birbirine bağlayın. Seçili düğümün başlığını, olayını, değerini ve notunu sağdaki alandan düzenleyin.
[](https://docs.zonely.gen.tr/images/panel/tools-integrations-guide-20261027/mini-oyunlar-03.png)
> [card] 1. Olay akışını düzenleyin
>
> Başlangıç ve bitiş düğümlerini bağlayın; sağdan seçili düğümün olayını düzenleyin.
Şemadaki olay adlarını oyun koduyla eşleştirin. Şema akışı düzenler; hareket, çizim ve çarpışma davranışları HTML içindeki oyun kodunda hazırlanır.
## Ödülü tanımlayın
**Ödüller** sekmesinden kredi, ürün veya sunucu komutu karşılığını hazırlayın. Buradaki ödül anahtarını, **Geliştirici** sekmesinde gösterilen ödül çağrısıyla oyununuza bağlayın.
[](https://docs.zonely.gen.tr/images/panel/tools-integrations-guide-20261027/mini-oyunlar-04.png)
> [card] 1. Ödül anahtarı
>
> Ödül anahtarını oyun kodundaki ilgili Zonely çağrısıyla eşleştirin.
Işık Avı örneği temel oynanışı gösterir. Ödül vermek istiyorsanız tur kazanma koşulunu Zonely bağlantısına ayrıca bağlayın; sonuç doğrulamasını ve ödül koşullarını oyun sunucunuzla birlikte hazırlayın.
## Oyunu önizleyin
**Oyunu Test Et** sekmesinde **Oyunu başlat** düğmesini kullanın. Hareketi, ışık toplamayı, canları ve tur sonunu kontrol edin. Tur sonundaki oynat simgesiyle yeni tur açabilirsiniz.
[](https://docs.zonely.gen.tr/images/panel/minigame-code-20261028/light-hunt.png)
> [card] Işık Avı önizlemesi
>
> Işıkları toplayın, kırmızı kürelerden kaçın ve ilerleme çubuğunu doldurun.
Örnek oyun tek kişiliktir. Çok oyunculu bir oyun hazırlarken ortak oda, hareket ve oyun durumunu seçtiğiniz bağlantı altyapısıyla eşleyin.
## Konsolu ve aktif kullanıcıları izleyin
**Konsol** sekmesinden oturum olaylarını ve hata mesajlarını takip edin. Oyun kodundaki hatayla sunucu bağlantısı hatasını ayırt ederek ilgili alanı düzeltin.
[](https://docs.zonely.gen.tr/images/panel/tools-integrations-guide-20261027/mini-oyunlar-06.png)
> [card] 1. Konsol
>
> Canlı oturumun olaylarını ve hata mesajlarını buradan inceleyin. Oturum açılınca olaylar burada görünür.
**Aktif Oyuncular** sekmesi, kaydedilmiş oyunda oturum açan kullanıcıları listeler. Bir kaydın görünmesi için canlı oyun oturumunun açılmış olması gerekir.
[](https://docs.zonely.gen.tr/images/panel/tools-integrations-guide-20261027/mini-oyunlar-07.png)
> [card] 1. Aktif kullanıcılar
>
> Kaydedilmiş oyunda canlı oturum açan kullanıcılar listelenir.
## Bağlantı yöntemlerini inceleyip kaydedin
**Geliştirici** sekmesindeki güncel örneklerden başlangıç, hareket, skor ve sonuç olaylarını alın. Oyun kodunda kullandığınız yöntemleri burada gösterilen bağlantı biçimiyle eşleştirin.
[](https://docs.zonely.gen.tr/images/panel/tools-integrations-guide-20261027/mini-oyunlar-08.png)
> [card] 1. SDK ve bağlantı rehberi
>
> Hazır köprü yöntemleri ile oyun, skor ve sonuç olaylarının sözleşmesini buradan alın.
Ana listedeki **Minigame Sunucuları** sekmesiyle kendi sunucunuzun kurulumunu ve çalışma durumunu takip edebilirsiniz. Bilgileri, kodu, şemayı ve ödülleri tamamlayıp oyunu kaydedin. Aktif oyunu kullanıcı tarafında açarak bir turu kontrol edin.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.