Package net.dv8tion.jda.api.interactions.commands.privileges

Class CommandPrivilege

java.lang.Object

net.dv8tion.jda.api.interactions.commands.privileges.CommandPrivilege

All Implemented Interfaces:

ISnowflake, SerializableData

public class CommandPrivilege
extends Object
implements ISnowflake, SerializableData

Privilege used to restrict access to a command within a Guild.

If the command is enabled by default, these can be used to blacklist users or roles from using the command. On the other hand if it is disabled by default, this can be used to whitelist users or roles instead.

See Also:

• Guild.retrieveCommandPrivileges()
• Guild.updateCommandPrivilegesById(String, Collection)
• Guild.updateCommandPrivileges(Map)
• CommandData.setDefaultEnabled(boolean)
• CommandCreateAction.setDefaultEnabled(boolean)
• Command.isDefaultEnabled()

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	CommandPrivilege.Type	The target type this privilege applies to.

Constructor Summary

Constructors

Constructor	Description
CommandPrivilege(CommandPrivilege.Type type, boolean enabled, long id)

Method Summary

Modifier and Type	Method	Description
static CommandPrivilege	disable(Role role)	Creates a privilege that denies access to the command for the provided role.
static CommandPrivilege	disable(User user)	Creates a privilege that denies access to the command for the provided user.
static CommandPrivilege	disableRole(long roleId)	Creates a privilege that denies access to the command for the provided role.
static CommandPrivilege	disableRole(String roleId)	Creates a privilege that denies access to the command for the provided role.
static CommandPrivilege	disableUser(long userId)	Creates a privilege that denies access to the command for the provided user.
static CommandPrivilege	disableUser(String userId)	Creates a privilege that denies access to the command for the provided user.
static CommandPrivilege	enable(Role role)	Creates a privilege that grants access to the command for the provided role.
static CommandPrivilege	enable(User user)	Creates a privilege that grants access to the command for the provided user.
static CommandPrivilege	enableRole(long roleId)	Creates a privilege that grants access to the command for the provided role.
static CommandPrivilege	enableRole(String roleId)	Creates a privilege that grants access to the command for the provided role.
static CommandPrivilege	enableUser(long userId)	Creates a privilege that grants access to the command for the provided user.
static CommandPrivilege	enableUser(String userId)	Creates a privilege that grants access to the command for the provided user.
boolean	equals(Object obj)
long	getIdLong()	The Snowflake id of this entity.
CommandPrivilege.Type	getType()	The CommandPrivilege.Type of entity this privilege is applied to.
int	hashCode()
boolean	isDisabled()	True if this privilege is denying access to the command
boolean	isEnabled()	True if this privilege is granting access to the command
DataObject	toData()	Serialized DataObject for this object.

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

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

getId, getTimeCreated

Constructor Details

CommandPrivilege

public CommandPrivilege(@Nonnull
 CommandPrivilege.Type type,
 boolean enabled,
 long id)

Method Details

enable

@Nonnull
public static CommandPrivilege enable(@Nonnull
 Role role)

Creates a privilege that grants access to the command for the provided role.

Parameters:

role - The role to grant access to

Returns:

CommandPrivilege instance

enable

@Nonnull
public static CommandPrivilege enable(@Nonnull
 User user)

Creates a privilege that grants access to the command for the provided user.

Parameters:

user - The user to grant access to

Returns:

CommandPrivilege instance

enableUser

@Nonnull
public static CommandPrivilege enableUser(@Nonnull
 String userId)

Creates a privilege that grants access to the command for the provided user.

Parameters:

userId - The user to grant access to

Returns:

CommandPrivilege instance

enableUser

@Nonnull
public static CommandPrivilege enableUser(long userId)

Creates a privilege that grants access to the command for the provided user.

Parameters:

userId - The user to grant access to

Returns:

CommandPrivilege instance

enableRole

@Nonnull
public static CommandPrivilege enableRole(@Nonnull
 String roleId)

Creates a privilege that grants access to the command for the provided role.

Parameters:

roleId - The role to grant access to

Returns:

CommandPrivilege instance

enableRole

@Nonnull
public static CommandPrivilege enableRole(long roleId)

Creates a privilege that grants access to the command for the provided role.

Parameters:

roleId - The role to grant access to

Returns:

CommandPrivilege instance

disable

@Nonnull
public static CommandPrivilege disable(@Nonnull
 Role role)

Creates a privilege that denies access to the command for the provided role.

Parameters:

role - The role to deny access for

Returns:

CommandPrivilege instance

disable

@Nonnull
public static CommandPrivilege disable(@Nonnull
 User user)

Creates a privilege that denies access to the command for the provided user.

Parameters:

user - The user to grant denies for

Returns:

CommandPrivilege instance

disableUser

@Nonnull
public static CommandPrivilege disableUser(@Nonnull
 String userId)

Creates a privilege that denies access to the command for the provided user.

Parameters:

userId - The user to grant access for

Returns:

CommandPrivilege instance

disableUser

@Nonnull
public static CommandPrivilege disableUser(long userId)

Creates a privilege that denies access to the command for the provided user.

Parameters:

userId - The user to grant access for

Returns:

CommandPrivilege instance

disableRole

@Nonnull
public static CommandPrivilege disableRole(@Nonnull
 String roleId)

Creates a privilege that denies access to the command for the provided role.

Parameters:

roleId - The role to deny access for

Returns:

CommandPrivilege instance

disableRole

@Nonnull
public static CommandPrivilege disableRole(long roleId)

Creates a privilege that denies access to the command for the provided role.

Parameters:

roleId - The role to deny access for

Returns:

CommandPrivilege instance

getIdLong

public long getIdLong()

Description copied from interface: ISnowflake

The Snowflake id of this entity. This is unique to every entity and will never change.

Specified by:

getIdLong in interface ISnowflake

Returns:

Long containing the Id.

getType

@Nonnull
public CommandPrivilege.Type getType()

The CommandPrivilege.Type of entity this privilege is applied to.

Returns:

The target CommandPrivilege.Type

isEnabled

public boolean isEnabled()

True if this privilege is granting access to the command

Returns:

Whether this privilege grants access

isDisabled

public boolean isDisabled()

True if this privilege is denying access to the command

Returns:

Whether this privilege denies access

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toData

@Nonnull
public DataObject toData()

Description copied from interface: SerializableData

Serialized DataObject for this object.

Specified by:

toData in interface SerializableData

Returns:

DataObject