Metin2 Player Bot Sistemi

[Cynex™]

Metin2 Player Bot Sistemi
Açık kaynak (MIT) • Windows & Linux • Docker ile kurulum • Tanıtım + Kurulum Rehberi​

---

Nedir?
Oyun dünyasını gerçek oyuncu gibi davranan otonom botlarla dolduran bir sunucu sistemidir. Botlar kendi başlarına kasar, parti kurar, metin keser, demircide item basar, pazar kurar ve birbirinden alışveriş yapar. Tüm gelişimleri veritabanına kaydedilir.

En önemli fark: Bu bir istemci botu, makro ya da hile değildir. Botlar doğrudan game core'un içinde çalışan tam teşekküllü karakterlerdir (PC). Siz oyuna girdiğinizde onları normal oyuncu gibi görürsünüz: yürüyüşleri, kombo animasyonları, skill'leri, ekipmanları gerçektir.

• Lisans: MIT. Kullanımı ve değiştirilmesi serbesttir, telif bilgisi korunmalıdır.
• Boyut: Yaklaşık 48.000 satır C++ bot kodu + 16 motor yaması
• Durum: Aktif geliştiriliyor, sık güncelleme alıyor
• Amaç: Tek oyunculu (singleplayer) veya küçük özel sunucuda "yaşayan dünya"

---

Botların Yapabildikleri

Spoyler: Savaş

• Tüm sınıflar: Savaşçı, Sura (Büyü/Silah), Ninja (Hançer/Okçu), Şaman
• Kombo animasyonları, ok tüketen yay atışları, buff yönetimi, skill döngüsü
• 2-3 kişilik partiler, Ork Vadisi kamplarında 8 kişiye kadar grup
• Metin avcıları: haritada dolaşıp taş kesen özel botlar
• Boss baskınları: Ork Reisi, Örümcek Kraliçe vb. Lonca üyeleri birbirini çağırır.
• Lonca savaşları, düello, Şeytan Kulesi

Spoyler: Dünya ve Hareket

• Haritanın kendi server_attr dosyasından üretilen A* yol bulma
• M1 ↔ M2 ↔ M3, Maymun Zindanı, Ork Vadisi, Yongbi Çölü, Sohan Dağı, Hwang Tapınağı, Örümcek Zindanı
• Üç krallık: Shinsoo, Chunjo ve Jinno. Her bot kendi krallığında yaşar.
• Uzun yolda ata binme, ışınlanma yüzüğü ile köye dönüş

Spoyler: Ekonomi ve Gelişim

• Demircide yükseltme (+6 ve üzeri), Kutsama Kâğıdı kullanımı
• Efsun değiştirme/ekleme taşları
• Pazar tezgâhı ve botlar arası ticaret: eksik malzemeyi ya da daha iyi ekipmanı birbirinden satın alırlar.
• +7 ve üzeri eşya asla NPC'ye satılmaz.
• At madalyası seferleri, at seviyesi, savaş atı sınavı
• Biyolog görevleri, balıkçılık, beceri kitabı okuma
• Her botun bir kişiliği var: metin avcısı, koleksiyoncu, at yetiştiricisi, tüccar...

Spoyler: Yönetim Panelleri

• Klasik yönetim paneli (127.0.0.1:7788): bot hedef ağırlıkları, sandık şansı, rate ayarları
• Singleplayer Panel (127.0.0.1:7790): canlı dünya haritası, bot profilleri ve envanterleri, sıralamalar, ekonomi geçmişi, toplu item verme
• Ayarlar yeniden başlatma gerekmeden 5 saniye içinde oyuna yansır.

---

Sistem Gereksinimleri

İşletim Sistemi	Windows 10/11 (Docker Desktop + WSL2) veya Linux (Ubuntu/Debian + Docker)
İşlemci	x86-64 (Intel/AMD)
RAM	En az 8 GB, 350+ bot için 16 GB önerilir
Disk	25-40 GB boş alan
İstemci	Sunucu dosyalarıyla uyumlu, Windows'ta çalışan bir istemci

Ölçülen kaynak kullanımı (843 bot açıkken):

• Game core: ~1.8 GB RAM, tek çekirdeğin %25-38'i
• MariaDB: ~89 MB RAM
• Paneller: ~270 MB RAM

---

