discord4j.rest.util.Permission Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of discord4j-rest Show documentation
A JVM-based REST/WS wrapper for the official Discord Bot API
There is a newer version: 3.3.0-RC2
/*
 * This file is part of Discord4J.
 *
 * Discord4J is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * Discord4J is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with Discord4J. If not, see .
 */
package discord4j.rest.util;

import discord4j.common.annotations.Experimental;

/**
 * Permissions are a way to limit and grant certain abilities to users.
 *
 * @see Permissions
 */
public enum Permission {

    /** Allows creation of instant invites. */
    CREATE_INSTANT_INVITE(0x00000001, false),

    /** Allows kicking members. */
    KICK_MEMBERS(0x00000002, true),

    /** Allows banning members. */
    BAN_MEMBERS(0x00000004, true),

    /** Allows all permissions and bypasses channel permission overwrites. */
    ADMINISTRATOR(0x00000008, true),

    /** Allows management and editing of channels. */
    MANAGE_CHANNELS(0x00000010, true),

    /** Allows management and editing of the guild. */
    MANAGE_GUILD(0x00000020, true),

    /** Allows for the addition of reactions to messages. */
    ADD_REACTIONS(0x00000040, false),

    /** Allows for viewing of audit logs. */
    VIEW_AUDIT_LOG(0x00000080, false),

    /** Allows for using priority speaker in a voice channel. */
    PRIORITY_SPEAKER(0x00000100, false),

    /** Allows for Stream in voice channel. */
    STREAM(0x00000200, false),

    /**
     * Allows guild members to view a channel, which includes reading messages in text channels and joining voice
     * channels.
     */
    VIEW_CHANNEL(0x00000400, false),

    /**
     * Allows for sending messages in a channel and creating threads in a forum(does not allow sending messages in
     * threads)
     */
    SEND_MESSAGES(0x00000800, false),

    /** Allows for sending of /tts messages. */
    SEND_TTS_MESSAGES(0x00001000, false),

    /** Allows for deletion of other users messages. */
    MANAGE_MESSAGES(0x00002000, true),

    /** Links sent by users with this permission will be auto-embedded. */
    EMBED_LINKS(0x00004000, false),

    /** Allows for uploading images and files. */
    ATTACH_FILES(0x00008000, false),

    /** Allows for reading of message history. */
    READ_MESSAGE_HISTORY(0x00010000, false),

    /**
     * Allows for using the @everyone tag to notify all users in a channel, and the @here tag to notify all online users
     * in a channel.
     */
    MENTION_EVERYONE(0x00020000, false),

    /** Allows the usage of custom emojis from other servers. */
    USE_EXTERNAL_EMOJIS(0x00040000, false),

    /** Allows for viewing guild insights. */
    VIEW_GUILD_INSIGHTS(0x00080000, false),

    /** Allows for joining of a voice channel. */
    CONNECT(0x00100000, false),

    /** Allows for speaking in a voice channel. */
    SPEAK(0x00200000, false),

    /** Allows for muting members in a voice channel. */
    MUTE_MEMBERS(0x00400000, false),

    /** Allows for deafening of members in a voice channel. */
    DEAFEN_MEMBERS(0x00800000, false),

    /** Allows for moving of members between voice channels. */
    MOVE_MEMBERS(0x01000000, false),

    /** Allows for using voice-activity-detection in a voice channel. */
    USE_VAD(0x02000000, false),

    /** Allows for modification of own nickname. */
    CHANGE_NICKNAME(0x04000000, false),

    /** Allows for modification of other users nicknames. */
    MANAGE_NICKNAMES(0x08000000, false),

    /** Allows management and editing of roles. */
    MANAGE_ROLES(0x10000000, true),

    /** Allows management and editing of webhooks. */
    MANAGE_WEBHOOKS(0x20000000, true),

    /**
     * Allows management and editing of emojis.
     *
     * @deprecated use the official permission name: {@link #MANAGE_GUILD_EXPRESSIONS}
     */
    @Deprecated
    MANAGE_EMOJIS(0x40000000, true),

