Class GuildMemberUpdateAvatarEvent

java.lang.Object

net.dv8tion.jda.api.events.Event

net.dv8tion.jda.api.events.guild.GenericGuildEvent

net.dv8tion.jda.api.events.guild.member.GenericGuildMemberEvent

net.dv8tion.jda.api.events.guild.member.update.GenericGuildMemberUpdateEvent<String>

net.dv8tion.jda.api.events.guild.member.update.GuildMemberUpdateAvatarEvent

All Implemented Interfaces:

GenericEvent, UpdateEvent<Member,String>

public class GuildMemberUpdateAvatarEvent
extends GenericGuildMemberUpdateEvent<String>

Indicates that a Member updated their Guild avatar.

Can be used to retrieve members who change their per guild avatar, the triggering guild, the old avatar id and the new avatar id.

Identifier: avatar

Requirements

This event requires the GUILD_MEMBERS intent to be enabled.
createDefault(String) and createLight(String) disable this by default!

Additionally, this event requires the MemberCachePolicy to cache the updated members. Discord does not specifically tell us about the updates, but merely tells us the member was updated and gives us the updated member object. In order to fire a specific event like this we need to have the old member cached to compare against.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	IDENTIFIER

Constructor Summary

Constructors

Constructor	Description
GuildMemberUpdateAvatarEvent(JDA api, long responseNumber, Member member, String oldAvatarId)

Method Summary

Modifier and Type	Method	Description
ImageProxy	getNewAvatar()	Returns an ImageProxy for this member's new avatar.
ImageProxy	getNewAvatar(ImageFormat format)	Returns an ImageProxy for this member's new avatar.
String	getNewAvatarId()	The new avatar id
String	getNewAvatarUrl()	The url of the new avatar
String	getNewAvatarUrl(ImageFormat format)	The url of the new avatar
ImageProxy	getOldAvatar()	Returns an ImageProxy for this member's old avatar.
ImageProxy	getOldAvatar(ImageFormat format)	Returns an ImageProxy for this member's old avatar.
String	getOldAvatarId()	The old avatar id
String	getOldAvatarUrl()	The previous avatar url
String	getOldAvatarUrl(ImageFormat format)	The previous avatar url

Methods inherited from class GenericGuildMemberUpdateEvent

getEntity, getNewValue, getOldValue, getPropertyIdentifier

Methods inherited from class GenericGuildMemberEvent

getMember, getUser

Methods inherited from class GenericGuildEvent

getGuild

Methods inherited from class Event

getJDA, getRawData, getResponseNumber, toString

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface GenericEvent

getJDA, getRawData, getResponseNumber

Methods inherited from interface UpdateEvent

getEntityType

Field Details

IDENTIFIER

public static final String IDENTIFIER

See Also:

• Constant Field Values

Constructor Details

GuildMemberUpdateAvatarEvent

public GuildMemberUpdateAvatarEvent(@Nonnull
 JDA api,
 long responseNumber,
 @Nonnull
 Member member,
 @Nullable
 String oldAvatarId)

Method Details

getOldAvatarId

@Nullable
public String getOldAvatarId()

The old avatar id

Returns:

The old avatar id

getOldAvatarUrl

@Nullable
public String getOldAvatarUrl()

The previous avatar url

Returns:

The previous avatar url

getOldAvatarUrl

@Nullable
public String getOldAvatarUrl(@Nonnull
 ImageFormat format)

The previous avatar url

Parameters:

format - The format in which the image should be

Returns:

The previous avatar url

Throws:

IllegalArgumentException - If the format is null

See Also:

• DiscordAssets.memberAvatar(ImageFormat, String, String, String)

getOldAvatar

@Nullable
public ImageProxy getOldAvatar()

Returns an ImageProxy for this member's old avatar.

Note: the old avatar may not always be downloadable as it might have been removed from Discord.

Returns:

Possibly-null ImageProxy of this member's old avatar

See Also:

• getOldAvatarUrl()

getOldAvatar

@Nullable
public ImageProxy getOldAvatar(@Nonnull
 ImageFormat format)

Returns an ImageProxy for this member's old avatar.

Note: the old avatar may not always be downloadable as it might have been removed from Discord.

Parameters:

format - The format in which the image should be

Returns:

Possibly-null ImageProxy of this member's old avatar

Throws:

IllegalArgumentException - If the format is null

See Also:

• getOldAvatarUrl(ImageFormat)
• DiscordAssets.memberAvatar(ImageFormat, String, String, String)

getNewAvatarId

@Nullable
public String getNewAvatarId()

The new avatar id

Returns:

The new avatar id

getNewAvatarUrl

@Nullable
public String getNewAvatarUrl()

The url of the new avatar

Returns:

The url of the new avatar

getNewAvatarUrl

@Nullable
public String getNewAvatarUrl(@Nonnull
 ImageFormat format)

The url of the new avatar

Parameters:

format - The format in which the image should be

Returns:

The url of the new avatar

Throws:

IllegalArgumentException - If the format is null

See Also:

• DiscordAssets.memberAvatar(ImageFormat, String, String, String)

getNewAvatar

@Nullable
public ImageProxy getNewAvatar()

Returns an ImageProxy for this member's new avatar.

Returns:

Possibly-null ImageProxy of this member's new avatar

See Also:

• getNewAvatarUrl()

getNewAvatar

@Nullable
public ImageProxy getNewAvatar(@Nonnull
 ImageFormat format)

Returns an ImageProxy for this member's new avatar.

Parameters:

format - The format in which the image should be

Returns:

Possibly-null ImageProxy of this member's new avatar

Throws:

IllegalArgumentException - If the format is null

See Also:

• getNewAvatarUrl(ImageFormat)
• DiscordAssets.memberAvatar(ImageFormat, String, String, String)