亚历克的控制台！

亚历克的控制台

一个响应式的游戏内查看器，用于实时和历史 Hytale 日志，从头重建，具备受限内存和分页大小的用户界面更新。

安装

1. 下载 Alec's Console v1.0.0.jar。
2. 将文件放入服务器的 mods/ 目录。
3. 启动或重启服务器。

亚历克的控制台支持 Hytale 服务器版本 >=0.5.0 <0.7.0。

使用

以玩家身份运行 /console，需具备权限：

alechilles.alecsconsole.command.console

页面可以显示：

• 当前会话的实时服务器日志。
• 当前及上一个服务器 .log 文件。
• 当客户端文件与服务器位于同一台机器时，可显示正式版或预发布版的客户端日志。

远程玩家无法通过 Hytale 的插件 API 上传或暴露其本地客户端日志。因此，客户端源仅限于同主机；ClientLogDirectory 可额外添加一个明确的本地目录。

实时文本过滤会在停止输入 300 毫秒后进行。选择历史源或文件会加载一次；更改其过滤器后，点击 搜索 或提交搜索字段以再次扫描。结果会分页显示，暂停/跟随可冻结和恢复实时视图，选中行会显示完整文本以便复制。多选会保持显示顺序。

配置

Hytale 在首次加载时会在插件的数据目录中创建 config.json。默认值：

{
  "LiveCapacity": 5000,
  "PageSize": 200,
  "SearchDebounceMs": 300,
  "DiskResultLimit": 2000,
  "ClientLogDirectory": null
}

实时记录、渲染行、发现的文件、待处理工作、历史结果和选中文本都有固定上限。不使用重复的磁盘扫描或磁盘索引。

构建与开发

需要 Java 25 和与 gradle.properties 匹配的已安装 Hytale 正式版服务器。

./gradlew build
./gradlew runServer

独立 jar 文件写入 build/libs/ 目录下。发布产物使用名称 Alec's Console v<version>.jar。此仓库还在亚历克的本地 Hytale 模组工作区中注册为 :alecs-console。

原始功能集灵感来自 duke-darius/hytale-console；此实现是独立的从头重建。