    /**
     * Allows management and editing of emojis and stickers.
     *
     * @deprecated use the official permission name: {@link #MANAGE_GUILD_EXPRESSIONS}
     */
    @Deprecated
    MANAGE_EMOJIS_AND_STICKERS(0x40000000, true),

    /** Allows management and editing of emojis, stickers, and soundboard sounds. */
    MANAGE_GUILD_EXPRESSIONS(0x40000000, true),

    /** Allows members to use slash commands in text channels.
     *
     *  @deprecated use the official permission name: {@link #USE_APPLICATION_COMMANDS}
     */
    @Deprecated
    USE_SLASH_COMMANDS(0x80000000L, false),

    /** Allows members to use application commands, including slash commands and context menu commands. */
    USE_APPLICATION_COMMANDS(0x80000000L, false),

    /**
     * Allows for requesting to speak in stage channels. Marked as experimental since Discord treats this feature as
     * "under active development and may be changed or removed"
     */
    @Experimental
    REQUEST_TO_SPEAK(0x0000000100000000L, false),

    /** Allows for creating, editing, and deleting scheduled events. */
    MANAGE_EVENTS(0x0000000200000000L, false),

    /** Allows for deleting and archiving threads, and viewing all private threads. */
    MANAGE_THREADS(0x0000000400000000L, true),

    /** Allows for creating public and announcement threads. */
    CREATE_PUBLIC_THREADS(0x0000000800000000L, false),

    /**
     * Allows for creating and participating in threads.
     *
     * @deprecated use the official permission name: {@link #CREATE_PUBLIC_THREADS}
     */
    @Deprecated
    USE_PUBLIC_THREADS(0x0000000800000000L, false),

    /** Allows for creating private threads. */
    CREATE_PRIVATE_THREADS(0x0000001000000000L, false),

    /**
     * Allows for creating and participating in private threads
     *
     * @deprecated use the official permission name: {@link #CREATE_PRIVATE_THREADS}
     */
    @Deprecated
    USE_PRIVATE_THREADS(0x0000001000000000L, false),

    /** Allows the usage of custom stickers from other servers. */
    USE_EXTERNAL_STICKERS(0x0000002000000000L, false),

    /** Allows for sending messages in threads */
    SEND_MESSAGES_IN_THREADS(0x0000004000000000L, false),

    /** Allows for using Activities (applications with the EMBEDDED flag) in a voice channel. */
    USE_EMBEDDED_ACTIVITIES(0x0000008000000000L, false),

    /**
     * Allows for timing out users to prevent them from sending or reacting to messages in chat and threads,
     * and from speaking in voice and stage channels.
     */
    MODERATE_MEMBERS(0x0000010000000000L, false),

    /** Allows for viewing role subscription insights */
    VIEW_CREATOR_MONETIZATION_ANALYTICS(0x0000020000000000L, true),

    /** Allows for using soundboard in a voice channel */
    USE_SOUNDBOARD(0x0000040000000000L, false),

    /** Allows the usage of custom soundboard sounds from other servers */
    USE_EXTERNAL_SOUNDS(0x0000200000000000L, false),

    /** Allows sending voice messages. */
    SEND_VOICE_MESSAGES(0x0000400000000000L, false);

    /** Whether MFA is required. */
    private final boolean mfa;

    /** The permission value. */
    private final long value;

    /**
     * Constructs a {@code Permission}.
     *
     * @param value The permission value.
     * @param mfa Whether MFA is required.
     */
    Permission(final long value, final boolean mfa) {
        this.value = value;
        this.mfa = mfa;
    }

    /**
     * Gets whether the permission requires the owner account to use multi-factor authentication when used on a guild
     * that has server-side MFA enabled.
     *
     * @return {@code true} when the permission requires the owner account to use multi-factor authentication when used
     * on a guild that has server-side MFA enabled, {@code false} otherwise.
     */
    public boolean requiresMfa() {
        return mfa;
    }

    /**
     * Gets the permission's value.
     *
     * @return The permission's value.
     */
    public long getValue() {
        return value;
    }
}