HomeJavaModsDiscordEasyWhitelist
DiscordEasyWhitelist
ModsJava

DiscordEasyWhitelist

by pmakin · on Modrinth

Which build do you need?

This mod ships a separate file for every mod loader and every version of the game. Pick both, then download — the wrong build installs fine and then does nothing in the game.

Mod loader

Minecraft version

⬇ Download for 1.21.8–1.21.11 · Folia⬇ Download for 1.21–1.21.7 · Folia⬇ Download for 1.21.8–1.21.11 · Paper⬇ Download for 1.21–1.21.7 · Paper⬇ Download for 1.21.8–1.21.11 · Purpur⬇ Download for 1.21–1.21.7 · Purpur
I don't know my version or loader
Open the Minecraft launcher and look at the profile you play on — it names both, like fabric-loader-1.21.4. The version also shows in the bottom-right corner of the game's main menu.
No loader in the profile name? Then it's plain Minecraft, and these mods won't run — you need Fabric or NeoForge installed first.

DiscordEasyWhitelist

Table of Contents


Overview

DiscordEasyWhitelist provides both simple access to the SimpleWhitelist and advanced features for managing player access to the server. Nearly all features can be disabled or modified, allowing for flexible customization.


Slash Commands

💡 Tip: [variables] in square brackets are not required
<variables> in angle brackets are required

/whitelist

💡 Tip: Requires moderator role to access

Provides access to SimpleWhitelist

/whitelist check <nickname>

/whitelist add <nickname>

/whitelist remove <nickname>

/link

💡 Tip: Requires moderator role to access

Provides access to DiscordSRV's linking feature

/link check [user] [nickname]

/link add <user> <nickname>

/link remove [user] [nickname]

/accept

💡 Tip: Requires moderator role to access

/accept <user> <nickname>

Complex comand that can execute following tasks if configured accordingly:

/remove

💡 Tip: Requires moderator role to access

/remove <user> [nickname] [reason]

❗ Important: nickname is optional argument because command can execute series of checks to determine nickname on it's own if it wasn't provided. Details on this will be provided later in Configuration section

Complex comand that can execute following tasks if configured accordingly:

/status

💡 Tip: Does NOT require moderator role to access

/status

/reload

💡 Tip: Requires moderator role to access

/reload

Configuration

Plugin uses 2 files to configurate itself:

❗ Important: If files doesn't exist (e.g. on first start), general.yml, langugae.yml AND langugae.russian.yml will be generated.
langugae.russian.yml is langugae.yml translated to russian langugae

general.yml

moderator-roles


whitelist

enable


link

enable


accept

enable

link-to-nickname

add-to-whitelist

change-guild-name

add-roles

roles-to-add

remove-roles

roles-to-remove

send-welcome-message

welcome-channel-id


remove

enable

unlink-from-nickname

fallback-to-guild-username

remove-from-whitelist

kick-from-game-if-online

send-direct-message

send-remove-message

remove-channel-id

ban-from-guild


leave

enable

unlink-if-available

remove-from-whitelist

kick-from-game-if-online

ban-from-guild

send-direct-message

send-leave-message

leave-channel-id

send-report-message

report-channel-id


status

enable

language.yml

This file defines all messages the plugin can send in Discord
It supports placeholders and can contain multi-line lists for messages with multiple lines.

❗ Important: If file doesn't exist, language.yml and language.russian.yml will be generated automatically.
language.russian.yml is a full translation of this file into Russian language.


error-prefix


warning-prefix


success-prefix


general

unknown-error

no-permission

wrong-command-argument

no-command-argument

too-many-command-arguments

channel-not-found

user-not-on-server


accept

disabled

link-warning-already-others

link-warning-already-same

link-success

whitelist-warning-already

whitelist-success

guild-name-success

guild-role-remove-success

guild-role-add-success

welcome-message

welcome-message-success

accept-success


remove

disabled

link-error-other

link-error-never-played

link-error-not-linked

link-warning-not-linked

link-warning-not-linked-fallback

link-success

whitelist-warning-already

whitelist-success

