Skip to content

Commit 85ca21c

Browse files
sync: update documentation sources (2026-03-11 02:05 UTC)
1 parent cc4745a commit 85ca21c

10 files changed

Lines changed: 1730 additions & 303 deletions

File tree

roblox-api/Full-API-Dump.json

Lines changed: 1590 additions & 101 deletions
Large diffs are not rendered by default.

roblox/en-us/art/characters/manually-update-catalog-heads.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -138,8 +138,9 @@ Import your head back into Studio and verify that it passes validation. If valid
138138
1. Select **Save to Roblox** on your asset.
139139
2. Select **Development Item**.
140140
3. Set its **Asset Category** to Model.
141-
4. Save the model to Roblox (no publishing fees are incurred).
142-
5. After saving to Roblox, save the asset ID provided.
141+
4. Set **Asset Privacy** to `Public` (default value is `Private`).
142+
5. Save the model to Roblox (no publishing fees are incurred).
143+
6. After saving to Roblox, save the asset ID provided.
143144
1. While you can submit either the head or body asset, there is no distinction between head and body asset when saving as a development item.
144145
2. For submission to the web form, we prefer that you get the asset ID of the head, but you can use either the head or body asset ID and Roblox will replace the head accordingly.
145146

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
version https://git-lfs.github.com/spec/v1
2-
oid sha256:5028f99e0437b868684e3e84b6755c6c7a28c24804e4ee030e1d5599e1d243fd
3-
size 32063707
2+
oid sha256:ed1d4cd521ea0eb0cc5c48ad430a7b0c8504a6d64b5edda95a004cd8faf8229e
3+
size 32265733
Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
version https://git-lfs.github.com/spec/v1
2-
oid sha256:7faa74160650effd3d2a467a9584f82303762dda33038301bef20157ae494982
3-
size 32280585
2+
oid sha256:232a8bfd0079cecbd6b59ee142378239185960ebaa718f15e3ecd204febea17f
3+
size 32308599
Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
version https://git-lfs.github.com/spec/v1
2-
oid sha256:6656e57efcd3ee1649d9c3a81e5fc32c2484335287171049e9a41143614892bb
3-
size 16338018
2+
oid sha256:d28cfda9411ce8e7edfad81aa582877474c8a26e214e9cfeaf5fac304a57c76e
3+
size 16541054
Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
version https://git-lfs.github.com/spec/v1
2-
oid sha256:2c74bdf32fb1b0f7fe899c7ca69cdf22bb8324cd46eaacd1ff66f4b6223ab9fc
3-
size 17414833
2+
oid sha256:d627c3a0f6ec4e198a1321110e1ae93eeff6d7871835b285c5c1ddd62cc01d76
3+
size 17718707
Lines changed: 3 additions & 0 deletions
Loading

roblox/en-us/makeup/index.md

Lines changed: 71 additions & 63 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ Makeup assets intended for the Marketplace can include up to 6 total decals, com
4545

4646
### Makeup template
4747

