PvPIndex MCBans

插件

· 作者 Shadow48402

由 PvPIndex 重构的 MCBans 分支

0 本站下载 0 关注 更新于 6 个月前

最新 1.2.0 · 26.1.2 · Bukkit / Folia

一键开服(送7天)

这是原版 MCBans 插件的重构分支。 封禁共享概念、命令结构和权限布局均源自 MCBans 团队及其贡献者。本分支将代码库现代化以适配 Java 21 / Paper 1.21+,并用 PvPIndex REST API 替换了旧的 MCBans 后端。

PvPIndex MCBans 将你的 Paper 服务器连接到 mcbans.pvpindex.com 全球封禁网络。在任何参与服务器上被封禁的玩家将在其他所有服务器上自动被拦截——同时你完全掌控本地封禁、存储后端和权限级别。


功能

  • 全局与本地封禁 - 发布本地封禁(仅保留在你的服务器上)或实时同步到所有连接服务器的全局封禁
  • 临时封禁 - 限时封禁,支持按分钟、小时、天或周自动过期
  • IP 封禁 - 通过 IP 地址封禁,以阻止 VPN 滥用和规避封禁
  • 理由预设 - 在配置中定义简写键(#hacks, #toxicity),展开为完整的理由字符串;扩展形式支持用于临时封禁的 default-duration;不区分大小写并支持 Tab 补全
  • 自定义踢出消息 - 每种类型(global, local, temp, failsafe)的模板,包含 {reason}, {admin}, {expires} 和 {appeal_url} 占位符
  • 离线韧性 - 在 API 中断期间发布的封禁会被排队并在恢复时推送;当 API 不可达时,failsafe 模式可以阻止所有登录
  • 增量同步 - 仅在可配置的间隔内下载封禁变更(默认 60 分钟)
  • 多种存储后端 - SQLite(默认,零配置)、MySQL/MariaDB、PostgreSQL
  • 小号检测 - /altlookup 通过 PvPIndex API 显示已知的小号
  • 开发者 API (JitPack) - 轻量级 pvpindex-mcbans-api 模块允许其他插件查询封禁状态,无需 Bukkit 依赖
  • Vault 集成 - 可选;只需更改一行配置即可交换权限后端
  • 完全可翻译 - 更改 language 键以加载不同的语言文件

要求

组件 版本
Java 21+
Paper 1.21+
PvPIndex API 密钥 在 pvpindex.com/apply 免费申请
Vault (可选) 任何较新版本

安装

  1. 从 GitHub Releases 下载 pvpindex-mcbans-<version>.jar。
  2. 将 JAR 放入 plugins/ 目录并启动服务器 - plugins/MCBans/config.yml 会自动生成。
  3. 申请 API 密钥 并将其粘贴到配置中:
pvpindex:
  apiKey: "your-bearer-token-here"
  1. 使用 /mcbans reload 重新加载或重启服务器。
  2. 运行 /mcbans sync 从网络拉取当前的封禁列表。

→ 完整指南:docs.pvpindex.com/mcbans/installation


命令

封禁命令

命令 权限 描述
/ban <player> [reason] mcbans.ban.local 发布本地封禁
/ban <player> g <reason> · /gban mcbans.ban.global 发布全局封禁(全网同步)
/ban <player> t <n> <m|h|d|w> [reason] · /tban mcbans.ban.temp 带自动过期的临时封禁
/banip <ip> [reason] · /ipban mcbans.ban.ip 封禁一个 IP 地址
/unban <player|IP|UUID> mcbans.unban 移除任何活跃封禁

管理命令

命令 权限 描述
/kick <player> [reason] mcbans.kick 踢出玩家而不封禁
/lookup <player|UUID> · /lup mcbans.lookup.player 查看封禁历史
/banlookup <id> · /blup mcbans.lookup.ban 按 ID 查看封禁记录
/altlookup <player|UUID> · /alup mcbans.lookup.alt 显示已知的小号

管理员命令

命令 描述
/mcbans 显示帮助
/mcbans reload 重新加载配置和语言文件
/mcbans sync 强制立即执行推送 + 下载循环
/mcbans presets 列出所有配置的理由预设 (mcbans.ban.local)

配置

pvpindex:
  apiUrl:       https://api.pvpindex.com
  apiKey:       ""            # ← 在此粘贴你的密钥
  syncInterval: 60            # 后台同步间隔(分钟)

storage:
  backend: sqlite             # sqlite | mysql | postgresql

language:   default
permission: SuperPerms        # SuperPerms | Vault

failsafe: false               # true = 当 API 不可达时阻止所有登录

# 可选:自定义发送给被封禁/踢出玩家的消息
kick-message:
  global:   "&cYou are globally banned.\n&7Reason: {reason}\n&7Appeal: {appeal_url}"
  local:    "&cYou are banned from this server.\n&7Reason: {reason}"
  temp:     "&cYou are temporarily banned until {expires}.\n&7Reason: {reason}"
  failsafe: "&cUnable to verify your ban status. Try again later."

# 可选:可在所有封禁命令中使用的简写理由键
reason-presets:
  hacks:
    reason: "Hacking / using unauthorized modifications"
  toxicity:
    reason: "Toxic behaviour"
  farming:
    reason: "Ban/ELO farming"
    default-duration: "7d"

→ 完整参考:docs.pvpindex.com/mcbans/configuration


开发者 API (JitPack)

将轻量级 API 客户端添加到你自己的插件中 - 不需要 Bukkit 依赖:

<repositories>
    <repository>
        <id>jitpack</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>
<dependency>
    <groupId>com.github.PVP-Index.pvpindex-mcbans</groupId>
    <artifactId>pvpindex-mcbans-api</artifactId>
    <version>1.1.0</version>
</dependency>

→ 开发者 API 文档


链接


PvPIndex 与 NeyHost 合作

结账时使用优惠券代码 PVPINDEX 可享受 10% 折扣。

Neyhost PvPIndex Partner


致谢

PvPIndex MCBans 是原始 MCBans 插件的重新架构分支,该插件由 MCBans 团队及贡献者开发(dev.bukkit.org/projects/mcbans)。其封禁共享概念、TCP 线协议、命令集以及权限布局均源自该项目。本分支针对 Java 21 / Paper 1.21+ 对代码库进行了现代化改造,并将传统的 MCBans 后端替换为 PvPIndex REST API。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源