Ver el código de «External.Discord»

{{correcto}}

== Información del paquete ==
Este paquete [[GMCP]] envía '''y recibe''' información del cliente del juego y se usa para controlar la integración de Reinos de Leyenda con [https://discord.reinosdeleyenda.es|discord].

A esta integración se le conoce como "Rich Presence" y está documentada en esta [https://discordapp.com/developers/docs/rich-presence/how-to|página].

Los valores enviados tendrán varios formatos que se explican a continuación.

== Datos enviados por el juego ==
{| class="wikitable"
!Operación
!Tipo de dato
!Explicación
|-
|External.Discord.Info
|objeto
|Objeto con dos strings: "inviteurl" y "applicationid".  (ID de la aplicación de Reinos de Leyenda en Discord). Respuesta a External.Discord.Hello.
|-
|External.Discord.Status
|objeto de estado de discord
|Envía un objeto con el estado del jugador para Discord. Ver más abajo los detalles.
|-
|}


=== Objeto de estado de Discord ===
{| class="wikitable"
!Nombre del valor
!Tipo de valor
!Descripción
|-
|game
|string
|Nombre del juego que se mostrará en Discord (p.ej.: "Reinos de Leyenda")
|-
|details
|string
|Texto de los "detalles" de Discord.
|-
|smallimage
|tabla
|Array que contiene dos elementos. El primero será la imagen grande mostrada en Discord; el segundo, la imagen pequeña.
|-
|smallimagetext
|string
|Tooltip de la imagen pequeña
|-
|largeimagetext
|string
|Tooltip de la imagen grande
|-
|state
|string
|Texto corto ("estado", como lo llama Discord) que explica qué haces en el juego
|-
|starttime
|int
|Fecha a la que has empezado la sesión de juego (en formato epoch)
|-
|endtime
|int
|Si estás en algún evento con duración, este valor contendrá el tiempo restante, en segundos
|-
|partysize
|int
|Miembros en tu grupo
|-
|partymax
|int
|Miembros máximos que pueden ir en tu grupo
|}

Ejemplo de uno de estos objetos:
 {
  "starttime" : 1539300230,
  "state" : "Explorando los Reinos",
  "smallimagetext" : "Juez de Satyr",
  "game" : "Reinos de Leyenda",
  "smallimage" : [
      "server-icon",
      "enano"
  ],
  "details" : "www.reinosdeleyenda.es",
  "largeimagetext" : "¡Juega ya en jugar.reinosdeleyenda.es!",
 }

== Datos enviados por el cliente ==

{| class="wikitable"
!Operación
!Tipo de dato
!Explicación
|-
|External.Discord.Hello
|objeto
|Informa al mud de que tu cliente es compatible con Discord. El objeto ''puede'' tener dos valores: "user", que representa a un usuario de discord, y "private", que controla la privacidad que define el jugador.
|-
|External.Discord.Get
|null
|Este mensaje sin cuerpo solicita al mud que envíe un mensaje *External.Discord.Status*
|}

== ¿Cuando se envían? ==
* Al conectar al mud
* Cada cierto tiempo, MudletRL envia una llamada a la función '''RL_discord_actualizar()''' que envía una petición '''External.Discord.Get'''.

[[Categoría:GMCP]]