So hostest du einen C#-Discord-Bot (.NET)

Diese Anleitung ist für Bots, die in C# oder einer anderen .NET-Sprache geschrieben sind, zum Beispiel mit Discord.Net oder DSharpPlus.

Den Typ wählen

1. Öffne deinen Server im Panel, bleib auf der Übersicht und klick auf Servertyp bearbeiten.
2. Wähl .NET Bot. Den Typ zu ändern installiert den Server neu und löscht standardmäßig seine Dateien, mach das also auf einem neuen Server. Lies dazu So wechselst du deinen Bot zwischen Node.js, Python und Java.
3. Unter Einstellungen, Docker-Image kannst du die .NET-Version wählen (8 ist der Standard, 6, 9 und 10 sind verfügbar).

Ein kleines Beispielprojekt

MyBot.csproj

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Discord.Net" Version="3.*" />
  </ItemGroup>
</Project>

Program.cs

using Discord;
using Discord.WebSocket;

var client = new DiscordSocketClient(new DiscordSocketConfig { GatewayIntents = GatewayIntents.Guilds });
client.Log += msg => { Console.WriteLine(msg); return Task.CompletedTask; };

await client.LoginAsync(TokenType.Bot, Environment.GetEnvironmentVariable("DISCORD_TOKEN"));
await client.StartAsync();
await Task.Delay(Timeout.Infinite);

Zwei Wege zum Deployen

Das Projekt hochladen. Lade in Files deine .csproj und die Quelldateien hoch (nicht die Ordner bin und obj). Bei jedem Start baut der Server dein Projekt mit dotnet publish und führt es dann aus. Der erste Build lädt NuGet-Pakete herunter und dauert deshalb eine Minute. Lass Projekt oder dll leer, um die einzige .csproj im Hauptordner zu nutzen, oder gib den Dateinamen ein, wenn es mehrere gibt.

Veröffentlichte Dateien hochladen. Führ dotnet publish -c Release auf deinem Computer aus und lade den Inhalt des Ausgabeordners hoch. Setz Projekt oder dll auf den Namen der .dll, zum Beispiel MyBot.dll. Startet schneller und braucht weniger Arbeitsspeicher.

Nutzt du lieber Git? Lies So deployst und aktualisierst du deinen Discord-Bot von GitHub.

Token und Start

Füge deinen Token bei Discord-Bot-Token ein. Dein Code liest ihn als Umgebungsvariable DISCORD_TOKEN. Öffne Console und starte. Zeigt die Console, dass der Bot verbunden ist, ist er online.

Gut zu wissen

• Das Bauen braucht Arbeitsspeicher. Ein Projekt mit vielen Paketen braucht beim Bauen eventuell einen Tarif mit 1 GB oder mehr, eine veröffentlichte .dll braucht weit weniger. Lies dazu Wie viel RAM braucht ein Discord-Bot.
• Ein Build-Fehler stoppt den Server, mit den Compiler-Meldungen in der Console. Behebe sie und drück auf Starten.
• Stimme TargetFramework auf die gewählte .NET-Version ab (net8.0 für .NET 8).