p_vincular - Minecraft ↔ Discord 账号绑定插件
版本: 2.1.0
作者: Pedro
兼容性: Minecraft 1.21 (api-version: 1.21)
平台: Paper / Spigot
p_vincular 是一款高级且功能完善的插件,用于将 Minecraft 玩家账号与 Discord 账号绑定,并自动将 Discord 角色同步至 LuckPerms 组/权限。非常适合希望完全整合游戏内社区与 Discord 社区的服务器。
主要功能
-
通过唯一的 6 位代码安全绑定(在 Minecraft 中生成并在 Discord 中输入,或通过斜杠命令操作)。
-
自动同步 Discord 角色 → LuckPerms 组。
-
支持映射多个角色组(VIP、MVP、YouTuber、Staff 等)。
-
可自定义通知:聊天消息、Minecraft 中的标题以及 Discord 中的嵌入/临时消息。
-
成功绑定奖励(控制台命令针对每个 UUID 仅执行一次)。
-
游戏内配置菜单(/pvconfig)和重载命令(/pvreload)。
-
手动同步命令(/pvsync)。
-
强大的安全系统(代码有效期 TTL、冷却时间、尝试次数限制、强制唯一 Discord ID)。
-
在 Discord 频道中以丰富的嵌入形式公开显示绑定/解绑公告。
命令
| 命令 |
描述 |
用法 |
所需权限 |
/vincular |
生成代码以将你的账号绑定到 Discord |
/vincular |
pvincular.use (默认:所有人) |
/desvincular |
移除当前绑定 |
/desvincular |
pvincular.use |
/pvsync [player] |
强制同步玩家的权限(或你自己) |
/pvsync 或 /pvsync Name |
pvincular.admin |
/pvconfig |
打开插件的图形化配置菜单 |
/pvconfig |
pvincular.admin |
/pvreload |
无需重启服务器即可重载 config.yml |
/pvreload |
pvincular.admin |
权限
依赖项
安装
-
下载 p_vincular-2.1.0.jar。
-
将其放入服务器的 plugins/ 文件夹中(推荐 Paper/Spigot 1.21+)。
-
(可选)在 plugins/p_vincular/ 内部添加 logo.png 图片以在 Discord 嵌入中使用。
-
重启服务器(插件将生成其文件夹和 config.yml)。
-
编辑 config.yml 设置以下内容:
-
运行 /pvreload 或再次重启以应用更改。
plugin.yml(供开发者参考)
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 [player]
permissions:
pvincular.use:
default: true
pvincular.admin:
default: op
libraries:
- "net.dv8tion:JDA:6.2.0"
| /pvconfig | 打开插件的图形配置菜单 | /pvconfig | pvincular.admin |
| /pvreload | 在不重启服务器的情况下重新加载 config.yml 文件 | /pvreload | pvincular.admin |
权限
依赖
安装
-
下载 p_vincular-2.1.0.jar 文件。
-
将其放入 Paper/Spigot 1.21+ 服务器的 plugins/ 文件夹中。
-
(可选)在 plugins/p_vincular/ 文件夹中添加一张 logo.png 图片,以便在 Discord 嵌入中使用。
-
重启服务器(插件将生成文件夹和 config.yml 文件)。
-
编辑 config.yml 文件,设置以下内容:
-
Discord 机器人令牌
-
公会(Discord 服务器)ID
-
角色 ID
-
通知频道 ID
-
运行 /pvreload 或再次重启。
plugin.yml 示例(供开发者参考)
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: 打开 p_vincular 的配置菜单。
usage: /pvconfig
pvreload:
description: 重新加载 p_vincular 的 config.yml。
usage: /pvreload
vincular:
description: 生成一个代码以绑定你的 Discord 账户。
usage: /vincular
desvincular:
description: 解除你账户的绑定。
usage: /desvincular
pvsync:
description: 强制同步某个玩家(或你自己)的数据。
usage: /pvsync [player]
permissions:
pvincular.use:
default: true
pvincular.admin:
default: op
libraries:
- "net.dv8tion:JDA:6.2.0"
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 [player] | 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
Installation
-
Download p_vincular-2.1.0.jar.
-
Place it in your server's plugins/ folder (Paper/Spigot 1.21+ recommended).
-
(Optional) Add a logo.png image inside plugins/p_vincular/ to use in Discord embeds.
-
Restart the server (the plugin will generate its folder and config.yml).
-
Edit config.yml with:
-
Discord bot token
-
Guild (server) ID
-
Role IDs
-
Notification channel ID
-
Run /pvreload or restart again to apply changes.
plugin.yml (for developer reference)
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 [player]
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ça robusto (TTL do código, cooldown, limite de tentativas, bloqueio de IDs duplicados).
-
Anúncios públicos de vínculo/desvínculo em canal do Discord.
Comandos
| Comando | Descrição | Uso | Permissão necessária |
|------------------|--------------------------------------------------------|------------------------------|---------------------------|
| /vincular | Gera um código para vincular a conta ao Discord | /vincular | pvincular.use (padrão: todos) |
| /desvincular | Remove o vínculo atual | /desvincular | pvincular.use |
| /pvsync [jogador] | Força a sincronização de cargos de um jogador (ou você mesmo) | /pvsync ou /pvsync Nome | pvincular.admin |
| /pvconfig | Abre o menu gráfico de configuração do plugin | /pvconfig | pvincular.admin |
| /pvreload | Recarrega o arquivo config.yml sem reiniciar o servidor| /pvreload | pvincular.admin |
Permissões
-
pvincular.use → Permite usar /vincular e /desvincular (default: true → todos os jogadores).
-
pvincular.admin → Acesso aos comandos administrativos (/pvconfig, /pvreload, /pvsync) (default: op).
Dependências
Instalação
-
Baixe o arquivo p_vincular-2.1.0.jar.
-
Coloque-o na pasta plugins/ do seu servidor Paper/Spigot 1.21+.
-
(Opcional) Adicione uma imagem logo.png na pasta plugins/p_vincular/ para ser usada nos embeds do Discord.
-
Reinicie o servidor (o plugin gerará a pasta e o arquivo config.yml).
-
Edite o config.yml com:
-
Execute /pvreload ou reinicie novamente.
Exemplo de plugin.yml (para referência do desenvolvedor)
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: Abre o menu de configuração do p_vincular.
usage: /pvconfig
pvreload:
description: Recarrega config.yml do p_vincular.
usage: /pvreload
vincular:
description: Gera um código para vincular sua conta no Discord.
usage: /vincular
desvincular:
description: Remove o vínculo da sua conta.
usage: /desvincular
pvsync:
description: Força sync de um jogador (ou você mesmo).
usage: /pvsync [player]
permissions:
pvincular.use:
default: true
pvincular.admin:
default: op
libraries:
- "net.dv8tion:JDA:6.2.0"
评论 0
登录后参与评分
还没有评论,来抢沙发吧