原创 闭源 工具 [MC-WEB-INFO] - 多功能网页看板 2026-09-21

MC-WEB-INFO 使用指南​

什么是 MC-WEB-INFO？​

MC-WEB-INFO 是一款为 Minecraft Folia / Paper 1.12.2-26.2 服务端设计的只读网页信息面板插件，内嵌 HTTP 服务（预设端口 32140），开放访问、无需登录即可查看服务器各项即时数据。​

版本信息​

• 版本：1.0.3
• 相容环境：Folia 26.2 / Paper 26.2（Java 25）
• 设计理念：零依赖、只读展示、SEO 支持、网页发言

---

​

功能总览​

功能	说明
服务器概览	TPS、在线人数、记忆体、CPU、运行时间
性能分析	详细 Tick 时序、线程、记忆体分析
在线玩家	即时在线列表、排序、搜寻、离线玩家历史
世界信息	各世界实体数、生物数、区块数、天气、时间
插件列表	已安装插件版本、作者、状态
控制台日志	实时抓取服务端控制台输出（LOG/CHAT/COMMAND/JOIN/QUIT）
服务端配置	从 server.properties 解析显示
系统信息	JVM、OS、Runtime 详细参数
网页发言	从网页输入框发消息广播至游戏内（需口令保护）
SEO 支持	每页独立路径、robots.txt、sitemap.xml、gzip 压缩

---

​

快速安装​

1. 放置插件文件​

将 MC-WEB-INFO-1.0.3.jar 复制到服务端的 plugins/ 目录。​

2. 重启服务端​

3. 查看启动日志​

启动后会在控制台看到：​

4. 访问面板​

在浏览器开启：​

​

​

例如：http://192.168.1.100:32140/ 或 http://localhost:32140/​

---

​

网页发言功能​

启用条件​

• 需在 config.yml 设置 chat.enabled: true（预设开启）
• 预设需要口令（chat.require-token: true）

获取发言口令​

进入「控制台」页面后，找到类型为「网页」的日志行，或执行命令：​

​

​

输出示例：​

使用方法​

1. 打开网页面板，切换到「控制台」分页
2. 下方会出现「网页发言」输入区
3. 填写「昵称」（可留空，使用预设名）和「口令」
4. 输入消息后点击「发送」或按 Enter
5. 消息会以 [网页端消息] 昵称: 内容 格式广播至所有在线玩家

安全机制​

• 口令保护（定长时间比较，防侧信道攻击）
• 同 IP 速率限制（预设 3 秒/次）
• 内容长度限制（预设 200 字符）
• 内容清洗（去除控制字符与 Minecraft 颜色码）
• 仅广播文本，绝不执行任何指令（即使发送 /stop 也只是聊天内容）

关闭网页发言​

编辑 plugins/MC-WEB-INFO/config.yml：​

​

​

然后执行 /mcwebinfo reload 或重启服务端。​

---

​

配置说明​

配置文件位置：plugins/MC-WEB-INFO/config.yml​

---

​

命令行工具​

命令	权限	说明
/mcwebinfo	mcwebinfo.admin	显示帮助信息
/mcwebinfo status	mcwebinfo.admin	查看插件状态
/mcwebinfo reload	mcwebinfo.admin	重新加载配置
/mcwebinfo token	mcwebinfo.admin	查看网页发言口令
/mcwebinfo version	无限制	查看版本信息
/mcwebinfo refresh	无限制	立即刷新面板数据

---

​

SEO 使用注意事项​

重要提示：当 seo.indexable: true 时，搜索引擎会收录面板内容，包括控制台日志中的聊天记录和指令。​

建议配置（推荐生产环境）​

若需公开收录​

请确保：​

1. 设定 site-url 为正确的外部可访问地址
2. 敏感信息不在聊天中出现
3. 定期检查 robots.txt 和 sitemap.xml

---

​

故障排查​

端口被占用​

错识：Web 服务启动失败（端口 32140 可能被占用） 解决：修改 config.yml 中的 web.port 为其他端口。​

无法访问面板​

1. 确认服务端已启动且插件加载成功
2. 检查防火墙是否开放埠（预设 32140）
3. 确认 web.bind 不是 127.0.0.1（若需外部访问）

控制台日志空白​

• 检查 console.capture: true
• 确认 Log4j2 Appender 挂载成功（启动日志应有相关提示）

网页发言失败​

1. 确认 chat.enabled: true
2. 确认口令正确（执行 /mcwebinfo token 查看）
3. 检查是否触发速率限制
4. 查看服务端控制台是否有错识日志

---

​

技术架构​

• HTTP 服务：JDK 内置 com.sun.net.httpserver，零外部依赖
• 日志采集：Log4j2 Root Appender + JUL 回退双通道
• 事件监听：AsyncChatEvent、PlayerCommandPreprocessEvent、ServerCommandEvent、PlayerJoinEvent、PlayerQuitEvent
• 广播方式：Bukkit.broadcast(Component.text(...)) — 纯文本，不执行指令
• 前端：原生 HTML/CSS/JS，无框架依赖，Canvas 绘图无第三方图表库

---

​

变更日志（v1.0.3）​

• 新增：网页发言功能（带口令保护、速率限制、内容清洗）
• 新增：控制台类型筛选器支持「网页」类型
• 新增：昵称和口令 localStorage 持久化
• 新增：/mcwebinfo token 命令查看口令
• 改动：插件重命名为「MC-WEB-INFO」
• 改动：包名从 com.mctop.webadmin 改为 com.mctop.mcwebinfo
• 改动：Log4j Appender 名称修正为 MCWEBINFO-Console
• 修补：ChatSender 代码末尾损坏修复

---

​

开发团队：MC-TOP 版本：1.0.3 更新日期：2026-09-21​