kick-message

remove-message

remove-message-reason

remove-message-success

remove-direct-message

remove-direct-message-reason

remove-direct-message-success

remove-direct-message-failure

guild-ban-reason

guild-ban-success

remove-success


whitelist

disabled

contains-nickname

not-contains-nickname

added-nickname

not-added-nickname

removed-nickname

not-removed-nickname


link

disabled

nickname-not-linked

nickname-linked

user-not-linked

user-linked

user-linked-no-nickname

link-warning-already-others

link-warning-already-same

link-success

unlink-nickname-not-found

unlink-nickname-success

unlink-user-not-found

unlink-user-success-no-nickname

unlink-user-success


reload

reloaded


leave

leave-message

leave-message-name-not-resolved

leave-direct-message

guild-ban-reason

report-message

report-warning-not-linked

report-warning-name-not-resolved

report-unlinked

report-unlinked-name-not-resolved

report-removed-from-whitelist

report-warning-not-in-whitelist

kick-message

report-banned-from-guild

report-warning-already-banned

report-message-success

report-direct-message-success

report-warning-direct-messages-failure


status

disabled

status-message-no-players

status-message

status-entry

status-entry-linked

Installation

You will need 2 plugins installed along:

That's it! DiscordEasyWhitelist should work as drop-in addon for them

Examples

general.yml

moderator-roles:
- '0000000000000000000'
- '0000000000000000000'
whitelist:
  enable: true
link:
  enable: true
accept:
  enable: true
  link-to-nickname: true
  add-to-whitelist: true
  change-guild-name: true
  add-roles: true
  roles-to-add:
  - '0000000000000000000'
  - '0000000000000000000'
  remove-roles: true
  roles-to-remove:
  - '0000000000000000000'
  - '0000000000000000000'
  send-welcome-message: true
  welcome-channel-id: '0000000000000000000'
remove:
  enable: true
  unlink-from-nickname: true
  fallback-to-guild-username: false
  remove-from-whitelist: true
  kick-from-game-if-online: true
  send-remove-message: true
  remove-channel-id: '0000000000000000000'
  send-direct-message: true
  ban-from-guild: true
leave:
  enable: false
  unlink-if-available: true
  remove-from-whitelist: true
  kick-from-game-if-online: true
  ban-from-guild: true
  send-leave-message: true
  leave-channel-id: '0000000000000000000'
  send-direct-message: true
  send-report-message: true
  report-channel-id: '0000000000000000000'
status:
  enable: true

langugae.yml

error-prefix: '🚫 '
warning-prefix: '⚠️ '
success-prefix: '✅ '
general:
  unknown-error: Unknown error. Check linking status of nickname/user being used
  no-permission: You don't have permission to use this command
  wrong-command-argument: 'Invalid argument: `{arg}`'
  no-command-argument: Enter at least one argument
  too-many-command-arguments: Too many arguments entered
  only-on-server: This command can only be used on discord server
  channel-not-found: Channel `{channel_id}` not found, message won't be sent
  user-not-on-server: '{discord_mention} is not in the guild'
accept:
  disabled: This functionality is disabled
  link-warning-already-others: Nickname or user are already linked to someone else,
    try unlinking them first
  link-warning-already-same: '{discord_mention} already linked to `{nickname}`'
  link-success: '{discord_mention} was linked to `{nickname}`'
  whitelist-warning-already: Nickname `{nickname}` already persists in the whitelist
  whitelist-success: Nickname `{nickname}` was added to the whitelist
  guild-name-success: '{discord_mention}''s guild name was changed to `{nickname}`'
  guild-role-remove-success: Roles {roles} were removed
  guild-role-add-success: Roles {roles} were added
  welcome-message:
  - '{discord_mention} Welcome!'
  - You was added to the server, IP can be found in <#0000000000000000000>, or using
    command `!ip`. Minecraft version 1.21.8.
  - Yoy should also check out <#0000000000000000000>, it contains useful information
    to start playing on the server comfortably. Have fun!
  - ''
  - '*Application review by {moderator_mention}*'
  welcome-message-success: Welcome message was sent into <#{channel_id}>
  accept-success: |-
    Logs:
    {report}
