Flat

CurvedHorizontally

SurfaceGuiShape

/reference/engine/enums/SurfaceGuiShape.yaml

An object that runs connected functions upon a specific occurrence.

Data Type

RBXScriptSignal

개요

가이드

튜토리얼

참조

리소스

아트

디자인

엔진

Avatar

클라우드

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

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

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

각 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에 업로드하고 업데이트할 수 있습니다.

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

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

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

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

이를 통해 계정에 대한 그룹 가입 요청을 관리할 수 있습니다.

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

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

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

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

Grants access to read and write your localization tables

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

기본값: {defaultValueStart}{defaultValueEnd}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

종합 가이드, 코드 샘플, 참조, 튜토리얼을 통해 Roblox에서 성공적인 콘텐츠를 만드는 방법에 대해 알아보세요.


{pageTitle} | {SiteName}

2D 경로

3D 아트 개요

3D 임포터

3D 작업 공간

9슬라이스

AI 데이터 공유

API 키

GDPR 및 CCPA 정보

접근성 가이드라인

로컬라이제이션 설정 액세스

장신구 조정 도구

계정 인증

획득

활동 교훈

적응형 타입스텝

새 모델 추가

애니메이션 추가하기

스크립트 추가하기

날개 추가하기

두 번째 포즈 추가하기

차고에 추가

광고 관리자

고급

어드벤처 게임 프로젝트

모험 게임 Pt. 1

모험 게임 파트 2

어드벤처 게임 Pt. 3

Roblox에서 광고하기

얼라인오리엔테이션

얼라인포지션

정렬 도구

전체 클라우드 API

애널리틱스

애널리틱스 대시보드

애널리틱스 필수 요소

앵귤러벨로시티

로블록스에서 애니메이션 만들기

캐릭터 애니메이션

머리 애니메이팅

부품 애니메이션

애니메이션

애니메이션 캡처

애니메이션 편집기

애니메이션 이벤트

애니메이션 및 피드백

모습

정교한 애셋 적용

표면 이미지 적용하기

아키텍처

아마튜어 설정

애셋 라이브러리 어셈블리

어셈블리

모듈식 환경 어셈블리

애셋 관리자

애셋 개인정보

애셋

어시스턴트

도큐멘테이션 어시스턴트

대기

오디언스

오디언스 인게이지먼트

오디오 애셋

자동 크기 조정

자동 스키닝

자동 번역

아바타

아바타 콘텍스트 메뉴

아바타 작품

아바타 편집기

아바타 검사 메뉴

아바타 아이템

아바타 미리 보기

아바타 설정

아바타 탭

아바타 튜토리얼

아바타 튜토리얼로 돌아가기

가이드로 돌아가기

튜토리얼로 돌아가기

배지

가상 경제 균형 맞추기

볼소켓

초급 게임 플레이

기본 파티클 이펙트

배틀 로열

배틀 로열 프로젝트

아티스트가 되다

초보자용 콘텐츠

디지털 시민이 되는 것

모범 사례

베타 기능

베타 테스트 경험

비욘드 더 다크

바인딩 가능 요소

블렌더 설정

Blender 및 Maya 내보내기 설정

신체

몸통 - 템플릿에서

신체 스케일

부울

버블 채팅

빌드 잇, 플레이 잇 시리즈

절반 구성하기

Studio 위젯 구축

빌드 시스템

고유한 3D 개체 만들기

비즈니스 구축

관람차 만들기

여닫이문 만들기

건물과 소품

도로 건설하기

내장

버튼

업그레이드 구매하기

C프레임

케이징

캐릭터 머리 케이징

케이징 설정

캘리스데닉스 도구

카메라

챌린지 체크포인트 1

도전 과제 체크포인트 2

도전 과제 체크포인트 3

애니메이션 변경

스크립트 변경

캐릭터 컨트롤러

캐릭터

채팅

음성으로 채팅하기

클래스

클래식 복장

교실 모범 사례

교실 운영

정리

정리 및 재설정

클라이언트/서버 런타임

복장

클라우드 서비스

구름

코딩 추상화

코딩 알고리즘

코딩 기본 원칙

함수 코딩하기

질문 코딩하기

게임 루프 코딩

리더보드 코딩

스토리 코딩하기

공동 작업

협업 모범 사례

아이템 수집하기

충돌

색상 및 질감

머리 지오메트리 컴바인

