SkyBot

SkyBot is a Valour.gg bot built with .NET 10.

Features

Designed for self-hosting
Open-source under AGPL-3.0
Built with .NET 10
Command system with automatic registration

Command Categories

Fun — games, utilities, and silly stuff (8ball, hangman, wordle, trivia, and more)
Info — bot and platform info commands
Moderation — ban, kick, welcome messages
RP — roleplay GIF commands powered by nekos.best (35+ commands)

Full command list: COMMANDS.md

Data & Privacy

SkyBot stores only the minimum data required for operation. Most data is stored in-memory and is lost on restart. A small amount of server configuration data is persisted to a local SQLite database for the welcome system.

SkyBot does not store:

Message content
Direct messages
Personal user data

Full privacy policy: https://git.skyjoshua.xyz/SkyJoshua/SkyBot/blob/main/PRIVACY.md

License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

See the LICENSE file for details: https://git.skyjoshua.xyz/SkyJoshua/SkyBot/blob/main/LICENSE

Because this project is licensed under AGPL-3.0, if you modify and deploy it publicly (including as a hosted service), you must make your source code available under the same license.

Requirements

.NET 10
A Valour bot token
A Pixabay API key (free) — required for the image command

Installation

git clone https://git.skyjoshua.xyz/SkyJoshua/SkyBot.git
cd SkyBot/SkyBot
dotnet restore

All required NuGet packages will be installed automatically using the provided SkyBot.csproj file.

Configuration

Create a .env file in the root directory of the project:

TOKEN=your-bot-token-here
PIXABAY_API_KEY=your-pixabay-api-key-here

Then open Config.cs and update the following values:

public static readonly long OwnerId = your-owner-id-here;
public static readonly string Prefix = "your-prefix-here";
public static readonly string SourceLink = "your-source-link-here";

Replace your-owner-id-here with your Valour user ID.
Replace your-prefix-here with your desired command prefix (e.g. s/).
Replace your-source-link-here with a link to your fork of the repository.

Never commit your .env file to the repository. Ensure it is listed in your .gitignore.

Running the Bot

dotnet run

2.4 KiB Raw Blame History