# 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](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](https://pixabay.com/api/docs/) (free) — required for the `image` command

---

## Installation

```bash
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:
```cs
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
```bash
dotnet run
```