From 5c8cf02d2d8b28f937f2fac51df9ad998153158a Mon Sep 17 00:00:00 2001 From: Anthony Tesija Date: Thu, 12 Jun 2025 22:32:35 +0000 Subject: [PATCH 1/3] Added nameplate documentation --- docs/resources/user.mdx | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/docs/resources/user.mdx b/docs/resources/user.mdx index f7eff1c1f0..e825bdf88b 100644 --- a/docs/resources/user.mdx +++ b/docs/resources/user.mdx @@ -47,6 +47,7 @@ There are other rules and restrictions not shared here for the sake of spam and | premium_type? | integer | the [type of Nitro subscription](/docs/resources/user#user-object-premium-types) on a user's account | identify | | public_flags? | integer | the public [flags](/docs/resources/user#user-object-user-flags) on a user's account | identify | | avatar_decoration_data? | ?[avatar decoration data](/docs/resources/user#avatar-decoration-data-object) object | data for the user's avatar decoration | identify | +| collectibles? | ?[collectibles](/docs/resources/user#collectibles) object | data for the user's collectibles | identify | ###### Example User @@ -66,6 +67,14 @@ There are other rules and restrictions not shared here for the sake of spam and "avatar_decoration_data": { "sku_id": "1144058844004233369", "asset": "a_fed43ab12698df65902ba06727e20c0e" + }, + "collectibles": { + "nameplate": { + "sku_id": "2247558840304243311", + "asset": "https://cdn.discordapp.com/fakelocation/asset.webm", + "label": "", + "palette": "#5865F2" + } } } ``` @@ -112,6 +121,30 @@ The data for the user's [avatar decoration](https://support.discord.com/hc/en-us | asset | string | the [avatar decoration hash](/docs/reference#image-formatting) | | sku_id | snowflake | id of the avatar decoration's SKU | +### Collectibles + +The collectibles the user has. This will contain all new collectibles starting with [nameplates](/docs/resources/user#nameplate). Avatar will contine to be in the [user](/docs/resources/user#user-object-user-structure) object. + +###### Collectible Structure + +| Field | Type | Description | +|------------|--------|----------------------------------------------------------------------------------------| +| nameplate? | object | object mapping of [nameplate data](/docs/resources/user#nameplate-nameplate-structure) | + + +### Nameplate + +The nameplate the user has. + +###### Nameplate Structure + +| Field | Type | Description | +|---------|-----------|-----------------------------------------------------------------| +| sku_id | snowflake | id of the nameplate SKU | +| asset | string | path to the [nameplate asset](/docs/reference#image-formatting) | +| label | string | the label of this nameplate. Currently unused | +| palette | string | background color of the nameplate | + ### Connection Object The connection object that the user has attached. From 341aad27dddd111e51b7507fff04e8ef5a72e143 Mon Sep 17 00:00:00 2001 From: Anthony Tesija Date: Fri, 13 Jun 2025 22:29:11 +0000 Subject: [PATCH 2/3] Add better example and palette strings --- docs/resources/user.mdx | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/resources/user.mdx b/docs/resources/user.mdx index e825bdf88b..2f9c5a66ff 100644 --- a/docs/resources/user.mdx +++ b/docs/resources/user.mdx @@ -47,7 +47,7 @@ There are other rules and restrictions not shared here for the sake of spam and | premium_type? | integer | the [type of Nitro subscription](/docs/resources/user#user-object-premium-types) on a user's account | identify | | public_flags? | integer | the public [flags](/docs/resources/user#user-object-user-flags) on a user's account | identify | | avatar_decoration_data? | ?[avatar decoration data](/docs/resources/user#avatar-decoration-data-object) object | data for the user's avatar decoration | identify | -| collectibles? | ?[collectibles](/docs/resources/user#collectibles) object | data for the user's collectibles | identify | +| ? | ?[collectibles](/docs/resources/user#collectibles) object | data for the user's collectibles | identify | ###### Example User @@ -71,9 +71,9 @@ There are other rules and restrictions not shared here for the sake of spam and "collectibles": { "nameplate": { "sku_id": "2247558840304243311", - "asset": "https://cdn.discordapp.com/fakelocation/asset.webm", + "asset": "nameplates/nameplates/twilight/", "label": "", - "palette": "#5865F2" + "palette": "cobalt" } } } @@ -123,7 +123,7 @@ The data for the user's [avatar decoration](https://support.discord.com/hc/en-us ### Collectibles -The collectibles the user has. This will contain all new collectibles starting with [nameplates](/docs/resources/user#nameplate). Avatar will contine to be in the [user](/docs/resources/user#user-object-user-structure) object. +The collectibles the user has, excluding Avatar Decorations and Profile Effects. ###### Collectible Structure @@ -138,12 +138,12 @@ The nameplate the user has. ###### Nameplate Structure -| Field | Type | Description | -|---------|-----------|-----------------------------------------------------------------| -| sku_id | snowflake | id of the nameplate SKU | -| asset | string | path to the [nameplate asset](/docs/reference#image-formatting) | -| label | string | the label of this nameplate. Currently unused | -| palette | string | background color of the nameplate | +| Field | Type | Description | +|---------|-----------|------------------------------------------------------------------------------------------------------------------------------------------------------| +| sku_id | snowflake | id of the nameplate SKU | +| asset | string | path to the [nameplate asset](/docs/reference#image-formatting) | +| label | string | the label of this nameplate. Currently unused | +| palette | string | background color of the nameplate, one of: `crimson`, `berry`, `sky`, `teal`, `forest`, `bubble_gum`, `violet`, `cobalt`, `clover`, `lemon`, `white` | ### Connection Object From aba9b1e29905fb43e77bcee4384c3dfbcb8dbf71 Mon Sep 17 00:00:00 2001 From: Anthony Tesija Date: Fri, 13 Jun 2025 22:30:48 +0000 Subject: [PATCH 3/3] Oops --- docs/resources/user.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/resources/user.mdx b/docs/resources/user.mdx index 2f9c5a66ff..41b1b0a751 100644 --- a/docs/resources/user.mdx +++ b/docs/resources/user.mdx @@ -47,7 +47,7 @@ There are other rules and restrictions not shared here for the sake of spam and | premium_type? | integer | the [type of Nitro subscription](/docs/resources/user#user-object-premium-types) on a user's account | identify | | public_flags? | integer | the public [flags](/docs/resources/user#user-object-user-flags) on a user's account | identify | | avatar_decoration_data? | ?[avatar decoration data](/docs/resources/user#avatar-decoration-data-object) object | data for the user's avatar decoration | identify | -| ? | ?[collectibles](/docs/resources/user#collectibles) object | data for the user's collectibles | identify | +| collectibles? | ?[collectibles](/docs/resources/user#collectibles) object | data for the user's collectibles | identify | ###### Example User