이 API 참조는 Roblox의 모든 클래스, 데이터 형식, 열거, 함수, 이벤트, 콜백 및 속성을 설명합니다.

클래스

데이터 형식

열거

전역 변수

라이브러리

Roblox 엔진 API 참조

개요

가이드

튜토리얼

참조

리소스

아트

디자인

엔진

아바타

레거시(기존)

클라우드

비동기적 방식으로, 현재 작업 상태를 나타내는 '작업'을 반환합니다. 여기에는 투표를 진행하여 실제 응답과 적용 가능한 메타데이터를 얻을 수 있는 엔드포인트 경로가 포함됩니다. 자세한 정보는 장기 작업에 관한 [설명서]({longRunningOperationsLink})에서 확인하세요.
            
아래 섹션은 작업 완료 시 제공되는 응답 및 메타데이터 개체에 대한 설명입니다.

베타 끝점이 공개적으로 사용될 준비가 되었습니다. 중대한 변경이 발생할 수 있지만 가능성은 낮습니다.

이 필드는 리소스를 생성할 때 설정될 수 있지만 후속 요청에 의해 수정될 수는 없습니다.

이 필드는 요청에 제공될 수 있지만 응답에는 포함되지 않습니다.

각 API 키별: IP 주소당 {periodInSeconds}초마다 {maxInPeriod} 요청

이 필드는 응답에서 설정할 수 있지만 요청에서는 무시됩니다.

이 엔드포인트를 호출하려면 다음 API 키 권한이 필요합니다. 적절한 키 생성에 대한
자세한 내용은 [API 키 관리]({apiKeyReferenceDocLink})에서 확인하세요.

다음 끝점은 기준 URL과 관련된 경로에서 사용할 수 있습니다.

