Go to file

SkyJoshua 7059b5dce5 Merge pull request #7 from SkyJoshua/dev

Dev

2026-03-20 20:50:42 +00:00

SkyBot

Merge pull request #7 from SkyJoshua/dev

2026-03-20 20:50:42 +00:00

.gitignore

Add database.db and Config.cs to .gitignore

2026-03-20 20:46:59 +00:00

LICENSE

Licenses!

2026-02-26 14:31:02 +00:00

PRIVACY.md

bunch of small fixes

2026-03-20 20:43:02 +00:00

README.md

bunch of small fixes

2026-03-20 20:43:02 +00:00

README.md

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)

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

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

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.

Fork the repository
Create a feature branch
Submit a pull request

</html>