Valour Bot Planet Joiner

Valour Bot Planet Joiner is a minimal .NET 8 application that authenticates with the Valour.gg API using a bot token and joins a specified planet automatically.

Environment variables are loaded using DotNetEnv, allowing secure configuration via a .env file.

---

Features

• Bot authentication via token
• Planet join via Planet ID
• Optional invite code support
• Graceful error handling
• Async .NET implementation

---

How It Works

1. Loads environment variables from a .env file
2. Reads the TOKEN bot token
3. Initializes ValourClient with https://api.valour.gg
4. Authenticates the bot
5. Attempts to join the specified planet
6. Outputs result to the console

---

Requirements

• .NET 8+
• Valid Valour bot token
• Planet ID

---

Installation

git clone https://github.com/SkyJoshua/JoinPlanet.git
cd JoinPlanet
dotnet restore

---

Configuration

Create a .env file in the project root:

TOKEN=your-valour-bot-token

Then edit the following values in Program.cs:

long planetId = 123456789012345; // Your Planet ID
string inviteCode = "";          // Optional invite code

Do not commit your .env file to version control.

---

Running the Bot

dotnet run

If authentication succeeds, the console will display the bot identity and the planet join result.

---

Error Handling

• Missing TOKEN environment variable
• Authentication failure
• Planet join failure
• Unhandled exceptions

---

License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

See the LICENSE file for details.

If you modify and deploy this project publicly (including as a hosted service), you must make your source code available under the same AGPL-3.0 license.