Files
horizon-airdef/website/docs/troubleshooting.md
T
Ludovic Marie 8f738d35ec Live player count: an anonymous "I'm playing" ping and "N playing now"
The game sends an anonymous ping once a minute while it runs (a random
session ID kept only in memory, the version, the platform, whether a LAN
or friends world is open). The telemetry server counts sessions seen in
the last 2 minutes, in memory only, with its own per-address rate limit
and a session cap, and serves rounded counts at GET /v1/live. The
launcher shows "N playing now" on the Play page when the count is
reachable, and tells players what the ping holds on the first-run
question, in Settings, and once on the Play page for players who
answered before. docs/telemetry.md and the privacy page say the same.

Like the rest of telemetry, nothing is sent until HORIZON_TELEMETRY_URL
is set or DEFAULT_ENDPOINT gets a server.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 10:18:58 +02:00

3.3 KiB

Logs, crashes and bug reports

When something breaks, Horizon writes down what happened. Send us that and the bug is much easier to fix. This page says where it is and how to report it.

If the game crashes

The launcher notices. It shows what went wrong, in one line, with buttons:

  • Open report opens the crash report.
  • Copy report copies it, so you can paste it where you report the bug.
  • Open logs folder opens the folder with the logs and crash reports.
  • Report on Discord takes you to our Discord server.

Where the files are

Everything is in the game folder, which is the same for every version you install:

  • Linux: ~/.local/share/horizon
  • macOS: ~/Library/Application Support/horizon
  • Windows: %APPDATA%\horizon

Inside it:

  • logs/latest.log is the log of the current or last run. Older runs are kept as logs/<date>-<number>.log.gz.
  • crash-reports/crash-<date>_<time>-client.txt is written when the game crashes. It holds the error, where it happened, your computer, your graphics card, your render settings, your resource packs and the last 50 lines of the log.

The launcher's Settings page has a Logs row with an Open button. On the command line, horizon-launcher logs --crash prints the newest crash report and horizon-launcher logs --lines 200 the end of the log.

What to try first

  • The game does not start, or crashes straight away. Update the launcher and Horizon, and your graphics drivers. On Windows, try Graphics API: DirectX 12 (see Settings).
  • "Not prepared" or "Minecraft 26.3 was not found". Play 26.3 once in the official Minecraft launcher, or point the launcher at your Minecraft folder (Choose… next to Minecraft folder on the Play page), then choose Prepare again.
  • Preparation says Java 25 is needed. Install a Java 25 JDK, for example Eclipse Temurin 25.
  • Slow or stuttering. Lower the render distance, turn LOD off, or pick the Performance preset. The performance overlay (Video, Advanced, Overlay) shows what is slow.
  • A resource or shader pack broke something. Switch it off, or take it out of its folder.

Reporting a bug

Good places, in this order:

  1. GitHub issues: github.com/ludovic111/horizon/issues. Search first; someone may have reported it already.
  2. Discord: the bugs channel on our Discord server, if you would rather talk it through.

Include:

  • what you did and what you expected;
  • your Horizon version (shown on the launcher's Play page) and the launcher's version;
  • your system and graphics card;
  • the crash report, or the end of latest.log, if there is one. Read it first: logs can hold your player name and server addresses, and lines of chat.

A Horizon bug is any place where it differs from vanilla 26.3, so "vanilla does X and Horizon does Y" is the best report there is.

Data the launcher can send

The launcher can send performance statistics, crash reports, bug reports and benchmarks, but only the kinds you allow, and everything is off until you say yes. The game also sends an anonymous "I'm playing" ping while it runs, for the live player count. See Privacy for what is sent, how long it is kept and how to delete it.