스크립트 편집기

Studio의 스크립트 편집기는 스크립트 작성을 위한 Roblox의 기본 도구입니다. 이는 영향력 강한 코드를 작성하고, 개발 시간을 단축하며, 체험을 반복하는 데 도움이 되는 자체 개선 환경입니다. 다음을 통해 스크립트 작성 체험을 향상시킬 수 있습니다.

• 코드에서 구문을 서식 지정하고 강조 표시합니다.
• 입력할 때 코드의 문구를 자동 완성하는 방법을 제공합니다.
• 변수 및 함수 선언으로 이동하여 코드 탐색을 돕습니다.
• 열린 스크립트 또는 전체 스크립트에서 코드를 찾고 교체할 수 있도록 도와줍니다.
• 코드 품질 및 이행에 대한 실시간 피드백을 제공합니다.

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

자동 완성

스크립트 편집기는 프로그래밍 효율성을 향상시키는 코드 관련 정보를 생성합니다.

• 입력할 때 구문를 완성하는 방법을 제안합니다. 위쪽 및 아래쪽 화살표 키를 사용하여 제안을 살펴본 다음, Tab 또는 Enter를 눌러 제안을 수락하고 전체 구문을 삽입합니다.

  

• 자동 완성은 체험의 데이터 모델과 연결되어 있습니다. CoolRocketShip(이)라는 Workspace에 Part이(가) 있는 경우, workspace.cool을(를) 입력하면 자동 완성 기능이 CoolRocketShip을(를) 제안하고 그것이 Part임을 나타냅니다.

  

• 또한 자동 완성 기능은 선언하는 변수 및 함수의 이름을 제안하므로, 오타를 방지하고 코드를 재사용하기가 더 쉽습니다.

  

• 자동 완성 팝업은 Engine API Reference와 유사한 문서화 및 코드 샘플을 제공하여 API 사용에 관한 컨텍스트를 제공합니다.

  

• 함수에 인수를 입력하면 자동 완성 팝업에 함수의 시그니처도 표시되어 해당 매개 변수 및 반환 값에 대한 참조를 제공합니다.

  

코드 내비게이션

선언으로 이동

해당 호출을 마우스로 우클릭하고 선언으로 이동을 클릭하여 함수 또는 변수의 선언으로 이동할 수 있습니다. 호출을 클릭할 때 Windows에서는 Ctrl 키를, macOS에서는 ⌘ 키를 눌러 선언으로 이동할 수도 있습니다.

스크립트 함수 필터

스크립트 함수 필터는 스크립트에서 선언된 함수 목록을 표시합니다. 이를 열려면 편집기의 아무 곳이나 우클릭한 다음, 스크립트 함수 필터를 클릭합니다. 목록이 열린 상태에서 각 함수의 시그니처를 살펴보고, 이름별로 필터링하고 항목을 더블 클릭하여 해당 선언으로 이동할 수 있습니다.

찾기 및 바꾸기

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

실시간 피드백

스크립트 분석

보기 탭에서 액세스할 수 있는 스크립트 분석 창은 스크립트에 대한 정적 분석을 수행하고 활성 오류 및 경고를 표시합니다. 워크플로우에 맞게 구성하는 방법에 대한 자세한 내용은 출력을 참조하십시오.

출력

보기 탭에서 액세스할 수 있는 출력 창에는 실행 중인 스크립트에서 캡처한 오류, Roblox 엔진의 메시지, print() 호출 시 메시지, warn() 호출 시 오류 등이 표시됩니다. 워크플로에 맞게 구성하는 방법에 대한 자세한 내용은 출력 창을 참조하세요.

코드 지원

코드 지원는 입력할 때 코드의 줄이나 기능을 제안하는 AI 도우미로, 코딩을 보다 효율적으로 수행하고 집중할 수 있도록 도와줍니다. 댓글 및 코드의 컨텍스트에 따라 제안은 두 가지 방식으로 트리거됩니다.

