¡Hola, esta es una mini guía de como conectar un bot a tu servidor de SA-MP!
Índice:
- Crear bot de Discord.
- Descargar plugins, includes.
- Configuración.
3.1 Configuración Bot (Discord Developers)
3.2 Configuración en la Gamemode (Servidor)
- Procesador de comandos.
Crear bot de Discord.
Para crear un bot de Discord, debemos ingresar a la página de Discord Developers (Click aquí), ir al apartado de applications/aplicaciones y crear una nueva aplicación.
Explicación gráfica:
Descargar Plugins/Includes.
En anteriores post míos (Discord connector - Procesador de comandos) dejé los links de cada repositorio de los puglins e includes que se van a utilizar, con una breve reseña de cual es su función, pero de todas formas lo explicaré aquí.
Discord connector Básicamente, la función de este completo es tener el control de un bot desde un servidor de SA-MP.
pawn-discord-cmd Es el procesador de comandos para poder utilizar nuestro bot en Discord.
Lógicamente, cada .dll ó .so debe ir en su carpeta de plugins, y cada archivo .inc debe ir en pawno-includes
Configuración.
1.1 Configuración del Bot.
Para la configuración del bot (Intents) debemos ir de nuevo a la aplicación que se creó anteriormente en Discord Developers, para poder activar dichas opciones.
Luego de eso, tendremos que ir al apartado de Bot y activar las siguientes opciones PRESENCE INTENT, SERVER MEMBERS INTENT, MESSAGE CONTENT INTENT
¡Genial! ¿Ahora como invitamos nuestro bot? ¡Sencillo! Vamos a ir al apartado de OAuth2 luego a URL Generator Seleccionamos la opción de Bot, y como permisos seleccionaremos Administrador y saldrá un link, ese link funcionará para invitar a nuestra aplicación a cualquier servidor.
Genial, la configuración desde el Discord Developers está completa. ¿Qué haremos ahora? Hacer la configuración para nuestro servidor de SA-MP.
Configuración en la Gamemode (Servidor)
La configuración en el servidor es bastante fácil, utilizaremos el Token que obtendremos desde la página de Discord Developers
Bien, primero que haremos es básicamente extraer o generar el token de nuestra aplicación para poder utilizarla en nuestra gamemode. Para eso iremos al apartado de Bot en Discord Developers, miraremos la primera opción (La que está debajo del nombre), en donde podremos regenerar nuestro token, ahí regeneraremos el token que vamos a usar para poder conectar la aplicación.
¡¡ESTE TOKEN NO SE COMPARTE CON ABSOLUTAMENTE NADIE!!
Una vez generado el token, y tenerlo a nuestro alcance abriremos nuestro server.cfg y agregaremos la siguiente línea.
discord_bot_token TOKEN
Con eso ya tenemos directamente la conexión de nuestro aplicación con el servidor. Al ejecutar el samp-server.exe este se encenderá, si se enciende es porqué todo salió correctamente.
Procesador de comandos.
El procesador de comandos (Procesador de comandos) es fácil de utilizar, sin más daré el código.
#include <a_samp>
#include <discord-connector>
#include <discord-cmd>
// Configuracion del procesador de comandos
#define DCMD_PREFIX '!' // El prefijo base es !
#define DCMD_STRICT_CASE // Menciona que es estricto con las mayusculas
#define DCMD_ALLOW_BOTS // No ejecutara comandos que esten escritos por otros bots.
DCMD:test(user, channel, params[]) {
DCC_SendChannelMessage(channel, "¡Funciona correctamente!");
return 1;
}
Esto es un código básico, no tiene mucha ciencia, es fácil, nada del otro mundo. Hay funciones más avanzadas que tal ves explique en otro momento, pero por ahora hasta aquí la guía.
Esta guía se desarrolló por Kyselovak. 10/17/2023
