P_Vincular

# p_vincular - Minecraft ↔ Discord Account Linking Plugin **Version:** `2.1.0` **Author:** Pedro **Compatibility:** Minecraft 1.21 (api-version: 1.21) **Platform:** Paper / Spigot **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. ## Main Features - Secure linking via a unique 6-digit code (generated in Minecraft and entered in Discord, or via slash commands). - Automatic synchronization of Discord roles → LuckPerms groups. - Support for multiple mapped role groups (VIP, MVP, YouTuber, Staff, etc.). - Customizable notifications: chat messages, titles in Minecraft, and embeds/ephemeral messages in Discord. - Rewards on successful link (console commands executed once per UUID). - In-game configuration menu (`/p - vconfig`) and reload command (` - /pvreload`). - Manual sync command (`/pvsync`). - Robust security system (code TTL, cooldown, attempt limits, unique Discord ID enforcement). - Public link/unlink announcements in a Discord channel with rich embeds. ## Commands | Command | Description | Usage | Required Permission | |----------------------|--------------------------------------------------------|--------------------------------|---------------------------| | `/vincular` | Generates a code to link your account to Discord | `/vincular` | `pvincular.use` (default: everyone) | | `/desvincular` | Removes the current link | `/desvincular` | `pvincular.use` | | `/pvsync ` | Forces role sync for a player (or yourself) | `/pvsync` or `/pvsync Name` | `pvincular.admin` | | `/pvconfig` | Opens the plugin's graphical configuration menu | `/pvconfig` | `pvincular.admin` | | `/pvreload` | Reloads the config.yml without restarting the server | `/pvreload` | `pvincular.admin` | ## Permissions - `pvincular.use` → Allows use of `/vincular` and `/desvincular` (default: true → all players). - `pvincular.admin` → Access to admin commands (`/pvconfig`, `/pvreload`, `/pvsync`) (default: op). ## Dependencies - **LuckPerms** (required) → For group synchronization and permission commands. - **JDA 6.2.0** → Shaded library for Discord bot functionality. ## Installation 1. Download `p_vincular-2.1.0.jar`. 2. Place it in your server's `plugins/` folder (Paper/Spigot 1.21+ recommended). 3. (Optional) Add a `logo.png` image inside `plugins/p_vincular/` to use in Discord embeds. 4. Restart the server (the plugin will generate its folder and `config.yml`). 5. Edit `config.yml` with: - Discord bot token - Guild (server) ID - Role IDs - Notification channel ID 6. Run `/pvreload` or restart again to apply changes. ## plugin.yml (for developer reference) ```yaml name: p_vincular version: 2.1.0 main: br.com.pedro.p_vincular.PVincularPlugin api-version: "1.21" dependencies: server: LuckPerms: required: true commands: pvconfig: description: Opens the p_vincular configuration menu. usage: /pvconfig pvreload: description: Reloads the p_vincular config.yml. usage: /pvreload vincular: description: Generates a code to link your account on Discord. usage: /vincular desvincular: description: Removes your account link. usage: /desvincular pvsync: description: Forces sync for a player (or yourself). usage: /pvsync permissions: pvincular.use: default: true pvincular.admin: default: op libraries: - "net.dv8tion:JDA:6.2.0" ``` # p_vincular - Plugin de Vinculação Minecraft ↔ Discord **Versão:** `2.1.0` **Autor:** Pedro **Compatibilidade:** Minecraft 1.21 (api-version: 1.21) **Plataforma:** Paper / Spigot **p_vincular** é um plugin avançado e completo para vincular contas do Minecraft com o Discord, sincronizando cargos do Discord com grupos/permissões no servidor (integrado ao LuckPerms). Ideal para servidores que desejam unir a comunidade do jogo com o servidor Discord. ## Funcionalidades Principais - Vinculação segura via código único de 6 dígitos (gerado no Minecraft e inserido no Discord ou vice-versa). - Sincronização automática de cargos do Discord → grupos no LuckPerms. - Suporte a múltiplos grupos mapeados (VIP, MVP, YouTuber, Staff etc.). - Notificações personalizáveis: chat, títulos no Minecraft e embeds/mensagens no Discord. - Recompensas ao vincular (comandos console executados apenas uma vez por UUID). - Menu de configuração in-game (`/pvconfig`) e reload (`/pvreload`). - Comando de sincronização manual (`/pvsync`). - Sistema de seguran