@@ -18,9 +18,6 @@ The name and description help users find your command among many others, and the | |||||
Message and User commands are only a name, to the user. So try to make the name descriptive. | Message and User commands are only a name, to the user. So try to make the name descriptive. | ||||
They're accessed by right clicking (or long press, on mobile) a user or a message, respectively. | They're accessed by right clicking (or long press, on mobile) a user or a message, respectively. | ||||
> [!IMPORTANT] | |||||
> Context menu commands are currently not supported on mobile. | |||||
All three varieties of application commands have both Global and Guild variants. | All three varieties of application commands have both Global and Guild variants. | ||||
Your global commands are available in every guild that adds your application. | Your global commands are available in every guild that adds your application. | ||||
You can also make commands for a specific guild; they're only available in that guild. | You can also make commands for a specific guild; they're only available in that guild. | ||||
@@ -172,13 +172,14 @@ namespace Discord | |||||
ServerRequiresMonetization = 50097, | ServerRequiresMonetization = 50097, | ||||
ServerRequiresBoosts = 50101, | ServerRequiresBoosts = 50101, | ||||
RequestBodyContainsInvalidJSON = 50109, | RequestBodyContainsInvalidJSON = 50109, | ||||
#endregion | |||||
#region 2FA (60XXX) | |||||
FailedToResizeAssetBelowTheMaximumSize = 50138, | |||||
OwnershipCannotBeTransferredToABotUser = 50132, | OwnershipCannotBeTransferredToABotUser = 50132, | ||||
AssetResizeBelowTheMaximumSize= 50138, | AssetResizeBelowTheMaximumSize= 50138, | ||||
UploadedFileNotFound = 50146, | UploadedFileNotFound = 50146, | ||||
MissingPermissionToSendThisSticker = 50600, | MissingPermissionToSendThisSticker = 50600, | ||||
#endregion | |||||
#region 2FA (60XXX) | |||||
Requires2FA = 60003, | Requires2FA = 60003, | ||||
#endregion | #endregion | ||||
@@ -106,13 +106,17 @@ namespace Discord | |||||
get => _nameLocalizations; | get => _nameLocalizations; | ||||
set | set | ||||
{ | { | ||||
foreach (var (locale, name) in value) | |||||
if (value != null) | |||||
{ | { | ||||
if(!Regex.IsMatch(locale, @"^\w{2}(?:-\w{2})?$")) | |||||
throw new ArgumentException($"Invalid locale: {locale}", nameof(locale)); | |||||
foreach (var (locale, name) in value) | |||||
{ | |||||
if(!Regex.IsMatch(locale, @"^\w{2}(?:-\w{2})?$")) | |||||
throw new ArgumentException($"Invalid locale: {locale}", nameof(locale)); | |||||
EnsureValidOptionName(name); | |||||
EnsureValidOptionName(name); | |||||
} | |||||
} | } | ||||
_nameLocalizations = value; | _nameLocalizations = value; | ||||
} | } | ||||
} | } | ||||
@@ -126,13 +130,17 @@ namespace Discord | |||||
get => _descriptionLocalizations; | get => _descriptionLocalizations; | ||||
set | set | ||||
{ | { | ||||
foreach (var (locale, description) in value) | |||||
if (value != null) | |||||
{ | { | ||||
if(!Regex.IsMatch(locale, @"^\w{2}(?:-\w{2})?$")) | |||||
throw new ArgumentException($"Invalid locale: {locale}", nameof(locale)); | |||||
foreach (var (locale, description) in value) | |||||
{ | |||||
if(!Regex.IsMatch(locale, @"^\w{2}(?:-\w{2})?$")) | |||||
throw new ArgumentException($"Invalid locale: {locale}", nameof(locale)); | |||||
EnsureValidOptionDescription(description); | |||||
EnsureValidOptionDescription(description); | |||||
} | |||||
} | } | ||||
_descriptionLocalizations = value; | _descriptionLocalizations = value; | ||||
} | } | ||||
} | } | ||||
@@ -55,18 +55,21 @@ namespace Discord | |||||
get => _nameLocalizations; | get => _nameLocalizations; | ||||
set | set | ||||
{ | { | ||||
foreach (var (locale, name) in value) | |||||
if (value != null) | |||||
{ | { | ||||
if (!Regex.IsMatch(locale, @"^\w{2}(?:-\w{2})?$")) | |||||
throw new ArgumentException("Key values of the dictionary must be valid language codes."); | |||||
switch (name.Length) | |||||
foreach (var (locale, name) in value) | |||||
{ | { | ||||
case > 100: | |||||
throw new ArgumentOutOfRangeException(nameof(value), | |||||
"Name length must be less than or equal to 100."); | |||||
case 0: | |||||
throw new ArgumentOutOfRangeException(nameof(value), "Name length must at least 1."); | |||||
if (!Regex.IsMatch(locale, @"^\w{2}(?:-\w{2})?$")) | |||||
throw new ArgumentException("Key values of the dictionary must be valid language codes."); | |||||
switch (name.Length) | |||||
{ | |||||
case > 100: | |||||
throw new ArgumentOutOfRangeException(nameof(value), | |||||
"Name length must be less than or equal to 100."); | |||||
case 0: | |||||
throw new ArgumentOutOfRangeException(nameof(value), "Name length must at least 1."); | |||||
} | |||||
} | } | ||||
} | } | ||||
@@ -35,17 +35,21 @@ namespace Discord | |||||
get => _nameLocalizations; | get => _nameLocalizations; | ||||
set | set | ||||
{ | { | ||||
foreach (var (locale, name) in value) | |||||
if (value != null) | |||||
{ | { | ||||
if(!Regex.IsMatch(locale, @"^\w{2}(?:-\w{2})?$")) | |||||
throw new ArgumentException($"Invalid locale: {locale}", nameof(locale)); | |||||
foreach (var (locale, name) in value) | |||||
{ | |||||
if (!Regex.IsMatch(locale, @"^\w{2}(?:-\w{2})?$")) | |||||
throw new ArgumentException($"Invalid locale: {locale}", nameof(locale)); | |||||
Preconditions.AtLeast(name.Length, 1, nameof(name)); | |||||
Preconditions.AtMost(name.Length, SlashCommandBuilder.MaxNameLength, nameof(name)); | |||||
Preconditions.AtLeast(name.Length, 1, nameof(name)); | |||||
Preconditions.AtMost(name.Length, SlashCommandBuilder.MaxNameLength, nameof(name)); | |||||
if (Type == ApplicationCommandType.Slash && !Regex.IsMatch(name, @"^[-_\p{L}\p{N}\p{IsDevanagari}\p{IsThai}]{1,32}$")) | |||||
throw new ArgumentException(@"Name must match the regex ^[-_\p{L}\p{N}\p{IsDevanagari}\p{IsThai}]{1,32}$", nameof(name)); | |||||
if (Type == ApplicationCommandType.Slash && !Regex.IsMatch(name, @"^[-_\p{L}\p{N}\p{IsDevanagari}\p{IsThai}]{1,32}$")) | |||||
throw new ArgumentException(@"Name must match the regex ^[-_\p{L}\p{N}\p{IsDevanagari}\p{IsThai}]{1,32}$", nameof(name)); | |||||
} | |||||
} | } | ||||
_nameLocalizations = value; | _nameLocalizations = value; | ||||
} | } | ||||
} | } | ||||
@@ -58,14 +62,18 @@ namespace Discord | |||||
get => _descriptionLocalizations; | get => _descriptionLocalizations; | ||||
set | set | ||||
{ | { | ||||
foreach (var (locale, description) in value) | |||||
if (value != null) | |||||
{ | { | ||||
if(!Regex.IsMatch(locale, @"^\w{2}(?:-\w{2})?$")) | |||||
throw new ArgumentException($"Invalid locale: {locale}", nameof(locale)); | |||||
foreach (var (locale, description) in value) | |||||
{ | |||||
if (!Regex.IsMatch(locale, @"^\w{2}(?:-\w{2})?$")) | |||||
throw new ArgumentException($"Invalid locale: {locale}", nameof(locale)); | |||||
Preconditions.AtLeast(description.Length, 1, nameof(description)); | |||||
Preconditions.AtMost(description.Length, SlashCommandBuilder.MaxDescriptionLength, nameof(description)); | |||||
Preconditions.AtLeast(description.Length, 1, nameof(description)); | |||||
Preconditions.AtMost(description.Length, SlashCommandBuilder.MaxDescriptionLength, nameof(description)); | |||||
} | |||||
} | } | ||||
_descriptionLocalizations = value; | _descriptionLocalizations = value; | ||||
} | } | ||||
} | } | ||||
@@ -0,0 +1,37 @@ | |||||
using System; | |||||
using Discord; | |||||
using Xunit; | |||||
namespace Discord; | |||||
public class CommandBuilderTests | |||||
{ | |||||
[Fact] | |||||
public void BuildSimpleSlashCommand() | |||||
{ | |||||
var command = new SlashCommandBuilder() | |||||
.WithName("command") | |||||
.WithDescription("description") | |||||
.AddOption( | |||||
"option1", | |||||
ApplicationCommandOptionType.String, | |||||
"option1 description", | |||||
isRequired: true, | |||||
choices: new [] | |||||
{ | |||||
new ApplicationCommandOptionChoiceProperties() | |||||
{ | |||||
Name = "choice1", Value = "1" | |||||
} | |||||
}) | |||||
.AddOptions(new SlashCommandOptionBuilder() | |||||
.WithName("option2") | |||||
.WithDescription("option2 description") | |||||
.WithType(ApplicationCommandOptionType.String) | |||||
.WithRequired(true) | |||||
.AddChannelType(ChannelType.Text) | |||||
.AddChoice("choice1", "1") | |||||
.AddChoice("choice2", "2")); | |||||
command.Build(); | |||||
} | |||||
} |