98 lines
2.4 KiB
Markdown
98 lines
2.4 KiB
Markdown
# 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
|
|
```
|