Discord

Estas funções escrevem o cartão de atividade que o Discord exibe embaixo do nome do jogador enquanto ele está no seu servidor. Quem abre o perfil dele vê exatamente o texto, as imagens e os botões que o seu script colocou ali.

Estas 12 funções existem somente no cliente. Chamá-las de um script de servidor resulta em erro de valor nulo.

O que o jogador (e os amigos dele) enxergam

Peça do cartão	Como aparece
Detalhes	Primeira linha de texto.
Estado	Segunda linha de texto.
Imagem grande	Quadro à esquerda do cartão, com um texto ao passar o mouse.
Imagem pequena	Selo no canto da imagem grande, também com texto ao passar o mouse.
Tempo	Contador de tempo decorrido ou de tempo restante.
Tamanho do grupo	Contagem no formato “x de y”, ao lado do estado.
Botões	Até dois botões clicáveis.

Cada peça só aparece quando você preenche ela. Um texto vazio, um tempo 0 ou um grupo com tamanho 0 somem do cartão.

Comece sempre pelo ID do aplicativo

setDiscordApplicationID precisa vir antes de qualquer outra função desta página. Sem ele, todas as outras devolvem false e não mudam nada.

As imagens também não são endereços da internet: você usa o nome do asset cadastrado no mesmo aplicativo cujo ID você informou.

Nota

Entrada inválida interrompe o script. Um argumento do tipo errado, texto grande demais, um ID de aplicativo vazio, um endereço de botão com prefixo não permitido, um grupo maior que o máximo ou um tempo negativo gera um erro Lua em vez de devolver false. Onde a função recebe texto, um número é aceito e convertido.

As chamadas devolvem false, sem erro, quando ainda não há um ID de aplicativo definido ou quando o jogador desligou o Discord Rich Presence nas configurações.

Quando o resource que definiu o ID do aplicativo para de rodar, o cartão é apagado sozinho.

setDiscordApplicationID Define de qual aplicativo do Discord o cartão vem.

setDiscordRichPresenceDetails Escreve a primeira linha de texto do cartão.

setDiscordRichPresenceState Escreve a segunda linha de texto do cartão, logo abaixo dos detalhes.

setDiscordRichPresenceAsset Define a imagem grande do cartão e o texto que aparece ao passar o mouse nela.

setDiscordRichPresenceSmallAsset Define a imagem pequena — o selo que fica no canto da imagem grande.

setDiscordRichPresenceButton Coloca um botão clicável no cartão.

setDiscordRichPresencePartySize Mostra quantos jogadores estão no grupo do jogador e quantos cabem nele.

setDiscordRichPresenceStartTime Define o momento a partir do qual o Discord conta o tempo decorrido.

setDiscordRichPresenceEndTime Define o momento em que a contagem regressiva do cartão chega a zero.

resetDiscordRichPresenceData Apaga o cartão inteiro.

isDiscordRichPresenceConnected Verifica se o cartão está realmente sendo entregue ao Discord.

getDiscordRichPresenceUserID Devolve o ID da conta do Discord logada na máquina do jogador.