NetCord.Services 1.0.0-alpha.334

Prefix Reserved
This is a prerelease version of NetCord.Services.
dotnet add package NetCord.Services --version 1.0.0-alpha.334                
NuGet\Install-Package NetCord.Services -Version 1.0.0-alpha.334                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="NetCord.Services" Version="1.0.0-alpha.334" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NetCord.Services --version 1.0.0-alpha.334                
#r "nuget: NetCord.Services, 1.0.0-alpha.334"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install NetCord.Services as a Cake Addin
#addin nuget:?package=NetCord.Services&version=1.0.0-alpha.334&prerelease

// Install NetCord.Services as a Cake Tool
#tool nuget:?package=NetCord.Services&version=1.0.0-alpha.334&prerelease                

NetCord

The modern and fully customizable C# Discord library

Table of Contents

  1. 📦 Installation
  2. 🚀 Showcase
  3. 🎨 Features
  4. 🥅 Goals
  5. 📚 Guides
  6. 📄 Documentation
  7. 🩹 Support
  8. 📜 License

1. 📦 Installation

You can install NetCord packages via NuGet package manager:

Package Description
NetCord Core package with fundamental functionality.
NetCord.Services Facilitates seamless handling of commands and interactions.
NetCord.Hosting Provides .NET Generic Host extensions for the NetCord package.
NetCord.Hosting.Services Provides .NET Generic Host extensions for the NetCord.Services package.
NetCord.Hosting.AspNetCore Provides ASP.NET Core extensions for seamless handling of HTTP interactions.

2. 🚀 Showcase

This snippet showcases a bot with a minimal API-style /square command and includes a module-based /greet command.

Minimal API-style Bot Example

The following example sets up a bot with a minimal API-style approach for the /square command, which calculates the square of a number:

var builder = Host.CreateDefaultBuilder(args)
    .UseDiscordGateway()
    .UseApplicationCommands<ApplicationCommandInteraction, ApplicationCommandContext>();

var host = builder.Build()
    .AddSlashCommand("square", "Square!", (int a) => $"{a}² = {a * a}")
    .UseGatewayEventHandlers();

await host.RunAsync();

Of course, you can also use the bare-bones approach.

Module-based Command Example

Moreover, you can use a module-based approach. Here's an example of a /greet command that greets a specified user:

public class GreetingModule : ApplicationCommandModule<ApplicationCommandContext>
{
    [SlashCommand("greet", "Greet someone!")]
    public string Greet(User user) => $"{Context.User} greets {user}!";
}

3. 🎨 Features

  • Fully Customizable - Easily tailor your Discord bot with NetCord's flexible, extensible API.
  • Easy to Use - Designed to be intuitive and easy to use for C# and .NET developers.
  • Lightweight & High Performance - Optimized for efficient resource use, ideal for scalable bots.
  • Fully Asynchronous - Built for responsive, concurrent operations in your bot.
  • Native AOT Support - Enjoy faster startups and reduced memory usage with AOT compilation.
  • Immutable Caching - Default immutable caching keeps data reliable and consistent.
  • Voice Support - Includes high-quality capabilities for sending and receiving voice.
  • HTTP Interactions - Easily handle interactions over HTTP without a persistent connection.
  • Dependency-Free - Lightweight by design, with no external dependencies required.
  • Stateless REST - Efficiently manage API requests with a stateless design.
  • Complete API Coverage - Comprehensive support for the Discord API and advanced features.
  • Open Source - Free to use and contribute to, licensed under MIT.

4. 🥅 Goals

NetCord's goal is to allow .NET developers to create fully customizable Discord bots without fighting the API wrapper itself. NetCord is designed to be easy to use and fully customizable, while still being lightweight and performant.

5. 📚 Guides

6. 📄 Documentation

7. 🩹 Support

8. 📜 License

This repository is released under the MIT License.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net8.0

NuGet packages (3)

Showing the top 3 NuGet packages that depend on NetCord.Services:

Package Downloads
NetCord.Hosting.Services

The modern and fully customizable C# Discord library.

NetCordAddons.Services

Unofficial netcord addons for better adding services using hosting.

Lavalink4NET.NetCord

