Gereksinimler

• FS25 dedicated sunucu: bir hosterde ya da kendi makinende. Oyun klasörüne (içinde mods ve savegame1 olan klasör) FTP ile erişebilmelisin. FTP ve FTPS (TLS) desteklenir; SFTP desteklenmez. Denenmiş hoster: VeryGames; FTP veren her hoster çalışır.
• Discord sunucusu: senin Yönetici ya da Sunucuyu yönet iznin olmalı. Bot bu sunucuya davet edilir.
• FS25_DiscordBridge modu: ana sayfadan indir, sunucunun mods klasörüne koy. Mod yalnızca sunucuda çalışır; oyuncuların kurması gerekmez (sunucu modu zaten dağıtır).
• Ücretsiz plan: sahip başına 1 sunucu, oyuncuların mod indirmesi günde 4 GB, 512 MB mod önbelleği, son 12 savegame yedeği.

Kurulum

Süre: yaklaşık 10 dakika · Sihirbaz: giriş yaptıktan sonra Sunucu ekle

1. Modu sunucuya yükle ve sunucuyu yeniden başlat. Hoster panelinden ya da FTP ile mods/FS25_DiscordBridge.zip dosyasını koy, sunucuyu bir kez yeniden başlat. Mod ilk çalışmada modSettings/FS25_DiscordBridge/state.json dosyasını yazar; sihirbaz bu dosyayı arar. Mod çalışmadan sihirbaz Devam'a izin vermez.
2. Discord ile giriş yap, "Sunucu ekle"ye bas. Yönettiğin Discord sunucuları listelenir (giriş anında alınır; sunucun yoksa çıkış yapıp yeniden gir). Sunucuyu seç, bot dilini seç (komutlar, panolar ve uyarılar bu dilde olur) ve bot henüz yoksa botu sunucuna ekle. Davet bağlantısı yalnızca gereken izinleri ister: kanalı görüntüle, mesaj gönder, bağlantı göm, dosya ekle (fatura resmi), mesaj geçmişi. Rehber mesajını sabitlemek istersen bot rolüne ayrıca Mesajları yönet ver.
3. FTP bilgilerini gir ve "Bağlantıyı sına". Host, port (genelde 21), kullanıcı, şifre, mod klasörü (/modSettings/FS25_DiscordBridge) ve savegame klasörü (savegame1; hosterde hangi kayıt yuvasını kullandığına bak). Şifre AES-256 ile şifrelenir, hiçbir ekranda görünmez. Sınama sonuçları:

   Sonuç	Anlamı	Ne yapmalı
   Kullanıcı adı ya da şifre yanlış	FTP sunucusu girişi reddetti	Hoster panelindeki FTP bilgilerini yeniden kopyala; şifreyi sıfırla
   Sunucuya ulaşılamıyor	Adres/port yanlış, FTP kapalı ya da güvenlik duvarı	Host'ta ftp:// yazma; portu kontrol et; hoster FTP'yi açık mı
   Veri kanalı açılamadı (pasif mod)	Bağlantı var ama listeleme zaman aşımı	Hosterin pasif port aralığını açması gerekir; FTPS'yi açıp kapatmayı dene
   Mod klasörü yok	Mod hiç çalışmamış ya da FTP kökü farklı	Kök, içinde mods ve savegame1 olan klasör olmalı; mod yüklü mü, sunucu yeniden başlatıldı mı
   Klasör var ama mod çalışmamış	state.json yok	Sunucuyu modla bir kez başlat, sonra tekrar sına
   savegameN klasörü yok	Yanlış kayıt yuvası	Hosterde etkin yuvanın adını yaz (savegame1..99). Yedek ve geri yükleme bu klasöre bağlıdır

   Devam yalnız bağlantı + mod klasörü + çalışan mod varsa açılır; bir alanı değiştirirsen yeniden sınaman istenir.
4. Kanalları seç. Hepsi isteğe bağlı; boş bırakılan bölüm Discord'a yazmaz. Önerilen düzen aşağıda. Seçtiğin kanallarda botun izni eksikse kurulum "botun kanal izni eksik: #kanal (Dosya ekle)" diye durur: Discord'da kanal ayarlarından bot rolüne izni ver, tekrar dene.
5. Admin rollerini, sunucu adını ve kısa kimliği gir, "Kur ve başlat". Admin rolündekiler panoda her şeyi görür ve komut verebilir; sen sahip olarak her zaman adminsin. Kısa kimlik dosya adı olarak kullanılır, sonradan değişmez. Köprü hemen yoklamaya başlar.

