Studio'daki senaryo editörü Roblox'ta senaryo yazmak için ana araçtır.Yüksek etkili kod yazmanıza, geliştirme sürenizi kısaltmanıza ve deneyimlerinize geri dönmenize yardımcı olabilecek kendi kendini geliştiren bir çevre.Kodlama deneyiminizi şu şekilde geliştirebilir:
- Kodunuzdaki sentaksı biçimlendirme ve vurgulama.
- Kodunuzda yazarken otomatik tamamlanma ifadelerine yol sunmak.
- Sana kod navigasyonuna yardım etmek için değişken ve işlev ilanlarına atlayarak.
- Açık kaynaklardaki veya tüm kaynaklardaki kodu bulmanıza ve değiştirmenize yardımcı oluyor bulmak ve değiştirmek.
- Kod kaliteniz ve performansınız üzerinde gerçek zamanlı geri bildirim sağlamak.
Senaryo Editörü tüm senaryoları destekler ve yeni bir senaryo oluşturduğunuzda veya mevcut bir senaryoyu Kâşif penceresinde iki kez tıkladığınızda otomatik olarak açılır.
Otomatik tamamla özellikleri
Senaryo Editörünün otomatik tamamlayıcı özellikleri, programlama verimliliğinizi artırabilecek kodla ilgili bilgiler üretir, örneğin:
Deneyime özgü şekilde yazılan cümlelerin nasıl bitirileceğine dair bilgilendirici öneriler , deneyimin veri modeline bağlı olanları üzerine yazılırken.Örneğin, 'a RocketShip adlı bir şey varsa, otomatik tamamla önerir , yazarken ve bunun bir olduğunu belirtir.
Otomatik doldurma isimleri deklarasyon ettiğiniz değişkenler ve işlevler için, sizi rahatsız edici yazım hatalarından kaçınmanıza yardımcı oluyor.
Kod örnekleri içeren belge açılır pencereleri , motorun API referansındakilere benzer olarak, API'nin kullanımı konusunda size konteks verir.
Kendi tanımladığınız dokümanla özelleştirebileceğiniz araç ipuçları üzerinde, kendi belgelerinizle özelleştirebileceğiniz
Hover üzerinde kript analizi diagnostikleri , hata gidermek için kullanabileceğiniz bilgilerle.
Fonksiyon imzaları , bir argüman yazarken, onun parametreleri ve dönüş değerleri için bir referans sağlarken bir argüman yazarsınız.
Kod navigasyonu
Bildirime git
Fonksiyon veya değişkenin ilanına atlayabilirsiniz, bir çağrıyı tıkladığınızda Windows'ta Ctrl veya Mac'te ⌘ sağ tıklayarak çağrısına gidin ve İlan'a git seçeneğini tıklatın.

Senaryo işlev filtresi
The Kript İşlev Filtresi bir kriptte beyan edilen tüm işlevlerin bir listesini görüntüler.Onu açmak için, Windows'ta AltF veya Mac'te ⌥F üzerinde basın.Liste açık olduğunda, her fonksiyonun imzalarını gezebilir, isimle filtreleyebilir ve birine çift tıklayarak onun ilanına geçebilirsiniz.

Bul ve değiştir
Bul/Değiştir düğmesi, açık bir senaryoda kodu bulmanızı ve değiştirmenizi sağlar. widget eşleşen durumu destekler, tüm kelimeyi eşleştirir ve düzenli ifadelerle arar.Onu açmak için, Windows'ta CtrlF veya Mac'te ⌘F üzerinde basın.

Gerçek zamanlı geri bildirim
Senaryo Analizi
Kod analizi penceresi, Görüntüleme sekmesinden erişilebilir ve senaryolarınız üzerinde statik analiz yapar ve aktif hata ve uyarıları görüntüler.Hatalar ve uyarılar hakkında daha fazla bilgi için, Luau linting belgelerine bakın.