• 몇 초 동안 줄에서 일시 중지하고 AI 모델에 제안을 위한 충분한 컨텍스트가 있을 때 자동으로 트리거.
• Windows에서는 Alt∖ 단축키를, MacOS에서는 ⌥∖ 단축키를 사용하여 수동으로 트리거(이 바로가기를 사용자 정의할 수 있음).

Tab 키를 눌러 제안을 수락하거나, 입력을 계속하여 무시하십시오. 현재 스크립트는 제안을 트리거하기 위해 최소한 몇 줄의 코드를 포함해야 합니다.

제안 개선

보다 정확하고 관련성 높은 제안을 받으려면, AI 지원에 관계없이 클린 코딩 관행을 따르고 다음 사항을 수행하는 것이 좋습니다.

• 코드를 더 작은 함수로 나눕니다.
• 각 스크립트가 수행하는 작업의 전반적인 의도를 포착해 설명 스크립트 이름으로 사용합니다. 예를 들어, 스크립트 이름을 Sounds 대신 SyncCustomSounds로 지정합니다.
• 매개 변수, 함수 및 스크립트에 대해 설명이 포함된 이름을 지정합니다. 예를 들어 단순히 grs 대신 일부분의 이름을 GreenSphere로 지정하거나, gen() 대신 함수 generateSphere()(으)로 지정합니다. 명명 함수와 익명 함수를 사용하면 더 나은 힌트를 제시할 수도 있습니다.
• 구현 중인 작업과 입력/출력이 무엇인지 설명하는 잘 작성된 주석을 일관되게 포함시키십시오.

  • 주석에 예상 결과가 포함된 몇 가지 샘플 호출을 포함시키는 것을 고려하십시오.
  • 예를 들어, -- Use raycast와(과) 같은 문제를 해결하는 방법을 제안합니다.
  • 정의한 정확한 함수 또는 변수 이름을 사용하십시오(예: -- Create 10 greenSphere objects 대신 -- Create 10 spheres).
• 귀하가 초보 스크립트 작성자인 경우 '플레이어가 부품을 만질 때 점프하게 만들기'와 같은 기본 프로젝트로 시작하거나, 도구를 사용하며 지식을 늘려감 따라 확장할 수 있는 작은 코드 스니펫을 생성할 수 있습니다.

제한

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

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

코드 개인 정보 보호

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

또한 모든 제안은 AI 모델에 의해 생성되며, 한 사용자에서 다른 사용자로 전송되지 않습니다. 코드는 모델 학습에 사용되지 않으므로, 무료 마켓플레이스 항목에 게시되는 코드를 제외하고는 코드 지원의 다른 사용자에게 제안되지 않습니다.

다중 커서

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

• 기본 커서의 편집 내용은 보조 커서로 복사됩니다. 다중 커서 편집을 사용하는 동안 편집을 실행 취소하거나 재실행하면, 그러한 실행 취소 또는 재실행 작업이 모든 커서에 적용됩니다.
• 자동 완성와 같은 위젯은 기본 커서에 표시되지만 보조 커서에는 표시되지 않습니다.
• 코드 들여쓰기, 주석 전환, 줄 삭제 등, 편집을 위한 스크립트 편집기 표준 키보드 단축키는 모두 다중 커서 편집에서도 작동합니다.

다음 표에는 다중 커서 워크플로와 해당 바로 가기가 요약되어 있습니다.

커서 추가

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

마우스 위치

마우스에 커서를 추가하는 방법:

1. Windows에서는 Alt, macOS에서는 ⌥를 길게 누릅니다.
2. 선택한 텍스트에 커서를 추가하는 방법:

마우스 드래그

마우스를 끌어 선택 항목에 커서를 추가하거나, 여러 줄 선택 항목을 여러 줄로 분할하거나, 열과 코드/공백 블록을 선택할 수 있습니다.

끌어서 선택

다음 일치 항목 선택에 커서를 추가하는 방법:

1. Windows에서는 Alt, macOS에서는 ⌥를 길게 누릅니다.
2. 선택한 텍스트 위로 마우스 클릭하고 드래그합니다.

선택한 줄 끝 및 선택 항목 끝

