Exhaustive model denoting all possible metadata fields of an asset

Client-authoritative meta model format version
- default is always 1

A model containing details about an asset
- V2: adds CurrentVersionId, AssetMetaModel

A model containing details about an asset type

A model which contains
- an asset id
- AssetMetaModel

Gets or sets a value indicating whether the request was a success.

A model containing details about an avatar

Whether default clothing has been applied to this avatar.

A non empty string indicates that there is more data available than this response contains. An empty string indicates the last page.

A model containing RGB hex colors for each body part.

The RGB hex color for head color, e.g. #FFFFFF

The RGB hex color for left arm color, e.g. #FFFFFF

The RGB hex color for left leg color, e.g. #FFFFFF

The RGB hex color for right arm color, e.g. #FFFFFF

The RGB hex color for right leg color, e.g. #FFFFFF

The RGB hex color for torso color, e.g. #FFFFFF

A model container BrickColor ids for each body part.

Response object representing a user's emote

Whether the outfit can be modified by the user.

A model containing details needed to update or create an outfit

The type of outfit ['Invalid' = 0, 'Avatar' = 1, 'DynamicHead' = 2, 'Shoes' = 4]

A model that contains a list of AssetWear models

The assets that could not be worn
Unlike invalidAssetIds, only contains assets that are wearable types

Whether or not all the outfit contents were successfully worn

Avatar Api v2

0: Authorization has been denied for this request.

Returns details about the authenticated user's avatar

bodyColorsModel

Sets the authenticated user's body colors

Only allows items that you own, are not expired, and are wearable asset types.
Any assets being worn before this method is called are automatically removed.

wearRequestModel

3: Invalid assetId
5: Meta does not apply to specified asset type
7: Required meta is not provided for the specific asset type

Sets the avatar's current assets to the list

Includes assets, bodycolors, and playerAvatarType.

userId

1: The specified user does not exist.
2: An account for the given userId does not exist!

Returns details about a specified user's avatar

The token received from the response to get the next page. For the first request, this value should be empty. Note : If no value is sent the 1st page will be returned.

paginationToken

The outfit type being searched for, null will return all outfitTypes

outfitType

The page number of the current page of requests, default is 1.

page

The max number of outfits that can be returned.

itemsPerPage

Whether the outfits are editable. A null value will lead to no filtering.

isEditable

Gets a list of outfits for the specified user.

Fails if any of the assetIds are not owned by the user, or not wearable types.
The name property of the request is optional as one will be auto-generated when the request has a null name.

outfitUpdateModel

3: Body colors must be valid BrickColor IDs
4: Invalid outfit name
5: Asset is not wearable by you and was not added to the outfit
7: Invalid Player Avatar Type. Valid types are R6 and R15
8: Invalid assetIds
9: Meta does not apply to specified asset type
10: Required meta is not provided for the specific asset type

0: Token Validation Failed
1: You already have the maximum number of outfits

6: An error occurred while creating the outfit

Fails if the user does not own any of the assetIds or if they are not wearable asset types.
Accepts partial updates.

userOutfitId

1: The specified userOutfit does not exist!
1: Must provide both assetIds and bodyColors in to update outfit contents.
3: Body colors must be valid BrickColor IDs
4: Invalid outfit name
5: Asset is not wearable by you
8: Invalid Player Avatar Type. Valid types are R6 and R15
11: Meta does not apply to specified asset type
12: Meta is required for this specific asset type

0: Token Validation Failed
2: You don't have permission to update this outfit.

6: An error occurred while trying to update the outfit

Fails if the user does not own any of the assetIds or if they are not wearable asset types.

1: The specified userOutfit does not exist!
3: Body colors must be valid BrickColor IDs
4: Invalid outfit name
5: Asset is not wearable by you
7: Invalid assetIds
8: Invalid Player Avatar Type. Valid types are R6 and R15

Ringkasan

Pengalaman Virtual

Avatar

Aset

Open Cloud

Buat

Penemuan

Pelokalan

Analitik

Desain

Scale

Afiliasi

Monetize

Metode ini tidak sinkron dan menghasilkan sebuah `Operasi`, yang mewakili keadaan operasi saat ini. Operasi tersebut berisi jalur endpoint yang dapat Anda pantau untuk memperoleh respons aktual dan metadata yang relevan. Lihat [dokumentasi]({longRunningOperationsLink}) tentang operasi jangka panjang untuk mengetahui informasi selengkapnya.
            
Bagian berikut menjelaskan objek respons dan metadata yang disediakan saat operasi selesai.

