BlackList 门禁插件

简介

BlackList 是一款轻量级 Minecraft 服务器门禁插件，支持黑名单/白名单双模式，可配置拦截进服、聊天、命令和玩家互动行为，零外部依赖。

功能特性

功能	说明
黑名单模式	黑名单玩家进服自动踢出，可拦截聊天/命令/互动
白名单模式	仅白名单玩家可进服，其余全部拦截
关闭模式	禁用门禁，所有人正常进出
进服拦截	黑名单/非白名单玩家进服自动踢出并显示原因
聊天拦截	黑名单玩家无法发送聊天消息
命令拦截	黑名单玩家无法执行任何命令
互动拦截	黑名单玩家无法破坏/放置方块、无法攻击实体
外部 API	支持 QQ 机器人等外部系统通过文件接口对接
数据持久化	名单数据存 data.yml，重启不丢失

命令

命令	说明	权限
/门禁 模式 <黑名单|白名单|关闭>	切换门禁模式	OP
/门禁 黑名单 添加 <玩家> [原因]	加入黑名单	OP
/门禁 黑名单 移除 <玩家>	移出黑名单	OP
/门禁 黑名单 列表 [页码]	查看黑名单	OP
/门禁 白名单 添加 <玩家> [原因]	加入白名单	OP
/门禁 白名单 移除 <玩家>	移出白名单	OP
/门禁 白名单 列表 [页码]	查看白名单	OP
/门禁 重载	重载配置	OP

安装

1. 将 blacklist-1.0.1.jar 放入服务器的 plugins/ 文件夹
2. 重启服务器或执行 /reload confirm
3. 插件自动生成 plugins/BlackList/config.yml 和 data.yml

配置说明

# 门禁模式：blacklist / whitelist / off
mode: blacklist

# 拦截设置
intercept:
  join: true       # 进服拦截
  chat: true       # 聊天拦截
  command: true    # 命令拦截
  interact: true   # 互动拦截（破坏/放置/攻击）

# 踢出消息
kick-message: "§c你已被加入黑名单。原因：{reason}"
whitelist-kick-message: "§c服务器仅对白名单玩家开放。"

# 外部 API 接口
api:
  enabled: false
  token: "your-token-here"
  folder: "plugins/BlackList/api/"

外部 API 接口

插件提供文件监听接口，外部系统（如 QQ 机器人）可通过写入文件来添加/移除黑名单：

plugins/BlackList/api/add/<token>/<玩家名>/<原因>
plugins/BlackList/api/remove/<token>/<玩家名>

兼容性

• Paper / Spigot / Purpur / Leaves 1.16 ~ 26.2
• Java 17+

开源

本项目以 MIT 协议开源，欢迎提交 Issue 和 Pull Request。

Copyright (c) 2026 TinyAII

---

BlackList - Access Control Plugin for Minecraft

Introduction

BlackList is a lightweight Minecraft server access control plugin supporting blacklist/whitelist modes, with configurable join/chat/command/interaction interception. Zero external dependencies.

Features

Feature	Description
Blacklist Mode	Blacklisted players are kicked on join, with optional chat/command/interaction blocking
Whitelist Mode	Only whitelisted players can join, all others are blocked
Off Mode	Disable access control, everyone can join normally
Join Intercept	Auto-kick blacklisted/non-whitelisted players with reason
Chat Intercept	Blacklisted players cannot send chat messages
Command Intercept	Blacklisted players cannot execute any commands
Interaction Intercept	Blacklisted players cannot break/place blocks or attack entities
External API	Supports QQ bot integration via file-based interface
Persistent Data	Saved to data.yml, survives server restarts

Commands

Command	Description	Permission
/bl mode <blacklist|whitelist|off>	Switch mode	OP
/bl blacklist add <player> [reason]	Add to blacklist	OP
/bl blacklist remove <player>	Remove from blacklist	OP
/bl blacklist list [page]	View blacklist	OP
/bl whitelist add <player> [reason]	Add to whitelist	OP
/bl whitelist remove <player>	Remove from whitelist	OP
/bl whitelist list [page]	View whitelist	OP
/bl reload	Reload config	OP

Installation

1. Drop blacklist-1.0.1.jar into your server's plugins/ folder
2. Restart server or run /reload confirm
3. Config auto-generates at plugins/BlackList/config.yml

Configuration

mode: blacklist
intercept:
  join: true
  chat: true
  command: true
  interact: true
kick-message: "§cYou have been blacklisted. Reason: {reason}"
whitelist-kick-message: "§cThis server is whitelist-only."

External API

External systems (e.g. QQ bots) can manage the list via file operations:

plugins/BlackList/api/add/<token>/<player>/<reason>
plugins/BlackList/api/remove/<token>/<player>

Compatibility

• Paper / Spigot / Purpur / Leaves 1.16 ~ 26.2
• Java 17+

License

MIT License - Copyright (c) 2026 TinyAII