All Superinterfaces:: IDetachableEntity, IGuildChannelContainer<GuildChannel>, ISnowflake

All Known Implementing Classes:: DetachedGuildImpl, GuildImpl

public interface Guild extends IGuildChannelContainer<GuildChannel>, ISnowflake, IDetachableEntity

Represents a Discord Guild. This should contain all information provided from Discord about a Guild.

See Also:

Nested Class Summary

Nested Classes

Modifier and Type

Interface

Description

static class

Guild.Ban

Represents a Ban object.

static enum

Guild.BoostTier

The boost tier for this guild.

static enum

Guild.ExplicitContentLevel

The Explicit-Content-Filter Level of a Guild.

static class

Guild.MetaData

Meta-Data for a Guild

static enum

Guild.MFALevel

Represents the Multifactor Authentication level required by the Guild.

static enum

Guild.NotificationLevel

Represents the Notification-level of the Guild.

static enum

Guild.NSFWLevel

Represents the NSFW level for this guild.

static enum

Guild.Timeout

Represents the idle time allowed until a user is moved to the AFK VoiceChannel if one is set (Guild.getAfkChannel()).

static enum

Guild.VerificationLevel

Represents the Verification-Level of the Guild.
Field Summary

Fields

Modifier and Type

Field

Description

static final String

BANNER_URL

Template for getBannerUrl().

static final String

ICON_URL

Template for getIconUrl().

static final String

SPLASH_URL

Template for getSplashUrl().
Method Summary

Modifier and Type

Method

Description

MemberAction

addMember(String accessToken, UserSnowflake user)

Adds the user to this guild as a member.

AuditableRestAction<Void>

addRoleToMember(UserSnowflake user, Role role)

Atomically assigns the provided Role to the specified Member.

default AuditableRestAction<BulkBanResponse>

ban(Collection<? extends UserSnowflake> users, int deletionTimeframe, TimeUnit unit)

Bans up to 200 of the provided users.

AuditableRestAction<BulkBanResponse>

ban(Collection<? extends UserSnowflake> users, Duration deletionTime)

Bans up to 200 of the provided users.

AuditableRestAction<Void>

ban(UserSnowflake user, int deletionTimeframe, TimeUnit unit)

Bans the user specified by the provided UserSnowflake and deletes messages sent by the user based on the deletionTimeframe.

Task<Void>

cancelRequestToSpeak()

Cancels the Request-to-Speak.

AuditableRestAction<AutoModRule>

createAutoModRule(AutoModRuleData data)

Creates a new AutoModRule for this guild.

ChannelAction<Category>

createCategory(String name)

Creates a new Category in this Guild.

default <T extends ICopyableChannel> ChannelAction<T>

createCopyOfChannel(T channel)

Creates a copy of the specified GuildChannel in this Guild.

default RoleAction

createCopyOfRole(Role role)

Creates a new Role in this Guild with the same settings as the given Role.

AuditableRestAction<RichCustomEmoji>

createEmoji(String name, Icon icon, Role... roles)

Creates a new RichCustomEmoji in this Guild.

default ChannelAction<ForumChannel>

createForumChannel(String name)

Creates a new ForumChannel in this Guild.

ChannelAction<ForumChannel>

createForumChannel(String name, Category parent)

Creates a new ForumChannel in this Guild.

default ChannelAction<MediaChannel>

createMediaChannel(String name)

Creates a new MediaChannel in this Guild.

ChannelAction<MediaChannel>

createMediaChannel(String name, Category parent)

Creates a new MediaChannel in this Guild.

default ChannelAction<NewsChannel>

createNewsChannel(String name)

Creates a new NewsChannel in this Guild.

ChannelAction<NewsChannel>

createNewsChannel(String name, Category parent)

Creates a new NewsChannel in this Guild.

RoleAction

createRole()

Creates a new Role in this Guild.

ScheduledEventAction

createScheduledEvent(String name, String location, OffsetDateTime startTime, OffsetDateTime endTime)

Creates a new ScheduledEvent.

ScheduledEventAction

createScheduledEvent(String name, GuildChannel channel, OffsetDateTime startTime)

Creates a new ScheduledEvent.

default ChannelAction<StageChannel>

createStageChannel(String name)

Creates a new StageChannel in this Guild.

ChannelAction<StageChannel>

createStageChannel(String name, Category parent)

Creates a new StageChannel in this Guild.

default AuditableRestAction<GuildSticker>

createSticker(String name, String description, FileUpload file, String tag, String... tags)

Creates a new GuildSticker in this Guild.

AuditableRestAction<GuildSticker>

createSticker(String name, String description, FileUpload file, Collection<String> tags)

Creates a new GuildSticker in this Guild.

RestAction<Template>

createTemplate(String name, String description)

Used to create a new Template for this Guild.

default ChannelAction<TextChannel>

createTextChannel(String name)

Creates a new TextChannel in this Guild.

ChannelAction<TextChannel>

createTextChannel(String name, Category parent)

Creates a new TextChannel in this Guild.

default ChannelAction<VoiceChannel>

createVoiceChannel(String name)

Creates a new VoiceChannel in this Guild.

ChannelAction<VoiceChannel>

createVoiceChannel(String name, Category parent)

Creates a new VoiceChannel in this Guild.

AuditableRestAction<Void>

deafen(UserSnowflake user, boolean deafen)

Sets the Guild Deafened state of the Member based on the provided boolean.

RestAction<Void>

delete()

Used to completely delete a Guild.

RestAction<Void>

delete(String mfaCode)

Used to completely delete a guild.

default AuditableRestAction<Void>

deleteAutoModRuleById(long id)

Deletes the AutoModRule for the provided id.

AuditableRestAction<Void>

deleteAutoModRuleById(String id)

Deletes the AutoModRule for the provided id.

default RestAction<Void>

deleteCommandById(long commandId)

Delete the command for this id.

RestAction<Void>

deleteCommandById(String commandId)

Delete the command for this id.

AuditableRestAction<Void>

deleteSticker(StickerSnowflake id)

Deletes a sticker from the guild.

default CommandEditAction

editCommandById(Command.Type type, long id)

Edit an existing command by id.

CommandEditAction

editCommandById(Command.Type type, String id)

Edit an existing command by id.

GuildStickerManager

editSticker(StickerSnowflake sticker)

Modify a sticker using GuildStickerManager.

default Task<List<Member>>

findMembers(Predicate<? super Member> filter)

Retrieves and collects members of this guild into a list.

default Task<List<Member>>

findMembersWithRoles(Collection<Role> roles)

Retrieves and collects members of this guild into a list.

default Task<List<Member>>

findMembersWithRoles(Role... roles)

Retrieves and collects members of this guild into a list.

VoiceChannel

getAfkChannel()

Provides the VoiceChannel that has been set as the channel which Members will be moved to after they have been inactive in a VoiceChannel for longer than getAfkTimeout().

Guild.Timeout

getAfkTimeout()

The Timeout set for this Guild representing the amount of time that must pass for a Member to have had no activity in a VoiceChannel to be considered AFK.

AudioManager

getAudioManager()

The AudioManager that represents the audio connection for this Guild.

default ImageProxy

getBanner()

Returns an ImageProxy for this guild's banner image.

String

getBannerId()

The guild banner id.

default String

getBannerUrl()

The guild banner url.

int

getBoostCount()

The amount of boosts this server currently has.

@Unmodifiable List<Member>

getBoosters()

Sorted list of Members that boost this guild.

default Role

getBoostRole()

Looks up the role which is the booster role of this guild.

Guild.BoostTier

getBoostTier()

The boost tier for this guild.

default Role

getBotRole()

Looks up the role which is the integration role for the currently connected bot (self-user).

SortedSnowflakeCacheView<Category>

getCategoryCache()

Sorted SnowflakeCacheView of Category.

SortedChannelCacheView<GuildChannel>

getChannelCache()

SortedChannelCacheView of GuildChannel.

default @Unmodifiable List<GuildChannel>

getChannels()

Populated list of channels for this guild.

@Unmodifiable List<GuildChannel>

getChannels(boolean includeHidden)

Populated list of channels for this guild.

TextChannel

getCommunityUpdatesChannel()

Provides the TextChannel that receives community updates.

DefaultGuildChannelUnion

getDefaultChannel()

The default StandardGuildChannel for a Guild.

Guild.NotificationLevel

getDefaultNotificationLevel()

Returns the default message Notification-Level of this Guild.

String

getDescription()

The description for this guild.

default RichCustomEmoji

getEmojiById(long id)

Gets an RichCustomEmoji from this guild that has the same id as the one provided.

default RichCustomEmoji

getEmojiById(String id)

Gets a RichCustomEmoji from this guild that has the same id as the one provided.

SnowflakeCacheView<RichCustomEmoji>

getEmojiCache()

SnowflakeCacheView of all cached Custom Emojis of this Guild.

default @Unmodifiable List<RichCustomEmoji>

getEmojis()

Gets all Custom Emojis belonging to this Guild.

default @Unmodifiable List<RichCustomEmoji>

getEmojisByName(String name, boolean ignoreCase)

Gets a list of all Custom Emojis in this Guild that have the same name as the one provided.

Guild.ExplicitContentLevel

getExplicitContentLevel()

The level of content filtering enabled in this Guild.

@Unmodifiable Set<String>

getFeatures()

The Features of the Guild.

SortedSnowflakeCacheView<ForumChannel>

getForumChannelCache()

SnowflakeCacheView of ForumChannel.

default ImageProxy

getIcon()

Returns an ImageProxy for this guild's icon.

String

getIconId()

The Discord hash-id of the Guild icon image.

default String

getIconUrl()

The URL of the Guild icon image.

JDA

getJDA()

Returns the JDA instance of this Guild

DiscordLocale

getLocale()

The preferred locale for this guild.

GuildManager

getManager()

Returns the GuildManager for this Guild, used to modify all properties and settings of the Guild.

default int

getMaxBitrate()

The maximum bitrate that can be applied to a voice channel in this guild.

default int

getMaxEmojis()

The maximum amount of custom emojis a guild can have based on the guilds boost tier.

default long

getMaxFileSize()

Returns the maximum size for files that can be uploaded to this Guild.

int

getMaxMembers()

The maximum amount of members that can join this guild.

int

getMaxPresences()

The maximum amount of connected members this guild can have at a time.

Member

getMember(UserSnowflake user)

Gets the Guild specific Member object for the provided UserSnowflake.

default Member

getMemberById(long userId)

Gets a Member object via the id of the user.

default Member

getMemberById(String userId)

Gets a Member object via the id of the user.

default Member

getMemberByTag(String tag)

Searches for a Member that has the matching Discord Tag.

default Member

getMemberByTag(String username, String discriminator)

Searches for a Member that has the matching Discord Tag.

MemberCacheView

getMemberCache()

MemberCacheView for all cached Members of this Guild.

int

getMemberCount()

The expected member count for this guild.

default @Unmodifiable List<Member>

getMembers()

A list of all Members in this Guild.

default @Unmodifiable List<Member>

getMembersByEffectiveName(String name, boolean ignoreCase)

Gets a list of all Members who have the same effective name as the one provided.

default @Unmodifiable List<Member>

getMembersByName(String name, boolean ignoreCase)

Gets a list of all Members who have the same name as the one provided.

default @Unmodifiable List<Member>

getMembersByNickname(String nickname, boolean ignoreCase)

Gets a list of all Members who have the same nickname as the one provided.

default @Unmodifiable List<Member>

getMembersWithRoles(Collection<Role> roles)

Gets a list of Members that have all provided Roles.

default @Unmodifiable List<Member>

getMembersWithRoles(Role... roles)

Gets a list of Members that have all Roles provided.

String

getName()

The human readable name of the Guild.

SortedSnowflakeCacheView<NewsChannel>

getNewsChannelCache()

Sorted SnowflakeCacheView of NewsChannel.

Guild.NSFWLevel

getNSFWLevel()

Returns the NSFW Level that this guild is classified with.

Member

getOwner()

The Member object for the owner of this Guild.

default String

getOwnerId()

The ID for the current owner of this guild.

long

getOwnerIdLong()

The ID for the current owner of this guild.

Role

getPublicRole()

The @everyone Role of this Guild.

Guild.MFALevel

getRequiredMFALevel()

Returns the level of multifactor authentication required to execute administrator restricted functions in this guild.

default Role

getRoleByBot(long userId)

Looks up a role which is the integration role for a bot.

default Role

getRoleByBot(String userId)

Looks up a role which is the integration role for a bot.

default Role

getRoleByBot(User user)

Looks up a role which is the integration role for a bot.

default Role

getRoleById(long id)

Gets a Role from this guild that has the same id as the one provided.

default Role

getRoleById(String id)

Gets a Role from this guild that has the same id as the one provided.

SortedSnowflakeCacheView<Role>

getRoleCache()

Sorted SnowflakeCacheView of all cached Roles of this Guild.

default @Unmodifiable List<Role>

getRoles()

Gets all Roles in this Guild.

default @Unmodifiable List<Role>

getRolesByName(String name, boolean ignoreCase)

Gets a list of all Roles in this Guild that have the same name as the one provided.

TextChannel

getRulesChannel()

Provides the TextChannel that lists the rules of the guild.

TextChannel

getSafetyAlertsChannel()

Provides the TextChannel that receives discord safety alerts.

default ScheduledEvent

getScheduledEventById(long id)

Gets a ScheduledEvent from this guild that has the same id as the one provided.

default ScheduledEvent

getScheduledEventById(String id)

Gets a ScheduledEvent from this guild that has the same id as the one provided.

SortedSnowflakeCacheView<ScheduledEvent>

getScheduledEventCache()

Sorted SnowflakeCacheView of all cached ScheduledEvents of this Guild.

default @Unmodifiable List<ScheduledEvent>

getScheduledEvents()

Gets all ScheduledEvents in this guild.

default @Unmodifiable List<ScheduledEvent>

getScheduledEventsByName(String name, boolean ignoreCase)

Gets a list of all ScheduledEvents in this Guild that have the same name as the one provided.

SecurityIncidentActions

getSecurityIncidentActions()

The current guild security incident actions.

SecurityIncidentDetections

getSecurityIncidentDetections()

The current security incident detections.

Member

getSelfMember()

Gets the Member object of the currently logged in account in this guild.

default ImageProxy

getSplash()

Returns an ImageProxy for this guild's splash icon.

String

getSplashId()

The Discord hash-id of the splash image for this Guild.

default String

getSplashUrl()

The URL of the splash image for this Guild.

SortedSnowflakeCacheView<StageChannel>

getStageChannelCache()

Sorted SnowflakeCacheView of StageChannel.

default GuildSticker

getStickerById(long id)

Gets a GuildSticker from this guild that has the same id as the one provided.

default GuildSticker

getStickerById(String id)

Gets a GuildSticker from this guild that has the same id as the one provided.

SnowflakeCacheView<GuildSticker>

getStickerCache()

SnowflakeCacheView of all cached GuildStickers of this Guild.

default @Unmodifiable List<GuildSticker>

getStickers()

Gets all custom GuildStickers belonging to this Guild.

default @Unmodifiable List<GuildSticker>

getStickersByName(String name, boolean ignoreCase)

Gets a list of all GuildStickers in this Guild that have the same name as the one provided.

TextChannel

getSystemChannel()

Provides the TextChannel that has been set as the channel which newly joined Members will be announced in.

SortedSnowflakeCacheView<TextChannel>

getTextChannelCache()

Sorted SnowflakeCacheView of TextChannel.

SortedSnowflakeCacheView<ThreadChannel>

getThreadChannelCache()

SnowflakeCacheView of ThreadChannel.

String

getVanityCode()

The vanity url code for this Guild.

default String

getVanityUrl()

The vanity url for this Guild.

Guild.VerificationLevel

getVerificationLevel()

Returns the verification-Level of this Guild.

SortedSnowflakeCacheView<VoiceChannel>

getVoiceChannelCache()

Sorted SnowflakeCacheView of VoiceChannel.

@Unmodifiable List<GuildVoiceState>

getVoiceStates()

A list containing the cached GuildVoiceState of every Member connected to an audio channel in this guild.

boolean

isBoostProgressBarEnabled()

Returns whether this Guild has its boost progress bar shown.

default boolean

isInvitesDisabled()

Whether the invites for this guild are paused/disabled.

boolean

isLoaded()

Whether this guild has loaded members.

boolean

isMember(UserSnowflake user)

Used to determine if the provided UserSnowflake is a member of this Guild.

AuditableRestAction<Void>

kick(UserSnowflake user)

Kicks a Member from the Guild.

default RestAction<Void>

kickVoiceMember(UserSnowflake user)

Used to kick a member from a AudioChannel.

RestAction<Void>

leave()

Used to leave a Guild.

default Task<List<Member>>

loadMembers()

Retrieves and collects members of this guild into a list.

Task<Void>

loadMembers(Consumer<Member> callback)

Retrieves all members of this guild.

default AutoModRuleManager

modifyAutoModRuleById(long id)

Returns an AutoModRuleManager, which can be used to modify the rule for the provided id.

AutoModRuleManager

modifyAutoModRuleById(String id)

Returns an AutoModRuleManager, which can be used to modify the rule for the provided id.

ChannelOrderAction

modifyCategoryPositions()

Modifies the positional order of Guild.getCategories() using a specific RestAction extension to allow moving Channels up/down or to a specific position.

AuditableRestAction<Void>

modifyMemberRoles(Member member, Collection<Role> roles)

Modifies the complete Role set of the specified Member
The provided roles will replace all current Roles of the specified Member.

AuditableRestAction<Void>

modifyMemberRoles(Member member, Collection<Role> rolesToAdd, Collection<Role> rolesToRemove)

Modifies the Roles of the specified Member by adding and removing a collection of roles.

default AuditableRestAction<Void>

modifyMemberRoles(Member member, Role... roles)

Modifies the complete Role set of the specified Member
The provided roles will replace all current Roles of the specified Member.

AuditableRestAction<Void>

modifyNickname(Member member, String nickname)

Changes the Member's nickname in this guild.

default RoleOrderAction

modifyRolePositions()

Modifies the positional order of Guild.getRoles() using a specific RestAction extension to allow moving Roles up/down or to a specific position.

RoleOrderAction

modifyRolePositions(boolean useAscendingOrder)

Modifies the positional order of Guild.getRoles() using a specific RestAction extension to allow moving Roles up/down or to a specific position.

AuditableRestAction<Void>

modifySecurityIncidents(SecurityIncidentActions incidents)

Update the current guild security incident actions.

ChannelOrderAction

modifyTextChannelPositions()

Modifies the positional order of Guild.getTextChannels() using a specific RestAction extension to allow moving Channels up/down or to a specific position.

CategoryOrderAction

modifyTextChannelPositions(Category category)

Modifies the positional order of Category#getTextChannels() using an extension of ChannelOrderAction specialized for ordering the nested TextChannels of this Category.

ChannelOrderAction

modifyVoiceChannelPositions()

Modifies the positional order of Guild.getVoiceChannels() using a specific RestAction extension to allow moving Channels up/down or to a specific position.

CategoryOrderAction

modifyVoiceChannelPositions(Category category)

Modifies the positional order of Category#getVoiceChannels() using an extension of ChannelOrderAction specialized for ordering the nested VoiceChannels of this Category.

GuildWelcomeScreenManager

modifyWelcomeScreen()

The Manager for this guild's welcome screen, used to modify properties of the welcome screen like if the welcome screen is enabled, the description and welcome channels.

RestAction<Void>

moveVoiceMember(UserSnowflake user, AudioChannel audioChannel)

Used to move a Member from one AudioChannel to another AudioChannel.

AuditableRestAction<Void>

mute(UserSnowflake user, boolean mute)

Sets the Guild Muted state of the Member based on the provided boolean.

AuditableRestAction<Integer>

prune(int days, boolean wait, Role... roles)

This method will prune (kick) all members who were offline for at least days days.

default AuditableRestAction<Integer>

prune(int days, Role... roles)

This method will prune (kick) all members who were offline for at least days days.

void

pruneMemberCache()

Re-apply the MemberCachePolicy of this session to all Members of this Guild.

AuditableRestAction<Void>

removeRoleFromMember(UserSnowflake user, Role role)

Atomically removes the provided Role from the specified Member.

AuditableRestAction<Void>

removeTimeout(UserSnowflake user)

Removes a time out from the specified Member in this Guild.

Task<Void>

requestToSpeak()

Once the currently logged in account is connected to a StageChannel, this will trigger a Request-to-Speak (aka raise your hand).

RestAction<@Unmodifiable List<ThreadChannel>>

retrieveActiveThreads()

Retrieves the active threads in this guild.

AuditLogPaginationAction

retrieveAuditLogs()

A PaginationAction implementation that allows to iterate over all AuditLogEntries of this Guild.

default RestAction<AutoModRule>

retrieveAutoModRuleById(long id)

Retrieves the AutoModRule for the provided id.

RestAction<AutoModRule>

retrieveAutoModRuleById(String id)

Retrieves the AutoModRule for the provided id.

RestAction<@Unmodifiable List<AutoModRule>>

retrieveAutoModRules()

Retrieves all current AutoModRules for this guild.

RestAction<Guild.Ban>

retrieveBan(UserSnowflake user)

Retrieves a Ban of the provided UserSnowflake.

BanPaginationAction

retrieveBanList()

Retrieves an immutable list of the currently banned Users.

default RestAction<Command>

retrieveCommandById(long id)

Retrieves the existing Command instance by id.

RestAction<Command>

retrieveCommandById(String id)

Retrieves the existing Command instance by id.

RestAction<PrivilegeConfig>

retrieveCommandPrivileges()

Retrieves the IntegrationPrivileges for the commands in this guild.

default RestAction<List<Command>>

retrieveCommands()

Retrieves the list of guild commands.

RestAction<List<Command>>

retrieveCommands(boolean withLocalizations)

Retrieves the list of guild commands.

default RestAction<RichCustomEmoji>

retrieveEmoji(CustomEmoji emoji)

Retrieves a custom emoji together with its respective creator.

default RestAction<RichCustomEmoji>

retrieveEmojiById(long id)

Retrieves a Custom Emoji together with its respective creator.

RestAction<RichCustomEmoji>

retrieveEmojiById(String id)

Retrieves a custom emoji together with its respective creator.

RestAction<@Unmodifiable List<RichCustomEmoji>>

retrieveEmojis()

Retrieves an immutable list of Custom Emojis together with their respective creators.

default RestAction<List<IntegrationPrivilege>>

