스크립트 편집기

Studio의 스크립트 편집기는 Roblox에서 스크립팅을 위한 주요 도구입니다. 이는 고-impact 코드를 작성하고 개발 시간을 단축하며 게임을 반복할 수 있도록 도와주는 자기 개선 환경입니다. 스크립팅 경험을 향상시킬 수 있는 방법은 다음과 같습니다:

• 코드의 구문을 포맷하고 하이라이팅합니다.
• 입력하는 동안 코드의 구문을 자동 완성하는 방법을 제공합니다.
• 변수 및 함수 선언으로 점프하여 코드를 탐색하는 데 도움을 줍니다.
• 열린 스크립트 또는 모든 스크립트에서 코드를 찾고 바꾸는 데 도움을 줍니다.
• 코드 품질 및 성능에 대한 실시간 피드백을 제공합니다.

스크립트 편집기는 모든 유형의 스크립트를 지원하며, 새 스크립트를 만들거나 탐색기 창에서 기존 스크립트를 더블 클릭할 때 자동으로 열립니다.

자동 완성 기능

스크립트 편집기의 자동 완성 기능은 프로그래밍 효율성을 향상시킬 수 있는 코드 관련 정보를 생성합니다. 예를 들어:

• 정보에 기반한 제안: 입력하는 동안 게임의 데이터 모델에 맞는 구문을 완성하는 방법에 대한 제안을 제공합니다. 예를 들어, Workspace에 RocketShip이라는 Model이 있는 경우, workspace.roc를 입력하면 자동 완성이 RocketShip을 제안하고 그것이 Model임을 나타냅니다.

  

  ↑ 및 ↓ 키를 사용하여 제안을 탐색한 다음, Tab 또는 Enter를 눌러 제안을 수락하고 전체 구문을 삽입합니다.

• 변수 및 함수의 이름 자동 완성: 선언한 변수 및 함수의 이름을 자동으로 완성하여 성가신 오타를 피할 수 있도록 도와줍니다.

  

• 코드 샘플이 포함된 문서 팝업: 엔진 API 참조와 유사한 문서 팝업을 제공하여 API 사용에 대한 맥락을 제공합니다.

  

• 마우스 오버 툴팁: 사용자 정의 문서로 툴팁을 설정할 수 있습니다.

  

• 마우스 오버 스크립트 분석 진단: 오류를 해결하는 데 사용할 수 있는 정보를 제공합니다.

  

• 함수 시그니처: 인수를 입력할 때 함수의 매개변수 및 반환 값에 대한 참조를 제공합니다.

  

코드 탐색

선언으로 이동

함수 또는 변수의 선언으로 점프하려면 Windows에서는 Ctrl를, Mac에서는 ⌘를 누른 채로 호출을 클릭하거나, 호출을 마우스 오른쪽 버튼으로 클릭하고 선언으로 이동을 클릭합니다.

스크립트 함수 필터

스크립트 함수 필터는 스크립트에 선언된 모든 함수의 목록을 표시합니다. 이를 열려면 Windows에서는 AltF를, Mac에서는 ⌥F를 누릅니다. 목록이 열리면 각 함수의 시그니처를 탐색하고 이름으로 필터링하며, 더블 클릭하여 선언으로 점프할 수 있습니다.

찾기 및 바꾸기

찾기/바꾸기 위젯을 사용하면 열린 스크립트에서 코드를 찾고 바꿀 수 있습니다. 이 위젯은 대소문자 일치, 전체 단어 일치 및 정규 표현식 검색을 지원합니다. 이를 열려면 Windows에서는 CtrlF를, Mac에서는 ⌘F를 누릅니다.

실시간 피드백

스크립트 분석

스크립트 분석 창은 Studio의 스크립트 탭 툴바에 있는 분석 버튼을 통해 접근할 수 있으며, 스크립트에 대한 정적 분석을 수행하고 활성 오류 및 경고를 표시합니다. 오류 및 경고에 대한 자세한 내용은 Luau 린팅 문서를 참조하십시오.

출력

출력 창은 실행 중인 스크립트에서 캡처된 오류, Roblox 엔진의 메시지, print() 호출의 메시지 및 warn() 호출의 오류를 표시합니다.

코드 보조

