Modo avanzado

Qué es un comando#

Un comando personalizado es un pequeño programa que el bot ejecuta cuando alguien escribe un texto en tu servidor, por ejemplo !hola. El lenguaje se parece a JavaScript, pero es mucho más chico: tiene solo lo necesario para mandar mensajes y tarjetas, consultar miembros y dar roles.

ReplyMessage({
    message: "¡Hola! Soy el bot de este servidor",
})

Cómo se activa#

El comando se activa cuando un mensaje contiene su texto de activación. Si el comando usa menciones, el texto puede ir antes o después de la mención:

!darrol @Serez Dev
@Serez Dev !darrol

Distingue mayúsculas y minúsculas. Si varios comandos coinciden, se ejecuta el de texto más largo. Las menciones de roles, @everyone y @here no cuentan como menciones de miembros.

Estructura del código#

Un programa tiene una o más instrucciones, normalmente una por línea. El punto y coma es opcional; el formatter lo quita.

const role = Role("371826690424569866")
const member = GetMember("123456789012345678")

Los saltos de línea dentro de paréntesis, objetos y arrays no terminan la instrucción, así que podés repartir una llamada larga en varias líneas.

Mayúsculas y minúsculas

Los nombres distinguen mayúsculas: GetMember existe, getMember no.

Comentarios

// Comentario de una línea
/*
 * Comentario de varias líneas.
 * No pueden anidarse.
 */
ReplyMessage({
    message: "Hola",
})

Valores#

Texto (strings)

Con comillas dobles o simples; el formatter las pasa a dobles. Para unir textos se usa +.

const first = "Hola"
const second = 'Mundo'
const greeting = first + ", " + second

Números, booleanos y null

const attempts = 0
const average = 4.5
const offset = -5
const enabled = true
const nothing = null

No hay notación exponencial (1e6). null representa la ausencia de un valor.

Objetos

Las propiedades van sin comillas. La coma final es válida y recomendada.

const card = {
    title: "Panel informativo",
    description: "Contenido del panel",
}

SendEmbed(card)

Arrays

Los elementos se leen por posición, empezando en cero.

const roleIds = ["371826690424569866", "371826690424569867"]
AddRole(GetAuthor(), Role(roleIds[0]))

Variables#

let crea una variable que se puede cambiar; const, una que no. Las dos necesitan un valor inicial.

let attempts = 0
attempts += 1
attempts++

const message = "Hola"

const message = "Hola"
message = "Otro mensaje"

Una variable existe solo dentro del bloque { } donde se declaró.

Un objeto guardado en una const sí puede cambiar sus propiedades; lo que no se puede es reemplazarlo entero:

const config = {
    message: "Mensaje inicial",
}

config.message = "Mensaje actualizado"
SendMessage(config)

Propiedades y operadores#

Las propiedades se leen con punto o con corchetes, y se pueden encadenar.

const author = GetAuthor()

ReplyMessage({
    message: "Hola, " + author.displayName + ". Tu ID es " + author.id,
})

Operadores

Condiciones#

Los paréntesis y las llaves son obligatorios.

const author = GetAuthor()
const role = Role("371826690424569866")

if (author.bot) {
    ReplyMessage({
        message: "Los bots no pueden usar este comando",
    })
} else if (HasRole(author, role)) {
    ReplyMessage({
        message: "Ya tenés el rol",
    })
} else {
    AddRole(author, role)
}

Miembros y menciones#

Quién escribió y a quién mencionó

GetAuthor() devuelve a quien escribió el comando. GetMentionedMember() devuelve al primer miembro mencionado y GetMentionedMembers(), a todos. Las tres siempre devuelven un valor, así que se usan directamente.

AddRole(GetMentionedMember(), Role("371826690424569866"))
ReplyMessage({
    message: "Rol entregado",
})

Buscar a un miembro por su ID

GetMember("id") puede devolver null si la persona no está en el servidor. Antes de usar el resultado hay que descartarlo; dentro del if, el editor ya sabe que existe.

const member = GetMember("123456789012345678")

if (member === null) {
    ReplyMessage({
        message: "No se encontró el miembro",
    })
} else {
    AddRole(member, Role("371826690424569866"))
}

const member = GetMember("123456789012345678")
AddRole(member, Role("371826690424569866"))

Recorrer listas#

El único bucle es for...of: recorre una lista. continue pasa al siguiente elemento y break termina el recorrido.

for (const member of GetMentionedMembers()) {
    if (member.bot) {
        continue
    }

    AddRole(member, Role("371826690424569866"))
}

let found = false

for (const member of GetMembers()) {
    if (member.id === "123456789012345678") {
        found = true
        break
    }
}

if (found) {
    ReplyMessage({
        message: "Miembro encontrado",
    })
}

IDs de Discord#

Los IDs de canales, roles y usuarios se escriben como texto, entre comillas, y tienen entre 17 y 20 dígitos. Para copiar un ID en Discord, activá el modo desarrollador y usá «Copiar ID».

SendMessage({
    channel: Channel("123456789012345678"),
    message: "Anuncio",
})

Channel(123456789012345678)