Önemli: Oyun Dosyaları Pakete Dahil Değil
Proje sadece bot sistemini, yamaları, kurulum betiklerini ve Docker yapılandırmasını içerir. Sunucu ve istemci dosyalarını kendiniz sağlamalısınız.

• Gerekli olan: uyumlu bir r40250 sunucu arşivi (metin2_server+src.tar.gz ve metin2_mysql_dump.zip içeren)
• İsteğe bağlı: aynı sürüme ait bir Windows istemci arşivi (zaten ayarlı istemciniz varsa gerekmez)

Kurulumun temel aldığı sunucu arşivinin SHA-256 değeri:

6e9e7339935058f73fead81e609219b496adbc867dfeca70f633031730313001

Kendi arşivinizi PowerShell'de şu komutla kontrol edebilirsiniz:

Get-FileHash .\metin2_server+src.tar.gz -Algorithm SHA256

Not: "r40250" etiketi taşıyan her istemci uyumlu değildir. Paket protokolü, item_proto/mob_proto ve dil dosyaları sunucuyla eşleşmelidir. En güvenlisi sunucuyla aynı sürümden bir istemci kullanmaktır.

---

Kurulum – Windows 10/11 (Önerilen)

1)

Linkleri görebilmek için Turkmmo Forumuna ÜYE olmanız gerekmektedir.

'ı kurun ve kurulumda WSL2 backend seçeneğini açın.

2) Docker Desktop'ı başlatın ve durum çubuğunda Engine running yazana kadar bekleyin.

3)

Linkleri görebilmek için Turkmmo Forumuna ÜYE olmanız gerekmektedir.

kurulu değilse kurun.

4) PowerShell'i açın ve projeyi indirin:

git clone https://github.com/TieruYT/metin2-playerbots.git
Set-Location .\metin2-playerbots

5) Kurulum betiğini kendi dosya yollarınızla çalıştırın:

