Senaryo editörü

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

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:

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.

    Autocomplete showing suggestions based on the experience's data model
  • 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.

    Autocomplete showing suggestions based on a previously declared variable.
  • Kod örnekleri içeren belge açılır pencereleri , motorun API referansındakilere benzer olarak, API'nin kullanımı konusunda size konteks verir.

    Autocomplete showing suggestions based on a Roblox Engine API.
  • Kendi tanımladığınız dokümanla özelleştirebileceğiniz araç ipuçları üzerinde, kendi belgelerinizle özelleştirebileceğiniz

    Autocomplete showing custom documentation.
  • Hover üzerinde kript analizi diagnostikleri , hata gidermek için kullanabileceğiniz bilgilerle.

    Autocomplete showing diagnostic information.
  • 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.

    Autocomplete showing function signature

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.

Go to Declaration workflow on a declared function

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.

Script Function Filter showing all functions inside a script

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.

Find/Replace widget labeled

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.

Script with various marked errors
Kod Editöründe vurgulanan kod hataları
Script Analysis window with details on marked errors from script
Kript analiz penceresinde açıklanan hatalar

Çı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.

KomutPencerelerMac
Fare konumunda işaretçiyi ekleyin/kaldırın Alt + tıklama + tıklama
En yeni eklenen işaretçiyi kaldır CtrlUU
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 CtrlDD
Her eşleşen seçime işaretçi ekleyin ShiftAltLShiftL
Sütun/blok seçimi ShiftAlt + sürüklemeShift + sürükleme
Seçimleri satırlara ayırma ShiftAltIShiftI

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:

  1. Windows'ta Alt veya Mac'te üzerinde tutun.

  2. İş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:

  1. Windows'ta Alt veya Mac'te üzerinde tutun.

  2. 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:

  1. Windows'ta basılı tut CtrlAlt veya Mac'te basılı tut üzerinde.

  2. 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:

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

  2. 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:

  1. Windows'ta basılı tut Alt veya Mac'te basılı tut .

  2. 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).

A close up view of the Studio Settings window with the Script Editor tab selected.

Sıklıkla değiştirilen seçenekler şunları içerir:

SeçenekAçı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.

KomutPencerelerMac
Senaryoyu kapat CtrlWW
Son kapatılan senaryoyu yeniden aç CtrlShiftTShiftT
Hızlı aç CtrlPP
Kâşifte kodu göster CtrlAltKK
Yakınlaş Ctrl==
Küçült Ctrl--
Senaryo yakınlaştırmasını sıfırla Ctrl00