Karandra/DragonBot

DragonBot :: A Lua powered Discord Bot

This is still an early prototype, so everything is subject to change

DragonBot is a Discord bot written in Lua and utilizes Luvit and the Discordia library.

The main functionality of the bot will come from an assortment of plugins included with the bot.

Currently all commands are processed within process.lua within the netlib and are handed of from there. The only functionality right now is to output Factoids, which is contained within the factoids.lua file within the netlib.

Setup

Windows

To run the bot under Windows, execute the Install.bat script. After running the script, go to SQLite.org Downloads and get the corresponding pre-compiled Windows Binaries for your system. From the archive copy the sqlite3.dll into the project directory. That's it. The setup script looks like this:

@echo off
REM Installer for DragonBot

REM Install Luvit
PowerShell -NoProfile -ExecutionPolicy unrestricted -Command "iex ((new-object net.webclient).DownloadString('https://github.com/luvit/lit/raw/master/get-lit.ps1'))"

REM Generate default config
xcopy ".\config.lua.default" ".\config.lua"
xcopy ".\blacklist.lua.default" ".\blacklist.lua"
xcopy ".\userlist.lua.default" ".\userlist.lua"

Linux

The Setup script should get everything running. If you want to do it manually, you need to grab Luvit and install it yourself as well as copy the correct files around. What should be copied can be found within the Setup script (location of libsqlite3.so can change based on the distro you use). The setup script looks like this:

#!/bin/bash
# Installer for DragonBot

# Install Luvit
curl -L https://github.com/luvit/lit/raw/master/get-lit.sh | sh
cp lit /usr/local/bin/lit
cp luvi /usr/local/bin/luvi
cp luvit /usr/local/bin/luvit

# Copy libsqlite3.so to the project directory
cp /usr/lib/libsqlite3.so.0 libsqlite3.so>/dev/null || :
cp /usr/lib/x86_64-linux-gnu/libsqlite3.so.0 libsqlite3.so>/dev/null || :
# See if the file is actually there 
cp libsqlite3.so libsqlite3.so

# Generate the default config
cp config.lua.default config.lua
cp blacklist.lua.default blacklist.lua
cp userlist.lua.default userlist.lua

Configuration

Configuring the bot is simple, it currently features two files that are supposed to be edited:

config.lua

-- This file stores the config for the bot, mainly the token and the trigger (more to come)
-- Just copy and paste your token into the field and you are good to go
local Settings = {token = "", trigger = "!"}

function GetConfig(name)
  return Settings[name]
end

userlist.lua

-- This file lets you set the permissions for users/roles (currently based on ID)
-- Example: Users = {["123456"] = 0, ["234567"] = 1}
Users = {}
return Users

blacklist.lua

-- This file lets you block certain users based on their ID
-- Example: {"123456","234567",...}
BlockedUsers = {}
return BlockedUsers

Dependencies

This bot is built using following projects:

Luvit
Lit-Sqlite3*

*This plugin has been patched to include following fix: stepelu/lua-ljsqlite3/FIX: rowexec()

Thanks to Neffi from the Skyrimmods Discord for helping out with this project and providing valuable feedback.

Karandra / DragonBot