Kısa cevap: Bir Rust güncellemesinden sonra önce gerçekten çalışan framework'ü kontrol et. Oxide kullanıyorsan oxide.version, oxide.plugins ve başlatma günlüğü işine yarar. Yalnızca tek bir eklenti eksikse derleyici hatası, eksik bağımlılık ve yapılandırma hatasını birbirinden ayır. Eklentilerin yüklenmiş olması, framework hatasını dışlamaz. Herhangi bir değişiklikten önce dosyalarını ve oyun kaydını yedekle; wipe yapmak veya tüm config dosyalarını silmek mantıklı bir ilk teşhis adımı değildir.
Bu rehber, kendin barındırdığın ya da herhangi bir sağlayıcıda çalışan PC sürümü Rust Dedicated Server sunucuları için geçerlidir. Yönetim adımları için gerçek sunucu konsoluna veya yetkili RCON erişimine, gerekirse de sunucu dosyalarına erişimin olmalı. SupremeTier müşteri hesabı gerekmez. Etkilenen sunucuda yalnızca oyuncuysan bir sonraki bölümle başla.
Güncelleme tarihi: 6 Kasım 2026; kendi hata testlerimiz: 29 Ekim 2026. Ana akıştaki komutlar Oxide içindir. Carbon ayrıca ele alınmıştır. “Tek bir eklenti derlenmiyor” ve “bağımlılık eksik” hata senaryoları, kendi izole test sunucumuzda kontrollü olarak tetiklenip onarıldı. Bu testler hata durumlarını simüle eder; güncellemeden sonra arızalanan üçüncü taraf bir eklentinin gözlemi değildir. Kasıtlı olarak karışık bırakılmış bir framework durumu da izole ortamda incelendi. Bu testte bir framework hook'u başarısız olurken eklentiler yüklenmeye devam etti. Aşağıdaki orijinal çıktılar kontrollü hata testlerinden alınmıştır ve bir müşteri sunucusunda doğal olarak yaşanmış bir olay gibi sunulmamaktadır.
Oyuncu olarak neler yapabilirsin?
/kit menüsünün kaybolması, envanterinin silindiğini kanıtlamaz. Belki yalnızca bu komutu sağlayan eklenti eksiktir. Önce diğer oyuncuların da aynı işlevi kullanamadığını ve birbirinden bağımsız birden fazla işlevin etkilenip etkilenmediğini sor. Zamanı, girdiğin komutu ve ekranda gördüğün yanıtı not al. Mesajın ekran görüntüsü yardımcı olur; özel oyuncu adlarını paylaşmadan önce kapatabilirsin.
Örneğin şöyle bildirebilirsin: “Saat 19:00 civarındaki yeniden başlatmadan beri kit komutum yanıt vermiyor. Işınlanma da çalışmıyor. Normal inşa etme çalışıyor. Yeniden başlatmadan önce ikisi de çalışıyordu.” Böylece yönetim ekibi ilgili başlatma kaydını hedefli şekilde arayabilir. “Her şey wipe'landı” demek ise kontrol etmeden fazla ileri gitmek olur.
Bir sunucu eklentisini onardığı iddiasıyla rastgele sunulan istemci dosyalarını yükleme. Oyuncu olarak sunucu tarafındaki framework'ü yeniden yükleyemezsin. Bu sunucuda vaat edilen PvE kuralları gibi koruma işlevleri eksikse durum netleşene kadar bunlara güvenme. Normal şekilde oynamaya devam etmenin güvenli olup olmadığına yönetim ekibi karar vermelidir.
Önce üç katmanı birbirinden ayır
Bu teşhis açısından modlu bir Rust sunucusu üç katmandan oluşur. Rust'ın kendisi oyun dünyasını ve oyun süreçlerini sağlar. Framework, yani burada Oxide veya alternatif olarak Carbon, eklentilerin çalışmasını mümkün kılar. Tekil eklentiler ise kit, ışınlanma, yönetim işlevleri veya oyun kurallarındaki değişiklikler gibi özellikleri uygular. Bazı eklentiler başka eklentilere veya extension'lara ihtiyaç duyar.
Alt katmanlardan biri eksikse üzerindeki birçok işlev aynı anda bozulmuş gibi görünür. Tek bir eklenti devre dışı kaldığında ise diğerleri çalışmaya devam edebilir. Bu ayrım bir başlangıç noktasıdır, ancak henüz kanıt değildir: Birden fazla eklenti aynı eksik kütüphaneye ihtiyaç duyuyor olabilir. Tersine, bir framework komutlara yanıt verse de belirli oyun olaylarında sorun yaşayabilir.
“Dosya mevcut”, “derlendi”, “yüklendi” ve “çalışıyor” dört farklı durumdur. Doğru klasördeki bir .cs dosyası yalnızca orada kaynak kod bulunduğunu gösterir. Derleme, bu koddan çalıştırılabilir kod üretildiği anlamına gelir. Yükleme, başlatma aşamasını da kapsar. İstenen davranışın senin ayarların ve izinlerinle gerçekten çalışıp çalışmadığını ancak hedefli bir işlev testi gösterir.
Resmi Oxide eklenti kurulumu belgeleri, .cs dosyalarını, otomatik derlemeyi ve eklenti dizinini açıklar. Bu dosya düzeyini oyunda görünen başarıyla karıştırma.
Hızlı karar yolu
Sunucu tamamen başladıktan sonra normal oyun sohbetinde değil, sunucu konsolunda başla. Bu ilk kontrol eklentilerde hiçbir değişiklik yapmaz:
oxide.version
oxide.plugins
oxide.version, framework sürümünü sorgular. oxide.plugins, başarısız yükleme denemeleri dahil eklentileri listeler. Resmi komut başvurusu eklenti listesini ve hedefli yükleme komutlarını açıklar; sunucu sahipleri için komut rehberi ise konsolu ve sohbeti anlatır.
| Gözlem | İlk çalışma hipotezi |
Sonraki kontrol |
|---|---|---|
| Oxide yanıt vermiyor, birçok işlev eksik | Framework eksik, başlamıyor veya yanlış konsol bağlamındasın |
Başlatma günlüğünü, gerçekten seçili framework'ü ve kurulumu kontrol et |
| Oxide yanıt veriyor, birkaç eklenti çalışıyor, biri başarısız | Bu eklentide veya gereksinimlerinde sorun var |
İlk tam hata mesajını ve eklenti sürümünü oku |
| Etkilenen birkaç eklenti aynı bağımlılığı belirtiyor | Ortak bağımlılık devre dışı kalmış |
Önce bu bağımlılığı incele |
| Eklenti yüklü, yalnızca bir işlev eksik | İzin, ayar, hook veya çalışma zamanı sorunu |
İlgili işlevi kontrollü koşullarda test et |
| Yeni config dosyaları, farklı dünya veya görünüşte boş veriler | Muhtemelen farklı bir sunucu örneği veya farklı bir veri yolu |
Kimliği, başlatma parametrelerini ve mount'ları önceki durumla karşılaştır |
Bilinmeyen bir komut bir ipucudur, kesin teşhis değildir. Gerçekten etkilenen sunucunun konsolunu açıp açmadığını, başlatmanın tamamlanıp tamamlanmadığını ve bu sunucunun Oxide kullanıp kullanmadığını kontrol et. Carbon kullanılıyorsa yalnızca Oxide'a özgü bir test yeterli dayanak oluşturmaz.
Her onarımdan önce: Kanıtları ve geri dönüş yolunu güvenceye al
İyi bir teşhis kısa bir durum tespitiyle başlar. Hatanın ilk ne zaman fark edildiğini, öncesinde hangi oyun güncellemesinin veya yeniden başlatmanın yapıldığını ve o zamandan beri nelerin değiştirildiğini not et. İşlemin başlangıcından ilk hata mesajına kadar kesintisiz başlatma günlüğünü kaydet. Son kırmızı satırın ekran görüntüsü çoğu zaman yeterli olmaz, çünkü yalnızca sonradan oluşan hatayı gösterir.
Oxide, yükleme ve derleyici hatalarını ayrıca sunucu kurulumundaki oxide/logs klasöründe bulunan kendi günlük dosyalarına yazar. Özellikle konsol yalnızca son satırları gösteriyorsa, buradaki mesaj görünür konsol bölümünden çoğu zaman daha eksiksizdir. Tarihi ilgili başlatmayla eşleşen dosyayı seç ve konsol günlüğüyle birlikte kaydet.
Rust sürümünü veya build bilgisini, kullanılan sürüm dalını, işletim sistemini, framework sürümünü ve etkilenen eklenti sürümlerini not al. Kurulu dosyaların indirme kaynağını sakla. “En son sürüm” tekrarlanabilir bir sürüm bilgisi değildir: Dosya, sen indirdikten sonra değiştirilmiş olabilir veya başlatma betiğin beklenenden farklı bir sürümü yüklüyor olabilir.
Yedeğe neler dahil edilmeli?
Dünya ve oyuncu verilerinin, başlatma yapılandırmasının ve modlama dosyalarının birbiriyle tutarlı bir durumunu yedekle. Oxide'da özellikle oxide/plugins, oxide/config ve oxide/data envanterine dahil edilmelidir; ayrıca izin verilerini ve kendi eklentilerini de hesaba kat. Kesin depolama yapısı kuruluma bağlıdır. Örnek bir dizini körü körüne kullanmak yerine gerçekten kullandığın yolları kontrol et.
Ayarları kullanım verilerinden ayır. Örneğin bir config dosyası eklentinin davranışını belirler; eklentinin verileri ise daha önce verilmiş ödülleri, kayıtlı konumları veya diğer kalıcı durumları içerebilir. İçerik eklentiye göre değişir. Bu yüzden oxide/data klasörünü topyekûn boşaltmak, hatalı işlevden çok daha fazlasını değiştirebilir.
Tutarlı bir yedek için kurulumunun belgelenmiş yedekleme sürecini kullan. Yazma işlemleri devam ederken alınan bir kopya tutarsız olabilir. Yedeğin gerçekten tamamlandığını ve erişilebilir olduğunu doğrula. Mevcut sunucunun üzerine yazmadan, yedeği ayrı bir konumda aç veya kontrol et. Ekranda görünen bir yedek adı, tek başına doğrulanmış bir geri dönüş yolu değildir.
Değişikliğinin sınırını belirle
Müdahaleden önce şunu yaz: “Yalnızca bu eklenti dosyasını değiştiriyorum” veya “Güncel Rust sürümüne uygun Oxide paketini yeniden kuruyorum”. Yedeklenen eski dosya, yeni dosya ve başarı ölçütü de buna dahildir. Framework'ü, birden fazla eklentiyi, config dosyalarını ve harita parametrelerini aynı anda değiştirme. Aksi halde sonradan hangi müdahalenin işe yaradığını veya zarar verdiğini bilemezsin.
Bir koruma, ekonomi veya erişim eklentisi devre dışı kaldığında, teste başlamadan önce sunucunun açık kalıp kalmayacağına karar ver. Teknik olarak erişilebilir bir dünya, söz verilen kurallarla otomatik olarak oynanabilir demek değildir. Gerekli bir kesintiyi önceden duyur ve kurulumunun normal durdurma yöntemini kullan. Tekrarlanan zorla kapatmalar teşhisin yerini tutmaz.
Durum A: Framework devre dışı kalıyor
Tipik tablo: Sunucu bir oyun güncellemesinden sonra başlıyor, ancak birbirinden bağımsız çok sayıda eklenti işlevi eksik. Güncel başlatma logunda Oxide'ın başarıyla yüklendiği görülmüyor veya doğru konsol bağlamındaki sürüm sorgusu bir framework sürümü döndürmüyor.
İncelenmesi gereken neden yalnızca “Oxide çok eski” değildir. Oyun güncellemesi değiştirilmiş dosyaların üzerine yazabilir; bir başlatma betiği ardından Vanilla dosyalarını geri getirebilir; framework yanlış sunucu dizinine açılmış olabilir. Yanlış işletim sistemi paketi, uyumsuz bir oyun dalı veya eksik bir yükleme de olası nedenler arasındadır.
Facepunch, Dedicated Server kılavuzunda bir oyun güncellemesinin Oxide'ın yeniden kurulmasını gerektirebileceğini ve SteamCMD'nin başlatma sürecinde dosyaları yeniden Vanilla durumuna döndürebileceğini açıkça belirtir. Buradan şu önemli sıra çıkar: Oyunu güncelle, uygun framework sürümünü kur, ardından sunucuyu başlat. Framework kurulumundan sonra yapılacak bir oyun dosyası doğrulaması, yaptığın işi yeniden boşa çıkarabilir.
Kendi sunucunu barındırırken izlenecek sıra
SteamCMD ile kendi barındırdığın bir sunucuda sıra şöyledir. Yol yalnızca bir örnektir; kendi gerçek sunucu dizinini kullan:
steamcmd +force_install_dir /pfad/zum/rustserver +login anonymous +app_update 258550 validate +quit
258550, Rust Dedicated Server'ın uygulama kimliğidir. validate, oyun dosyalarını kontrol eder ve bu sırada Vanilla sürümünü geri yükler. Oxide'ın tam da bu yüzden sonra gelmesi gerekir: Resmî Oxide.Rust sürümünden işletim sistemine uygun arşivi indir; Linux için Oxide.Rust-linux.zip, Windows için Oxide.Rust.zip. Arşivi klasör yapısını koruyarak sunucunun ana dizinine, yani RustDedicated veya RustDedicated.exe dosyasının bulunduğu yere aç ve mevcut dosyaların üzerine yazılmasına izin ver. Sunucuyu ancak bundan sonra başlat ve oxide.version ile kontrol et.
Başlatma betiğin her başlatmadan önce SteamCMD'yi çağırıyorsa, Oxide dosyalarını her yeniden başlatmada tekrar değiştirir. Bu durumda Oxide kurulumunu da başlatma betiğine, güncelleme ile sunucu başlatma arasına eklemelisin ya da otomatik güncellemeyi başlatma betiğinden çıkarmalısın. Managed Hosting kullanıyorsan bunun yerine sağlayıcının framework işlevini kullanırsın.
Güncel sürüm ile geçmiş test kombinasyonunu ayırt et
6 Kasım 2026 tarihli sürüm kontrolümüzde, yayımlanmış en yeni sürüm resmî Oxide.Rust 2.0.7894 sürümüydü. Bu sürüm 6 Kasım 2026, 10:11:56 UTC itibarıyla yayımlandı ve o günün ilk Rust hotfix'i için 2636.290.1 değerini belirtiyor. Bu Rust bilgisi bir Oxide paket sürüm numarası değildir. Bu güncelleme yalnızca yayımlanan sürümü belgeler; yeni kombinasyonla kendi yaptığımız bir işlev testi anlamına gelmez.
Kendi hata denemelerimiz 29 Ekim 2026 tarihindeki durumu yansıtıyor: Rust için uMod değişiklik günlüğü, 22 Ekim güncellemesi için 2635.289.1 değerini belirtiyor; buna ait resmî Oxide.Rust 2.0.7839 sürümü 22 Ekim 2026, 18:02:03 UTC itibarıyla yayımlandı. İzole test sunucumuzda version ve oxide.version gerçekten de Rust protokolü 2635.289.1 ile Oxide.Rust 2.0.7839 bilgisini bildirdi. Bu, geçmişe ait bir test kombinasyonudur; bu numaraları sonraki güncellemelerden sonra da korumanı öneren kalıcı bir tavsiye değildir.
Asıl müdahaleyi yaparken güncel sürümü ve sunucunun Rust durumunu yeniden kontrol et. Uygun bir sürüm notunun var olması, sağlayıcının veya başlatma betiğinin bu sürümü kurmuş olduğunu kanıtlamaz. Belirleyici olan, ardından çalışan örnekten okunan sürüm ile güncel başlatma logudur.
Kendi denememiz A: Eklentiler yüklenmesine rağmen framework hatası
Başlangıç durumumuz, Rust protokolü 2635.289.1 ve buna ait Oxide.Rust 2.0.7839 idi. Normal bir durdurmanın ve kendi test dünyamız ile Oxide dizininin yedeklenmesinin ardından, yalnızca izole test sunucusunda bilerek 19 Şubat 2026 tarihli resmî 2.0.7072 sürümünün eski Oxide.Rust.dll dosyasını yerleştirdik. Güncel kurulumun geri kalanı olduğu gibi kaldı. Bu, karışık ve birbiriyle uyumsuz bir framework durumunu simüle eder; eksiksiz bir geçmiş sunucu paketinin testi değildir.
Değişiklik, gerçekten yerleştirilen DLL'in SHA-256 değeriyle doğrulandı. Başlatma sırasında şu gerçek mesaj göründü:
Failed to call hook 'IOnServerCommand' on plugin 'RustCore v2.0.7072' (MissingFieldException: Field not found: string .Arg.FullString Due to: Could not find field in class)
Aynı anda kendi test eklentilerimiz başlatma işaretlerine ulaştı. Sunucu süreci de çalışmaya devam etti. Fazla basit bir pratik kuraldan önemli farkı işte budur: Bir framework sorunu, tüm eklentilerin yüklenmesini engellemek zorunda değildir. Başarılı bir eklenti listesi veya çalışan bir süreç, tam bir uyumluluk kontrolü değildir.
Mesaj, bir framework bileşeni olan RustCore adını ve bulunamayan bir alan erişimini belirtiyor. Bu, bir kit yapılandırmasının JSON hatası değildir. Bilerek oluşturulan bu kombinasyonda neden, birbiriyle uyumsuz framework durumudur. Buna karşılık başka bir ad taşıyan aynı türden bir hata, tek bir eklentiden kaynaklanabilir; bileşeni, hook'u ve bağlamı her zaman birlikte oku.
Asgari geri alma için daha önce sabitlenmiş uygun 2.0.7839 DLL dosyasını geri yükledik ve kontrollü olarak yeniden başlattık. Ardından oxide.version yeniden 2.0.7839 yanıtını verdi, oxide.plugins kendi dört test eklentimizin tamamını listeledi ve daha önce görülen MissingFieldException yeni kullanılabilir konsol arabelleğinde artık yer almıyordu. Böylece uygun framework'e geri dönüş yolu bu somut deneme için doğrulanmış oldu. Bundan, canlı sunucun için rastgele arşivlerden tek tek DLL dosyalarını kopyalayıp birleştirmeyi öneren bir sonuç çıkmaz: Orada, tutarlı bir durum elde etmek için uygun framework'ün eksiksiz kurulum yolunu kullan.
Denemede bilerek çok daha eski bir sürüm kullanıldı. Bu deneme, her eski sürümün aynı şekilde başarısız olduğunu da, tam olarak bu hata tablosunun her ekim güncellemesinde ortaya çıktığını da iddia etmez. Framework arızası, Oxide yüklenmemiş düz bir Vanilla durumu anlamına da gelebilir. Bu yüzden gerçek sürüm, logdaki ilk teşhis ve işlev testinin birlikte değerlendirilmesi gerekir.
Asgari onarım
- Başlangıç durumunu ve logu yedekle. Otomatik bir güncelleyicinin o anda çalışıp çalışmadığını kontrol et. Çakışacak ikinci bir kurulum işlemi başlatma.
- Rust durumunu, sürüm dalını, işletim sistemini ve bunlar için öngörülen framework sürümünü karşılaştır.
- Kurulum, framework dosyalarında değişiklik gerektiriyorsa sunucuyu normal şekilde durdur.
- Belgelenmiş kurulum yolunu kullan. Kendi sunucunu barındırıyorsan güvenilir ve uygun arşivi, dizin yapısını koruyarak doğru kuruluma, yukarıda açıklanan sırayla açarsın. Managed Hosting kullanıyorsan sağlayıcının framework işlevini kullan; başka panellerin menülerini kendi sağlayıcına uyarlamaya çalışma.
- Güncelleme sırasını kontrol et ve bir kez kontrollü olarak başlat. Yeni başlatma logunu oku.
- Framework sürümünü, eklenti listesini ve daha önce çalışmayan en az bir işlevi kontrol et.
Başarı: Beklenen framework doğru örnekten yanıt verir, beklenen eklentiler yüklenir ve kontrol edilen işlev çalışır. Geri dönüş yolu: Müdahale öncesindeki durumu sakla. Yeni bir oyunun üzerine körü körüne eski bir framework dosyası geri yükleme. Yalnızca daha eski bir tam paket uyumluysa, dünya biçimi ve istemci uyumluluğu dahil olmak üzere bu paketin geri yüklenebilirliği ayrıca kontrol edilmelidir. Bu belirsizse, uygun bir sürüm çıkana kadar sunucu kontrollü biçimde kapalı kalır.
Durum B: Bir eklenti derlenmiyor
Tipik tablo: Oxide yanıt veriyor, diğer eklentiler yükleniyor, ancak belirli bir eklenti başarısız olarak görünüyor. Log, çoğunlukla dosya, satır, sütun ve eksik bir sembol veya artık uyumlu olmayan bir metotla birlikte bir derleyici hatası gösteriyor.
Derleyici hatası ilk etapta yalnızca şu anlama gelir: Mevcut kaynak kod, erişilebilir referanslarla derlenemiyor. Bir oyun güncellemesi kullanılan bir arayüzü değiştirmiş olabilir. Ancak bozuk bir indirme, senin değiştirdiğin kod veya eksik bir katı bağımlılık da neden olabilir. Bu yüzden “Failed to compile”, otomatik olarak “Geliştiricinin yeni bir sürüm yayınlaması yeterli” demek değildir.
Kendi Testimiz B: Bir Derleyici Hatası
Rust protokolü 2635.289.1 ve Oxide.Rust 2.0.7839 çalıştıran izole test sunucumuzda yalnızca Guide7CompileBroken.cs test eklentisine kasıtlı bir #error satırı ekledik. Daha önce yüklenmiş olan Guide7Probe kontrol eklentisi bundan ayrı tutuldu. Gerçek konsol çıktısı şöyleydi:
Error while compiling Guide7CompileBroken: #error: 'GUIDE7_INTENTIONAL_COMPILE_FAILURE' | Line: 1, Pos: 8
Minimum onarım için yalnızca kasıtlı olarak eklenen hata satırını kaldırdık. Ardından konsol şunu bildirdi:
Guide7CompileBroken was compiled successfully in 362ms
Loaded plugin Guide7CompileBroken v1.0.0 by Guide7 isolated test fixture
Bu kontrollü testte geri dönüş yolu, değiştirilmemiş hatalı dosyayı geri yüklemektir; böylece aynı kasıtlı derleyici hatası yeniden oluşur. Gerçek bir üçüncü taraf eklentisi için “herhangi bir satırı silmek” kesinlikle bir onarım yöntemi değildir. Testimiz, framework ile eklenti derleyicisinin birbirinden ayrı olduğunu gösterir; Ekim güncellemesinin belirli bir API'yi bozduğunu kanıtlamaz. Gözlemlenen 362 ms yalnızca bu tek testi açıklar, genel bir yükleme süresi değildir.
Gerçek logda, konsolda veya oxide/logs içinde önce etkilenen dosyanın adını ve ilk derleyici tanılama mesajını ara. Daha sonra görünen “eklenti yüklenemedi” mesajı çoğu zaman yalnızca sonucu tekrarlar. Birden fazla eklentinin tam olarak aynı eksik sembolü belirtip belirtmediğini kontrol et: Bu durumda sorun, birbirinden bağımsız birkaç arıza yerine ortak bir API değişikliği veya referans olabilir.
Güncellemeleri yalnızca eklentinin belgelenmiş kaynağından indir. Değişiklik notlarını oku: Sorununu gideriyor mu, yeni bir bağımlılık gerektiriyor mu veya veri biçimini değiştiriyor mu? Daha yüksek bir sürüm numarası tek başına senin kullandığın kombinasyonla uyumluluğu garanti etmez.
Minimum Onarım
Mevcut .cs dosyasını, ilgili config dosyasını ve verileri yedekle. İlk olarak yalnızca etkilenen eklentiyi öngörülen düzeltilmiş sürümle değiştir. Oxide normalde eklenti klasöründeki değişiklikleri izler; bu yüzden aynı dosyayı tekrar tekrar yüklemekten ve telaşla ek yeniden yüklemeler yapmaktan kaçın. İşlemi konsoldan takip et, ardından gerçekte hangi sürümün yüklü olduğunu kontrol et.
Hedefli bir yeniden yükleme gerekiyorsa komutun biçimi şöyledir:
oxide.reload Pluginname
Burada Pluginname, indirme sayfasındaki pazarlama başlığını değil, eklentinin .cs uzantısı olmadan gerçek dosya adını ifade eder. Resmî komut referansı bu hedefli yeniden yüklemeyi belgeler. Sorunu daraltırken tüm eklentileri joker karakterle yeniden yükleme. Bu, gereksiz yere birçok durumu değiştirir ve yeni hatalara yol açabilir.
Başarı: Derleyici tanılama mesajı kaybolur, eklentinin beklenen sürümü yüklenir ve etkilenen işlev testi geçer. Geri dönüş: Güncelleme başarısız olursa bu yeni logu da kaydet. Eski eklenti sürümünü ve gerekli veri durumunu yalnızca bu kombinasyon oyunun güncel sürümüyle uyumluysa geri yükle. Oyun güncellemesinden sonra zaten bozuk olan eski bir dosya, işe yarar bir geri alma yöntemi değildir.
Uyumlu bir düzeltme yoksa yalnızca etkilenen eklentiyi geçici olarak devre dışı bırakmak mantıklı olabilir. Öncesinde başka hangi eklentilerin ve oyun kurallarının buna bağlı olduğunu kontrol et. Sunucu normal şekilde durdurulmuşken yedeklenen kaynak dosyayı izlenen eklenti klasöründen ayrı bir yedek klasörüne taşı. Bu sırada ne config dosyasını ne de kullanıcı verilerini sil. Onarım yapılana kadar hangi işlevin eksik olacağını not et.
Durum C: Bir Bağımlılık Eksik
Tipik senaryo: Bir eklenti eksik bir gereksinimi belirtir. Diğer işlevler çalışmaya devam eder veya devre dışı kalan birden fazla eklenti aynı kütüphaneye bağlıdır. Eksik görünen dosya mevcut olsa bile kendisi yüklenemiyor olabilir.
Oxide'ın bağımlılık yönergesi isteğe bağlı, gerekli ve katı bağımlılıkları birbirinden ayırır. İsteğe bağlı bir entegrasyon davranışı genişletir. Gerekli bir bağımlılık, işlevin çalışması için şarttır. Katı bir bağımlılık ise daha derleme aşamasını engelleyebilir. Bu terimler, “bağımlılık eksik” ile “derleyici hatası” durumlarının neden örtüşebildiğini açıklar.
Kendi Testimiz C: Eksik Bir Bağımlılık
Aynı test sunucusunda, // Requires: Guide7Dependency gereksinimini bildiren kendi Guide7Consumer.cs test eklentimizi yükledik. İlgili bağımlılık başlangıçta kasıtlı olarak kurulu değildi. Kontrollü testin gerçek çıktıları şunlardır:
Guide7Consumer plugin requires missing dependency: Guide7Dependency
Ignored unexpected plugin compilation failure: Guide7Consumer
Error while compiling Guide7Consumer: Missing dependency: Guide7Dependency
Burada da “Error while compiling” ifadesi geçiyor. Ancak belirleyici ek bilgi, eksik bağımlılığın açıkça adının verilmesidir. Yalnızca Guide7Dependency.cs dosyasını kurduk ve ardından bağımlı eklentiyi hedefli olarak yeniden yükledik. Sonrasında iki başlatma işaretçisi ve iki yükleme onayı da göründü:
[Guide7Dependency] GUIDE7_DEPENDENCY_READY
Loaded plugin Guide7Dependency v1.0.0 by Guide7 isolated test fixture
[Guide7Consumer] GUIDE7_CONSUMER_READY
Loaded plugin Guide7Consumer v1.0.0 by Guide7 isolated test fixture
Bu işaretçiler iki test eklentisinin başlatıldığını gösterir; üçüncü taraf bir eklentinin mağaza, ışınlanma veya koruma işlevinin test edildiğini göstermez. Bu testte geri dönüş için bağımlı eklenti kaldırıldıktan sonra yalnızca kendi bağımlılığımız silinirdi. Bağımlı eklentiyi tekrar tekrar yüklemek, tek başına gereksinimini kurmaz. Gerçek logunda önce bağımlılığın kendisi başarısız oluyorsa ilk olarak onun ilk hatasını gider. Rastgele bir indirme kaynağından alınan benzer adlı bir kütüphane, bunun yerine geçmez.
Eklenti sayfasından ve belgelerden tam adı, bağımlılığın türünü ve varsa istenen sürümleri kontrol et. Başka bir .cs eklentisi ile derlenmiş bir extension farklı şeylerdir. Kurulum konumları ve yeniden başlatma gereksinimleri farklı olabilir. Extension'lar için kendi kurulum kılavuzlarını kullan; bir DLL dosyasını tahmine dayanarak oxide/plugins içine kopyalama.
Minimum Onarım
Küçük bir zincir oluştur: etkilenen eklenti → gereken bağımlılık → bu bağımlılığın durumu. Bağımlılığı eklenti listesinde ve başlangıç logunda kontrol et. Gerçekten eksikse tam olarak o bağımlılığı resmî kaynağından kur. Zaten mevcutsa aynı dosyayı tekrar tekrar yüklemek yerine ilk hatasını gider.
Sıradan bir eklenti bağımlılığında, belgeleri bu akışı destekliyorsa önce bağımlılığı, ardından ona bağlı eklentiyi hedefli olarak yükleyebilirsin. Bir extension söz konusuysa veya başlangıç yapılandırması değiştiyse kontrollü bir yeniden başlatma gerekebilir. Yeniden başlatmayı otomatik bir çözüm olarak değil, yeni bir log üreten ve doğrulanabilen bir adım olarak gör.
Başarı: Bağımlılık ve ona bağlı eklenti öngörülen sürümlerde yüklenir; ikisini birbirine bağlayan işlev çalışır. Yalnızca iki eklentinin yüklü görünmesi bunun için yeterli değildir. Geri dönüş: Yedeklenmiş uyumlu kombinasyonu geri yükle veya bağımlılığı eksik olduğu sürece bağımlı eklentiyi devre dışı bırak. Sürüm düşürmeden önce yeni sürümün config dosyalarını veya verileri yeniden yazıp yazmadığını kontrol et.
Yüklü Ama Çalışmıyor
Bir eklenti yüklü görünüyorsa kurulum tanılamasını bırakıp işlev testine geç. Önce doğru işlevi doğru hesapla test edip etmediğini kontrol et. Bir admin, sıradan bir oyuncudan farklı yetkilere sahip olabilir. Bu nedenle tek bir admin denemesinin sonucu otomatik olarak tüm oyuncular için geçerli sayılamaz.
Ardından belgelenmiş izinleri ve ayarları kontrol et. Gereken işlev, dünya, bölge veya kullanıcı grubu etkinleştirilmiş mi? Bekleme süresi, savaş durumu veya oyun içi bir ön koşul gibi şartlar var mı? Bu örnekler kontrol edilebilecek olası alanlardır; her eklenti için geçerli olduğu iddia edilemez. Belirleyici olan, tam olarak kullandığın eklentinin belgeleridir.
Başarılı bir başlatma, her hook'un çalıştığını da kanıtlamaz. Hook, framework'ün bir oyun olayına bağlanmak için sunduğu bağlantı noktasıdır. Böyle bir arayüz değiştiğinde plugin yüklenebilir, ancak ilgili olay gerçekleştiğinde hata verebilir veya hiç tepki vermeyebilir. Bu yüzden asıl tetikleyiciyi tekrarla ve log'u tam o anda dikkatle izle.
Çalışma zamanı istisnasında ilgili stack trace'in tamamını ve hatadan önce yapılan işlemi kaydet. “Test amaçlı” çok sayıda izni değiştirmek iyi bir alternatif değildir: Bu, erişimleri genişletebilir ve asıl hatayı gizleyebilir. Temiz bir karşılaştırma için belirli bir hesap ve belgelenmiş izinler kullanılır.
Config dosyalarını silmek neden nadiren doğru başlangıçtır
Bir yapılandırma dosyası gerçekten hatalı olabilir. Buna işaret eden durumlar arasında açıkça bildirilen bir JSON ayrıştırma hatası veya bir ayarın okunması sırasında doğrudan oluşan bir hata sayılabilir. Eksik bir oyun metodundan kaynaklanan derleyici hatası ise tüm config dosyalarını sıfırlayarak giderilemez.
Oxide'ın yapılandırma kılavuzu, kapatılırken ayarları geri yazan plugin'lere karşı da uyarır. Plugin çalışırken yaptığın bir düzenlemenin üzerine bu durumda yazılabilir. Dosyayı yedekle, plugin'in kılavuzunu izle ve gerekirse düzenlemeden önce plugin'i devre dışı bırak.
JSON'u önce uygun bir doğrulayıcıyla yerel olarak kontrol et. Erişim bilgileri veya webhook adresleri gibi gizli değerlerin herkese açık çevrim içi doğrulayıcılarda işi yoktur. Ancak geçerli JSON yalnızca söz diziminin doğru olduğunu gösterir: Düzgün yazılmış bir alan yine de izin verilmeyen bir değer veya eski bir şema içerebilir.
Karşılaştırma için yeni bir config gerekiyorsa mümkünse yalıtılmış bir kopya üzerinde çalış. Orijinal dosyayı değiştirmeden sakla. Ardından ayarları tek tek karşılaştır ve yalnızca gerekçesini açıklayabildiğin değişiklikleri aktar. Tam sıfırlama; kuralları, fiyatları, izin bağlantılarını veya plugin'e bağlı diğer ayarları ilk işlev testinde fark edilmeden değiştirebilir.
Wipe, plugin onarımı değildir
Wipe, oyun durumunu veya seçilen ilerleme verilerini etkiler. Plugin derleyici hatası ise kodla ve kodun gereksinimleriyle ilgilidir. Bunlar farklı katmanlardır. Yeni bir dünya, kaldırılmış bir API metodunu geri getirmez ve eksik bir kütüphaneyi kurmaz.
Bir hatanın wipe gününde ortaya çıkması, bozuk dünya verileriyle bağlantılı olduğunu kanıtlamaz. Oyun güncellemesi, framework güncellemesi, plugin güncellemesi ve wipe çoğu zaman aynı bakım sürecinde yapılır. Bu olayları zaman çizelgende birbirinden ayır. Yeniden başlatmadan sonra farklı bir sunucu kimliğinin veya farklı bir veri dizininin kullanılıp kullanılmadığını da kontrol et.
Gerçekten bir dünya veya veri sorunundan şüpheleniliyorsa bu, kendi yedeği ve kendi başarı ölçütü olan ayrı bir tanılama işidir. Bunu plugin onarımının son adımı olarak öylesine yapma. Eski bir yedeği geri yüklemeden önce o zamandan beri kazanılan hangi ilerlemenin kaybolacağı ve yedeğin uyumlu olup olmadığı net olmalıdır.
Carbon: aynı tanılama mantığı, farklı kurulum yolu
Sunucun Carbon kullanıyorsa işe sürüm sorgusuyla başla:
c.version
Carbon yapılandırması ve resmî sürüm notları, Carbon'a özgü işlevleri ve sürüm bilgilerini belgeler. Gerçek Carbon kurulumundaki komutları ve yolları kullan. Orada başarısız olan bir Oxide komutu, tek başına framework'ün çalışmadığını kanıtlamaz.
Temel sorular aynı kalır: Framework çalışıyor mu? Hangi eklentiler gerçekten yüklü? Sorun tek bir plugin'de mi, yoksa ortak bir gereksinimde mi? Hangi işlev gerçekten test edildi? Ancak bundan her Oxide plugin'inin her Carbon sürümünde değişiklik yapılmadan çalışacağı veya framework değiştirmenin risksiz bir anlık çözüm olduğu sonucu çıkmaz.
Sorunu daraltırken işin arasında Oxide ile Carbon arasında geçiş yapma. Geçiş, birden fazla gereksinimi aynı anda değiştirir. Bunu ayrıca planla, verileri ve izinleri yedekle, ihtiyaç duyduğun plugin'leri test et. Tek bir derleyici hatası için uygun en küçük değişikliğin izlenmesi, genellikle platformu tamamen değiştirmekten daha kolaydır.
Üç durumun doğrudan karşılaştırması
| Durum | Belirleyici bulgu |
Yapılacak en küçük anlamlı müdahale |
Özellikle dokunulmayacaklar |
Sonrasında kanıt |
|---|---|---|---|---|
| Framework eksik veya uyumsuz | Framework'ün başladığı doğrulanmadı; çok sayıda işlev etkileniyor |
Oyun güncellemesinden sonra uygun framework sürümünü doğru şekilde kur |
Dünya, plugin config dosyaları ve kullanıcı verileri |
Sürüm, başlatma log'u, plugin listesi, işlev |
| Tek bir plugin derlenmiyor | Framework çalışıyor; ilk tanılama bu plugin'i gösteriyor |
Uyumlu plugin sürümünü kur veya plugin'i tek başına devre dışı bırak |
Diğer plugin'ler ve yedeklenmiş veriler |
Derleme, yükleme ve işlevi ayrı ayrı kontrol et |
| Bağımlılık eksik | Plugin bir gereksinimi belirtiyor; bu gereksinim eksik veya hata veriyor |
Gereksinimi onar, ardından ona bağlı plugin'i kontrol et |
İlgisiz eklentiler |
Bağımlılık ve ortak işlev çalışıyor |
Bu karşılaştırma, ölçülmüş onarım sürelerini değil tanılama sürecini gösterir. Her hata tek bir satıra net biçimde uymaz. Örneğin eksik bir DLL referans hedefi derleyici hatasına yol açabilir. Son kırmızı mesaja göre değil, kanıtlanmış ilk nedene göre sınıflandır.
Onarımı güvenilir şekilde nasıl doğrularsın
Değişiklikten önce asıl arızayı görünür kılan küçük bir test belirle. Bir kit plugin'inde bu, örneğin bu iş için ayrılmış bir test hesabı ve bilinen bir test kitiyle belgelenmiş bir kit alma işlemi olabilir. Koruma plugin'inde ise daha önce vaat edilen koruma kontrollü koşullarda sınanmalıdır. Bunun için başkalarının yapılarını veya gerçek ekonomik değerleri kullanma.
Ardından aynı testi tam olarak tek bir değişiklikten önce ve sonra karşılaştır. Hesap türünü, ilgili izinleri, plugin sürümünü, ayarları, yapılan işlemi ve sonucu not et. Bozuk olmayan yakın bir işlevi de kontrol et. Böylece bir onarımın görünen sorunu çözerken başka bir temel kuralı değiştirip değiştirmediğini fark edersin.
Anlamlı bir kapanış beş soruyu kapsar:
- Beklenen framework doğru sunucu örneğinden yanıt veriyor mu?
- Gerçekten yüklenen plugin sürümleri hedeflenen sürümlerle eşleşiyor mu?
- İlk hata yeni log'da başka bir hata oluşturmadan kayboldu mu?
- Söz konusu kullanım senaryosu uygun kullanıcı hesabıyla çalışıyor mu?
- Sonuç, planlanan bir sonraki kontrollü başlatmadan sonra da korunuyor mu?
Son madde özellikle kurulum sırasını ve otomatik başlatmayı sınar. Bunun için oyun devam ederken gereksiz yere bir yeniden başlatma daha zorlama. Bu kanıt henüz yoksa onarımı işlevsel olarak test edildi, başlatma kanıtı bekleniyor şeklinde belgele.
Yardımcı bir hata raporu
Dağınık ekran görüntüleri yığını gönderme. Kısa ve yeniden üretilebilir bir rapor, sorunun daraltılmasını hızlandırır. Oxide'ın sorun bildirme notları; ortam bilgilerini, adımları, beklenen ve gerçekleşen sonucu ve ilgili log'ları eklemeyi önerir.
Etkilenen işlev:
Tarih ve saat dilimiyle gözlemlenen ilk hata:
Rust sürümü ve release dalı:
Framework ve gerçekten okunan sürüm:
Plugin adı, sürümü ve indirme kaynağı:
Gerekli bağımlılıklar ve durumları:
Hatadan önceki son değişiklik:
İlk tam hata mesajı:
Yeniden oluşturma adımları:
Beklenen sonuç / gerçekleşen sonuç:
Daha önce denenen tekil değişiklik ve sonucu:
Mevcut yedek ve geri dönüş yolu:
Kopyadan parolaları, token'ları, webhook adreslerini ve gerekli olmayan kişisel bilgileri çıkar. Değiştirilmemiş orijinali kendinde güvenli şekilde sakla. Temizlenmiş log kopyası teknik nedeni korumalıdır: Tanılama için gereken plugin dosya adını veya hata mesajını yanlışlıkla silme.
Talebini doğru yere ilet. Yanlış kurulum sırası veya seçilemeyen bir framework konusunda hosting desteği yardımcı olabilir. Tek bir plugin'de yeniden üretilebilen bir hata için çoğu zaman doğru muhatap plugin'in geliştiricisidir. Birden fazla katman belirsizse aceleyle birini suçlamak yerine bulgularını gönder.
Bir sonraki Rust güncellemesinden önce
Kritik eklentilerinin ve bağımlılıklarının küçük bir envanterini tut. Hangi oyun kurallarının onlar olmadan geçerli olmadığını ve hangi özelliklerin yalnızca kolaylık sağladığını not et. Böylece bir güncellemeden sonra her eklentiyi alfabetik sırayla elden geçirmek yerine önce topluluğunuz için belirleyici olan şeyleri kontrol edebilirsin.
Planlı değişikliklerden önce izlenebilir bir durumu yedekle ve ilgili sürüm bilgilerini sakla. Framework projesinin ve en önemli eklenti geliştiricilerinin güncel duyurularını kontrol et. Sabit bir bekleme süresine güvenme: Bir sürüm hızlıca yayımlanabilir, ancak belirli bir eklentinin yine de uyarlanması gerekebilir.
Ayrıca başlatma betiğinin veya sağlayıcının neleri otomatikleştirdiğini de kontrol et. Rust'ı mı, framework'ü mü, ikisini birden mi güncelliyor, yoksa hiçbirini mi? Hangi sırayla? Bir sağlayıcı bunu her başlatmada yapabilir, bir diğeri ayrı bir güncelleme işleviyle. Başka bir panelin kılavuzu otomatik olarak senin sunucunu anlatmaz.
Büyük topluluklar için bilinen test verileriyle ayrı bir test süreci işletmeye değer. Bir denemenin aynı ilgili sürümleri ve ayarları kullanması gerekir, aksi takdirde başarısı ancak sınırlı bir anlam taşır. Boş bir test sunucusundan genel kararlılık vaatleri çıkarmak yerine testin sınırlarını belgele.
FAQ
Her eklenti güncellemesinden sonra tüm sunucuyu yeniden başlatmam gerekir mi?
Her zaman değil. Oxide, eklenti değişikliklerinin otomatik olarak algılanmasını ve hedefli yeniden yüklemeyi destekler. Buna karşılık framework dosyaları, extension'lar ve belirli başlatma süreçleri yeniden başlatma gerektirebilir. Belirleyici olan, ilgili bileşenin dokümantasyonudur. Yeniden yüklemeden sonra logu ve işlevi kontrol et; bir komutun başarıyla kabul edilmesi tek başına yeterli değildir.
Tüm eklentiler eksik. Suçlu kesinlikle Oxide mi?
Hayır. Bu güçlü bir ipucu, ancak konsol bağlamını, başlatmanın tamamlanıp tamamlanmadığını, framework seçimini, sunucu örneğini ve ortak bağımlılıkları kontrol et. Yanlış bir veri dizini veya aynı gereksinime sahip birden fazla eklenti de tam bir arıza gibi görünebilir. Hatayı güvenilir biçimde daraltan, ancak bulguların bir arada değerlendirilmesidir.
Yeni bir framework çıktığında yeniden başlatmak işe yarar mı?
Yalnızca kurulum sürecin bu framework'ü bu sırada gerçekten kuruyorsa veya onu önceden doğru şekilde güncellediysen. Kendi sunucunu barındırıyorsan yeniden başlatma tek başına bir indirme anlamına gelmez. Sonrasında okunan framework sürümünü hedeflenen sürümle karşılaştır. Sürüm değişmediyse güncelleme yolunu incele.
Config'i silip yeniden oluşturulmasını sağlayabilir miyim?
Yeni bir config, yedeklenmiş bir test kopyasında karşılaştırma yaparken işine yarayabilir. Genel bir onarım yöntemi olarak uygun değildir ve kendi kurallarını sıfırlayabilir. Önce somut bir yapılandırma hatası ara. Orijinal dosyayı ve verileri yedekle, ayrıca eklentinin kaldırılırken ayarları geri yazıp yazmadığına dikkat et.
Bir eklenti güncellemeden sonra neden yüklü görünüyor ama çalışmıyor?
Yüklenmek yalnızca bir aşamadır. Söz konusu işlev izinler, ayarlar, ancak daha sonra ihtiyaç duyulan bir bağımlılık veya değişmiş bir hook yüzünden başarısız olabilir. Tetikleyiciyi kontrollü koşullarda test et ve aynı ana ait logu oku. Yalnızca listedeki kayda bakarak işlevin onarıldığını öne sürme.
Oxide veya bir eklenti düzeltmesi için ne kadar beklemem gerekir?
Sabit bir süreyi ciddi biçimde vaat etmek mümkün değildir. Güncel sürüm kanalını ve ilgili eklentinin durumunu kontrol et. Kritik bir koruma kullanılamıyorsa tahmini bir saate güvenmek yerine sunucunun güvenli çalışma durumuna karar ver.
Doğrudan eski bir sürüme geri dönebilir miyim?
Yalnızca doğrulanmış uyumlu bir kombinasyonla ve güvenceye alınmış bir geri dönüş yoluyla. Eski framework ile yeni Rust yine başarısız olabilir. Yeni bir eklenti sürümü, eski sürümün anlayamayacağı şekilde verileri değiştirmiş olabilir. Geri yüklemeden önce mevcut durumu da ayrıca yedekle ve veri uyumluluğunu kontrol et.
Logda sık karşılaşılan terimler
Framework: Oxide veya Carbon gibi, eklentilerin temelini oluşturan yapı. Eklenti (Plugin): Belirli bir işlevi olan tekil eklenti. Derleyici (Compiler): Eklenti kaynak kodunu çalıştırılabilir koda dönüştürür. Bağımlılık: Bir eklentinin ihtiyaç duyduğu başka bir bileşen. Extension: Genellikle kendi kurulum yolu olan derlenmiş bir kütüphane biçimindeki ek framework uzantısı. Hook: Oyundaki bir olaya bağlanma noktası. RCON: Sunucu konsoluna yetkili uzaktan erişim. Rollback: Daha önceki, birbiriyle uyumlu bir durumun doğrulanarak geri yüklenmesi. Wipe: Seçili oyun verilerinin sıfırlanması; genel bir eklenti onarımı değildir.
Etkilenen sunucuda atacağın en mantıklı sonraki adım küçüktür: Güncel başlatma logunu yedekle, gerçekten çalışan framework'ü kontrol et ve ilk hata mesajının izini sür. Hangi tekil bileşenin değiştirilmesi gerektiğine ancak ondan sonra karar ver.
Kaynaklar ve inceleme durumu
- GitHub'daki Oxide.Rust sürümleri: Rust 2636.290.1 için 6 Kasım 2026 tarihli güncel 2.0.7894 sürümü; 22 Ekim 2026 tarihli 2.0.7839 sürümü ve 19 Şubat 2026 tarihli 2.0.7072 sürümüyle yapılan geçmiş denemeler.
- Rust için uMod değişiklik günlüğü: 22 Ekim 2026 güncellemesi dahil ekim ayı kayıtları.
- Oxide dokümantasyonu: Eklenti kurulumu,
oxide/logs, komutlar, yapılandırma, bağımlılıklar ve hata raporları. - Facepunch'ın Dedicated Server kılavuzu: SteamCMD, App-ID 258550 ve oyun güncellemelerinden sonra Oxide.
- Carbon dokümantasyonu: Sürüm komutu ve yapılandırma.
İnceleme durumu: Sürüm bilgileri 6 Kasım 2026'da kontrol edildi; Oxide.Rust 2.0.7894 ile yeni bir işlev testi yapılmadı. Üç hata denemesi 29 Ekim 2026'da, Rust protokolü 2635.289.1 ve Oxide.Rust 2.0.7839 kullanan, bize ait izole bir test sunucusunda gerçekleştirildi; test sunucusu ardından silindi. Bu geçmiş denemelerin sürüm numaraları, sonraki Rust güncellemelerinin ardından artık yalnızca birer örnektir.