High performance Lavalink wrapper for .NET | Add powerful audio playback to your NetCord-based applications with this integration for Lavalink4NET. Suitable for end users developing with NetCord.

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on NetCord.Services:

Repository Stars
angelobreuer/Lavalink4NET
Lavalink4NET is a Lavalink wrapper with node clustering, caching and custom players for .NET with support for Discord.Net, DSharpPlus, Remora, and NetCord.
Version Downloads Last updated
1.0.0-alpha.334 64 12/6/2024
1.0.0-alpha.333 280 11/28/2024
1.0.0-alpha.332 54 11/27/2024
1.0.0-alpha.232 66 11/25/2024
1.0.0-alpha.231 94 11/18/2024
1.0.0-alpha.230 35 11/18/2024
1.0.0-alpha.229 35 11/18/2024
1.0.0-alpha.228 173 11/15/2024
1.0.0-alpha.227 149 10/13/2024
1.0.0-alpha.226 64 10/7/2024
1.0.0-alpha.225 64 10/1/2024
1.0.0-alpha.224 67 9/24/2024
1.0.0-alpha.223 57 9/23/2024
1.0.0-alpha.222 55 9/19/2024
1.0.0-alpha.221 89 9/14/2024
1.0.0-alpha.220 51 9/14/2024
1.0.0-alpha.219 59 9/13/2024
1.0.0-alpha.218 40 9/8/2024
1.0.0-alpha.217 53 9/4/2024
1.0.0-alpha.216 52 9/1/2024
1.0.0-alpha.215 52 8/31/2024
1.0.0-alpha.214 61 8/31/2024
1.0.0-alpha.213 58 8/30/2024
1.0.0-alpha.212 194 8/19/2024
1.0.0-alpha.211 109 8/9/2024
1.0.0-alpha.210 61 8/9/2024
1.0.0-alpha.209 53 8/8/2024
1.0.0-alpha.208 40 8/6/2024
1.0.0-alpha.207 68 7/26/2024
1.0.0-alpha.206 55 7/25/2024
1.0.0-alpha.205 49 7/25/2024
1.0.0-alpha.204 58 7/21/2024
1.0.0-alpha.203 54 7/10/2024
1.0.0-alpha.202 46 7/10/2024
1.0.0-alpha.201 36 7/9/2024
1.0.0-alpha.200 55 6/22/2024
1.0.0-alpha.199 81 6/2/2024
1.0.0-alpha.198 64 5/26/2024
1.0.0-alpha.197 62 5/26/2024
1.0.0-alpha.196 151 5/17/2024
1.0.0-alpha.195 66 5/17/2024
1.0.0-alpha.194 58 5/11/2024
1.0.0-alpha.193 85 5/5/2024
1.0.0-alpha.192 61 4/30/2024
1.0.0-alpha.191 55 4/28/2024
1.0.0-alpha.190 65 4/27/2024
1.0.0-alpha.189 68 4/27/2024
1.0.0-alpha.188 76 4/25/2024
1.0.0-alpha.187 60 4/25/2024
1.0.0-alpha.186 61 4/25/2024
1.0.0-alpha.185 64 4/25/2024
1.0.0-alpha.184 76 4/20/2024
1.0.0-alpha.183 58 4/19/2024
1.0.0-alpha.182 56 4/19/2024
1.0.0-alpha.181 114 4/6/2024
1.0.0-alpha.180 80 3/30/2024
1.0.0-alpha.179 77 3/24/2024
1.0.0-alpha.178 63 3/19/2024
1.0.0-alpha.177 74 3/15/2024
1.0.0-alpha.176 64 3/14/2024
1.0.0-alpha.175 53 3/14/2024
1.0.0-alpha.174 62 3/14/2024
1.0.0-alpha.173 63 3/9/2024
1.0.0-alpha.172 77 3/7/2024
1.0.0-alpha.171 818 2/29/2024
1.0.0-alpha.170 66 2/29/2024
1.0.0-alpha.169 58 2/27/2024
1.0.0-alpha.168 76 2/22/2024
1.0.0-alpha.167 72 2/21/2024
1.0.0-alpha.166 61 2/21/2024
1.0.0-alpha.165 79 2/17/2024
1.0.0-alpha.164 57 2/17/2024
1.0.0-alpha.163 65 2/16/2024
1.0.0-alpha.162 60 2/15/2024
1.0.0-alpha.161 69 2/13/2024
1.0.0-alpha.160 102 2/10/2024
1.0.0-alpha.159 64 2/10/2024
1.0.0-alpha.158 78 2/6/2024
1.0.0-alpha.157 74 2/6/2024
1.0.0-alpha.156 60 2/6/2024
1.0.0-alpha.155 68 2/4/2024
1.0.0-alpha.154 71 2/4/2024
1.0.0-alpha.153 69 2/3/2024
1.0.0-alpha.152 67 2/1/2024
1.0.0-alpha.151 74 1/27/2024
1.0.0-alpha.150 56 1/27/2024
1.0.0-alpha.149 68 1/23/2024
1.0.0-alpha.148 59 1/17/2024
1.0.0-alpha.147 71 1/16/2024
1.0.0-alpha.146 66 1/15/2024
1.0.0-alpha.145 71 1/15/2024
1.0.0-alpha.144 64 1/13/2024
1.0.0-alpha.143 91 1/6/2024
1.0.0-alpha.142 81 1/3/2024
1.0.0-alpha.141 80 1/1/2024
1.0.0-alpha.140 67 1/1/2024
1.0.0-alpha.139 86 12/29/2023
1.0.0-alpha.138 71 12/29/2023
1.0.0-alpha.137 83 12/24/2023
1.0.0-alpha.136 83 12/23/2023
1.0.0-alpha.135 83 12/23/2023
1.0.0-alpha.134 90 12/23/2023
1.0.0-alpha.133 75 12/19/2023
1.0.0-alpha.132 75 12/18/2023
1.0.0-alpha.131 87 12/18/2023
1.0.0-alpha.130 74 12/17/2023
1.0.0-alpha.129 68 12/17/2023
1.0.0-alpha.128 94 12/10/2023
1.0.0-alpha.127 70 12/10/2023
1.0.0-alpha.126 75 12/9/2023
1.0.0-alpha.125 73 12/8/2023
1.0.0-alpha.124 167 11/12/2023
1.0.0-alpha.123 79 11/9/2023
1.0.0-alpha.122 146 10/28/2023
1.0.0-alpha.121 106 10/13/2023
1.0.0-alpha.120 101 10/10/2023
1.0.0-alpha.119 99 10/7/2023
1.0.0-alpha.118 78 10/5/2023
1.0.0-alpha.117 110 8/29/2023
1.0.0-alpha.116 102 8/28/2023
1.0.0-alpha.115 99 8/25/2023
1.0.0-alpha.114 81 8/24/2023
1.0.0-alpha.113 83 8/17/2023
1.0.0-alpha.112 80 8/16/2023
1.0.0-alpha.111 82 8/7/2023
1.0.0-alpha.110 163 7/24/2023
1.0.0-alpha.109 102 7/21/2023
1.0.0-alpha.108 119 6/16/2023
1.0.0-alpha.107 89 6/14/2023
1.0.0-alpha.106 86 6/12/2023
1.0.0-alpha.105 89 6/12/2023
1.0.0-alpha.104 90 6/12/2023
1.0.0-alpha.103 84 5/17/2023
1.0.0-alpha.102 95 5/8/2023
1.0.0-alpha.101 126 4/26/2023
1.0.0-alpha.100 92 4/23/2023
1.0.0-alpha.99 89 4/22/2023
1.0.0-alpha.98 88 4/21/2023
1.0.0-alpha.97 96 4/20/2023
1.0.0-alpha.96 94 4/16/2023
1.0.0-alpha.95 98 4/10/2023
1.0.0-alpha.94 113 4/4/2023
1.0.0-alpha.93 98 4/3/2023
1.0.0-alpha.92 112 3/29/2023
1.0.0-alpha.91 110 3/27/2023
1.0.0-alpha.90 102 3/22/2023
1.0.0-alpha.89 142 3/19/2023
1.0.0-alpha.88 183 3/11/2023
1.0.0-alpha.87 95 3/11/2023
1.0.0-alpha.86 119 3/11/2023
1.0.0-alpha.85 214 3/7/2023
1.0.0-alpha.84 159 3/2/2023
1.0.0-alpha.83 111 2/27/2023
1.0.0-alpha.82 101 2/26/2023
1.0.0-alpha.81 93 2/25/2023
1.0.0-alpha.80 99 2/22/2023
1.0.0-alpha.79 96 2/20/2023
1.0.0-alpha.78 100 2/16/2023
1.0.0-alpha.77 102 2/15/2023
1.0.0-alpha.76 95 2/15/2023
1.0.0-alpha.75 92 2/15/2023
1.0.0-alpha.74 92 2/14/2023
1.0.0-alpha.73 99 2/12/2023
1.0.0-alpha.72 101 2/12/2023
1.0.0-alpha.71 100 2/9/2023
1.0.0-alpha.70 107 2/6/2023
1.0.0-alpha.69 109 1/19/2023
1.0.0-alpha.68 108 1/19/2023
1.0.0-alpha.67 116 1/16/2023
1.0.0-alpha.66 110 1/13/2023
1.0.0-alpha.65 120 1/10/2023
1.0.0-alpha.64 108 1/10/2023
1.0.0-alpha.63 105 1/10/2023
1.0.0-alpha.62 101 1/9/2023
1.0.0-alpha.61 110 1/6/2023
1.0.0-alpha.60 124 12/31/2022
1.0.0-alpha.59 103 12/31/2022
1.0.0-alpha.58 105 12/28/2022
1.0.0-alpha.57 111 12/27/2022
1.0.0-alpha.56 109 12/26/2022
1.0.0-alpha.55 106 12/26/2022
1.0.0-alpha.54 109 12/25/2022
1.0.0-alpha.53 108 12/25/2022
1.0.0-alpha.52 95 12/23/2022
1.0.0-alpha.51 104 12/10/2022
1.0.0-alpha.50 101 12/3/2022
1.0.0-alpha.49 103 11/21/2022
1.0.0-alpha.47 115 11/10/2022
1.0.0-alpha.46 99 11/8/2022
1.0.0-alpha.45 130 11/5/2022
1.0.0-alpha.44 122 11/5/2022
1.0.0-alpha.43 129 11/3/2022
1.0.0-alpha.42 116 11/1/2022
1.0.0-alpha.41 108 10/31/2022
1.0.0-alpha.40 122 10/26/2022
1.0.0-alpha.39 124 10/23/2022
1.0.0-alpha.38 119 10/22/2022
1.0.0-alpha.37 125 10/11/2022
1.0.0-alpha.36 96 10/6/2022
1.0.0-alpha.35 141 9/18/2022
1.0.0-alpha.34 121 9/15/2022
1.0.0-alpha.33 213 8/26/2022
1.0.0-alpha.32 107 8/26/2022
1.0.0-alpha.31 119 8/21/2022
1.0.0-alpha.30 115 8/19/2022
1.0.0-alpha.29 119 8/16/2022
1.0.0-alpha.28 123 8/12/2022
1.0.0-alpha.27 128 8/9/2022
1.0.0-alpha.26 119 8/8/2022
1.0.0-alpha.25 133 7/23/2022
1.0.0-alpha.23 134 7/12/2022
1.0.0-alpha.22 117 7/8/2022
1.0.0-alpha.21 120 7/8/2022
1.0.0-alpha.20 119 7/8/2022
1.0.0-alpha.19 122 6/21/2022
1.0.0-alpha.18 128 6/4/2022
1.0.0-alpha.17 125 6/4/2022
1.0.0-alpha.16 150 4/1/2022
1.0.0-alpha.15 135 3/27/2022
1.0.0-alpha.14 138 3/26/2022
1.0.0-alpha.13 134 3/15/2022
1.0.0-alpha.12 143 3/11/2022
1.0.0-alpha.11 126 3/7/2022
1.0.0-alpha.10 123 2/14/2022
1.0.0-alpha.9 137 2/13/2022
1.0.0-alpha.8 127 2/11/2022
1.0.0-alpha.7 125 2/11/2022
1.0.0-alpha.6 129 2/11/2022
1.0.0-alpha.5 131 2/10/2022
1.0.0-alpha.4 126 2/10/2022
1.0.0-alpha.3 144 2/2/2022
1.0.0-alpha.2 153 2/2/2022
1.0.0-alpha.1 143 2/2/2022