Echo Chat Bot

================================================================

LOG BOT — KULLANIM KILAVUZU / USER GUIDE

================================================================

----------------------------------------------------------------

TÜRKÇE

----------------------------------------------------------------

LOG BOT NEDİR?

--------------

Log Bot, BoomChat/CodyChat sistemine entegre bir eklentidir.

Bir komut dosyası (loglar.txt) içindeki satırları sırayla okuyarak

otomatik olarak sahte bot kullanıcılar oluşturur, bu kullanıcıları

odalara sokar, mesaj yazdırır ve odadan çıkarır.

Amacı, sohbet odasını canlı göstermektir.

NASIL ÇALIŞIR?

--------------

Her birkaç saniyede bir (ayarlanabilir) arka planda otomatik olarak

tetiklenir. Her tetiklemede komut dosyasındaki bir sonraki satırı

işler ve durur. Böylece komutlar gerçek bir sohbet akışı gibi

zaman yayılımlı çalışır.

Bot hesapları veritabanında "cycle_bot = 1" alanıyla işaretlenir.

Oluşturulan her botun ID'si log_bot/system/bot_ids.json dosyasına

kaydedilir.

KOMUT DOSYASI FORMATI (loglar.txt)

------------------------------------

Komutlar loglar/ klasöründeki logs_part*.txt dosyalarında saklanır.

