Skip to content

Added nameplate documentation #7614

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jun 13, 2025
Merged

Added nameplate documentation #7614

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
5c8cf02
Added nameplate documentation
anthonydiscord Jun 12, 2025
341aad2
Add better example and palette strings
anthonydiscord Jun 13, 2025
aba9b1e
Oops
anthonydiscord Jun 13, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 33 additions & 0 deletions docs/resources/user.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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"
Copy link
Contributor

@advaith1 advaith1 Jun 12, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks like palette is some sort of string enum, not a hex code. can the possible values be documented with their meaning?

  collectibles: {
    nameplate: {
      sku_id: '1349849614198505602',
      asset: 'nameplates/nameplates/twilight/',
      label: 'COLLECTIBLES_NAMEPLATES_TWILIGHT_A11Y',
      palette: 'cobalt'
    }
  }

also asset isn't a full url, it's just the path

Copy link
Contributor Author

@anthonydiscord anthonydiscord Jun 13, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking into getting the palette values documented! We're going to leave the label blank for now until it returns a value.

}
}
}
```
Expand Down Expand Up @@ -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.
Expand Down