retrieveIntegrationPrivilegesById(long targetId)

Retrieves the IntegrationPrivileges for the target with the specified ID.

RestAction<List<IntegrationPrivilege>>

retrieveIntegrationPrivilegesById(String targetId)

Retrieves the IntegrationPrivileges for the target with the specified ID.

RestAction<@Unmodifiable List<Invite>>

retrieveInvites()

Retrieves all Invites for this guild.

default CacheRestAction<Member>

retrieveMember(UserSnowflake user)

Load the member for the specified UserSnowflake.

CacheRestAction<Member>

retrieveMemberById(long id)

Load the member for the specified user.

default CacheRestAction<Member>

retrieveMemberById(String id)

Load the member for the specified user.

default Task<List<Member>>

retrieveMembers(boolean includePresence, Collection<? extends UserSnowflake> users)

Retrieves a list of members.

default Task<List<Member>>

retrieveMembers(Collection<? extends UserSnowflake> users)

Retrieves a list of members.

Task<List<Member>>

retrieveMembersByIds(boolean includePresence, long... ids)

Retrieves a list of members by their user id.

default Task<List<Member>>

retrieveMembersByIds(boolean includePresence, String... ids)

Retrieves a list of members by their user id.

default Task<List<Member>>

retrieveMembersByIds(boolean includePresence, Collection<Long> ids)

Retrieves a list of members by their user id.

default Task<List<Member>>

retrieveMembersByIds(long... ids)

Retrieves a list of members by their user id.

default Task<List<Member>>

retrieveMembersByIds(String... ids)

Retrieves a list of members by their user id.

default Task<List<Member>>

retrieveMembersByIds(Collection<Long> ids)

Retrieves a list of members by their user id.

Task<List<Member>>

retrieveMembersByPrefix(String prefix, int limit)

Queries a list of members using a radix tree based on the provided name prefix.

default RestAction<GuildVoiceState>

retrieveMemberVoiceState(UserSnowflake user)

Load the member's voice state for the specified UserSnowflake.

CacheRestAction<GuildVoiceState>

retrieveMemberVoiceStateById(long id)

Load the member's voice state for the specified user.

default RestAction<GuildVoiceState>

retrieveMemberVoiceStateById(String id)

Load the member's voice state for the specified user.

RestAction<Guild.MetaData>

retrieveMetaData()

Loads Guild.MetaData for this guild instance.

default CacheRestAction<Member>

retrieveOwner()

Shortcut for guild.retrieveMemberById(guild.getOwnerIdLong()).

RestAction<Integer>

retrievePrunableMemberCount(int days)

The method calculates the amount of Members that would be pruned if prune(int, Role...) was executed.

default RestAction<EnumSet<Region>>

retrieveRegions()

Retrieves the available regions for this Guild
Shortcut for retrieveRegions(true)
This will include deprecated voice regions by default.

RestAction<EnumSet<Region>>

retrieveRegions(boolean includeDeprecated)

Retrieves the available regions for this Guild

default CacheRestAction<ScheduledEvent>

retrieveScheduledEventById(long id)

Retrieves a ScheduledEvent by its ID.

CacheRestAction<ScheduledEvent>

retrieveScheduledEventById(String id)

Retrieves a ScheduledEvent by its ID.

default RestAction<List<ScheduledEvent>>

retrieveScheduledEvents()

Retrieves all ScheduledEvents for this guild.

RestAction<List<ScheduledEvent>>

retrieveScheduledEvents(boolean includeUserCount)

Retrieves all ScheduledEvents for this guild.

RestAction<GuildSticker>

retrieveSticker(StickerSnowflake sticker)

Attempts to retrieve a GuildSticker object for this guild based on the provided snowflake reference.

RestAction<@Unmodifiable List<GuildSticker>>

retrieveStickers()

Retrieves all the stickers from this guild.

RestAction<@Unmodifiable List<Template>>

retrieveTemplates()

Retrieves all Templates for this guild.

RestAction<VanityInvite>

retrieveVanityInvite()

Retrieves the Vanity Invite meta data for this guild.

RestAction<@Unmodifiable List<Webhook>>

retrieveWebhooks()

Retrieves all Webhooks for this Guild.

RestAction<GuildWelcomeScreen>

retrieveWelcomeScreen()

Retrieves the welcome screen for this Guild.

default AuditableRestAction<Void>

timeoutFor(UserSnowflake user, long amount, TimeUnit unit)

Puts the specified Member in time out in this Guild for a specific amount of time.

default AuditableRestAction<Void>

timeoutFor(UserSnowflake user, Duration duration)

Puts the specified Member in time out in this Guild for a specific amount of time.

AuditableRestAction<Void>

timeoutUntil(UserSnowflake user, TemporalAccessor temporal)

Puts the specified Member in time out in this Guild until the specified date.

AuditableRestAction<Void>

transferOwnership(Member newOwner)

Transfers the Guild ownership to the specified Member
Only available if the currently logged in account is the owner of this Guild

AuditableRestAction<Void>

unban(UserSnowflake user)

Unbans the specified UserSnowflake from this Guild.

boolean

unloadMember(long userId)

Attempts to remove the user with the provided id from the member cache.

CommandListUpdateAction

updateCommands()

Configures the complete list of guild commands.

default CommandCreateAction

upsertCommand(String name, String description)

Creates or updates a slash command.

RestAction<Command>

upsertCommand(CommandData command)

Creates or updates a command.

Methods inherited from interface net.dv8tion.jda.api.entities.detached.IDetachableEntity
isDetached

Methods inherited from interface net.dv8tion.jda.api.entities.channel.attribute.IGuildChannelContainer
getCategories, getCategoriesByName, getCategoryById, getCategoryById, getChannelById, getChannelById, getForumChannelById, getForumChannelById, getForumChannels, getForumChannelsByName, getGuildChannelById, getGuildChannelById, getGuildChannelById, getGuildChannelById, getMediaChannelById, getMediaChannelById, getMediaChannelCache, getMediaChannels, getMediaChannelsByName, getNewsChannelById, getNewsChannelById, getNewsChannels, getNewsChannelsByName, getStageChannelById, getStageChannelById, getStageChannels, getStageChannelsByName, getTextChannelById, getTextChannelById, getTextChannels, getTextChannelsByName, getThreadChannelById, getThreadChannelById, getThreadChannels, getThreadChannelsByName, getVoiceChannelById, getVoiceChannelById, getVoiceChannels, getVoiceChannelsByName

Methods inherited from interface net.dv8tion.jda.api.entities.ISnowflake
getId, getIdLong, getTimeCreated

Field Details
- ICON_URL
  
  static final String ICON_URL
  
  Template for getIconUrl().
  See Also:
  
  Constant Field Values
- SPLASH_URL
  
  static final String SPLASH_URL
  
  Template for getSplashUrl().
  See Also:
  
  Constant Field Values
- BANNER_URL
  
  static final String BANNER_URL
  
  Template for getBannerUrl().
  See Also:
  
  Constant Field Values
Method Details
- retrieveCommands
  
  @Nonnull @CheckReturnValue default RestAction<List<Command>> retrieveCommands()
  
  Retrieves the list of guild commands.
  This list does not include global commands! Use JDA.retrieveCommands() for global commands.
  This list does not include localization data. Use retrieveCommands(boolean) to get localization data
  
  Returns:
  
  RestAction - Type: List of Command
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- retrieveCommands
  
  @Nonnull @CheckReturnValue RestAction<List<Command>> retrieveCommands(boolean withLocalizations)
  
  Retrieves the list of guild commands.
  This list does not include global commands! Use JDA.retrieveCommands() for global commands.
  
  Parameters:
  
  withLocalizations - true if the localization data (such as name and description) should be included
  
  Returns:
  
  RestAction - Type: List of Command
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- retrieveCommandById
  
  @Nonnull @CheckReturnValue RestAction<Command> retrieveCommandById(@Nonnull String id)
  
  Retrieves the existing Command instance by id.
  If there is no command with the provided ID, this RestAction fails with ErrorResponse.UNKNOWN_COMMAND
  
  Parameters:
  
  id - The command id
  
  Returns:
  
  RestAction - Type: Command
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  IllegalArgumentException - If the provided id is not a valid snowflake
- retrieveCommandById
  
  @Nonnull @CheckReturnValue default RestAction<Command> retrieveCommandById(long id)
  
  Retrieves the existing Command instance by id.
  If there is no command with the provided ID, this RestAction fails with ErrorResponse.UNKNOWN_COMMAND
  
  Parameters:
  
  id - The command id
  
  Returns:
  
  RestAction - Type: Command
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- upsertCommand
  
  @Nonnull @CheckReturnValue RestAction<Command> upsertCommand(@Nonnull CommandData command)
  
  Creates or updates a command.
  If a command with the same name exists, it will be replaced. This operation is idempotent. Commands will persist between restarts of your bot, you only have to create a command once.
  To specify a complete list of all commands you can use updateCommands() instead.
  You need the OAuth2 scope "applications.commands" in order to add commands to a guild.
  Parameters:
  
  command - The CommandData for the command
  
  Returns:
  
  RestAction - Type: Command
  The RestAction used to create or update the command
  
  Throws:
  
  IllegalArgumentException - If null is provided
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  Commands.slash(...)
  
  Commands.message(...)
  
  Commands.user(...)
- upsertCommand
  
  @Nonnull @CheckReturnValue default CommandCreateAction upsertCommand(@Nonnull String name, @Nonnull String description)
  
  Creates or updates a slash command.
  If a command with the same name exists, it will be replaced. This operation is idempotent. Commands will persist between restarts of your bot, you only have to create a command once.
  To specify a complete list of all commands you can use updateCommands() instead.
  You need the OAuth2 scope "applications.commands" in order to add commands to a guild.
  
  Parameters:
  
  name - The lowercase alphanumeric (with dash) name, 1-32 characters
  
  description - The description for the command, 1-100 characters
  
  Returns:
  
  CommandCreateAction
  
  Throws:
  
  IllegalArgumentException - If null is provided or the name/description do not meet the requirements
  
  DetachedEntityException - If this entity is detached
- updateCommands
  
  @Nonnull @CheckReturnValue CommandListUpdateAction updateCommands()
  Configures the complete list of guild commands.
  This will replace the existing command list for this guild. You should only use this at most once on startup!
  This operation is idempotent. Commands will persist between restarts of your bot, you only have to create a command once.
  You need the OAuth2 scope "applications.commands" in order to add commands to a guild.
  Examples
  Set list to 2 commands:
  guild.updateCommands() .addCommands(Commands.slash("ping", "Gives the current ping")) .addCommands(Commands.slash("ban", "Ban the target user") .addOption(OptionType.USER, "user", "The user to ban", true)) .setDefaultPermissions(DefaultMemberPermissions.enabledFor(Permission.BAN_MEMBERS)) .queue();
  
  Delete all commands:
  guild.updateCommands().queue();
  Returns:
  
  CommandListUpdateAction
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  JDA.updateCommands()
- editCommandById
  
  @Nonnull @CheckReturnValue CommandEditAction editCommandById(@Nonnull Command.Type type, @Nonnull String id)
  
  Edit an existing command by id.
  If there is no command with the provided ID, this RestAction fails with ErrorResponse.UNKNOWN_COMMAND
  
  Parameters:
  
  type - The command type
  
  id - The id of the command to edit
  
  Returns:
  
  CommandEditAction used to edit the command
  
  Throws:
  
  IllegalArgumentException - If the provided id is not a valid snowflake or the type is Command.Type.UNKNOWN
  
  DetachedEntityException - If this entity is detached
- editCommandById
  
  @Nonnull @CheckReturnValue default CommandEditAction editCommandById(@Nonnull Command.Type type, long id)
  
  Edit an existing command by id.
  If there is no command with the provided ID, this RestAction fails with ErrorResponse.UNKNOWN_COMMAND
  
  Parameters:
  
  type - The command type
  
  id - The id of the command to edit
  
  Returns:
  
  CommandEditAction used to edit the command
  
  Throws:
  
  IllegalArgumentException - If the type is Command.Type.UNKNOWN
  
  DetachedEntityException - If this entity is detached
- deleteCommandById
  
  @Nonnull @CheckReturnValue RestAction<Void> deleteCommandById(@Nonnull String commandId)
  
  Delete the command for this id.
  If there is no command with the provided ID, this RestAction fails with ErrorResponse.UNKNOWN_COMMAND
  
  Parameters:
  
  commandId - The id of the command that should be deleted
  
  Returns:
  
  RestAction
  
  Throws:
  
  IllegalArgumentException - If the provided id is not a valid snowflake
  
  DetachedEntityException - If this entity is detached
- deleteCommandById
  
  @Nonnull @CheckReturnValue default RestAction<Void> deleteCommandById(long commandId)
  
  Delete the command for this id.
  If there is no command with the provided ID, this RestAction fails with ErrorResponse.UNKNOWN_COMMAND
  
  Parameters:
  
  commandId - The id of the command that should be deleted
  
  Returns:
  
  RestAction
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- retrieveIntegrationPrivilegesById
  
  @Nonnull @CheckReturnValue RestAction<List<IntegrationPrivilege>> retrieveIntegrationPrivilegesById(@Nonnull String targetId)
  
  Retrieves the IntegrationPrivileges for the target with the specified ID.
  The ID can either be of a Command or Application!
  Moderators of a guild can modify these privileges through the Integrations Menu
  If there is no command or application with the provided ID, this RestAction fails with ErrorResponse.UNKNOWN_COMMAND
  
  Parameters:
  
  targetId - The id of the command (global or guild), or application
  
  Returns:
  
  RestAction - Type: List of IntegrationPrivilege
  
  Throws:
  
  IllegalArgumentException - If the id is not a valid snowflake
  
  DetachedEntityException - If this entity is detached
- retrieveIntegrationPrivilegesById
  
  @Nonnull @CheckReturnValue default RestAction<List<IntegrationPrivilege>> retrieveIntegrationPrivilegesById(long targetId)
  
  Retrieves the IntegrationPrivileges for the target with the specified ID.
  The ID can either be of a Command or Application!
  Moderators of a guild can modify these privileges through the Integrations Menu
  If there is no command or application with the provided ID, this RestAction fails with ErrorResponse.UNKNOWN_COMMAND
  
  Parameters:
  
  targetId - The id of the command (global or guild), or application
  
  Returns:
  
  RestAction - Type: List of IntegrationPrivilege
  
  Throws:
  
  IllegalArgumentException - If the id is not a valid snowflake
  
  DetachedEntityException - If this entity is detached
- retrieveCommandPrivileges
  
  @Nonnull @CheckReturnValue RestAction<PrivilegeConfig> retrieveCommandPrivileges()
  
  Retrieves the IntegrationPrivileges for the commands in this guild.
  The RestAction provides a PrivilegeConfig providing the privileges of this application and its commands.
  Moderators of a guild can modify these privileges through the Integrations Menu
  
  Returns:
  
  RestAction - Type: PrivilegeConfig
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- retrieveRegions
  
  @Nonnull @CheckReturnValue default RestAction<EnumSet<Region>> retrieveRegions()
  
  Retrieves the available regions for this Guild
  Shortcut for retrieveRegions(true)
  This will include deprecated voice regions by default.
  
  Returns:
  
  RestAction - Type EnumSet
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- retrieveRegions
  
  @Nonnull @CheckReturnValue RestAction<EnumSet<Region>> retrieveRegions(boolean includeDeprecated)
  
  Retrieves the available regions for this Guild
  
  Parameters:
  
  includeDeprecated - Whether to include deprecated regions
  
  Returns:
  
  RestAction - Type EnumSet
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- retrieveAutoModRules
  
  @Nonnull @CheckReturnValue RestAction<@Unmodifiable List<AutoModRule>> retrieveAutoModRules()
  
  Retrieves all current AutoModRules for this guild.
  
  Returns:
  
  RestAction - Type: List of AutoModRule
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have the MANAGE_SERVER permission
  
  DetachedEntityException - If this entity is detached
- retrieveAutoModRuleById
  
  @Nonnull @CheckReturnValue RestAction<AutoModRule> retrieveAutoModRuleById(@Nonnull String id)
  
  Retrieves the AutoModRule for the provided id.
  
  Parameters:
  
  id - The id of the rule
  
  Returns:
  
  RestAction - Type: AutoModRule
  
  Throws:
  
  IllegalArgumentException - If the provided id is not a valid snowflake
  
  InsufficientPermissionException - If the currently logged in account does not have the MANAGE_SERVER permission
  
  DetachedEntityException - If this entity is detached
- retrieveAutoModRuleById
  
  @Nonnull @CheckReturnValue default RestAction<AutoModRule> retrieveAutoModRuleById(long id)
  
  Retrieves the AutoModRule for the provided id.
  
  Parameters:
  
  id - The id of the rule
  
  Returns:
  
  RestAction - Type: AutoModRule
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have the MANAGE_SERVER permission
  
  DetachedEntityException - If this entity is detached
- createAutoModRule
  
  @Nonnull @CheckReturnValue AuditableRestAction<AutoModRule> createAutoModRule(@Nonnull AutoModRuleData data)
  
  Creates a new AutoModRule for this guild.
  You can only create a certain number of rules for each AutoModTriggerType. The maximum is provided by AutoModTriggerType.getMaxPerGuild().
  Parameters:
  
  data - The data for the new rule
  
  Returns:
  
  AuditableRestAction - Type: AutoModRule
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have the required permissions
  
  IllegalStateException -
  
  If the provided data does not have any AutoModResponse configured
  
  If any of the configured AutoModResponses is not supported by the AutoModTriggerType
  
  DetachedEntityException - If this entity is detached
- modifyAutoModRuleById
  
  @Nonnull @CheckReturnValue AutoModRuleManager modifyAutoModRuleById(@Nonnull String id)
  
  Returns an AutoModRuleManager, which can be used to modify the rule for the provided id.
  The manager allows modifying multiple fields in a single request.
  You modify multiple fields in one request by chaining setters before calling RestAction.queue().
  
  Returns:
  
  The manager instance
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have the MANAGE_SERVER permission.
  
  DetachedEntityException - If this entity is detached
- modifyAutoModRuleById
  
  @Nonnull @CheckReturnValue default AutoModRuleManager modifyAutoModRuleById(long id)
  
  Returns an AutoModRuleManager, which can be used to modify the rule for the provided id.
  The manager allows modifying multiple fields in a single request.
  You modify multiple fields in one request by chaining setters before calling RestAction.queue().
  
  Returns:
  
  The manager instance
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have the MANAGE_SERVER permission.
  
  DetachedEntityException - If this entity is detached
- deleteAutoModRuleById
  
  @Nonnull @CheckReturnValue AuditableRestAction<Void> deleteAutoModRuleById(@Nonnull String id)
  
  Deletes the AutoModRule for the provided id.
  
  Parameters:
  
  id - The id of the rule
  
  Returns:
  
  AuditableRestAction - Type: Void
  
  Throws:
  
  IllegalArgumentException - If the provided id is not a valid snowflake
  
  InsufficientPermissionException - If the currently logged in account does not have the MANAGE_SERVER permission
  
  DetachedEntityException - If this entity is detached
- deleteAutoModRuleById
  
  @Nonnull @CheckReturnValue default AuditableRestAction<Void> deleteAutoModRuleById(long id)
  
  Deletes the AutoModRule for the provided id.
  
  Parameters:
  
  id - The id of the rule
  
  Returns:
  
  AuditableRestAction - Type: Void
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have the MANAGE_SERVER permission
  
  DetachedEntityException - If this entity is detached
- addMember
  
  @Nonnull @CheckReturnValue MemberAction addMember(@Nonnull String accessToken, @Nonnull UserSnowflake user)
  
  Adds the user to this guild as a member.
  This requires an OAuth2 Access Token with the scope guilds.join.
  Parameters:
  
  accessToken - The access token
  
  user - The UserSnowflake for the member to add. This can be a member or user instance or User.fromId(long).
  
  Returns:
  
  MemberAction
  
  Throws:
  
  IllegalArgumentException - If the access token is blank, empty, or null, or if the provided user reference is null or is already in this guild
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.CREATE_INSTANT_INVITE
  
  DetachedEntityException - If this entity is detached
  
  Since:
  
  3.7.0
  
  See Also:
  
  Discord OAuth2 Documentation
- isLoaded
  
  boolean isLoaded()
  
  Whether this guild has loaded members.
  This will always be false if the GUILD_MEMBERS intent is disabled.
  
  Returns:
  
  True, if members are loaded.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- pruneMemberCache
  
  void pruneMemberCache()
  Re-apply the MemberCachePolicy of this session to all Members of this Guild.
  Example
  
  // Check if the members of this guild have at least 50% bots (bot collection/farm) public void checkBots(Guild guild) { // Keep in mind: This requires the GUILD_MEMBERS intent which is disabled in createDefault and createLight by default guild.retrieveMembers() // Load members CompletableFuture<Void> (async and eager) .thenApply((v) -> guild.getMemberCache()) // Turn into CompletableFuture<MemberCacheView> .thenAccept((members) -> { int total = members.size(); // Casting to double to get a double as result of division, don't need to worry about precision with small counts like this double bots = (double) members.applyStream(stream -> stream.map(Member::getUser) .filter(User::isBot) .count()); // Count bots if (bots / total > 0.5) // Check how many members are bots System.out.println("More than 50% of members in this guild are bots"); }) .thenRun(guild::pruneMemberCache); // Then prune the cache }
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  unloadMember(long)
  
  JDA.unloadUser(long)
- unloadMember
  
  boolean unloadMember(long userId)
  
  Attempts to remove the user with the provided id from the member cache.
  If you attempt to remove the SelfUser this will simply return false.
  This should be used by an implementation of MemberCachePolicy as an upstream request to remove a member. For example a Least-Recently-Used (LRU) cache might use this to drop old members if the cache capacity is reached. Or a timeout cache could use this to remove expired members.
  Parameters:
  
  userId - The target user id
  
  Returns:
  
  True, if the cache was changed
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  pruneMemberCache()
  
  JDA.unloadUser(long)
