Script Editörü

Studio'daki Script Editörü, Roblox'ta script yazmak için birincil araçtır. Yüksek etkili kod yazmanıza, geliştirme sürenizi kısaltmanıza ve oyunlarınızı iterasyona sokmanıza yardımcı olabilecek kendini geliştiren bir ortamdır. Script deneyiminizi şu şekilde geliştirebilir:

• Kodunuzdaki sözdizimini biçimlendirir ve vurgular.
• Yazarken kodunuzda ifadeleri otomatik tamamlama yolları sunar.
• Değişken ve fonksiyon bildirimlerine atlayarak kodda gezinmenize yardımcı olur.
• Açık scriptlerde veya tüm scriptlerde kodu bulup değiştirme işlemlerine yardımcı olur.
• Kod kaliteniz ve performansınız hakkında gerçek zamanlı geri bildirim sağlar.

Script Editörü, tüm script türlerini destekler ve yeni bir script oluşturduğunuzda veya Explorer penceresinde mevcut bir script'e çift tıkladığınızda otomatik olarak açılır.

Otomatik tamamlama özellikleri

Script Editörü'nün otomatik tamamlama özellikleri, programlama verimliliğinizi artırabilecek kodla ilgili bilgileri üretir, örneğin:

• Yazarken tamamlamanız gereken ifadeler hakkında bilgili öneriler sunar; bu öneriler oyunun veri modeli ile bağlamlıdır. Örneğin, Workspace içinde RocketShip adında bir Model'ınız varsa, workspace.roc yazdığınızda otomatik tamamlama RocketShip önerir ve bunun bir Model olduğunu belirtir.

  

  Önerileri gözden geçirmek için ↑ ve ↓ tuşlarını kullanın, ardından bir öneriyi kabul etmek ve tamamlanmış ifadeyi eklemek için Tab veya Enter tuşuna basın.

• Tanımladığınız değişkenler ve fonksiyonlar için otomatik adlandırma yaparak can sıkıcı yazım hatalarından kaçınmanıza yardımcı olur.

  

• API'nin kullanımına dair bağlam sağlayan, Motor API Referansı ile benzer kod örnekleri içeren belge açılır pencereleri.

  

• Kendi tanımladığınız belgelerle özelleştirebileceğiniz fare ile üzerine gelindiğinde açılan ipuçları.

  

• Hataları gidermenize yardımcı olabilecek bilgilerle fare ile üzerine gelindiğinde script analizi tanılama.

  

• Bir argüman yazdığınızda fonksiyon imzaları, parametreleri ve dönüş değerleri için bir referans sağlar.

  

Kodda gezinme

Bildirime git

Bir fonksiyon veya değişkenin bildirimine atlamak için, çağrıyı tıklarken Windows'ta Ctrl veya Mac'te ⌘ tuşunu basılı tutabilirsiniz veya çağrısına sağ tıklayıp Bildirime Git seçeneğini tıklayabilirsiniz.

Script fonksiyon filtresi

Script Fonksiyon Filtresi, bir scriptte tanımlanan tüm fonksiyonların listesini görüntüler. Açmak için Windows'ta AltF veya Mac'te ⌥F tuşlarına basın. Liste açıkken, her fonksiyonun imzalarını gözden geçirebilir, isimlerine göre filtreleyebilir ve birine çift tıklayarak bildirimine atlayabilirsiniz.

Bul ve değiştir

Bul/Değiştir widget'ı, açık bir scriptte kod bulup değiştirme işlemi yapmanıza olanak tanır. Widget, büyük/küçük harf eşleştirme, tam kelime eşleştirme ve düzenli ifadelerle arama desteği sunar. Açmak için Windows'ta CtrlF veya Mac'te ⌘F tuşlarına basın.

Gerçek zamanlı geri bildirim

Script Analizi

Script Analizi penceresi, Studio'nun Script sekmesi araç çubuğundaki Analiz butonuyla erişilebilir, scriptleriniz üzerinde statik analiz yapar ve aktif hataları ve uyarıları görüntüler. Hatalar ve uyarılar hakkında daha fazla bilgi için Luau linting belgelerine bakın.

Çıktı

Çıktı penceresi, scriptlerin çalıştırılmasından elde edilen hataları, Roblox motorundan gelen mesajları, print() çağrılarından gelen mesajları ve warn() çağrılarından gelen hataları görüntüler.

Kod Yardımı

Kod Yardımı, yazarken kod satırları veya fonksiyonları öneren bir özelliktir, böylece daha verimli kod yazmanıza ve odaklanmanıza yardımcı olur. Yorumlarınız ve kodunuzdan gelen bağlamlara dayalı olarak, öneriler iki şekilde tetiklenir:

