Cartão de Perfil

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Pode ser interessante aprender sobre outros jogadores. O ProfileCard módulo de desenvolvedor é uma ótima maneira de ver mais informações sobre os outros dentro de uma experiência, desde conquistas de insígnias até as experiências favoritas do jogador.

Uso do módulo

Instalação

Para usar o módulo ProfileCard em uma experiência:

  1. No menu Window do Studio ou na barra de ferramentas da aba Home, abra o Toolbox e selecione a aba Creator Store.

  2. Certifique-se de que a classificação Models esteja selecionada, então clique no botão See All para Categories.

  3. Localize e clique no bloco Packages.

  4. Localize o módulo Profile Card e clique nele, ou arraste e solte-o na visão 3D.

  5. Na janela Explorer, mova o modelo completo ProfileCard para ReplicatedStorage. Ao executar a experiência, o módulo começará a funcionar.

Visualizações

Os cartões de perfil têm diferentes visualizações, dependendo se você está vendo seu próprio cartão ou o cartão de outro jogador.

Quando você aparece pela primeira vez na experiência, um ícone aparece acima do seu personagem. Clicar no ícone abre a visualização do cartão de perfil. Uma vez que o cartão é fechado, o ícone desaparece, mas você pode reabrir o cartão a qualquer momento clicando em seu personagem.

Ao visualizar seu próprio cartão, ele aparece como apareceria para outro jogador, exceto que texto de espaço reservado aparecerá para quaisquer entradas em branco. Além disso, a string de status está sujeita a filtragem de texto, assim como qualquer entrada de texto livre deve ser.

Cartão sem status personalizado
Cartão com status personalizado
Entrando em um status personalizado
Tentativa de entrar em um status inválido

Referência da API

Funções

configure

configure(config: table)

Substitui as opções de configuração padrão através das seguintes chaves/valores na tabela config. Esta função deve ser chamada de um LocalScript dentro de StarterPlayerScripts.

ChaveDescriçãoPadrão
alwaysOnTopSe true, mostra ícones de localizadores em cima de tudo, evitando que eles sejam bloqueados por objetos do mundo 3D.true
showPersonalIndicatorSe true, mostra o indicador pessoal quando um jogador entra pela primeira vez na experiência.true
showBlurSe true, mostra o fundo da tela embaçado quando um jogador entra no modo de edição.true
maxClickDistanceDistância máxima do ponto de vista da câmera em que um cartão aparecerá quando um personagem é clicado, medida em studs.100
backgroundColorCor de fundo para o cartão (Color3).[228, 255, 255]
backgroundTransparencyTransparência da backgroundColor do cartão.0.2
isScaledSe true, redimensiona automaticamente o tamanho do texto para preencher a altura do espaço.false
isTruncatedSe true, oculta automaticamente as extremidades das strings que seriam longas demais para uma visualização adequada.true
hasRoundedCornersSe true, os cantos do cartão serão arredondados.false
cornerRadiusValueValor do raio do canto UICorner, se hasRoundedCorners for true.20
hasBorderSe true, mostra uma borda para o cartão.false
borderColorCor da borda do cartão (Color3). Aplica-se apenas se hasBorder for true.[228, 255, 255]
borderThicknessEspessura da borda do cartão, se hasBorder for true.3
borderTransparencyTransparência da borda do cartão, se hasBorder for true.0
borderLineJoinModeEstilo de canto da borda do cartão (Enum.LineJoinMode). Aplica-se apenas se hasBorder for true.Round
headerFontSizeTamanho da fonte para o cabeçalho do cartão.18
headerFontTypeTipo de fonte para o cabeçalho do cartão (Enum.Font).GothamBlack
textFontSizeTamanho da fonte para o texto do corpo do cartão.15
textFontTypeTipo de fonte para o texto do corpo do cartão (Enum.Font).GothamMedium
LocalScript

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ProfileCard = require(ReplicatedStorage.ProfileCard)
ProfileCard.configure({
alwaysOnTop = true,
maxClickDistance = 50,
backgroundColor = Color3.fromRGB(0, 0, 0),
backgroundTransparency = 0.4
})
©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.