> For the complete documentation index, see [llms.txt](https://undeffineddev.gitbook.io/whitelistplus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://undeffineddev.gitbook.io/whitelistplus/whitelist+.md).

# Whitelist+

{% hint style="info" %}
**Still using versions 1.7.9 or 1.8.x?**\
No problem! You can use the legacy build available here:\
👉 [Download Legacy Build (v2.0)](http://github.com/UndeffinedStudio/whitelistplus/releases/tag/2.0)
{% endhint %}

<figure><img src="/files/ZEWoSVEzow4ZIcYU2pR8" alt=""><figcaption></figcaption></figure>

This plugin offers a powerful and flexible solution for Minecraft server administrators. With versatile storage options including JSON, MySQL, and SQLite, it ensures reliable player data management. The configuration is clean and organized, with separate files for settings, messages, and whitelists, making maintenance easy. PlaceholderAPI support lets you seamlessly integrate this plugin variables for customization. Compatible with Minecraft versions from 1.7.9 up to 1.21.6 **(1.21.7 not tested, but I don't think there are any code-breaking changes)**.

### Preview

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgOcWXwVICh2J9L3whjhS%2Fuploads%2F5r7v4KcjAUp3pFmBqF4C%2F2025-06-28%2014-16-30.mp4?alt=media&token=fbd22c33-80a9-4e3f-9505-2d576db139a3>" %}
GUI Interactions
{% endembed %}

<details>

<summary>Images</summary>

<figure><img src="/files/bXHngbYXfFVnkm9adE0o" alt=""><figcaption><p>Commands</p></figcaption></figure>

<figure><img src="/files/2oSY1L0ErdQyKkZBnsf0" alt=""><figcaption><p>GUI</p></figcaption></figure>

<figure><img src="https://i.ibb.co/5xvKqPj/descarga.png" alt=""><figcaption><p><em>Server Access Denied</em></p></figcaption></figure>

</details>

<details>

<summary>Plugin &#x26; Message Configuration Files</summary>

For the `no-permission-*` keys in the lang file, you can leave them empty — the plugin will automatically fall back to the general `no-permission` key.

The supported storage types are: `file`, `mysql`, and `sqlite`.

</details>

<details>

<summary>Commands</summary>

All commands are executed using the base command: `/whitelist` or using the aliases `[wlp, wlist]`\
**Note:** Permissions are required for each subcommand.

***

**`/whitelist` or `/whitelist help`**

Displays the list of available commands along with descriptions.\
✅ **Permission:** `whitelistplus.commands`

***

**`/whitelist reload`**

Reloads the plugin configuration and language files. Also reloads the whitelist storage.\
**⚠️ Don't** use `/reload` or restart the server to apply changes — it won't work and changes will be lost. Always use `/whitelist reload` instead.\
✅ **Permission:** `whitelistplus.reload`

***

**`/whitelist on`**

Enables the whitelist system.\
📢 Optionally broadcasts a message and kicks non-whitelisted players (based on config settings).\
✅ **Permission:** `whitelistplus.on`

***

**`/whitelist off`**

Disables the whitelist system.\
📢 Optionally broadcasts a message.\
✅ **Permission:** `whitelistplus.off`

***

**`/whitelist add <player>`**

Adds a player to the whitelist.\
❗ The player must not already be whitelisted.\
✅ **Permission:** `whitelistplus.add`

***

**`/whitelist remove <player>`**

Removes a player from the whitelist.\
❗ The player must already be on the whitelist.\
✅ **Permission:** `whitelistplus.remove`

***

**`/whitelist list`**

Displays a list of all whitelisted players.\
✅ **Permission:** `whitelistplus.list`

***

**`/whitelist gui`**

Opens an interactive GUI to manage the whitelist.\
👤 Only available to players (not the console).\
✅ **Permission:** `whitelistplus.open`

</details>

<details>

<summary>Permissions</summary>

| Permission             | Description                                                 | Default |
| ---------------------- | ----------------------------------------------------------- | ------- |
| whitelistplus.admin    | Full admin access to WhitelistPlus.                         | op      |
| whitelistplus.commands | Allows use of the /whitelist command and its subcommands.   | op      |
| whitelistplus.add      | Allows adding players to the whitelist.                     | op      |
| whitelistplus.remove   | Allows removing players from the whitelist.                 | op      |
| whitelistplus.view     | Allows viewing the whitelist through the GUI.               | op      |
| whitelistplus.lang     | Allows changing the language or messages.                   | op      |
| whitelistplus.toggle   | Allows toggling the whitelist ON or OFF through the GUI.    | op      |
| whitelistplus.reload   | Allows reloading the plugin configuration.                  | op      |
| whitelistplus.open     | Allows opening the main WhitelistPlus GUI.                  | op      |
| whitelistplus.bypass   | Allows joining the server even if the whitelist is enabled. | false   |
| whitelistplus.list     | Allows listing all currently whitelisted players.           | op      |
| whitelistplus.on       | Allows enabling the whitelist.                              | op      |
| whitelistplus.off      | Allows disabling the whitelist.                             | op      |

</details>

<details>

<summary>Complements</summary>

<table><thead><tr><th width="128">Name</th><th>Description</th><th width="175">Minimum plugin version</th><th width="160">Minimum API Version</th><th width="128">Author</th><th>Homepage</th></tr></thead><tbody><tr><td>NONE</td><td>NONE</td><td>0</td><td>0</td><td>NONE</td><td>NONE</td></tr></tbody></table>

</details>

<details>

<summary>PlaceholderAPI Variables</summary>

* **%wlp\_status%** shows a colored message indicating whether the whitelist is enabled or disabled
* **%wlp\_is\_whitelisted%** returns `"true"` if the player is currently whitelisted (by UUID or name), otherwise `"false"`.
* **%wlp\_total\_whitelisted%** displays the total number of players in the whitelist.
* **%wlp\_is\_enabled%** indicates whether the whitelist system is currently enabled (`"true"` or `"false"`).
* **%wlp\_whitelisted\_by%** shows the name of the user who added the player to the whitelist.
* **%wlp\_whitelisted\_by\_uuid%** displays the UUID of the user who added the player to the whitelist.

</details>

<details>

<summary>FAQ</summary>

Q: **Does the list work for offline player? | A:** Absolutely! It should works offline. But if you have any trouble, just let me know 🙂

**What else should I put here 🤔?**

</details>

<details>

<summary>Support</summary>

Email(s):&#x20;

* <contact@undeffineddev.tech>
* <undeffineddev419@proton.me> (I don't check this one much, but you can send it to both... maybe you'll have a better chance of me seeing your message ¯\_(ツ)\_/¯)

Discord: **nexspecter**

SpigotM&#x43;**:** [**TheSantiCraft234**](https://www.spigotmc.org/members/thesanticraft234.1448354/)

</details>