# TheDashboard
轻量级 Web 后台面板，用于你的 Paper‑Minecraft 服务器——在浏览器中管理玩家、查看实时日志、发送控制台命令以及启动/停止服务器。
— 英文在下方 —
## 🇩🇪 德语
TheDashboard 是一个运行在插件内部的轻量级 Web 面板。无需外部 Web 服务器。通过密码令牌安全访问并方便地管理你的服务器。
### 亮点
- 查看和管理在线玩家（OP 徽章）：踢出、封禁、解除封禁、授予/移除 OP 权限
- 浏览器中的实时控制台和服务器日志
- 向服务器控制台发送命令
- 停止和重启服务器（Paper）
- 现代、响应式 UI - 立即可以使用
- 通过开关启用/禁用并管理白名单 (添加/移除玩家)
- 面板中显示的实时 TPS（1 分钟）
### 快速开始
1) 将 JAR 文件放入 plugins/ 目录并启动服务器
2) 在浏览器中打开：http://:4646/
3) 首次启动时设置新密码（设置对话框）
4) 使用密码登录并开始管理
### 兼容性
- Paper 1.21.x
- Java 21
### 配置 (基础)
- 端口和密码位于 plugins/TheDashboard/config.yml (默认端口：4646)
- 可选：如果日志未自动检测到，请设置 webserver.logFile
### 安全性
- 立即更改默认密码“YOUR_SECURE_PASSWORD”
- （可选）如果公开可访问：放置在反向代理之后、启用 HTTPS 并通过防火墙进行限制
— — —
## 🇬🇧 English
TheDashboard is a lightweight web panel that runs inside the plugin. No external web server required. Access via a password token and manage your server from the browser.
### Highlights
- View and manage online players (OP badge): kick, ban, unban, op/deop
- Live console and server logs in the browser
- Send commands to the server console
- Stop and restart the server (Paper)
- Modern, responsive UI – works out of the box
- Whitelist toggle and management (add/remove players)
- Live TPS display (1‑minute) in the panel
### Quick Start
1) Drop the JAR into plugins/ and start the server
2) Open in your browser: http://:4646/
3) On first run, set a new password (setup dialog)
4) Log in with the password and start managing
### Compatibility
- Paper 1.21.x
- Java 21
### Configuration (Basics)
- Port and password in plugins/TheDashboard/config.yml (default port: 4646)
- Optional: set webserver.logFile if logs aren’t detected automatically
### Security
- Change the default password “YOUR_SECURE_PASSWORD” immediately
- (optional) If exposed publicly: place behind a reverse proxy, enable HTTPS, and restrict via firewall