Çıkış
Çıkış penceresi, Görüntüleme sekmesinden erişilebilen hataları görüntüler: yürütülen kodlardan yakalanan hatalar, Roblox Motorundan gelen mesajlar, print() 'a yapılan çağrılardan gelen hatalar ve warn() 'a yapılan çağrılardan gelen hatalar.İş akışınız için yapılandırmayla ilgili ayrıntılar için, bakın Çıkış.

Kod Yardımı
Kod Yardımı , yazarken kod satırlarını veya işlevlerini öneren bir özelliktir, böylece daha verimli kod yazıp odaklanmanıza yardımcı olur.Yorum ve koddan gelen bağlamlara dayanarak, öneriler iki şekilde tetiklenecektir:
- Otomatik olarak birkaç saniye boyunca bir satıra durakladığınızda ve AI modelinin bir öneri için yeterli bağlama sahip olduğunda.
- Manuel olarak kısayol ile Windows'ta veya Mac'ta (bu kısayolu özelleştirebilirsiniz özelleştirebilirsiniz).
Bir öneriyi kabul etmek için Tab'ye basın veya devam ederek görmezden gelin.Şu anda, senaryonuz bir öneriyi tetiklemek için en az birkaç satır kod içermelidir.
Önerileri geliştir
Daha doğru ve alakalı öneriler almak için, destek olmasına rağmen temiz kodlama uygulamalarını takip etmeniz önerilir ve:
- Kodunuzu daha küçük işlevlere bölün.
- Her bir senaryonun genel niyetini yakalayan tanımlayıcı senaryo isimlerini kullanın.Örneğin, bir kaydı adlandır SyncCustomSounds yerine sadece Sesler .
- Değişkenler, işlevler ve senaryolar için tanımlayıcı isimler atayın.Örneğin, bir parçaya Yeşil Küre yerine basitçe grs yerine ad verin, veya bir işlev generateSphere() yerine gen() yerine ad verin.İsimli işlevlerle anonim işlevlerin kullanılması da daha iyi ipuçlar üretebilir.
- Uyguladığınız görevi ve giriş/çıkışların ne olması gerektiğini tanımlayan iyi yazılmış yorumları düzenli olarak dahil edin
- Yorumlara beklenen sonuçlarla bazı örnek çağrılar dahil etmeyi düşünün.
- Örneğin bir sorunu nasıl çözeceğinizi önerin, örneğin -- Use raycast .
- Örneğin, tanımladığınız kesin işlev veya değişken adını kullanın, örneğin -- Create 10 greenSphere objects yerine -- Create 10 spheres.
- Eğer yeni bir yazılımcıysanız, "oyuncuyu parçaya dokunduğunda atlamasını sağla" veya bilginiz arttıkça genişletebileceğiniz küçük kod parçaları üretmek için araç kullanarak temel projelerle başlayın.
Sınırlar
Araç temel kodlama görevlerini otomatikleştirmeye yardımcı olur, ancak daima mükemmel kodu önermez. Bilinen sınırlar şunları içerir:
- Manuel tetikleme asla her zaman bir öneri oluşturmaz.
- Öneriler, bir kod kütüphanesinden makine öğrenilmiştir ve bu nedenle eğitildikleri kodun bazı sınırlarını yansıtabilir.Örneğin, öneriler eski API'ler yerine yeni API'leri kullanmayabilir veya Luau yerine Lua'yı kullanabilir.
- Araç, amacınız için yararlı olmayan yanlış veya yanıltıcı bilgi üretebilir.
- İç filtreler saldırgan dili engellemeye çalışır, ancak hepsi kapsayıcı değildir ve araçta saldırgan veya önyargılı bilgiler üretme olasılığı vardır.
- Öneriler kullanıcılar arasında aynı, benzer veya farklı olabilir, hatta aynı sorularla bile. Ancak kodunuz asla başkalarıyla paylaşılmayacaktır.
- Öğrenme modellerinden gelen sınırlı çıktı uzunluğu nedeniyle öneri tamamlanmamış olabilir.
- Öneri sayısı için günlük bir sınır var ve sınıra ulaştıktan sonra bir sonraki güne kadar öneri almayacaksınız.
Kod gizliliği
Şu anda, Roblox öğrenme modellerini eğitmek için herhangi bir halka açık olmayan veri kullanmıyor.Araç yalnızca büyük dil modellerini ayarlamak için ücretsiz pazar kaynaklarının küçük bir kısmını kullanır ve alt set, kalite ve güvenlik filtreleri için çeşitli kontrollerden geçti.
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ığından, Kod Yardımı 'nın diğer kullanıcılara önerilmeyeceği, serbest pazara yayınlanan kodun bir istisnası dışında.
Çoklu işaretleyici
Senaryo Editörü, aynı anda düzenlemeler yapmak için çok sayıda kursörün kullanımını destekler.Gereksinimlerinize göre bir fare tıklaması veya klavye kısayolu ile işaretçiler ekleyebilirsiniz.Başlangıç kuruluşu birincil kursor olarak adlandırılır ve ek kursörler ikincil kursörler olarak adlandırılır.
- Birincil işaret kopyasında yaptığınız düzenlemeleri ikincil işaretçilere aktarır.Her düzenleme bir eylem olarak sayılır, bu nedenle bir düzenlemenin geri alınması/yeniden yapılması tüm oklara uygulanır.
- Otomatik tamamla gibi widgetler birincil işaretçide görünür, ancak ikincil işaretçilerde değil.
- Senaryo düzenleme işlemi için standart klavye kısa yolları tümü, kod imleme, yorum değiştirme ve satır silme dahil çoklu kurşun düzenleme ile çalışır.
Aşağıdaki tablo, çoklu iş akışlarını ve kısayollarını özetlemektedir.
Komut | Pencereler | Mac |
---|---|---|
Fare konumunda işaretçiyi ekleyin/kaldırın | Alt + tıklama | ⌥ + tıklama |
En yeni eklenen işaretçiyi kaldır | CtrlU | ⌘U |
Fare sürükleme sırasında işaretçiyi ekleyin/modifiye edin | Alt + sürükleme | ⌥ + sürükleme |
Fareyi yukarı/aşağı ekleyin | CtrlAlt↑ / CtrlAlt↓ | ⌘⌥↑ / ⌘⌥↓ |
Sonraki eşleşen seçime işaretçi ekleyin | CtrlD | ⌘D |
Her eşleşen seçime işaretçi ekleyin | ShiftAltL | Shift⌥L |
Sütun/blok seçimi | ShiftAlt + sürükleme | Shift⌥ + sürükleme |
Seçimleri satırlara ayırma | ShiftAltI | Shift⌥I |
Kuralları ekleyin
Klavye kısa yolları ve fare hareketlerinin bir kombinasyonuyla işaretçiler ekleyebilirsiniz.Ok işaretleri aynı alanı kaplıyorsa birleşir, örneğin ok işaretlerini ok tuşlarıyla ekleyin veya ok aralarındaki tüm karakterleri silin.
Fare konumunda At the mouse location
Fare işaretleyici konumuna bir kurmaç eklemek için:
Windows'ta Alt veya Mac'te ⌥ üzerinde tutun.
İşaretleyici eklemek istediğiniz yere tıklayın.
Fare sürükleme ile
Fareyi sürükleyerek bir seçime işaretçi ekleyebilir, çok satırlı bir seçimi satırlara ayırabilir veya kod veya boşluk bloklarını seçebilirsiniz.
Kodun bir seçime eklemek için kaydırarak bir işaretçi eklemek için:
Windows'ta Alt veya Mac'te ⌥ üzerinde tutun.
Kod seçimine tıklayın ve fareyi sürükleyin.
Ana işaretçinin üstünde ve altında
Ana işaretin üzerinde veya altında doğrudan bir işaret eklemek için:
Windows'ta basılı tut CtrlAlt veya Mac'te basılı tut ⌘⌥ üzerinde.
↑ veya ↓ oklarına basın.
Seçimlere eşleştirme için
Seçimin tüm maçlarına veya bir sonraki/önceki maça işaretçiler ekleyebilir ve isteğe bağlı olarak eşleşmelerin büyük/küçük harflere duyarlı olup olmadığını veya tüm kelimeyi eşleştirdiğini değiştirebilirsiniz.
Seçili bir bölümün tüm eşleşenlerine bir işaretçi eklemek için:
Eşleşmek istediğiniz kodu seçin.
Windows'ta üzerinde Mac'te basın.
İşaretçileri kaldır
İşaretçileri aşağıdaki klavye kısa yolları ve fare hareketleriyle kaldırabilirsiniz.Alternatif olarak, Esc tuşuna basarak çoklu işaret düzenlemeyi sonlandırabilirsiniz.
Fare konumunda At the mouse location
Bir işaretçiyi kaldırmak için:
Windows'ta basılı tut Alt veya Mac'te basılı tut ⌥ .
Kaldırmak istediğiniz kursörü tıklayın.
En yeni eklenenler
En yeni eklenen işaretçiyi kaldırmak için, Windows'ta CtrlU veya Mac'ta ⌘U üzerine basın.
Kursörleri kopyalayıp yapıştırın
Kodun bir seçiminin kopyalanması içindeki işaretçileri de içerir.Yapıştırmanın davranışı, kaynağındaki kurma sayısına ve hedefteki kurma sayısına bağlıdır:
- Eğer kursör sayısı aynıysa, her kopyalanmış kursör ilgili hedef kursörüne yapışır.
- Eğer kursör sayısı farklıysa, hedefteki her kursör, kopyalanan her kursörle birlikte yeni bir satır olarak tüm yapıştırmayı alır.
Tip üzerinde biçimlendirme
Enter/return tuşuna basmak, önceki satıra göre yeni satıra ilişkin her kursörü otomatik olarak işaretleyecektir.Önceki satır bir tamamlanmamış blokla başlarsa, biçimlendirici onu tamamlamaya çalışacaktır.
Editör ayarları
Birçok özelleştirme seçeneği Dosya üzerinden erişilebilir Stüdyo Ayarları (Windows'ta üzerinde Mac; üzerinde Mac).

Sıklıkla değiştirilen seçenekler şunları içerir:
Seçenek | Açıklama |
---|---|
Yazı Tipi | Düzenleyicideki kod için yazı tipi ve boyutu. |
Tab genişliği | Bir Tab boşluk işaretleyen alan sayısı. |
Boşluklar kullanarak girinti yap | Etkinleştirildiğinde, Tab Genişliği eşit olan boşluklar Tab girilir. |
Metin sarılması | Etkinleştirildiğinde, daha uzun kod satırları bir sonraki satıra sarılır. |
Senaryo Editörü renk ön ayarı | Kod öğeleri için renk ön ayarı, seçim renkleri ve daha fazlası.Ön ayar seçtikten sonra, Seçim Rengi ve Yorum Rengi gibi seçenekler için özel renkler ayarlayabilirsiniz. |
Klavye kısa yolları
Senaryo Editörü'nün aşağıdaki klavye kısa yolları vardır.Ayrıca, bir senaryoyu görüntülediğinizde veya düzenlediğinizde Studio çubuğunda görünen Komutlar sekmesinden de birçok komuta erişebilirsiniz.
Komut | Pencereler | Mac |
---|---|---|
Senaryoyu kapat | CtrlW | ⌘W |
Son kapatılan senaryoyu yeniden aç | CtrlShiftT | ⌘ShiftT |
Hızlı aç | CtrlP | ⌘P |
Kâşifte kodu göster | CtrlAltK | ⌘⌥K |
Yakınlaş | Ctrl= | ⌘= |
Küçült | Ctrl- | ⌘- |
Senaryo yakınlaştırmasını sıfırla | Ctrl0 | ⌘0 |