48-
The makeup template resource, available in the [Makeup Beta downloadable resource](#resources) is a 3D model asset that allows creators to quickly import premade makeup assets into their own 3D modeling tools where you can modify, create, and preview your own makeup assets.
48+
Each makeup template resource, available in the [resources](#resources) section later in this guide, provides a 3D model asset that allows creators to quickly import premade makeup assets into their own 3D modeling tools where you can modify, create, and preview your own makeup assets.
4949

5050
<GridContainer numColumns="2">
5151
<figure><img src="../assets/makeup/Makeup-Full-Render.png" /><figcaption>Reference template render</figcaption></figure>
@@ -60,12 +60,12 @@ The makeup template includes the following:
6060
- Multiple face region mesh objects, fully linked to reference PBR textures
6161
- Eyebrows and eyelash mesh objects.
6262

63-
For a general workflow on authoring makeup using the template, see [the makeup creation process](#creation-process).
63+
For a general workflow on authoring makeup using the template, see the next section.
6464

6565
## Creation process
6666

6767
<Alert severity ='info'>
68-
Makeup is currently in beta. Check out the DevForum announcement for the latest information on additional features, tools, and details regarding creating or implementing makeup.
68+
Makeup is currently in beta. Check out the [DevForum announcement](https://devforum.roblox.com/t/studio-beta-introducing-avatar-makeup/3973764) for the latest information on additional features, tools, and details regarding creating or implementing makeup.
6969
</Alert>
7070

7171
<GridContainer numColumns="3">
@@ -103,7 +103,11 @@ As always with 3D art and creation workflows, there are many ways to achieve a s
103103

104104
## Resources
105105

106-
The following are downloadable resources. See [Template heads](#template-heads) for required 3D models to import makeup assets with. See [Template textures](#template-textures) for additional image and project files available for your convenience and refernece.
106+
The following are downloadable resources you can use within the creation process:
107+
108+
- See [Template textures](#template-textures) for image and project files you can use in 2D editing software like GIMP or Photoshop.
109+
- See [Template heads](#template-heads) for required 3D models you can use to view and test your makeup assets.
110+
- See [Reference experience](#reference-experience) to import and test your makeup assets into Studio
107111

108112
<Alert severity = 'info'>
109113
For resources that include two templates, in almost every case **it's recommended to use the mesh template** to create makeup because:
@@ -115,11 +119,73 @@ Some creators prefer using the cage template because there is only one transfer
115119
</Alert>
116120

117121
<Alert severity = 'warning'>
118-
Be sure to review your options _before_ starting to create makeup because you cannot start with one template, then transfer your makeup to the other.
122+
Be sure to review your options **before** starting to create makeup because you cannot start with one template, then transfer your makeup to the other.
119123
</Alert>
120124

125+
### Template textures
126+
127+
<Grid container alignItems="stretch" style={{}}>
128+
<Grid item xs={12} md={6} lg={4} style={{ padding: 6, display: 'flex' }}>
129+
<Card style={{ flex: 1, display: 'flex', flexDirection: 'column' }}>
130+
<CardContent style={{ flexGrow: 1 }}>
131+
<center>Photoshop / GIMP texture images</center>
132+
<figure>
133+
<center>
134+
<img src="../assets/makeup/resources/Photoshop-Thumbnail.png" width="100%" />
135+
</center>
136+
<center>
137+
<img src="../assets/makeup/resources/Photoshop-Thumbnail-Cage.png" width="100%" />
138+
</center>
139+
</figure>
140+
<figure>
141+
A comprehensive `.zip` folder texture images for use in Photoshop or your preferred image editor.
142+
<br />
143+
When you are finished making changes to these texture images, swap out the textures in the template head using Blender/Maya and import the reference head with new textures into Studio.
144+
</figure>
145+
</CardContent>
146+
<CardActions style={{bottom: 0, width: '100%'}}>
147+
<Button href="../assets/makeup/resources/Makeup-Textures-Photoshop-Gimp-Mesh.zip" fullWidth size='large' color='primary' variant='contained' style={{marginBottom:"4px;"}}>Mesh Template</Button>
148+
</CardActions>
149+
<CardActions style={{bottom: 0, width: '100%'}}>
150+
<Button href="../assets/makeup/resources/Makeup-Textures-Photoshop-Gimp-Cage.zip" fullWidth size='small' color='secondary' variant='contained' style={{marginBottom:"4px;"}}>Cage Template</Button>
151+
</CardActions>
152+
</Card>
153+
</Grid>
154+
155+
<Grid item xs={12} md={6} lg={4} style={{ padding: 6, display: 'flex' }}>
156+
<Card style={{ flex: 1, display: 'flex', flexDirection: 'column' }}>
157+
<CardContent style={{ flexGrow: 1 }}>
158+
<center>Substance Painter files</center>
159+
<figure>
160+
<center>
161+
<img src="../assets/makeup/resources/Substance-Thumbnail.png" width="100%" />
162+
</center>
163+
<center>
164+
<img src="../assets/makeup/resources/Substance-Thumbnail-Cage.png" width="100%" />
165+
</center>
166+
</figure>
167+
<figure>
168+
A comprehensive `.zip` folder texture files for use in Substance Painter, an industry-standard PBR authoring software.
169+
<br />
170+
When you are finished making changes to these texture images, swap out the textures in the template head using Blender/Maya and import the reference head with new textures into Studio.
171+
</figure>
172+
</CardContent>
173+
<CardActions style={{bottom: 0, width: '100%'}}>
174+
<Button href="../assets/makeup/resources/Makeup-Textures-SubstancePainter-Mesh.zip" fullWidth size='large' color='primary' variant='contained' style={{marginBottom:"4px;"}}>Mesh Template</Button>
175+
</CardActions>
176+
<CardActions style={{bottom: 0, width: '100%'}}>
177+
<Button href="../assets/makeup/resources/Makeup-Textures-SubstancePainter-Cage.zip" fullWidth size='small' color='secondary' variant='contained' style={{marginBottom:"4px;"}}>Cage Template</Button>
178+
</CardActions>
179+
</Card>
180+
</Grid>
181+
</Grid>
182+
121183
### Template heads
122184

185+
<Alert severity = 'info'>
186+
The Blender and Maya templates also include a facial region reference `.png` file that you can use to reference how your makeup assets fit into the eye, lips, and face/cheek regions.
187+
</Alert>
188+
123189
<Grid container alignItems="stretch" style={{}}>
124190
<Grid item xs={12} md={6} lg={4} style={{ padding: 6, display: 'flex' }}>
125191
<Card style={{ flex: 1, display: 'flex', flexDirection: 'column' }}>
@@ -197,64 +263,6 @@ A comprehensive `.zip` folder of `.fbx` and `.gltf` assets, including heads with
197263

198264
</Grid>
199265

200-
### Template textures
201-
202-
<Grid container alignItems="stretch" style={{}}>
203-
<Grid item xs={12} md={6} lg={4} style={{ padding: 6, display: 'flex' }}>
204-
<Card style={{ flex: 1, display: 'flex', flexDirection: 'column' }}>
205-
<CardContent style={{ flexGrow: 1 }}>
206-
<center>Photoshop / GIMP texture images</center>
207-
<figure>
208-
<center>
209-
<img src="../assets/makeup/resources/Photoshop-Thumbnail.png" width="100%" />
210-
</center>
211-
<center>
212-
<img src="../assets/makeup/resources/Photoshop-Thumbnail-Cage.png" width="100%" />
213-
</center>
214-
</figure>
215-
<figure>
216-
A comprehensive `.zip` folder texture images for use in Photoshop or your preferred image editor.
217-
<br />
218-
When you are finished making changes to these texture images, swap out the textures in the template head using Blender/Maya and import the reference head with new textures into Studio.
219-
</figure>
220-
</CardContent>
221-
<CardActions style={{bottom: 0, width: '100%'}}>
222-
<Button href="../assets/makeup/resources/Makeup-Textures-Photoshop-Gimp-Mesh.zip" fullWidth size='large' color='primary' variant='contained' style={{marginBottom:"4px;"}}>Mesh Template</Button>
223-
</CardActions>
224-
<CardActions style={{bottom: 0, width: '100%'}}>
225-
<Button href="../assets/makeup/resources/Makeup-Textures-Photoshop-Gimp-Cage.zip" fullWidth size='small' color='secondary' variant='contained' style={{marginBottom:"4px;"}}>Cage Template</Button>
226-
</CardActions>
227-
</Card>
228-
</Grid>
229-
230-
<Grid item xs={12} md={6} lg={4} style={{ padding: 6, display: 'flex' }}>
231-
<Card style={{ flex: 1, display: 'flex', flexDirection: 'column' }}>
232-
<CardContent style={{ flexGrow: 1 }}>
233-
<center>Substance Painter files</center>
234-
<figure>
235-
<center>
236-
<img src="../assets/makeup/resources/Substance-Thumbnail.png" width="100%" />
237-
</center>
238-
<center>
239-
<img src="../assets/makeup/resources/Substance-Thumbnail-Cage.png" width="100%" />
240-
</center>
241-
</figure>
242-
<figure>
243-
A comprehensive `.zip` folder texture files for use in Substance Painter, an industry-standard PBR authoring software.
244-
<br />
245-
When you are finished making changes to these texture images, swap out the textures in the template head using Blender/Maya and import the reference head with new textures into Studio.
246-
</figure>
247-
</CardContent>
248-
<CardActions style={{bottom: 0, width: '100%'}}>
249-
<Button href="../assets/makeup/resources/Makeup-Textures-SubstancePainter-Mesh.zip" fullWidth size='large' color='primary' variant='contained' style={{marginBottom:"4px;"}}>Mesh Template</Button>
250-
</CardActions>
251-
<CardActions style={{bottom: 0, width: '100%'}}>
252-
<Button href="../assets/makeup/resources/Makeup-Textures-SubstancePainter-Cage.zip" fullWidth size='small' color='secondary' variant='contained' style={{marginBottom:"4px;"}}>Cage Template</Button>
253-
</CardActions>
254-
</Card>
255-
</Grid>
256-
</Grid>
257-
258266
### Reference experience
259267

260268
<Grid container alignItems="stretch" style={{}}>

0 commit comments

Comments
 (0)