Agent Ransack
UO-Developer.com — Windows dosya ve içerik arama aracı (Sphere / RunUO script taraması)Agent Ransack, Windows için ücretsiz bir dosya arama ve içerik bulma programıdır. Bilgisayarınızdaki dosya ve klasörleri hızlıca tarar; ad, boyut, tarih, tür veya dosya içeriğine göre arama yapmanızı sağlar. Sphere ve RunUO shard yöneticileri ile scripter'lar için en sık kullanım alanı: scripts klasöründe DEFNAME, trigger, event veya hata mesajı metni aramak.
Konu: Agent Ransack indirme ve kullanım | Seviye: Shard yönetici / scripter
İlgili: AutoHotKey Nebula İtembox | Sphere Server Kurulum Rehberi | libmysql.dll 32 bit | libmysql.dll 64 bit
İçindekiler
- Program özellikleri
- İndirme ve kurulum
- Sphere script klasöründe arama
- Sık kullanılan arama örnekleri
- İpuçları ve alternatifler
- Kontrol listesi
1. Program Özellikleri
Agent Ransack'ın temel yetenekleri:
- Hızlı arama — Dosyaları ad, boyut, tarih, içerik veya türüne göre bulur
- Gelişmiş filtreler — Dosya boyutu, tarih aralığı, uzantı gibi kriterler
- Sonuç önizleme — Eşleşen satırları dosyayı açmadan gösterir
- İçerik araması — .scp, .cs, .ini ve diğer metin dosyalarının içinde kelime veya ifade arar
- Kullanım kolaylığı — Klasöre sağ tıklayıp arama başlatma, sonuçları dosya yoluna göre listeleme
UO geliştirme bağlamında en değerli özellik içerik aramasıdır: hangi script'te bir DEFNAME, trigger veya sysmessage geçtiğini saniyeler içinde bulursunuz.
2. İndirme ve Kurulum
UO-Developer indirme: Bu sayfadaki Agent Ransack indirme bağlantısından arşivi alın (agentransack_2951.rar). WinRAR veya 7-Zip ile açın, kurulum sihirbazını çalıştırın.
Resmi site: Güncel sürüm için Mythicsoft — Agent Ransack sayfasını da kullanabilirsiniz. Ücretsiz sürüm çoğu shard geliştirme ihtiyacını karşılar.
- Kurulumdan sonra Başlat menüsünden veya masaüstü kısayolundan programı açın
- İlk kullanımda arama klasörünü Sphere veya RunUO scripts dizini olarak ayarlayın
- Windows 10/11 ile uyumludur; yönetici olarak çalıştırma genelde gerekmez
3. Sphere Script Klasöründe Arama
Temel adımlar (forum rehberlerinden özet):
- Containing text (veya arama kutusu): aradığınız kelime veya ifade — örn. i_katana, ON=@Equip, SCROLL_MOTD
- Look in: script kök klasörü — örn. C:\Sphere\Scripts\ veya yalnızca C:\Sphere\Scripts\Items\
- Search / Start ile taramayı başlatın
- Sonuç listesinde dosya adı ve eşleşen satır görünür; çift tıklayarak ilgili .scp dosyasını açın
Alternatif: Windows Gezgini'nde scripts klasörüne sağ tıklayıp Agent Ransack ile ara seçeneğini kullanın; arama penceresi o klasör yolu ile açılır.
Örnek klasör yapısı:
C:\Sphere\
├── SphereSvr.exe
├── sphere.ini
├── scripts\
│ ├── sphere_item_provisions_clothing.scp
│ ├── sphere_skills.scp
│ ├── sphere_types.scp
│ ├── items\
│ ├── npcs\
│ └── dialogs\
└── save\4. Sık Kullanılan Arama Örnekleri
Item / DEFNAME bulma
Bir eşyanın hangi dosyada tanımlandığını bulmak için DEFNAME veya hex ID arayın:
i_katanaDEFNAME=i_capeTrigger ve event bulma
Kod çakışması veya yanlış trigger şüphesinde:
ON=@EquipON=@Logine_jailVendor / craft sorunları
Aynı SELL satırının birden fazla yerde tanımlı olup olmadığını kontrol etmek için:
SELL=i_pet_horse_grayCraft yapılmıyorsa SKILLMAKE veya RESOURCES satırlarını arayın:
SKILLMAKE=TAILORINGHata mesajı veya metin bulma
Oyunda gördüğünüz sysmessage metnini script içinde arayın — hatanın kaynağı genelde ilk eşleşmededir:
connector girisi dogrulanmadiÇift tanım temizliği
Aynı dialog veya typedef birden fazla dosyada tanımlıysa sorun çıkar. Örnek aramalar:
[TYPEDEF t_deed][DIALOG d_blacksmith]sphere.ini / ayar satırı
MYSQL=Magery.scp5. İpuçları ve Alternatifler
- Dar klasör — Tüm diski taramak yerine önce scripts\Items, scripts\dialogs gibi alt klasörleri hedefleyin; sonuç daha hızlı gelir
- Dosya türü — Sphere için çoğunlukla .scp; RunUO için .cs uzantılı dosyalar
- Büyük/küçük harf — İçerik aramasında genelde büyük/küçük harf duyarsız arama yeterlidir; eşleşme yoksa farklı yazım deneyin
- Yedek — Bulduğunuz dosyayı düzenlemeden önce kopyasını alın veya versiyon kontrolü kullanın
- WinRAR alternatifi — scripts klasörünü WinRAR ile açıp Bul menüsünden de arama yapılabilir; Agent Ransack sonuç önizlemesi ve klasör taraması açısından daha pratiktir
Ne zaman kullanılır?
- Bir item, NPC veya spell hangi dosyada tanımlı bilinmiyorsa
- Aynı kod iki yerde tanımlı — çakışma şüphesi varsa
- Oyun içi hata mesajının script kaynağı aranıyorsa
- Pack veya fix script içinde istenmeyen satır temizlenecekse
- Forumda önerilen bir DEFNAME veya event adının konumunu bulmak için
6. Kontrol Listesi
- Agent Ransack kuruldu
- Look in yolu doğru — Sphere/RunUO scripts klasörü
- Aranan metin doğru yazıldı (DEFNAME, trigger adı veya mesaj metni)
- Sonuç dosyası düzenlenmeden önce yedeklendi
- Değişiklik sonrası sunucu yeniden başlatıldı veya script reload yapıldı
- Sorun devam ediyorsa aynı aramayı alt klasörlerde tekrarlayın


