EasyBans
一套完整的 Velocity 代理端管理套件——封禁、静音、警告、踢出、递增处罚模板,以及开箱即用的多语言支持。
无需 MySQL 即可上手——默认使用嵌入式 H2 数据库运行。
什么是 EasyBans?
EasyBans 是一款面向 Velocity 代理端的网络级管理插件。它在代理层面接管了所有原版封禁相关命令(/ban、/ban-ip、/pardon、/pardon-ip、/banlist、/kick),让你的工作人员在整个网络中拥有统一的管理系统,而不是让每个后端服务器各自执行原版的封禁机制。封禁、静音、警告、踢出以及工作人员备注均通过 UUID 进行集中追踪,并保留完整的历史记录与工作人员责任追溯。
主要功能
- 封禁、IP 封禁、静音、警告、踢出 & 工作人员备注 —— 全部基于 UUID,均包含原因、持续时间和执行工作人员信息
- 递增处罚模板 —— 配置处罚阶梯(例如:3天 → 14天 → 永久),系统会根据玩家之前的违规记录自动应用相应的处罚阶段
- 带自动升级的警告类别 —— “3次刷屏警告 → 自动静音”、“5次警告 → 自动封禁”,完全可自定义
- 单服务器范围限制 —— 通过单一标志,即可将玩家仅封禁到某个后端服务器,或整个网络
- 多实例同步 —— 如果多个代理实例连接同一个数据库?处罚会自动传播(支持数据库轮询或 Redis pub/sub)
- 全面的多语言支持 —— 内置法语、英语、西班牙语、意大利语、俄语、阿拉伯语和德语,均采用 MiniMessage 格式(支持十六进制颜色、渐变、悬停文本)。玩家可通过
/easybans language <code> 自行设置语言
- 完全可自定义的多行踢出/封禁界面 —— 支持渐变、悬停文本,以及按模板阶段的覆盖设置
- Discord Webhook 集成 —— 每次封禁/静音/警告/踢出操作都会以富嵌入形式发布到你的工作人员 Discord 频道
- 关联账号(小号)检测 —— 当新连接与已封禁账号共享 IP 时,通知工作人员(或可选地自动封禁)
- 从其他插件导入 —— 可直接从原版封禁列表、EssentialsX、MaxBans、BanManager、AdvancedBan、BungeeAdminTools 或 LiteBans 迁移数据
- 全场景 Tab 补全 —— 在线与离线玩家名称、标志、持续时间、模板、类别、服务器均可补全
- MySQL、MariaDB、PostgreSQL & H2 —— 自由选择后端数据库,或直接使用零配置的嵌入式默认值
命令
/ban <player> <duration|reason...> [-s] [-server:<name>] [-t:<template>]
/banip <player> <duration|reason...> [-s] [-server:<name>]
/unban <player> [reason...]
/pardon-ip <ip> [reason...]
/mute <player> <duration|reason...> [-s] [-server:<name>] [-t:<template>]
/unmute <player> [reason...]
/warn <player> <category> <reason...>
/kick <player> <reason...> [-server:<name>]
/note <player> <note...>
/history <player> [page]
/staffhistory <staff> [page]
/banlist [players|ips] [page]
/lookup <id>
/easybans allow <player> <ip>
/easybans rollback <staff|confirm>
/easybans import <source> <location>
/easybans language <code>
/easybans template
/easybans reload
所有原版封禁命令名称(ban-ip、pardon、pardon-ip、banlist)均已注册为别名,因此对于已经习惯原版语法的工作人员来说,EasyBans 会无缝接管。
要求
- Java 25+
- Velocity 代理端
- 单代理端设置无需其他依赖——H2 是嵌入式且零配置的
- 对于 1.19.1+ 客户端的静音功能,需在代理端和所有后端服务器安装 SignedVelocity(防止在静音取消消息时出现聊天签名不同步问题)
配置
首次运行时自动生成带有合理默认值的配置文件:config.yml(存储、同步、Discord、关联账号检测、区域设置)、templates.yml(处罚模板和警告类别),以及每种内置语言的 messages_<locale>.yml。完整参考文档:请参阅插件 GitHub 仓库中的 CONFIG.md。
权限
所有权限均位于 easybans.* 命名空间下(例如 easybans.ban、easybans.mute、easybans.warn、easybans.kick、easybans.history、easybans.rollback、easybans.import……)——除服务器操作员外,默认不授予任何权限。完整权限列表请参见 GitHub 上的 PERMISSIONS.md。
发现 Bug 或有功能建议?请在 GitHub 上提交 Issue,或通过 Discord 联系我们。
EasyBans
A complete moderation suite for Velocity proxies — bans, mutes, warnings, kicks, escalating punishment templates, and full multi-language support, working out of the box.
No MySQL required to get started — runs on an embedded H2 database by default.
What is EasyBans?
EasyBans is a network-wide moderation plugin for Velocity proxies. It replaces every vanilla ban-related command (/ban, /ban-ip, /pardon, /pardon-ip, /banlist, /kick) at the proxy level, so your staff get one consistent moderation system across your entire network instead of each backend server enforcing its own vanilla bans. Bans, mutes, warnings, kicks and staff notes are all tracked centrally, by UUID, with full history and staff accountability.
Key Features
- Bans, IP bans, mutes, warnings, kicks & staff notes — all UUID-based, all with reasons, durations, and staff attribution
- Escalating punishment templates — configure a punishment ladder (e.g. 3d → 14d → permanent) that automatically applies the right stage based on a player's prior offenses
- Warning categories with auto-escalation — "3 spam warnings → auto-mute", "5 warnings → auto-ban", fully configurable
- Per-server scoping — ban a player from one backend server only, or network-wide, with a single flag
- Multi-instance sync — running more than one proxy against the same database? Punishments propagate automatically (database polling or Redis pub/sub)
- Full multi-language support — French, English, Spanish, Italian, Russian, Arabic and German out of the box, all in MiniMessage format (hex colors, gradients, hover text). Players can set their own language with
/easybans language <code>
- Fully customizable, multi-line kick/ban screens — with gradients, hover text, and per-template-stage overrides
- Discord webhook integration — every ban/mute/warn/kick posted to your staff Discord as a rich embed
- Linked-account (alt) detection — notifies staff (or optionally auto-bans) when a new connection shares an IP with a banned account
- Import from other plugins — migrate straight from vanilla ban-lists, EssentialsX, MaxBans, BanManager, AdvancedBan, BungeeAdminTools, or LiteBans
- Tab-completion everywhere — online and offline player names, flags, durations, templates, categories, servers
- MySQL, MariaDB, PostgreSQL & H2 — pick your backend, or just use the zero-config embedded default
Commands
/ban <player> <duration|reason...> [-s] [-server:<name>] [-t:<template>]
/banip <player> <duration|reason...> [-s] [-server:<name>]
/unban <player> [reason...]
/pardon-ip <ip> [reason...]
/mute <player> <duration|reason...> [-s] [-server:<name>] [-t:<template>]
/unmute <player> [reason...]
/warn <player> <category> <reason...>
/kick <player> <reason...> [-server:<name>]
/note <player> <note...>
/history <player> [page]
/staffhistory <staff> [page]
/banlist [players|ips] [page]
/lookup <id>
/easybans allow <player> <ip>
/easybans rollback <staff|confirm>
/easybans import <source> <location>
/easybans language <code>
/easybans template
/easybans reload
Every vanilla ban command name (ban-ip, pardon, pardon-ip, banlist) is registered as an alias, so EasyBans transparently takes over for staff already used to vanilla syntax.
Requirements
- Java 25+
- Velocity proxy
- Nothing else for a single-proxy setup — H2 is embedded and zero-config
- For mutes on 1.19.1+ clients, install SignedVelocity on the proxy and every backend server (prevents chat-signature desync when a mute cancels a message)
Configuration
Everything is generated with sensible defaults on first run: config.yml (storage, sync, Discord, linked-account detection, locale), templates.yml (punishment templates and warning categories), and messages_<locale>.yml for each of the 7 bundled languages. Full reference: see CONFIG.md in the plugin's GitHub repository.
Permissions
Every permission is namespaced under easybans.* (e.g. easybans.ban, easybans.mute, easybans.warn, easybans.kick, easybans.history, easybans.rollback, easybans.import...) — nothing is granted by default beyond server operators. Full list in PERMISSIONS.md on GitHub.
Found a bug or have a feature request? Open an issue on GitHub or reach out on Discord.
评论 0
登录后参与评分
还没有评论,来抢沙发吧