Merge origin/main into feat/lan-levels-check
tools/lan_e2e.py: main added the minecarts, frames, lightning and riding checks; levels stays last (it moves the players between dimensions, and skips itself without --server-thread). CHECKS and CHECK_FNS: 66 each. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@@ -20,7 +20,7 @@ To play, use [the launcher](../launcher/README.md); the project site is [playhor
|
||||
- [Resource packs](resource-packs.md): everything a 26.3 resource pack can change, whether Horizon honours it, and the proof.
|
||||
- [Opt-in data collection](telemetry.md): the consent, exactly what is sent, how it is stored and sent.
|
||||
- [Benchmark report format](benchmark-report.md): the versioned JSON every benchmark writes (game, launcher, `tools/perf_bench.py`), the local log and, with consent, the upload.
|
||||
- Menus: the title, world list, create world, multiplayer, options and pause screens share the launcher's design tokens and fonts (`crates/horizon-theme`), drawn by `ui_theme` over a live frozen backdrop (`game/backdrop.rs`, blurred and graded by `post.rs`). Options → Interface → Menu style switches to vanilla's screens (Classic, kept in `horizon.txt`; `HORIZON_MENU_STYLE=horizon|classic` overrides it, and scripted runs default to Classic). [Title](media/menu-title.png) ([webm](media/menu-title.webm)), [worlds](media/menu-worlds.png), [options](media/menu-options.png), [pause](media/menu-pause.png).
|
||||
- Menus: every screen is vanilla's (title, world list, create world, multiplayer, options, pause). Horizon's own settings hang off vanilla's Options the way mods add theirs: **Horizon Settings...** and **Mods...** in the last two slots of the Options grid (Horizon Settings opens Graphics, Advanced Graphics, Shader Packs, Controller Settings, Extras and Mods, each a vanilla options list), with Horizon Graphics, Advanced Graphics and Shader Packs also at the top of Video Settings and Controller Settings at the bottom of Controls. The title screen's and pause menu's Friends buttons open Join a Friend and Play with Friends ([play-with-friends.md](play-with-friends.md)).
|
||||
|
||||
## Parity
|
||||
|
||||
|
||||
@@ -29,7 +29,6 @@ Legend: **yes** complete, **part** partial (see note), **no** missing, **—** n
|
||||
| Dedicated server: start, console, log, stop | yes | yes | yes | |
|
||||
| Accounts (no secrets) | yes | yes | yes | names and UUIDs only; sign-in is a device code the player enters |
|
||||
| Launcher settings (game folder, auto-install, opening animation, desktop entry) | yes | part | no | CLI has `desktop-entry`; the rest only in the window |
|
||||
| Game menu style | yes | yes | yes | |
|
||||
| Logs, crash report | yes | yes | yes | |
|
||||
| Updates (Horizon and launcher) | yes | yes | yes | MCP only checks |
|
||||
| Patch notes, links | yes | yes | yes | |
|
||||
@@ -76,7 +75,7 @@ Legend: **yes** complete, **part** partial (see note), **no** missing, **—** n
|
||||
|
||||
| Capability | Before | After |
|
||||
| --- | --- | --- |
|
||||
| Screens: widgets | labelled buttons only | every widget of every screen (`ui`): id, kind, label, bounds, slider value, tab selected, slots with stacks; both menu styles |
|
||||
| Screens: widgets | labelled buttons only | every widget of every screen (`ui`): id, kind, label, bounds, slider value, tab selected, slots with stacks |
|
||||
| Screens: act on a widget | `click-button LABEL`, `click-at X Y` | `click ID [right\|middle] [shift]`, `set ID VALUE` (sliders), `click` focuses fields |
|
||||
| Options | open a page; `render-distance` only | `options-get` all 193 `options.txt` options typed with ranges/choices; `options-set` validates, applies, saves |
|
||||
| Waits | `wait TICKS`, `wait-ready` | `wait-for screen\|widget\|loaded\|chat\|event` with timeout errors |
|
||||
@@ -111,7 +110,7 @@ Legend: **yes** complete, **part** partial (see note), **no** missing, **—** n
|
||||
### Structured UI: the widget tree
|
||||
|
||||
`ui` returns every interactive element the last frame drew, on every screen (title menus,
|
||||
pause, options pages, inventories and stations, chat, death, Horizon-style menus):
|
||||
pause, options pages, inventories and stations, chat, death, Play with Friends):
|
||||
|
||||
```json
|
||||
{"screen": "options", "gui_size": [427, 240], "frame": 3061,
|
||||
@@ -126,8 +125,7 @@ pause, options pages, inventories and stations, chat, death, Horizon-style menus
|
||||
`Video Settings...` → `video-settings`); a repeated slug gets `-2`, `-3` in draw order;
|
||||
unlabelled elements are `<kind>-<n>` in draw order. The id of a slider does not change
|
||||
when its value (and so its label) does. World, server and language rows carry their
|
||||
names; Horizon-style switches, sliders and segments carry their settings row's caption
|
||||
(`vsync`, `menu-style-horizon`); inventory, creative and menu slots are `slot-<ID>` with
|
||||
names; inventory, creative and menu slots are `slot-<ID>` with
|
||||
their stack (an item tab's display slots are `slot-900` up).
|
||||
- **Kinds**: `button`, `slider` (`value` 0..1 as drawn), `field` (text box), `row` (list
|
||||
entry: world, server, pack, language), `tab` (`selected`), `slot`.
|
||||
|
||||
@@ -97,9 +97,8 @@ real mouse hands control back at once.
|
||||
|
||||
Every interactive rectangle a screen draws registers itself as a focus
|
||||
target with its kind (`widgets::target_as`): classic buttons, sliders, edit
|
||||
boxes and list rows (worlds, servers, languages), every Horizon-style widget
|
||||
(`ui_theme::Ui::interact`: sidebar items, switches, segments, sliders,
|
||||
fields, buttons), inventory and container slots, creative and recipe-book
|
||||
boxes and list rows (worlds, servers, languages), icon buttons (the title's
|
||||
and pause menu's Friends button), inventory and container slots, creative and recipe-book
|
||||
tabs, and the stations' own buttons (trades, loom patterns, beacon effects,
|
||||
enchantments, stonecutter recipes, the recipe book's recipes, pages and
|
||||
filter). A screen that registers nothing falls back to the pointer.
|
||||
@@ -137,16 +136,11 @@ the crafting result, armour to the player's grid.
|
||||
- **Where focus lands** when a screen opens: the held hotbar slot in an
|
||||
inventory, else the first button.
|
||||
|
||||
How it looks follows the menu style:
|
||||
|
||||
- **Classic screens** look as vanilla's own keyboard focus does: buttons,
|
||||
sliders and slots show their highlighted sprite (`isHoveredOrFocused`,
|
||||
drawn because the hidden pointer is over them), and list rows and text
|
||||
fields get vanilla's white one-pixel outline (`AbstractSelectionList`'s
|
||||
focused selection, `EditBox`'s highlighted border).
|
||||
- **Horizon-style screens** get the design system's focus colour: a two-dp
|
||||
ring in the accent colour around the focused widget, pill-shaped on
|
||||
buttons, tabs and sliders.
|
||||
It looks as vanilla's own keyboard focus does: buttons, sliders and slots
|
||||
show their highlighted sprite (`isHoveredOrFocused`, drawn because the hidden
|
||||
pointer is over them), and list rows and text fields get vanilla's white
|
||||
one-pixel outline (`AbstractSelectionList`'s focused selection, `EditBox`'s
|
||||
highlighted border).
|
||||
|
||||
### Pointer
|
||||
|
||||
@@ -183,8 +177,8 @@ Steam + X opens it at any time. "On-Screen Keyboard: Auto / Horizon / Steam"
|
||||
Both modes reach every screen through the pointer events. Focus mode
|
||||
registers targets on: the title menus (main, world list and its search, create
|
||||
and edit world, delete, multiplayer list and its edit screens), every options
|
||||
page (classic pages and the Horizon-style sections, key and controller binds,
|
||||
language list), pause, death, chat, signs and books (their buttons), the
|
||||
page (vanilla's and Horizon Settings with the pages it opens, key and
|
||||
controller binds, language list), pause and Play with Friends, death, chat, signs and books (their buttons), the
|
||||
survival and creative inventories, every container and station (chests,
|
||||
furnaces, brewing, crafter, crafting table with its recipe book, anvil,
|
||||
grindstone, smithing, stonecutter, loom, cartography, enchanting, beacon,
|
||||
@@ -212,8 +206,10 @@ hints, "Press X to dismount") only while the pad is the last-used input.
|
||||
|
||||
## Options and remapping
|
||||
|
||||
Controller settings are Horizon's own and live in `horizon-controller.txt`
|
||||
next to `options.txt`, like `horizon-graphics.txt`: `options.txt` stays
|
||||
Controller settings are Horizon's own: **Options → Controls → Controller
|
||||
Settings...** (or **Options → Horizon Settings... → Controller Settings...**),
|
||||
a vanilla options list with **Controller Binds...** at the top. They live in
|
||||
`horizon-controller.txt` next to `options.txt`, like `horizon-graphics.txt`: `options.txt` stays
|
||||
exactly vanilla's, so a vanilla client can share the game folder.
|
||||
|
||||
```
|
||||
@@ -490,8 +486,8 @@ The first round (input layer, menus, glyphs and options, rumble) shipped in
|
||||
PRs #120, #129, #145 and #149. The second round, each shippable alone:
|
||||
|
||||
1. **Focus navigation** (this section above): the menu navigation option,
|
||||
focus targets and vanilla's arrow-key step, the focus highlight in both
|
||||
menu styles, the on-screen keyboard.
|
||||
focus targets and vanilla's arrow-key step, vanilla's focus highlight,
|
||||
the on-screen keyboard.
|
||||
2. **Button prompts**: contextual hints with the pad's glyphs in menus and
|
||||
optionally in game, and rebinding from them.
|
||||
3. **DualSense output** (above): the HID output layer and rumble through it
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
# Horizon's design system
|
||||
|
||||
One design language for the launcher, the website and the game's own menus (what "Menu style:
|
||||
Horizon" draws). Vanilla's classic screens and the HUD are not part of it: they stay exactly
|
||||
vanilla, because parity is the point of the game.
|
||||
One design language for the launcher, the website and the few overlays the game draws that
|
||||
vanilla has no screen for (the on-screen keyboard a controller types with). Every game screen
|
||||
and the HUD are not part of it: they are vanilla's, because parity is the point of the game, and
|
||||
Horizon's own settings are pages built from vanilla's widgets, the way mods add theirs.
|
||||
|
||||
The tokens live in one place, `crates/horizon-theme`. The launcher (`launcher/src/theme.rs`)
|
||||
and the game (`crates/horizon-client/src/ui_theme.rs`) read them as Rust constants, and the
|
||||
@@ -139,16 +140,35 @@ Geist (400, 500, 600) and Geist Mono (400), bundled under the SIL Open Font Lice
|
||||
are index lists with the release name as the title; Settings is an index list of switches and
|
||||
values. The opening is the faint wordmark drawn letter by letter, then the interface arrives.
|
||||
The sunset photograph is gone: the window is the page colour, light or dark with the system.
|
||||
- **Website** (`website/`): the same page structure as before (what it is, screenshots,
|
||||
parity, launcher, patch notes, community), each section a `micro` mono label, a `display`
|
||||
heading and a short paragraph, its content an index list. Screenshots stay as images (radius
|
||||
12, no frame). Light and dark follow the system, with a toggle. A giant faint wordmark sits
|
||||
above the footer. No hero photograph: the first screen is the headline, one paragraph, the
|
||||
download button and the parity score as an index row.
|
||||
- **Game menus** (Horizon style): the title backdrop under a page-colour veil; text sidebar;
|
||||
index lists for worlds and servers; options pages as index lists of rows (label left, value
|
||||
in mono, the control right). The pause menu is a centred column of plain rows over a darker
|
||||
veil.
|
||||
- **Website** (`website/`): the Blocks look below. The same page structure as before (what it
|
||||
is, screenshots, parity, launcher, patch notes, community), headings in Pixelify Sans, lists as
|
||||
stacks of panels, the stone texture behind the page and Horizon's pixel landscape (a dawn or a
|
||||
sunset) behind the hero. Light and dark follow the system, with a toggle. A giant wordmark in
|
||||
pixels sits in the footer.
|
||||
- **Game**: vanilla's screens. The on-screen keyboard is a rounded plate of keys in the page
|
||||
colour, the focused key in the accent.
|
||||
|
||||
## Blocks
|
||||
|
||||
A blocky, Minecraft-like look in Horizon's purple, for the website and the redesigned launcher:
|
||||
Minecraft's inventory rather than a document. Its colours are `horizon_theme::Blocks`
|
||||
(`BLOCKS_LIGHT`, `BLOCKS_DARK`), which `tokens.css` carries under the same names as before plus
|
||||
`--panel`, `--raised`, `--button`, `--well`, `--bevel`, `--lip`, `--outline` and the `--face`
|
||||
of the main action. The game's menus keep `LIGHT` and `DARK`.
|
||||
|
||||
- **Pixel type for what names and what you act on.** Headings, navigation, buttons and the
|
||||
wordmark use Pixelify Sans (OFL; Medium, SemiBold, Bold); paragraphs and numbers stay in Geist
|
||||
and Geist Mono so long text reads easily.
|
||||
- **Blocks, not rounded cards.** Every surface is square: a 2 px dark outline, a 2 px light bevel
|
||||
along the top and a darker lip along the bottom. The main action is the violet face with its own
|
||||
bevel and a 4 px lip; it sinks a pixel when pressed. Code and fields are sunk wells.
|
||||
- **Pixel art drawn in code.** The stone behind the pages is 64 texels of the page colour in five
|
||||
close shades (`TILE_SHADES`), never Minecraft's stone; the landscape is a banded sky, a sun cut in
|
||||
slices like the mark, hills and square trees. `website/scripts/art.mjs` draws both.
|
||||
- **Icons** (the launcher): Pixelarticons (MIT), 24 unit pixel SVGs in
|
||||
`crates/horizon-theme/icons/pixel/`.
|
||||
- **Contrast**: every text colour meets WCAG AA (4.5:1) on the panels, the page and the lightest
|
||||
stone shade in both palettes (`blocks_text_meets_wcag_aa_in_both_appearances`).
|
||||
|
||||
## The mark
|
||||
|
||||
|
||||
@@ -19,11 +19,12 @@ again restores vanilla's behaviour completely.
|
||||
| Game glue (input hooks, per-frame update) | `crates/horizon-client/src/game/extras.rs` |
|
||||
| Mouse Tweaks-style controls, sort buttons | `crates/horizon-client/src/game/tweaks.rs` |
|
||||
| Sort order and its clicks | `crates/horizon-client/src/inv_sort.rs` (pure, unit tested) |
|
||||
| The settings page | `options_horizon.rs`: the **Extras** section of Horizon's Options |
|
||||
| The settings page | `options_ui.rs` (`Page::Extras`): **Options → Horizon Settings... → Extras...** |
|
||||
|
||||
The settings are grouped by extra. On Horizon's page an extra's own settings
|
||||
(its key, corner, size...) show under its switch while it is on (`Item::parent`);
|
||||
Classic's Horizon Extras screen lists them all, two buttons to a row.
|
||||
The settings are grouped by extra, under a header each, two buttons to a row as
|
||||
vanilla's options lists are, and each says what it does in its tooltip. An
|
||||
extra's own settings (its key, corner, size...) are greyed out while its switch
|
||||
is off (`Item::parent`).
|
||||
|
||||
`game.rs` only gets one-line hooks (key, wheel, mouse, frame, HUD), so the
|
||||
extras stay out of the way of other input and options work.
|
||||
|
||||
@@ -2,17 +2,17 @@
|
||||
|
||||
## Settings
|
||||
|
||||
In the Horizon menu style, the Options screen's **Video** section holds the graphics settings, with a Simple / Advanced switch at the top (remembered between sessions):
|
||||
Horizon's graphics settings are two screens built from vanilla's widgets, opened from the top of **Video Settings** (**Horizon Graphics...** and **Advanced Graphics...**, beside **Shader Packs...**, where Sodium and Iris put theirs) or from **Options → Horizon Settings...**:
|
||||
|
||||
- **Simple**: a preset (Performance, Balanced, Quality, Ultra or Custom), render distance, LOD distance, FOV, max framerate, VSync and GUI scale.
|
||||
- **Advanced**: every setting, grouped under Rendering, Quality, Display, Preferences, Performance and Overlay.
|
||||
- **Graphics** (Simple): a preset (Performance, Balanced, Quality, Ultra or Custom) and LOD distance.
|
||||
- **Advanced Graphics**: every Horizon setting, grouped under Rendering, Quality, Display, Preferences, Performance and Overlay.
|
||||
|
||||
In the Classic style, Video Settings starts with two buttons opening the same settings as vanilla-looking screens.
|
||||
Vanilla's own settings (render distance, FOV, framerate, VSync, GUI scale, smooth lighting...) stay where vanilla has them, in Video Settings; both screens leave them out.
|
||||
|
||||
Every row has a one-line description and its cost in frame time (none, low, medium, high, or saves time for culling that makes frames faster), and applies at once, except worker threads, which apply at the next start. A preset sets the quality settings together; changing one of them turns it into Custom. Display preferences (FOV, framerate, VSync, GUI scale, fullscreen, present mode, pacing) leave the preset as it is.
|
||||
|
||||

