스크립트 편집기

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라고 이름짓고, 단순히 Sounds라고 이름짓지 마십시오.
• 매개변수, 함수 및 스크립트에 설명적인 이름을 부여하십시오. 예를 들어, 부품에 GreenSphere와 같은 이름을 붙이거나, 함수에 generateSphere()라는 이름을 붙이십시오.
• 구현할 작업과 입력/출력이 무엇인지 설명하는 잘 작성된 주석을 일관성 있게 포함하십시오.

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

제한 사항

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

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

코드 개인 정보 보호

현재 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 설정의 스크립트 편집기 탭을 통해 접근할 수 있습니다. 일반적으로 수정되는 옵션은 다음과 같습니다:

키보드 단축키

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