- getMemberCount
  
  int getMemberCount()
  
  The expected member count for this guild.
  If this guild is not lazy loaded this should be identical to the size returned by getMemberCache().
  When GatewayIntent.GUILD_MEMBERS is disabled, this will not be updated.
  
  Returns:
  
  The expected member count for this guild
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getName
  
  @Nonnull String getName()
  
  The human readable name of the Guild.
  This value can be modified using GuildManager.setName(String).
  
  Returns:
  
  Never-null String containing the Guild's name.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getIconId
  
  @Nullable String getIconId()
  
  The Discord hash-id of the Guild icon image. If no icon has been set, this returns null.
  The Guild icon can be modified using GuildManager.setIcon(Icon).
  
  Returns:
  
  Possibly-null String containing the Guild's icon hash-id.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getIconUrl
  
  @Nullable default String getIconUrl()
  
  The URL of the Guild icon image. If no icon has been set, this returns null.
  The Guild icon can be modified using GuildManager.setIcon(Icon).
  
  Returns:
  
  Possibly-null String containing the Guild's icon URL.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getIcon
  
  @Nullable default ImageProxy getIcon()
  
  Returns an ImageProxy for this guild's icon.
  Returns:
  
  The ImageProxy of this guild's icon
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  getIconUrl()
- getFeatures
  
  @Nonnull @Unmodifiable Set<String> getFeatures()
  
  The Features of the Guild.
  Features can be updated using GuildManager.setFeatures(Collection).
  Returns:
  
  Never-null, unmodifiable Set containing all of the Guild's features.
  
  See Also:
  
  List of Features
- isInvitesDisabled
  
  default boolean isInvitesDisabled()
  
  Whether the invites for this guild are paused/disabled.
  This is equivalent to getFeatures().contains("INVITES_DISABLED").
  
  Returns:
  
  True, if invites are paused/disabled
- getSplashId
  
  @Nullable String getSplashId()
  
  The Discord hash-id of the splash image for this Guild. A Splash image is an image displayed when viewing a Discord Guild Invite on the web or in client just before accepting or declining the invite. If no splash has been set, this returns null.
  Splash images are VIP/Partner Guild only.
  The Guild splash can be modified using GuildManager.setSplash(Icon).
  
  Returns:
  
  Possibly-null String containing the Guild's splash hash-id
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getSplashUrl
  
  @Nullable default String getSplashUrl()
  
  The URL of the splash image for this Guild. A Splash image is an image displayed when viewing a Discord Guild Invite on the web or in client just before accepting or declining the invite. If no splash has been set, this returns null.
  Splash images are VIP/Partner Guild only.
  The Guild splash can be modified using GuildManager.setSplash(Icon).
  
  Returns:
  
  Possibly-null String containing the Guild's splash URL.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getSplash
  
  @Nullable default ImageProxy getSplash()
  
  Returns an ImageProxy for this guild's splash icon.
  Returns:
  
  Possibly-null ImageProxy of this guild's splash icon
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  getSplashUrl()
- getVanityCode
  
  @Nullable String getVanityCode()
  
  The vanity url code for this Guild. The vanity url is the custom invite code of partnered / official / boosted Guilds.
  The returned String will be the code that can be provided to discord.gg/{code} to get the invite link.
  Returns:
  
  The vanity code or null
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  Since:
  
  4.0.0
  
  See Also:
  
  getVanityUrl()
- getVanityUrl
  
  @Nullable default String getVanityUrl()
  
  The vanity url for this Guild. The vanity url is the custom invite code of partnered / official / boosted Guilds.
  The returned String will be the vanity invite link to this guild.
  
  Returns:
  
  The vanity url or null
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  Since:
  
  4.0.0
- retrieveVanityInvite
  
  @Nonnull @CheckReturnValue RestAction<VanityInvite> retrieveVanityInvite()
  Retrieves the Vanity Invite meta data for this guild.
  This allows you to inspect how many times the vanity invite has been used. You can use getVanityUrl() if you only care about the invite.
  This action requires the MANAGE_SERVER permission.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  INVITE_CODE_INVALID
  If this guild does not have a vanity invite
  
  MISSING_PERMISSIONS
  The vanity invite cannot be fetched due to a permission discrepancy
  Returns:
  
  RestAction - Type: VanityInvite
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_SERVER
  
  DetachedEntityException - If this entity is detached
  
  Since:
  
  4.2.1
- getDescription
  
  @Nullable String getDescription()
  
  The description for this guild.
  This is displayed in the server browser below the guild name for verified guilds.
  The description can be modified using GuildManager.setDescription(String).
  
  Returns:
  
  The description
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  Since:
  
  4.0.0
- getLocale
  
  @Nonnull DiscordLocale getLocale()
  
  The preferred locale for this guild.
  If the guild doesn't have the COMMUNITY feature, this returns the default.
  Default: DiscordLocale.ENGLISH_US
  
  Returns:
  
  The preferred DiscordLocale for this guild
  
  Since:
  
  4.2.1
- getBannerId
  
  @Nullable String getBannerId()
  
  The guild banner id.
  This is shown in guilds below the guild name.
  The banner can be modified using GuildManager.setBanner(Icon).
  Returns:
  
  The guild banner id or null
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  Since:
  
  4.0.0
  
  See Also:
  
  getBannerUrl()
- getBannerUrl
  
  @Nullable default String getBannerUrl()
  
  The guild banner url.
  This is shown in guilds below the guild name.
  The banner can be modified using GuildManager.setBanner(Icon).
  
  Returns:
  
  The guild banner url or null
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  Since:
  
  4.0.0
- getBanner
  
  @Nullable default ImageProxy getBanner()
  
  Returns an ImageProxy for this guild's banner image.
  Returns:
  
  Possibly-null ImageProxy of this guild's banner image
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  getBannerUrl()
- getBoostTier
  
  @Nonnull Guild.BoostTier getBoostTier()
  
  The boost tier for this guild.
  Each tier unlocks new perks for a guild that can be seen in the features.
  
  Returns:
  
  The boost tier.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  Since:
  
  4.0.0
- getBoostCount
  
  int getBoostCount()
  
  The amount of boosts this server currently has.
  
  Returns:
  
  The boost count
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  Since:
  
  4.0.0
- getBoosters
  
  @Nonnull @Unmodifiable List<Member> getBoosters()
  
  Sorted list of Members that boost this guild.
  The list is sorted by Member.getTimeBoosted() ascending. This means the first element will be the member who has been boosting for the longest time.
  This will only check cached members!
  See MemberCachePolicy
  
  Returns:
  
  Immutable list of members who boost this guild
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getMaxBitrate
  
  default int getMaxBitrate()
  
  The maximum bitrate that can be applied to a voice channel in this guild.
  This depends on the features of this guild that can be unlocked for partners or through boosting.
  
  Returns:
  
  The maximum bitrate
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  Since:
  
  4.0.0
- getMaxFileSize
  
  default long getMaxFileSize()
  
  Returns the maximum size for files that can be uploaded to this Guild. This returns 8 MiB for Guilds without a Boost Tier or Guilds with Boost Tier 1, 50 MiB for Guilds with Boost Tier 2 and 100 MiB for Guilds with Boost Tier 3.
  
  Returns:
  
  The maximum size for files that can be uploaded to this Guild
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  Since:
  
  4.2.0
- getMaxEmojis
  
  default int getMaxEmojis()
  
  The maximum amount of custom emojis a guild can have based on the guilds boost tier.
  
  Returns:
  
  The maximum amount of custom emojis
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getMaxMembers
  
  int getMaxMembers()
  
  The maximum amount of members that can join this guild.
  Returns:
  
  The maximum amount of members
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  Since:
  
  4.0.0
  
  See Also:
  
  retrieveMetaData()
- getMaxPresences
  
  int getMaxPresences()
  
  The maximum amount of connected members this guild can have at a time.
  This includes members that are invisible but still connected to discord. If too many members are online the guild will become unavailable for others.
  Returns:
  
  The maximum amount of connected members this guild can have
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  Since:
  
  4.0.0
  
  See Also:
  
  retrieveMetaData()
- retrieveMetaData
  
  @Nonnull @CheckReturnValue RestAction<Guild.MetaData> retrieveMetaData()
  
  Loads Guild.MetaData for this guild instance.
  
  Returns:
  
  RestAction - Type: Guild.MetaData
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  Since:
  
  4.2.0
- getAfkChannel
  
  @Nullable VoiceChannel getAfkChannel()
  
  Provides the VoiceChannel that has been set as the channel which Members will be moved to after they have been inactive in a VoiceChannel for longer than getAfkTimeout().
  If no channel has been set as the AFK channel, this returns null.
  This value can be modified using GuildManager.setAfkChannel(VoiceChannel).
  
  Returns:
  
  Possibly-null VoiceChannel that is the AFK Channel.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getSystemChannel
  
  @Nullable TextChannel getSystemChannel()
  
  Provides the TextChannel that has been set as the channel which newly joined Members will be announced in.
  If no channel has been set as the system channel, this returns null.
  This value can be modified using GuildManager.setSystemChannel(TextChannel).
  
  Returns:
  
  Possibly-null TextChannel that is the system Channel.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getRulesChannel
  
  @Nullable TextChannel getRulesChannel()
  
  Provides the TextChannel that lists the rules of the guild.
  If this guild doesn't have the COMMUNITY feature, this returns null.
  Returns:
  
  Possibly-null TextChannel that is the rules channel
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  getFeatures()
- getCommunityUpdatesChannel
  
  @Nullable TextChannel getCommunityUpdatesChannel()
  
  Provides the TextChannel that receives community updates.
  If this guild doesn't have the COMMUNITY feature, this returns null.
  Returns:
  
  Possibly-null TextChannel that is the community updates channel
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  getFeatures()
- getSafetyAlertsChannel
  
  @Nullable TextChannel getSafetyAlertsChannel()
  
  Provides the TextChannel that receives discord safety alerts.
  If this guild doesn't have the COMMUNITY feature, this returns null.
  Returns:
  
  Possibly-null TextChannel that is the saferty alerts channel.
  
  See Also:
  
  getFeatures()
- getOwner
  
  @Nullable Member getOwner()
  
  The Member object for the owner of this Guild.
  This is null when the owner is no longer in this guild or not yet loaded (lazy loading). Sometimes owners of guilds delete their account or get banned by Discord.
  If lazy-loading is used it is recommended to use retrieveOwner() instead.
  Ownership can be transferred using transferOwnership(Member).
  This only works when the member was added to cache. Lazy loading might load this later.
  See MemberCachePolicy
  Returns:
  
  Possibly-null Member object for the Guild owner.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  getOwnerIdLong()
  
  retrieveOwner()
- getOwnerIdLong
  
  long getOwnerIdLong()
  
  The ID for the current owner of this guild.
  This is useful for debugging purposes or as a shortcut.
  Returns:
  
  The ID for the current owner
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  getOwner()
- getOwnerId
  
  @Nonnull default String getOwnerId()
  
  The ID for the current owner of this guild.
  This is useful for debugging purposes or as a shortcut.
  Returns:
  
  The ID for the current owner
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  getOwner()
- getAfkTimeout
  
  @Nonnull Guild.Timeout getAfkTimeout()
  
  The Timeout set for this Guild representing the amount of time that must pass for a Member to have had no activity in a VoiceChannel to be considered AFK. If getAfkChannel() is not null (thus an AFK channel has been set) then Member will be automatically moved to the AFK channel after they have been inactive for longer than the returned Timeout.
  Default is 300 seconds (5 minutes).
  This value can be modified using GuildManager.setAfkTimeout(net.dv8tion.jda.api.entities.Guild.Timeout).
  
  Returns:
  
  The Timeout set for this Guild.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getSecurityIncidentActions
  
  @Nonnull SecurityIncidentActions getSecurityIncidentActions()
  
  The current guild security incident actions.
  Security incident actions are used to temporarily disable features for the purpose of moderation.
  
  Returns:
  
  SecurityIncidentActions the current actions
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getSecurityIncidentDetections
  
  @Nonnull SecurityIncidentDetections getSecurityIncidentDetections()
  
  The current security incident detections.
  Discord may automatically detect spammers or raiders.
  
  Returns:
  
  SecurityIncidentDetections the current detections
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- isMember
  
  boolean isMember(@Nonnull UserSnowflake user)
  
  Used to determine if the provided UserSnowflake is a member of this Guild.
  This will only check cached members! If the cache is not loaded (see isLoaded()), this may return false despite the user being a member. This is false when getMember(UserSnowflake) returns null.
  
  Parameters:
  
  user - The user to check
  
  Returns:
  
  True - if this user is present and cached in this guild
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getSelfMember
  
  @Nonnull Member getSelfMember()
  
  Gets the Member object of the currently logged in account in this guild.
  This is basically JDA.getSelfUser() being provided to getMember(UserSnowflake).
  
  Returns:
  
  The Member object of the currently logged in account.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getNSFWLevel
  
  @Nonnull Guild.NSFWLevel getNSFWLevel()
  
  Returns the NSFW Level that this guild is classified with.
  For a short description of the different values, see NSFWLevel.
  This value can only be modified by Discord after reviewing the Guild.
  
  Returns:
  
  The NSFWLevel of this guild.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getMember
  
  @Nullable Member getMember(@Nonnull UserSnowflake user)
  
  Gets the Guild specific Member object for the provided UserSnowflake.
  If the user is not in this guild or currently uncached, null is returned.
  This will only check cached members!
  Parameters:
  
  user - The UserSnowflake for the member to get. This can be a member or user instance or User.fromId(long).
  
  Returns:
  
  Possibly-null Member for the related User.
  
  Throws:
  
  IllegalArgumentException - If the provided user is null
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  retrieveMember(UserSnowflake)
- getMemberById
  
  @Nullable default Member getMemberById(@Nonnull String userId)
  
  Gets a Member object via the id of the user. The id relates to ISnowflake.getId(), and this method is similar to JDA.getUserById(String)
  This is more efficient that using JDA.getUserById(String) and getMember(UserSnowflake).
  If no Member in this Guild has the userId provided, this returns null.
  This will only check cached members!
  Parameters:
  
  userId - The Discord id of the User for which a Member object is requested.
  
  Returns:
  
  Possibly-null Member with the related userId.
  
  Throws:
  
  NumberFormatException - If the provided id cannot be parsed by Long.parseLong(String)
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  retrieveMemberById(String)
- getMemberById
  
  @Nullable default Member getMemberById(long userId)
  
  Gets a Member object via the id of the user. The id relates to ISnowflake.getIdLong(), and this method is similar to JDA.getUserById(long)
  This is more efficient that using JDA.getUserById(long) and getMember(UserSnowflake).
  If no Member in this Guild has the userId provided, this returns null.
  This will only check cached members!
  See MemberCachePolicy
  Parameters:
  
  userId - The Discord id of the User for which a Member object is requested.
  
  Returns:
  
  Possibly-null Member with the related userId.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  retrieveMemberById(long)
- getMemberByTag
  
  @Nullable default Member getMemberByTag(@Nonnull String tag)
  
  Searches for a Member that has the matching Discord Tag.
  Format has to be in the form Username#Discriminator where the username must be between 2 and 32 characters (inclusive) matching the exact casing and the discriminator must be exactly 4 digits.
  This does not check the nickname of the member but the username.
  This will only check cached members!
  See MemberCachePolicy
  This only checks users that are in this guild. If a user exists with the tag that is not available in the Member-Cache it will not be detected.
  Currently Discord does not offer a way to retrieve a user by their discord tag.
  Parameters:
  
  tag - The Discord Tag in the format Username#Discriminator
  
  Returns:
  
  The Member for the discord tag or null if no member has the provided tag
  
  Throws:
  
  IllegalArgumentException - If the provided tag is null or not in the described format
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  JDA.getUserByTag(String)
- getMemberByTag
  
  @Nullable default Member getMemberByTag(@Nonnull String username, @Nonnull String discriminator)
  
  Searches for a Member that has the matching Discord Tag.
  Format has to be in the form Username#Discriminator where the username must be between 2 and 32 characters (inclusive) matching the exact casing and the discriminator must be exactly 4 digits.
  This does not check the nickname of the member but the username.
  This will only check cached members!
  See MemberCachePolicy
  This only checks users that are in this guild. If a user exists with the tag that is not available in the Member-Cache it will not be detected.
  Currently Discord does not offer a way to retrieve a user by their discord tag.
  Parameters:
  
  username - The name of the user
  
  discriminator - The discriminator of the user
  
  Returns:
  
  The Member for the discord tag or null if no member has the provided tag
  
  Throws:
  
  IllegalArgumentException - If the provided arguments are null or not in the described format
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  getMemberByTag(String)
- getMembers
  
  @Nonnull default @Unmodifiable List<Member> getMembers()
  
  A list of all Members in this Guild.
  The Members are not provided in any particular order.
  This will only check cached members!
  See MemberCachePolicy
  This copies the backing store into a list. This means every call creates a new list with O(n) complexity. It is recommended to store this into a local variable or use getMemberCache() and use its more efficient versions of handling these values.
  Returns:
  
  Immutable list of all cached members in this Guild.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  loadMembers()
- getMembersByName
  
  @Nonnull @Incubating default @Unmodifiable List<Member> getMembersByName(@Nonnull String name, boolean ignoreCase)
  
  Gets a list of all Members who have the same name as the one provided.
  This compares against Member.getUser().getName()
  If there are no Members with the provided name, then this returns an empty list.
  This will only check cached members!
  See MemberCachePolicy
  Parameters:
  
  name - The name used to filter the returned Members.
  
  ignoreCase - Determines if the comparison ignores case when comparing. True - case insensitive.
  
  Returns:
  
  Possibly-empty immutable list of all Members with the same name as the name provided.
  
  Throws:
  
  IllegalArgumentException - If the provided name is null
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  retrieveMembersByPrefix(String, int)
  
  Incubating:
  
  This will be replaced in the future when the rollout of globally unique usernames has been completed.
- getMembersByNickname
  
  @Nonnull default @Unmodifiable List<Member> getMembersByNickname(@Nullable String nickname, boolean ignoreCase)
  
  Gets a list of all Members who have the same nickname as the one provided.
  This compares against Member.getNickname(). If a Member does not have a nickname, the comparison results as false.
  If there are no Members with the provided name, then this returns an empty list.
  This will only check cached members!
  See MemberCachePolicy
  Parameters:
  
  nickname - The nickname used to filter the returned Members.
  
  ignoreCase - Determines if the comparison ignores case when comparing. True - case insensitive.
  
  Returns:
  
  Possibly-empty immutable list of all Members with the same nickname as the nickname provided.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  retrieveMembersByPrefix(String, int)
- getMembersByEffectiveName
  
  @Nonnull default @Unmodifiable List<Member> getMembersByEffectiveName(@Nonnull String name, boolean ignoreCase)
  
  Gets a list of all Members who have the same effective name as the one provided.
  This compares against Member.getEffectiveName().
  If there are no Members with the provided name, then this returns an empty list.
  This will only check cached members!
  See MemberCachePolicy
  Parameters:
  
  name - The name used to filter the returned Members.
  
  ignoreCase - Determines if the comparison ignores case when comparing. True - case insensitive.
  
  Returns:
  
  Possibly-empty immutable list of all Members with the same effective name as the name provided.
  
  Throws:
  
  IllegalArgumentException - If the provided name is null
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  retrieveMembersByPrefix(String, int)
- getMembersWithRoles
  
  @Nonnull default @Unmodifiable List<Member> getMembersWithRoles(@Nonnull Role... roles)
  
  Gets a list of Members that have all Roles provided.
  If there are no Members with all provided roles, then this returns an empty list.
  This will only check cached members!
  See MemberCachePolicy
  Parameters:
  
  roles - The Roles that a Member must have to be included in the returned list.
  
  Returns:
  
  Possibly-empty immutable list of Members with all provided Roles.
  
  Throws:
  
  IllegalArgumentException - If a provided Role is from a different guild or null.
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  findMembersWithRoles(Role...)
- getMembersWithRoles
  
  @Nonnull default @Unmodifiable List<Member> getMembersWithRoles(@Nonnull Collection<Role> roles)
  
  Gets a list of Members that have all provided Roles.
  If there are no Members with all provided roles, then this returns an empty list.
  This will only check cached members!
  See MemberCachePolicy
  Parameters:
  
  roles - The Roles that a Member must have to be included in the returned list.
  
  Returns:
  
  Possibly-empty immutable list of Members with all provided Roles.
  
  Throws:
  
  IllegalArgumentException - If a provided Role is from a different guild or null.
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  findMembersWithRoles(Collection)
- getMemberCache
  
  @Nonnull MemberCacheView getMemberCache()
  
  MemberCacheView for all cached Members of this Guild.
  This will only provide cached members!
  See MemberCachePolicy
  Returns:
  
  MemberCacheView
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  loadMembers()
- getScheduledEventCache
  
  @Nonnull SortedSnowflakeCacheView<ScheduledEvent> getScheduledEventCache()
  
  Sorted SnowflakeCacheView of all cached ScheduledEvents of this Guild.
  Scheduled events are sorted by their start time, and events that start at the same time are sorted by their snowflake ID.
  This requires CacheFlag.SCHEDULED_EVENTS to be enabled.
  
  Returns:
  
  SortedSnowflakeCacheView
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- retrieveScheduledEvents
  
  @Nonnull @CheckReturnValue default RestAction<List<ScheduledEvent>> retrieveScheduledEvents()
  
  Retrieves all ScheduledEvents for this guild.
  This list does not include user count data. Use retrieveScheduledEvents(boolean) to get user count data
  
  Returns:
  
  RestAction - Type: List of ScheduledEvent
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- retrieveScheduledEvents
  
  @Nonnull @CheckReturnValue RestAction<List<ScheduledEvent>> retrieveScheduledEvents(boolean includeUserCount)
  
  Retrieves all ScheduledEvents for this guild.
  
  Parameters:
  
  includeUserCount - Whether to include user counts for the ScheduledEvents.
  
  Returns:
  
  RestAction - Type: List of ScheduledEvent
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getScheduledEventsByName
  
  @Nonnull default @Unmodifiable List<ScheduledEvent> getScheduledEventsByName(@Nonnull String name, boolean ignoreCase)
  
  Gets a list of all ScheduledEvents in this Guild that have the same name as the one provided.
  If there are no ScheduledEvents with the provided name, then this returns an empty list.
  This requires CacheFlag.SCHEDULED_EVENTS to be enabled.
  
  Parameters:
  
  name - The name used to filter the returned ScheduledEvent objects.
  
  ignoreCase - Determines if the comparison ignores case when comparing. True - case insensitive.
  
  Returns:
  
  Possibly-empty immutable list of all ScheduledEvent names that match the provided name.
  
  Throws:
  
  IllegalArgumentException - If the name is blank, empty or null
  
  DetachedEntityException - If this entity is detached
