Skip to content

Releases: MuNET-OSS/MinecraftServerFrontend

v1.0.0 - 首个正式版本

20 Mar 18:29
@7yunluo 7yunluo
v1.0.0
fd562bc

Choose a tag to compare

View all tags
v1.0.0 - 首个正式版本 Latest
Latest

MinecraftServerFrontend v1.0.0

Minecraft 服务器前端管理面板首个正式发布版本。

✨ 功能

  • 实时仪表盘 — TPS、内存、CPU、在线玩家、MSPT 实时监控
  • 服务器延迟监控 — 集成 Uptime Kuma，ECharts 折线图展示延迟历史
  • Web 控制台 — 实时日志流 + 命令执行 + 服务端 Tab 补全 + 日志刷新按钮
  • 玩家管理 — 在线玩家列表，支持踢出和封禁
  • 公告系统 — 增删改查 + 游戏内推送（聊天栏/屏幕标题，13 种颜色）
  • 插件管理 — 启用/禁用插件（.disabled 后缀切换）
  • External API — API Key 认证的外部接口，供 AI 工具/自动化脚本调用
  • 深色/亮色主题 — 粉色主色调，圆形扩张切换动画
  • 响应式设计 — 桌面端侧边栏 + 移动端底部导航栏

📦 Release 包含文件

文件 说明
frontend-dist.tar.gz 前端构建产物，解压后直接部署到 Nginx
backend-dist.tar.gz 后端构建产物 + package.json + .env.example

🚀 快速部署（使用预构建包）

1. 部署插件

从源码构建插件（需要 Java 21 + Gradle）：

cd plugin && ./gradlew build

将 build/libs/MuCraftBridge.jar 放入 MC 服务器的 plugins/ 目录，重启服务器。

2. 部署后端

# 解压后端
mkdir backend && tar xzf backend-dist.tar.gz -C backend
cd backend

# 安装生产依赖
npm install --omit=dev

# 配置环境变量
cp .env.example .env
# 编辑 .env，至少修改 JWT_SECRET 和 BRIDGE_SECRET

# 启动
node dist/index.js

3. 部署前端

# 解压前端
tar xzf frontend-dist.tar.gz
# 将 dist/ 目录内容部署到 Nginx

Nginx 配置示例：

server {
    listen 80;

    root /path/to/dist;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

    location /api/ {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }

    location /socket.io/ {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

4. 访问面板

默认账号：admin / admin123

⚠️ 请通过环境变量 ADMIN_USERNAME / ADMIN_PASSWORD 修改默认凭据

环境要求

组件 版本
Node.js >= 18
MC 服务器 Paper / Leaves 1.21+
Java（构建插件） >= 21
Assets 7
Loading