|
||||

|
||||

|
||||

|
||||
|
||||
| Group | Setting | Stored in |
|
||||
| --- | --- | --- |
|
||||
@@ -29,7 +29,7 @@ Every row has a one-line description and its cost in frame time (none, low, medi
|
||||
|
||||
**Battery mode** (Performance, off by default) is for laptops and handhelds: at most 60 frames per second in a world, 30 in menus without a world or while another window has focus, and half the automatic worker threads (chunks load slower). It changes only when frames are drawn: what they show and the game's 20 ticks per second stay as they are.
|
||||
|
||||
Which settings each level shows, their descriptions and costs are in `crates/horizon-client/src/graphics_ui.rs` (`rows`); the Horizon shell draws them in `options_horizon.rs` with `ui_theme::described_row`, and the Classic screens use `graphics_style.rs`.
|
||||
Which settings each screen shows, their descriptions and costs are in `crates/horizon-client/src/graphics_ui.rs` (`rows`); `graphics_style.rs` draws them.
|
||||
|
||||
## Distant terrain
|
||||
|
||||
|
||||
|
Before Width: | Height: | Size: 95 KiB |
|
Before Width: | Height: | Size: 569 KiB |
|
Before Width: | Height: | Size: 194 KiB |
|
Before Width: | Height: | Size: 376 KiB |
|
Before Width: | Height: | Size: 23 KiB |
|
Before Width: | Height: | Size: 191 KiB |
|
Before Width: | Height: | Size: 16 KiB |
|
Before Width: | Height: | Size: 1.0 MiB After Width: | Height: | Size: 289 KiB |
|
Before Width: | Height: | Size: 569 KiB After Width: | Height: | Size: 218 KiB |
|
Before Width: | Height: | Size: 37 KiB After Width: | Height: | Size: 76 KiB |
@@ -110,7 +110,7 @@ loading. Ordered by what the first native ports need ([research](research/java-m
|
||||
| `target` | the crosshair's block or entity, with its state and NBT summary | Jade/WTHIT-style tooltips |
|
||||
| `inventory-read` | the player's inventory, held item, open container | AppleSkin, recipe viewers |
|
||||
| `recipes` | the recipe registry and lookups | JEI/EMI-style viewers |
|
||||
| `ui` | widgets: text, item icons, lists, a screen the mod owns, a settings page in Options > Mods | built on `ui_theme` so it matches the menus |
|
||||
| `ui` | widgets: text, item icons, lists, a screen the mod owns, a settings page in Options > Mods | built from vanilla's widgets (`ui`) so it matches the menus |
|
||||
| `world-read` | blocks and biomes around the player, within the render distance | minimaps, schematics |
|
||||
| `render` | world-space lines, boxes and ghost blocks in a per-frame budget | Litematica-style placement, waypoints |
|
||||
| `registries` | new blocks, items, entities and recipes, mostly data: JSON models, textures, loot and recipes in the `.hmod`'s `assets/` and `data/` | server side; see [Multiplayer](#multiplayer) |
|
||||
|
||||
@@ -119,7 +119,7 @@ game accepts, test hooks included.
|
||||
`place X Y Z [--item ITEM]`, `interact X Y Z` (doors, chests, crafting
|
||||
tables), `use-item [--hold S]` (eat, drink, throw), `select SLOT|ITEM`, `drop`.
|
||||
- **Widgets:** `ui` lists every widget of the open screen (title menus, pause,
|
||||
options pages in both menu styles, inventories and menus): an id, its kind
|
||||
options pages, inventories and menus): an id, its kind
|
||||
(`button`, `slider` with its 0..1 `value`, `field`, `row`, `tab` with
|
||||
`selected`, `slot` with its stack), the label and its bounds. Ids come from
|
||||
labels (`FOV: 70` is `fov`, `Video Settings...` is `video-settings`, a
|
||||
@@ -144,7 +144,7 @@ game accepts, test hooks included.
|
||||
- **Screens:** `open-inventory`, `click-slot SLOT [right] [shift]` (0-8 hotbar,
|
||||
9-35 inventory, 100+ crafting grid, 200 result, 300+ containers, 500-503
|
||||
armor, 504 offhand, 600+ stations), `close`, `click-button LABEL` (any
|
||||
button of any screen or title menu, classic or Horizon style, by its label),
|
||||
button of any screen or title menu, by its label),
|
||||
`click-at X Y`, `type TEXT` (on the create-world screen `--field name|seed
|
||||
--replace`), `chat`, `command`, `respawn`, `pause`, `resume`.
|
||||
- **World:** `tp`, `give`, `time`, `setblock`, `summon`, `wait TICKS`, and the
|
||||
|
||||
@@ -1,7 +1,8 @@
|
||||
# Play with friends
|
||||
|
||||
A player opens their single-player world to friends with one click and gets an **invite code**.
|
||||
Friends paste the code (on the multiplayer screen in game, or on the launcher's Play page) and join.
|
||||
Friends paste the code (in game: the title screen's Friends button opens Join a Friend, and Direct
|
||||
Connection takes a full code too; or on the launcher's Play page) and join.
|
||||
There is no Horizon server in the middle and no account: the code itself says where the host is and
|
||||
holds the key that encrypts the game between them.
|
||||
|
||||
@@ -22,7 +23,8 @@ bytes vanilla's protocol would send, between a loopback port on each side.
|
||||
|
||||
## How it works
|
||||
|
||||
**Hosting.** "Invite friends" (in Horizon's pause menu) opens the world to LAN if it isn't (Open to
|
||||
**Hosting.** The pause menu's Friends button (vanilla's icon, beside Player Reporting) opens **Play
|
||||
with Friends** (`friends_screen.rs`); its **Start Sharing** opens the world to LAN if it isn't (Open to
|
||||
LAN's defaults), then the host's game, on its own:
|
||||
|
||||
1. listens on its **direct port**, TCP 25580 by default (the same port every time, so a port forwarded
|
||||
@@ -59,7 +61,8 @@ port closes, the router mapping is deleted). Sharing again makes a new secret.
|
||||
|
||||
## When friends can't reach the host
|
||||
|
||||
The host's panel says what to expect, from what the game found:
|
||||
Play with Friends says what to expect, from what the game found; when friends on the internet can't
|
||||
reach the host, its **Troubleshooting...** button (beside Done) opens this section in the browser:
|
||||
|
||||
| What the game found | What the host reads |
|
||||
| --- | --- |
|
||||
|
||||
@@ -44,8 +44,7 @@ Everything is in `crates/horizon-client/src/gfx.rs`, `Renderer::render`, one com
|
||||
4. **Screen effects** (`screen_effects.rs`): pumpkin blur, portal, powder snow, vignette, nausea, as
|
||||
full-screen quads.
|
||||
5. **Menu blur** (`menu_blur.rs`, `menu_blur.wgsl`): vanilla's `menuBackgroundBlurriness` behind screens.
|
||||
6. **Menu grade** (`post.rs`, `post.wgsl`): the Horizon menus' frosted backdrop.
|
||||
7. **HUD** (`hud.rs`, `hud.wgsl`): GUI, text, items in slots.
|
||||
6. **HUD** (`hud.rs`, `hud.wgsl`): GUI, text, items in slots.
|
||||
|
||||
All world shaders share one uniform block, `Globals` in `gfx.rs` (`struct Globals` in `terrain.wgsl`):
|
||||
view-projection, inverse view, fog colour and distances, sky colour, sun direction, sunrise colour, game time.
|
||||
@@ -60,8 +59,8 @@ The lightmap, fog and sky colours are computed on the CPU (`environment.rs`, `fo
|
||||
`~/Library/Application Support/horizon` on macOS, `~/.local/share/horizon` on Linux), not the launcher's version
|
||||
folder. A pack with a `pack.toml` at its root is a Horizon pack; a folder with `shaders/`, or a `.zip`, is a Java
|
||||
pack.
|
||||
- The **Shader Packs** page lists them: a sidebar section in the Horizon menus, **Video Settings → Shader Packs...**
|
||||
in the Classic ones, and the Shader Pack row of the graphics settings leads to it. It shows the folder's full path
|
||||
- The **Shader Packs** page lists them: **Video Settings → Shader Packs...** (where Iris puts its button), **Options →
|
||||
Horizon Settings... → Shader Packs...**, and the Shader Pack row of the graphics settings lead to it. It shows the folder's full path
|
||||
and an *Open Folder* button (the folder is made if it is missing), then one switch per pack: turning one on picks
|
||||
it, turning it off is the vanilla picture. With no pack, it says so under the path. The list is read again every
|
||||
second while the page is open, so a pack dropped into the folder shows up.
|
||||
|
||||
@@ -45,7 +45,8 @@ Never sent: account names or UUIDs, world names, server or LAN addresses, chat,
|
||||
- `telemetry/outbox/` holds one JSON file per item, `<day>-<kind>-<random>.json`. It never holds more than 200 items or 2 MiB, and the oldest go first. `kept.json` counts today's items per kind against the caps above.
|
||||
- The launcher sends the outbox when it starts and when it closes. Items go as one JSON batch (`{"schema":1,"install_id":…,"items":[…]}`, up to 64 items and 1 MiB), compressed with zstd: `POST /v1/batch` with `Content-Encoding: zstd`. A day's perf summaries are under 2 KB on the wire.
|
||||
- After a failure the launcher waits a minute, doubling up to a day, and sends at most 8 batches a day. A batch the server refuses with a 4xx (not 429) is dropped.
|
||||
- `HORIZON_TELEMETRY_URL` sets the server. There is none by default: until there is, nothing is sent and the outbox stays within its caps.
|
||||
- The server is `https://telemetry.playhorizon.dev` (`DEFAULT_ENDPOINT`), on Railway in the EU (`europe-west4`, Amsterdam). `HORIZON_TELEMETRY_URL` names another one (a local server); `HORIZON_TELEMETRY_URL=off` sends nothing at all, no ping either. Tests, CI and the benchmark and test harnesses set `off`.
|
||||
- What is sent still depends on the switches: with every switch off nothing but the ping leaves, and the outbox stays empty.
|
||||
- `SCHEMA` versions the format. New optional fields keep it. A field that changes meaning or goes bumps it, and the server keeps reading the older ones.
|
||||
|
||||
## The "I'm playing" ping
|
||||
@@ -68,13 +69,14 @@ The server keeps sessions in memory only, never on disk, and never with the send
|
||||
{ "playing": 1240, "lan": 85, "versions": { "v2026.10.22": 1100, "other": 140 }, "platforms": { "linux": 300, "macos": 240, "windows": 700 } }
|
||||
```
|
||||
|
||||
The launcher reads it when it opens and every minute after, and shows "N playing now" on the Play page. It shows nothing when the server can't be reached. Like the rest, there is no server by default (`HORIZON_TELEMETRY_URL`): until there is one, the game sends no ping and the launcher shows no count. `HORIZON_NO_HEARTBEAT=1` keeps automated runs out of the count.
|
||||
The launcher reads it when it opens and every minute after, and shows "N playing now" on the Play page. It shows nothing when the server can't be reached. `HORIZON_TELEMETRY_URL=off` turns both off; `HORIZON_NO_HEARTBEAT=1` keeps a single automated run out of the count.
|
||||
|
||||
## Server
|
||||
|
||||
- `POST /v1/batch`
|
||||
- `DELETE /v1/installs/<install_id>`: deletes everything sent under that ID.
|
||||
- `GET /v1/aggregate`: the anonymous totals the website's results page reads.
|
||||
- `GET /v1/benchmarks/summary`: players' benchmark uploads grouped by GPU, CPU, render distance and game for playhorizon.dev/benchmarks. A group shows only with at least 3 different installs, and only its medians and counts: no install ID, day, OS version, driver, memory or screen. Uploads are never published one by one.
|
||||
- `POST /v1/live` and `GET /v1/live`: the "I'm playing" ping and the live count.
|
||||
|
||||
`crates/horizon-telemetry-server` is the server. Its [README](../crates/horizon-telemetry-server/README.md) covers storage (about 190 bytes per play session), retention (180 days of raw rows, anonymous daily totals kept), rate limits and hosting.
|
||||
`crates/horizon-telemetry-server` is the server, at `https://telemetry.playhorizon.dev` on Railway (one SQLite file on a volume, region `europe-west4`). Its [README](../crates/horizon-telemetry-server/README.md) covers storage (about 190 bytes per play session), retention (180 days of raw rows, anonymous daily totals kept), rate limits and hosting.
|
||||
|
||||