v1.0.0 · Minecraft 1.21.8 · Java 21

Win11 风格
Minecraft 服务器
Web 管理面板

零外部依赖、纯内嵌 HTTP 服务器、公网可访问。集成 LuckPerms、DeluxeTags、 TAB、PlaceholderAPI、MiniMOTD 等 9 款热门插件，一个 jar 包全面掌控。

快速部署 前置插件
15 功能模块
9 插件集成
0 外部依赖
40+ API 端点
FluentMC 面板 · 仪表盘
仪表盘 实时
玩家管理 15
白名单 安全
世界管理 控制
控制台 命令
外观自定义 MOTD
权限管理 LP
称号管理 DT
✦ 核心特点

为什么选择 FluentMC

零外部依赖、WinUI 风格界面、公网远程访问、Token 认证、纯反射 Hook 桥接， 让服务器管理更安全、更高效。

零外部依赖

使用 JDK 内置 HttpServer，打包后仅一个轻量 jar，无第三方框架冲突。

轻量

WinUI 风格界面

深色/浅色主题切换，Win11 级别交互体验，按钮、开关、滑块丝滑流畅。

UI

公网远程访问

绑定 0.0.0.0 即可从公网管理服务器，配合防火墙放行端口即可访问。

网络

Token 认证

登录后颁发令牌，支持配置有效期，所有 API 需携带 Bearer Token 访问。

安全

插件桥接架构

通过反射检测可选依赖，未安装时自动隐藏对应功能，零依赖冲突风险。

生态

纯反射 Hook

所有可选插件集成均使用反射，不会因缺少依赖而崩溃，优雅降级。

稳定
✦ 功能全景

15 大模块 全面掌控

从仪表盘到权限管理，从 MOTD 编辑到数据分析，一个面板覆盖服务器管理的全部核心场景。

仪表盘
玩家管理
白名单
世界管理
控制台
权限管理
称号管理
TAB 列表
外观自定义
PAPI 云拓展
多世界管理
数据分析
基础功能
每日奖励
系统设置
✦ 插件生态

深度集成 9 大插件

全部通过纯反射 Hook 实现，按需启用，优雅降级。安装后自动检测，无需额外配置。

插件 Hook 类 集成方式 状态
LuckPerms LuckPermsHook 反射 API + Java API 软依赖
DeluxeTags DeluxeTagsHook 直读 config.yml + 命令重载 软依赖
TAB TabHook 反射 API + 配置文件读写 软依赖
PlaceholderAPI PlaceholderAPIHook 反射 API (eCloud) 软依赖
MiniMOTD MiniMOTDHook 反射 API + 配置文件读写 软依赖
Multiverse-Core MultiverseHook 纯反射 (MVWorldManager) 软依赖
Plan PlanHook 反射 API + 配置文件读取 软依赖
Essentials EssentialsHook 纯反射 (IEssentials) 软依赖
DailyReward DailyRewardHook 配置文件直读直写 + 命令派发 软依赖
所有插件均为软依赖，未安装时对应模块自动隐藏，不影响面板运行。 下载前置插件 →
✦ 技术架构

匠心设计 · 技术亮点

内嵌 HTTP 服务器、主线程安全桥接、纯反射 Hook、Token 认证，每一个细节都经过精心打磨。

后端架构

使用 Java 21 + Paper API 1.21.8，内嵌 com.sun.net.httpserver.HttpServer （零外部依赖），Gson 由 Paper 内置提供。

所有 Bukkit API 调用通过 MinecraftService 调度到主线程执行， 使用 CountDownLatch 同步等待（5 秒超时）， AtomicReference 传递结果，确保线程安全。

  • 零外部依赖 · 仅 JDK + Paper API
  • 纯反射 Hook · 优雅降级
  • Token 认证 · UUID 令牌 + 过期管理
  • BukkitScheduler · 主线程安全调度
Java 21 Paper 1.21.8 Bearer Token

前端特性

01

原生三件套 HTML/CSS/JS，无框架依赖

02

WinUI 设计系统 深色/浅色主题，响应式布局

03

实时数据轮询 仪表盘自动刷新，页面不可见时暂停

04

MiniMessage 预览 渐变色 & 彩虹色实时渲染

05

动态侧边栏 基于插件可用性自动显隐

✦ 快速开始

安装部署 5 步搞定

从下载 jar 到公网访问，5 步即可完成部署。配置文件自动生成，重载无需重启。

环境准备

JDK 21+ + Paper 1.21.8（兼容 Spigot）。

放入 JAR

将 FluentMC-1.0.0.jar 放入 plugins/ 目录。

首次启动

自动生成 plugins/MCServerPanel/config.yml，控制台输出访问地址和默认密码。

修改配置

编辑密码、端口、命令黑名单等。执行 /panel reload 重载。

访问面板

浏览器打开 http://<服务器IP>:8765，输入密码登录。

下载插件
游戏内命令
/panel · /panel reload · /panel status · /panel url · /panel password · /panelreload
权限: mcpanel.admin

配置文件 (config.yml)

web.port — 8765
web.host — "0.0.0.0"
auth.password — "admin123"
auth.token-expire-hours — 24
security.blocked-commands — stop, restart, reload, op, deop
ui.theme — system
✦ 常见问题

FAQ

快速解答您在使用过程中可能遇到的问题。

请检查三处配置：
1) config.yml 中 host: "0.0.0.0"
2) 服务器防火墙放行面板端口（默认 8765）
3) 云服务器安全组规则放行该端口

这是插件加载顺序问题。Hook 类实现了自动重试机制，执行 /panel reload 后刷新页面即可自动检测。

编辑 config.yml 中的 auth.password，然后执行 /panel reload 重载配置。也可在游戏内使用 /panel password 查看/修改。

该命令在 config.yml 的 blocked-commands 黑名单中。如需放行，从列表中移除并执行 /panel reload。

端口和主机地址变更需要重启服务器或使用 /panel reload 完整重载才能生效。

内嵌 HTTP 服务器不支持 HTTPS。建议配置 Nginx 反向代理终止 TLS，转发到面板端口。