Lengbanlist | 冷禁列表
2.2.0❤️ 集封禁 、广播 、 禁言 、 警告 、 检测、举报为一体的新时代高版本MC服务器封禁插件 - | 简体中文 | 英文 | 模型化支持 | ❤️
- Tested MC versions
- 1.17, 1.18, 1.19, 1.20, 1.21, 26.1, 26.2, 26.3
简介
Lengbanlist 起初只是台封禁广播机：谁被封了，全服喊一声。
现在它是服务器的一整套管理班子——封禁、警告、禁言、举报申诉、聊天过滤、IP 关联、VPN 检测、审计回滚，外加一个浏览器就能打开的 Web 面板。
功能开关都在 config.yml 的 features 段。
功能
| 模块 | 命令 | 说明 |
|---|---|---|
| 封禁 / IP 封禁 | /ban /ban-ip /unban /setban | 时长支持 秒 / 分 / 时 / 天 / 周 / 月 / 年，也认 forever 与 auto（按警告次数自动算）；已有封禁随时改期改理由；IP 段封禁支持 172.198.2.x、172.198.2.0/24，整个网段一起拦 |
| 警告系统 | /warn /unwarn | 记录与撤销警告。LBAC 自动封禁默认 30 天内 3 次触发，阈值、统计窗口和封禁时长阶梯可在 warn-escalation 配置；撤销到阈值以下自动解封 |
| 禁言 | /mute /unmute /listmute | 定时或永久禁言，禁言期间开不了口；随时解禁，/listmute 看当前名单 |
| 聊天过滤 | — | 违禁词在 chatconfig.yml 里自己定，命中自动替换；攒够次数自动禁言；可疑消息带按钮推给管理员，一键放行或警告 |
| IP 关联 / VPN 检测 | /lban alts | 记下每位玩家的历史登录 IP，多账号共用同一 IP 时提醒管理员；入服检测 VPN / 代理，可配置成警告、踢出或封禁 |
| 举报与申诉 | /report /admin | /report 打开在线玩家头颅列表，点玩家后在聊天栏输入理由；/admin 打开举报管理界面，可受理、关闭、封禁、警告、传送到被举报人。命令式提交与处理仍然保留；封禁申诉从网页提交，在面板里处理 |
| 封禁广播 | — | 定时在聊天栏播报封禁统计，文案格式随意改；支持 random 随机 / orderly 顺序两种模式，也能手动触发、随时开关 |
| 角色模型 | /lban model /lban models | 提示语来自云端仓库 Lengbanlist-Models：models list 浏览、models install <ID> 安装、model <名称> 切换，插件里每句话的语气跟着变。模型支持继承——只写要改的句子，插件升级新增的文案自动跟上。每月还会按 bStats 使用统计选出月度精选 |
| 图形界面 | /lban open | 54 格箱子菜单，按钮按权限显示：封禁、解禁、改期、禁言、警告、冻结、隐身、切模型、重载都能点。封禁、禁言、警告、冻结还带聊天向导，一路问下来，中途 cancel 退出 |
| Web 管理面板 | — | 内置 HTTP 管理页，浏览器直接打开，JWT 鉴权加限流。封禁、解禁、禁言、警告、记录查询、重载在页面上都能办 |
| 查询工具 | /check /history /getip | 查玩家或 IP 的当前处罚、历史记录、关联账号与 IP 归属地 |
| 隐身 / 冻结 | /lban vanish /lban freeze | 隐身：对其他人完全不可见，手持物与盔甲一并隐藏，玩家列表里也不显示（有 lengbanlist.vanish.see 权限的照旧看得见）。冻结：禁移动、禁破坏、禁交互、禁丢弃、禁命令、禁传送，屏幕上弹出红色标题与理由，解冻得手动 /lban unfreeze；冻结记录存数据库，重启不丢，多子服共库时全服生效 |
| 多子服共用数据 | — | 数据库配置独立到 storage.yml。给每台子服设一个 server-name，共用同一份 MySQL / MariaDB / PostgreSQL 时，审计日志会记下每条操作出自哪台子服、哪位操作员，/lban audit 与 Web 面板都能翻 |
| 管理员频道 | /sc | 只有管理员看得见的独立聊天频道（Lua 扩展） |
| 传送 | /lban tp | 传送到玩家身边（Lua 扩展） |
| 操作回滚 | /lban rollback | 顺着审计日志按操作人与时间范围一键回滚：封禁的解封、解封的重新封禁、警告的撤销，也能只回滚某一类 |
| 其他 | /info | 插件版本、内存、CPU、在线人数；SQLite / MySQL / MariaDB / PostgreSQL 四选一，旧版 YAML 存储自动迁移；内置 bStats 统计与自动更新 |
扩展
核心只留处罚闭环，别的都能拆出去。目前两种写法：
- Lua 扩展：把
.lua丢进plugins/Lengbanlist/extensions/，/lban ext reload就生效——不用编译，不用重启。核心自带的/lban tp、/sc就是这么写的。 - Java 扩展：独立 Bukkit 插件，编译期依赖
lengbanlist-api，能注册命令、挂核心决策钩子、复用核心的连接池。
两种扩展注册的命令和内置命令走同一条路径，权限、补全、/lban help、功能开关自动对齐；装了哪些扩展，/lban ext list 一眼看完。
不想手动搬文件的话，/lban ext list 连云端市场一起看，/lban ext install <扩展名> 一键装：Lua 装完自动重载，jar 会下载到 plugins/ 并提示重启。
环境要求
| 项目 | 要求 |
|---|---|
| 服务端 | Spigot / Paper / Folia |
| 游戏版本 | 1.17.1 ~ 26.3+，单个 jar 通用 |
| Java | 17 及以上 |
| 数据库 | SQLite（内置，开箱即用）/ MySQL / MariaDB / PostgreSQL |
快速开始
- 把插件 jar 放进服务端
plugins目录，重启服务端。 - 首次启动会生成
plugins/Lengbanlist/eula.yml：把I have read and agree to the above terms改成yes，再重启一次——没同意之前插件不会启用。 - 按需修改
config.yml（功能开关与玩法）与storage.yml（数据库、保留策略、服务器标识）。旧版本写在config.yml里的database段会自动迁移。 - 执行
/lban reload应用改动，或重启服务端。
文档
| 文档 | 内容 |
|---|---|
| 命令帮助 | 完整命令列表与用法 |
| 配置速览 | config.yml / storage.yml 字段说明 |
| 插件展示 | 界面截图与实际效果 |
| 开发须知 | 工程结构、各包职责、扩展系统、构建与测试 |
| 扩展开发 | 用 Java 写扩展：契约、完整示例、方法参考 |
| 多平台链接 | GitHub / SpigotMC / Modrinth / Discord |
| 使用限制与责任声明 | MPL-2.0 与 EULA 要点 |
支持这个项目 ❤️
遇到问题、想聊新功能，来 QQ Group 坐坐。
如果这个插件对你有帮助，欢迎赞助支持。你的支持是我持续开发和维护的动力。
感谢支持 
Similar projects
Plugin →VeinMiner
Mine the whole vein on mining a single ore/block. Make the tedious mining experience to something satisfying and fun! FTB Ultimine alternative
99.3MSueta
Simple Voice Chat
A working voice chat in Minecraft!
76.8MSueta
Chunky
Pre-generates chunks, quickly and efficiently
18.4MSueta
VeinMiner Enchantment
Veinminer Addon - Adds vineminer enchantment to enchanting tables. Only tools with the enchantment can veinmine
18MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
WorldEdit
A Minecraft Map Editor... that runs in-game! With selections, schematics, copy and paste, brushes, and scripting. Use it in creative, or use it temporarily in survival.
11.6MSueta