- getScheduledEventById
  
  @Nullable default ScheduledEvent getScheduledEventById(@Nonnull String id)
  
  Gets a ScheduledEvent from this guild that has the same id as the one provided. This method is similar to JDA.getScheduledEventById(String), but it only checks this specific Guild for a scheduled event.
  If there is no ScheduledEvent with an id that matches the provided one, then this returns null.
  This requires CacheFlag.SCHEDULED_EVENTS to be enabled.
  
  Parameters:
  
  id - The id of the ScheduledEvent.
  
  Returns:
  
  Possibly-null ScheduledEvent with matching id.
  
  Throws:
  
  NumberFormatException - If the provided id cannot be parsed by Long.parseLong(String)
  
  DetachedEntityException - If this entity is detached
- getScheduledEventById
  
  @Nullable default ScheduledEvent getScheduledEventById(long id)
  
  Gets a ScheduledEvent from this guild that has the same id as the one provided. This method is similar to JDA.getScheduledEventById(long), but it only checks this specific Guild for a scheduled event.
  If there is no ScheduledEvent with an id that matches the provided one, then this returns null.
  This requires CacheFlag.SCHEDULED_EVENTS to be enabled.
  
  Parameters:
  
  id - The id of the ScheduledEvent.
  
  Returns:
  
  Possibly-null ScheduledEvent with matching id.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getScheduledEvents
  
  @Nonnull default @Unmodifiable List<ScheduledEvent> getScheduledEvents()
  
  Gets all ScheduledEvents in this guild.
  Scheduled events are sorted by their start time, and events that start at the same time are sorted by their snowflake ID.
  This copies the backing store into a list. This means every call creates a new list with O(n) complexity. It is recommended to store this into a local variable or use getScheduledEventCache() and use its more efficient versions of handling these values.
  This requires CacheFlag.SCHEDULED_EVENTS to be enabled.
  
  Returns:
  
  Possibly-empty immutable List of ScheduledEvents.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getStageChannelCache
  
  @Nonnull SortedSnowflakeCacheView<StageChannel> getStageChannelCache()
  
  Description copied from interface: IGuildChannelContainer
  
  Sorted SnowflakeCacheView of StageChannel.
  In Guild cache, channels are sorted according to their position and id.
  This getter exists on any instance of IGuildChannelContainer and only checks the caches with the relevant scoping. For Guild, JDA, or ShardManager, this returns the relevant channel with respect to the cache within each of those objects. For a guild, this would mean it only returns channels within the same guild.
  If this is called on JDA or ShardManager, this may return null immediately after building, because the cache isn't initialized yet. To make sure the cache is initialized after building your JDA instance, you can use JDA.awaitReady().
  
  Specified by:
  
  getStageChannelCache in interface IGuildChannelContainer<GuildChannel>
  
  Returns:
  
  SortedSnowflakeCacheView
- getThreadChannelCache
  
  @Nonnull SortedSnowflakeCacheView<ThreadChannel> getThreadChannelCache()
  
  Description copied from interface: IGuildChannelContainer
  
  SnowflakeCacheView of ThreadChannel.
  These threads can also represent posts in ForumChannels.
  This getter exists on any instance of IGuildChannelContainer and only checks the caches with the relevant scoping. For Guild, JDA, or ShardManager, this returns the relevant channel with respect to the cache within each of those objects. For a guild, this would mean it only returns channels within the same guild.
  If this is called on JDA or ShardManager, this may return null immediately after building, because the cache isn't initialized yet. To make sure the cache is initialized after building your JDA instance, you can use JDA.awaitReady().
  
  Specified by:
  
  getThreadChannelCache in interface IGuildChannelContainer<GuildChannel>
  
  Returns:
  
  SnowflakeCacheView
- getCategoryCache
  
  @Nonnull SortedSnowflakeCacheView<Category> getCategoryCache()
  
  Description copied from interface: IGuildChannelContainer
  
  Sorted SnowflakeCacheView of Category.
  In Guild cache, channels are sorted according to their position and id.
  This getter exists on any instance of IGuildChannelContainer and only checks the caches with the relevant scoping. For Guild, JDA, or ShardManager, this returns the relevant channel with respect to the cache within each of those objects. For a guild, this would mean it only returns channels within the same guild.
  If this is called on JDA or ShardManager, this may return null immediately after building, because the cache isn't initialized yet. To make sure the cache is initialized after building your JDA instance, you can use JDA.awaitReady().
  
  Specified by:
  
  getCategoryCache in interface IGuildChannelContainer<GuildChannel>
  
  Returns:
  
  SortedSnowflakeCacheView
- getTextChannelCache
  
  @Nonnull SortedSnowflakeCacheView<TextChannel> getTextChannelCache()
  
  Description copied from interface: IGuildChannelContainer
  
  Sorted SnowflakeCacheView of TextChannel.
  In Guild cache, channels are sorted according to their position and id.
  This getter exists on any instance of IGuildChannelContainer and only checks the caches with the relevant scoping. For Guild, JDA, or ShardManager, this returns the relevant channel with respect to the cache within each of those objects. For a guild, this would mean it only returns channels within the same guild.
  If this is called on JDA or ShardManager, this may return null immediately after building, because the cache isn't initialized yet. To make sure the cache is initialized after building your JDA instance, you can use JDA.awaitReady().
  
  Specified by:
  
  getTextChannelCache in interface IGuildChannelContainer<GuildChannel>
  
  Returns:
  
  SortedSnowflakeCacheView
- getNewsChannelCache
  
  @Nonnull SortedSnowflakeCacheView<NewsChannel> getNewsChannelCache()
  
  Description copied from interface: IGuildChannelContainer
  
  Sorted SnowflakeCacheView of NewsChannel.
  In Guild cache, channels are sorted according to their position and id.
  This getter exists on any instance of IGuildChannelContainer and only checks the caches with the relevant scoping. For Guild, JDA, or ShardManager, this returns the relevant channel with respect to the cache within each of those objects. For a guild, this would mean it only returns channels within the same guild.
  If this is called on JDA or ShardManager, this may return null immediately after building, because the cache isn't initialized yet. To make sure the cache is initialized after building your JDA instance, you can use JDA.awaitReady().
  
  Specified by:
  
  getNewsChannelCache in interface IGuildChannelContainer<GuildChannel>
  
  Returns:
  
  SortedSnowflakeCacheView
- getVoiceChannelCache
  
  @Nonnull SortedSnowflakeCacheView<VoiceChannel> getVoiceChannelCache()
  
  Description copied from interface: IGuildChannelContainer
  
  Sorted SnowflakeCacheView of VoiceChannel.
  In Guild cache, channels are sorted according to their position and id.
  This getter exists on any instance of IGuildChannelContainer and only checks the caches with the relevant scoping. For Guild, JDA, or ShardManager, this returns the relevant channel with respect to the cache within each of those objects. For a guild, this would mean it only returns channels within the same guild.
  If this is called on JDA or ShardManager, this may return null immediately after building, because the cache isn't initialized yet. To make sure the cache is initialized after building your JDA instance, you can use JDA.awaitReady().
  
  Specified by:
  
  getVoiceChannelCache in interface IGuildChannelContainer<GuildChannel>
  
  Returns:
  
  SortedSnowflakeCacheView
- getForumChannelCache
  
  @Nonnull SortedSnowflakeCacheView<ForumChannel> getForumChannelCache()
  
  Description copied from interface: IGuildChannelContainer
  
  SnowflakeCacheView of ForumChannel.
  This getter exists on any instance of IGuildChannelContainer and only checks the caches with the relevant scoping. For Guild, JDA, or ShardManager, this returns the relevant channel with respect to the cache within each of those objects. For a guild, this would mean it only returns channels within the same guild.
  If this is called on JDA or ShardManager, this may return null immediately after building, because the cache isn't initialized yet. To make sure the cache is initialized after building your JDA instance, you can use JDA.awaitReady().
  
  Specified by:
  
  getForumChannelCache in interface IGuildChannelContainer<GuildChannel>
  
  Returns:
  
  SnowflakeCacheView
- getChannelCache
  
  @Nonnull SortedChannelCacheView<GuildChannel> getChannelCache()
  
  SortedChannelCacheView of GuildChannel.
  Provides cache access to all channels of this guild, including thread channels (unlike getChannels()). The cache view attempts to provide a sorted list, based on how channels are displayed in the client. Various methods like CacheView.forEachUnordered(Consumer) or CacheView.lockedIterator() bypass sorting for optimization reasons.
  It is possible to filter the channels to more specific types using ChannelCacheView.getElementById(ChannelType, long) or SortedChannelCacheView.ofType(Class).
  
  Specified by:
  
  getChannelCache in interface IGuildChannelContainer<GuildChannel>
  
  Returns:
  
  SortedChannelCacheView
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getChannels
  
  @Nonnull default @Unmodifiable List<GuildChannel> getChannels()
  Populated list of channels for this guild.
  This includes all types of channels, except for threads.
  This includes hidden channels by default, you can use getChannels(false) to exclude hidden channels.
  The returned list is ordered in the same fashion as it would be by the official discord client.
  
  TextChannel, ForumChannel, and NewsChannel without parent
  
  VoiceChannel and StageChannel without parent
  
  Categories
  
  TextChannel, ForumChannel, and NewsChannel with category as parent
  
  VoiceChannel and StageChannel with category as parent
  Returns:
  
  Immutable list of channels for this guild
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  getChannels(boolean)
- getChannels
  
  @Nonnull @Unmodifiable List<GuildChannel> getChannels(boolean includeHidden)
  Populated list of channels for this guild.
  This includes all types of channels, except for threads.
  The returned list is ordered in the same fashion as it would be by the official discord client.
  
  TextChannel, ForumChannel, and NewsChannel without parent
  
  VoiceChannel and StageChannel without parent
  
  Categories
  
  TextChannel, ForumChannel, and NewsChannel with category as parent
  
  VoiceChannel and StageChannel with category as parent
  Parameters:
  
  includeHidden - Whether to include channels with denied View Channel Permission
  
  Returns:
  
  Immutable list of channels for this guild
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  getChannels()
- getRoleById
  
  @Nullable default Role getRoleById(@Nonnull String id)
  
  Gets a Role from this guild that has the same id as the one provided.
  If there is no Role with an id that matches the provided one, then this returns null.
  
  Parameters:
  
  id - The id of the Role.
  
  Returns:
  
  Possibly-null Role with matching id.
  
  Throws:
  
  NumberFormatException - If the provided id cannot be parsed by Long.parseLong(String)
  
  DetachedEntityException - If this entity is detached
- getRoleById
  
  @Nullable default Role getRoleById(long id)
  
  Gets a Role from this guild that has the same id as the one provided.
  If there is no Role with an id that matches the provided one, then this returns null.
  
  Parameters:
  
  id - The id of the Role.
  
  Returns:
  
  Possibly-null Role with matching id.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getRoles
  
  @Nonnull default @Unmodifiable List<Role> getRoles()
  
  Gets all Roles in this Guild.
  The roles returned will be sorted according to their position. The highest role being at index 0 and the lowest at the last index.
  This copies the backing store into a list. This means every call creates a new list with O(n) complexity. It is recommended to store this into a local variable or use getRoleCache() and use its more efficient versions of handling these values.
  
  Returns:
  
  An immutable List of Roles.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getRolesByName
  
  @Nonnull default @Unmodifiable List<Role> getRolesByName(@Nonnull String name, boolean ignoreCase)
  
  Gets a list of all Roles in this Guild that have the same name as the one provided.
  If there are no Roles with the provided name, then this returns an empty list.
  
  Parameters:
  
  name - The name used to filter the returned Roles.
  
  ignoreCase - Determines if the comparison ignores case when comparing. True - case insensitive.
  
  Returns:
  
  Possibly-empty immutable list of all Role names that match the provided name.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getRoleByBot
  
  @Nullable default Role getRoleByBot(long userId)
  
  Looks up a role which is the integration role for a bot.
  These roles are created when the bot requested a list of permission in the authorization URL.
  To check whether a role is a bot role you can use role.getTags().isBot() and you can use Role.RoleTags.getBotIdLong() to check which bot it applies to.
  This requires CacheFlag.ROLE_TAGS to be enabled. See JDABuilder.enableCache(...).
  
  Parameters:
  
  userId - The user id of the bot
  
  Returns:
  
  The bot role, or null if no role matches
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getRoleByBot
  
  @Nullable default Role getRoleByBot(@Nonnull String userId)
  
  Looks up a role which is the integration role for a bot.
  These roles are created when the bot requested a list of permission in the authorization URL.
  To check whether a role is a bot role you can use role.getTags().isBot() and you can use Role.RoleTags.getBotIdLong() to check which bot it applies to.
  This requires CacheFlag.ROLE_TAGS to be enabled. See JDABuilder.enableCache(...).
  
  Parameters:
  
  userId - The user id of the bot
  
  Returns:
  
  The bot role, or null if no role matches
  
  Throws:
  
  IllegalArgumentException - If the userId is null or not a valid snowflake
  
  DetachedEntityException - If this entity is detached
- getRoleByBot
  
  @Nullable default Role getRoleByBot(@Nonnull User user)
  
  Looks up a role which is the integration role for a bot.
  These roles are created when the bot requested a list of permission in the authorization URL.
  To check whether a role is a bot role you can use role.getTags().isBot() and you can use Role.RoleTags.getBotIdLong() to check which bot it applies to.
  This requires CacheFlag.ROLE_TAGS to be enabled. See JDABuilder.enableCache(...).
  
  Parameters:
  
  user - The bot user
  
  Returns:
  
  The bot role, or null if no role matches
  
  Throws:
  
  IllegalArgumentException - If null is provided
  
  DetachedEntityException - If this entity is detached
- getBotRole
  
  @Nullable default Role getBotRole()
  
  Looks up the role which is the integration role for the currently connected bot (self-user).
  These roles are created when the bot requested a list of permission in the authorization URL.
  To check whether a role is a bot role you can use role.getTags().isBot() and you can use Role.RoleTags.getBotIdLong() to check which bot it applies to.
  This requires CacheFlag.ROLE_TAGS to be enabled. See JDABuilder.enableCache(...).
  
  Returns:
  
  The bot role, or null if no role matches
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getBoostRole
  
  @Nullable default Role getBoostRole()
  
  Looks up the role which is the booster role of this guild.
  These roles are created when the first user boosts this guild.
  To check whether a role is a booster role you can use role.getTags().isBoost().
  This requires CacheFlag.ROLE_TAGS to be enabled. See JDABuilder.enableCache(...).
  
  Returns:
  
  The boost role, or null if no role matches
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getRoleCache
  
  @Nonnull SortedSnowflakeCacheView<Role> getRoleCache()
  
  Sorted SnowflakeCacheView of all cached Roles of this Guild.
  Roles are sorted according to their position.
  
  Returns:
  
  SortedSnowflakeCacheView
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getEmojiById
  
  @Nullable default RichCustomEmoji getEmojiById(@Nonnull String id)
  
  Gets a RichCustomEmoji from this guild that has the same id as the one provided.
  If there is no RichCustomEmoji with an id that matches the provided one, then this returns null.
  Unicode emojis are not included as RichCustomEmoji!
  This requires the CacheFlag.EMOJI to be enabled!
  Parameters:
  
  id - the emoji id
  
  Returns:
  
  An Emoji matching the specified id
  
  Throws:
  
  NumberFormatException - If the provided id cannot be parsed by Long.parseLong(String)
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  retrieveEmojiById(String)
- getEmojiById
  
  @Nullable default RichCustomEmoji getEmojiById(long id)
  
  Gets an RichCustomEmoji from this guild that has the same id as the one provided.
  If there is no RichCustomEmoji with an id that matches the provided one, then this returns null.
  Unicode emojis are not included as RichCustomEmoji!
  This requires the CacheFlag.EMOJI to be enabled!
  Parameters:
  
  id - the emoji id
  
  Returns:
  
  An emoji matching the specified id
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  retrieveEmojiById(long)
- getEmojis
  
  @Nonnull default @Unmodifiable List<RichCustomEmoji> getEmojis()
  
  Gets all Custom Emojis belonging to this Guild.
  Emojis are not ordered in any specific way in the returned list.
  Unicode emojis are not included as RichCustomEmoji!
  This copies the backing store into a list. This means every call creates a new list with O(n) complexity. It is recommended to store this into a local variable or use getEmojiCache() and use its more efficient versions of handling these values.
  This requires the CacheFlag.EMOJI to be enabled!
  Returns:
  
  An immutable List of Custom Emojis.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  retrieveEmojis()
- getEmojisByName
  
  @Nonnull default @Unmodifiable List<RichCustomEmoji> getEmojisByName(@Nonnull String name, boolean ignoreCase)
  
  Gets a list of all Custom Emojis in this Guild that have the same name as the one provided.
  If there are no Emojis with the provided name, then this returns an empty list.
  Unicode emojis are not included as RichCustomEmoji!
  This requires the CacheFlag.EMOJI to be enabled!
  
  Parameters:
  
  name - The name used to filter the returned Emojis. Without colons.
  
  ignoreCase - Determines if the comparison ignores case when comparing. True - case insensitive.
  
  Returns:
  
  Possibly-empty immutable list of all Emojis that match the provided name.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getEmojiCache
  
  @Nonnull SnowflakeCacheView<RichCustomEmoji> getEmojiCache()
  
  SnowflakeCacheView of all cached Custom Emojis of this Guild.
  This will be empty if CacheFlag.EMOJI is disabled.
  This requires the CacheFlag.EMOJI to be enabled!
  Returns:
  
  SnowflakeCacheView
  
  See Also:
  
  retrieveEmojis()
- getStickerById
  
  @Nullable default GuildSticker getStickerById(@Nonnull String id)
  
  Gets a GuildSticker from this guild that has the same id as the one provided.
  If there is no GuildSticker with an id that matches the provided one, then this returns null.
  This requires the CacheFlag.STICKER to be enabled!
  Parameters:
  
  id - the sticker id
  
  Returns:
  
  A Sticker matching the specified id
  
  Throws:
  
  NumberFormatException - If the provided id cannot be parsed by Long.parseLong(String)
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  retrieveSticker(StickerSnowflake)
- getStickerById
  
  @Nullable default GuildSticker getStickerById(long id)
  
  Gets a GuildSticker from this guild that has the same id as the one provided.
  If there is no GuildSticker with an id that matches the provided one, then this returns null.
  This requires the CacheFlag.STICKER to be enabled!
  Parameters:
  
  id - the sticker id
  
  Returns:
  
  A Sticker matching the specified id
  
  See Also:
  
  retrieveSticker(StickerSnowflake)
- getStickers
  
  @Nonnull default @Unmodifiable List<GuildSticker> getStickers()
  
  Gets all custom GuildStickers belonging to this Guild.
  GuildStickers are not ordered in any specific way in the returned list.
  This copies the backing store into a list. This means every call creates a new list with O(n) complexity. It is recommended to store this into a local variable or use getStickerCache() and use its more efficient versions of handling these values.
  This requires the CacheFlag.STICKER to be enabled!
  Returns:
  
  An immutable List of GuildStickers.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  retrieveStickers()
- getStickersByName
  
  @Nonnull default @Unmodifiable List<GuildSticker> getStickersByName(@Nonnull String name, boolean ignoreCase)
  
  Gets a list of all GuildStickers in this Guild that have the same name as the one provided.
  If there are no GuildStickers with the provided name, then this returns an empty list.
  This requires the CacheFlag.STICKER to be enabled!
  
  Parameters:
  
  name - The name used to filter the returned GuildStickers. Without colons.
  
  ignoreCase - Determines if the comparison ignores case when comparing. True - case insensitive.
  
  Returns:
  
  Possibly-empty immutable list of all Stickers that match the provided name.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getStickerCache
  
  @Nonnull SnowflakeCacheView<GuildSticker> getStickerCache()
  
  SnowflakeCacheView of all cached GuildStickers of this Guild.
  This will be empty if CacheFlag.STICKER is disabled.
  This requires the CacheFlag.STICKER to be enabled!
  Returns:
  
  SnowflakeCacheView
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  retrieveStickers()
- retrieveEmojis
  
  @Nonnull @CheckReturnValue RestAction<@Unmodifiable List<RichCustomEmoji>> retrieveEmojis()
  
  Retrieves an immutable list of Custom Emojis together with their respective creators.
  Note that RichCustomEmoji.getOwner() is only available if the currently logged in account has Permission.MANAGE_GUILD_EXPRESSIONS.
  
  Returns:
  
  RestAction - Type: List of RichCustomEmoji
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- retrieveEmojiById
  
  @Nonnull @CheckReturnValue RestAction<RichCustomEmoji> retrieveEmojiById(@Nonnull String id)
  Retrieves a custom emoji together with its respective creator.
  This does not include unicode emoji.
  Note that RichCustomEmoji.getOwner() is only available if the currently logged in account has Permission.MANAGE_GUILD_EXPRESSIONS.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  UNKNOWN_EMOJI
  If the provided id does not correspond to an emoji in this guild
  Parameters:
  
  id - The emoji id
  
  Returns:
  
  RestAction - Type: RichCustomEmoji
  
  Throws:
  
  IllegalArgumentException - If the provided id is not a valid snowflake
  
  DetachedEntityException - If this entity is detached
- retrieveEmojiById
  
  @Nonnull @CheckReturnValue default RestAction<RichCustomEmoji> retrieveEmojiById(long id)
  Retrieves a Custom Emoji together with its respective creator.
  Note that RichCustomEmoji.getOwner() is only available if the currently logged in account has Permission.MANAGE_GUILD_EXPRESSIONS.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  UNKNOWN_EMOJI
  If the provided id does not correspond to an emoji in this guild
  Parameters:
  
  id - The emoji id
  
  Returns:
  
  RestAction - Type: RichCustomEmoji
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- retrieveEmoji
  
  @Nonnull @CheckReturnValue default RestAction<RichCustomEmoji> retrieveEmoji(@Nonnull CustomEmoji emoji)
  Retrieves a custom emoji together with its respective creator.
  Note that RichCustomEmoji.getOwner() is only available if the currently logged in account has Permission.MANAGE_GUILD_EXPRESSIONS.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  UNKNOWN_EMOJI
  If the provided emoji does not correspond to an emoji in this guild anymore
  Parameters:
  
  emoji - The emoji reference to retrieve
  
  Returns:
  
  RestAction - Type: RichCustomEmoji
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- retrieveStickers
  
  @Nonnull @CheckReturnValue RestAction<@Unmodifiable List<GuildSticker>> retrieveStickers()
  
  Retrieves all the stickers from this guild.
  This also includes unavailable stickers.
  
  Returns:
  
  RestAction - Type: List of GuildSticker
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- retrieveSticker
  
  @Nonnull @CheckReturnValue RestAction<GuildSticker> retrieveSticker(@Nonnull StickerSnowflake sticker)
  Attempts to retrieve a GuildSticker object for this guild based on the provided snowflake reference.
  The returned RestAction can encounter the following Discord errors:
  
  UNKNOWN_STICKER
  Occurs when the provided id does not refer to a sticker known by Discord.
  Parameters:
  
  sticker - The reference of the requested Sticker.
  Can be RichSticker, StickerItem, or Sticker.fromId(long).
  
  Returns:
  
  RestAction - Type: GuildSticker
  On request, gets the sticker with id matching provided id from Discord.
  
  Throws:
  
  IllegalArgumentException - If null is provided
  
  DetachedEntityException - If this entity is detached