• Otomatik olarak, bir satırda birkaç saniye durakladığınızda ve AI modelinin bir öneri için yeterli bağlamı olduğunda.
• Manuel olarak, Windows'ta Alt∖ veya Mac'te ⌥∖ kısayolu ile.

Bir öneriyi kabul etmek için Tab tuşuna basın veya yazmaya devam ederek göz ardı edin. Şu anda, scriptinizin bir öneriyi tetiklemek için en az birkaç satır kod içermesi gerekir.

Önerileri geliştirme

Daha doğru ve ilgili öneriler almak için, yardım alıp almadığınıza bakılmaksızın temiz kodlama uygulamalarını takip etmeniz önerilir ve:

• Kodunuzu daha küçük fonksiyonlara ayırın.
• Her scriptin ne yaptığını genel olarak yansıtan açıklayıcı script isimleri kullanın. Örneğin, bir scripti sadece Sounds yerine SyncCustomSounds olarak adlandırın.
• Parametreler, fonksiyonlar ve scriptler için açıklayıcı isimler atayın. Örneğin, bir parçayı sadece grs yerine GreenSphere olarak adlandırın veya bir fonksiyonu generateSphere() yerine gen() olarak adlandırın. İsimli fonksiyonlar kullanmak, anonim fonksiyonlara göre daha iyi ipuçları üretebilir.
• Uyguladığınız görevi ve girdi/çıktıların ne olması gerektiğini açıklayan iyi yazılmış yorumlar eklemeyi sürekli olarak yapın.

  • Beklenen sonuçlarla birlikte bazı örnek çağrılar eklemeyi düşünün.
  • Bir problemi nasıl çözeceğinizi önerin, örneğin -- Raycast kullanın.
  • Tanımladığınız tam fonksiyon veya değişken adını kullanın, örneğin -- 10 greenSphere nesnesi oluşturun yerine -- 10 sphere oluşturun.
• Eğer yeni bir script yazıyorsanız, "oyuncu parçaya dokunduğunda zıplat" gibi temel projelerle başlayın veya bilginiz arttıkça genişletebileceğiniz küçük kod parçaları oluşturmak için aracı kullanın.

Sınırlamalar

Araç, temel kodlama görevlerini otomatikleştirmeye yardımcı olur, ancak her zaman mükemmel kod önermez. Bilinen sınırlamalar şunlardır:

• Manuel tetikleme her zaman bir öneri oluşturmaz.
• Öneriler, bir kod derlemesinden makine öğrenimi ile elde edilir ve bu nedenle eğitildikleri kodun bazı sınırlamalarını yansıtabilir. Örneğin, öneriler daha eski API'leri tercih edebilir veya Luau yerine Lua kullanabilir.
• Araç, amacınıza uygun olmayan yanlış veya yanıltıcı bilgiler üretebilir.
• İç filtreler, saldırgan dili engellemeye çalışır, ancak hepsini kapsayıcı değildir ve aracın saldırgan veya önyargılı bilgiler üretebilme olasılığı vardır.
• Öneriler, kullanıcılar arasında aynı, benzer veya farklı olabilir, hatta aynı istemlerle bile. Ancak, kodunuz diğer kullanıcılarla asla paylaşılmayacaktır.
• Öneri, öğrenme modellerinin sınırlı çıktı uzunluğu nedeniyle eksik olabilir.
• Günlük öneri sayısı için bir üst sınır vardır ve bu sınır aşıldığında, bir sonraki güne kadar öneri almazsınız.

Kod gizliliği

Şu anda, Roblox, öğrenme modellerini eğitmek için herhangi bir özel veri kullanmamaktadır. Araç, büyük dil modellerini ayarlamak için yalnızca ücretsiz pazar varlıklarının küçük bir alt kümesini kullanır ve bu alt küme kalite ve güvenlik filtrelerinden çeşitli kontrollerden geçmiştir.

Ayrıca, tüm öneriler AI modeli tarafından üretilir ve bir kullanıcıdan diğerine aktarılmaz. Kodunuz model eğitimi için kullanılmadığı için, Kod Yardımı'nın diğer kullanıcılarına önerilmeyecektir; tek istisna, ücretsiz pazar öğelerine gönderilen kodlardır.

Çoklu imleç

Script Editörü, aynı anda düzenlemeler yapmak için birden fazla imleç kullanımını destekler. İhtiyaçlarınıza göre imleçler ekleyebilirsiniz; bir fare tıklaması veya klavye kısayolu ile. İlk imleç birincil imleç olarak adlandırılır ve ek imleçler ikincil imleçler olarak adlandırılır.

