Trình Biên Soạn Kịch Bản

Trình Biên Soạn Kịch Bản trong Studio là công cụ chính để lập trình trên Roblox. Đây là một môi trường tự cải thiện có thể giúp bạn viết mã hiệu quả, rút ngắn thời gian phát triển và lặp lại trên các trò chơi của bạn. Nó có thể cải thiện trải nghiệm lập trình của bạn bằng cách:

• Định dạng và tô sáng cú pháp trong mã của bạn.
• Cung cấp cách để tự động hoàn thành các cụm từ trong mã khi bạn gõ.
• Giúp bạn dẫn hướng mã bằng cách nhảy đến các khai báo biến và hàm.
• Giúp bạn tìm và thay thế mã trong các kịch bản mở hoặc tất cả các kịch bản.
• Cung cấp phản hồi theo thời gian thực về chất lượng và hiệu suất mã của bạn.

Trình Biên Soạn Kịch Bản hỗ trợ tất cả các loại kịch bản và tự động mở khi bạn tạo một kịch bản mới hoặc nhấp đúp vào một kịch bản hiện có trong cửa sổ Explorer.

Tính năng tự động hoàn thành

Các tính năng tự động hoàn thành của Trình Biên Soạn Kịch Bản tạo ra thông tin liên quan đến mã có thể cải thiện hiệu suất lập trình của bạn, chẳng hạn như:

• Gợi ý thông minh về cách hoàn thành các cụm từ khi bạn gõ chúng, phù hợp với mô hình dữ liệu của trò chơi. Ví dụ, nếu bạn có một Model trong Workspace gọi là RocketShip, tự động hoàn thành sẽ gợi ý RocketShip khi bạn gõ workspace.roc và chỉ ra rằng đó là một Model.

  

  Sử dụng các phím ↑ và ↓ để duyệt qua các gợi ý, sau đó nhấn Tab hoặc Enter để chấp nhận một gợi ý và chèn cụm từ hoàn chỉnh.

• Tự động điền tên cho các biến và hàm mà bạn khai báo, giúp bạn tránh những lỗi chính tả phiền phức.

  

• Cửa sổ tài liệu với mẫu mã tương tự như trên Tài liệu API Engine, cung cấp cho bạn ngữ cảnh về cách sử dụng API.

  

• Tooltip khi di chuột mà bạn có thể tùy chỉnh với tài liệu do bạn định nghĩa.

  

• Chẩn đoán phân tích kịch bản khi di chuột với thông tin mà bạn có thể sử dụng để khắc phục lỗi.

  

• Chữ ký hàm khi bạn gõ một đối số, cung cấp cho bạn một tham chiếu cho các tham số và giá trị trả về của nó.

  

Dẫn hướng mã

Đi đến khai báo

Bạn có thể nhảy đến khai báo của một hàm hoặc biến bằng cách giữ Ctrl trên Windows hoặc ⌘ trên Mac khi nhấp vào lời gọi, hoặc bằng cách nhấp chuột phải vào lời gọi của nó và nhấp vào Đi đến Khai báo.

Bộ lọc hàm kịch bản

Bộ Lọc Hàm Kịch Bản hiển thị danh sách tất cả các hàm đã khai báo trong một kịch bản. Để mở nó, nhấn AltF trên Windows hoặc ⌥F trên Mac. Khi danh sách mở, bạn có thể duyệt qua các chữ ký cho mỗi hàm, lọc qua chúng theo tên và nhấp đúp vào một hàm để nhảy đến khai báo của nó.

Tìm và thay thế

Tiện ích Tìm/Thay thế cho phép bạn tìm và thay thế mã trong một kịch bản mở. Tiện ích hỗ trợ khớp chữ hoa chữ thường, khớp toàn bộ từ và tìm kiếm bằng biểu thức chính quy. Để mở nó, nhấn CtrlF trên Windows hoặc ⌘F trên Mac.

Phản hồi theo thời gian thực

Phân tích Kịch bản

Cửa sổ Phân Tích Kịch Bản, có thể truy cập thông qua nút Phân Tích trong thanh công cụ tab Kịch bản của Studio, thực hiện phân tích tĩnh trên các kịch bản của bạn và hiển thị các lỗi và cảnh báo đang hoạt động. Để biết thêm thông tin về các lỗi và cảnh báo, xem tài liệu Luau linting.

Đầu ra

Cửa sổ Đầu ra hiển thị các lỗi được ghi lại từ việc chạy các kịch bản, thông điệp từ engine Roblox, thông điệp từ các cuộc gọi đến print(), và các lỗi từ các cuộc gọi đến warn().

Hỗ trợ Mã

Hỗ trợ Mã là một tính năng gợi ý các dòng hoặc hàm mã khi bạn gõ, giúp bạn lập trình hiệu quả hơn và tập trung hơn. Dựa trên ngữ cảnh từ bình luận và mã của bạn, các gợi ý sẽ được kích hoạt theo hai cách:

• Tự động khi bạn dừng lại trên một dòng trong vài giây và mô hình AI có đủ ngữ cảnh để đưa ra gợi ý.
• Thủ công với phím tắt Alt∖ trên Windows hoặc ⌥∖ trên Mac.

Nhấn Tab để chấp nhận một gợi ý, hoặc bỏ qua nó bằng cách tiếp tục gõ. Hiện tại, kịch bản của bạn cần chứa ít nhất một vài dòng mã để kích hoạt một gợi ý.

Cải thiện gợi ý

Để có được các gợi ý chính xác và phù hợp hơn, bạn nên tuân theo các thực hành lập trình sạch, bất kể có sự hỗ trợ hay không, và:

• Phân chia mã của bạn thành các hàm nhỏ hơn.
• Sử dụng tên kịch bản mô tả mà nắm bắt được ý định tổng thể của những gì mỗi kịch bản thực hiện. Ví dụ, đặt tên cho một kịch bản là SyncCustomSounds thay vì chỉ là Sounds.
• Gán tên mô tả cho các tham số, hàm và kịch bản. Ví dụ, đặt tên cho một phần là GreenSphere thay vì chỉ là grs, hoặc đặt tên cho một hàm là generateSphere() thay vì gen(). Sử dụng các hàm có tên so với các hàm vô danh cũng có thể tạo ra các gợi ý tốt hơn.
• Liên tục bao gồm các bình luận được viết tốt mô tả nhiệm vụ bạn đang thực hiện và những gì các đầu vào/đầu ra nên có.

  • Cân nhắc bao gồm một số cuộc gọi mẫu với kết quả mong đợi trong các bình luận.
  • Đề xuất cách giải quyết một vấn đề, chẳng hạn như -- Sử dụng raycast.
  • Sử dụng tên hàm hoặc biến chính xác mà bạn đã định nghĩa, chẳng hạn như -- Tạo 10 đối tượng greenSphere thay vì -- Tạo 10 hình cầu.
• Nếu bạn là một lập trình viên mới, hãy bắt đầu với các dự án cơ bản như "làm cho người chơi nhảy khi họ chạm vào phần" hoặc sử dụng công cụ để tạo ra các đoạn mã nhỏ mà bạn có thể mở rộng khi kiến thức của bạn phát triển.

Giới hạn

Công cụ giúp tự động hóa các tác vụ lập trình cơ bản nhưng không phải lúc nào cũng gợi ý mã hoàn hảo. Các giới hạn đã biết bao gồm:

• Kích hoạt thủ công không luôn tạo ra một gợi ý.
• Các gợi ý được học từ một tập hợp mã và do đó có thể phản ánh một số giới hạn của mã mà chúng được đào tạo. Ví dụ, các gợi ý có thể không sử dụng các API mới hơn mà thay vào đó là các API cũ hơn, hoặc chúng có thể sử dụng Lua thay vì Luau.
• Công cụ có thể tạo ra thông tin không chính xác hoặc gây hiểu lầm mà không hữu ích cho mục đích của bạn.
• Các bộ lọc nội bộ cố gắng chặn ngôn ngữ xúc phạm, nhưng chúng không hoàn toàn và có khả năng công cụ có thể tạo ra thông tin xúc phạm hoặc thiên lệch.
• Các gợi ý có thể giống nhau, tương tự hoặc khác nhau giữa các người dùng, ngay cả với cùng một lời nhắc. Tuy nhiên, mã của bạn sẽ không bao giờ được chia sẻ với người khác.
• Gợi ý có thể không đầy đủ do độ dài đầu ra hạn chế từ các mô hình học.
• Có một giới hạn hàng ngày cho số lượng gợi ý và, khi đạt đến giới hạn, bạn sẽ không nhận được gợi ý cho đến ngày hôm sau.

Quyền riêng tư mã

Hiện tại, Roblox không sử dụng bất kỳ dữ liệu không công khai nào để đào tạo các mô hình học. Công cụ chỉ sử dụng một tập hợp nhỏ các tài sản thị trường miễn phí để điều chỉnh các mô hình ngôn ngữ lớn và tập hợp này đã vượt qua nhiều kiểm tra về chất lượng và bộ lọc an toàn.

Hơn nữa, tất cả các gợi ý đều được tạo ra bởi mô hình AI và không chuyển từ người dùng này sang người dùng khác. Vì mã của bạn không được sử dụng cho việc đào tạo mô hình, nó sẽ không được gợi ý cho các người dùng khác của Hỗ trợ Mã, với một ngoại lệ là mã được đăng lên các mục thị trường miễn phí.

Đa con trỏ