주석

커뮤니티

도시를 완성하세요

도전 과제 완료

광고 규정 준수

조건문

빔 연결하기

콘솔 가이드라인

월드 구축

하우스 건설

컨테이너

콘텐츠 업데이트

상황별 구매

제어 구조

사용자 카메라 제어

코어

핵심 커리큘럼

핵심 루프

코어 스크립트

기본 시각 효과 만들기

플레이어 해저드 만들기

첫 체험 만들기

코인 수집 메커니즘 만들기

프로젝트 생성

지형으로 환경 만들기

창조하고 파괴하다

첫 번째 포즈 만들기

애니메이션 만들기

기본 머리 만들기

번들 설치 프로그램 생성하기

엘리베이터 만들기

매력적인 경험 만들기

얼굴 장신구 만들기

깜박이는 조명 만들기

레이저 빔 만들기

움직이는 오브젝트 만들기

네온사인 만들기

플레이어 도구 만들기

프라이빗 서버 생성하기

점수 바 만들기

이음새 만들기 및 언래핑

회전하는 개체 만들기

화산 만들기

폭포 만들기

GUI 만들기

체력 픽업 만들기

스코어 바 만들기

스크립트 생성하기

스파클러 만들기

텍스처 맵 만들기

제작 및 게시

맵 생성하기

모듈 스크립트를 사용하여 생성하기

제작 개요

크리에이터 펀드

크리에이터 상점

크로스 플랫폼 디자인

서버 간 메시징

현재 릴리스

커브 편집기

사용자 정의

커스텀 필드

사용자 정의 파티클 이펙트

사용자 정의 섬네일

커스텀 번역

전역 조명 사용자 정의

사용자 정의 및 공유

체험 내 텍스트 채팅 사용자 정의

원통

DMCA 가이드라인

데이터 모델

데이터 저장소

데이터 구조

데이터 형식

죽음의 용암

디버깅

다크 사운드스케이프 디자인

교육적 경험 디자인하기

Roblox에서 디자인하기

포즈 디자인하기

스피더 디자인하기

지도 디자인하기

성능 중점 디자인

세계 디자인하기

타격 감지

사용자 입력 감지

정교한 애셋 개발

개발자 콘솔

개발자 상품

월드의 움직임 구현

사전과 배열

디지털 시민권

기본 UI 요소 비활성화

검색 및 발견

드래그 탐지기

중복 및 디자인

다이내믹 효과

Roblox에서 수익 창출하기

경제 이벤트

교육자 온보딩

이펙트

Else/If 연습 - 점수 주기

텍스처 임베딩 및 내보내기

감정 표현 바

감정 표현

매치 종료

참여도

참여 기반 페이아웃

내부 환경 강화하기

외부 환경 강화하기

퓨처 조명으로 야외 환경 개선하기

열거형

환경

환경 아트

오류 보고

오류

이벤트 주최자

이벤트 시퀀서

이벤트 유형

이벤트

이벤트 플랫폼

체험 가이드라인

체험 아이콘

체험 알림

체험 섬네일

체험 콘텐츠

체험

탐색기 창

설정 내보내기

내보내기

애니메이션 내보내기

Maya에서 애니메이션 내보내기

캐릭터 모델링 내보내기

FBX 내보내기

블렌더에서 FBX 내보내기

외부 카탈로그 쿼리

외부 도구

엑스트라 머리 개체

FACS 포즈 참조

사라지는 트랩

주요 콘텐츠

기능

최종 확인

프로젝트 완료하기

완료 및 추가

프로젝트 완료

Blast 끝내기

도전을 완료하십시오

피팅 및 컨버전

기본 게임플레이 시스템

프레임

자주 묻는 질문

친구 로케이터

함수

함수와 이벤트

퍼널 이벤트

은하수 스피드웨이

게임 펀드

게임 설정

게임 패드

게임 플레이 스크립팅

지상에서 벗어나다

시작하기

Roblox 공식 채널에서 추천받기

개발자를 위한 시작하기

전역 조명

전역 바람

전역

For 반복문을 이용한 발광 조명

도전을 넘어서

레이스 참가하기

교육자 온보딩으로 이동

환경 그레이박스

플레이 가능 영역 그레이박스

부품 그룹화

그룹

오디언스 늘리기

가이드라인

요청 처리

해시 맵

머리

강조 표시

힌지

