Script Editörü

Script Editörü, Studio'da Roblox'ta scripting yapmak için birincil araçtır. Yüksek etki kodu yazmanıza yardımcı olabilen, geliştirme sürenizi kısaltan ve deneyimlerinizi iteratif bir şekilde geliştirmenize olanak tanıyan kendini geliştiren bir ortamdır. Scripting deneyiminizi şöyle iyileştirebilir:

• Kodunuzdaki sözdizimini formatlayarak ve vurgulayarak.
• Yazarken kodunuzdaki ifadeleri otomatik tamamlama yolları sunarak.
• Değişkenler ve işlev bildirimlerine atlayarak kodunuzu navigasyon yapmanıza yardımcı olarak.
• Açık scriptlerde veya tüm scriptlerde bul ve değiştir yapmanıza yardımcı olarak.
• Kod kaliteniz ve performansınız hakkında gerçek zamanlı geri bildirim sağlayarak.

Script Editörü, her tür scripti destekler ve yeni bir script oluşturduğunuzda veya Explorer penceresinde mevcut bir scriptin üzerine ç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 kod ile ilgili bilgileri üretir, örneğin:

• Bilgili öneriler, yazarken tamamlamaları deneyimin veri modeli ile ilgili durumsal önerilerde bulunur. Örneğin, Workspace içinde RocketShip adında bir Model varsa, workspace.roc yazdığınızda otomatik tamamlama RocketShip önerir ve bunun bir Model olduğunu belirtir.

  

  Önerileri taramak 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.

• Değişkenler ve işlevler için otomatik doldurma adını, kaçınılmaz yazım hatalarından kaçınmanıza yardımcı olur.

  

• API kullanımınız hakkında bağlam sağlayan kod örnekleri içeren belgeler ile pop-up'lar. Engine API Referansı ile benzer şekilde, API'nın kullanımı hakkında bağlam sağlar.

  

• Özelleştirilmiş belgeler ile üzerlerine gelindiğinde gösterilen araç ipuçları.

  

• Hataları gidermeniz için kullanılabilecek bilgiler ile üzerlerine gelindiğinde script analizi tanılama bilgileri.

  

• Bir argüman yazdığınızda işlev imzaları, parametreleri ve döndürülen değerleri referans olarak size sağlar.

  

Kod navigasyonu

Bildirime git

Bir işlev veya değişkenin bildirimine atlamak için Windows'ta Ctrl veya Mac'te ⌘ tuşunu basılı tutarak çağrısına tıklayın veya çağrısına sağ tıklayıp Bildirime Git seçeneğine tıklayın.

Script işlevi filtresi

Script İşlevi Filtresi, bir scriptte tanımlı tüm işlevlerin bir listesini görüntüler. Açmak için Windows'ta AltF tuşlarına veya Mac'te ⌥F tuşlarına basın. Liste açıldığında her bir işlevin imzalarını gözden geçirebilir, adıyla filtreleyebilir ve birine çift tıklayarak bildirimine atlayabilirsiniz.

Bul ve değiştir

Bul/Değiştir widget'ı, açık bir scriptte kodu bulmanıza ve değiştirmenize olanak tanır. Widget, büyük/küçük harf eşleşmesine, tüm kelime eşleşmesine ve düzenli ifadeler ile arama yapmayı destekler. 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 sekmesinin araç çubuğundaki Analiz butonuyla erişilebilir, scriptinize statik analiz uygular ve aktif hataları ve uyarıları görüntüler. Hata 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ını veya işlevlerini öneren bir özelliktir, böylece daha verimli kod yazmanıza ve odaklanmanıza yardımcı olur. Yorum ve kodunuza dayanan öneriler iki şekilde tetiklenir:

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

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

Önerileri Geliştirme

Daha doğru ve ilgili öneriler almak için, herhangi bir yardım almadan temiz kodlama uygulamalarını takip etmeniz önerilir ve:

• Kodunuzu daha küçük işlevlere ayırın.
• Her bir scriptin ne yaptığını genel olarak yansıtan açıklayıcı script adları kullanın. Örneğin, bir scripti sadece Sesler yerine SyncCustomSounds olarak adlandırın.
• Parametreler, işlevler ve scriptler için açıklayıcı adlar verin. Örneğin, bir parçayı GreenSphere yerine sadece grs olarak adlandırın ya da bir işlevi generateSphere() yerine gen() olarak adlandırın. İsimli işlevlerin, anonim işlevlere kıyasla daha iyi ipuçları vereceğini unutmayın.
• Uyguladığınız görevi ve girdilerin/çıktıların ne olması gerektiğini açıklayan iyi yazılmış yorumlar eklemeyi sürekli olarak dahil edin.

  • Yorumlarda beklenen sonuçlarla bazı örnek çağrılar sağlamayı düşünebilirsiniz.
  • Bir sorunu çözme önerisinde bulunabilirsiniz, örneğin -- Raycast kullanın.
  • Tanımladığınız tam işlev veya değişken adını kullanın, örneğin -- 10 greenSphere nesnesi oluştur yerine -- 10 küre oluştur.