Trình Biên Soạn Kịch Bản hỗ trợ việc sử dụng nhiều con trỏ để thực hiện các chỉnh sửa đồng thời. Bạn có thể thêm con trỏ dựa trên nhu cầu của bạn bằng cách nhấp chuột hoặc phím tắt. Con trỏ ban đầu được gọi là con trỏ chính và các con trỏ bổ sung được gọi là con trỏ phụ.

• Các chỉnh sửa mà bạn thực hiện tại con trỏ chính sẽ được sao chép đến các con trỏ phụ. Mỗi chỉnh sửa được tính là một hành động, vì vậy việc hoàn tác/làm lại một chỉnh sửa sẽ áp dụng cho tất cả các con trỏ.
• Các tiện ích như tự động hoàn thành xuất hiện trên con trỏ chính nhưng không xuất hiện trên các con trỏ phụ.
• Tất cả các phím tắt tiêu chuẩn cho việc chỉnh sửa kịch bản đều hoạt động với chỉnh sửa đa con trỏ, bao gồm thụt lề mã, bật/tắt bình luận và xóa dòng.

Bảng sau tóm tắt các quy trình làm việc đa con trỏ và các phím tắt của chúng.

Thêm con trỏ

Bạn có thể thêm con trỏ bằng cách kết hợp các phím tắt và thao tác chuột. Các con trỏ sẽ hợp nhất nếu chúng chiếm cùng một không gian, chẳng hạn như nếu bạn thêm con trỏ bằng các phím mũi tên hoặc xóa tất cả các ký tự giữa các con trỏ.

Tại vị trí chuột

Để thêm một con trỏ tại vị trí con trỏ chuột của bạn:

1. Giữ Alt trên Windows hoặc ⌥ trên Mac.

2. Nhấp vào nơi bạn muốn thêm con trỏ.

Với kéo chuột

Bạn có thể kéo chuột để thêm một con trỏ vào một lựa chọn, chia một lựa chọn nhiều dòng thành các dòng, hoặc chọn các cột và khối mã/khoảng trắng.

Để thêm một con trỏ vào một lựa chọn mã thông qua kéo:

1. Giữ Alt trên Windows hoặc ⌥ trên Mac.

2. Nhấp và kéo chuột của bạn qua lựa chọn mã.

Trên và dưới con trỏ chính

Để thêm một con trỏ ngay trên hoặc dưới con trỏ chính:

1. Nhấn và giữ CtrlAlt trên Windows hoặc ⌘⌥ trên Mac.

2. Nhấn các phím mũi tên ↑ hoặc ↓.

Đến các lựa chọn khớp

Bạn có thể thêm con trỏ đến tất cả các khớp của một lựa chọn hoặc đến khớp tiếp theo/trước đó, và tùy chọn bật/tắt việc khớp có phân biệt chữ hoa chữ thường và/hoặc khớp toàn bộ từ.

Để thêm một con trỏ vào tất cả các khớp của một phần đã chọn:

1. Chọn mã mà bạn muốn tìm kiếm các khớp.

2. Nhấn ShiftAltL trên Windows hoặc Shift⌥L trên Mac.

Xóa con trỏ

Bạn có thể xóa con trỏ bằng các phím tắt và thao tác chuột sau đây. Ngoài ra, bạn có thể thoát khỏi chỉnh sửa đa con trỏ bằng cách nhấn Esc.

Tại vị trí chuột

Để xóa một con trỏ:

1. Nhấn và giữ Alt trên Windows hoặc ⌥ trên Mac.

2. Nhấp vào con trỏ mà bạn muốn xóa.

Con trỏ được thêm gần đây nhất

Để xóa con trỏ được thêm gần đây nhất, nhấn CtrlU trên Windows hoặc ⌘U trên Mac.

Sao chép và dán con trỏ

Việc sao chép một lựa chọn mã bao gồm các con trỏ bên trong nó. Hành vi của việc dán phụ thuộc vào số lượng con trỏ tại nguồn và số lượng con trỏ tại đích:

• Nếu số lượng con trỏ giống nhau, thì mỗi con trỏ đã sao chép sẽ dán vào mỗi con trỏ đích tương ứng.
• Nếu số lượng con trỏ khác nhau, thì mỗi con trỏ tại đích sẽ nhận toàn bộ dán với mỗi con trỏ đã sao chép như một dòng mới.

Định dạng khi gõ

Nhấn enter/return sẽ tự động thụt lề mỗi con trỏ ở dòng mới tương ứng với dòng trước đó. Nếu dòng trước đó bắt đầu với một khối chưa hoàn chỉnh, bộ định dạng sẽ cố gắng hoàn thành nó.

Cài đặt trình biên soạn

Nhiều tùy chọn tùy chỉnh có thể truy cập thông qua tab Trình Biên Soạn Kịch Bản của Cài đặt Studio. Các tùy chọn thường được sửa đổi bao gồm:

Phím tắt

Trình Biên Soạn Kịch Bản có các phím tắt sau.