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
imagecommand
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-herewith your Valour user ID. - Replace
your-prefix-herewith your desired command prefix (e.g.s/). - Replace
your-source-link-herewith 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