LumaPanel · 矿灯 -- 一个高性能的服务器面板 v1.0.1

[MD] # LumaPanel · 矿灯 基岩版服务器的 Web 管理面板，作为 [LeviLamina](https://github.com/LiteLDev/LeviLamina) 插件运行。装上之后，用浏览器就能管理服务器：看实时状态、管玩家、查背包、开地图、发指令。 --- **LumaPanel 用 Rust 编写，编译成原生动态库，直接运行在服务器进程内部。** - **原生级性能** — 编译成机器码，没有解释器、没有垃圾回收停顿、没有额外运行时 - **零额外进程** — 不占额外的进程和端口去做进程间通信 - **极低资源占用** — 资源占用极低，对服务器 TPS 的影响微乎其微 - **开箱即用** — 无需额外配置，即装即用 给自己的服务器加一个功能齐全的管理面板，不该让服务器变卡。这正是用 Rust 的原因。 --- ## 功能一览 - **仪表盘** — TPS、在线人数、CPU / 内存实时曲线 - **玩家管理** — 在线列表（坐标、维度、本次在线时长）、私信、踢人；玩家档案（XUID、登录次数、总时长、首次与最近上线）；每个玩家的进出历史、死亡记录、执行过的指令 - **背包查看** — 直接看任意玩家的背包 / 盔甲 / 副手 / 末影箱，含附魔和铁砧命名；可给予、清除物品 - **世界地图** — 把存档渲染成可缩放的俯视地图，切换维度、坐标网格、比例尺，显示出生点、玩家实时位置、死亡地点；可定时自动更新或手动一键渲染 - **聊天 / 控制台** — 网页里收发聊天、广播、执行任意后台指令 - **行为记录** — 玩家进出、死亡地点、聊天、执行过的指令，都能查、能按玩家筛选 - **配置编辑** — 网页里逐项修改 `server.properties`（自动备份），以及地图渲染设置 界面是深色 Minecraft 风格，手机浏览器也能用。 --- ## 安装 **前置条件**：你的基岩版服务器（BDS）已经装了 **LeviLamina**，并且装了 **[levilamina-rust-loader(v0.1.3版本以上)](https://www.minebbs.com/resources/levilamina-rust-loader-levilamina-rust.17046/)** 这个前置（LumaPanel 依赖它来运行）。 把压缩包里的 `LumaPanel` 文件夹整个放进服务器的 `plugins` 目录，最终结构是这样： ``` 你的服务器/ └── plugins/ └── LumaPanel/ ├── lumapanel.dll ├── manifest.json └── static/ ``` 然后启动（或重启）服务器。控制台看到这两行就是装好了： ``` [LumaPanel] LumaPanel v1.0.0 loaded [LumaPanel] Web server started at http://0.0.0.0:8000/ ``` 首次启动会自动生成配置文件和一个**访问令牌**。 > **版本要匹配**：v1.0.0 版本针对 **Minecraft 1.26.10 / LeviLamina 26.10.14** 编译。如果你的服务器是别的版本，插件可能无法加载——需要对应版本的构建。 --- ## 打开面板 浏览器访问 **`http://你的服务器IP:8000/`**，输入访问令牌登录。 令牌在配置文件里：`plugins/lumapanel/config.toml` 的 `[auth]` → `token`。 > 从公网访问的话，记得服务器防火墙 / 安全组放行 **8000** 端口（可在配置里改）。 --- ## 配置 配置文件 `plugins/lumapanel/config.toml` 在首次启动后生成，常用项： ```toml [web] host = "0.0.0.0" # 监听地址，0.0.0.0 = 允许外部访问 port = 8000 # 面板端口 [auth] token = "……" # 访问令牌，首次启动自动生成；留空则任何人都能进（公网最好别这么干） [panel] positions_interval_secs = 5 # 玩家坐标刷新间隔（秒），也决定死亡地点的坐标精度 history_retention_days = 30 # 曲线历史保留天数 chat_history_limit = 5000 # 聊天记录上限 event_history_limit = 5000 # 事件记录上限 [map] enabled = true # 是否开启地图 render_interval_mins = 30 # 地图自动更新间隔（分钟），0 = 不自动更新 dimensions = [0] # 要渲染的维度：0 主世界、1 下界、2 末地 resource_pack = "" # 官方资源包路径（可选），填了地图配色更接近原版 ``` 改完配置重启服务器生效。`[map]` 下大部分设置也能直接在网页"设置 → 存档地图"里改，即时生效。 ### 让地图更接近原版配色（可选） 不填资源包时，地图用的是内置的方块颜色表。想让配色更准，可以下载官方资源包，把 `resource_pack` 指向它（目录、`.zip` 或 `.mcpack` 都行）。官方资源包在 [Mojang/bedrock-samples](https://github.com/Mojang/bedrock-samples) 拿。 --- ## 常见问题 **面板打不开？** 先看服务器控制台有没有 `LumaPanel ... loaded` 和 `Web server started`。没有就是插件没加载，多半是版本不匹配或没装 levilamina-rust-loader 前置。有的话检查端口有没有被防火墙挡住。 **忘了访问令牌？** 看 `plugins/lumapanel/config.toml` 里的 `[auth] token`，或者把这一行删掉重启，会重新生成一个。 **修改地形/新建了建筑，地图为什么没更新？** 地图默认每 30 分钟自动更新一次。想立刻看到，去"设置 → 存档地图"点"立即渲染"——它会先强制存盘再渲染(需要等待一会)，拿到的是最新状态。 **背包显示"世界数据中没有该玩家的记录"？** 背包数据要等世界存盘后才能读到。在线玩家刚进服、还没自动保存时，点背包弹窗里的"保存世界并刷新"强制存盘一次即可。另外这个功能需要玩家在面板运行期间进过服。 **背包能改吗？** 能给予和清除物品（通过游戏指令，仅对在线玩家生效），但不直接改存档文件——那样有损坏存档的风险。 --- ## 提示 - **务必设置访问令牌**。令牌留空会关闭登录验证，公网上等于门户大开。 - 面板是只读地看存档 + 通过指令操作，不会直接改你的世界文件，用着放心。 --- ## 反馈 有问题、建议或 bug，欢迎通过以下方式联系： - 邮箱：**maskviva@qq.com** - 或在**讨论区**留言反馈 [/MD]