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

> Run Minecraft AFK bots on your own Windows, Linux or Docker service.

AFK bots in API mode work on your own service machine. After the browser is closed, the service can continue to work. This service is not dry for browser mode.

## Service

[ZonelyAfkBotApiService](https://github.com/zonely-gen-tr/ZonelyAfkBotApiService) Get files and **Service/** Switch to the folder. Use the file of your operating system for local startup:

> [tab] Windows
>
> ```bat title="Windows · local" 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 · local" 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
> ```

In the same folder in the installation of Docker **start-docker-windows.bat** or **start-docker-linux.sh** launcher is used.

## Edit service access

The first opening **Service/.env** file **API\_TOKEN**, **PANEL\_USERNAME**, **PANEL\_PASSWORD** and **PANEL\_SESSION\_SECRET** Set values. The default main port of the service **8787**.

## Prepare Zonely link

**Addons → Minecraft AFK Bot** settings **API Mode** Select. Same as the HTTP/HTTPS type, service address, port and .env file **API Token** enter the value.

[![Connection Type, Service IP/Domain Name, API Token](https://mintcdn.com/zonely-a8cd49e7/MLAhZnjsyaexSV7n/images/panel/addon-settings-guide-20261027/afk-bot-ayarlari-02-en.png?fit=max\&auto=format\&n=MLAhZnjsyaexSV7n\&q=85\&s=62b39ebb62c2dcf2ab3362519f7618a7)](https://docs.zonely.gen.tr/images/panel/addon-settings-guide-20261027/afk-bot-ayarlari-02-en.png)

> [card] 1. Connection Type
>
> Select your service’s HTTP or HTTPS type.

> [card] 2. Service IP/Domain Name
>
> Enter the address and port of the AFK service.

> [card] 3. API Token
>
> Use the same token value with the service .env file.

Use its accessible address if the service is on other machine. **127.0.0.1** The side that makes connection with the only service is the right target when it is in the same machine.

## Follow the service

Health control **/health**,service management **/panel** opens over. After completing connection control on the panel, prepare the bot settings. Update Zonely link when service address or token changes.

[AFK Bot settings](https://docs.zonely.gen.tr/en/guides/minecraft-afk-bot.md) · [Connections and tools](https://docs.zonely.gen.tr/en/integrations/overview.md)


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