레이저 적중 감지

홈 탭

아이콘 및 섬네일

이슈 판별

만약/그렇다면 연습 - 강화 아이템

만약/그렇다면 연습 - 함정

몰입형 광고

몰입형 내러티브

구현

블래스터 행동 적용

플레이어 데이터 및 구매 시스템 구현

PBR 텍스처 가져오기

Studio로 가져오기

성능 개선

Blender에서 테스트

체험 내 애셋 제작

체험 내 도구

체험 내 UI 컨테이너

게임 내 사운드

Studio에서 테스트

Behavior

입력 및 카메라

설치 및 설정

인스턴스

인스턴스 속성

인스턴스 스트리밍

지적 재산권

인터랙티브 버튼

파트 인터페이스

중급 게임 플레이

스크립팅 입문

배열 소개

사전 소개

디지털 시민성 소개

디지털 안전 소개

For 루프 소개

게임 디자인 및 코딩 소개

If 문에 대한 소개

모듈 스크립트 소개

Roblox 소개

인벤토리

역 운동학

친구 초대하기

친구들을 게임에 초대하기

섬 지형

움직이는 섬

레이블

언어 코드

빔 레이저 트랩

레이어드 복장

레이아웃 및 모양

레이아웃 및 디자인

리더보드

기존 채팅 시스템

라이브러리

광원

프롭을 이용한 조명

라이트와 폴란드어

라인포스

리니어벨로시티

로블록스 교육자 목록

LiveOps 필수 요소

운영 기획

불러오기 화면

로컬라이제이션

로컬라이제이션 스크립팅

루핑 애니메이션

배열 순환하기

반복문

Luau

Luau 레퍼런스

주요 디자인 요구 사항

최종 수정 하기

배열에 변경 사항 만들기

메시 촘촘하게 만들기

폭발 만들기

관리

플레이어 관리

원더 맨션

수동 편집 로컬라이제이션 테이블

마케팅 자료

마켓플레이스 수수료 및 커미션

마켓플레이스 개요

마켓플레이스 정책

재질 생성기

월드에 재질 적용하기

재질

기계적 제약

메모리 저장소

메모리 사용

굿즈 부스

메시

메시징

메타테이블

마이크로 프로파일러

체험 내 텍스트 채팅으로의 마이그레이션

미니맵 시스템

모바일

모델 탭

모델링

모델링 사양

모델

모더레이션

외부 케이지 모디파이

수익 창출

수익 창출 기초

모니터링

성능 모니터링

무드

마우스 및 키보드

무버 제약

몸 움직이기

멀티스레딩

Else/If와 다중 조건들

다중 매개 변수와 인수

NPC 키트

이름 및 체력 표시

네이티브 코드 생성

중첩 루프

네트워크 소유권

다음 단계

콜리전없음

둘러보기 페이지 등재 신청하기

숫자

OAuth 2.0

객체 속성

개체

관측 가능성

온스크린 UI 컨테이너

온보딩

온보딩 테크닉

템플릿 열기

연산자

체험 최적화

코드 정리

출력 창

PBR 재질 레퍼런스

PBR 텍스처(선택)

패키지

유료 액세스

쌍 (Pairs) 과 반복 가능한 쌍 (iPairs)

매개 변수 연습 - 버튼

부모와 자녀

입자 방출기

파트

패스

경로 찾기

패턴

파티션당 제한

성능

성능 최적화

포토 부스

물리 기반 렌더링(PBR)

물리

픽업 시스템

피벗 도구

플레이스 게시

비행기

교육 환경 계획하기

식물 참조 프로젝트

플랫폼 개요

플레이어 초대 프롬프트

플레이어 UI

플레이어

배경 음악 재생

로블록스에서 플레이하기

지도 플레이테스트하기

플러그인 탭

정책 및 가이드라인

위치 지정 및 크기 조정

후처리 이펙트

각기둥

비공개 서버

상품

프로필 카드

프로젝트 정리

프로젝트 설정

프로젝트

홍보

속성 창

속성 및 특성

프로토타입

근접 프롬프트

게시

눈썹 및 속눈썹 게시

마켓플레이스에 게시

퀘스트 디자인

퀵 액세스 도구

R6-R15 어댑터

랜덤 가상 아이템 정책

레이캐스팅

실시간

플레이어 데이터 기록 및 표시

레퍼런스 애셋