Kanallar ve roller

Önerilen kanal düzeni

Bot izinleri

Her seçilen kanalda bot şunlara sahip olmalı: Kanalı görüntüle, Mesaj gönder, Bağlantı göm, Dosya ekle. Sihirbaz ve ayar kaydı bunu denetler. Sabitleme için Mesajları yönet, slash komutlarının görünmesi için sunucuda Uygulama komutlarını kullan açık olmalı (varsayılan açık).

Oyuncu erişimi

Ayarlar › Erişim: hangi Discord rolü panoda hangi sekmeyi görür, hangi komutları verebilir. Admin rolü her şeyi görür; "moderatör" kademesi seçtiğin komutlara açılır; sıradan oyuncu yalnız kendi çiftliğini görür. Rolü panoya açılmamış oyuncu girişte "erişimin yok" uyarısı alır ve sana yönlendirilir.

İlk veri kontrol listesi

Kurulumdan sonra pano, ilk anlık görüntü gelene kadar üç satırlık bir kontrol listesi gösterir:

• FTP bağlantısı ve mod klasörü: bağlandı ise FTP çalışıyor. bağlanamıyor ise hata metni (yalnız yönetici görür) ve Ayarlar › FTP › Bağlantıyı sına bağlantısı çıkar.
• Sunucuda mod sürümü: modun yazdığı ilk veriyle dolar.
• Olay akışı: ilk olaylar (oyuncu girişi, kayıt) gelince dolar.

"Bağlantı iyi ama veri yok" uyarısı iki dakika sonra çıkar: mod sunucuda çalışmıyor demektir (zip mods klasöründe değil ya da sunucu modla başlatılmadı). Bağlantı 10 dakika boyunca başarısız olursa köprü seni Discord'da uyarır (kural: Sistem › Köprü bağlantısı), altı saatte bir tekrarlar ve bağlantı dönünce "geri geldi" der.

Oyuncular

• Çiftlik bağlama: oyuncu panelden ya da Discord'da /bagla ile tek kullanımlık kod alır, oyunda sohbete yazar. Bundan sonra panelde ve Discord'da kendi çiftliğinin verisini görür, faturayı kendi çiftliği adına keser, kişisel bildirim alır. Kod 15 dakikada geçersiz olur; bağlantıyı oyuncu da yönetici de kaldırabilir. Harita ya da kayıt değişince köprü eski kaydın geçmişini arşivleyip sıfırdan başlar ve bağlantılar kalkar; oyuncular yeni kayıtta yeniden bağlanır. Aynı haritada yeni oyun açtıysan Ayarlar › Genel › Kayıt'tan "Yeni kayıt başlat".
• Kişisel bildirimler: /bildirim ile oyuncu hangi uyarıların özelden geleceğini seçer (tarla hazır, kontrat süresi, fatura).
• Faturalar: panelde Faturalar sekmesi; oyuncular arası kayıt belgesi, oyunda para aktarmaz. Oyuncu Pazarı modu kuruluysa pazar faturaları aynı listeye düşer.
• Komutlar: /sunucu, /ciftlik, /tarlalar, /araclar, /fiyat, /modlar… Yönetici: duyuru, kaydet, para, zaman, oyuncu atma. Aynı komutlar panelde Komut sekmesine yazılarak da verilir (/para BOSS 250k); Geçmiş listesinde Discord'dan verilenler de görünür. Hangi komutun kime açık olduğu Ayarlar › Komutlar'da.

Mod eşitleme ve Launcher

Oyuncu sunucuya girebilmek için sunucudaki modların aynısını kendi mods klasöründe bulundurmalı. Köprü bunu iki yolla çözer:

• Dostlar Launcher (önerilen): oyuncu Windows uygulamasını indirir, Discord ile girer, sunucuyu seçer, Eşitle der; eksik ve eski modlar klasörüne iner, Oyna oyunu sunucuya bağlanacak şekilde açar.
• Tarayıcı: panelde Modlar sekmesi, "Mods klasörümü seç", Eşitle (Chrome / Edge). Tek tek indirme her tarayıcıda çalışır.

Rehber mesajı