Endpoint beta siap digunakan publik. Perubahan yang menyebabkan kerusakan mungkin terjadi tetapi jarang.

Kolom ini mungkin akan muncul saat resource dibuat, tetapi mungkin tidak akan diubah oleh permintaan berikutnya.

Kolom ini boleh diisi saat pembuataan resource, tetapi tidak boleh diubah melalui permintaan berikutnya.

Kolom ini mungkin akan disediakan di permintaan, tetapi tidak akan pernah disertakan di respons.

Per Kunci API: {maxInPeriod} permintaan setiap {periodInSeconds} detik per Alamat IP

Kolom ini mungkin akan muncul di respons, tetapi akan diabaikan di permintaan.

Izin kunci API berikut diperlukan untuk memanggil endpoint ini. Untuk mengetahui
informasi selengkapnya tentang cara membuat kunci yang tepat, lihat [Cara Mengelola Kunci API]({apiKeyReferenceDocLink}).

Endpoint berikut tersedia di jalur relatif terhadap base URL.

String ini diformat sebagai [FieldMask](/cloud/reference/types#fieldmask).

Nilai JSON dapat berupa `null`, `boolean`, `string`, `number`, `array`, atau `object`.

Cakupan berikut diperlukan agar aplikasi OAuth 2.0 dapat menggunakan endpoint ini. Untuk mengetahui informasi selengkapnya tentang cara mendaftarkan aplikasi OAuth 2.0, lihat [Pendaftaran dan review aplikasi]({oauth2ReferenceDocLink}).

Objek berikut mendeskripsikan muatan yang diterima atau diberikan. Lihat masing-masing endpoint untuk mengetahui informasi selengkapnya tentang waktu penggunaan objek ini.

String ini diformat sebagai [Timestamp](/cloud/reference/types#timestamp).

Cakupan berikut diperlukan agar aplikasi OAuth 2.0 dapat menggunakan endpoint ini. Untuk mengetahui informasi selengkapnya tentang cara mendaftarkan aplikasi OAuth 2.0, lihat [Pendaftaran dan Review Aplikasi]({oauth2ReferenceDocLink}).

This allows viewing information about your assets.

This allows uploading and updating assets to Roblox.

Grants the ability to update badges owned by the user.

This allows viewing information about your commerce items.

This allows editing of your commerce merchant connections.

This allows you to view information about your Creator Store products.

This allows you to modify information about your Creator Store products.

This allows viewing information about your communities.

This allows you to manage community join requests and role updates of lower-ranked community members for your account.

This allows viewing information about your inventory.

Grants access to mange your badges and spend robux.

Grants access to manage your developer products.

Grants access to read information about the experiences you follow.

Grants access to follow and unfollow experiences on your behalf.

Grants access to manage your communities.

Grants permission to read community information.

Grants access to read and write your localization tables

Grants access to manage team collaboration for all experiences you own.

Grants access to manage your experiences and certain information associated with your experiences (e.g. localization information).

Grants access to read your experiences' localization information.

Grants access to modify your experiences' localization preferences.

Grants access to manage your user account.

Grants access to modify user localization preferences.

This grants the ability to publish messages on behalf of users.

This allows sending notifications from your experience to users.

This allows listing secrets associated with your experience.

This allows creating and updating secrets associated with your experience.

Grants access to read about your subscription products.

Grants the ability to read place information.

Grants the ability to edit place information.

This operation grants access to publish new versions of experiences to Roblox.

Grants the ability to read experience information.

Grants the ability to edit experience information.

Allows you to view user restrictions in the experience.

Allows you to edit user restrictions in the experience.

Grants the ability to read user's premium and verified status.

This allows you to view a user's social accounts.

This enables Single Sign-On functionality.

This grants access to read your profile information.

Nilai Default: {defaultValueStart}{defaultValueEnd}

Array adalah daftar nilai berurutan. Array berguna untuk menyimpan koleksi data.

Satu set pasangan nilai kunci, di mana kunci dapat berupa angka, string, atau objek apa pun.

Fungsi ini langsung memberikan nilai jika mungkin, tetapi dapat menghasilkan thread yang memanggilnya sampai dapat memberikan nilai.

{nameStart}nama{nameEnd} tidak lagi didukung atau dikelola oleh Roblox.

Operasi matematika ini sudah tidak didukung atau dikelola oleh Roblox.

Anggota ini tidak muncul di browser objek dan tidak dimaksudkan untuk penggunaan luas.

Anggota ini hanya dapat diakses melalui panel perintah. Upaya untuk mengakses anggota ini dari skrip akan menyebabkan kesalahan.

Fungsi ini tidak dapat menjeda thread Lua yang memanggilnya.

Upaya untuk mengakses anggota ini dalam skrip akan menyebabkan kesalahan. Anda mungkin dapat mengakses anggota ini dari jendela properti di Roblox Studio.

Anggota ini tidak muncul di Browser Objek Roblox Studio.

Kamu tidak dapat membuat instance kelas ini dengan konstruktor Instance.new.

Roblox tidak mereplikasi anggota ini melintasi batas server-kliennya.

Kode Lua tidak dapat mengakses anggota ini. Anda mungkin dapat mengubah nilainya dari jendela properti di Roblox Studio.

Anggota ini dapat diakses dari tugas eksekusi OpenCloud Luau.

Perilaku replikasi objek ini tergantung pada pemain pemiliknya.

Anggota ini dapat diakses melalui panel perintah dan plugin. Upaya untuk mengakses anggota ini dari skrip akan menyebabkan kesalahan.

Anggota ini hanya dapat dibaca. Upaya untuk menulis ke anggota ini akan menyebabkan kesalahan.

Properti ini hanya dapat dibaca dan aman dibaca di thread asinkron. Upaya untuk menulis ke properti ini akan menyebabkan kesalahan.

Anggota ini hanya dapat diakses di CoreScripts.

Hanya Roblox CoreScripts yang dapat mengakses anggota ini, dan Pemain tidak dapat menggunakan Roblox CoreScripts.

Kamu bisa membaca dan menulis ke properti ini dengan aman dari beberapa thread.

Kelas ini adalah jenis tunggal tingkat atas. Ambil instance kelas ini dengan fungsi GetService.

Beberapa thread berpotensi menulis ke properti ini, sehingga pembacaan dari thread asinkron tidak aman.

Fungsi ini menjeda thread Lua yang memanggilnya sampai memberikan hasil. Proses ini tidak mengganggu skrip lain.

Kelola dan analisis semua pengalaman virtualmu di satu tempat yang mudah digunakan.

Belajar dengan dokumentasi dan sumber informasi untuk semua kreator.

Pelajari cara membuat pengalaman virtual Roblox dengan panduan, tutorial, dan contoh kode.

Buat pengalaman virtualmu di Studio, Integrated Development Environment (IDE) kami yang lengkap, lalu deploy ke berbagai perangkat.

Dependable ways to offer value over time to your audience

Learn how to create successful ads that drive traffic to your creations

Chart your experience's growth and discover opportunities to improve

Learn how to apply movement to your characters and environments

Learn how to upload or use assets from Store in your creations

Create Avatar items and publish it to Marketplace

Sorted by highest revenue over the last 7 days

Learn about what you can make and sell on the marketplace

The avatar represents every Roblox user as a customizable character

See this thread of cool creations being built by the community

Learn basic modeling techniques in blender

Find models, scripts, and plugins made by other creators

Learn how to cage your avatar items from Roblox's own 3D artist

Learn how to configure characters to ensure all avatar features work properly

Learn how to create objects that interact with the world or other users

Make and sell your first basic clothing item on Roblox

Use Studio's collaboration tools to work with your team at the same time

Check out what’s trending on the Creator Marketplace

Check out what's trending on the Creator Store

Participate in community events held by other Creators

Find tutorials written by the Creator community

Keep players engaged and monetized with content updates

Captivate your audience with an enjoyable gameplay cycle

Drive engagement and progress with fun, repetitive gameplay

Learn how to create a sliding door without writing any code

Alex shares first-hand experience behind creating the hit experience, JailBreak

Blake found a passion in making realistic, quirky carnival games

The Clemens are the family-owned studio behind hits like The Survival Game

Jasmine is the artist behind some of the most popular avatar items on Marketplace

Jessica is the designer behind imaginative environments like in Alo Yoga

Jenni is the UGC creator and artist behind many popular collaborations

Morphist’s unique style combines cutesy and emo aesthetics

The Riotfall creators travel to find inspiration for their immersive environments

Stephen shares their love of programming tools

Sam shares how they got started designing fashion items that they wish existed

All objects that make up a 3D world, such as parts and lighting

Learn about the range of debugging tools available in Studio

See your progress towards your next cash out!

Use the developer console to debug your experience when testing

Adding subscriptions to your experience helps build long term relationships with your user base. Enable subscriptions before December 15, 2023, and enjoy 3 months of lower rates.

Look at the top Experiences out to get inspiration

Get started with Studio, Roblox’s creation engine

Add a few lines of code to unlock new dashboards to understand your onboarding and other funnels and track your in-game economy.

Minty teaches Enyu about constructive solid geometry.

Build live, cross-server events and cutscenes on a structured sequence

Learn how to create timed events for your experiences

Create time-based events for increased discoverability across Roblox. Announce your latest update, highlight an activity, or celebrate a milestone with your players!

Learn about how to target the age group right for your Creation through Experienced Guidelines

Gain knowledge and expertise directly from Roblox

Learn how to implement a friend invite reward system

Understand the basics of how to create a game

Learn how you can control how your data is used to train AI. {linkStart}Read More{linkEnd}

Easily create custom textures using our AI tools

Use our all-in-one creation engine to build anything you can imagine

PolarCub shares all the tips tricks to make UGC items

Leverage Guilded to build a community for your Creation

Join our incredible cast of creators for a Halloween game jam

Use the head part to create facial animations or trigger emotes

Using metrics to understand where you can improve your gameplay

Figure out how to keep them coming back to your game

User input allow users to interact with your experience environment

Guide players through their first time playing your experience

Create clothing that stretchs and fit over any avatar body

At Roblox, we believe you learn best by doing. Choose one of our guides to explore more of what the platform offers.

Get help writing code and answers to your creation questions

The Lighting and SoundService let you control environmental effects

Learn how to adapt your content to different languages and cultural norms

This walkthrough covers attachments, beams, and some basic scripting concepts that shows you how to set player health to 0 if they touch something

Cultivating an active player base is an instrumental part of developing a successful and enduring game.

Get started with the performance optimization and troubleshooting tool

Microprofiler provides timing information for the task scheduler

Dive deep into frame colors, flame graphs, and more

Understand how to use metrics to be more successful

Improve the performance of computationally intensive Luau scripts

View your daily benchmarks, insights, and real-time metrics to take {boldStart}{experienceName}{boldEnd} to the next level.

Learn how to use NPCs (non-player characters) in your experiences

@minty creates an obby live from scratch using suggestions from chat

Our platform provides you with unparalleled opportunities to create. Get started by exploring the Creator Hub, Roblox Studio, and our vibrant Creator community.

Our platform provides you with unparalleled opportunities to create.

Our community of award-winning studios and self-taught creators all started here, just like you. 

A principal environment artist at Roblox covers how and why to use packages

Learn how to deal with the most common performance problems.

Staff stream about gravity, material properties, and constraints

Learn about what happens when a user joins an experience

Plugins add additional features or functionality to your creations

Let's tour PolarCub's UGC Homestore! Also, Temprist shows up.

Learn how to drive traffic and awareness to your creations

Catch up on all the highlights from this year's RDC

Learn how to sell and promote avatar items with insights from the experts.

Learn efficient workflows for making avatar items in Blender.

Madison_Hatter2 shows how to texture and publish a simple avatar item.

Learn about what’s possible with our creation engine

Learn hwo to rig an R15 humanoid character model

Make and sell your first basic rigid accessory on Roblox

Get a preview of some of the new features and capabilities coming soon to Roblox

Studio is the tool that lets you create experiences on Roblox

Learn how to use the script editor in Studio to create custom scripts

Andrew shows you where to place your scripts, so they run properly.

Scripting lets you add immersive interactions for your users

Learn Studio shortcuts and key commands that make building quicker

Learn how to integrate features that allow players to play with friends

Create a Sponsored Ad to get your Creation in front of more Creators

Studio is an all-in-one tool for building on Roblox. Try making something today!

Learn how to offer players recurring benefits for a monthly fee

Grow your experience with the help of other Creators

Use the terrain editor to generate and alter terrain in Studio

Experiences like {boldStart}{experienceName}{boldEnd} saw an average +8.5% lift in qualified play through rate with personalization.

Translations can help your Creation reach tons of different audiences

Tour the new UGC Homestore template with Minty and SCHLEEMPH

Learn about how to build for Roblox's unique audience

What are they and how you can use them to build

Watch a quick introduction to creating on Roblox, then jump into Studio

Read the latest announcements from Roblox Staff

Manage and grow your creations all in one convenient place

Workspace holds objects that you want the engine to render in your project

Staff stream covering parts, meshes, terrain, and lighting

Intro to texturing for UGC ft. Madison_Hatter2

Avatar v2

Models