remove:
  disabled: This functionality is disabled
  link-error-other: Nickname or user are already linked to someone else, try unlinking
    them first
  link-error-never-played: '{discord_mention} never entered the server, can''t resolve
    their nickname, enter it manually'
  link-error-not-linked: '{discord_mention} isn''t linked to any nickname'
  link-warning-not-linked: '{discord_mention} isn''t linked to entered nickname'
  link-warning-not-linked-fallback: '{discord_mention} isn''t linked to any nickname,
    falling back to `{fallback}`'
  link-success: '{discord_mention} was unlinked from `{nickname}`'
  whitelist-warning-already: Whitelist already doesn't contain `{nickname}`
  whitelist-success: Nickname `{nickname}` was removed from the whitelist
  kick-message: <red>You was removed from the whitelist
  remove-message:
  - '{discord_mention} (`{nickname}`) was banned'
  remove-message-reason:
  - '{discord_mention} (`{nickname}`) was banned with the reason: "{reason}"'
  remove-message-success: Remove message was sent into <#{channel_id}>
  remove-direct-message:
  - You was banned on the server
  remove-direct-message-reason:
  - 'You was banned on the server with a reason: "{reason}"'
  remove-direct-message-success: Direct message was sent to {discord_mention}
  remove-direct-message-failure: '{discord_mention} has closed DMs, message not sent'
  guild-ban-reason: Banned by DEW
  guild-ban-success: '{discord_mention} was banned on the server'
  remove-success: |-
    Logs:
    {report}
whitelist:
  disabled: This functionality is disabled
  contains-nickname: Whitelist contains `{nickname}`
  not-contains-nickname: Whitelist doesn't contain `{nickname}`
  added-nickname: Nickname `{nickname}` was added to the whitelist
  not-added-nickname: Whitelist already contains `{nickname}`
  removed-nickname: Nickname `{nickname}` was removed from the whitelist
  not-removed-nickname: Whitelist already doesn't contain `{nickname}`
link:
  disabled: This functionality is disabled
  nickname-not-linked: '`{nickname}` isn''t linked to any user'
  nickname-linked: '`{nickname}` is linked to {discord_mention}'
  user-not-linked: '{discord_mention} isn''t linked to any nickname'
  user-linked: '{discord_mention} is linked to `{nickname}`'
  user-linked-no-nickname: '{discord_mention}  is linked to UUID `{uuid}`, player
    didn''t join server once, can''t retrieve his nickname'
  link-warning-already-others: Nickname or user are already linked to someone else,
    try unlinking them first
  link-warning-already-same: '{discord_mention} already linked to `{nickname}`'
  link-success: '{discord_mention} was linked to `{nickname}`'
  unlink-nickname-not-found: '`{nickname}` isn''t linked to any user'
  unlink-nickname-success: '`{nickname}` was unlinked from {discord_mention}'
  unlink-user-not-found: '{discord_mention} isn''t linked to any nickname'
  unlink-user-success-no-nickname: '{discord_mention} was unlinked from UUID `{uuid}`,
    player didn''t join server once, can''t retrieve his nickname'
  unlink-user-success: '{discord_mention} was unlinked from `{nickname}`'
reload:
  reloaded: Config reloaded
leave:
  leave-message:
  - '{discord_mention} (`{nickname}`) left the server and faced consequences 💀'
  leave-message-name-not-resolved:
  - '{discord_mention} left the server and faced consequences 💀'
  leave-direct-message:
  - You left the server and was removed from the whitelist
  guild-ban-reason: Banned by DEW
  report-message: |-
    {discord_mention} left the server!
    {report}
  report-warning-not-linked: User wasn't linked to any nickname
  report-warning-name-not-resolved: Player didn't join server once, can't retrieve
    his nickname
  report-unlinked-name-not-resolved: User was unlinked from UUID `{uuid}`
  report-unlinked: User was unlinked from `{nickname}`
  report-removed-from-whitelist: '`{nickname}` was removed from the whitelist'
  report-warning-not-in-whitelist: Whitelist already didn't contain `{nickname}`
  kick-message: <red>You was removed from the whitelist
  report-banned-from-guild: '{discord_mention} was banned from the server'
  report-warning-already-banned: '{discord_mention} was already banned from the server'
  report-message-success: Leave message was sent into <#{channel_id}>
  report-direct-message-success: Direct message was sent to {discord_mention}
  report-warning-direct-messages-failure: '{discord_mention} has closed DMs, message
    not sent'