• Birincil imleçte yaptığınız düzenlemeler ikincil imleçlere kopyalanır. Her düzenleme bir eylem olarak sayılır, bu nedenle bir düzenlemenin geri alınması/yeniden yapılması tüm imleçlere uygulanır.
• Otomatik tamamlama gibi widget'lar birincil imleçte görünür, ancak ikincil imleçlerde görünmez.
• Script düzenleme için standart klavye kısayolları çoklu imleç düzenlemesi ile çalışır; kod girintileme, yorumları açıp kapatma ve satır silme işlemleri dahil.

Aşağıdaki tablo, çoklu imleç iş akışlarını ve kısayollarını özetlemektedir.

İmleç ekleme

Klavye kısayolları ve fare hareketleri kombinasyonu ile imleç ekleyebilirsiniz. İmleçler, aynı alanda bulunuyorlarsa birleşir; örneğin, ok tuşları ile imleç eklediğinizde veya imleçler arasındaki tüm karakterleri sildiğinizde.

Fare konumunda

Fare işaretçinizin konumunda bir imleç eklemek için:

1. Windows'ta Alt tuşunu veya Mac'te ⌥ tuşunu basılı tutun.

2. İmleci eklemek istediğiniz yere tıklayın.

Fare sürüklemesiyle

Fareyi sürükleyerek bir seçime imleç ekleyebilir, çok satırlı bir seçimi satırlara ayırabilir veya kod/boşluk sütunlarını ve bloklarını seçebilirsiniz.

Kod seçimine sürükleyerek imleç eklemek için:

1. Windows'ta Alt tuşunu veya Mac'te ⌥ tuşunu basılı tutun.

2. Fare ile kod seçiminiz üzerinde tıklayıp sürükleyin.

Birincil imlecin üstünde ve altında

Birincil imlecin hemen üstünde veya altında bir imleç eklemek için:

1. Windows'ta CtrlAlt tuşlarını veya Mac'te ⌘⌥ tuşlarını basılı tutun.

2. ↑ veya ↓ ok tuşlarına basın.

Eşleşen seçimlere

Bir seçimin tüm eşleşmelerine veya bir sonraki/önceki eşleşmeye imleç ekleyebilir ve isteğe bağlı olarak eşleşmelerin büyük/küçük harf duyarlı olup olmadığını ve/veya tam kelime eşleşmesi yapıp yapmadığını değiştirebilirsiniz.

Seçilen bir bölümün tüm eşleşmelerine imleç eklemek için:

1. Eşleşmelerini aramak istediğiniz kodu seçin.

2. Windows'ta ShiftAltL veya Mac'te Shift⌥L tuşlarına basın.

İmleçleri kaldırma

Aşağıdaki klavye kısayolları ve fare hareketleri ile imleçleri kaldırabilirsiniz. Alternatif olarak, Esc tuşuna basarak çoklu imleç düzenlemesinden çıkabilirsiniz.

Fare konumunda

Bir imleci kaldırmak için:

1. Windows'ta Alt tuşunu veya Mac'te ⌥ tuşunu basılı tutun.

2. Kaldırmak istediğiniz imlece tıklayın.

En son eklenen

En son eklenen imleci kaldırmak için, Windows'ta CtrlU veya Mac'te ⌘U tuşlarına basın.

İmleçleri kopyalama ve yapıştırma

Bir kod seçimini kopyalamak, içindeki imleçleri de içerir. Yapıştırma davranışı, kaynakta bulunan imleç sayısına ve hedefteki imleç sayısına bağlıdır:

• Eğer imleç sayısı aynıysa, her kopyalanan imleç, her karşılık gelen hedef imleçte yapıştırılır.
• Eğer imleç sayısı farklıysa, her hedef imleç, her kopyalanan imleci yeni bir satır olarak alır.

Yazarken biçimlendirme

Enter/return tuşuna basmak, her imleci yeni satırda bir önceki satıra göre otomatik olarak girintiler. Eğer önceki satır tamamlanmamış bir blokla başlıyorsa, biçimlendirici bunu tamamlamaya çalışır.

Editör ayarları

Birçok özelleştirme seçeneği, Studio Ayarları içindeki Script Editörü sekmesi aracılığıyla erişilebilir. Sıklıkla değiştirilen seçenekler şunlardır:

Klavye kısayolları

Script Editörü aşağıdaki klavye kısayollarına sahiptir.