# p_vincular – Minecraft \u2194 Discord Account Linking Plugin<\/p>\n
**Version:** `2.1.0` <\/p>\n
**Author:** Pedro <\/p>\n
**Compatibility:** Minecraft 1.21 (api-version: 1.21) <\/p>\n
**Platform:** Paper \/ Spigot <\/p>\n
**p_vincular** is an advanced and complete plugin for linking Minecraft player accounts with Discord accounts, automatically syncing Discord roles to LuckPerms groups\/permissions. Perfect for servers that want to fully integrate their in-game and Discord communities.<\/p>\n
## Main Features<\/p>\n
– Secure linking via a unique 6-digit code (generated in Minecraft and entered in Discord, or via slash commands).<\/p>\n
– Automatic synchronization of Discord roles \u2192 LuckPerms groups.<\/p>\n
– Support for multiple mapped role groups (VIP, MVP, YouTuber, Staff, etc.).<\/p>\n
– Customizable notifications: chat messages, titles in Minecraft, and embeds\/ephemeral messages in Discord.<\/p>\n
– Rewards on successful link (console commands executed once per UUID).<\/p>\n
– In-game configuration menu (`\/p<\/p>\n
– vconfig`) and reload command (`<\/p>\n
– \/pvreload`).<\/p>\n
– Manual sync command (`\/pvsync`).<\/p>\n
– Robust security system (code TTL, cooldown, attempt limits, unique Discord ID enforcement).<\/p>\n
– Public link\/unlink announcements in a Discord channel with rich embeds.<\/p>\n
## Commands<\/p>\n
| Command | Description | Usage | Required Permission |<\/p>\n
|———————-|——————————————————–|——————————–|—————————|<\/p>\n
| `\/vincular` | Generates a code to link your account to Discord | `\/vincular` | `pvincular.use` (default: everyone) |<\/p>\n
| `\/desvincular` | Removes the current link | `\/desvincular` | `pvincular.use` |<\/p>\n
| `\/pvsync [player]` | Forces role sync for a player (or yourself) | `\/pvsync` or `\/pvsync Name` | `pvincular.admin` |<\/p>\n
| `\/pvconfig` | Opens the plugin’s graphical configuration menu | `\/pvconfig` | `pvincular.admin` |<\/p>\n
| `\/pvreload` | Reloads the config.yml without restarting the server | `\/pvreload` | `pvincular.admin` |<\/p>\n
## Permissions<\/p>\n
– `pvincular.use` \u2192 Allows use of `\/vincular` and `\/desvincular` (default: true \u2192 all players).<\/p>\n
– `pvincular.admin` \u2192 Access to admin commands (`\/pvconfig`, `\/pvreload`, `\/pvsync`) (default: op).<\/p>\n
## Dependencies<\/p>\n
– **LuckPerms** (required) \u2192 For group synchronization and permission commands.<\/p>\n
– **JDA 6.2.0** \u2192 Shaded library for Discord bot functionality.<\/p>\n
## Installation<\/p>\n
1. Download `p_vincular-2.1.0.jar`.<\/p>\n
2. Place it in your server’s `plugins\/` folder (Paper\/Spigot 1.21+ recommended).<\/p>\n
3. (Optional) Add a `logo.png` image inside `plugins\/p_vincular\/` to use in Discord embeds.<\/p>\n
4. Restart the server (the plugin will generate its folder and `config.yml`).<\/p>\n
5. Edit `config.yml` with:<\/p>\n
– Discord bot token<\/p>\n
– Guild (server) ID<\/p>\n
– Role IDs<\/p>\n
– Notification channel ID<\/p>\n
6. Run `\/pvreload` or restart again to apply changes.<\/p>\n
## plugin.yml (for developer reference)<\/p>\n
“`yaml<\/p>\n
name: p_vincular<\/p>\n
version: 2.1.0<\/p>\n
main: br.com.pedro.p_vincular.PVincularPlugin<\/p>\n
api-version: “1.21”<\/p>\n
dependencies:<\/p>\n
server:<\/p>\n
LuckPerms:<\/p>\n
required: true<\/p>\n
commands:<\/p>\n
pvconfig:<\/p>\n
description: Opens the p_vincular configuration menu.<\/p>\n
usage: \/pvconfig<\/p>\n
pvreload:<\/p>\n
description: Reloads the p_vincular config.yml.<\/p>\n
usage: \/pvreload<\/p>\n
vincular:<\/p>\n
description: Generates a code to link your account on Discord.<\/p>\n
usage: \/vincular<\/p>\n
desvincular:<\/p>\n
description: Removes your account link.<\/p>\n
usage: \/desvincular<\/p>\n
pvsync:<\/p>\n
description: Forces sync for a player (or yourself).<\/p>\n
usage: \/pvsync [player]<\/p>\n
permissions:<\/p>\n
pvincular.use:<\/p>\n
default: true<\/p>\n
pvincular.admin:<\/p>\n
default: op<\/p>\n
libraries:<\/p>\n
– “net.dv8tion:JDA:6.2.0”<\/p>\n
“` <\/p>\n
# p_vincular – Plugin de Vincula\u00e7\u00e3o Minecraft \u2194 Discord<\/p>\n
**Vers\u00e3o:** `2.1.0` <\/p>\n
**Autor:** Pedro<\/p>\n
**Compatibilidade:** Minecraft 1.21 (api-version: 1.21) <\/p>\n
**Plataforma:** Paper \/ Spigot <\/p>\n
**p_vincular** \u00e9 um plugin avan\u00e7ado e completo para vincular contas do Minecraft com o Discord, sincronizando cargos do Discord com grupos\/permiss\u00f5es no servidor (integrado ao LuckPerms). Ideal para servidores que desejam unir a comunidade do jogo com o servidor Discord.<\/p>\n
## Funcionalidades Principais<\/p>\n
– Vincula\u00e7\u00e3o segura via c\u00f3digo \u00fanico de 6 d\u00edgitos (gerado no Minecraft e inserido no Discord ou vice-versa).<\/p>\n
– Sincroniza\u00e7\u00e3o autom\u00e1tica de cargos do Discord \u2192 grupos no LuckPerms.<\/p>\n
– Suporte a m\u00faltiplos grupos mapeados (VIP, MVP, YouTuber, Staff etc.).<\/p>\n
– Notifica\u00e7\u00f5es personaliz\u00e1veis: chat, t\u00edtulos no Minecraft e embeds\/mensagens no Discord.<\/p>\n
– Recompensas ao vincular (comandos console executados apenas uma vez por UUID).<\/p>\n
– Menu de configura\u00e7\u00e3o in-game (`\/pvconfig`) e reload (`\/pvreload`).<\/p>\n
– Comando de sincroniza\u00e7\u00e3o manual (`\/pvsync`).<\/p>\n
– Sistema de seguran\u00e7a robusto (TTL do c\u00f3digo, cooldown, limite de tentativas, bloqueio de IDs duplicados).<\/p>\n
– An\u00fancios p\u00fablicos de v\u00ednculo\/desv\u00ednculo em canal do Discord.<\/p>\n
## Comandos<\/p>\n
| Comando | Descri\u00e7\u00e3o | Uso | Permiss\u00e3o necess\u00e1ria |<\/p>\n
|——————|——————————————————–|——————————|—————————|<\/p>\n
| `\/vincular` | Gera um c\u00f3digo para vincular a conta ao Discord | `\/vincular` | `pvincular.use` (padr\u00e3o: todos) |<\/p>\n
| `\/desvincular` | Remove o v\u00ednculo atual | `\/desvincular` | `pvincular.use` |<\/p>\n
| `\/pvsync [jogador]` | For\u00e7a a sincroniza\u00e7\u00e3o de cargos de um jogador (ou voc\u00ea mesmo) | `\/pvsync` ou `\/pvsync Nome` | `pvincular.admin` |<\/p>\n
| `\/pvconfig` | Abre o menu gr\u00e1fico de configura\u00e7\u00e3o do plugin | `\/pvconfig` | `pvincular.admin` |<\/p>\n
| `\/pvreload` | Recarrega o arquivo config.yml sem reiniciar o servidor| `\/pvreload` | `pvincular.admin` |<\/p>\n
## Permiss\u00f5es<\/p>\n
– `pvincular.use` \u2192 Permite usar `\/vincular` e `\/desvincular` (default: true \u2192 todos os jogadores).<\/p>\n
– `pvincular.admin` \u2192 Acesso aos comandos administrativos (`\/pvconfig`, `\/pvreload`, `\/pvsync`) (default: op).<\/p>\n
## Depend\u00eancias<\/p>\n
– **LuckPerms** (obrigat\u00f3rio) \u2192 Para sincroniza\u00e7\u00e3o de grupos e execu\u00e7\u00e3o de comandos de permiss\u00e3o.<\/p>\n
– **JDA 6.2.0** \u2192 Biblioteca inclu\u00edda via repositories Maven (shade no plugin).<\/p>\n
## Instala\u00e7\u00e3o<\/p>\n
1. Baixe o arquivo `p_vincular-2.1.0.jar`.<\/p>\n
2. Coloque-o na pasta `plugins\/` do seu servidor Paper\/Spigot 1.21+.<\/p>\n
3. (Opcional) Adicione uma imagem `logo.png` na pasta `plugins\/p_vincular\/` para ser usada nos embeds do Discord.<\/p>\n
4. Reinicie o servidor (o plugin gerar\u00e1 a pasta e o arquivo `config.yml`).<\/p>\n
5. Edite o `config.yml` com:<\/p>\n
– Token do bot Discord<\/p>\n
– ID da guild (servidor Discord)<\/p>\n
– IDs dos cargos<\/p>\n
– ID do canal de notifica\u00e7\u00f5es<\/p>\n
6. Execute `\/pvreload` ou reinicie novamente.<\/p>\n
## Exemplo de plugin.yml (para refer\u00eancia do desenvolvedor)<\/p>\n
“`yaml<\/p>\n
name: p_vincular<\/p>\n
version: 2.1.0<\/p>\n
main: br.com.pedro.p_vincular.PVincularPlugin<\/p>\n
api-version: “1.21”<\/p>\n
dependencies:<\/p>\n
server:<\/p>\n
LuckPerms:<\/p>\n
required: true<\/p>\n
commands:<\/p>\n
pvconfig:<\/p>\n
description: Abre o menu de configura\u00e7\u00e3o do p_vincular.<\/p>\n
usage: \/pvconfig<\/p>\n
pvreload:<\/p>\n
description: Recarrega config.yml do p_vincular.<\/p>\n
usage: \/pvreload<\/p>\n
vincular:<\/p>\n
description: Gera um c\u00f3digo para vincular sua conta no Discord.<\/p>\n
usage: \/vincular<\/p>\n
desvincular:<\/p>\n
description: Remove o v\u00ednculo da sua conta.<\/p>\n
usage: \/desvincular<\/p>\n
pvsync:<\/p>\n
description: For\u00e7a sync de um jogador (ou voc\u00ea mesmo).<\/p>\n
usage: \/pvsync [player]<\/p>\n
permissions:<\/p>\n
pvincular.use:<\/p>\n
default: true<\/p>\n
pvincular.admin:<\/p>\n
default: op<\/p>\n
libraries:<\/p>\n
– “net.dv8tion:JDA:6.2.0”<\/p>\n","protected":false},"excerpt":{"rendered":"
Vincula\u00e7\u00e3o de discord com minecraft, cargos!
\nLinking Discord with Minecraft, roles!<\/p>\n","protected":false},"featured_media":118738,"template":"","meta":{"_minecraft_slug":"p_vincular","_minecraft_project_id":"fcZ2V5UV","_minecraft_author":"Mr_Haruki","_minecraft_license":"MIT","_minecraft_downloads":17,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"p_vincular.zip","_minecraft_size_bytes":69455,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:44:47.782543Z","_minecraft_date_created":"2026-01-13T23:02:51.877349Z","_minecraft_date_modified":"2026-01-17T18:14:07.316610Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/p_vincular","_minecraft_icon_attachment_id":118738,"_minecraft_imported_at":"2026-06-06T23:34:47+00:00","_minecraft_import_hash":"316ef9901b62402d12e7ba39e68cd1ac","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,122,126,90,127,867,129,123,92],"mod_loader":[130,132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-118737","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-magic","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-social","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n