Welcome to Sally

Sally is a friendly multipurpose discordbot. She provides many game integrations and interesting APIs. It is possible to customize Sally with self made plugins. The plugins need to be written in C#.

Quick Links

Homepage:
https://its-sally.net

Sally Invite Link:
https://invite.its-sally.net

Join the Discord server, if you are looking for support or just wanna hang out!
https://discord.gg/hjPRKyY

Overview

• Commands
• Features
• Self-hosting
  • Windows
  • Linux
  • Max
  • Docker
• Support

Commands

All Commands can be found on the webpage: https://its-sally.net/commands. It will be updated regularly.

Features

Integrations - Games

• Rocket League
• Terraria
• Oldschool Runescape
• Osu! (planned)
• League of Legends (planned)

Integrations - APIs

• Wikipedia
• OpenWeather
• Konachan
• Cleverbot
• more planned

Build-In

• Command suggestion
• YouTube music player
• Mood system
• Level and rankup system
• Livechat replies
• Service subscription

Self-hosting

• Prerequisite:
  • MySQL or (planned sqlite)
  • Dotnet 3.0 or newer

Windows

coming soon!

Linux

1. Install MySql Server
   Guide: How to install a mysql server on Linux 18.04

2. Install .NET Core
   Guide: How to install .NET Core on Linux 18.04

3. Clone this repository

    git clone https://github.com/Chilllli/Sally.NET.git
   

4. Move into repo directory

    cd Sally.NET
   

5. Complie release build

    dotnet build Sally.NET.sln -c Release
   

6. Start the bot for the first time
   Note: The bot will crash because the config file is missing!

    dotnet Sally/bin/Release/netcoreapp3.0/Sally.dll
   

7. Create a file named "configuration.json" under <git repo root>/Sally/bin/Release/netcoreapp3.0/config
   Paste in following structure:

    {
    "token":"",
    "db_user":"",
    "db_database":"",
    "db_password":"",
    "db_host":"",
    "radioControlChannel":"",
    "meId":"",
    "gainedXp":"",
    "xpTimerInMin":"",
    "WeatherPlace":"",
    "WeatherApiKey":"",
    "CleverApi":""
    }
   

   Note: You need to provied your own values for these properties!

8. Run the bot again

    dotnet Sally/bin/Release/netcoreapp3.0/Sally.dll
   

   Now the bot should run just fine. If something not working, you may check your credentials.

   Note: I recommend using tmux, then the bot can run in the background!
   Guide: Getting started with tmux

Mac

coming soon!

Docker

coming soon!

Support

You can directly support Sally and me via Patreon: https://patreon.com/sallydev

Thanks for tuning in! (づ｡◕‿‿◕｡)づ