- editSticker
  
  @Nonnull @CheckReturnValue GuildStickerManager editSticker(@Nonnull StickerSnowflake sticker)
  Modify a sticker using GuildStickerManager.
  You can update multiple fields at once, by calling the respective setters before executing the request.
  The returned RestAction can encounter the following Discord errors:
  
  UNKNOWN_STICKER
  Occurs when the provided id does not refer to a sticker known by Discord.
  Returns:
  
  GuildStickerManager
  
  Throws:
  
  IllegalArgumentException - If null is provided
  
  InsufficientPermissionException - If the currently logged in account does not have MANAGE_GUILD_EXPRESSIONS in the guild.
  
  DetachedEntityException - If this entity is detached
- retrieveBanList
  
  @Nonnull @CheckReturnValue BanPaginationAction retrieveBanList()
  Retrieves an immutable list of the currently banned Users.
  If you wish to ban or unban a user, use either ban(UserSnowflake, int, TimeUnit) or unban(UserSnowflake).
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The ban list cannot be fetched due to a permission discrepancy
  Returns:
  
  The BanPaginationAction of the guild's bans.
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.BAN_MEMBERS permission.
  
  DetachedEntityException - If this entity is detached
- retrieveBan
  
  @Nonnull @CheckReturnValue RestAction<Guild.Ban> retrieveBan(@Nonnull UserSnowflake user)
  Retrieves a Ban of the provided UserSnowflake.
  If you wish to ban or unban a user, use either ban(UserSnowflake, int, TimeUnit) or unban(UserSnowflake).
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The ban list cannot be fetched due to a permission discrepancy
  
  UNKNOWN_BAN
  Either the ban was removed before finishing the task or it did not exist in the first place
  Parameters:
  
  user - The UserSnowflake for the banned user. This can be a user instance or User.fromId(long).
  
  Returns:
  
  RestAction - Type: Ban
  An unmodifiable ban object for the user banned from this guild
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.BAN_MEMBERS permission.
  
  DetachedEntityException - If this entity is detached
- retrievePrunableMemberCount
  
  @Nonnull @CheckReturnValue RestAction<Integer> retrievePrunableMemberCount(int days)
  The method calculates the amount of Members that would be pruned if prune(int, Role...) was executed. Prunability is determined by a Member being offline for at least days days.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The prune count cannot be fetched due to a permission discrepancy
  Parameters:
  
  days - Minimum number of days since a member has been offline to get affected.
  
  Returns:
  
  RestAction - Type: Integer
  The amount of Members that would be affected.
  
  Throws:
  
  InsufficientPermissionException - If the account doesn't have KICK_MEMBER Permission.
  
  IllegalArgumentException - If the provided days are less than 1 or more than 30
  
  DetachedEntityException - If this entity is detached
- getPublicRole
  
  @Nonnull Role getPublicRole()
  
  The @everyone Role of this Guild.
  This role is special because its position is calculated as -1. All other role positions are 0 or greater. This implies that the public role is always below any custom roles created in this Guild. Additionally, all members of this guild are implied to have this role so it is not included in the list returned by Member.getRoles().
  The ID of this Role is the Guild's ID thus it is equivalent to using getRoleById(getIdLong()).
  
  Returns:
  
  The @everyone Role
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getDefaultChannel
  
  @Nullable DefaultGuildChannelUnion getDefaultChannel()
  
  The default StandardGuildChannel for a Guild.
  This is the channel that the Discord client will default to opening when a Guild is opened for the first time when accepting an invite that is not directed at a specific channel.
  Note: This channel is the first channel in the guild (ordered by position) that the getPublicRole() has the Permission.VIEW_CHANNEL in.
  
  Returns:
  
  The channel representing the default channel for this guild
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getManager
  
  @Nonnull @CheckReturnValue GuildManager getManager()
  
  Returns the GuildManager for this Guild, used to modify all properties and settings of the Guild.
  You modify multiple fields in one request by chaining setters before calling RestAction.queue().
  
  Returns:
  
  The Manager of this Guild
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_SERVER
  
  DetachedEntityException - If this entity is detached