레퍼런스 파일

레지스트레이션

624 릴리즈 노트

625 릴리즈 노트

626 릴리즈 노트

627 릴리즈 노트

628 릴리즈 노트

629 릴리즈 노트

630 릴리즈 노트

631 릴리즈 노트

632 릴리즈 노트

원격

엑스트라 뼈 제거

while 루프를 사용한 코드 반복

유지율

테이블에서 값 반환하기

재사용 코드

서식 있는 텍스트 마크업

리그 빌더

리깅

휴머노이드 모델 리깅

휴머노이드 모델 리깅(블렌더)

심플 메시 리깅(블렌더)

리깅 및 스키닝

권리 관리자

삭제권 이행 요청

강성

리지드 액세서리

Roblox 블렌더 플러그인

Roblox Connect 프로젝트

Roblox 개발자 101

Roblox Studio

로블록스 스튜디오 기초

Roblox 단위

Roblox 사용자 기반

Roblox를 위한 AP CSP

Unity 개발자용 Roblox

Unreal 개발자용 Roblox

막대

밧줄

런닝 클래스룸

게임 실행

샘플 App

저장하고 게시하십시오

저장하려면 출판하십시오

데이터 저장

보물찾기

스케줄러

범위

포인트 득점

Lua Debugger

스크립트 프로파일러

스크립트 탭

업그레이드 버튼 스크립팅

스크립팅

아바타 애니메이션 스크립팅

스크립트

스컬프팅

디테일 스컬프팅

지형 스컬프팅하기

시즌 패스 디자인

보안 전술 및 치트 완화

셀카 모드

판매 항목

크리에이터 상점에서 판매

장신구 판매

서비스

메시 설정

Studio 설정

로블록스 교실 설정하기

팀 구성하기

스피더 공유하기

휴머노이드 모델 스키닝

휴머노이드 모델 스키닝(블렌더)

심플 메시 스키닝(블렌더)

스카이박스

절전 시스템

그리드에 맞추기

상호 작용

입체 모델링

정렬된 맵

사운드

사운드 디자인

공간 데이터

게임 내 음성 채팅

친구와 함께 스폰하기

스폰 및 리스폰

사양

체험 스폰서

아이템 스폰서

용수철

무더기

코딩 시작

스토리 게임

스트리밍

몰입형 스트리밍

문자열

Studio

Studio 인터페이스

Studio 바로 가기

Studio 테스트 모드

구독 디자인

지원 시스템

표면 아트

테이블

태그 표

비행 가져 가기

인재 허브의 개발자 안전

작업 스케줄러

원격 교육

기술 개요

기술 사양

텔레포트

템플릿 파일

템플릿

지형

지형 편집기

지형 도구

테스트 탭

테스트하고 플레이

테스트하고 저장

테스트

캐릭터 테스팅

포즈 테스팅

게임 테스트

스피더 테스트하기

텍스트 채팅

텍스트 필터링

텍스트 입력

텍스처 생성기

텍스처 페인팅

텍스처 페인팅 설정

텍스처 사양

텍스처 및 데칼

텍스처링

눈 텍스처링

얼굴 텍스처링

듀발 드라이브의 미스터리

폭풍

제삼자 애널리틱스 서비스

제3자 소프트웨어

For 반복문을 이용한 시간 제한 다리

타이머와 이벤트

팁 및 설정

도구 상자

도구

토크

토션스프링

트레일

다이내믹 콘텐츠 번역

체험 페이지 정보 번역

체험 콘텐츠 번역

복장 형태 트리밍

튜플

유형 확인

강제 형 변환

형식

유형 및 위치

UI 애니메이션

UI 및 UX

단위 수업

유니버설

업로드 및 게시

애셋 업로딩

사용자 광고

사용자 인터페이스

사용자 데이터

애니메이션 사용

Studio에서 머리 사용하기

매개 변수를 사용하여 정보 다루기

MicroProfiler 사용

동작에 파티클 사용하기

파티클을 이용한 폭발 제작

Studio의 3D 임포터

텍스처 사용하기

장신구 조정 도구 사용

VR 가이드라인

검증 도구

변수

변수 & 객체

벡터포스

연결부 검증

영상 애셋

영상 프레임

보기 탭

무기 키트

Webhook 알림

용접

번역자와 작업하기

팀 작업

이야기 쓰기

Xbox 가이드라인