Alec's Console!

Usage

Run /console as a player with:

alechilles.alecsconsole.command.console

The page can show:

• Live server logs from the current session.
• The current and previous server .log files.
• Release or pre-release client logs when the client files are on the same machine as the server.

Remote players cannot upload or expose their local client logs through Hytale's plugin API. The client source is therefore same-host only; ClientLogDirectory can add one explicit local directory.

Live text filtering waits 300 ms after typing stops. Selecting a historical source or file loads it once; after changing its filters, press Search or submit the search field to scan again. Results are paged, Pause/Follow freezes and resumes the live view, and selected rows expose full text for copying. Multi-select preserves display order.

Configuration

Hytale creates config.json in the plugin's data directory on first load. Defaults:

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

Live records, rendered rows, discovered files, pending work, historical results, and selection text all have fixed bounds. No repeating disk scan or on-disk index is used.

Crash and stats reporting

Alec's Console embeds Beacon 2.0.1, including its consent UI. No separate Beacon installation is required. It supports crash reports attributed to Console and standard stats heartbeats with player counts, mod/server versions, and runtime environment information. Both categories default to enabled; operators can review or disable them with /beacon consent. Beacon coordinates with other installed copies so one runtime handles reporting.

The integration does not submit Console searches, copied selections, or historical client/server log files. Crash reporting uses Beacon's crash capture and redaction. Beacon failures do not prevent Console from loading or shutting down.

The packaged descriptor registers the alecs-console project with Beacon's hosted service using its public project key. Beacon's operator settings are stored under mods/Alechilles_Beacon/Settings/ in the server or save directory.

Build and development

Requires Java 25 and an installed Hytale release server matching gradle.properties.

./gradlew build
./gradlew runServer

The standalone jar is written under build/libs/. Release artifacts use the name Alec's Console v<version>.jar. This repository is also registered as :alecs-console in Alec's local Hytale mod workspace.

build produces the shaded JAR with the embedded runtime. prepareEmbeddedAssetPack merges Beacon's UI into Console's resources for both packaging and runServer.

The original feature set was inspired by duke_darius' Hytale Console; this implementation is an independent ground-up rebuild.