"#" ile başlayan satırlar yorum satırıdır, işlenmez.

 olustur@ BOTADI

   → Belirtilen isimde bir bot hesabı oluşturur.

    Hesap zaten varsa günceller, tekrar oluşturmaz.

 part@ BOTADI [ODA_ID | #OdaAdı]

   → Botu belirtilen odaya sokar ve giriş mesajı yayınlar.

    Oda belirtilmezse varsayılan oda kullanılır.

    Bot henüz yoksa önce otomatik oluşturulur.

 konustur@ BOTADI [#OdaAdı] @x MESAJ x@

   → Bot belirtilen odada mesaj yazar.

    Bot o odada değilse önce odaya alınır.

    Mesaj blok formatı: @x ... x@

    Basit format: konustur@ BOTADI MESAJ

 kille@ BOTADI

   → Botu bulunduğu odadan çıkarır.

ÖRNEK KOMUT DOSYASI

--------------------

 olustur@ Ahmet

 part@ Ahmet 1

 konustur@ Ahmet @x Merhaba nasılsınız? x@

 konustur@ Ahmet @x Bugün hava çok güzel :) x@

 kille@ Ahmet

AKILLI GİRİŞ/ÇIKIŞ OPTİMİZASYONU

-----------------------------------

Bir botun part@ komutunun hemen ardından (sonraki 50 satır içinde)

kille@ komutu geliyorsa ve arada konustur@ yoksa, bot hiç odaya

girmeden bu satırlar atlanır. Gereksiz giriş/çıkış mesajı üretilmez.

CİNSİYET VE AVATAR

-------------------

Bot ismi Türkçe kadın isim listesiyle karşılaştırılır.

Eşleşme varsa avatar kadın (pembe çerçeve), yoksa erkek (mavi

çerçeve) olarak atanır. Avatar bot/women/ veya bot/man/ klasöründen

rastgele seçilir.

AYARLAR (Admin Paneli)

-----------------------

 Durum      : Botu etkinleştirir / devre dışı bırakır.

 Varsayılan Oda : Oda belirtilmeyen komutlarda kullanılan oda ID'si.

 Tetikleme Aralığı: Kaç saniyede bir komut işleneceği (min: 2 sn).

 Döngü Modu   : Dosya bitince başa döner ve yeni rastgele

          log dosyası seçer.

 Min. Gerçek Kullanıcı: Odada bu kadar gerçek kullanıcı yoksa

          komutlar işlenmez.

KEEPALIVE (Canlı Tutma)

------------------------

Her tetiklemede odadaki tüm bot hesaplarının "last_action" zamanı

güncellenir; böylece sistem onları aktif sanır ve odadan atmaz.

ODA BOŞALMA KORUMASI

---------------------

Odada hiç gerçek kullanıcı kalmadığında tüm botlar otomatik olarak

odadan çıkarılır. Gerçek kullanıcı geldiğinde komut dosyası kaldığı

yerden devam eder.

BOT ID KAYDI

------------

Oluşturulan veya odaya giren her botun ID ve oda bilgisi:

 log_bot/system/bot_ids.json

dosyasına kaydedilir.

Format:

 [

  { "bot_id": 101, "room_id": 1 },

  { "bot_id": 102, "room_id": 1 }

 ]

================================================================

----------------------------------------------------------------

ENGLISH

----------------------------------------------------------------

WHAT IS LOG BOT?

----------------

Log Bot is an addon integrated into BoomChat/CodyChat systems.

It reads lines from a command script (loglar.txt) one by one and

automatically creates fake bot users, moves them into chat rooms,

makes them send messages, and removes them from rooms.

Its purpose is to make chat rooms appear active and lively.

HOW IT WORKS

------------

It is triggered automatically in the background every few seconds

(configurable). On each trigger, it processes the next line in the

command script and then stops. This way commands are spread over

time, simulating a real conversation flow.

Bot accounts are marked in the database with "cycle_bot = 1".

Every created bot's ID is saved to log_bot/system/bot_ids.json.

COMMAND FILE FORMAT (loglar.txt)

---------------------------------

Commands are stored in logs_part*.txt files inside the loglar/ folder.

Lines starting with "#" are comments and are ignored.

 olustur@ BOTNAME

   → Creates a bot account with the given username.

    If the account already exists, it is updated, not duplicated.

 part@ BOTNAME [ROOM_ID | #RoomName]

   → Moves the bot into the specified room and broadcasts a

    join message. If no room is specified, the default room is

    used. If the bot does not exist yet, it is created first.

 konustur@ BOTNAME [#RoomName] @x MESSAGE x@

   → Makes the bot send a message in the specified room.

    If the bot is not in that room, it joins first.

    Message block format: @x ... x@

    Simple format: konustur@ BOTNAME MESSAGE

 kille@ BOTNAME

   → Removes the bot from its current room.

EXAMPLE COMMAND FILE

---------------------

 olustur@ Alice

 part@ Alice 1

 konustur@ Alice @x Hello everyone! x@

 konustur@ Alice @x The weather is great today :) x@

 kille@ Alice

SMART JOIN/LEAVE OPTIMIZATION

-------------------------------

If a bot's part@ command is immediately followed (within the next

50 lines) by a kille@ command with no konustur@ in between, the bot

never actually enters the room — those lines are skipped entirely.

This avoids generating unnecessary join/leave messages.

GENDER AND AVATAR

-----------------

The bot's username is compared against a Turkish female name list.

If matched, the avatar is female (pink border); otherwise male

(blue border). The avatar is randomly selected from the bot/women/

or bot/man/ folder.

SETTINGS (Admin Panel)

-----------------------

 Status       : Enables / disables the bot.

 Default Room    : Room ID used when no room is specified in a command.

 Trigger Interval  : How often (in seconds) a command is processed (min: 2s).

 Loop Mode      : When the file ends, resets to the beginning and

            picks a new random log file.

 Min. Real Users   : Commands are not processed unless this many real

            users are present in the room.

KEEPALIVE

----------

On every trigger, the "last_action" timestamp of all bot accounts

currently in the room is refreshed, so the system considers them

active and does not remove them.

EMPTY ROOM PROTECTION

----------------------

When no real users remain in the room, all bots are automatically

removed. When a real user returns, the command script continues

from where it left off.

BOT ID STORAGE

--------------

The ID and room information of every bot that is created or joins

a room is saved to:

 log_bot/system/bot_ids.json

Format:

 [

  { "bot_id": 101, "room_id": 1 },

  { "bot_id": 102, "room_id": 1 }

 ]

================================================================