코드 보조는 입력하는 동안 코드의 줄이나 함수를 제안하여 더 효율적으로 코딩하고 집중할 수 있도록 도와주는 기능입니다. 주석 및 코드의 맥락에 따라 제안은 두 가지 방법으로 트리거됩니다:

• 자동으로: 몇 초 동안 한 줄에서 멈추면 AI 모델이 제안을 위한 충분한 맥락을 갖추게 됩니다.
• 수동으로: Windows에서는 Alt∖, Mac에서는 ⌥∖ 단축키를 사용합니다.

제안을 수락하려면 Tab를 누르거나 계속 입력하여 무시할 수 있습니다. 현재 스크립트에는 제안을 트리거하기 위해 몇 줄의 코드가 포함되어 있어야 합니다.

제안 개선

보다 정확하고 관련성 높은 제안을 받으려면, 도움을 받더라도 깔끔한 코딩 관행을 따르는 것이 좋습니다:

• 코드를 더 작은 함수로 나누십시오.
• 각 스크립트가 수행하는 전체 의도를 포착하는 설명적인 스크립트 이름을 사용하십시오. 예를 들어, 스크립트를 SyncCustomSounds라고 이름 짓는 것이 좋습니다.
• 매개변수, 함수 및 스크립트에 대해 설명적인 이름을 지정하십시오. 예를 들어, 부품을 GreenSphere라고 이름 짓는 것이 좋습니다. 익명 함수보다 이름이 있는 함수를 사용하는 것이 더 나은 힌트를 생성할 수 있습니다.
• 구현하는 작업과 입력/출력이 무엇인지 설명하는 잘 작성된 주석을 일관되게 포함하십시오.

  • 주석에 예상 결과와 함께 몇 가지 샘플 호출을 포함하는 것을 고려하십시오.
  • 문제를 해결하는 방법을 제안하십시오. 예를 들어 -- Use raycast.
  • 정의한 함수 또는 변수 이름을 사용하십시오. 예를 들어 -- Create 10 greenSphere objects 대신 -- Create 10 spheres라고 작성하십시오.
• 초보 스크립터라면 "플레이어가 부품에 닿으면 점프하게 만들기"와 같은 기본 프로젝트로 시작하거나 도구를 사용하여 지식을 쌓아가면서 확장할 수 있는 작은 코드 조각을 생성하십시오.

제한 사항

이 도구는 기본 코딩 작업을 자동화하는 데 도움을 주지만 항상 완벽한 코드를 제안하지는 않습니다. 알려진 제한 사항은 다음과 같습니다:

• 수동 트리거는 항상 제안을 강제로 생성하지 않습니다.
• 제안은 코드의 말뭉치에서 기계 학습된 것이므로, 훈련된 코드의 일부 제한을 반영할 수 있습니다. 예를 들어, 제안이 최신 API 대신 구식 API를 사용할 수 있거나, Lua 대신 Luau를 사용할 수 있습니다.
• 이 도구는 귀하의 목적에 유용하지 않은 잘못된 정보나 오해의 소지가 있는 정보를 생성할 수 있습니다.
• 내부 필터는 공격적인 언어를 차단하려고 시도하지만, 모든 것을 포괄하지 않으며 도구가 공격적이거나 편향된 정보를 생성할 가능성이 있습니다.
• 제안은 사용자마다 동일하거나 유사하거나 다를 수 있으며, 동일한 프롬프트를 사용하더라도 마찬가지입니다. 그러나 귀하의 코드는 다른 사람과 공유되지 않습니다.
• 제안은 학습 모델의 출력 길이가 제한되어 있어 불완전할 수 있습니다.
• 제안 수에는 일일 한도가 있으며, 한도가 초과되면 다음 날까지 제안을 받을 수 없습니다.

코드 프라이버시

현재 Roblox는 비공식 데이터를 학습 모델 훈련에 사용하지 않습니다. 이 도구는 대규모 언어 모델을 조정하기 위해 무료 마켓플레이스 자산의 작은 하위 집합만 사용하며, 이 하위 집합은 품질 및 안전 필터에 대한 다양한 검사를 통과했습니다.

또한 모든 제안은 AI 모델에 의해 생성되며 사용자 간에 전송되지 않습니다. 귀하의 코드는 모델 훈련에 사용되지 않으므로, 다른 코드 보조 사용자에게 제안되지 않습니다. 단, 무료 마켓플레이스 항목에 게시된 코드는 예외입니다.

