> ## 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.

# Mini oyun sunucusu

> Oyun sürecini bağlantı JSON’u ile yönetim paneline bağlayın.

Mini oyun sunucusu aracı, kendi makinenizdeki oyun sürecini Zonely Minigame Gateway’e bağlar. Panelden bağlantı durumu, süreç çıktısı ve sistem ölçümleri izlenebilir.

## Bağlantı kaydını hazırlayın

**Yönetim → Mini Oyunlar** bölümünde ilgili oyun için sunucu bağlantısı oluşturun. Panelin ürettiği bağlantı JSON’unu alın. Bu veri site ve sunucuya özgü kimlikleri içerir.

## Aracı başlatın

[Resmî paketi](https://github.com/zonely-gen-tr/zonely-minigame-server) indirin ve dosyaları aynı klasörde tutun. **Node.js 20 veya üzeri** gereklidir. Sisteminize ait başlatıcıyı çalıştırın:

> [tab] Windows
>
> ```bat title="Windows" icon="https://mintcdn.com/zonely-a8cd49e7/ja7fj31SJsKV8uKD/images/doc-icons/ui-monitor.svg?fit=max&auto=format&n=ja7fj31SJsKV8uKD&q=85&s=be8f113e6d089ddf27a146dee68a1b3c" theme={"theme":"css-variables"}
> Zonely-Minigame-Server.bat
> ```

> [tab] Linux
>
> ```bash title="Linux" icon="https://mintcdn.com/zonely-a8cd49e7/ja7fj31SJsKV8uKD/images/doc-icons/ui-terminal.svg?fit=max&auto=format&n=ja7fj31SJsKV8uKD&q=85&s=974dbaf0043eca8dd43204c8ea988572" lines theme={"theme":"css-variables"}
> chmod +x zonely-minigame-server.sh
> ./zonely-minigame-server.sh
> ```

İlk başlangıçta oluşan **config.json** dosyasına panelden aldığınız tam JSON’u yazın.

## Oyun sürecini belirleyin

| Alan | İşlev |
| - | - |
| process.command | Oyun sürecini başlatacak uygulama. |
| process.args | Başlatma parametreleri. |
| process.cwd | Sürecin çalışma klasörü. |
| process.env | Sürece verilecek ortam değerleri. |
| auto\_start | Bağlantı kurulduğunda süreci otomatik başlatma. |

Kendi uygulamanıza göre süreç alanlarını tamamlayıp aracı yeniden başlatın. **connection\_key** ve diğer bağlantı kimliklerini panelin ürettiği biçimde koruyun.

## Panelden izleyin

Bağlantı durumunu ve günlük çıktısını açın. Araç bağlı olup oyun başlamıyorsa süreç komutunu, parametreleri ve çalışma klasörünü inceleyin.

[Mini oyun yönetimi](https://docs.zonely.gen.tr/guides/minigame-studio.md) · [Bağlantılar ve araçlar](https://docs.zonely.gen.tr/integrations/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.