Editor naskah

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Editor skrip di Studio adalah alat utama untuk menulis skrip di Roblox .Ini adalah lingkungan yang ditingkatkan sendiri yang dapat membantu Anda menulis kode berdampak tinggi, mengurangi waktu pengembangan Anda, dan mengulangi pengalaman Anda.Ini dapat meningkatkan pengalaman penulisan skrip Anda dengan:

Editor Skrip mendukung semua jenis skrip dan membuka secara otomatis saat Anda membuat skrip baru atau mengklik dua kali skrip yang ada di jendela Explorer.

Fitur penyelesaian otomatis

Fitur penyelesaian otomatis Editor Skrip menghasilkan informasi terkait kode yang dapat meningkatkan efisiensi pemrograman Anda, seperti:

  • Saran terinformasi tentang cara menyelesaikan frasa saat Anda mengetiknya yang bersifat kontekstual pada model data pengalaman .Sebagai contoh, jika Anda memiliki Model di Workspace yang disebut RocketShip , autocomplete menyarankan RocketShip ketika Anda mengetik workspace.roc dan menunjukkan bahwa itu adalah Model .

    Autocomplete showing suggestions based on the experience's data model
  • Isi otomatis nama untuk variabel dan fungsi yang Anda menyatakan, membantu Anda menghindari kesalahan ketik yang menjengkelkan.

    Autocomplete showing suggestions based on a previously declared variable.
  • Popup dokumentasi dengan sampel kode yang mirip dengan yang ada di Referensi API Mesin, memberi Anda konteks tentang penggunaan API.

    Autocomplete showing suggestions based on a Roblox Engine API.
  • Tip alat di atas mouse yang dapat Anda kustomisasi dengan dokumentasi yang didefinisikan sendiri.

    Autocomplete showing custom documentation.
  • Diagnosis analisis skrip on-hover dengan informasi yang dapat Anda gunakan untuk memecahkan masalah kesalahan.

    Autocomplete showing diagnostic information.
  • Tanda tangan fungsi saat Anda mengetik argumen, memberi Anda referensi untuk parameter dan nilai kembali.

    Autocomplete showing function signature

Pergi ke deklarasi

Anda dapat melompat ke deklarasi fungsi atau variabel dengan menahan Ctrl di Windows atau di Mac saat mengklik panggilan, atau dengan mengklik kanan panggilannya dan mengklik Pergi ke Deklarasi .

Go to Declaration workflow on a declared function

filterfungsi skrip

Fungsi Filter Skrip menampilkan daftar semua fungsi yang dideklarasikan dalam skrip.Untuk membukanya, tekan AltF di Windows atau F di Mac.Dengan daftar terbuka, Anda dapat menelusuri tanda tangan untuk setiap fungsi, filter melalui nama, dan klik dua kali untuk melompat ke deklarasinya.

Script Function Filter showing all functions inside a script

Temukan dan ganti

Widget Temukan/Ganti memungkinkan Anda menemukan dan mengganti kode di skrip terbuka. Widget mendukung kasus cocok, mencocokkan seluruh kata, dan mencari dengan ekspresi reguler.Untuk membukanya, tekan CtrlF di Windows atau F di Mac.

Find/Replace widget labeled

Umpan balas masukannyata

Analisis Skrip

Jendela Analisis Skrip dapat diakses dari tab Pandangan, melakukan analisis statis pada skrip Anda dan menampilkan kesalahan dan peringatan aktif.Untuk informasi lebih lanjut tentang kesalahan dan peringatan, lihat dokumentasi Luau linting.

Script with various marked errors
Kesalahan skrip disorot di Editor Skrip
Script Analysis window with details on marked errors from script
Kesalahan dijelaskan di jendela Analisis Skrip

Output

Jendela Keluaran yang dapat diakses dari tab Pandangan, menampilkan kesalahan yang ditangkap dari menjalankan skrip, pesan dari Roblox Engine, pesan dari panggilan ke print() , dan kesalahan dari panggilan ke warn() .Untuk rincian tentang konfigurasi untuk alur kerja Anda, lihat Output.

Asisten Kode

Asisten Kode adalah fitur yang menyarankan baris atau fungsi kode saat Anda ketik, membantu Anda menulis kode lebih efisien dan tetap fokus.Berdasarkan konteks dari komentar dan kode Anda, saran akan dipicu dalam dua cara:

  • Secara otomatis saat Anda berhenti di satu baris selama beberapa detik dan model AI memiliki cukup konteks untuk saran.
  • Secara manual dengan pintasan pada Windows atau pada Mac (Anda dapat kustomisasi pintasan ini).

Tekan Tab untuk menerima saran, atau abaikan dengan terus ketik.Saat ini, skrip Anda harus berisi setidaknya beberapa baris kode untuk memicu saran.

Tingkatkan saran

