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

Fun

• 8ball — ask the magic 8 ball a question
• coinflip — flip a coin
• dice — roll a die
• rockpaperscissors — play rock paper scissors against the bot
• choose — pick one of the given options
• echo — repeat text through the bot
• reverse — reverse yours or a replied message
• mock — mOcK tExT
• t9encode / t9decode — encode or decode old phone keypad multi-tap digits
• hangman — channel-wide game of hangman with optional category (hg <letter or word> to guess)
• wordle — channel-wide Wordle; guess the 5-letter word in 6 tries (wg <word> to guess)
• trivia — channel-wide trivia question with 30 seconds to answer (tg <A/B/C/D> to guess)
• image — fetch a random image matching your search (aliases: img)

Chill

• cat — post a random cat picture
• hug — send a hug with a random gif

Info

• ping — check bot latency
• uptime — show how long the bot has been running
• info — user and planet info
• version — show the current bot and Valour SDK version
• usercount — show the total Valour user count
• source — link to the bot's source code
• joinsite — link to a site to help bots join a planet
• devcentral — invite link to the Dev Central planet
• swagger — link to the Valour API docs
• minecraft — Unofficial ValourSMP server IPs
• suggest — submit a suggestion for the bot

Moderation

• ban / unban / kick — member moderation
• bans — list all bans in the planet
• setwelcome — configure a welcome channel and message

Data & Privacy

SkyBot stores only the minimum data required for operation. All data is stored in-memory and is lost on restart. SkyBot does not persist any data to disk.

SkyBot does not store:

• Message content
• Direct messages
• Personal user data

Full privacy policy:
https://github.com/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://github.com/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

Fork this repository, then:

git clone https://github.com/YOUR_USERNAME/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 with your bot token:

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

Contributing

Contributions are welcome. By submitting a contribution, you agree that your contributions will be licensed under AGPL-3.0.

1. Fork the repository
2. Create a feature branch
3. Submit a pull request