maddinat0r / samp-discord-connector

SA:MP plugin which controls a Discord bot
MIT License
114 stars 57 forks source link
cpp11 discord-bot sa-mp

Discord connector plugin for San Andreas Multiplayer (SA:MP)

AppVeyor CI Total downloads Latest release
Build status All Releases latest release
Github Releases

This plugin allows you to control a Discord bot from within your PAWN script.

How to install on an open.mp server

  1. Extract the contents of the archive to a directory, copy the file(s) in plugins into COMPONENTS if you do not do this, it will try to load as a SA:MP plugin instead.
  2. Edit your configuration file (config.json) as follows:
      "discord": {
         "bot_token": "MYBOTTOKEN"
      }

    Alternatively you can use the enviromental variable DCC_BOT_TOKEN to set the token instead. DO NOT SHARE YOUR TOKEN WITH ANYONE

How to install on a SA:MP server

  1. Extract the content of the downloaded archive into the root directory of your SA-MP server.
  2. Edit the server configuration (server.cfg) as follows:
    • Windows: plugins discord-connector
    • Linux: plugins discord-connector.so
  3. Add discord_bot_token YOURDISCORDBOTTOKEN to your server.cfg file, or set it in the environment variable DCC_BOT_TOKEN (never share your bot token with anyone!)

I am getting a intent error, how do I fix it?

If you're getting an intent error, you need to go to the discord developer dashboard and select your bot. Then, you need to go to your bot settings and activate your intents.

Build instruction

Note: The plugin has to be a 32-bit library; that means all required libraries have to be compiled in 32-bit and the compiler has to support 32-bit.

Windows

  1. install a C++ compiler of your choice
  2. install CMake
  3. install Conan
  4. clone this repository recursively (git clone --recursive https://...)
  5. create a folder named build and execute CMake in there
  6. build the generated project files with your C++ compiler

Linux

  1. install a C++ compiler of your choice
  2. install CMake
  3. install Conan
  4. clone this repository recursively (git clone --recursive https://...)
  5. create a folder named build and execute CMake in there (mkdir build && cd build && cmake ..)
  6. build the generated project files with your C++ compiler