Untuk mendapatkan saran yang lebih akurat dan relevan, disarankan agar Anda mengikuti praktik koding bersih, terlepas dari bantuan, dan:

  • Memecah kode Anda menjadi fungsi yang lebih kecil.
  • Gunakan nama skrip deskriptif yang menangkap niat umum dari apa yang dilakukan setiap skrip.Sebagai contoh, beri nama skrip SinkronisasiSuaraKustom alih-alih hanya Suara .
  • Tetuk nama deskriptif untuk parameter, fungsi, dan skrip.Sebagai contoh, beri nama bagian GreenSphere alih-alih hanya grs , atau beri nama fungsi generateSphere() alih-alih gen().Menggunakan fungsi bernama versus fungsi anonim juga dapat menghasilkan petunjuk yang lebih baik.
  • Secara konsisten termasuk komentar yang ditulis dengan baik yang menggambarkan tugas yang Anda terapkan dan apa yang harus menjadi input/ output.
    • Pertimbangkan untuk menyertakan beberapa panggilan sampel dengan hasil yang diharapkan dalam komentar.
    • Saran bagaimana memecahkan masalah, misalnya -- Use raycast .
    • Gunakan fungsi atau nama variabel yang tepat yang Anda definisikan, misalnya -- Create 10 greenSphere objects alih-alih -- Create 10 spheres.
  • Jika Anda seorang pemogram pemula, mulailah dengan proyek dasar seperti "membuat pemain melompat saat mereka menyentuh bagian" atau gunakan alat untuk menghasilkan potongan kode kecil yang dapat Anda perluas saat pengetahuan Anda tumbuh.

Keterbatasan

Alat ini membantu otomatisasi tugas pemrograman dasar tetapi tidak selalu menyarankan kode sempurna. Batasan yang dikenal termasuk:

  • Pemicu manual tidak selalu memaksakan menghasilkan saran.
  • Saran dipelajari oleh mesin dari kumpulan kode dan dapat mencerminkan beberapa batasan kode yang mereka latih.Sebagai contoh, saran mungkin tidak menggunakan API baru untuk mendukung API lama, atau mereka dapat menggunakan Lua alih-alih Luau.
  • Alat dapat menghasilkan informasi yang salah atau menyesatkan yang tidak berguna untuk tujuan Anda.
  • Filter internal berusaha untuk memblokir bahasa ofensif, tetapi mereka tidak menyeluruh dan ada kemungkinan alat dapat menghasilkan informasi ofensif atau berpihak.
  • Saran mungkin sama, serupa, atau berbeda di antara pengguna, bahkan dengan perintah yang sama. Namun kode Anda tidak akan pernah dibagikan dengan orang lain.
  • Saran mungkin tidak lengkap karena panjang output terbatas dari model pembelajaran.
  • Ada batas harian untuk jumlah saran dan, setelah batas tercapai, Anda tidak akan mendapatkan saran sampai hari berikutnya.

privasi

Saat ini, Roblox tidak menggunakan data non-publik apa pun untuk melatih model pembelajaran.Alat hanya menggunakan subset kecil dari aset pasar gratis untuk menyetel model bahasa besar dan subset telah melewati berbagai pemeriksaan untuk filter kualitas dan keamanan.

Selain itu, semua saran dihasilkan oleh model AI dan tidak mentransfer dari satu pengguna ke pengguna lain.Karena kode Anda tidak digunakan untuk pelatihan model, itu tidak akan disarankan kepada pengguna lain dari Asisten Kode , dengan satu pengecualian kode diposting ke item pasar gratis.

Multi-kursor

Editor Skrip mendukung penggunaan beberapa kursor untuk membuat perubahan secara bersamaan.Anda dapat menambahkan kursor berdasarkan kebutuhan Anda dengan klik mouse atau pintasan keyboard.Kursor awal disebut kursor utama dan kursor tambahan disebut kursor sekunder .

  • Edit yang Anda buat pada salinan kursor utama ke kursor sekunder.Setiap edit dihitung sebagai satu action, jadi membatalkan/menyelesaikan edit berlaku untuk semua kursor.
  • Widget seperti penyelesaian otomatis muncul di kursor utama tetapi bukan kursor sekunder.
  • Semua pintasan keyboard standar untuk pekerjaan pengeditan skrip dengan multi-kursor editing, termasuk penandaan kode, menyalakan komentar, dan menghapus baris.

Tabel berikut menyimpulkan alur kerja multi-kursor dan jalan pintasnya.

PerintahJendelaMakan Mac
Tambahkan/hapus kursor di lokasi mouse Alt + klik + klik
Hapus kurator terbaru yang ditambahkan CtrlUU
Tambahkan/modifikasi kursor saat seretan mouse Alt + seretan + seretan
Tambahkan kursor di atas/di bawah CtrlAlt  / CtrlAlt  /
Tambahkan kursor ke seleksi berikutnya yang cocok CtrlDD
Tambahkan kursor ke setiap pilihan yang cocok ShiftAltLShiftL
pilihkolom/blok ShiftAlt + seretShift + seret
Membagi seleksi menjadi baris ShiftAltIShiftI