- isBoostProgressBarEnabled
  
  boolean isBoostProgressBarEnabled()
  
  Returns whether this Guild has its boost progress bar shown.
  
  Returns:
  
  True, if this Guild has its boost progress bar shown
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- retrieveAuditLogs
  
  @Nonnull @CheckReturnValue AuditLogPaginationAction retrieveAuditLogs()
  A PaginationAction implementation that allows to iterate over all AuditLogEntries of this Guild.
  This iterates from the most recent action to the first logged one. (Limit 90 days into history by discord api)
  Examples
  
  public void logBan(GuildBanEvent event) { Guild guild = event.getGuild(); List<TextChannel> modLog = guild.getTextChannelsByName("mod-log", true); guild.retrieveAuditLogs() .type(ActionType.BAN) // filter by type .limit(1) .queue(list -> { if (list.isEmpty()) return; AuditLogEntry entry = list.get(0); String message = String.format("%#s banned %#s with reason %s", entry.getUser(), event.getUser(), entry.getReason()); modLog.forEach(channel -> channel.sendMessage(message).queue() ); }); }
  Returns:
  
  AuditLogPaginationAction
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have the permission VIEW_AUDIT_LOGS
  
  DetachedEntityException - If this entity is detached
- leave
  
  @Nonnull @CheckReturnValue RestAction<Void> leave()
  
  Used to leave a Guild. If the currently logged in account is the owner of this guild (getOwner()) then ownership of the Guild needs to be transferred to a different Member before leaving using transferOwnership(Member).
  
  Returns:
  
  RestAction - Type: Void
  
  Throws:
  
  IllegalStateException - Thrown if the currently logged in account is the Owner of this Guild.
  
  DetachedEntityException - If this entity is detached
- delete
  
  @Nonnull @CheckReturnValue RestAction<Void> delete()
  
  Used to completely delete a Guild. This can only be done if the currently logged in account is the owner of the Guild.
  If the account has MFA enabled, use delete(String) instead to provide the MFA code.
  
  Returns:
  
  RestAction - Type: Void
  
  Throws:
  
  PermissionException - Thrown if the currently logged in account is not the owner of this Guild.
  
  IllegalStateException - If the currently logged in account has MFA enabled. (SelfUser.isMfaEnabled()).
  
  DetachedEntityException - If this entity is detached
- delete
  
  @Nonnull @CheckReturnValue RestAction<Void> delete(@Nullable String mfaCode)
  
  Used to completely delete a guild. This can only be done if the currently logged in account is the owner of the Guild.
  This method is specifically used for when MFA is enabled on the logged in account SelfUser.isMfaEnabled(). If MFA is not enabled, use delete().
  
  Parameters:
  
  mfaCode - The Multifactor Authentication code generated by an app like Google Authenticator.
  This is not the MFA token given to you by Discord. The code is typically 6 characters long.
  
  Returns:
  
  RestAction - Type: Void
  
  Throws:
  
  PermissionException - Thrown if the currently logged in account is not the owner of this Guild.
  
  IllegalArgumentException - If the provided mfaCode is null or empty when SelfUser.isMfaEnabled() is true.
  
  DetachedEntityException - If this entity is detached
- getAudioManager
  
  @Nonnull AudioManager getAudioManager()
  
  The AudioManager that represents the audio connection for this Guild.
  If no AudioManager exists for this Guild, this will create a new one.
  This operation is synchronized on all audio managers for this JDA instance, this means that calling getAudioManager() on any other guild while a thread is accessing this method may be locked.
  Returns:
  
  The AudioManager for this Guild.
  
  Throws:
  
  IllegalStateException - If GatewayIntent.GUILD_VOICE_STATES is disabled
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  JDA.getAudioManagerCache()
- requestToSpeak
  
  @Nonnull Task<Void> requestToSpeak()
  Once the currently logged in account is connected to a StageChannel, this will trigger a Request-to-Speak (aka raise your hand).
  This will set an internal flag to automatically request to speak once the bot joins a stage channel.
  You can use cancelRequestToSpeak() to move back to the audience or cancel your pending request.
  If the self member has Permission.VOICE_MUTE_OTHERS this will immediately promote them to speaker.
  Example:
  stageChannel.createStageInstance("Talent Show").queue() guild.requestToSpeak(); // Set request to speak flag guild.getAudioManager().openAudioConnection(stageChannel); // join the channel
  Returns:
  
  Task representing the request to speak. Calling Task.get() can result in deadlocks and should be avoided at all times.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  cancelRequestToSpeak()
- cancelRequestToSpeak
  
  @Nonnull Task<Void> cancelRequestToSpeak()
  
  Cancels the Request-to-Speak.
  This can also be used to move back to the audience if you are currently a speaker.
  If there is no request to speak or the member is not currently connected to a StageChannel, this does nothing.
  Returns:
  
  Task representing the request to speak cancellation. Calling Task.get() can result in deadlocks and should be avoided at all times.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  requestToSpeak()
- getJDA
  
  @Nonnull JDA getJDA()
  
  Returns the JDA instance of this Guild
  
  Returns:
  
  the corresponding JDA instance
- retrieveInvites
  
  @Nonnull @CheckReturnValue RestAction<@Unmodifiable List<Invite>> retrieveInvites()
  
  Retrieves all Invites for this guild.
  Requires MANAGE_SERVER in this guild. Will throw an InsufficientPermissionException otherwise.
  To get all invites for a GuildChannel use GuildChannel.retrieveInvites()
  Returns:
  
  RestAction - Type: List<Invite>
  The list of expanded Invite objects
  
  Throws:
  
  InsufficientPermissionException - if the account does not have MANAGE_SERVER in this Guild.
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  IInviteContainer.retrieveInvites()
- retrieveTemplates
  
  @Nonnull @CheckReturnValue RestAction<@Unmodifiable List<Template>> retrieveTemplates()
  
  Retrieves all Templates for this guild.
  Requires MANAGE_SERVER in this guild. Will throw an InsufficientPermissionException otherwise.
  
  Returns:
  
  RestAction - Type: List<Template>
  The list of Template objects
  
  Throws:
  
  InsufficientPermissionException - if the account does not have MANAGE_SERVER in this Guild.
  
  DetachedEntityException - If this entity is detached
- createTemplate
  
  @Nonnull @CheckReturnValue RestAction<Template> createTemplate(@Nonnull String name, @Nullable String description)
  Used to create a new Template for this Guild.
  Requires MANAGE_SERVER in this Guild. Will throw an InsufficientPermissionException otherwise.
  Possible ErrorResponses include:
  
  Guild already has a template
  The guild already has a template.
  Parameters:
  
  name - The name of the template
  
  description - The description of the template
  
  Returns:
  
  RestAction - Type: Template
  The created Template object
  
  Throws:
  
  InsufficientPermissionException - if the account does not have MANAGE_SERVER in this Guild
  
  IllegalArgumentException - If the provided name is null or not between 1-100 characters long, or if the provided description is not between 0-120 characters long
  
  DetachedEntityException - If this entity is detached
- retrieveWebhooks
  
  @Nonnull @CheckReturnValue RestAction<@Unmodifiable List<Webhook>> retrieveWebhooks()
  
  Retrieves all Webhooks for this Guild.
  Requires MANAGE_WEBHOOKS in this Guild.
  To get all webhooks for a specific TextChannel, use IWebhookContainer.retrieveWebhooks()
  Returns:
  
  RestAction - Type: List<Webhook>
  A list of all Webhooks in this Guild.
  
  Throws:
  
  InsufficientPermissionException - if the account does not have MANAGE_WEBHOOKS in this Guild.
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  IWebhookContainer.retrieveWebhooks()
- retrieveWelcomeScreen
  
  @Nonnull @CheckReturnValue RestAction<GuildWelcomeScreen> retrieveWelcomeScreen()
  Retrieves the welcome screen for this Guild.
  The welcome screen is shown to all members after joining the Guild.
  Possible ErrorResponses include:
  
  Unknown Guild Welcome Screen
  The guild has no welcome screen
  
  Missing Permissions
  The guild's welcome screen is disabled and the currently logged in account doesn't have the MANAGE_SERVER permission
  Returns:
  
  RestAction - Type: GuildWelcomeScreen
  The welcome screen for this Guild.
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- getVoiceStates
  
  @Nonnull @Unmodifiable List<GuildVoiceState> getVoiceStates()
  
  A list containing the cached GuildVoiceState of every Member connected to an audio channel in this guild.
  This requires CacheFlag.VOICE_STATE to be enabled.
  
  Returns:
  
  Immutable list containing all cached GuildVoiceStates for this guild.
- retrieveMemberVoiceStateById
  
  @Nonnull @CheckReturnValue CacheRestAction<GuildVoiceState> retrieveMemberVoiceStateById(long id)
  Load the member's voice state for the specified user.
  Possible ErrorResponseExceptions include:
  
  ErrorResponse.UNKNOWN_VOICE_STATE
  The specified user does not exist, is not a member of this guild or is not connected to a voice channel
  Parameters:
  
  id - The user id to load the voice state from
  
  Returns:
  
  RestAction - Type: GuildVoiceState
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- retrieveMemberVoiceStateById
  
  @Nonnull @CheckReturnValue default RestAction<GuildVoiceState> retrieveMemberVoiceStateById(@Nonnull String id)
  Load the member's voice state for the specified user.
  Possible ErrorResponseExceptions include:
  
  ErrorResponse.UNKNOWN_VOICE_STATE
  The specified user does not exist, is not a member of this guild or is not connected to a voice channel
  Parameters:
  
  id - The user id to load the voice state from
  
  Returns:
  
  RestAction - Type: GuildVoiceState
  
  Throws:
  
  IllegalArgumentException - If the provided id is empty or null
  
  NumberFormatException - If the provided id is not a snowflake
  
  DetachedEntityException - If this entity is detached
- retrieveMemberVoiceState
  
  @Nonnull @CheckReturnValue default RestAction<GuildVoiceState> retrieveMemberVoiceState(@Nonnull UserSnowflake user)
  Load the member's voice state for the specified UserSnowflake.
  Possible ErrorResponseExceptions include:
  
  ErrorResponse.UNKNOWN_VOICE_STATE
  The specified user does not exist, is not a member of this guild or is not connected to a voice channel
  Parameters:
  
  user - The UserSnowflake for the member's voice state to retrieve. This can be a member or user instance or User.fromId(long).
  
  Returns:
  
  RestAction - Type: GuildVoiceState
  
  Throws:
  
  IllegalArgumentException - If provided with null
  
  DetachedEntityException - If this entity is detached
- getVerificationLevel
  
  @Nonnull Guild.VerificationLevel getVerificationLevel()
  
  Returns the verification-Level of this Guild. Verification level is one of the factors that determines if a Member can send messages in a Guild.
  For a short description of the different values, see Guild.VerificationLevel.
  This value can be modified using GuildManager.setVerificationLevel(net.dv8tion.jda.api.entities.Guild.VerificationLevel).
  
  Returns:
  
  The Verification-Level of this Guild.
- getDefaultNotificationLevel
  
  @Nonnull Guild.NotificationLevel getDefaultNotificationLevel()
  
  Returns the default message Notification-Level of this Guild. Notification level determines when Members get notification for messages. The value returned is the default level set for any new Members that join the Guild.
  For a short description of the different values, see NotificationLevel.
  This value can be modified using GuildManager.setDefaultNotificationLevel(net.dv8tion.jda.api.entities.Guild.NotificationLevel).
  
  Returns:
  
  The default message Notification-Level of this Guild.
- getRequiredMFALevel
  
  @Nonnull Guild.MFALevel getRequiredMFALevel()
  
  Returns the level of multifactor authentication required to execute administrator restricted functions in this guild.
  For a short description of the different values, see MFALevel.
  This value can be modified using GuildManager.setRequiredMFALevel(net.dv8tion.jda.api.entities.Guild.MFALevel).
  
  Returns:
  
  The MFA-Level required by this Guild.
- getExplicitContentLevel
  
  @Nonnull Guild.ExplicitContentLevel getExplicitContentLevel()
  
  The level of content filtering enabled in this Guild.
  This decides which messages sent by which Members will be scanned for explicit content.
  
  Returns:
  
  ExplicitContentLevel for this Guild
- loadMembers
  
  @Nonnull @CheckReturnValue default Task<List<Member>> loadMembers()
  
  Retrieves and collects members of this guild into a list.
  This will use the configured MemberCachePolicy to decide which members to retain in cache.
  You can use findMembers(Predicate) to filter specific members.
  This requires the privileged GatewayIntent.GUILD_MEMBERS to be enabled!
  You MUST NOT use blocking operations such as Task.get()! The response handling happens on the event thread by default.
  
  Returns:
  
  Task - Type: List of Member
  
  Throws:
  
  IllegalStateException - If the GatewayIntent.GUILD_MEMBERS is not enabled
  
  DetachedEntityException - If this entity is detached
- findMembers
  
  @Nonnull @CheckReturnValue default Task<List<Member>> findMembers(@Nonnull Predicate<? super Member> filter)
  
  Retrieves and collects members of this guild into a list.
  This will use the configured MemberCachePolicy to decide which members to retain in cache.
  This requires the privileged GatewayIntent.GUILD_MEMBERS to be enabled!
  You MUST NOT use blocking operations such as Task.get()! The response handling happens on the event thread by default.
  
  Parameters:
  
  filter - Filter to decide which members to include
  
  Returns:
  
  Task - Type: List of Member
  
  Throws:
  
  IllegalArgumentException - If the provided filter is null
  
  IllegalStateException - If the GatewayIntent.GUILD_MEMBERS is not enabled
  
  DetachedEntityException - If this entity is detached
- findMembersWithRoles
  
  @Nonnull @CheckReturnValue default Task<List<Member>> findMembersWithRoles(@Nonnull Collection<Role> roles)
  
  Retrieves and collects members of this guild into a list.
  This will use the configured MemberCachePolicy to decide which members to retain in cache.
  This requires the privileged GatewayIntent.GUILD_MEMBERS to be enabled!
  You MUST NOT use blocking operations such as Task.get()! The response handling happens on the event thread by default.
  
  Parameters:
  
  roles - Collection of all roles the members must have
  
  Returns:
  
  Task - Type: List of Member
  
  Throws:
  
  IllegalArgumentException - If null is provided
  
  IllegalStateException - If the GatewayIntent.GUILD_MEMBERS is not enabled
  
  DetachedEntityException - If this entity is detached
  
  Since:
  
  4.2.1
- findMembersWithRoles
  
  @Nonnull @CheckReturnValue default Task<List<Member>> findMembersWithRoles(@Nonnull Role... roles)
  
  Retrieves and collects members of this guild into a list.
  This will use the configured MemberCachePolicy to decide which members to retain in cache.
  This requires the privileged GatewayIntent.GUILD_MEMBERS to be enabled!
  You MUST NOT use blocking operations such as Task.get()! The response handling happens on the event thread by default.
  
  Parameters:
  
  roles - All roles the members must have
  
  Returns:
  
  Task - Type: List of Member
  
  Throws:
  
  IllegalArgumentException - If null is provided
  
  IllegalStateException - If the GatewayIntent.GUILD_MEMBERS is not enabled
  
  DetachedEntityException - If this entity is detached
  
  Since:
  
  4.2.1
- loadMembers
  
  @Nonnull Task<Void> loadMembers(@Nonnull Consumer<Member> callback)
  
  Retrieves all members of this guild.
  This will use the configured MemberCachePolicy to decide which members to retain in cache.
  This requires the privileged GatewayIntent.GUILD_MEMBERS to be enabled!
  You MUST NOT use blocking operations such as Task.get()! The response handling happens on the event thread by default.
  
  Parameters:
  
  callback - Consumer callback for each member
  
  Returns:
  
  Task cancellable handle for this request
  
  Throws:
  
  IllegalArgumentException - If the callback is null
  
  IllegalStateException - If the GatewayIntent.GUILD_MEMBERS is not enabled
  
  DetachedEntityException - If this entity is detached
- retrieveMember
  
  @Nonnull @CheckReturnValue default CacheRestAction<Member> retrieveMember(@Nonnull UserSnowflake user)
  Load the member for the specified UserSnowflake.
  If the member is already loaded it will be retrieved from getMemberById(long) and immediately provided if the member information is consistent. The cache consistency directly relies on the enabled GatewayIntents as GatewayIntent.GUILD_MEMBERS is required to keep the cache updated with the latest information. You can use useCache(false) to always make a new request, which is the default behavior if the required intents are disabled.
  Possible ErrorResponseExceptions include:
  
  ErrorResponse.UNKNOWN_MEMBER
  The specified user is not a member of this guild
  
  ErrorResponse.UNKNOWN_USER
  The specified user does not exist
  Parameters:
  
  user - The UserSnowflake for the member to retrieve. This can be a member or user instance or User.fromId(long).
  
  Returns:
  
  RestAction - Type: Member
  
  Throws:
  
  IllegalArgumentException - If provided with null
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  pruneMemberCache()
  
  unloadMember(long)
- retrieveOwner
  
  @Nonnull @CheckReturnValue default CacheRestAction<Member> retrieveOwner()
  Shortcut for guild.retrieveMemberById(guild.getOwnerIdLong()).
  This will retrieve the current owner of the guild. It is possible that the owner of a guild is no longer a registered discord user in which case this will fail.
  If the member is already loaded it will be retrieved from getMemberById(long) and immediately provided if the member information is consistent. The cache consistency directly relies on the enabled GatewayIntents as GatewayIntent.GUILD_MEMBERS is required to keep the cache updated with the latest information. You can use useCache(false) to always make a new request, which is the default behavior if the required intents are disabled.
  Possible ErrorResponseExceptions include:
  
  ErrorResponse.UNKNOWN_MEMBER
  The specified user is not a member of this guild
  
  ErrorResponse.UNKNOWN_USER
  The specified user does not exist
  Returns:
  
  RestAction - Type: Member
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  pruneMemberCache()
  
  unloadMember(long)
  
  getOwner()
  
  getOwnerIdLong()
  
  retrieveMemberById(long)
- retrieveMemberById
  
  @Nonnull @CheckReturnValue default CacheRestAction<Member> retrieveMemberById(@Nonnull String id)
  Load the member for the specified user.
  If the member is already loaded it will be retrieved from getMemberById(long) and immediately provided if the member information is consistent. The cache consistency directly relies on the enabled GatewayIntents as GatewayIntent.GUILD_MEMBERS is required to keep the cache updated with the latest information. You can use useCache(false) to always make a new request, which is the default behavior if the required intents are disabled.
  Possible ErrorResponseExceptions include:
  
  ErrorResponse.UNKNOWN_MEMBER
  The specified user is not a member of this guild
  
  ErrorResponse.UNKNOWN_USER
  The specified user does not exist
  Parameters:
  
  id - The user id to load the member from
  
  Returns:
  
  RestAction - Type: Member
  
  Throws:
  
  IllegalArgumentException - If the provided id is empty or null
  
  NumberFormatException - If the provided id is not a snowflake
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  pruneMemberCache()
  
  unloadMember(long)
- retrieveMemberById
  
  @Nonnull @CheckReturnValue CacheRestAction<Member> retrieveMemberById(long id)
  Load the member for the specified user.
  If the member is already loaded it will be retrieved from getMemberById(long) and immediately provided if the member information is consistent. The cache consistency directly relies on the enabled GatewayIntents as GatewayIntent.GUILD_MEMBERS is required to keep the cache updated with the latest information. You can use useCache(false) to always make a new request, which is the default behavior if the required intents are disabled.
  Possible ErrorResponseExceptions include:
  
  ErrorResponse.UNKNOWN_MEMBER
  The specified user is not a member of this guild
  
  ErrorResponse.UNKNOWN_USER
  The specified user does not exist
  Parameters:
  
  id - The user id to load the member from
  
  Returns:
  
  RestAction - Type: Member
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  pruneMemberCache()
  
  unloadMember(long)
- retrieveMembers
  
  @Nonnull @CheckReturnValue default Task<List<Member>> retrieveMembers(@Nonnull Collection<? extends UserSnowflake> users)
  
  Retrieves a list of members.
  If the user does not resolve to a member of this guild, then it will not appear in the resulting list. It is possible that none of the users resolve to a member, in which case an empty list will be the result.
  If the GUILD_PRESENCES intent is enabled, this will load the OnlineStatus and Activities of the members. You can use retrieveMembers(boolean, Collection) to disable presences.
  The requests automatically timeout after 10 seconds. When the timeout occurs a TimeoutException will be used to complete exceptionally.
  You MUST NOT use blocking operations such as Task.get()! The response handling happens on the event thread by default.
  Parameters:
  
  users - The users of the members (max 100)
  
  Returns:
  
  Task handle for the request
  
  Throws:
  
  IllegalArgumentException -
  
  If the input contains null
  
  If the input is more than 100 IDs
  
  DetachedEntityException - If this entity is detached
- retrieveMembersByIds
  
  @Nonnull @CheckReturnValue default Task<List<Member>> retrieveMembersByIds(@Nonnull Collection<Long> ids)
  
  Retrieves a list of members by their user id.
  If the id does not resolve to a member of this guild, then it will not appear in the resulting list. It is possible that none of the IDs resolve to a member, in which case an empty list will be the result.
  If the GUILD_PRESENCES intent is enabled, this will load the OnlineStatus and Activities of the members. You can use retrieveMembersByIds(boolean, Collection) to disable presences.
  The requests automatically timeout after 10 seconds. When the timeout occurs a TimeoutException will be used to complete exceptionally.
  You MUST NOT use blocking operations such as Task.get()! The response handling happens on the event thread by default.
  Parameters:
  
  ids - The ids of the members (max 100)
  
  Returns:
  
  Task handle for the request
  
  Throws:
  
  IllegalArgumentException -
  
  If the input contains null
  
  If the input is more than 100 IDs
  
  DetachedEntityException - If this entity is detached
- retrieveMembersByIds
  
  @Nonnull @CheckReturnValue default Task<List<Member>> retrieveMembersByIds(@Nonnull String... ids)
  
  Retrieves a list of members by their user id.
  If the id does not resolve to a member of this guild, then it will not appear in the resulting list. It is possible that none of the IDs resolve to a member, in which case an empty list will be the result.
  If the GUILD_PRESENCES intent is enabled, this will load the OnlineStatus and Activities of the members. You can use retrieveMembersByIds(boolean, String...) to disable presences.
  The requests automatically timeout after 10 seconds. When the timeout occurs a TimeoutException will be used to complete exceptionally.
  You MUST NOT use blocking operations such as Task.get()! The response handling happens on the event thread by default.
  Parameters:
  
  ids - The ids of the members (max 100)
  
  Returns:
  
  Task handle for the request
  
  Throws:
  
  IllegalArgumentException -
  
  If the input contains null
  
  If the input is more than 100 IDs
  
  DetachedEntityException - If this entity is detached
- retrieveMembersByIds
  
  @Nonnull @CheckReturnValue default Task<List<Member>> retrieveMembersByIds(@Nonnull long... ids)
  
  Retrieves a list of members by their user id.
  If the id does not resolve to a member of this guild, then it will not appear in the resulting list. It is possible that none of the IDs resolve to a member, in which case an empty list will be the result.
  If the GUILD_PRESENCES intent is enabled, this will load the OnlineStatus and Activities of the members. You can use retrieveMembersByIds(boolean, long...) to disable presences.
  The requests automatically timeout after 10 seconds. When the timeout occurs a TimeoutException will be used to complete exceptionally.
  You MUST NOT use blocking operations such as Task.get()! The response handling happens on the event thread by default.
  Parameters:
  
  ids - The ids of the members (max 100)
  
  Returns:
  
  Task handle for the request
  
  Throws:
  
  IllegalArgumentException -
  
  If the input contains null
  
  If the input is more than 100 IDs
  
  DetachedEntityException - If this entity is detached
- retrieveMembers
  
  @Nonnull @CheckReturnValue default Task<List<Member>> retrieveMembers(boolean includePresence, @Nonnull Collection<? extends UserSnowflake> users)
  
  Retrieves a list of members.
  If the user does not resolve to a member of this guild, then it will not appear in the resulting list. It is possible that none of the users resolve to a member, in which case an empty list will be the result.
  You can only load presences with the GUILD_PRESENCES intent enabled.
  The requests automatically timeout after 10 seconds. When the timeout occurs a TimeoutException will be used to complete exceptionally.
  You MUST NOT use blocking operations such as Task.get()! The response handling happens on the event thread by default.
  Parameters:
  
  includePresence - Whether to load presences of the members (online status/activity)
  
  users - The users of the members (max 100)
  
  Returns:
  
  Task handle for the request
  
  Throws:
  
  IllegalArgumentException -
  
  If includePresence is true and the GUILD_PRESENCES intent is disabled
  
  If the input contains null
  
  If the input is more than 100 users
  
  DetachedEntityException - If this entity is detached
- retrieveMembersByIds
  
  @Nonnull @CheckReturnValue default Task<List<Member>> retrieveMembersByIds(boolean includePresence, @Nonnull Collection<Long> ids)
  
  Retrieves a list of members by their user id.
  If the id does not resolve to a member of this guild, then it will not appear in the resulting list. It is possible that none of the IDs resolve to a member, in which case an empty list will be the result.
  You can only load presences with the GUILD_PRESENCES intent enabled.
  The requests automatically timeout after 10 seconds. When the timeout occurs a TimeoutException will be used to complete exceptionally.
  You MUST NOT use blocking operations such as Task.get()! The response handling happens on the event thread by default.
  Parameters:
  
  includePresence - Whether to load presences of the members (online status/activity)
  
  ids - The ids of the members (max 100)
  
  Returns:
  
  Task handle for the request
  
  Throws:
  
  IllegalArgumentException -
  
  If includePresence is true and the GUILD_PRESENCES intent is disabled
  
  If the input contains null
  
  If the input is more than 100 IDs
  
  DetachedEntityException - If this entity is detached
- retrieveMembersByIds
  
  @Nonnull @CheckReturnValue default Task<List<Member>> retrieveMembersByIds(boolean includePresence, @Nonnull String... ids)
  
  Retrieves a list of members by their user id.
  If the id does not resolve to a member of this guild, then it will not appear in the resulting list. It is possible that none of the IDs resolve to a member, in which case an empty list will be the result.
  You can only load presences with the GUILD_PRESENCES intent enabled.
  The requests automatically timeout after 10 seconds. When the timeout occurs a TimeoutException will be used to complete exceptionally.
  You MUST NOT use blocking operations such as Task.get()! The response handling happens on the event thread by default.
  Parameters:
  
  includePresence - Whether to load presences of the members (online status/activity)
  
  ids - The ids of the members (max 100)
  
  Returns:
  
  Task handle for the request
  
  Throws:
  
  IllegalArgumentException -
  
  If includePresence is true and the GUILD_PRESENCES intent is disabled
  
  If the input contains null
  
  If the input is more than 100 IDs
  
  DetachedEntityException - If this entity is detached
- retrieveMembersByIds
  
  @Nonnull @CheckReturnValue Task<List<Member>> retrieveMembersByIds(boolean includePresence, @Nonnull long... ids)
  
  Retrieves a list of members by their user id.
  If the id does not resolve to a member of this guild, then it will not appear in the resulting list. It is possible that none of the IDs resolve to a member, in which case an empty list will be the result.
  You can only load presences with the GUILD_PRESENCES intent enabled.
  The requests automatically timeout after 10 seconds. When the timeout occurs a TimeoutException will be used to complete exceptionally.
  You MUST NOT use blocking operations such as Task.get()! The response handling happens on the event thread by default.
  Parameters:
  
  includePresence - Whether to load presences of the members (online status/activity)
  
  ids - The ids of the members (max 100)
  
  Returns:
  
  Task handle for the request
  
  Throws:
  
  IllegalArgumentException -
  
  If includePresence is true and the GUILD_PRESENCES intent is disabled
  
  If the input contains null
  
  If the input is more than 100 IDs
  
  DetachedEntityException - If this entity is detached
- retrieveMembersByPrefix
  
  @Nonnull @CheckReturnValue Task<List<Member>> retrieveMembersByPrefix(@Nonnull String prefix, int limit)
  
  Queries a list of members using a radix tree based on the provided name prefix.
  This will check both the username and the nickname of the members. Additional filtering may be required. If no members with the specified prefix exist, the list will be empty.
  The requests automatically timeout after 10 seconds. When the timeout occurs a TimeoutException will be used to complete exceptionally.
  You MUST NOT use blocking operations such as Task.get()! The response handling happens on the event thread by default.
  Parameters:
  
  prefix - The case-insensitive name prefix
  
  limit - The max amount of members to retrieve (1-100)
  
  Returns:
  
  Task handle for the request
  
  Throws:
  
  IllegalArgumentException -
  
  If the provided prefix is null or empty.
  
  If the provided limit is not in the range of [1, 100]
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  getMembersByName(String, boolean)
  
  getMembersByNickname(String, boolean)
  
  getMembersByEffectiveName(String, boolean)
- retrieveActiveThreads
  
  @Nonnull @CheckReturnValue RestAction<@Unmodifiable List<ThreadChannel>> retrieveActiveThreads()
  
  Retrieves the active threads in this guild.
  
  Returns:
  
  RestAction - List of ThreadChannel
- retrieveScheduledEventById
  
  @Nonnull @CheckReturnValue default CacheRestAction<ScheduledEvent> retrieveScheduledEventById(long id)
  Retrieves a ScheduledEvent by its ID.
  Possible ErrorResponses include:
  
  ErrorResponse.UNKNOWN_SCHEDULED_EVENT
  A scheduled event with the specified ID does not exist in the guild, or the currently logged in user does not have access to it.
  Parameters:
  
  id - The ID of the ScheduledEvent
  
  Returns:
  
  RestAction - Type: ScheduledEvent
  
  Throws:
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  getScheduledEventById(long)
- retrieveScheduledEventById
  
  @Nonnull @CheckReturnValue CacheRestAction<ScheduledEvent> retrieveScheduledEventById(@Nonnull String id)
  Retrieves a ScheduledEvent by its ID.
  Possible ErrorResponses include:
  
  ErrorResponse.UNKNOWN_SCHEDULED_EVENT
  A scheduled event with the specified ID does not exist in this guild, or the currently logged in user does not have access to it.
  Parameters:
  
  id - The ID of the ScheduledEvent
  
  Returns:
  
  RestAction - Type: ScheduledEvent
  
  Throws:
  
  IllegalArgumentException - If the specified ID is null or empty
  
  NumberFormatException - If the specified ID cannot be parsed by Long.parseLong(String)
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  getScheduledEventById(long)
- moveVoiceMember
  
  @Nonnull @CheckReturnValue RestAction<Void> moveVoiceMember(@Nonnull UserSnowflake user, @Nullable AudioChannel audioChannel)
  Used to move a Member from one AudioChannel to another AudioChannel.
  As a note, you cannot move a Member that isn't already in a AudioChannel. Also they must be in a AudioChannel in the same Guild as the one that you are moving them to.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The target Member cannot be moved due to a permission discrepancy
  
  MISSING_ACCESS
  The VIEW_CHANNEL permission was removed
  
  UNKNOWN_MEMBER
  The specified Member was removed from the Guild before finishing the task
  
  UNKNOWN_CHANNEL
  The specified channel was deleted before finishing the task
  Parameters:
  
  user - The member that you are moving.
  
  audioChannel - The destination AudioChannel to which the member is being moved to. Or null to perform a voice kick.
  
  Returns:
  
  RestAction
  
  Throws:
  
  IllegalStateException - If the user is a Member and isn't currently in a AudioChannel in this Guild, or CacheFlag.VOICE_STATE is disabled.
  
  IllegalArgumentException -
  
  If the provided user is null
  
  If the provided Member isn't part of this Guild
  
  If the provided AudioChannel isn't part of this Guild
  
  InsufficientPermissionException -
  
  If this account doesn't have Permission.VOICE_MOVE_OTHERS in the AudioChannel that the Member is currently in.
  
  If this account AND the Member being moved don't have Permission.VOICE_CONNECT for the destination AudioChannel.
  
  DetachedEntityException - If this entity is detached
- kickVoiceMember
  
  @Nonnull @CheckReturnValue default RestAction<Void> kickVoiceMember(@Nonnull UserSnowflake user)
  Used to kick a member from a AudioChannel.
  As a note, you cannot kick a Member that isn't already in a AudioChannel. Also they must be in a AudioChannel in the same Guild.
  Equivalent to moveVoiceMember(member, null).
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The target Member cannot be moved due to a permission discrepancy
  
  UNKNOWN_MEMBER
  The specified Member was removed from the Guild before finishing the task
  
  UNKNOWN_CHANNEL
  The specified channel was deleted before finishing the task
  Parameters:
  
  user - The member that you are kicking.
  
  Returns:
  
  RestAction
  
  Throws:
  
  IllegalStateException - If the user is a Member and isn't currently in a AudioChannel in this Guild, or CacheFlag.VOICE_STATE is disabled.
  
  IllegalArgumentException -
  
  If any of the provided arguments is null
  
  If the provided Member isn't part of this Guild
  
  If the provided AudioChannel isn't part of this Guild
  
  InsufficientPermissionException - If this account doesn't have Permission.VOICE_MOVE_OTHERS in the AudioChannel that the Member is currently in.
  
  DetachedEntityException - If this entity is detached
- modifyNickname
  
  @Nonnull @CheckReturnValue AuditableRestAction<Void> modifyNickname(@Nonnull Member member, @Nullable String nickname)
  Changes the Member's nickname in this guild. The nickname is visible to all members of this guild.
  To change the nickname for the currently logged in account only the Permission NICKNAME_CHANGE is required.
  To change the nickname of any Member for this Guild the Permission NICKNAME_MANAGE is required.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The nickname of the target Member is not modifiable due to a permission discrepancy
  
  UNKNOWN_MEMBER
  The specified Member was removed from the Guild before finishing the task
  Parameters:
  
  member - The Member for which the nickname should be changed.
  
  nickname - The new nickname of the Member, provide null or an empty String to reset the nickname
  
  Returns:
  
  AuditableRestAction
  
  Throws:
  
  IllegalArgumentException - If the specified Member is not from the same Guild. Or if the provided member is null
  
  InsufficientPermissionException -
  
  If attempting to set nickname for self and the logged in account has neither Permission.NICKNAME_CHANGE or Permission.NICKNAME_MANAGE
  
  If attempting to set nickname for another member and the logged in account does not have Permission.NICKNAME_MANAGE
  
  HierarchyException - If attempting to set nickname for another member and the logged in account cannot manipulate the other user due to permission hierarchy position.
  See Member.canInteract(Member)
  
  DetachedEntityException - If this entity is detached
- prune
  
  @Nonnull @CheckReturnValue default AuditableRestAction<Integer> prune(int days, @Nonnull Role... roles)
  This method will prune (kick) all members who were offline for at least days days.
  The RestAction returned from this method will return the amount of Members that were pruned.
  You can use retrievePrunableMemberCount(int) to determine how many Members would be pruned if you were to call this method.
  This might timeout when pruning many members. You can use prune(days, false) to ignore the prune count and avoid a timeout.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The prune cannot finished due to a permission discrepancy
  Parameters:
  
  days - Minimum number of days since a member has been offline to get affected.
  
  roles - Optional roles to include in prune filter
  
  Returns:
  
  AuditableRestAction - Type: Integer
  The amount of Members that were pruned from the Guild.
  
  Throws:
  
  InsufficientPermissionException - If the account doesn't have KICK_MEMBER Permission.
  
  IllegalArgumentException -
  
  If the provided days are not in the range from 1 to 30 (inclusive)
  
  If null is provided
  
  If any of the provided roles is not from this guild
  
  DetachedEntityException - If this entity is detached
- prune
  
  @Nonnull @CheckReturnValue AuditableRestAction<Integer> prune(int days, boolean wait, @Nonnull Role... roles)
  This method will prune (kick) all members who were offline for at least days days.
  The RestAction returned from this method will return the amount of Members that were pruned.
  You can use retrievePrunableMemberCount(int) to determine how many Members would be pruned if you were to call this method.
  This might timeout when pruning many members with wait=true.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The prune cannot finished due to a permission discrepancy
  Parameters:
  
  days - Minimum number of days since a member has been offline to get affected.
  
  wait - Whether to calculate the number of pruned members and wait for the response (timeout for too many pruned)
  
  roles - Optional roles to include in prune filter
  
  Returns:
  
  AuditableRestAction - Type: Integer
  Provides the amount of Members that were pruned from the Guild, if wait is true.
  
  Throws:
  
  InsufficientPermissionException - If the account doesn't have KICK_MEMBER Permission.
  
  IllegalArgumentException -
  
  If the provided days are not in the range from 1 to 30 (inclusive)
  
  If null is provided
  
  If any of the provided roles is not from this guild
  
  DetachedEntityException - If this entity is detached
- modifySecurityIncidents
  
  @Nonnull @CheckReturnValue AuditableRestAction<Void> modifySecurityIncidents(@Nonnull SecurityIncidentActions incidents)
  Update the current guild security incident actions.
  Security incident actions are used to temporarily disable features for the purpose of moderation.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  ErrorResponse.INVALID_FORM_BODY
  If one of the provided timestamps is too far into the future
  Parameters:
  
  incidents - The new security incidents
  
  Returns:
  
  AuditableRestAction
  
  Throws:
  
  IllegalArgumentException - If null is provided
  
  InsufficientPermissionException - If the account doesn't have MANAGE_SERVER Permission.
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  SecurityIncidentActions.enabled(OffsetDateTime, OffsetDateTime)
  
  SecurityIncidentActions.disabled()
- kick
  
  @Nonnull @CheckReturnValue AuditableRestAction<Void> kick(@Nonnull UserSnowflake user)
  Kicks a Member from the Guild.
  Note: getMembers() will still contain the User until Discord sends the GuildMemberRemoveEvent.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The target Member cannot be kicked due to a permission discrepancy
  
  UNKNOWN_MEMBER
  The specified Member was removed from the Guild before finishing the task
  Parameters:
  
  user - The UserSnowflake for the user to kick. This can be a member or user instance or User.fromId(long).
  
  Returns:
  
  AuditableRestAction Kicks the provided Member from the current Guild
  
  Throws:
  
  IllegalArgumentException - If the user cannot be kicked from this Guild or the provided user is null.
  
  InsufficientPermissionException - If the logged in account does not have the Permission.KICK_MEMBERS permission.
  
  HierarchyException - If the logged in account cannot kick the other member due to permission hierarchy position. (See Member.canInteract(Member))
  
  DetachedEntityException - If this entity is detached
- ban
  
  @Nonnull @CheckReturnValue AuditableRestAction<Void> ban(@Nonnull UserSnowflake user, int deletionTimeframe, @Nonnull TimeUnit unit)
  Bans the user specified by the provided UserSnowflake and deletes messages sent by the user based on the deletionTimeframe.
  If you wish to ban a user without deleting any messages, provide deletionTimeframe with a value of 0. To set a ban reason, use AuditableRestAction.reason(String).
  You can unban a user with Guild.unban(UserReference).
  Note: getMembers() will still contain the User's Member object (if the User was in the Guild) until Discord sends the GuildMemberRemoveEvent.
  Examples
  Banning a user without deleting any messages:
  guild.ban(user, 0, TimeUnit.SECONDS) .reason("Banned for rude behavior") .queue();
  Banning a user and deleting messages from the past hour:
  guild.ban(user, 1, TimeUnit.HOURS) .reason("Banned for spamming") .queue();
  
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The target Member cannot be banned due to a permission discrepancy
  
  UNKNOWN_USER
  The user does not exist
  Parameters:
  
  user - The UserSnowflake for the user to ban. This can be a member or user instance or User.fromId(long).
  
  deletionTimeframe - The timeframe for the history of messages that will be deleted. (seconds precision)
  
  unit - Timeframe unit as a TimeUnit (for example ban(user, 7, TimeUnit.DAYS)).
  
  Returns:
  
  AuditableRestAction
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.BAN_MEMBERS permission.
  
  HierarchyException - If the logged in account cannot ban the other user due to permission hierarchy position.
  See Member.canInteract(Member)
  
  IllegalArgumentException -
  
  If the provided deletionTimeframe is negative.
  
  If the provided deletionTimeframe is longer than 7 days.
  
  If the provided user or time unit is null
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  AuditableRestAction.reason(String)
- ban
  
  @Nonnull @CheckReturnValue AuditableRestAction<BulkBanResponse> ban(@Nonnull Collection<? extends UserSnowflake> users, @Nullable Duration deletionTime)
  Bans up to 200 of the provided users.
  To set a ban reason, use AuditableRestAction.reason(String).
  The BulkBanResponse includes a list of failed users, which is populated with users that could not be banned, for instance due to some internal server error or permission issues. This list of failed users also includes all users that were already banned.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The target Member cannot be banned due to a permission discrepancy
  
  FAILED_TO_BAN_USERS
  None of the users could be banned
  Parameters:
  
  users - The users to ban
  
  deletionTime - Delete recent messages of the given timeframe (for instance the last hour with Duration.ofHours(1))
  
  Returns:
  
  AuditableRestAction - Type: BulkBanResponse
  
  Throws:
  
  HierarchyException - If any of the provided users is the guild owner or has a higher or equal role position
  
  InsufficientPermissionException - If the bot does not have Permission.BAN_MEMBERS or Permission.MANAGE_SERVER
  
  IllegalArgumentException -
  
  If the users collection is null or contains null
  
  If the deletionTime is negative
  
  DetachedEntityException - If this entity is detached
- ban
  
  @Nonnull @CheckReturnValue default AuditableRestAction<BulkBanResponse> ban(@Nonnull Collection<? extends UserSnowflake> users, int deletionTimeframe, @Nonnull TimeUnit unit)
  Bans up to 200 of the provided users.
  To set a ban reason, use AuditableRestAction.reason(String).
  The BulkBanResponse includes a list of failed users, which is populated with users that could not be banned, for instance due to some internal server error or permission issues. This list of failed users also includes all users that were already banned.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The target Member cannot be banned due to a permission discrepancy
  
  FAILED_TO_BAN_USERS
  None of the users could be banned
  Parameters:
  
  users - The users to ban
  
  deletionTimeframe - The timeframe for the history of messages that will be deleted. (seconds precision)
  
  unit - Timeframe unit as a TimeUnit (for example ban(user, 7, TimeUnit.DAYS)).
  
  Returns:
  
  AuditableRestAction - Type: BulkBanResponse
  
  Throws:
  
  HierarchyException - If any of the provided users is the guild owner or has a higher or equal role position
  
  InsufficientPermissionException - If the bot does not have Permission.BAN_MEMBERS or Permission.MANAGE_SERVER
  
  IllegalArgumentException -
  
  If null is provided
  
  If the deletionTimeframe is negative
  
  DetachedEntityException - If this entity is detached
- unban
  
  @Nonnull @CheckReturnValue AuditableRestAction<Void> unban(@Nonnull UserSnowflake user)
  Unbans the specified UserSnowflake from this Guild.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The target Member cannot be unbanned due to a permission discrepancy
  
  UNKNOWN_BAN
  The specified User is not banned from the current Guild
  
  UNKNOWN_USER
  The specified User does not exist
  Parameters:
  
  user - The UserSnowflake to unban. This can be a member or user instance or User.fromId(long).
  
  Returns:
  
  AuditableRestAction
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.BAN_MEMBERS permission.
  
  IllegalArgumentException - If the provided user is null
  
  DetachedEntityException - If this entity is detached
- timeoutFor
  
  @Nonnull @CheckReturnValue default AuditableRestAction<Void> timeoutFor(@Nonnull UserSnowflake user, long amount, @Nonnull TimeUnit unit)
  Puts the specified Member in time out in this Guild for a specific amount of time.
  While a Member is in time out, they cannot send messages, reply, react, or speak in voice channels.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The target Member cannot be put into time out due to a permission discrepancy
  
  UNKNOWN_MEMBER
  The specified Member was removed from the Guild before finishing the task
  Parameters:
  
  user - The UserSnowflake to timeout. This can be a member or user instance or User.fromId(long).
  
  amount - The amount of the provided unit to put the specified Member in time out for
  
  unit - The Unit type of amount
  
  Returns:
  
  AuditableRestAction
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MODERATE_MEMBERS permission.
  
  HierarchyException - If the logged in account cannot put a timeout on the other Member due to permission hierarchy position. (See Member.canInteract(Member))
  
  IllegalArgumentException - If any of the following checks are true
  
  The provided user is null
  
  The provided amount is lower than or equal to 0
  
  The provided unit is null
  
  The provided amount with the unit results in a date that is more than 28 days in the future
  
  DetachedEntityException - If this entity is detached
- timeoutFor
  
  @Nonnull @CheckReturnValue default AuditableRestAction<Void> timeoutFor(@Nonnull UserSnowflake user, @Nonnull Duration duration)
  Puts the specified Member in time out in this Guild for a specific amount of time.
  While a Member is in time out, all permissions except VIEW_CHANNEL and MESSAGE_HISTORY are removed from them.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The target Member cannot be put into time out due to a permission discrepancy
  
  UNKNOWN_MEMBER
  The specified Member was removed from the Guild before finishing the task
  Parameters:
  
  user - The UserSnowflake to timeout. This can be a member or user instance or User.fromId(long).
  
  duration - The duration to put the specified Member in time out for
  
  Returns:
  
  AuditableRestAction
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MODERATE_MEMBERS permission.
  
  HierarchyException - If the logged in account cannot put a timeout on the other Member due to permission hierarchy position.
  See Member.canInteract(Member)
  
  IllegalArgumentException - If any of the following checks are true
  
  The provided user is null
  
  The provided duration is null
  
  The provided duration results in a date that is more than 28 days in the future
  
  DetachedEntityException - If this entity is detached
- timeoutUntil
  
  @Nonnull @CheckReturnValue AuditableRestAction<Void> timeoutUntil(@Nonnull UserSnowflake user, @Nonnull TemporalAccessor temporal)
  Puts the specified Member in time out in this Guild until the specified date.
  While a Member is in time out, all permissions except VIEW_CHANNEL and MESSAGE_HISTORY are removed from them.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The target Member cannot be put into time out due to a permission discrepancy
  
  UNKNOWN_MEMBER
  The specified Member was removed from the Guild before finishing the task
  Parameters:
  
  user - The UserSnowflake to timeout. This can be a member or user instance or User.fromId(long).
  
  temporal - The time the specified Member will be released from time out
  
  Returns:
  
  AuditableRestAction
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MODERATE_MEMBERS permission.
  
  HierarchyException - If the logged in account cannot put a timeout on the other Member due to permission hierarchy position. (See Member.canInteract(Member))
  
  IllegalArgumentException - If any of the following are true
  
  The provided user is null
  
  The provided temporal is null
  
  The provided temporal is in the past
  
  The provided temporal is more than 28 days in the future
  
  DetachedEntityException - If this entity is detached
- removeTimeout
  
  @Nonnull @CheckReturnValue AuditableRestAction<Void> removeTimeout(@Nonnull UserSnowflake user)
  Removes a time out from the specified Member in this Guild.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The time out cannot be removed due to a permission discrepancy
  
  UNKNOWN_MEMBER
  The specified Member was removed from the Guild before finishing the task
  Parameters:
  
  user - The UserSnowflake to timeout. This can be a member or user instance or User.fromId(long).
  
  Returns:
  
  AuditableRestAction
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MODERATE_MEMBERS permission.
  
  HierarchyException - If the logged in account cannot remove the timeout from the other Member due to permission hierarchy position. (See Member.canInteract(Member))
  
  DetachedEntityException - If this entity is detached
- deafen
  
  @Nonnull @CheckReturnValue AuditableRestAction<Void> deafen(@Nonnull UserSnowflake user, boolean deafen)
  Sets the Guild Deafened state of the Member based on the provided boolean.
  Note: The Member's GuildVoiceState.isGuildDeafened() value won't change until JDA receives the GuildVoiceGuildDeafenEvent event related to this change.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The target Member cannot be deafened due to a permission discrepancy
  
  UNKNOWN_MEMBER
  The specified Member was removed from the Guild before finishing the task
  
  USER_NOT_CONNECTED
  The specified Member is not connected to a voice channel
  Parameters:
  
  user - The UserSnowflake who's GuildVoiceState to change. This can be a member or user instance or User.fromId(long).
  
  deafen - Whether this Member should be deafened or undeafened.
  
  Returns:
  
  AuditableRestAction
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.VOICE_DEAF_OTHERS permission in the given channel.
  
  IllegalArgumentException - If the provided user is null.
  
  IllegalStateException - If the provided user is not currently connected to a voice channel.
  
  DetachedEntityException - If this entity is detached
- mute
  
  @Nonnull @CheckReturnValue AuditableRestAction<Void> mute(@Nonnull UserSnowflake user, boolean mute)
  Sets the Guild Muted state of the Member based on the provided boolean.
  Note: The Member's GuildVoiceState.isGuildMuted() value won't change until JDA receives the GuildVoiceGuildMuteEvent event related to this change.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The target Member cannot be muted due to a permission discrepancy
  
  UNKNOWN_MEMBER
  The specified Member was removed from the Guild before finishing the task
  
  USER_NOT_CONNECTED
  The specified Member is not connected to a voice channel
  Parameters:
  
  user - The UserSnowflake who's GuildVoiceState to change. This can be a member or user instance or User.fromId(long).
  
  mute - Whether this Member should be muted or unmuted.
  
  Returns:
  
  AuditableRestAction
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.VOICE_DEAF_OTHERS permission in the given channel.
  
  IllegalArgumentException - If the provided user is null.
  
  IllegalStateException - If the provided user is not currently connected to a voice channel.
  
  DetachedEntityException - If this entity is detached
- addRoleToMember
  
  @Nonnull @CheckReturnValue AuditableRestAction<Void> addRoleToMember(@Nonnull UserSnowflake user, @Nonnull Role role)
  Atomically assigns the provided Role to the specified Member.
  This can be used together with other role modification methods as it does not require an updated cache!
  If multiple roles should be added/removed (efficiently) in one request you may use modifyMemberRoles(Member, Collection, Collection) or similar methods.
  If the specified role is already present in the member's set of roles this does nothing.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The Members Roles could not be modified due to a permission discrepancy
  
  UNKNOWN_MEMBER
  The target Member was removed from the Guild before finishing the task
  
  UNKNOWN_ROLE
  If the specified Role does not exist
  Parameters:
  
  user - The UserSnowflake to change roles for. This can be a member or user instance or User.fromId(long).
  
  role - The role which should be assigned atomically
  
  Returns:
  
  AuditableRestAction
  
  Throws:
  
  IllegalArgumentException -
  
  If the specified member or role are not from the current Guild
  
  Either member or role are null
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_ROLES
  
  HierarchyException - If the provided roles are higher in the Guild's hierarchy and thus cannot be modified by the currently logged in account
  
  DetachedEntityException - If this entity is detached
- removeRoleFromMember
  
  @Nonnull @CheckReturnValue AuditableRestAction<Void> removeRoleFromMember(@Nonnull UserSnowflake user, @Nonnull Role role)
  Atomically removes the provided Role from the specified Member.
  This can be used together with other role modification methods as it does not require an updated cache!
  If multiple roles should be added/removed (efficiently) in one request you may use modifyMemberRoles(Member, Collection, Collection) or similar methods.
  If the specified role is not present in the member's set of roles this does nothing.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The Members Roles could not be modified due to a permission discrepancy
  
  UNKNOWN_MEMBER
  The target Member was removed from the Guild before finishing the task
  
  UNKNOWN_ROLE
  If the specified Role does not exist
  Parameters:
  
  user - The UserSnowflake to change roles for. This can be a member or user instance or User.fromId(long).
  
  role - The role which should be removed atomically
  
  Returns:
  
  AuditableRestAction
  
  Throws:
  
  IllegalArgumentException -
  
  If the specified member or role are not from the current Guild
  
  Either member or role are null
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_ROLES
  
  HierarchyException - If the provided roles are higher in the Guild's hierarchy and thus cannot be modified by the currently logged in account
  
  DetachedEntityException - If this entity is detached
- modifyMemberRoles
  
  @Nonnull @CheckReturnValue AuditableRestAction<Void> modifyMemberRoles(@Nonnull Member member, @Nullable Collection<Role> rolesToAdd, @Nullable Collection<Role> rolesToRemove)
  Modifies the Roles of the specified Member by adding and removing a collection of roles.
  None of the provided roles may be the Public Role of the current Guild.
  If a role is both in rolesToAdd and rolesToRemove it will be removed.
  Example
  
  public static void promote(Member member) { Guild guild = member.getGuild(); List<Role> pleb = guild.getRolesByName("Pleb", true); // remove all roles named "pleb" List<Role> knight = guild.getRolesByName("Knight", true); // add all roles named "knight" // update roles in single request guild.modifyMemberRoles(member, knight, pleb).queue(); }
  
  Warning
  This may not be used together with any other role add/remove/modify methods for the same Member within one event listener cycle! The changes made by this require cache updates which are triggered by lifecycle events which are received later. This may only be called again once the specific Member has been updated by a GenericGuildMemberEvent targeting the same Member.
  This is logically equivalent to:
  Set<Role> roles = new HashSet<>(member.getRoles()); roles.addAll(rolesToAdd); roles.removeAll(rolesToRemove); RestAction<Void> action = guild.modifyMemberRoles(member, roles);
  
  You can use addRoleToMember(UserSnowflake, Role) and removeRoleFromMember(UserSnowflake, Role) to make updates independent of the cache.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The Members Roles could not be modified due to a permission discrepancy
  
  UNKNOWN_MEMBER
  The target Member was removed from the Guild before finishing the task
  Parameters:
  
  member - The Member that should be modified
  
  rolesToAdd - A Collection of Roles to add to the current Roles the specified Member already has, or null
  
  rolesToRemove - A Collection of Roles to remove from the current Roles the specified Member already has, or null
  
  Returns:
  
  AuditableRestAction
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_ROLES
  
  HierarchyException - If the provided roles are higher in the Guild's hierarchy and thus cannot be modified by the currently logged in account
  
  IllegalArgumentException -
  
  If the target member is null
  
  If any of the specified Roles is managed or is the Public Role of the Guild
  
  DetachedEntityException - If this entity is detached
- modifyMemberRoles
  
  @Nonnull @CheckReturnValue default AuditableRestAction<Void> modifyMemberRoles(@Nonnull Member member, @Nonnull Role... roles)
  Modifies the complete Role set of the specified Member
  The provided roles will replace all current Roles of the specified Member.
  Warning
  This may not be used together with any other role add/remove/modify methods for the same Member within one event listener cycle! The changes made by this require cache updates which are triggered by lifecycle events which are received later. This may only be called again once the specific Member has been updated by a GenericGuildMemberEvent targeting the same Member.
  The new roles must not contain the Public Role of the Guild
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The Members Roles could not be modified due to a permission discrepancy
  
  UNKNOWN_MEMBER
  The target Member was removed from the Guild before finishing the task
  
  Example
  
  public static void removeRoles(Member member) { Guild guild = member.getGuild(); // pass no role, this means we set the roles of the member to an empty array. guild.modifyMemberRoles(member).queue(); }
  Parameters:
  
  member - A Member of which to override the Roles of
  
  roles - New collection of Roles for the specified Member
  
  Returns:
  
  AuditableRestAction
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_ROLES
  
  HierarchyException - If the provided roles are higher in the Guild's hierarchy and thus cannot be modified by the currently logged in account
  
  IllegalArgumentException -
  
  If any of the provided arguments is null
  
  If any of the provided arguments is not from this Guild
  
  If any of the specified Roles is managed
  
  If any of the specified Roles is the Public Role of this Guild
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  modifyMemberRoles(Member, Collection)
- modifyMemberRoles
  
  @Nonnull @CheckReturnValue AuditableRestAction<Void> modifyMemberRoles(@Nonnull Member member, @Nonnull Collection<Role> roles)
  Modifies the complete Role set of the specified Member
  The provided roles will replace all current Roles of the specified Member.
  The new roles must not contain the Public Role of the Guild
  Warning
  This may not be used together with any other role add/remove/modify methods for the same Member within one event listener cycle! The changes made by this require cache updates which are triggered by lifecycle events which are received later. This may only be called again once the specific Member has been updated by a GenericGuildMemberEvent targeting the same Member.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The Members Roles could not be modified due to a permission discrepancy
  
  UNKNOWN_MEMBER
  The target Member was removed from the Guild before finishing the task
  
  Example
  
  public static void makeModerator(Member member) { Guild guild = member.getGuild(); List<Role> roles = new ArrayList<>(member.getRoles()); // modifiable copy List<Role> modRoles = guild.getRolesByName("moderator", true); // get roles with name "moderator" roles.addAll(modRoles); // add new roles // update the member with new roles guild.modifyMemberRoles(member, roles).queue(); }
  Parameters:
  
  member - A Member of which to override the Roles of
  
  roles - New collection of Roles for the specified Member
  
  Returns:
  
  AuditableRestAction
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_ROLES
  
  HierarchyException - If the provided roles are higher in the Guild's hierarchy and thus cannot be modified by the currently logged in account
  
  IllegalArgumentException -
  
  If any of the provided arguments is null
  
  If any of the provided arguments is not from this Guild
  
  If any of the specified Roles is managed
  
  If any of the specified Roles is the Public Role of this Guild
  
  DetachedEntityException - If this entity is detached
  
  See Also:
  
  modifyMemberRoles(Member, Collection)
- transferOwnership
  
  @Nonnull @CheckReturnValue AuditableRestAction<Void> transferOwnership(@Nonnull Member newOwner)
  Transfers the Guild ownership to the specified Member
  Only available if the currently logged in account is the owner of this Guild
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The currently logged in account lost ownership before completing the task
  
  UNKNOWN_MEMBER
  The target Member was removed from the Guild before finishing the task
  Parameters:
  
  newOwner - Not-null Member to transfer ownership to
  
  Returns:
  
  AuditableRestAction
  
  Throws:
  
  PermissionException - If the currently logged in account is not the owner of this Guild
  
  IllegalArgumentException -
  
  If the specified Member is null or not from the same Guild
  
  If the specified Member already is the Guild owner
  
  DetachedEntityException - If this entity is detached
- createTextChannel
  
  @Nonnull @CheckReturnValue default ChannelAction<TextChannel> createTextChannel(@Nonnull String name)
  Creates a new TextChannel in this Guild. For this to be successful, the logged in account has to have the MANAGE_CHANNEL Permission
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MAX_CHANNELS
  The maximum number of channels were exceeded
  Parameters:
  
  name - The name of the TextChannel to create (up to 100 characters)
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new TextChannel before creating it
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_CHANNEL permission
  
  IllegalArgumentException - If the provided name is null, blank, or longer than 100 characters
  
  DetachedEntityException - If this entity is detached
- createTextChannel
  
  @Nonnull @CheckReturnValue ChannelAction<TextChannel> createTextChannel(@Nonnull String name, @Nullable Category parent)
  Creates a new TextChannel in this Guild. For this to be successful, the logged in account has to have the MANAGE_CHANNEL Permission
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MAX_CHANNELS
  The maximum number of channels were exceeded
  Parameters:
  
  name - The name of the TextChannel to create (up to 100 characters)
  
  parent - The optional parent category for this channel, or null
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new TextChannel before creating it
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_CHANNEL permission
  
  IllegalArgumentException - If the provided name is null, blank, or longer than 100 characters; or the provided parent is not in the same guild.
  
  DetachedEntityException - If this entity is detached
- createNewsChannel
  
  @Nonnull @CheckReturnValue default ChannelAction<NewsChannel> createNewsChannel(@Nonnull String name)
  Creates a new NewsChannel in this Guild. For this to be successful, the logged in account has to have the MANAGE_CHANNEL Permission
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MAX_CHANNELS
  The maximum number of channels were exceeded
  Parameters:
  
  name - The name of the NewsChannel to create (up to 100 characters)
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new NewsChannel before creating it
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_CHANNEL permission
  
  IllegalArgumentException - If the provided name is null, blank, or longer than 100 characters
  
  DetachedEntityException - If this entity is detached
- createNewsChannel
  
  @Nonnull @CheckReturnValue ChannelAction<NewsChannel> createNewsChannel(@Nonnull String name, @Nullable Category parent)
  Creates a new NewsChannel in this Guild. For this to be successful, the logged in account has to have the MANAGE_CHANNEL Permission
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MAX_CHANNELS
  The maximum number of channels were exceeded
  Parameters:
  
  name - The name of the NewsChannel to create (up to 100 characters)
  
  parent - The optional parent category for this channel, or null
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new NewsChannel before creating it
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_CHANNEL permission
  
  IllegalArgumentException - If the provided name is null, blank, or longer than 100 characters; or the provided parent is not in the same guild.
  
  DetachedEntityException - If this entity is detached
- createVoiceChannel
  
  @Nonnull @CheckReturnValue default ChannelAction<VoiceChannel> createVoiceChannel(@Nonnull String name)
  Creates a new VoiceChannel in this Guild. For this to be successful, the logged in account has to have the MANAGE_CHANNEL Permission.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MAX_CHANNELS
  The maximum number of channels were exceeded
  Parameters:
  
  name - The name of the VoiceChannel to create (up to 100 characters)
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new VoiceChannel before creating it
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_CHANNEL permission
  
  IllegalArgumentException - If the provided name is null, blank, or longer than 100 characters
  
  DetachedEntityException - If this entity is detached
- createVoiceChannel
  
  @Nonnull @CheckReturnValue ChannelAction<VoiceChannel> createVoiceChannel(@Nonnull String name, @Nullable Category parent)
  Creates a new VoiceChannel in this Guild. For this to be successful, the logged in account has to have the MANAGE_CHANNEL Permission.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MAX_CHANNELS
  The maximum number of channels were exceeded
  Parameters:
  
  name - The name of the VoiceChannel to create (up to 100 characters)
  
  parent - The optional parent category for this channel, or null
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new VoiceChannel before creating it
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_CHANNEL permission
  
  IllegalArgumentException - If the provided name is null, blank, or longer than 100 characters; or the provided parent is not in the same guild.
  
  DetachedEntityException - If this entity is detached
- createStageChannel
  
  @Nonnull @CheckReturnValue default ChannelAction<StageChannel> createStageChannel(@Nonnull String name)
  Creates a new StageChannel in this Guild. For this to be successful, the logged in account has to have the MANAGE_CHANNEL Permission.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MAX_CHANNELS
  The maximum number of channels were exceeded
  Parameters:
  
  name - The name of the StageChannel to create (up to 100 characters)
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new StageChannel before creating it
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_CHANNEL permission
  
  IllegalArgumentException - If the provided name is null, blank, or longer than 100 characters
  
  DetachedEntityException - If this entity is detached
- createStageChannel
  
  @Nonnull @CheckReturnValue ChannelAction<StageChannel> createStageChannel(@Nonnull String name, @Nullable Category parent)
  Creates a new StageChannel in this Guild. For this to be successful, the logged in account has to have the MANAGE_CHANNEL Permission.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MAX_CHANNELS
  The maximum number of channels were exceeded
  Parameters:
  
  name - The name of the StageChannel to create (up to 100 characters)
  
  parent - The optional parent category for this channel, or null
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new StageChannel before creating it
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_CHANNEL permission
  
  IllegalArgumentException - If the provided name is null, blank, or longer than 100 characters; or the provided parent is not in the same guild.
  
  DetachedEntityException - If this entity is detached
- createForumChannel
  
  @Nonnull @CheckReturnValue default ChannelAction<ForumChannel> createForumChannel(@Nonnull String name)
  Creates a new ForumChannel in this Guild. For this to be successful, the logged in account has to have the MANAGE_CHANNEL Permission.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MAX_CHANNELS
  The maximum number of channels were exceeded
  Parameters:
  
  name - The name of the ForumChannel to create (up to 100 characters)
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new ForumChannel before creating it
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_CHANNEL permission
  
  IllegalArgumentException - If the provided name is null, blank, or longer than 100 characters
  
  DetachedEntityException - If this entity is detached
- createForumChannel
  
  @Nonnull @CheckReturnValue ChannelAction<ForumChannel> createForumChannel(@Nonnull String name, @Nullable Category parent)
  Creates a new ForumChannel in this Guild. For this to be successful, the logged in account has to have the MANAGE_CHANNEL Permission.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MAX_CHANNELS
  The maximum number of channels were exceeded
  Parameters:
  
  name - The name of the ForumChannel to create (up to 100 characters)
  
  parent - The optional parent category for this channel, or null
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new ForumChannel before creating it
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_CHANNEL permission
  
  IllegalArgumentException - If the provided name is null, blank, or longer than 100 characters; or the provided parent is not in the same guild.
  
  DetachedEntityException - If this entity is detached
- createMediaChannel
  
  @Nonnull @CheckReturnValue default ChannelAction<MediaChannel> createMediaChannel(@Nonnull String name)
  Creates a new MediaChannel in this Guild. For this to be successful, the logged in account has to have the MANAGE_CHANNEL Permission.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MAX_CHANNELS
  The maximum number of channels were exceeded
  Parameters:
  
  name - The name of the MediaChannel to create (up to 100 characters)
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new MediaChannel before creating it
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_CHANNEL permission
  
  IllegalArgumentException - If the provided name is null, blank, or longer than 100 characters
  
  DetachedEntityException - If this entity is detached
- createMediaChannel
  
  @Nonnull @CheckReturnValue ChannelAction<MediaChannel> createMediaChannel(@Nonnull String name, @Nullable Category parent)
  Creates a new MediaChannel in this Guild. For this to be successful, the logged in account has to have the MANAGE_CHANNEL Permission.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MAX_CHANNELS
  The maximum number of channels were exceeded
  Parameters:
  
  name - The name of the MediaChannel to create (up to 100 characters)
  
  parent - The optional parent category for this channel, or null
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new MediaChannel before creating it
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_CHANNEL permission
  
  IllegalArgumentException - If the provided name is null, blank, or longer than 100 characters; or the provided parent is not in the same guild.
  
  DetachedEntityException - If this entity is detached
- createCategory
  
  @Nonnull @CheckReturnValue ChannelAction<Category> createCategory(@Nonnull String name)
  Creates a new Category in this Guild. For this to be successful, the logged in account has to have the MANAGE_CHANNEL Permission.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MAX_CHANNELS
  The maximum number of channels were exceeded
  Parameters:
  
  name - The name of the Category to create (up to 100 characters)
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new Category before creating it
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_CHANNEL permission
  
  IllegalArgumentException - If the provided name is null, blank, or longer than 100 characters
  
  DetachedEntityException - If this entity is detached
- createCopyOfChannel
  
  @Nonnull @CheckReturnValue default <T extends ICopyableChannel> ChannelAction<T> createCopyOfChannel(@Nonnull T channel)
  Creates a copy of the specified GuildChannel in this Guild.
  The provided channel need not be in the same Guild for this to work!
  This copies the following elements:
  
  Name
  
  Parent Category (if present)
  
  Voice Elements (Bitrate, Userlimit)
  
  Text Elements (Topic, NSFW)
  
  All permission overrides for Members/Roles
  
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The channel could not be created due to a permission discrepancy
  
  MAX_CHANNELS
  The maximum number of channels were exceeded
  Type Parameters:
  
  T - The channel type
  
  Parameters:
  
  channel - The GuildChannel to use for the copy template
  
  Returns:
  
  A specific ChannelAction
  This action allows to set fields for the new GuildChannel before creating it!
  
  Throws:
  
  IllegalArgumentException - If the provided channel is null
  
  InsufficientPermissionException - If the currently logged in account does not have the MANAGE_CHANNEL Permission
  
  DetachedEntityException - If this entity is detached
  
  Since:
  
  3.1
  
  See Also:
  
  createTextChannel(String)
  
  createVoiceChannel(String)
  
  ChannelAction
- createRole
  
  @Nonnull @CheckReturnValue RoleAction createRole()
  Creates a new Role in this Guild.
  It will be placed at the bottom (just over the Public Role) to avoid permission hierarchy conflicts.
  For this to be successful, the logged in account has to have the MANAGE_ROLES Permission
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The role could not be created due to a permission discrepancy
  
  MAX_ROLES_PER_GUILD
  There are too many roles in this Guild
  Returns:
  
  RoleAction
  Creates a new role with previously selected field values
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_ROLES Permission
  
  DetachedEntityException - If this entity is detached
- createCopyOfRole
  
  @Nonnull @CheckReturnValue default RoleAction createCopyOfRole(@Nonnull Role role)
  Creates a new Role in this Guild with the same settings as the given Role.
  The position of the specified Role does not matter in this case!
  It will be placed at the bottom (just over the Public Role) to avoid permission hierarchy conflicts.
  For this to be successful, the logged in account has to have the MANAGE_ROLES Permission and all Permissions the given Role has.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The role could not be created due to a permission discrepancy
  
  MAX_ROLES_PER_GUILD
  There are too many roles in this Guild
  Parameters:
  
  role - The Role that should be copied
  
  Returns:
  
  RoleAction
  RoleAction with already copied values from the specified Role
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the Permission.MANAGE_ROLES Permission and every Permission the provided Role has
  
  IllegalArgumentException - If the specified role is null
  
  DetachedEntityException - If this entity is detached
- createEmoji
  
  @Nonnull @CheckReturnValue AuditableRestAction<RichCustomEmoji> createEmoji(@Nonnull String name, @Nonnull Icon icon, @Nonnull Role... roles)
  Creates a new RichCustomEmoji in this Guild.
  If one or more Roles are specified the new emoji will only be available to Members with any of the specified Roles (see Member.canInteract(RichCustomEmoji))
  For this to be successful, the logged in account has to have the MANAGE_GUILD_EXPRESSIONS Permission.
  Unicode emojis are not included as RichCustomEmoji!
  Note that a guild is limited to 50 normal and 50 animated emojis by default. Some guilds are able to add additional emojis beyond this limitation due to the MORE_EMOJI feature (see Guild.getFeatures()).
  Due to simplicity we do not check for these limits.
  Possible ErrorResponses caused by the returned RestAction include the following:
  
  MISSING_PERMISSIONS
  The emoji could not be created due to a permission discrepancy
  Parameters:
  
  name - The name for the new emoji
  
  icon - The Icon for the new emoji
  
  roles - The Roles the new emoji should be restricted to
  If no roles are provided the emoji will be available to all Members of this Guild
  
  Returns:
  
  AuditableRestAction - Type: RichCustomEmoji
  
  Throws:
  
  InsufficientPermissionException - If the logged in account does not have the MANAGE_GUILD_EXPRESSIONS Permission
  
  DetachedEntityException - If this entity is detached
- createSticker
  
  @Nonnull @CheckReturnValue AuditableRestAction<GuildSticker> createSticker(@Nonnull String name, @Nonnull String description, @Nonnull FileUpload file, @Nonnull Collection<String> tags)
  Creates a new GuildSticker in this Guild.
  Possible ErrorResponses include:
  
  INVALID_FILE_UPLOADED
  The sticker file asset is not in a supported file format
  
  MISSING_PERMISSIONS
  The sticker could not be created due to a permission discrepancy
  Parameters:
  
  name - The sticker name (2-30 characters)
  
  description - The sticker description (2-100 characters, or empty)
  
  file - The sticker file containing the asset (png/apng/gif/lottie) with valid file extension (png, gif, or json)
  
  tags - The tags to use for auto-suggestions (Up to 200 characters in total)
  
  Returns:
  
  AuditableRestAction - Type: GuildSticker
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have the MANAGE_GUILD_EXPRESSIONS permission
  
  IllegalArgumentException -
  
  If the name is not between 2 and 30 characters long
  
  If the description is more than 100 characters long or exactly 1 character long
  
  If the asset file is null or of an invalid format (must be PNG, GIF, or LOTTIE)
  
  If anything is null
  
  DetachedEntityException - If this entity is detached
- createSticker
  
  @Nonnull @CheckReturnValue default AuditableRestAction<GuildSticker> createSticker(@Nonnull String name, @Nonnull String description, @Nonnull FileUpload file, @Nonnull String tag, @Nonnull String... tags)
  Creates a new GuildSticker in this Guild.
  Possible ErrorResponses include:
  
  INVALID_FILE_UPLOADED
  The sticker file asset is not in a supported file format
  
  MISSING_PERMISSIONS
  The sticker could not be created due to a permission discrepancy
  Parameters:
  
  name - The sticker name (2-30 characters)
  
  description - The sticker description (2-100 characters, or empty)
  
  file - The sticker file containing the asset (png/apng/gif/lottie) with valid file extension (png, gif, or json)
  
  tag - The sticker tag used for suggestions (emoji or tag words)
  
  tags - Additional tags to use for suggestions
  
  Returns:
  
  AuditableRestAction - Type: GuildSticker
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have the MANAGE_GUILD_EXPRESSIONS permission
  
  IllegalArgumentException -
  
  If the name is not between 2 and 30 characters long
  
  If the description is more than 100 characters long or exactly 1 character long
  
  If the asset file is null or of an invalid format (must be PNG, GIF, or LOTTIE)
  
  If anything is null
  
  DetachedEntityException - If this entity is detached
- deleteSticker
  
  @Nonnull @CheckReturnValue AuditableRestAction<Void> deleteSticker(@Nonnull StickerSnowflake id)
  Deletes a sticker from the guild.
  The returned RestAction can encounter the following Discord errors:
  
  UNKNOWN_STICKER
  Occurs when the provided id does not refer to a sticker known by Discord.
  Returns:
  
  AuditableRestAction
  
  Throws:
  
  IllegalStateException - If null is provided
  
  InsufficientPermissionException - If the currently logged in account does not have MANAGE_GUILD_EXPRESSIONS in the guild.
  
  DetachedEntityException - If this entity is detached
- createScheduledEvent
  
  @Nonnull @CheckReturnValue ScheduledEventAction createScheduledEvent(@Nonnull String name, @Nonnull String location, @Nonnull OffsetDateTime startTime, @Nonnull OffsetDateTime endTime)
  Creates a new ScheduledEvent. Events created with this method will be of Type.EXTERNAL. These events are set to take place at an external location.
  Requirements
  Events are required to have a name, location and start time. Additionally, an end time must also be specified for events of Type.EXTERNAL. Permission.MANAGE_EVENTS is required on the guild level in order to create this type of event.
  Example
  
  guild.createScheduledEvent("Cactus Beauty Contest", "Mike's Backyard", OffsetDateTime.now().plusHours(1), OffsetDateTime.now().plusHours(3)) .setDescription("Come and have your cacti judged! _Must be spikey to enter_") .queue();
  Parameters:
  
  name - the name for this scheduled event, 1-100 characters
  
  location - the external location for this scheduled event, 1-100 characters
  
  startTime - the start time for this scheduled event, can't be in the past or after the end time
  
  endTime - the end time for this scheduled event, has to be later than the start time
  
  Returns:
  
  ScheduledEventAction
  
  Throws:
  
  IllegalArgumentException -
  
  If a required parameter is null or empty
  
  If the start time is in the past
  
  If the end time is before the start time
  
  If the name is longer than 100 characters
  
  If the description is longer than 1000 characters
  
  If the location is longer than 100 characters
  
  DetachedEntityException - If this entity is detached
- createScheduledEvent
  
  @Nonnull @CheckReturnValue ScheduledEventAction createScheduledEvent(@Nonnull String name, @Nonnull GuildChannel channel, @Nonnull OffsetDateTime startTime)
  Creates a new ScheduledEvent.
  Requirements
  Events are required to have a name, channel and start time. Depending on the type of channel provided, an event will be of one of two different Types:
  
  Type.STAGE_INSTANCE
  These events are set to take place inside of a StageChannel. The following permissions are required in the specified stage channel in order to create an event there:
  
  Permission.MANAGE_EVENTS
  
  Permission.MANAGE_CHANNEL
  
  Permission.VOICE_MUTE_OTHERS
  
  Permission.VOICE_MOVE_OTHERS}
  
  Type.VOICE
  These events are set to take place inside of a VoiceChannel. The following permissions are required in the specified voice channel in order to create an event there:
  
  Permission.MANAGE_EVENTS
  
  Permission.VIEW_CHANNEL
  
  Permission.VOICE_CONNECT
  
  Example
  
  guild.createScheduledEvent("Cactus Beauty Contest", guild.getGuildChannelById(channelId), OffsetDateTime.now().plusHours(1)) .setDescription("Come and have your cacti judged! _Must be spikey to enter_") .queue();
  Parameters:
  
  name - the name for this scheduled event, 1-100 characters
  
  channel - the voice or stage channel where this scheduled event will take place
  
  startTime - the start time for this scheduled event, can't be in the past
  
  Returns:
  
  ScheduledEventAction
  
  Throws:
  
  IllegalArgumentException -
  
  If a required parameter is null or empty
  
  If the start time is in the past
  
  If the name is longer than 100 characters
  
  If the description is longer than 1000 characters
  
  If the channel is not a Stage or Voice channel
  
  If the channel is not from the same guild as the scheduled event
  
  DetachedEntityException - If this entity is detached
- modifyCategoryPositions
  
  @Nonnull @CheckReturnValue ChannelOrderAction modifyCategoryPositions()
  Modifies the positional order of Guild.getCategories() using a specific RestAction extension to allow moving Channels up/down or to a specific position.
  This uses ascending order with a 0 based index.
  Possible ErrorResponses include:
  
  UNNKOWN_CHANNEL
  One of the channels has been deleted before the completion of the task
  
  MISSING_ACCESS
  The currently logged in account was removed from the Guild
  Returns:
  
  ChannelOrderAction - Type: Category
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- modifyTextChannelPositions
  
  @Nonnull @CheckReturnValue ChannelOrderAction modifyTextChannelPositions()
  Modifies the positional order of Guild.getTextChannels() using a specific RestAction extension to allow moving Channels up/down or to a specific position.
  This uses ascending order with a 0 based index.
  Possible ErrorResponses include:
  
  UNNKOWN_CHANNEL
  One of the channels has been deleted before the completion of the task
  
  MISSING_ACCESS
  The currently logged in account was removed from the Guild
  Returns:
  
  ChannelOrderAction - Type: TextChannel
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- modifyVoiceChannelPositions
  
  @Nonnull @CheckReturnValue ChannelOrderAction modifyVoiceChannelPositions()
  Modifies the positional order of Guild.getVoiceChannels() using a specific RestAction extension to allow moving Channels up/down or to a specific position.
  This uses ascending order with a 0 based index.
  Possible ErrorResponses include:
  
  UNNKOWN_CHANNEL
  One of the channels has been deleted before the completion of the task
  
  MISSING_ACCESS
  The currently logged in account was removed from the Guild
  Returns:
  
  ChannelOrderAction - Type: VoiceChannel
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- modifyTextChannelPositions
  
  @Nonnull @CheckReturnValue CategoryOrderAction modifyTextChannelPositions(@Nonnull Category category)
  Modifies the positional order of Category#getTextChannels() using an extension of ChannelOrderAction specialized for ordering the nested TextChannels of this Category.
  Like ChannelOrderAction, the returned CategoryOrderAction can be used to move TextChannels up, down, or to a specific position.
  This uses ascending order with a 0 based index.
  Possible ErrorResponses include:
  
  UNNKOWN_CHANNEL
  One of the channels has been deleted before the completion of the task.
  
  MISSING_ACCESS
  The currently logged in account was removed from the Guild.
  Parameters:
  
  category - The Category to order TextChannels from.
  
  Returns:
  
  CategoryOrderAction - Type: TextChannel
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- modifyVoiceChannelPositions
  
  @Nonnull @CheckReturnValue CategoryOrderAction modifyVoiceChannelPositions(@Nonnull Category category)
  Modifies the positional order of Category#getVoiceChannels() using an extension of ChannelOrderAction specialized for ordering the nested VoiceChannels of this Category.
  Like ChannelOrderAction, the returned CategoryOrderAction can be used to move VoiceChannels up, down, or to a specific position.
  This uses ascending order with a 0 based index.
  Possible ErrorResponses include:
  
  UNNKOWN_CHANNEL
  One of the channels has been deleted before the completion of the task.
  
  MISSING_ACCESS
  The currently logged in account was removed from the Guild.
  Parameters:
  
  category - The Category to order VoiceChannels from.
  
  Returns:
  
  CategoryOrderAction - Type: VoiceChannels
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- modifyRolePositions
  
  @Nonnull @CheckReturnValue default RoleOrderAction modifyRolePositions()
  Modifies the positional order of Guild.getRoles() using a specific RestAction extension to allow moving Roles up/down or to a specific position.
  You can also move roles to a position relative to another role, by using moveBelow(...) and moveAbove(...).
  This uses descending ordering which means the highest role is first!
  This means the lowest role appears at index n - 1 and the highest role at index 0.
  Providing true to modifyRolePositions(boolean) will result in the ordering being in ascending order, with the highest role at index n - 1 and the lowest at index 0.
  As a note: Member.getRoles() and Guild.getRoles() are both in descending order, just like this method.
  Possible ErrorResponses include:
  
  UNKNOWN_ROLE
  One of the roles was deleted before the completion of the task
  
  MISSING_ACCESS
  The currently logged in account was removed from the Guild
  Returns:
  
  RoleOrderAction
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- modifyRolePositions
  
  @Nonnull @CheckReturnValue RoleOrderAction modifyRolePositions(boolean useAscendingOrder)
  Modifies the positional order of Guild.getRoles() using a specific RestAction extension to allow moving Roles up/down or to a specific position.
  Possible ErrorResponses include:
  
  UNKNOWN_ROLE
  One of the roles was deleted before the completion of the task
  
  MISSING_ACCESS
  The currently logged in account was removed from the Guild
  Parameters:
  
  useAscendingOrder - Defines the ordering of the OrderAction. If false, the OrderAction will be in the ordering defined by Discord for roles, which is Descending. This means that the highest role appears at index 0 and the lowest role at index n - 1. Providing true will result in the ordering being in ascending order, with the lower role at index 0 and the highest at index n - 1.
  As a note: Member.getRoles() and Guild.getRoles() are both in descending order.
  
  Returns:
  
  RoleOrderAction
  
  Throws:
  
  DetachedEntityException - If this entity is detached
- modifyWelcomeScreen
  
  @Nonnull @CheckReturnValue GuildWelcomeScreenManager modifyWelcomeScreen()
  
  The Manager for this guild's welcome screen, used to modify properties of the welcome screen like if the welcome screen is enabled, the description and welcome channels.
  You modify multiple fields in one request by chaining setters before calling RestAction.queue().
  
  Returns:
  
  The GuildWelcomeScreenManager for this guild's welcome screen
  
  Throws:
  
  InsufficientPermissionException - If the currently logged in account does not have Permission.MANAGE_SERVER
  
  DetachedEntityException - If this entity is detached

Interface Guild

Nested Class Summary

Field Summary

Method Summary

Methods inherited from interface net.dv8tion.jda.api.entities.detached.IDetachableEntity

Methods inherited from interface net.dv8tion.jda.api.entities.channel.attribute.IGuildChannelContainer

Methods inherited from interface net.dv8tion.jda.api.entities.ISnowflake

Field Details

ICON_URL

SPLASH_URL

BANNER_URL

Method Details

retrieveCommands

retrieveCommands

retrieveCommandById

retrieveCommandById

upsertCommand

upsertCommand

updateCommands

editCommandById

editCommandById

deleteCommandById

deleteCommandById

retrieveIntegrationPrivilegesById

retrieveIntegrationPrivilegesById

retrieveCommandPrivileges

retrieveRegions

retrieveRegions

retrieveAutoModRules

retrieveAutoModRuleById

retrieveAutoModRuleById

createAutoModRule

modifyAutoModRuleById

modifyAutoModRuleById

deleteAutoModRuleById

deleteAutoModRuleById

addMember

isLoaded

pruneMemberCache

unloadMember

getMemberCount

getName

getIconId

getIconUrl

getIcon

getFeatures

isInvitesDisabled

getSplashId

getSplashUrl

getSplash

getVanityCode

getVanityUrl

retrieveVanityInvite

getDescription

getLocale

getBannerId

getBannerUrl

getBanner

getBoostTier

getBoostCount

getBoosters

getMaxBitrate

getMaxFileSize

getMaxEmojis

getMaxMembers

getMaxPresences

retrieveMetaData

getAfkChannel

getSystemChannel

getRulesChannel

getCommunityUpdatesChannel

getSafetyAlertsChannel

getOwner

getOwnerIdLong

getOwnerId

getAfkTimeout

getSecurityIncidentActions

getSecurityIncidentDetections

isMember

getSelfMember