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

# AFK Bot API servisi

> Minecraft AFK botlarını kendi Windows, Linux veya Docker servisinizde çalıştırın.

API modunda AFK botları kendi servis makinenizde çalışır. Tarayıcı kapandıktan sonra servis çalışmaya devam edebilir. Tarayıcı modu için bu servis kurulmaz.

## Servisi kurun

[ZonelyAfkBotApiService](https://github.com/zonely-gen-tr/ZonelyAfkBotApiService) dosyalarını alın ve **service/** klasörüne geçin. Yerel başlatma için işletim sisteminize ait dosyayı kullanın:

> [tab] Windows
>
> ```bat title="Windows · yerel" icon="https://mintcdn.com/zonely-a8cd49e7/ja7fj31SJsKV8uKD/images/doc-icons/ui-monitor.svg?fit=max&auto=format&n=ja7fj31SJsKV8uKD&q=85&s=be8f113e6d089ddf27a146dee68a1b3c" lines theme={"theme":"css-variables"}
> cd service
> start-local-windows.bat
> ```

> [tab] Linux
>
> ```bash title="Linux · yerel" 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"}
> cd service
> sh start-local-linux.sh
> ```

Docker kurulumunda aynı klasördeki **start-docker-windows.bat** veya **start-docker-linux.sh** başlatıcısı kullanılır.

## Servis erişimini düzenleyin

İlk açılışta oluşan **service/.env** dosyasında **API\_TOKEN**, **PANEL\_USERNAME**, **PANEL\_PASSWORD** ve **PANEL\_SESSION\_SECRET** değerlerini belirleyin. Servisin varsayılan ana portu **8787**’dir.

## Zonely bağlantısını hazırlayın

**Eklentiler → Minecraft AFK Bot** ayarlarında **API Mode** seçin. HTTP/HTTPS türünü, servis adresini, portunu ve .env dosyasıyla aynı **API Token** değerini girin.

[![Bağlantı Türü, Servis IP / Alan Adı, API Token](https://mintcdn.com/zonely-a8cd49e7/MLAhZnjsyaexSV7n/images/panel/addon-settings-guide-20261027/afk-bot-ayarlari-02.png?fit=max\&auto=format\&n=MLAhZnjsyaexSV7n\&q=85\&s=4ae49ab3613bd64d788dacb5966a6940)](https://docs.zonely.gen.tr/images/panel/addon-settings-guide-20261027/afk-bot-ayarlari-02.png)

> [card] 1. Bağlantı Türü
>
> Servisinizin HTTP veya HTTPS türünü seçin.

> [card] 2. Servis IP / Alan Adı
>
> AFK servisinin adresini ve portunu girin.

> [card] 3. API Token
>
> Servis .env dosyasıyla aynı token değerini kullanın.

Servis başka makinedeyse onun erişilebilir adresini kullanın. **127.0.0.1** yalnız servis ile bağlantıyı yapan taraf aynı makinedeyken doğru hedeftir.

## Servisi takip edin

Sağlık kontrolü **/health**, servis yönetimi **/panel** üzerinden açılır. Panelde bağlantı kontrolünü tamamladıktan sonra bot ayarlarını hazırlayın. Servis adresi veya token değiştiğinde Zonely bağlantısını da güncelleyin.

[AFK Bot ayarları](https://docs.zonely.gen.tr/guides/minecraft-afk-bot.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.