You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: Documentation/guides/basic-concepts/installing-native-dependencies.md
+12-8Lines changed: 12 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,11 @@ NetCord relies on several native libraries for high-performance audio processing
5
5
## Native Dependencies Context
6
6
7
7
-**Libdave**: Essential for voice connection interactions.
8
-
-**Libsodium**: Used for encryption. While NetCord defaults to native AES-GCM (which does not require Libsodium), Libsodium is a highly recommended production dependency. It acts as a fallback for the XChaCha20-Poly1305 encryption mode, ensuring your bot remains compatible if Discord switches to this mode for your connection.
8
+
-**Libsodium**: Used for encryption and provides fallback encryption modes. NetCord attempts to use the platform's native AES-GCM encryption for voice connections. However, Libsodium becomes essential in two scenarios:
9
+
-**Server-side limitation**: When connecting to a voice channel, Discord assigns you to a voice server. Depending on the server and region, it may or may not support AES-GCM. All voice servers support XChaCha20-Poly1305, so if AES-GCM is unavailable on the server you're assigned to, Libsodium is required to use XChaCha20-Poly1305 as a fallback.
10
+
-**Hardware limitation**: If your hardware doesn't support AES-GCM (rare but possible on older CPUs), Libsodium is required to provide the XChaCha20-Poly1305 fallback encryption.
11
+
12
+
Without Libsodium, your bot will fail to connect to voice channels if either of these conditions occur.
9
13
-**Opus**: A versatile audio codec required for any classes in NetCord prefixed with `Opus` (e.g., audio encoding/decoding).
10
14
-**Zstd**: Used for efficient payload compression.
11
15
@@ -16,14 +20,14 @@ NetCord distributes these dependencies as per-RID (Runtime Identifier) packages.
Copy file name to clipboardExpand all lines: README.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -32,7 +32,7 @@ You can install NetCord packages via NuGet package manager:
32
32
|**[NetCord.Hosting](https://www.nuget.org/packages/NetCord.Hosting)**| Provides .NET Generic Host extensions for the NetCord package. |
33
33
|**[NetCord.Hosting.Services](https://www.nuget.org/packages/NetCord.Hosting.Services)**| Provides .NET Generic Host extensions for the NetCord.Services package. |
34
34
|**[NetCord.Hosting.AspNetCore](https://www.nuget.org/packages/NetCord.Hosting.AspNetCore)**| Provides ASP.NET Core extensions for seamless handling of HTTP events. |
Copy file name to clipboardExpand all lines: Resources/NuGet/README.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -25,7 +25,7 @@ You can install NetCord packages via NuGet package manager:
25
25
|**[NetCord.Hosting](https://www.nuget.org/packages/NetCord.Hosting)**| Provides .NET Generic Host extensions for the NetCord package. |
26
26
|**[NetCord.Hosting.Services](https://www.nuget.org/packages/NetCord.Hosting.Services)**| Provides .NET Generic Host extensions for the NetCord.Services package. |
27
27
|**[NetCord.Hosting.AspNetCore](https://www.nuget.org/packages/NetCord.Hosting.AspNetCore)**| Provides ASP.NET Core extensions for seamless handling of HTTP events. |
0 commit comments