Ayarlar › Uyarılar › Rehberi kanala gönder: mod paylaşım kanalına adım adım anlatım ve düğmeler (Launcher indir, Modları eşitle, Panoyu aç) gider; varsayılan metin Launcher'ı önce anlatır. İçeriğin tamamı düzenlenebilir (başlık, bölümler, renk, küçük resim, alt yazı); yer tutucular {server} {mods} {size} {url} {panel} {launcher} kendiliğinden dolar. "Sabitle" açıksa bot mesajı kanala sabitler. Sunucu satın alınan eklenti (DLC) kullanıyorsa "Gerekli DLC'ler" bölümü otomatik eklenir: köprü DLC dağıtamaz, oyuncunun hesabında kurulu olmalı. Oyun sunucusu her başladığında sayılar sessizce tazelenir.

Yeni mod duyurusu

Kural Yeni / güncellenen mod: sunucuya mod eklenince, bir mod güncellenince ya da kaldırılınca kanala duyuru düşer (her modun kendi indirme bağlantısı; uzun liste birden çok mesaja bölünür). Güncelleme, dosya boyutu veya zip'in içindeki modDesc sürümü değişince anlaşılır. Kontrol oyun sunucusu her başladığında ve altı saatte bir yapılır.

Dosya adları

Mod zip adında harf, rakam, boşluk, alt çizgi, tire, nokta, parantez ve + geçebilir; .ZIP büyük harf olabilir. Buna uymayan dosyalar oyun tarafından da yüklenmez; panelde yöneticiye "Atlanan dosyalar" kartında gösterilir, adı düzeltmen yeterli.

Modüller: Kontrat, Palet Deposu, Pazar, Teşhis

Köprü tek başına çalışır. Dostlar STUDIO'nun diğer modları sunucuda köprüyle birlikte çalışınca panoda ilgili sekme ve Discord'da ilgili komut/uyarılar kendiliğinden açılır; ek ayar gerekmez. Kontrat Yöneticisi ve Palet Deposu hazır; Pazar ve Teşhis geliştirmede, yayınlanınca burada. Üçüncü parti modlar modül değildir, yalnız mod listesinde görünür.

Kurulum: zip'i sunucunun mods klasörüne koy ve sunucuyu yeniden başlat; köprüde paket varsa Ayarlar › Modüller'den tek tıkla sunucuya kurulur (durum: çalışıyor / kurulu ama yeniden başlatılmadı / yok). Bir modülü kapatırsan sekmesi gizlenir ve uyarıları susar. Modlar ve sürüm notları: studio.dostlarkonagi.com.

Uyarılar ve yedekler

• Kurallar (Ayarlar › Uyarılar): sunucu düştü / kalktı, kayıt alındı, mod hatası (log izleme sorumlu modu söyler), tarla hasata hazır, araç yakıtsız/hasarlı, hayvan açlığı, üretim durdu, fiyat zirvesi, kontrat, pazar, fatura, köprü bağlantısı. Her kuralın kanalı ve eşiği ayrı; bölümü kapatınca kuralları da susar.
• Savegame yedeği: her oyun kaydından sonra kayıt klasörü zip olarak alınır (yaklaşık 7 MB), son 12 kopya saklanır. Ayarlar › Yedekler'den indir ya da geri yükle. Geri yükleme sunucudaki kayıt dosyalarının üzerine yazar: önce sunucuyu durdur, işlemi başlatan yönetici sonuçtan sorumludur.
• Köprü bakımı: köprü kısa süre durursa mesajlar birikmez, veri yeniden bağlanınca tazelenir. Bakım duyuruları Dostlar Discord'unda yapılır.

Sorun giderme

Çözülmezse Dostlar Discord'una yaz; sunucu kısa kimliğini ve hatanın saatini ekle.

Sınırlar ve kaldırma

• Ücretsiz plan: sahip başına 1 sunucu, mod indirme 4 GB/gün, 512 MB önbellek, 12 savegame yedeği, olaylar 30 gün, bakiye/fiyat geçmişi 60 gün.
• Duraklat (Ayarlar › Sunucu): veri yenilenmez, bot komutları kapanır; istediğin an sürdür.
• Kaldır: yalnız sunucuyu kaydeden sahip (ya da operatör) yapabilir; onay için kısa kimlik yazılır. Veri 30 gün kenarda tutulur, sonra silinir; aynı kısa kimlik bir daha verilmez. FTP şifresi hemen silinir.
• Sahiplik: kaydı açan Discord hesabı değiştirilemez; FTP değişikliği, geri yükleme ve kaldırma yalnız sahibe açıktır.
• Verilerin nasıl işlendiği: gizlilik politikası · kullanım şartları: yasal.