Dimscord

A Discord Bot & REST Library for Nim. Discord API Channel

Why Dimscord?

• It is minimalistic and efficient.
• Nim is a good programming language and I believe that Nim should stand a chance on having an up-to-date, substantial discord library.
• It has a REST-mode only feature, which isn't cache-reliant.
• The other Nim Discord library (discordnim) has bunch of issues, and it's unmaintained.

FAQ:

• What is Nim?
  • Nim is a statically-typed programming language (older than Go and Rust) that compiles to C/C++/JavaScript. It is similar to Python, easier to learn, and it's flexible. You can read it more in the official website for Nim.
• Why use Nim for Discord bots?
  • Since it's easier to learn, it's faster than any other interpreted languages, which is beneficial for the performance of larger discord bots. You can read the Nim FAQ here
• Is there a command handler for Dimscord?
  • Yes, but not in this library.

Getting Started:

1. Install Nim using choosenim or Nim's website

2. Install Dimscord via Nimble using nimble install dimscord or GitHub git clone https://github.com/krisppurg/dimscord

   • You will need at least Nim 1.2.0 to install dimscord

3. Read the Wiki or Examples for referencing. Maybe even rewrite your bot if you want to switch.

4. Start coding! Stay up-to-date with the latest Dimscord release and stuff.

Quick Example:

import dimscord, asyncdispatch, times, options

let discord = newDiscordClient("<your bot token goes here>")

# Handle event for on_ready.
proc onReady(s: Shard, r: Ready) {.event(discord).} =
    echo "Ready as " & $r.user

# Handle event for message_create.
proc messageCreate(s: Shard, m: Message) {.event(discord).} =
    if m.author.bot: return
    if m.content == "!ping": # If message content is "!ping".
        let
            before = epochTime() * 1000
            msg = await discord.api.sendMessage(m.channel_id, "ping?")
            after = epochTime() * 1000
        # Now edit the message.
        # Use 'discard' because editMessage returns a new message.
        discard await discord.api.editMessage(
            m.channel_id,
            msg.id, 
            "Pong! took " & $int(after - before) & "ms | " & $s.latency() & "ms."
        )
    elif m.content == "!embed": # Otherwise if message content is "!embed".
        # Sends a message with embed.
        discard await discord.api.sendMessage(
            m.channel_id,
            embed = some Embed(
                title: some "Hello there!", 
                description: some "This is description",
                color: some 0x7789ec
            )
        )

# Connect to Discord and run the bot.
waitFor discord.startSession()

Please ensure that when you are running your Discord bot you define -d:ssl example: nim c -r -d:ssl main.nim, you can use -d:dimscordDebug, if you want to debug.

If you want to use voice then you can use -d:dimscordVoice (This requires libsodium.dll/so to be accessible)

Contributing

• If you are interested in contributing to Dimscord, I'd recommend reading the CONTRIBUTING.md file.