다중 줄 선택 항목의 각 줄 끝과 선택 항목 끝에 커서를 추가하려면 다음 사항을 수행하십시오.

열/블록 선택

코드 또는 공백의 열과 블록을 선택하려면 Windows에서는 ShiftAlt를 누르고 macOS에서는 Shift⌥를 누른 상태에서 마우스를 드래그합니다. 드래그하면 강조 표시된 각 줄에 커서가 추가됩니다.

주 커서 위와 아래

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

1. Windows에서는 Ctrl + Alt, macOS에서는 ⌘ + ⌥를 길게 누릅니다.
2. 위쪽 및 아래쪽 화살표를 누릅니다.

일치하는 전체 선택 항목

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

전체 일치

일치하는 전체 선택 항목에 커서를 추가하는 방법:

1. 일치 항목을 검색할 코드를 선택합니다.
2. Windows에서는 Shift + Alt + L, macOS에서는 Shift + ⌥ + L을 누릅니다.

다음/이전 일치

다음 일치하는 선택 항목에 커서를 추가하려면 다음을 수행하세요.

1. 일치 항목을 검색할 코드를 선택합니다.
2. Windows에서는 Ctrl + D, macOS에서는 ⌘ + D를 누릅니다.
3. 원하는 다음 일치 항목이 모두 선택될 때까지 Ctrl/⌘ + D를 계속 누릅니다.

이전 일치 선택 항목에 커서를 추가하는 기본 단축키는 없지만 직접 추가할 수 있습니다.

1. 파일 > 고급 > 단축키 사용자 정의에서 단축키 사용자 정의 창을 열고 '이전 항목 선택' 바로 가기를 편집하여 원하는 단축키를 만들 수도 있습니다.

2. 바로가기 창에서 이전 항목 선택을 찾습니다.

   

3. 작업의 바로 가기 필드를 두 번 클릭하고 사용자 정의 키 조합을 입력합니다(예를 들어 "다음" 일치 기본값인 CtrlD와 쌍을 이루도록 하는 ShiftCtrlD).

   

4. 창 오른쪽 하단에 있는 확인을 클릭하여 설정을 확인합니다.

대소문자 또는 전체 단어 일치

위의 각 일치 관련 워크플로에 대해 다음과 같이 대소문자 및/또는 전체 단어를 일치시킬 수 있습니다.

1. Windows에서는 Ctrl + P, macOS에서는 ⌘ + P를 사용하여 빠른 열기 창을 엽니다.

2. 전환 버튼을 사용하여 일치하는 선택 항목이 대소문자를 구분해야 하는지 및/또는 전체 단어만 일치해야 하는지 선택합니다.

   

커서 제거

키보드 단축키와 마우스 조작을 조합하여 커서를 제거할 수 있습니다. 전체 보조 커서를 제거하고 다중 커서 편집을 종료하려면 ESC를 누르거나 스크립트 편집기의 아무 곳이나 클릭하십시오.

마우스 위치

커서를 제거하는 방법:

1. Windows에서는 Alt, macOS에서는 ⌥를 길게 누릅니다.
2. 제거할 커서를 클릭합니다.

가장 최근에 추가된 항목

가장 최근에 추가된 커서를 제거하려면 Windows에서는 Ctrl + U, macOS에서는 ⌥ + U를 누릅니다.

커서 복사 및 붙여 넣기

선택한 텍스트를 복사하면 그 안에 커서가 포함됩니다. 붙여 넣기 동작은 소스의 커서 수와 대상의 커서 수에 따라 달라집니다.

• 커서의 수가 같으면 복사된 각 커서가 해당하는 각 대상 커서에 붙여 넣어집니다.
• 커서 수가 다른 경우, 대상의 각 커서는 복사된 각 커서와 함께 전체 붙여 넣기를 새 줄로 받습니다.

형식 선택

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

키보드 단축키

스크립트 편집기에는 다음과 같은 키보드 단축키가 있습니다. 스크립트를 보거나 편집할 때마다 Studio 도구 모음에 나타나는 스크립트 탭에서 다양한 명령에 액세스할 수도 있습니다.