다중 커서

스크립트 편집기는 동시에 편집할 수 있도록 여러 커서를 사용할 수 있습니다. 필요에 따라 마우스 클릭이나 키보드 단축키로 커서를 추가할 수 있습니다. 초기 커서는 기본 커서라고 하며, 추가 커서는 보조 커서라고 합니다.

• 기본 커서에서 수행한 편집은 보조 커서에 복사됩니다. 각 편집은 하나의 작업으로 계산되므로, 편집의 실행 취소/다시 실행은 모든 커서에 적용됩니다.
• 자동 완성과 같은 위젯은 기본 커서에서만 나타나며 보조 커서에서는 나타나지 않습니다.
• 스크립트 편집을 위한 모든 표준 키보드 단축키는 다중 커서 편집과 함께 작동하며, 코드 들여쓰기, 주석 전환 및 줄 삭제를 포함합니다.

다음 표는 다중 커서 워크플로우와 해당 단축키를 요약합니다.

커서 추가

키보드 단축키와 마우스 조작의 조합으로 커서를 추가할 수 있습니다. 커서는 동일한 공간을 차지하면 병합됩니다. 예를 들어, 화살표 키로 커서를 추가하거나 커서 사이의 모든 문자를 삭제하면 커서가 병합됩니다.

마우스 위치에서

마우스 포인터 위치에 커서를 추가하려면:

1. Windows에서는 Alt를, Mac에서는 ⌥를 누릅니다.

2. 커서를 추가할 위치를 클릭합니다.

마우스 드래그로

마우스를 드래그하여 선택에 커서를 추가하거나, 다중 줄 선택을 줄로 나누거나, 코드/공백의 열 및 블록을 선택할 수 있습니다.

드래그하여 코드 선택에 커서를 추가하려면:

1. Windows에서는 Alt를, Mac에서는 ⌥를 누릅니다.

2. 코드 선택 위에서 마우스를 클릭하고 드래그합니다.

기본 커서 위/아래에

기본 커서 바로 위 또는 아래에 커서를 추가하려면:

1. Windows에서는 CtrlAlt를 누르고, Mac에서는 ⌘⌥를 누릅니다.

2. ↑ 또는 ↓ 화살표를 누릅니다.

일치하는 선택에

선택의 모든 일치 항목에 커서를 추가하거나 다음/이전 일치 항목에 커서를 추가할 수 있으며, 선택적으로 대소문자 구분 및/또는 전체 단어 일치를 전환할 수 있습니다.

선택한 부분의 모든 일치 항목에 커서를 추가하려면:

1. 일치 항목을 검색할 코드를 선택합니다.

2. Windows에서는 ShiftAltL를, Mac에서는 Shift⌥L를 누릅니다.

커서 제거

다음 키보드 단축키 및 마우스 조작을 사용하여 커서를 제거할 수 있습니다. 또는 Esc를 눌러 다중 커서 편집을 종료할 수 있습니다.

마우스 위치에서

커서를 제거하려면:

1. Windows에서는 Alt를, Mac에서는 ⌥를 누릅니다.

2. 제거할 커스를 클릭합니다.

가장 최근에 추가된

가장 최근에 추가된 커서를 제거하려면 Windows에서는 CtrlU를, Mac에서는 ⌘U를 누릅니다.

커서 복사 및 붙여넣기

코드 선택을 복사하면 그 안의 커서도 포함됩니다. 붙여넣기 동작은 소스의 커서 수와 대상의 커서 수에 따라 다릅니다:

• 커서 수가 동일하면 각 복사된 커서가 각 해당 대상 커서에 붙여넣어집니다.
• 커서 수가 다르면 대상의 각 커서가 각 복사된 커서를 새 줄로 붙여넣습니다.

입력 시 포맷팅

Enter/Return을 누르면 각 커서가 이전 줄에 상대적으로 새 줄에서 자동으로 들여쓰기됩니다. 이전 줄이 불완전한 블록으로 시작하면 포맷터가 이를 완성하려고 시도합니다.

편집기 설정

많은 사용자 정의 옵션은 Studio 설정의 스크립트 편집기 탭을 통해 접근할 수 있습니다. 일반적으로 수정되는 옵션은 다음과 같습니다:

키보드 단축키

스크립트 편집기에는 다음과 같은 키보드 단축키가 있습니다.