Tambahkan kursor

Anda dapat menambahkan kursor dengan kombinasi pintasan keyboard dan manuver mouse.Kursor bergabung jika mereka menduduki ruang yang sama, seperti jika Anda menambahkan kursor dengan tombol panah atau menghapus semua karakter di antara kursor.

Pada lokasi mouse

Untuk menambahkan kursor di lokasi pointer mouse Anda:

  1. Tahan Alt di Windows atau di Mac.

  2. Klik di mana Anda ingin menambahkan kursor.

Dengan seretan mouse

Anda dapat menyeret mouse untuk menambahkan kursor ke seleksi, membagi seleksi multi-baris menjadi baris, atau memilih kolom dan blok kode/ruang kosong.

Untuk menambahkan kursor ke seleksi kode melalui seretan:

  1. Tahan Alt di Windows atau di Mac.

  2. Klik dan seret mouse Anda di atas pilihan kode.

Di atas dan di bawah kursor utama

Untuk menambahkan kursor langsung di atas atau di bawah kursor utama:

  1. Tekan dan tahan CtrlAlt di Windows atau di Mac.

  2. Tekan panah atau .

Untuk mencocokkan pilihan

Anda dapat menambahkan kursor ke semua pertandingan dari seleksi atau ke mencocokkanberikutnya/sebelumnya, dan secara opsional beralih apakah pertandingan sesuai dengan sensitif huruf besar/kecil dan/atau cocok dengan seluruh kata.

Untuk menambahkan kursor ke semua pertandingan dari bagian yang dipilih:

  1. Pilih kode yang ingin Anda cari cocokan.

  2. Tekan ShiftAltL pada Windows atau ShiftL pada Mac.

Hapus kursor

Anda dapat menghapus kursor dengan shortcut keyboard dan manuver mouse berikut.Alternatifnya, Anda dapat keluar dari pengeditan multi-kursor dengan menekan Esc .

Pada lokasi mouse

Untuk menghapus kursor:

  1. Tekan dan tahan Alt di Windows atau di Mac.

  2. Klik kursor yang ingin Anda hapus.

Terbaru ditambahkan

Untuk menghapus kursor yang paling baru ditambahkan, tekan CtrlU di Windows atau U di Mac.

Salin dan tempel kursor

Menyalin pilihan kode termasuk kursor di dalamnya.Perilaku paste tergantung pada jumlah kursor di sumber dan jumlah kursor di tujuan:

  • Jika jumlah kursor sama, maka setiap kursor yang disalin ditempel ke kurikuler tujuan yang sesuai.
  • Jika jumlah kursor berbeda, maka setiap kursor di tujuan menerima seluruh paste dengan setiap kursor yang disalin sebagai baris baru.

Formatasi tipe pada saat itu

Menekan enter/return akan secara otomatis mengidentifikasi setiap kursor di baris baru relatif terhadap baris sebelumnya.Jika baris sebelumnya dimulai dengan blok yang tidak lengkap, formatter akan mencoba untuk menyelesaikannya.

Pengaturan editor

Banyak opsi kustomisasi dapat diakses melalui FilePengaturan Studio ( AltS di Windows; S di Mac).

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

Opsi yang dimodifikasi secara umum termasuk:

PilihanDeskripsi
Jenis huruf Wajah dan ukuran huruf untuk kode di editor.
Lebar tab Jumlah ruang yang mewakili indentasi Tab .
Mengidentifikasi menggunakan spasi Jika diaktifkan, ruang yang sama dengan Lebar Tab dimasukkan dengan tekan Tab.
Pengemasan teks Jika diaktifkan, baris kode yang lebih panjang dibungkus ke baris berikutnya.
Prasetel warna Editor Skrip Prasetel warna untuk elemen kode, warna seleksi, dan banyak lagi.Setelah memilih prasetel, Anda dapat mengatur warna spesifik untuk opsi seperti Warna Pilihan dan Komentar Warna .

Jeda pintasan keyboard

Editor Skrip memiliki shortcut keyboard berikut.Anda juga dapat mengakses banyak perintah dari tab Skrip yang muncul di bilah alat Studio setiap kali Anda melihat atau mengedit skrip.

PerintahJendelaMakan Mac
Tutup skrip CtrlWW
Buka kembali skrip terakhir yang ditutup CtrlShiftTShiftT
Buka cepat CtrlPP
Tampilkan skrip di Explorer CtrlAltKK
Perbesar Ctrl==
Perbesar keluar Ctrl--
Setel ulang zoom skrip Ctrl00