RookHelm eklentisini kurun

Bu kılavuz, bir Source 1 oyun sunucusunu RookHelm’e bağlama sürecinde size yol gösterir. En hızlı yol, panelinizdeki eklenti paketi: tek indirme, yerine bırakın, yeniden başlatın ve sunucuyu tek tıkla sahiplenin. Yapılandırma düzenlemek yok.

Desteklenen oyunlar

RookHelm, SourceMod çalıştıran her Source 1 oyunu için tek bir eklenti paketi sunar. Destek oyun bazlı bir izin listesinden değil, SourceMod’dan gelir: oyununuz SourceMod 1.12 çalıştırıyorsa eklenti yüklenir ve aynı şekilde çalışır.

Oyun	Motor	Durum
Team Fortress 2	Source	Destekleniyor
Counter-Strike: Source	Source	Destekleniyor
Day of Defeat: Source	Source	Destekleniyor
Left 4 Dead 2	Source	Destekleniyor
Half-Life 2: Deathmatch	Source	Destekleniyor
SourceMod çalıştıran diğer tüm oyunlar	Source	Destekleniyor
Garry’s Mod	Source	Henüz desteklenmiyor
Counter-Strike 2	Source 2	Henüz desteklenmiyor

Garry’s Mod stok SourceMod çalıştırmaz, bu yüzden özel destek gerektirir - planlanıyor ancak henüz mevcut değil.

Burada listelenmeyen bir oyun için destek mi istiyorsunuz? [email protected] adresine e-posta gönderin - istekler bundan sonra neyi destekleyeceğimizi belirler.

Başlamadan önce

Şunlara ihtiyacınız var:

• addons/sourcemod/ konumunda kurulu SourceMod 1.12 (kararlı).
• Oyun sunucunuzun dosyalarına erişim (FTP, SSH veya barındırma sağlayıcınızın dosya yöneticisi).
• Bir RookHelm topluluğunda admin koltuğu - eklenti paketi panelinizin Servers (sunucular) sayfasında bulunur. (Henüz topluluğunuz yok mu? Erişim isteyin.)

SourceMod 1.13 is not yet supported

RookHelm şu anda SourceMod 1.12 için derlenmiş tek bir uzantı sunar. SourceMod 1.13 (master/geliştirme derlemeleri) yeni ve uyumsuz bir uzantı ABI’si getirdi; bu yüzden mevcut RookHelm uzantısı orada yüklenmez - sunucu günlüğünüzde Extension version is too old to load görürsünüz. Bir 1.13 derlemesi yayınlanana kadar SourceMod’un (ve Metamod:Source’un) kararlı 1.12 dalını çalıştırın. Bununla karşılaşırsanız Sorun giderme sayfasına bakın.

REST in Pawn’u veya başka bir uzantıyı ayrıca kurmanıza gerek yok - RookHelm uzantısı pakete dahildir. Sunucu başına kimlik bilgilerini de elle kopyalamazsınız; sunucuyu sahiplendiğinizde anahtarını otomatik olarak alır.

Adım 1 - Eklenti paketini indirin

Servers sayfasında Download plugin bundle (eklenti paketini indir) düğmesine tıklayın. Bu size şunları içeren rookhelm-sourcemod-<community>.zip dosyasını verir:

• RookHelm SourceMod uzantısı ve ona eşlik eden eklenti.
• Topluluğunuzun iki ayarıyla (rookhelm_api_url ve rookhelm_enrollment_token) önceden doldurulmuş cfg/sourcemod/rookhelm.cfg.
• README.txt ve lisans metinleri.

Kayıt token’ı topluluğunuzdaki her sunucu için aynıdır; dolayısıyla aynı paket tüm filonuzda çalışır. Yeniden indirmek güvenlidir - token’ınızı değiştirmez.

Not

Paket, topluluk kayıt token’ınızı içerir. Token’a sahip olmak bir sunucunun yalnızca kendini bekleyenler listenize duyurmasını sağlar - siz sunucuyu açıkça sahiplenene kadar banlara, susturmalara veya herhangi bir topluluk verisine erişim vermez. Yine de zip dosyasına kimlik bilgisi içeren herhangi bir yapılandırma gibi davranın: herkese açık paylaşmayın.

Adım 2 - Yerine bırakın ve yeniden başlatın

Zip’i, addons/ ve cfg/ klasörleri mevcut kurulumunuzla birleşecek şekilde oyununuzun mod dizinine çıkarın:

unzip rookhelm-sourcemod-*.zip -d /path/to/srcds/

Ardından sunucuyu yeniden başlatın. Açılışta eklenti, paketle gelen cfg/sourcemod/rookhelm.cfg dosyasını otomatik yükler, iki ayarı okur, RookHelm’e bir bağlantı açar ve kendini duyurur.

Not

