Bu rehber, SphereServer'a ilk kez .scp script dosyası eklemek isteyenler içindir. Item, NPC veya komut tanımlarını oluşturma, kaydetme, scripts\ klasörüne taşıma ve sunucuya tanıtma adımlarını kapsar.

Yazar: NightCrawler | Seviye: Başlangıç

Sitedeki kısa anlatımlar: Script Ekleme | Script Nasıl Eklenir?

• Script dosyası nedir?
• Adım 1 — Metin dosyası oluşturma
• Adım 2 — Script içeriğini yazma
• Adım 3 — .scp olarak kaydetme
• Adım 4 — scripts klasörüne taşıma
• Adım 5 — Sphere'e tanıtma (resync)
• Adım 6 — Oyun içinde test
• Sık yapılan hatalar
• Editör önerisi

SphereServer'da item, NPC, yetenek, komut gibi oyun içi her şey .scp uzantılı script dosyaları aracılığıyla tanımlanır. Bu dosyalar düz metindir; özel bir program gerekmez — Notepad, Notepad++ veya VS Code ile oluşturulup düzenlenebilir.

Script pack indirme: Sphere script pack kategorisi | Emülatör kurulumu: Sphere Server 56B Kurulum

Adım 1 — Yeni bir metin dosyası oluşturun

Masaüstünde veya istediğiniz bir klasörde sağ tık → Yeni → Metin Belgesi ile boş bir dosya açın. Alternatif olarak Notepad'i Başlat menüsünden de açabilirsiniz.

Adım 2 — Script içeriğini yazın

Dosyanın içine Sphere script kodlarınızı yazın. Örnek — basit bir item tanımı:

[ITEMDEF i_elma]

NAME=Elma

ID=0x09D0

TYPE=t_food

WEIGHT=1

FOODVAL=4

Adım 3 — Dosyayı .scp olarak kaydedin

Notepad'de Dosya → Farklı Kaydet menüsüne gidin ve şu ayarları uygulayın:

• Dosya adı — İstediğiniz isim + .scp (ör. item_yiyecekler.scp)
• Kayıt türü — Tüm Dosyalar (*.*) seçin (Metin Belgesi bırakmayın)
• Kodlama — ANSI veya UTF-8 (Sphere genellikle ANSI ile uyumludur)

Dikkat: Kayıt türünü değiştirmezseniz dosya item_yiyecekler.scp.txt olarak kaydedilir ve Sphere bu dosyayı görmez.

Windows'ta uzantıları görmek için: Klasör penceresinde Görünüm → Dosya adı uzantıları (veya eski sürümlerde Araçlar → Klasör Seçenekleri → Görünüm → Bilinen dosya türleri için uzantıları gizle kutusunu kaldırın). Ayrıntılı ekran görüntüleri: Script Nasıl Eklenir?

Adım 4 — Dosyayı scripts klasörüne taşıyın

Oluşturduğunuz .scp dosyasını SphereServer kurulum klasöründeki scripts\ dizinine kopyalayın veya taşıyın:

C:\SphereServer\scripts\item_yiyecekler.scp

Alt klasör kullanabilirsiniz (ör. scripts\items\, scripts\npcs\); Sphere alt klasörleri de tarar.

Adım 5 — Sphere'e scripti tanıtın

Yöntem A — Resync (önerilen)

Sphere konsol penceresine şu komutu yazın ve Enter'a basın:

r r

Tüm script dosyaları yeniden taranır; sunucuyu kapatmaya gerek kalmaz.

Yöntem B — Sunucuyu yeniden başlatma

SphereSvr.exe kapatılıp yeniden açılırsa scriptler yüklenir; ancak bağlı oyuncuların oturumu kesilir.

Adım 6 — Scripti oyun içinde test edin

GM yetkili karakter veya konsoldan tanımladığınız nesneyi oluşturun. Örnek komutlar:

add i_elma          ; item olusturur

go i_elma           ; tanimli item'a isinlanir (TYPEDEF'e gore)

Konsolda hata mesajı yoksa script başarıyla yüklendi demektir.

• Script yüklenmedi — Nedeni: kayıt türü Metin Belgesi kaldı | Çözüm: Tüm Dosyalar seçerek .scp olarak kaydedin
• Unknown keyword hatası — Nedeni: script sözdizimi hatası | Çözüm: ITEMDEF veya CHARDEF bloğunu kontrol edin
• Resync sonrası hâlâ yok — Nedeni: yanlış klasör | Çözüm: dosyanın scripts\ içinde olduğunu doğrulayın
• Script yüklendi ama item oluşmuyor — Nedeni: TYPEDEF veya ID eksik/hatalı | Çözüm: tanım bloğunu eksiksiz doldurun
• .scp.txt uzantısı — Nedeni: Windows gizli uzantı | Çözüm: uzantıları görünür yapın, .txt ekini silin

Notepad temel ihtiyaçları karşılasa da aşağıdaki editörler script yazmayı kolaylaştırır:

• Notepad++ — Satır numaraları, sözdizimi renklendirme, çoklu sekme (ücretsiz)
• Visual Studio Code — Gelişmiş arama/değiştirme, eklenti desteği (ücretsiz)

• Script arşivi: Sphere script pack kategorisi
• Güvenlik: dışarıdan indirilen scriptleri yüklemeden önce inceleyin — Sphere 55x Zararları
• Performans: Lag Hakkında Herşey
• Tam kurulum: Sphere 0.56b Win32 + Latest Script Pack

Adımları eksiksiz uyguladığınızda scriptiniz çalışır hâle gelecektir. İyi kodlamalar!