이 문자열은 [FieldMask](/cloud/reference/types#fieldmask) 형식으로 지정됩니다.

JSON 값은 `null`, `boolean`, `string`, `number`, `array`, `object`일 수 있습니다.

OAuth 2.0 애플리케이션에서 이 엔드포인트를 사용하려면 다음 범위가 필요합니다. OAuth 2.0 애플리케이션 등록 방법에 대한 자세한 내용은 [앱 등록 및 심사]({oauth2ReferenceDocLink})에서 확인하세요.

다음 개체는 수락되거나 반환되는 페이로드를 설명합니다. 이러한 개체가 사용되는 시기에 대한 자세한 정보는 각 개별 끝점을 참고하세요.

이 문자열은 [Timestamp](/cloud/reference/types#timestamp) 형식으로 지정됩니다.

이를 통해 애셋에 대한 정보를 볼 수 있습니다.

이를 통해 애셋을 Roblox에 업로드하고 업데이트할 수 있습니다.

사용자가 소유한 배지를 업데이트할 수 있는 권한을 부여합니다.

이를 통해 상거래 아이템에 대한 정보를 볼 수 있습니다.

이를 통해 상거래 판매자 연결을 편집할 수 있습니다.

이를 통해 크리에이터 상점 상품에 대한 정보를 볼 수 있습니다.

이를 통해 크리에이터 상점 상품에 대한 정보를 수정할 수 있습니다.

이를 통해 커뮤니티에 대한 정보를 볼 수 있습니다.

이를 통해 계정에 대한 커뮤니티 가입 요청 및 역할 업데이트를 관리할 수 있습니다.

이를 통해 인벤토리에 대한 정보를 볼 수 있습니다.

내 배지를 관리할 수 있는 액세스 권한을 부여합니다.

내 배지를 관리하고 Robux를 사용할 수 있는 액세스 권한을 부여합니다.

내 개발자 상품을 관리할 수 있는 액세스 권한을 부여합니다.

팔로우 중인 체험에 대한 정보를 읽을 수 있는 액세스 권한을 부여합니다.

나를 대신해 체험을 팔로우 및 언팔로우할 수 있는 권한을 부여합니다.

내 패스를 관리할 수 있는 액세스 권한을 부여합니다.

내 커뮤니티를 관리할 수 있는 권한을 부여합니다.

커뮤니티 정보를 읽을 수 있는 권한을 부여합니다.

커뮤니티 관리 권한을 부여합니다.

내 로컬라이제이션 테이블을 읽고 쓸 수 있는 액세스 권한을 부여합니다

소유한 모든 체험의 팀 공동 작업을 관리할 수 있는 권한을 부여합니다.

체험 및 체험과 관련된 특정 정보를 관리할 자격을 부여합니다(예: 로컬라이제이션 정보).

내 체험의 로컬라이제이션 정보를 읽을 수 있는 액세스 권한을 부여합니다.

내 체험의 로컬라이제이션 기본 설정을 수정할 수 있는 액세스 권한을 부여합니다.

내 사용자 계정을 관리할 수 있는 권한을 부여합니다.

사용자 로컬라이제이션 기본 설정을 수정할 수 있는 액세스 권한을 부여합니다.

사용자를 대신해 메시지를 게시할 수 있는 권한이 부여됩니다.

이를 통해 체험에서 사용자에게 알림을 보낼 수 있습니다.

이를 통해 체험과 관련된 시크릿을 나열할 수 있습니다.

이를 통해 체험과 관련된 시크릿을 생성하고 업데이트할 수 있습니다.

구독 상품에 대해 읽을 수 있는 액세스 권한을 부여합니다.

플레이스 정보를 읽을 수 있는 권한을 부여합니다.

플레이스 정보를 편집할 수 있는 권한을 부여합니다.

이 작업은 새로운 버전의 체험을 Roblox에 게시할 수 있는 권한을 부여합니다.

체험 정보를 읽을 수 있는 권한을 부여합니다.

체험 정보를 편집할 수 있는 권한을 부여합니다.

체험에서 사용자 제한을 볼 수 있습니다.

체험에서 사용자 제한을 편집할 수 있습니다.

사용자의 Premium 및 인증 상태를 읽을 수 있는 권한을 부여합니다.

이를 통해 사용자의 소셜 계정을 볼 수 있습니다.

이 작업은 싱글 사인온 기능을 활성화합니다.

프로필 정보를 읽을 수 있는 액세스 권한을 부여합니다.

기본값: {defaultValueStart}{defaultValueEnd}

배열은 순서가 지정된 값 목록입니다. 배열은 데이터 컬렉션을 저장하는 데 유용합니다.

키-값 쌍 집합으로, 이때 키는 숫자, 문자열 또는 개체일 수 있습니다.

{tuples}(와)과 마찬가지로, 값의 목록입니다.

이 함수는 가능한 경우 즉시 반환하지만, 값을 반환할 수 있을 때까지 호출한 스레드를 일시 중단할 수 있습니다.

{nameStart}이름{nameEnd}(은)는 더 이상 Roblox에서 지원하거나 유지 관리하지 않습니다.

이 수학 연산은 더 이상 Roblox에서 지원하거나 유지 관리하지 않습니다.

이 멤버는 개체 브라우저에 표시되지 않으며 널리 사용하기 위한 것이 아닙니다.

이 멤버는 명령 모음을 통해서만 액세스할 수 있습니다. 스크립트에서 이 멤버에 액세스하려고 하면 오류가 발생합니다.

이 함수는 호출한 Lua 스레드를 일시 중지할 수 없습니다.

스크립트에서 이 멤버에 액세스하려고 하면 오류가 발생합니다. Roblox Studio의 속성 창에서 이 멤버에 액세스가 가능할 수 있습니다.

이 멤버는 Roblox Studio의 개체 브라우저에 표시되지 않습니다.

Instance.new 생성자로 이 클래스의 인스턴스를 만들 수 없습니다.

Roblox는 서버-클라이언트 경계를 넘어 이 멤버를 복제하지 않습니다.

Lua 코드는 이 멤버에 액세스할 수 없습니다. Roblox Studio의 속성 창에서 값의 변경이 가능할 수 있습니다.

이 멤버는 OpenCloud Luau 실행 작업에서 액세스할 수 있습니다.

이 개체의 복제 동작은 개체를 소유한 플레이어에 따라 다릅니다.

이 멤버는 명령 모음 및 플러그인을 통해서 액세스할 수 있습니다. 스크립트에서 이 멤버에 액세스하려고 하면 오류가 발생합니다.

이 멤버는 읽기 전용입니다. 이 멤버에 쓰려고 하면 오류가 발생합니다.

이 속성은 읽기 전용이며 동기화되지 않은 스레드에서 안전하게 읽을 수 있습니다. 쓰기를 시도하면 오류가 발생합니다.

이 멤버는 CoreScript에서만 액세스할 수 있습니다.

Roblox CoreScript만 이 멤버에 액세스할 수 있으며, Players는 이를 사용할 수 없습니다.

여러 스레드에서 이 속성에 안전하게 읽고 쓸 수 있습니다.

이 클래스는 최상위 Singleton입니다. GetService 함수를 사용해 이 클래스의 인스턴스를 가져옵니다.

여러 스레드가 이 속성에 쓸 수 있으므로, 동기화되지 않은 스레드에서 읽는 것은 안전하지 않습니다.

이 함수는 결과를 반환할 때까지 호출한 Lua 스레드를 일시 중지합니다. 다른 스크립트를 방해하지 않습니다.

모든 체험을 한 곳에서 편리하게 관리하고 분석하세요.

크리에이터를 위한 설명서 및 리소스를 통해 작품 제작에 대해 배우세요.

가이드, 튜토리얼, 코드 샘플을 통해 Roblox 체험 제작 방법을 배우세요.

올인원 통합 개발 환경을 제공하는 Studio에서 체험을 구축하고 다양한 기기에 배포하세요.

사용자들에게 장기적으로 가치를 제공하는 확실한 방법을 알아보세요

작품으로 트래픽을 유도하는 성공적인 광고를 만드는 방법을 알아보세요

체험의 성장 과정을 차트로 확인하고 개선의 기회를 발견하세요

캐릭터와 환경에 움직임을 적용하는 방법을 알아보세요

업로드하거나 상점의 애셋을 창작물에 사용하는 방법을 알아보세요

아바타 아이템을 제작하고 마켓플레이스에 게시하세요

지난 7일 동안 가장 높은 수익을 기준으로 정렬됨

마켓플레이스에서 무엇을 만들어 판매할 수 있는지 알아보세요

아바타는 모든 Roblox 사용자를 꾸밀 수 있는 캐릭터로 표현합니다

커뮤니티 멤버들이 제작 중인 멋진 작품들을 둘러보세요

블렌더에서 기본적인 모델링 기법을 배웁니다

다른 크리에이터가 만든 모델, 스크립트, 플러그인을 찾으세요

모든 아바타 기능이 제대로 작동하도록 캐릭터를 구성하는 방법을 알아보세요

월드 또는 다른 사용자와 상호작용을 할 수 있는 개체를 만드는 방법을 알아보세요

Roblox에서 처음으로 기본 복장을 만들고 판매하세요

Studio의 협업 도구를 이용해 팀원들과 동시에 작업하세요

크리에이터 마켓플레이스의 최신 트렌드를 확인하세요

크리에이터 상점의 최신 트렌드를 확인하세요

다른 크리에이터가 주최하는 커뮤니티 이벤트에 참가하세요

크리에이터 커뮤니티가 직접 작성한 튜토리얼을 찾아 보세요

콘텐츠 업데이트를 통해 플레이어의 참여도와 수익 창출을 유지하세요

즐거운 게임 플레이 사이클을 활용해 사용자들의 마음을 사로잡으세요

재미있고 반복적인 게임플레이로 참여와 진행을 유도하세요

코드를 입력하지 않고 미닫이문을 만드는 방법을 알아보세요

Alex가 히트작 '탈옥수와 경찰'을 직접 제작한 경험을 들려줍니다

Blake는 현실적이고 기발한 카니발 게임을 만드는 열정에 눈을 떴습니다

Clemens는 '생존 게임' 등의 히트작을 만든 가족 운영 스튜디오입니다

Jasmine은 마켓플레이스에서 큰 인기를 끄는 아바타 아이템들을 만든 아티스트입니다

Jessica는 Alo Yoga 등에서 볼 수 있는 상상력 넘치는 환경을 설계한 디자이너입니다

Jenni는 수많은 인기 공동 작업을 진행한 UGC 크리에이터 및 아티스트입니다

Morphist의 독특한 스타일에는 귀여움과 감성적인 미학이 결합되어 있습니다

'폭동' 크리에이터들이 몰입형 체험에 대한 영감을 얻기 위해 여행을 떠납니다

Stephen이 프로그래밍 도구에 대한 애정을 공유합니다

Sam이 자신이 원했던 패션 아이템을 디자인하게 된 과정을 공유합니다

파트와 조명 등 3D 월드를 구성하는 모든 개체

Studio에서 사용할 수 있는 다양한 디버깅 도구에 대해 알아보세요

다음 현금 인출까지의 진행 상황을 확인하세요!

테스트할 때는 개발자 콘솔을 사용해 체험을 디버깅하세요

체험에 구독을 추가하면 사용자층과 장기적인 관계를 구축하는 데 도움이 됩니다. 2023년 12월 15일 이전에 구독을 활성화하고 3개월 동안 저렴한 비용으로 즐겨 보세요.

최고 인기 체험을 둘러보며 영감을 얻으세요

Roblox의 개발 엔진, Studio 이용을 시작하세요

코드 몇 줄 추가로 새로운 대시보드를 잠금 해제해 온보딩 및 기타 유입 경로를 파악하고 게임 내 경제를 추적하세요.

구조화된 시퀀스에서 라이브 교차 서버 이벤트 및 컷신을 구축하세요

체험에 시간제한 이벤트를 만드는 방법을 알아보세요

시간 기반 이벤트를 만들어 Roblox에서 검색 가능성을 높이세요. 최신 업데이트를 알리거나, 활동을 강조하거나, 플레이어들과 함께 목표 달성을 축하하세요!

체험 가이드라인을 통해 작품에 맞는 연령대를 타기팅하는 방법을 알아보세요

Roblox로부터 직접 전문 정보와 지식을 얻으세요

친구 초대 보상 시스템을 구현하는 방법을 알아보세요

게임 만들기의 기초를 이해하세요

나의 데이터가 AI 트레이닝에 활용되는 방식을 제어하는 방법을 알아보세요. {linkStart}자세한 정보{linkEnd}

AI 도구를 사용해 간편하게 사용자 정의 텍스처를 만드세요

올인원 제작 엔진을 활용해 상상하던 모든 걸 만들어 보세요

PolarCub가 UGC 아이템 제작을 위한 모든 팁을 공유합니다

Guilded를 활용해 작품의 커뮤니티를 구축하세요

놀랍도록 뛰어난 크리에이터들과 핼러윈 게임 잼에 함께하세요

머리 파트를 이용해 얼굴 애니메이션을 만들거나 감정 표현을 트리거하세요

메트릭을 통해 게임플레이를 개선할 수 있는 부분을 파악하세요

게임을 다시 찾도록 만드는 방법을 알아내세요

사용자 입력을 통해 사용자가 체험 환경과 상호작용을 
할 수 있습니다

체험을 처음 플레이하는 플레이어들을 안내하세요

어떤 아바타 신체에도 잘 맞도록 늘어나는 옷을 만드세요

Roblox는 실습을 통한 학습이 최고라는 믿음을 가지고 있습니다. 가이드 중 하나를 선택해 Roblox 기능에 대해 더 자세히 알아보세요.

코드 작성 시 도움을 받고 작품 제작 관련 질문의 답변을 얻으세요

Lighting 및 SoundService를 사용해 환경 효과를 제어할 수 있습니다

다양한 언어와 문화적 기준에 맞게 콘텐츠를 조정하는 방법을 알아보세요

플레이어가 무언가에 닿았을 때 체력을 0으로 만드는 방법을 보여주는 연결부와 빔, 일부 기초 스크립팅 개념을 다룹니다

새로운 아이디어를 빠르게 실험하는 방법

활동적인 플레이어 기반을 육성하는 것은 성공적이고 지속적인 게임을 개발하는 데 중요한 역할을 합니다.

성능 최적화 및 문제 해결 도구 이용을 시작하세요

마이크로 프로파일러는 작업 스케줄러에 타이밍 정보를 제공해 줍니다

프레임 색상, 플레임 그래프 등에 대해 자세히 알아보세요

메트릭을 통해 더 성공하는 방법을 파악하세요

계산 집약적인 Luau 스크립트의 성능을 향상하세요

일일 벤치마크, 인사이트, 실시간 메트릭을 확인하고 {boldStart}{experienceName}{boldEnd}의 수준을 한층 더 끌어올리세요.

체험에 NPC(비플레이어 캐릭터)를 사용하는 방법을 알아보세요

@minty가 채팅 제안을 사용해 실시간으로 오비를 처음부터 만들어 봅니다

Roblox의 플랫폼은 비교불가능한 수준의 창작 툴을 제공합니다. 크리에이터 허브, Roblox Studio, 역동적인 크리에이터 커뮤니티를 탐색하며 여정을 시작하세요.

Roblox의 플랫폼은 비교불가능한 수준의 창작 툴을 제공합니다.

우리 모두와 마찬가지로, 화려한 수상 경력의 스튜디오 및 단독 크리에이터 커뮤니티 구성원 모두가 이곳에서 첫 발걸음을 내딛었죠.

Roblox의 수석 환경 아티스트가 패키지를 사용하는 방법과 이유를 설명합니다

중력, 재질 속성, 제약을 설명하는 스태프 스트림을 시청하세요

사용자가 체험에 참여하면 어떤 일이 생기는지 알아보세요

플러그인은 작품에 추가 기능을 더해 줍니다

PolarCub의 UGC 홈스토어를 살펴보세요! Temprist도 등장합니다.

작품에 대한 트래픽과 인지도를 높이는 방법을 알아보세요

올해 RDC의 모든 하이라이트를 확인하세요

Roblox 개발 엔진으로 할 수 있는 작업에 대해 자세히 알아보세요

R15 휴머노이드 캐릭터 모델을 리깅하는 방법을 알아보세요

Roblox에서 나만의 첫 기본 고정식 장신구를 만들고 판매하세요

Roblox에 곧 공개될 새로운 기능을 미리 만나 보세요

Studio는 Roblox에서 체험을 만들 수 있는 도구입니다

Studio의 스크립트 편집기를 사용해 사용자 정의 스크립트를 만드는 법을 알아보세요

스크립팅을 통해 사용자들을 위한 몰입형 상호작용을 추가할 수 있습니다

제작 시간을 단축할 수 있는 Studio 바로가기 및 주요 명령어를 알아보세요

플레이어들이 친구들과 함께 플레이할 수 있는 기능을 통합하는 방법을 알아보세요

스폰서 광고를 통해 더 많은 크리에이터에게 작품을 알리세요

Studio는 Roblox에서의 작품 제작을 위한 올인원 도구입니다. 지금 바로 시작하세요!

플레이어들에게 월별 요금으로 정기적인 혜택을 제공하는 방법을 알아보세요

다른 크리에이터와의 협업을 통해 체험을 성장시키세요

지형 편집기를 사용해 Studio에서 지형을 생성하고 변경하세요

{boldStart}{experienceName}{boldEnd} 등의 체험이 개인 설정으로 인정된 플레이스루 비율 면에서 평균 8.5% 상승을 경험했습니다.

작품에 대한 번역을 제공해 더욱 다양한 오디언스에 도달할 수 있도록 지원하세요

Minty, SCHLEEMPH와 함께 새로운 UGC 홈스토어 템플릿을 살펴보세요

Roblox 고유의 이용자층을 위해 제작하는 방법을 알아보세요

드래그 탐지기란 무엇이며, 제작에 어떻게 사용할 수 있는지 알아보세요

Roblox에서의 작품 제작에 대한 간략한 소개 영상을 시청한 후 Studio로 이동하세요

Roblox 직원이 전하는 최신 공지 사항을 확인하세요

대시보드에서 작품을 관리하세요

도움이 되는 비디오를 더 시청해 보세요

모든 작품을 한곳에서 편리하게 관리하고 성장시키세요

작업 공간에는 프로젝트에서 엔진이 렌더링할 개체가 저장됩니다

파트, 메시, 지형, 조명을 다루는 스태프 스트림을 시청하세요