Düzenlenecek bir şey yok. Paket, cfg/sourcemod/rookhelm.cfg içindeki iki ayarı önceden doldurur ve eklenti bu dosyayı başlangıçta yükler; böylece server.cfg dosyasına hiçbir satır eklemez, hiçbir kimlik bilgisini elle kopyalamazsınız.

Adım 3 - Sunucuyu sahiplenin

Servers sayfasına döndüğünüzde sunucu, kendi bildirdiği ad ve adresle yaklaşık bir dakika içinde Pending servers (bekleyen sunucular) altında görünür. Adopt (sahiplen) düğmesine tıklayın. Sahiplenme, sunucunun imzalama anahtarını üretir ve sunucuya otomatik iletir - kopyalanacak bir şey yok.

Yepyeni bir topluluktaki ilk sunucu dahil her sunucu, açık bir sahiplenme tıklaması bekler. Bu bilinçli bir tercih: siz sizin olduğunu doğrulayana kadar bir sunucu yetkisizdir.

Başarı neye benzer

Sahiplenildikten sonra, genellikle birkaç saniye içinde ilk kalp atışı ulaştığında sunucunun durumu Online (çevrimiçi) olur. O andan itibaren banlar, susturmalar ve oyuncu sayıları panelinize akmaya başlar.

İndirmeyi panelden başlattıysanız Servers sayfasındaki kurulum kartı kendi kendine ilerler - kurulum adımlarından, bekleyen satır göründüğünde “Server detected” (sunucu algılandı) durumuna, sahiplenilen sunucu rapor verdiğinde “Heartbeat received. Plugin installed” (kalp atışı alındı, eklenti kuruldu) durumuna.

İndirmeyi doğrulayın (isteğe bağlı)

Her sürüm bir SHA256SUMS dosyasıyla gelir. Paketin bozulmadan aktarıldığını doğrulamak için:

sha256sum -c SHA256SUMS
# Expected: "rookhelm-sourcemod-v<version>.zip: OK"

Yayınlanan ikili dosyalar RookHelm sürüm hattı tarafından üretilir. Uzantı, GPL-3.0 ve tescilli kodu bir araya getirir; paketin içindeki NOTICE.txt, GPL-3.0 bölümünün kaynak kodunu nasıl talep edeceğinizi açıklar.

Elle yapılandırın (ileri düzey)

Paketi kullanmak yerine yapılandırmaları kendiniz yönetiyorsanız yalnızca iki ayara ihtiyacınız var. İkisini de Servers sayfasından kopyalayın ve sunucunun başlangıçta çalıştırdığı bir yapılandırmaya, örneğin cfg/server.cfg dosyasına ekleyin:

rookhelm_api_url           "https://api.rookhelm.com"
rookhelm_enrollment_token  "your-community-enrollment-token"

Eklentinin bunları okuması için sunucuyu yeniden başlatın (veya haritayı değiştirin), ardından sunucuyu Adım 3’teki gibi sahiplenin. Bu şekilde ayarladığınız değerler güvendedir: eklenti, cfg/sourcemod/rookhelm.cfg dosyasını yalnızca mevcutsa otomatik yükler (bu dosya yalnızca panel paketiyle gelir); dolayısıyla elle yapılan bir server.cfg kurulumunun üzerine asla yazılmaz.

ConVar	Açıklama
rookhelm_api_url	RookHelm bağlantı uç noktasının temel URL’si. Panel paketi bunu önceden doldurur.
rookhelm_enrollment_token	Topluluk kayıt token’ınız - tek değer, her sunucuda aynı, bir kez yapıştırılır. Panel paketi bunu önceden doldurur.

Her iki ConVar da FCVAR_PROTECTED olduğundan değerleri cvarlist çıktısında gizli kalır ve sohbetten okunamaz. Sunucu başına imzalama anahtarı asla bir ConVar değildir - sunucu, siz sahiplendiğinizde anahtarı kendisi alır ve saklar.

Kimlik bilgilerini yenileme

• Kayıt token’ı: sızarsa panelden yenileyin. Halihazırda sahiplenilmiş sunucular çalışmaya devam eder - sunucu başına anahtarları kayıt token’ından bağımsızdır. Henüz sahiplenilmemiş sunucular yeni bir pakete ihtiyaç duyar.
• Bir sunucunun imzalama anahtarı: bir sunucunun anahtarı kaybolur veya ele geçirilirse sunucunun sayfasındaki Reissue keys (anahtarları yeniden ver) seçeneğini kullanın. Yeni anahtar, sunucunun bir sonraki yeniden bağlanışında iletilir; asla elle kopyalamazsınız.

---

Daha fazla yardım mı gerekiyor?

Bir sunucu yeniden başlatmadan sonra bekleyenlerde görünmüyorsa veya sahiplendikten sonra çevrimiçi olmuyorsa Sorun giderme sayfasına bakın.

Erişim isteyin