status:
  disabled: This functionality is disabled
  status-message-no-players: '## No players online'
  status-message: |-
    ## {players_count} players online:
    {players}
  status-entry: '* {nickname}'
  status-entry-linked: '* {nickname} ({discord_mention})'

language.russian.yml

error-prefix: '🚫 '
warning-prefix: '⚠️ '
success-prefix: '✅ '
general:
  unknown-error: Неизвестная ошибка. Проверьте привязку используемых ников/аккаунтов
  no-permission: У вас нет прав для использования этой команды
  wrong-command-argument: Аргумент `{arg}` введен некорректно
  no-command-argument: Введите хотя бы один аргумент
  too-many-command-arguments: Слишком много аргументов
  only-on-server: Эта команда может быть использована только на сервере
  channel-not-found: Канал `{channel_id}` не найден, сообщение не будет отправлено
  user-not-on-server: '{discord_mention} не находится на сервере'
accept:
  disabled: Этот функционал выключен
  link-warning-already-others: Ник или аккаунт уже привязаны к кому-то другому, сначала
    отвяжите их
  link-warning-already-same: '{discord_mention} уже привязан к `{nickname}`'
  link-success: '{discord_mention} был привязан к `{nickname}`'
  whitelist-warning-already: Ник `{nickname}` уже присутствует в вайт-листе
  whitelist-success: Ник `{nickname}` добавлен в вайт-лист
  guild-name-success: Имя {discord_mention} было изменено на `{nickname}`
  guild-role-remove-success: Роли {roles} были удалены
  guild-role-add-success: Роли {roles} были добавлены
  welcome-message:
  - '{discord_mention}, добро пожаловать!'
  - Тебя добавили на сервер. IP находится в <#1086714411848310934>, либо с помощью
    команды `!ip`. Версия 1.21.8.
  - Рекомендую также посмотреть канал <#1285560328490324008>, чтобы начать ориентироваться
    на сервере. Приятной игры!
  - ''
  - '*Анкета рассмотрена {moderator_mention}*'
  welcome-message-success: В <#{channel_id}> отправлено приветственное сообщение
  accept-success: |-
    Отчёт:
    {report}
remove:
  disabled: Этот функционал выключен
  link-error-other: Ник или аккаунт уже привязаны к кому-то другому, сначала отвяжите
    их
  link-error-never-played: '{discord_mention} никогда не заходил на сервер, невозможно
    получить ник, укажите его вручную'
  link-error-not-linked: '{discord_mention} не привязан к какому-либо нику'
  link-warning-not-linked: '{discord_mention} не привязан к указанному нику'
  link-warning-not-linked-fallback: '{discord_mention} не привязан к какому-либо нику.
    Использую `{fallback}`'
  link-success: '{discord_mention} был отвязан от `{nickname}`'
  whitelist-warning-already: Ник `{nickname}` и так не присутствует в вайт-листе
  whitelist-success: Ник `{nickname}` удалён из вайт-листа
  kick-message: <red>Вы были удалены из вайт-листа
  remove-message:
  - '{discord_mention} (`{nickname}`) был забанен'
  remove-message-reason:
  - '{discord_mention} (`{nickname}`) был забанен по причине: "{reason}"'
  remove-message-success: В <#{channel_id}> отправлено сообщение о бане
  remove-direct-message:
  - Вы были забанены на сервере
  remove-direct-message-reason:
  - 'Вы были забанены на сервере по причине: "{reason}"'
  remove-direct-message-success: '{discord_mention} отправлено личное сообщение'
  remove-direct-message-failure: У {discord_mention} закрыты личные сообщения, сообщение
    не отправлено
  guild-ban-reason: Забанен DEW
  guild-ban-success: '{discord_mention} забанен на сервере'
  remove-success: |-
    Отчёт:
    {report}