& .\installer\install.ps1 `
    -Archive 'C:\Metin2Files\Reference_Server.zip' `
    -ClientArchive 'C:\Metin2Files\Reference_Client.zip' `
    -NoWebClient

Zaten ayarlı bir istemciniz varsa, istemci hazırlanmadan kurulum yapmak için:

& .\installer\install.ps1 `
    -Archive 'C:\Metin2Files\Reference_Server.zip' `
    -NoClient -NoWebClient

Arşivi önceden çıkardıysanız -Archive yerine -ReferenceDir 'C:\yol\[40250] Reference Serverfile' kullanabilirsiniz.

Kurulum betiği şunları otomatik yapar:

• Docker Compose yapısını kurar.
• Bot sistemi entegre edilmiş game core imajını derler.
• Tüm servisleri güvenli şekilde sadece 127.0.0.1 üzerinden açar.

6) Sunucuyu başlatın:

Set-Location "$env:USERPROFILE\Metin2Server"
docker compose up -d

Daha kolay yol – Launcher: Proje klasöründeki Metin2-Launcher-GUI.bat dosyasını çalıştırın ve Zainstaluj / przygotuj (Kur / Hazırla) butonuna basın. Launcher Docker'ı kendisi başlatır, tek Graj (Oyna) butonuyla sunucuyu ve istemciyi açar. Güncellemeleri de veritabanına dokunmadan yükler.

---

Kurulum – Linux (Ubuntu/Debian)

git clone https://github.com/TieruYT/metin2-playerbots.git
cd metin2-playerbots
sudo sh ./installer/install.sh --local \
  --archive '/yol/Reference_Server.zip' \
  --no-client --no-web-client

--local parametresi servisleri sadece 127.0.0.1'e bağlar ve dışarıya port açmaz.

---

Oyuna Giriş
İstemcinizin sunucu adresini şu şekilde ayarlayın:

IP	127.0.0.1
Auth Port	11000
Game Portları	13000 – 13002

Oyuna girdiğinizde sizi botlarla dolu bir oyun karşılar.

Paneller:

• Klasik yönetim paneli: http://127.0.0.1:7788
• Singleplayer Panel (canlı harita): http://127.0.0.1:7790

---

Ayarlar (.env)
Ayar dosyasının konumu:

• Windows: %USERPROFILE%\Metin2Server\.env
• Linux: /opt/metin2/stack/.env

# Sunucu açılışında otomatik doğacak bot sayısı
PLAYERBOT_AUTOSPAWN_COUNT=350

# Auth portu
M2_AUTH_PORT=11000

# CH1 game port aralığı
M2_GAME_PORT_RANGE=13000-13002

# Yönetim paneli portu
M2_PANEL_PUBLIC_PORT=7788

# Maksimum karakter seviyesi
M2_MAX_LEVEL=120

# Sunucunun gönderdiği canavar/item/görev metinlerinin dili
M2_DEFAULT_GAME_LANGUAGE=en

.env dosyasını değiştirdikten sonra game container'ını yeniden başlatın.

---

Oyun İçi Komutlar (GM)

Komut	Yetki	Açıklama	Örnek
/bot_spawn <id> <krallık>	GM	Belirli bir botu doğurur (1=Shinsoo, 2=Chunjo, 3=Jinno)	/bot_spawn 4 2
/bot_despawn <id>	GM	Botu oyundan çıkarır	/bot_despawn 4
/bot_spawn_many <başlangıç> <adet> <krallık>	GM	Toplu bot doğurur	/bot_spawn_many 4 350 2
/bot_despawn_many <başlangıç> <adet>	GM	Toplu bot çıkarır	/bot_despawn_many 4 350
/bot_rank	Herkes	En yüksek seviyeli botları ve konumlarını gösterir	/bot_rank

---

Sık Karşılaşılan Sorunlar

Spoyler: Kurulum 'compatibility' hatası veriyor

Sunucu arşiviniz temel alınan sürümden farklı olabilir. Yukarıdaki SHA-256 değerini kontrol edin. Farklı bir sürümse kurulum betiği C:\Metin2Server\diagnostics\compatibility-report.txt dosyasına bir rapor yazar.

Spoyler: Oyuna giriyorum ama karakterler/itemler bozuk görünüyor

İstemciniz sunucuyla uyumsuzdur. item_proto, mob_proto ve paket yapısı sunucuyla eşleşmelidir. Sunucuyla aynı sürümden bir istemci kullanın.

Spoyler: İstediğim kadar bot doğmuyor

PLAYERBOT_AUTOSPAWN_COUNT bir istektir. Asıl sınır, veritabanında hazırlanmış bot kimliklerinin sayısıdır. Sunucu açılışındaki şu log satırlarına bakın:

PLAYERBOT_AUTH: loaded 511 registered bot identities
PLAYERBOT: autospawn requested=750 registered_started=511

Spoyler: Port zaten kullanımda hatası

Bilgisayarınızda başka bir Metin2 kurulumu veya eski bir Docker projesi aynı portları tutuyor olabilir (11000, 13000-13002, 7788, 7790, 3306). Eski container'ları Docker Desktop'tan durdurun.

Spoyler: Kanal FULL görünüyor

Botlar kullanıcı sayısına dahil edildiği için kanal dolu görünebilir. Projenin güncel sürümünde bu düzeltilmiştir, botlar kanal doluluk hesabına katılmaz. Güncel sürümü kullandığınızdan emin olun.

---

Kendi Sunucu Kaynağınıza Port Etmek İsteyenler İçin
Sistem hazır kurulum olarak r40250/mt2009 dosyalarıyla çalışır. Farklı bir kaynağa taşımak isterseniz bilmeniz gerekenler:

• Bot kodu linux-port/overlays/playerbot/src/game/src/ altındadır. Motor değişiklikleri patches/ klasöründeki yamalardır.
• Tüm bot dosyaları tek bir çeviri birimine sırayla include edilir. Sıra, bağımlılık sırasıdır.
• 32 bit derleme (-m32) zorunludur.
• Yamaları kendi kaynağınıza elle uyarlamanız gerekir. Bu ciddi ve uzun bir iştir.

---

İndirme

Linkleri görebilmek için Turkmmo Forumuna ÜYE olmanız gerekmektedir.

​

Bu konu bir tanıtım ve Türkçe kurulum rehberidir. Proje MIT lisanslıdır, tüm hakları sahiplerine aittir.

 

[-TuRKuaZ-]

paylaşım için teşekkürler.Deneyip Ekran görüntüsü Atacağım..Kanıt olarak ekleriz

 

[Aliyldrim]

Abi elline koluna sağlık legal ticarette yapıyormu bari :

 

[Cynex™]

Abi elline koluna sağlık legal ticarette yapıyormu bari :

Neden Olmasın

 

[Aliyldrim]

Neden Olmasın

kendin pişir kendin ye botlarım legale açılın ve efendinizi zengin edin