Funciones#

Estas son todas las funciones disponibles. Los nombres se escriben exactamente así.

Channel(channelId: String): ChannelReference

Channel("123456789012345678")

Role(roleId: String): RoleReference

Role("371826690424569866")

GetMember(userId: String): Member | Null

const member = GetMember("123456789012345678")

const member = GetMember("123456789012345678")
if (member !== null) {
    ReplyMessage({ message: member.displayName })
}

GetMembers(): Array<Member>

const members = GetMembers()

GetAuthor(): Member

const author = GetAuthor()

AddRole(GetAuthor(), Role("371826690424569866"))

GetMentionedMember(): Member

const target = GetMentionedMember()

AddRole(GetMentionedMember(), Role("371826690424569866"))

GetMentionedMembers(): Array<Member>

const members = GetMentionedMembers()

for (const member of GetMentionedMembers()) {
    AddRole(member, Role("371826690424569866"))
}

HasRole(member: Member, role: RoleReference): Boolean

HasRole(member, Role("371826690424569866"))

AddRole(member: Member, role: RoleReference): Void

AddRole(member, Role("371826690424569866"))

SendMessage(config: SendMessageConfig): Void

SendMessage({ message: "Hola" })

SendMessage({ channel: Channel("123456789012345678"), message: "Hola" })

ReplyMessage(config: ReplyMessageConfig): Void

ReplyMessage({ message: "Rol agregado" })

SendEmbed(config: SendEmbedConfig): Void

SendEmbed({ description: "Información" })

SendEmbed({ image: "https://example.com/banner.png" })

SendEmbed({ channel: Channel("123456789012345678"), message: "Aviso", title: "Novedad", image: "https://example.com/banner.png" })

ReplyEmbed(config: ReplyEmbedConfig): Void

ReplyEmbed({ description: "Contenido de la respuesta" })

ReplyEmbed({ image: "https://example.com/banner.png" })

Tipos y configuraciones#

Valores del servidor

Los devuelven las funciones y son de solo lectura: se pueden leer, pero no modificar.

Configuraciones de mensajes y tarjetas

Son los objetos que reciben SendMessage, SendEmbed y las demás acciones. Solo admiten las propiedades de la tabla. Los colores usan el formato #RRGGBB y los enlaces tienen que empezar con http:// o https://.

Recetas#

Mensaje en otro canal

SendMessage({
    channel: Channel("123456789012345678"),
    message: "El evento comienza en diez minutos",
})

Tarjeta con texto e imagen

SendEmbed({
    title: "Actualización",
    description: "Se publicó una nueva versión",
    color: "#5865F2",
    image: "https://example.com/release.png",
    footer: {
        text: "Servidor oficial",
    },
})

Dar un rol a quien escribe, si todavía no lo tiene

const author = GetAuthor()
const role = Role("371826690424569866")

if (HasRole(author, role)) {
    ReplyMessage({
        message: "Ya tenés el rol",
    })
} else {
    AddRole(author, role)
    ReplyMessage({
        message: "Rol agregado",
    })
}

Mencionar a alguien en el mensaje

Discord muestra como mención cualquier texto con la forma <@ID>. Se arma uniendo el ID con +. Funciona en el mensaje y en la descripción de una tarjeta. En el modo simple es lo mismo que escribir {autor} o {mencionado}.

AddRole(GetMentionedMember(), Role("371826690424569866"))
ReplyMessage({
    message: "<@" + GetAuthor().id + "> le dio el rol a <@" + GetMentionedMember().id + ">",
})

Solo un rol puede usar el comando

La autorización se comprueba sobre quien escribe (GetAuthor()), nunca sobre la persona mencionada.

if (HasRole(GetAuthor(), Role("111111111111111111"))) {
    AddRole(GetMentionedMember(), Role("371826690424569866"))
} else {
    ReplyMessage({
        message: "No tenés permiso para usar este comando",
    })
}

Errores frecuentes#

El editor marca estos errores mientras escribís. Debajo de cada ejemplo está el mensaje exacto que vas a ver.

Claves entre comillas

SendMessage({
    "message": "Hola",
})

Tarjeta sin contenido propio

message y channel no cuentan como contenido de la tarjeta.

SendEmbed({
    message: "Solo texto externo",
})

Propiedad que no existe

SendEmbed({
    title: "Hola",
    thumbnail: "https://example.com/icon.png",
})

Función escrita con otro nombre

sendMessage({
    message: "Hola",
})

Igualdad con == o template strings

const same = 1 == 1

const greeting = `Hola ${name}`

Formato#

El botón Formatear del editor (o Shift+Alt+F) ordena el código con estas reglas, sin cambiar lo que hace ni borrar comentarios:

• Indentación de 4 espacios.
• Strings con comillas dobles.
• Sin punto y coma.
• Una instrucción por línea.
• Espacios alrededor de los operadores y después de cada coma.
• Objetos con propiedades en varias líneas, una propiedad por línea, con coma final.
• Llave de apertura en la misma línea; else junto a la llave de cierre.
• Hasta 2 líneas en blanco seguidas.