33 lines
1.8 KiB
Markdown
33 lines
1.8 KiB
Markdown
# Valour Bot Guide
|
|
By SkyJoshua
|
|
|
|
> **This guide is still a work in progress!**
|
|
|
|
This guide walks you through creating a bot on Valour.gg, connecting it with the SDK and getting it to do things on a planet. Basic knowledge in .NET is not required but is highly recommended!
|
|
|
|
## Prerequisites
|
|
- A [Valour](https://app.valour.gg) account
|
|
- [.NET SDK](https://dotnet.microsoft.com/download) installed
|
|
- Basic knowledge of C#
|
|
- The [Valour SDK](https://www.nuget.org/packages/Valour.SDK) (installed as part of the guide)
|
|
|
|
## 1. Create a bot account
|
|
1. Log into [Valour](https://app.valour.gg) with your regular account.
|
|
2. Go to **Developer Settings** (User Settings -> Developer).
|
|
3. Click **Create Bot** and give it a name.
|
|
4. **Copy the token immediately** - it is only shown once. If you lose it, you can regenerate it from the bot's edit page (this invalidates the old one).
|
|
|
|
## 2. Making the bot
|
|
|
|
### Step 1. [Logging in as the bot](Guides/1.Login.md) - Setting up the project and connecting to Valour
|
|
### Step 2. [Joining a planet](Guides/2.JoinPlanet.md) - Adding your bot to a planet
|
|
### Step 3. [Connecting and Sending a Message to a Planet](Guides/3.ConnectingAndSending.md) - Opening a real-time connection and sending your first message
|
|
### Step 4. [Receiving Messages and Commands](Guides/4.MessagesAndCommands.md) - Listening for messages and creating a basic command
|
|
### Step 5. [Command Arguments](Guides/5.CommandArguments.md) - Parsing arguments from commands
|
|
### Step 6. [Member Info](Guides/6.MemberInfo.md) - Fetching info about the message author
|
|
### Step 7. [Permission Checking](Guides/7.PermissionChecking.md) - Restricting commands to members with the right permissions
|
|
|
|
---
|
|
|
|
For more information check out the [Valour GitHub](https://github.com/Valour-Software/Valour) and the [Valour SDK on NuGet](https://www.nuget.org/packages/Valour.SDK).
|