• Eğer acemi bir scripter iseniz, "bir parçaya dokunduklarında oyuncunun zıplamasını sağla" gibi temel projelerle başlayın veya bilginiz geliştikçe üstüne ekleyebileceğ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 önerileri sunmaz. Bilinen sınırlamalar şunlardır:

• Manuel tetikleme her zaman bir öneriyi zorla oluşturmaz.
• Öneriler, bir kod kümesi üzerinden makine öğrenimi ile öğrenildiği için, eğitim aldıkları kodun bazı sınırlamalarını yansıtabilir. Örneğin, öneriler yeni API'leri kullanmak yerine daha eski API'leri tercih edebilir veya Lua yerine Luau kullanabilir.
• Araç, amacınıza uygun olmayan yanlış veya yanıltıcı bilgiler üretebilir.
• İç filtreler saldırgan dili engellemeye çalışır, ancak hepsi kapsamlı değildir ve araç, saldırgan veya önyargılı bilgiler üretebilir.
• Öneriler, aynı istemlerle bile kullanıcılar arasında aynı, benzer ya da farklı olabilir. Ancak, kodunuz diğer kullanıcılarla asla paylaşılmaz.
• Öneri, öğrenme modellerinin sınırlı çıktısı nedeniyle eksik olabilir.
• Günlük öneri sayısında bir üst limit vardır ve limit aşılırsa, ertesi güne kadar öneri almazsınız.

Kod Gizliliği

Şu anda Roblox, öğrenme modellerini eğitmek için herhangi bir özel veriyi kullanmıyor. Araç yalnızca büyük dil modellerini ayarlamak için küçük bir serbest pazar varlıkları alt kümesini kullanır ve bu alt küme kalite ve güvenlik filtrelerinden 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ğitiminde kullanılmadığı için, diğer Kod Yardımı kullanıcılarına önerilmeyecek, tek istisna serbest pazar öğelerine kod yerleştirilmesi durumudur.

Çoklu imleç

Script Editörü, aynı anda düzenlemeleri yapmak üzere birden fazla imleç kullanımı destekler. İhtiyacınıza göre imleçleri fare tıklaması veya klavye kısayolu ile ekleyebilirsiniz. İlk imleç birincil imleç olarak adlandırılırken, 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ı/yine yapılması tüm imleçler için geçerlidir.
• Otomatik tamamlama gibi widget'lar yalnızca birincil imleçte görünür ancak ikincil imleçlerde görünmez.
• Script düzenleme için standart klavye kısayollarının tümü çoklu imleç düzenlemesi ile çalışır, bunlar arasında kod girintileme, yorumları açma/kapatma ve satır silme de bulunmaktadır.

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

İmleç ekleme

İmleçleri, klavye kısayolları ve fare hareketleri kombinasyonu ile ekleyebilirsiniz. İmleçler aynı alanı kaplıyorlarsa birleştirilir, örneğin ok tuşlarıyla imleç ekliyorsanız veya imleçler arasındaki tüm karakterleri silip tümüyle silerseniz.

Fare konumunda

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

1. Windows'ta Alt tuşunu ya da 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ık 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 ya da Mac'te ⌥ tuşunu basılı tutun.

2. Seçim üzerindeki fareyle tıklayıp sürükleyin.

Birincil imleç üstünde ve altında

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

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

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

Eşleşen seçimlere

Bir seçim veya bir sonraki/önceki eşleşmeye imleç ekleyebilir ve isteğe bağlı olarak eşleşmelerin büyük/küçük harfe duyarlı ve/veya tüm kelimelere uygun olup olmayacağını değiştirebilirsiniz.

Seçili bölümün tüm eşleşmelerine bir 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ç 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 ya da Mac'te ⌥ tuşunu basılı tutun.

2. Kaldırmak istediğiniz imleci 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ç kopyalama ve yapıştırma

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

• Eğer imleç sayıları eşitse, her kopyalanmış imleç, her karşılık gelen varış imlecine yapıştırılır.
• Eğer imleç sayıları farklıysa, destino'daki her imleç tüm yapıştırmayı alır ve her kopyalanmış imleç yeni bir satır olur.

Yazarken biçimlendirme

Enter/return tuşuna basılması, her imleci önceki satıra göre yeni satıra otomatik olarak girintiler. Önceki satır tamamlanmamış bir blokla başlıyorsa, biçimlendirici onu tamamlamaya çalışır.

Editör ayarları

Birçok özelleştirme seçeneği, Studio Ayarları altındaki Script Editörü sekmesi aracılığıyla erişilebilir. Yaygın olarak değiştirilen seçenekler şunlardır:

Klavye kısayolları

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