whitelist:
  disabled: Этот функционал выключен
  contains-nickname: Ник `{nickname}` присутствует в вайт-листе
  not-contains-nickname: Ник `{nickname}` не присутствует в вайт-листе
  added-nickname: Ник `{nickname}` добавлен в вайт-лист
  not-added-nickname: Ник `{nickname}` уже есть в вайт-листе
  removed-nickname: Ник `{nickname}` удалён из вайт-листа
  not-removed-nickname: Ник `{nickname}` и так не присутствует в вайт-листе
link:
  disabled: Этот функционал выключен
  nickname-not-linked: '`{nickname}` не привязан к какому-либо аккаунту'
  nickname-linked: '`{nickname}` привязан к {discord_mention}'
  user-not-linked: '{discord_mention} не привязан к какому-либо нику'
  user-linked: '{discord_mention} привязан к `{nickname}`'
  user-linked-no-nickname: '{discord_mention} привязан к UUID `{uuid}`, игрок ни разу
    не заходил на сервер, поэтому вычислить ник невозможно'
  link-warning-already-others: Ник или аккаунт уже привязаны к кому-то другому, сначала
    отвяжите их
  link-warning-already-same: '{discord_mention} уже привязан к `{nickname}`'
  link-success: '{discord_mention} был привязан к `{nickname}`'
  unlink-nickname-not-found: '`{nickname}` не привязан к какому-либо аккаунту'
  unlink-nickname-success: '`{nickname}` был отвязан от {discord_mention}'
  unlink-user-not-found: '{discord_mention} не привязан к какому-либо нику'
  unlink-user-success-no-nickname: '{discord_mention} был отвязан от UUID `{uuid}`,
    игрок ни разу не заходил на сервер, поэтому вычислить ник невозможно'
  unlink-user-success: '{discord_mention} был отвязан от `{nickname}`'
reload:
  reloaded: Конфиг перезагружен
leave:
  leave-message:
  - '{discord_mention} (`{nickname}`) вышел с сервера и понёс наказание 💀'
  leave-message-name-not-resolved:
  - '{discord_mention} вышел с сервера и понёс наказание 💀'
  leave-direct-message:
  - Вы вышли с сервера и были удалены из вайт-листа
  guild-ban-reason: Забанен DEW
  report-message: |-
    {discord_mention} вышел с сервера!
    {report}
  report-warning-not-linked: Аккаунт не был привязан к какому-либо нику
  report-warning-name-not-resolved: Игрок ни разу не заходил на сервер, нельзя вычислить
    ник
  report-unlinked-name-not-resolved: Аккаунт был отвязан от UUID `{uuid}`
  report-unlinked: Аккаунт был отвязан от `{nickname}`
  report-removed-from-whitelist: '`{nickname}` был удалён из вайт-листа'
  report-warning-not-in-whitelist: '`{nickname}` и так не присутствовал в вайт-лист'
  kick-message: <red>Вы были удалены из вайт-листа
  report-banned-from-guild: '{discord_mention} был забанен на сервере'
  report-warning-already-banned: '{discord_mention} уже забанен на сервере'
  report-message-success: Сообщение о выходе было отправлено в <#{channel_id}>
  report-direct-message-success: '{discord_mention} отправлено личное сообщение'
  report-warning-direct-messages-failure: У {discord_mention} закрыты личные сообщения,
    сообщение не отправлено
status:
  disabled: Этот функционал выключен
  status-message-no-players: '## Игроков онлайн нет'
  status-message: |-
    ## {players_count} игроков онлайн:
    {players}
  status-entry: '* {nickname}'
  status-entry-linked: '* {nickname} ({discord_mention})'
Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

Verified by MCModsHub

These come from our own check of the pack file, not from the source page.

Explore more