From 612779045634e897b71a05112f0fe9b910e8fdc0 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 01:24:30 +0200 Subject: [PATCH 001/126] Switch releases to 0.2 (merge only when Ludovic says go) .github/release-line.txt = 0.2: the release train's next runs publish v0.2.0 (a beta, as always) and launcher@0.2.0 at once, "the first release of 0.2" (docs/versioning.md). Merge it only after the bridges (the last dated game release, made stable, and launcher-v0.17.0) are out: the go-day steps are in docs/versioning.md. Also, because they say 0.2 is out: the site's FAQ explains the numbers, Install says an old launcher updates twice, hosting.md gives the one command for a server that says it is up to date, and the launcher's Cargo.toml says 0.2.0 so builds from source (packages) are on the 0.2 line. Co-Authored-By: Claude Opus 5.5 --- .github/release-line.txt | 1 + docs/hosting.md | 4 +++- launcher/Cargo.lock | 2 +- launcher/Cargo.toml | 2 +- website/docs/faq.md | 4 ++++ website/docs/install.md | 2 +- 6 files changed, 11 insertions(+), 4 deletions(-) create mode 100644 .github/release-line.txt diff --git a/.github/release-line.txt b/.github/release-line.txt new file mode 100644 index 000000000..3b04cfb60 --- /dev/null +++ b/.github/release-line.txt @@ -0,0 +1 @@ +0.2 diff --git a/docs/hosting.md b/docs/hosting.md index 963083b16..2cfe64231 100644 --- a/docs/hosting.md +++ b/docs/hosting.md @@ -240,7 +240,9 @@ If the new game crashes or doesn't come up in time, the server goes back to the and puts the world back as it was just before the switch (the world the new game left is kept in `backups/`). `horizon-server rollback` goes back to the release before by hand, keeping the world as it is (it backs it up first). `--version vX.Y.Z` installs a given release, and `--archive FILE --version NAME` an -archive you have, such as your own build. A stopped server is switched and starts on the new release next +archive you have, such as your own build. A server still on a release from before the last dated one doesn't know +that 0.2 comes after the dated releases and says it is up to date: run `horizon-server update --version v0.2.0` +once ([versioning](versioning.md)). A stopped server is switched and starts on the new release next time. Set `HORIZON_NO_UPDATE_CHECK=1` in the server's environment to turn the check off. Coming: `console` (attach to a server running in the background), `ban` and `pardon` as their own diff --git a/launcher/Cargo.lock b/launcher/Cargo.lock index b48a90543..357460f7e 100644 --- a/launcher/Cargo.lock +++ b/launcher/Cargo.lock @@ -2661,7 +2661,7 @@ dependencies = [ [[package]] name = "horizon-launcher" -version = "0.1.5" +version = "0.2.0" dependencies = [ "clap", "dirs 5.0.1", diff --git a/launcher/Cargo.toml b/launcher/Cargo.toml index d6225cb96..cc68424af 100644 --- a/launcher/Cargo.toml +++ b/launcher/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "horizon-launcher" -version = "0.1.5" +version = "0.2.0" edition = "2021" license = "MIT" description = "Downloads, prepares and starts Horizon builds" diff --git a/website/docs/faq.md b/website/docs/faq.md index 6a3ae24ef..cd6c55dac 100644 --- a/website/docs/faq.md +++ b/website/docs/faq.md @@ -62,6 +62,10 @@ Only if you say yes, and each kind has its own switch. Everything is off by defa Often. Every change players can see is released automatically after it is merged, so new versions can come out several times a day. The launcher installs them for you, or only stable ones if you leave **Beta builds** off. See [Install](/docs/install#updating). +## What do the version numbers mean? + +Since 0.2, every release has a number: 0.2.0, then 0.2.1, 0.2.2 and so on, one for each release. The game and the launcher are both on 0.2 and count on their own, so you can play Horizon 0.2.7 with launcher 0.2.3. A bigger step, such as 0.3, is announced when it comes. Releases before 0.2 were named after the day they came out (2026.10.19.15); every 0.2 release is newer than all of them. + ## How do I report a bug? See [Logs, crashes and bug reports](/docs/troubleshooting). diff --git a/website/docs/install.md b/website/docs/install.md index 1ac3da95a..d67e68c08 100644 --- a/website/docs/install.md +++ b/website/docs/install.md @@ -35,7 +35,7 @@ The game opens on Horizon's own title screen. Your worlds, options and logs live ## Updating - **Horizon.** The launcher looks for a new release when it starts and every four hours while it is open. With **Install new versions automatically** on (the default), it installs one and moves you to it if you were on the newest. New releases come out many times a day, and old versions stay installed until you remove them on the **Versions** page. -- **The launcher.** It updates itself from its own releases, then shows **Restart** in its footer. +- **The launcher.** It updates itself from its own releases, then shows **Restart** in its footer. A launcher from before 0.2 (0.16 or older) updates twice in a row: first to 0.17, then to 0.2. Then it installs Horizon 0.2 like any update. ## Stable and beta builds From 2ecbdd57ebfc50459e4cd5017cbe24f3a790ae8a Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 22 Oct 2026 00:46:17 +0000 Subject: [PATCH 002/126] Mob pushes: one list per mob once a crowd is pushing Pushes between mobs wait in a list until their target ticks; each mob's tick scanned the whole list, and take_mob_pushes removed each push from the events in place, shifting the rest. In a pen where every mob pushes its neighbours both grow with the square of the crowd per mob. The pending pushes stay a list while short (64) and become one list per mob past that, each in push order, so every velocity adds up the same values in the same order. take_mob_pushes splits the events in one pass, keeping the order of the others. A test checks velocities bit for bit and the remaining events against the old code. 30 mobs pushing each other: 0.11 -> 0.04 ms per tick 100 mobs pushing each other: 1.73 -> 0.37 ms 200 mobs pushing each other: 9.07 -> 2.61 ms Co-Authored-By: Claude Opus 5.5 (1M context) Claude-Session: https://claude.ai/code/session_01UxXpf7d4RgpespL2G2UsGE --- .../horizon-client/examples/mob_ai_probe.rs | 2 +- crates/horizon-client/src/game/creatures.rs | 2 +- crates/horizon-client/src/mobs.rs | 282 +++++++++++++++++- 3 files changed, 270 insertions(+), 16 deletions(-) diff --git a/crates/horizon-client/examples/mob_ai_probe.rs b/crates/horizon-client/examples/mob_ai_probe.rs index 2a4969221..974293ee5 100644 --- a/crates/horizon-client/examples/mob_ai_probe.rs +++ b/crates/horizon-client/examples/mob_ai_probe.rs @@ -1132,7 +1132,7 @@ fn main() -> horizon_client::Result<()> { } #[allow(unused_mut)] // filled only with the rng-trace feature let mut traces: Vec = Vec::new(); - let mut pushes = Vec::new(); + let mut pushes = horizon_client::mobs::PendingPushes::default(); let mut born = Vec::new(); for i in 0..mobs.len() { if mobs[i].removed { diff --git a/crates/horizon-client/src/game/creatures.rs b/crates/horizon-client/src/game/creatures.rs index 113558e34..baf968729 100644 --- a/crates/horizon-client/src/game/creatures.rs +++ b/crates/horizon-client/src/game/creatures.rs @@ -498,7 +498,7 @@ impl Game<'_> { // The level random, lent to the mobs (brain behaviours draw from // it) and taken back after their ticks. let mut scratch = self.world.random.clone(); - let mut pushes = Vec::new(); + let mut pushes = horizon_client::mobs::PendingPushes::default(); let mut keep = Vec::with_capacity(mobs.len()); let mut grid = horizon_client::mobs::seen_grid::SeenGrid::new(snapshot.iter().map(|s| s.bounds)); diff --git a/crates/horizon-client/src/mobs.rs b/crates/horizon-client/src/mobs.rs index c8155984c..2c19b9251 100644 --- a/crates/horizon-client/src/mobs.rs +++ b/crates/horizon-client/src/mobs.rs @@ -1308,31 +1308,67 @@ impl Mob { /// `Entity.push` on other mobs acts at once in vanilla: a mob ticking later /// moves with it this tick. Takes the `Push` events aimed at mobs out of /// `events[from..]` into `pending`, which the caller adds to each mob's -/// velocity before its tick (and to every mob once all have ticked). -pub fn take_mob_pushes(events: &mut Vec, from: usize, pending: &mut Vec<(u32, Vec3)>) { - let mut i = from; - while i < events.len() { +/// velocity before its tick (and to every mob once all have ticked). The +/// other events keep their order. +pub fn take_mob_pushes(events: &mut Vec, from: usize, pending: &mut PendingPushes) { + // One pass: a crowd's tick holds a push per neighbour, and removing each + // in place would shift the rest every time. + let mut kept = from; + for i in from..events.len() { if let MobEvent::Push { target: Who::Mob(id), velocity, } = events[i] { - pending.push((id, Vec3::new(velocity[0], velocity[1], velocity[2]))); - events.remove(i); + pending.push(id, Vec3::new(velocity[0], velocity[1], velocity[2])); } else { - i += 1; + events.swap(kept, i); + kept += 1; } } + events.truncate(kept); +} +/// Pushes waiting for their mob's tick, in push order. A list while short; +/// past [`PendingPushes::LIST_MAX`] (a crowd pushing each other) one list +/// per mob, as scanning the whole list for each mob grows with its square. +#[derive(Default)] +pub struct PendingPushes { + list: Vec<(u32, Vec3)>, + by_mob: crate::fast_hash::FxHashMap>, +} +impl PendingPushes { + const LIST_MAX: usize = 64; + pub fn push(&mut self, id: u32, v: Vec3) { + if self.by_mob.is_empty() && self.list.len() < Self::LIST_MAX { + self.list.push((id, v)); + return; + } + // Older pushes first, so each mob's stay in order. + for (id, v) in self.list.drain(..) { + self.by_mob.entry(id).or_default().push(v); + } + self.by_mob.entry(id).or_default().push(v); + } } /// Adds the pending pushes aimed at `m` to its velocity, in push order. -pub fn apply_mob_pushes(m: &mut Mob, pending: &mut Vec<(u32, Vec3)>) { - pending.retain(|(id, v)| { - if *id != m.id { - return true; - } +pub fn apply_mob_pushes(m: &mut Mob, pending: &mut PendingPushes) { + let mut add = |v: Vec3| { m.velocity = Vec3::new(m.velocity.x + v.x, m.velocity.y + v.y, m.velocity.z + v.z); - false - }); + }; + if !pending.list.is_empty() { + pending.list.retain(|(id, v)| { + if *id != m.id { + return true; + } + add(*v); + false + }); + } + if !pending.by_mob.is_empty() + && let Some(pushes) = pending.by_mob.remove(&m.id) + { + pushes.into_iter().for_each(add); + } } /// Applies the brain memories a mob's tick set on other mobs (from event /// index `from` on), at once: vanilla sets them on the other entity during @@ -2132,3 +2168,221 @@ mod elytra_tests { assert!((wings.angles[1] - 0.08726646).abs() < 0.00001); } } +#[cfg(test)] +mod push_tests { + use super::*; + use horizon_core::geometry::Vec3; + use serde_json::json; + + fn kind() -> Arc { + Arc::new(MobType { + id: "minecraft:cow".into(), + species: Species::Cow, + width: 0.9, + height: 1.4, + eye_height: 1.3, + category: "creature".into(), + max_health: 10.0, + speed: 0.2, + flying_speed: 0.4, + attack_damage: 0.0, + attack_knockback: 0.0, + follow_range: 16.0, + step_height: 0.6, + armor: 0.0, + armor_toughness: 0.0, + knockback_resistance: 0.0, + jump_strength: 0.42, + attributes: Arc::default(), + gravity: 0.08, + safe_fall_distance: 3.0, + fall_damage_multiplier: 1.0, + water_efficiency: 0.0, + water_slowdown: 0.8, + air_speed: 0.02, + baby_scale: 0.5, + head_rot_speed: 10.0, + max_head_x_rot: 40.0, + max_head_y_rot: 75.0, + ambient_interval: 120, + flags: Flags { + animal: true, + ..Default::default() + }, + model: Arc::new(Part::parse("root", &json!({}))), + layers: HashMap::new(), + texture: String::new(), + brain: Brain::Passive, + anim: Anim::Rabbit, + sounds: [""; 3], + step_sound: None, + food: Arc::default(), + tempt: Arc::default(), + }) + } + + /// The pending pushes as one list, scanned for each mob, as before. + fn take_old(events: &mut Vec, from: usize, pending: &mut Vec<(u32, Vec3)>) { + let mut i = from; + while i < events.len() { + if let MobEvent::Push { + target: Who::Mob(id), + velocity, + } = events[i] + { + pending.push((id, Vec3::new(velocity[0], velocity[1], velocity[2]))); + events.remove(i); + } else { + i += 1; + } + } + } + fn apply_old(velocity: &mut Vec3, id: u32, pending: &mut Vec<(u32, Vec3)>) { + pending.retain(|(to, v)| { + if *to != id { + return true; + } + *velocity = Vec3::new(velocity.x + v.x, velocity.y + v.y, velocity.z + v.z); + false + }); + } + fn mobs(n: u32) -> Vec { + let kind = kind(); + (0..n) + .map(|id| Mob::new(id, kind.clone(), Vec3::ZERO, 0.0)) + .collect() + } + /// A crowd tick: each mob takes its pushes, then pushes every other + /// mob (and the player, and hisses now and then); then all take theirs. + fn crowd_tick( + n: u32, + tick: u32, + mut on_push: impl FnMut(&mut Vec, usize), + mut on_apply: impl FnMut(u32), + ) -> Vec { + let mut events = Vec::new(); + for i in 0..n { + on_apply(i); + let from = events.len(); + for j in 0..n { + if j != i && !(i * 31 + j * 17 + tick).is_multiple_of(5) { + let f = f64::from(i * 7 + j + tick) * 0.001; + events.push(MobEvent::Push { + target: Who::Mob(j), + velocity: [f, -f * 0.5, f * 0.25], + }); + } + if j.is_multiple_of(9) { + events.push(MobEvent::Hiss { mob: j }); + } + } + events.push(MobEvent::Push { + target: Who::Player, + velocity: [0.1, 0.0, 0.1], + }); + on_push(&mut events, from); + } + for i in 0..n { + on_apply(i); + } + events + } + + #[test] + fn pushes_land_as_with_the_list() { + for n in [1u32, 3, 8, 20, 60] { + let mut new_mobs = mobs(n); + let mut old_v = vec![Vec3::ZERO; n as usize]; + let mut pending = PendingPushes::default(); + let mut old_pending = Vec::new(); + for tick in 0..4 { + let new_events = { + let pending = std::cell::RefCell::new(&mut pending); + let mobs = std::cell::RefCell::new(&mut new_mobs); + crowd_tick( + n, + tick, + |e, from| take_mob_pushes(e, from, &mut pending.borrow_mut()), + |i| { + apply_mob_pushes( + &mut mobs.borrow_mut()[i as usize], + &mut pending.borrow_mut(), + ) + }, + ) + }; + let old_events = { + let pending = std::cell::RefCell::new(&mut old_pending); + let v = std::cell::RefCell::new(&mut old_v); + crowd_tick( + n, + tick, + |e, from| take_old(e, from, &mut pending.borrow_mut()), + |i| { + apply_old( + &mut v.borrow_mut()[i as usize], + i, + &mut pending.borrow_mut(), + ) + }, + ) + }; + assert_eq!(format!("{new_events:?}"), format!("{old_events:?}")); + for i in 0..n as usize { + let (a, b) = (new_mobs[i].velocity, old_v[i]); + assert_eq!( + (a.x.to_bits(), a.y.to_bits(), a.z.to_bits()), + (b.x.to_bits(), b.y.to_bits(), b.z.to_bits()), + "{n} mobs, tick {tick}, mob {i}" + ); + } + } + } + } + + /// One tick of a pen of `n` mobs pushing each other. + #[test] + #[ignore] + fn push_cost() { + for n in [10u32, 30, 100, 200] { + let mut ms = mobs(n); + let mut v = vec![Vec3::ZERO; n as usize]; + let t = std::time::Instant::now(); + { + let pending = std::cell::RefCell::new(Vec::new()); + let v = std::cell::RefCell::new(&mut v); + crowd_tick( + n, + 0, + |e, from| take_old(e, from, &mut pending.borrow_mut()), + |i| { + apply_old( + &mut v.borrow_mut()[i as usize], + i, + &mut pending.borrow_mut(), + ) + }, + ); + } + let before = t.elapsed().as_secs_f64() * 1e3; + let t = std::time::Instant::now(); + { + let pending = std::cell::RefCell::new(PendingPushes::default()); + let ms = std::cell::RefCell::new(&mut ms); + crowd_tick( + n, + 0, + |e, from| take_mob_pushes(e, from, &mut pending.borrow_mut()), + |i| { + apply_mob_pushes( + &mut ms.borrow_mut()[i as usize], + &mut pending.borrow_mut(), + ) + }, + ); + } + let after = t.elapsed().as_secs_f64() * 1e3; + println!("{n} mobs pushing each other: {before:.3} ms -> {after:.3} ms"); + } + } +} From 14bd239141ffedab749097a6a5f97d6b897a3b69 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 10:37:40 +0200 Subject: [PATCH 003/126] Solid section draws grouped by arena page within 64-block bands A list sorted only by distance switched vertex buffer every few sections: about 1200 indirect multi-draws a frame at render distance 32, most of a few entries, which Mesa's Intel driver unrolls on the CPU. Grouping each band's sections by page keeps the list front to back within the band, with one call per page and band. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/gfx.rs | 47 +++++- crates/horizon-client/src/gfx/page_runs.rs | 181 +++++++++++++++++++++ 2 files changed, 224 insertions(+), 4 deletions(-) create mode 100644 crates/horizon-client/src/gfx/page_runs.rs diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 127aaf737..cbd5e8b8c 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -66,6 +66,7 @@ mod java_stages; mod lod; mod occlusion; mod pack_stages; +mod page_runs; pub mod panorama; mod resident; mod stars; @@ -421,6 +422,9 @@ pub struct Renderer { /// built, and their pages. phase2_draws: Vec<[u32; 5]>, phase2_pages: Vec<(u32, Option)>, + /// Each section's solid draws, to group them by arena page. + solid_runs: page_runs::PageRuns, + phase2_runs: page_runs::PageRuns, /// Block-entity blocks per meshed section (world position, state id). block_entities: HashMap>, /// Changes whenever `block_entities` does (unique across renderers). @@ -2170,6 +2174,8 @@ impl Renderer { draw_pages: Vec::new(), phase2_draws: Vec::new(), phase2_pages: Vec::new(), + solid_runs: page_runs::PageRuns::default(), + phase2_runs: page_runs::PageRuns::default(), block_entities: HashMap::new(), block_entity_revision: next_block_entity_revision(), occlusion: occlusion::Occlusion::new(crate::chunk::MIN_Y, crate::chunk::HEIGHT / 16), @@ -3042,6 +3048,8 @@ impl Renderer { .and_then(|cull| cull.begin(&self.device).then_some(cull)); self.phase2_draws.clear(); self.phase2_pages.clear(); + self.solid_runs.clear(); + self.phase2_runs.clear(); for (i, v) in visible.iter().enumerate() { let s = self.sections.get(v.slot); let first_phase = cull.as_ref().is_none_or(|c| c.first(v.slot)); @@ -3060,22 +3068,53 @@ impl Renderer { pages.push((s.page, None)); indices += quads * 6; }); - match &mut cull { - Some(c) if first_phase => c.drawn(i, v.slot, indices), - Some(c) => c.deferred(i, v.slot, start, draws.len() - start, indices), - None => {} + let runs = if first_phase { + &mut self.solid_runs + } else { + &mut self.phase2_runs + }; + runs.push( + v.distance, + s.page, + start, + draws.len() - start, + [i as u32, v.slot, indices], + ); + if let Some(c) = &mut cull + && first_phase + { + c.drawn(i, v.slot, indices); + } + } + self.solid_runs + .regroup(&mut self.draws, &mut self.draw_pages, 0); + // Phase 2's draws are tested where grouping left them. + let runs = self + .phase2_runs + .regroup(&mut self.phase2_draws, &mut self.phase2_pages, 0); + if let Some(c) = &mut cull { + for r in runs { + let [i, slot, indices] = r.tag; + c.deferred(i as usize, slot, r.start as usize, r.len as usize, indices); } } // Distant terrain tiles are never occlusion tested: phase 1. + let tiles = self.draws.len(); + self.solid_runs.clear(); for (i, v) in visible_lods.iter().enumerate() { let s = &self.lods[&v.key].mesh; + let start = self.draws.len(); s.faces.ranges(eye - Vec3::from(v.origin), |first, quads| { let first = s.start + u64::from(first) * 4; self.draws .push([quads * 6, 1, 0, first as u32, (visible.len() + i) as u32]); self.draw_pages.push((s.page, None)); }); + self.solid_runs + .push(v.distance, s.page, start, self.draws.len() - start, [0; 3]); } + self.solid_runs + .regroup(&mut self.draws, &mut self.draw_pages, tiles); let phase1_draws = self.draws.len() as u32; self.draws.extend_from_slice(&self.phase2_draws); self.draw_pages.extend_from_slice(&self.phase2_pages); diff --git a/crates/horizon-client/src/gfx/page_runs.rs b/crates/horizon-client/src/gfx/page_runs.rs new file mode 100644 index 000000000..3ada45737 --- /dev/null +++ b/crates/horizon-client/src/gfx/page_runs.rs @@ -0,0 +1,181 @@ +//! Solid draws grouped by vertex arena page within distance bands. +//! +//! Sections sit in arena pages of 256 MiB, so render distance 32 spreads +//! them over half a dozen pages, and a list sorted only by distance switches +//! page every few sections: about a thousand indirect multi-draws of two or +//! three entries a frame. Mesa's Intel driver (and wgpu-core, for each +//! vertex buffer change) pays per call, and below four entries Mesa unrolls +//! the call on the CPU entry by entry. Grouping the sections of one band of +//! distance by page keeps the list front to back to within the band (what +//! the depth test needs to reject hidden fragments early) with one call per +//! page and band. +//! +//! The picture does not change: solid draws write depth and are tested +//! against it, so their order only decides which of two fragments at the +//! same depth stays, and sections do not share faces. + +/// The width of a band, in blocks. +const BAND: f64 = 64.0; + +/// One section's draws: `start..start + len` of the list. +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub(super) struct Run { + key: u64, + pub start: u32, + pub len: u32, + /// The caller's data, carried along (occlusion culling's test inputs). + pub tag: [u32; 3], +} + +#[derive(Default)] +pub(super) struct PageRuns { + runs: Vec, + scratch: Vec<([u32; 5], (u32, Option))>, +} + +impl PageRuns { + pub fn clear(&mut self) { + self.runs.clear(); + } + + /// The draws `start..start + len` of a section `distance` from the + /// camera (squared, as bits) in arena `page`; runs come nearest first. + pub fn push(&mut self, distance: u64, page: u32, start: usize, len: usize, tag: [u32; 3]) { + if len > 0 { + let band = (f64::from_bits(distance).sqrt() / BAND) as u64; + self.runs.push(Run { + key: band << 32 | u64::from(page), + start: start as u32, + len: len as u32, + tag, + }); + } + } + + /// Reorders `draws[base..]` and their `pages`, which the pushed runs + /// cover in order, so that each band's runs in one page are adjacent + /// (in distance order); returns the runs at their new places. + pub fn regroup( + &mut self, + draws: &mut [[u32; 5]], + pages: &mut [(u32, Option)], + base: usize, + ) -> &[Run] { + let page = |r: &Run| r.key as u32; + if self.runs.windows(2).all(|w| page(&w[0]) == page(&w[1])) { + return &self.runs; + } + // Stable: within a band and page the runs stay nearest first. + self.runs.sort_by_key(|r| r.key); + self.scratch.clear(); + for r in &mut self.runs { + let (s, e) = (r.start as usize, (r.start + r.len) as usize); + r.start = (base + self.scratch.len()) as u32; + self.scratch + .extend(draws[s..e].iter().copied().zip(pages[s..e].iter().copied())); + } + for (i, &(draw, p)) in self.scratch.iter().enumerate() { + draws[base + i] = draw; + pages[base + i] = p; + } + &self.runs + } +} + +#[cfg(test)] +mod tests { + use super::*; + + fn bits(blocks: f64) -> u64 { + (blocks * blocks).to_bits() + } + + /// Runs of (distance in blocks, page, draws), as the list builder pushes them. + fn list(runs: &[(f64, u32, u32)]) -> (PageRuns, Vec<[u32; 5]>, Vec<(u32, Option)>) { + let mut grouped = PageRuns::default(); + let (mut draws, mut pages) = (Vec::new(), Vec::new()); + for (n, &(distance, page, count)) in runs.iter().enumerate() { + let start = draws.len(); + for k in 0..count { + draws.push([n as u32, k, 0, 0, 0]); + pages.push((page, None)); + } + grouped.push( + bits(distance), + page, + start, + count as usize, + [n as u32, 0, 0], + ); + } + (grouped, draws, pages) + } + + #[test] + fn a_band_draws_each_page_once_keeping_the_order_inside_it() { + let (mut grouped, mut draws, mut pages) = list(&[ + (10.0, 1, 2), + (20.0, 0, 1), + (30.0, 1, 3), + (40.0, 0, 2), + (70.0, 1, 1), + ]); + let runs: Vec<_> = grouped + .regroup(&mut draws, &mut pages, 0) + .iter() + .map(|r| (r.tag[0], r.start, r.len)) + .collect(); + assert_eq!( + runs, + [(1, 0, 1), (3, 1, 2), (0, 3, 2), (2, 5, 3), (4, 8, 1)] + ); + let order: Vec<_> = draws.iter().map(|d| (d[0], d[1])).collect(); + assert_eq!( + order, + [ + (1, 0), + (3, 0), + (3, 1), + (0, 0), + (0, 1), + (2, 0), + (2, 1), + (2, 2), + (4, 0) + ] + ); + let pages: Vec<_> = pages.iter().map(|p| p.0).collect(); + assert_eq!(pages, [0, 0, 0, 1, 1, 1, 1, 1, 1]); + } + + #[test] + fn bands_stay_in_distance_order() { + let (mut grouped, mut draws, mut pages) = + list(&[(10.0, 1, 1), (100.0, 0, 1), (200.0, 0, 1)]); + grouped.regroup(&mut draws, &mut pages, 0); + let order: Vec<_> = draws.iter().map(|d| d[0]).collect(); + assert_eq!(order, [0, 1, 2]); + } + + #[test] + fn one_page_and_an_offset_list() { + let (mut grouped, mut draws, mut pages) = list(&[(10.0, 3, 2), (90.0, 3, 1)]); + let before = draws.clone(); + assert_eq!(grouped.regroup(&mut draws, &mut pages, 0)[1].start, 2); + assert_eq!(draws, before); + // A list after other draws: starts are absolute. + let mut grouped = PageRuns::default(); + let mut draws = vec![[9; 5], [7, 0, 0, 0, 0], [8, 0, 0, 0, 0]]; + let mut pages = vec![(5, None), (1, None), (0, None)]; + grouped.push(bits(5.0), 1, 1, 1, [0; 3]); + grouped.push(bits(6.0), 0, 2, 1, [1, 0, 0]); + let runs = grouped.regroup(&mut draws, &mut pages, 1).to_vec(); + assert_eq!(draws, [[9; 5], [8, 0, 0, 0, 0], [7, 0, 0, 0, 0]]); + assert_eq!(pages, [(5, None), (0, None), (1, None)]); + assert_eq!((runs[0].tag[0], runs[0].start), (1, 1)); + // Empty runs are left out. + grouped.clear(); + grouped.push(bits(1.0), 0, 0, 0, [0; 3]); + assert!(grouped.regroup(&mut [], &mut [], 0).is_empty()); + } +} From d0330061bdbb896d9c3b3b4d3447caba3230df1f Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 10:45:33 +0200 Subject: [PATCH 004/126] Far Detail: an opt-in Reduced level for far terrain, suggested on integrated GPUs Reduced starts each far tile level at half the distance Full does (about a quarter of the far quads beyond the full-detail edge, whose finest tiles stay). Full stays the default everywhere and no preset changes it. On integrated GPUs other than Apple's, the setting's description suggests Reduced. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game.rs | 4 ++ crates/horizon-client/src/game/control.rs | 2 + crates/horizon-client/src/gfx.rs | 8 +++ crates/horizon-client/src/graphics.rs | 68 ++++++++++++++++++- crates/horizon-client/src/graphics_ui.rs | 20 +++++- crates/horizon-client/src/lod.rs | 80 +++++++++++++++++++---- 6 files changed, 168 insertions(+), 14 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 2df6aa9b0..a115796e5 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -10247,6 +10247,10 @@ impl Game<'_> { if let (Some(lod), Some(player)) = (&mut self.lod, &self.player) { let lod_distance = self.settings.horizon.lod_distance_on(&renderer.info); lod.set_near_loading(self.streaming.busy()); + lod.set_reduced_detail( + self.settings.horizon.far_detail + == horizon_client::graphics::FarDetail::Reduced, + ); // The covered columns change only with the complete ones and // the render area: rebuilt then, not every frame. let at = ( diff --git a/crates/horizon-client/src/game/control.rs b/crates/horizon-client/src/game/control.rs index d79f69d3c..df641d5c2 100644 --- a/crates/horizon-client/src/game/control.rs +++ b/crates/horizon-client/src/game/control.rs @@ -838,6 +838,8 @@ impl Game<'_> { "source_attempted": self.lod_source_attempted, "active_tiles": self.lod.as_ref().map_or(0, |lod| lod.stats().0), "cached_tiles": self.lod.as_ref().map_or(0, |lod| lod.stats().1), + "far_detail": self.settings.horizon.far_detail.name(), + "resident_quads": self.renderer.as_ref().map_or(0, |r| r.lod_quads()), "pending_observations": self.lod_observe.len(), "refined_samples": self.lod.as_ref().map_or(0, |lod| lod.refined_samples()), }); diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 127aaf737..9be2958fb 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -850,6 +850,13 @@ impl Renderer { pub fn resident_sections(&self) -> usize { self.sections.len() } + /// Quads of the far terrain tiles with GPU buffers. + pub fn lod_quads(&self) -> u64 { + self.lods + .values() + .map(|tile| u64::from(tile.mesh.solid + tile.mesh.translucent)) + .sum() + } /// Bytes of the section vertex arena's buffers, and of the vertices /// resident sections hold in them. pub fn section_vertex_bytes(&self) -> [u64; 2] { @@ -916,6 +923,7 @@ impl Renderer { None => open_device(&window, offscreen, api, layers).await?, }; let info = adapter.get_info(); + crate::graphics::suggest_reduced_far_detail(crate::graphics::lod_capped(&info)); let size = window.inner_size(); let (config, present_modes) = if let Some(surface) = &surface { let mut config = surface diff --git a/crates/horizon-client/src/graphics.rs b/crates/horizon-client/src/graphics.rs index bea0ffaa9..1974c4538 100644 --- a/crates/horizon-client/src/graphics.rs +++ b/crates/horizon-client/src/graphics.rs @@ -156,6 +156,48 @@ pub enum Overlay { Graph, } +/// How finely far terrain is drawn (`FarDetail` in the LOD options). +#[derive(Clone, Copy, Debug, PartialEq, Eq, Default)] +pub enum FarDetail { + /// Each tile level starts at eight times its size from the camera. + #[default] + Full, + /// Coarser levels start at half that distance: about a quarter of the + /// far quads, for GPUs that far terrain slows down. Changes the picture. + Reduced, +} +impl FarDetail { + pub fn name(self) -> &'static str { + match self { + FarDetail::Full => "full", + FarDetail::Reduced => "reduced", + } + } + pub fn label(self) -> &'static str { + match self { + FarDetail::Full => "Full", + FarDetail::Reduced => "Reduced", + } + } + fn parse(s: &str) -> Self { + if s == "reduced" { + FarDetail::Reduced + } else { + FarDetail::Full + } + } +} + +static REDUCED_SUGGESTED: std::sync::atomic::AtomicBool = std::sync::atomic::AtomicBool::new(false); +/// Whether the settings suggest Reduced far detail: set when the renderer +/// starts, on the GPUs `lod_capped` names (far terrain slows them most). +pub fn suggest_reduced_far_detail(on: bool) { + REDUCED_SUGGESTED.store(on, std::sync::atomic::Ordering::Relaxed); +} +pub fn reduced_far_detail_suggested() -> bool { + REDUCED_SUGGESTED.load(std::sync::atomic::Ordering::Relaxed) +} + /// The farthest LOD Distance, in chunks, on integrated GPUs other than /// Apple's: they share the CPU's memory bandwidth, and past it far terrain /// costs them more frame time than it is worth. @@ -181,6 +223,8 @@ pub struct Graphics { pub preset: Preset, /// Distant surface terrain range, in chunks; 0 disables LODs. pub lod_distance: u32, + /// How finely far terrain is drawn; Full unless the player picks Reduced. + pub far_detail: FarDetail, /// Skip sections hidden behind closed ones (vanilla's occlusion graph). pub cave_culling: bool, /// Hide shared leaf and mangrove-root faces, reducing foliage density. @@ -221,6 +265,7 @@ impl Default for Graphics { Self { preset: Preset::Custom, lod_distance: 0, + far_detail: FarDetail::Full, cave_culling: true, cull_leaves: false, entity_culling: false, @@ -268,6 +313,7 @@ impl Graphics { match key.trim() { "preset" => g.preset = Preset::parse(value), "lodDistance" => g.lod_distance = number(g.lod_distance).min(1024), + "farDetail" => g.far_detail = FarDetail::parse(value), "caveCulling" => g.cave_culling = flag(g.cave_culling), "cullLeaves" => g.cull_leaves = flag(g.cull_leaves), "entityCulling" => g.entity_culling = flag(g.entity_culling), @@ -306,9 +352,10 @@ impl Graphics { } pub fn serialize(&self) -> String { format!( - "preset:{}\nlodDistance:{}\ncaveCulling:{}\ncullLeaves:{}\nentityCulling:{}\nchunkUpdates:{}\nuploadBudgetKiB:{}\nsky:{}\nfog:{}\nweather:{}\nanimatedTextures:{}\npresentMode:{}\nframePacing:{}\nworkers:{}\noverlay:{}\nresolutionScale:{}\nfxaa:{}\nlevel:{}\nbatteryMode:{}\nshaderPack:{}\ngraphicsApi:{}\n", + "preset:{}\nlodDistance:{}\nfarDetail:{}\ncaveCulling:{}\ncullLeaves:{}\nentityCulling:{}\nchunkUpdates:{}\nuploadBudgetKiB:{}\nsky:{}\nfog:{}\nweather:{}\nanimatedTextures:{}\npresentMode:{}\nframePacing:{}\nworkers:{}\noverlay:{}\nresolutionScale:{}\nfxaa:{}\nlevel:{}\nbatteryMode:{}\nshaderPack:{}\ngraphicsApi:{}\n", self.preset.name(), self.lod_distance, + self.far_detail.name(), bool_text(self.cave_culling), bool_text(self.cull_leaves), bool_text(self.entity_culling), @@ -410,6 +457,7 @@ mod tests { let g = Graphics { preset: Preset::Balanced, lod_distance: 256, + far_detail: FarDetail::Reduced, cave_culling: false, cull_leaves: true, entity_culling: true, @@ -491,6 +539,24 @@ mod tests { assert_eq!(Graphics::parse("lodDistance:invalid\n").lod_distance, 0); } + #[test] + fn far_detail_is_full_unless_reduced_is_picked() { + assert_eq!(Graphics::default().far_detail, FarDetail::Full); + assert_eq!( + Graphics::parse("farDetail:reduced\n").far_detail, + FarDetail::Reduced + ); + for text in ["farDetail:full\n", "farDetail:other\n", ""] { + assert_eq!(Graphics::parse(text).far_detail, FarDetail::Full); + } + // No preset changes it. + for preset in Preset::ALL { + let mut s = crate::settings::Settings::default(); + apply_preset(preset, &mut s); + assert_eq!(s.horizon.far_detail, FarDetail::Full, "{preset:?}"); + } + } + #[test] fn automatic_workers_leave_cores_for_the_render_and_server_threads() { let g = Graphics::default(); diff --git a/crates/horizon-client/src/graphics_ui.rs b/crates/horizon-client/src/graphics_ui.rs index eea2d03cb..cc27b9488 100644 --- a/crates/horizon-client/src/graphics_ui.rs +++ b/crates/horizon-client/src/graphics_ui.rs @@ -2,7 +2,7 @@ //! they show, in what groups, with what description and cost, and their //! input. How they look comes from `graphics_style`. use crate::{ - graphics::{GraphicsApi, Overlay, Pacing, PresentMode, Preset}, + graphics::{FarDetail, GraphicsApi, Overlay, Pacing, PresentMode, Preset}, graphics_style::{Cost, STYLE}, hud::{HudAtlas, HudBatch}, options_ui::Opt, @@ -22,6 +22,7 @@ pub enum Level { pub enum H { Preset, LodDistance, + FarDetail, CaveCulling, CullLeaves, EntityCulling, @@ -85,6 +86,16 @@ pub fn rows(level: Level) -> Vec { Medium, "Coarse distant terrain in local worlds. Integrated GPUs stop at 128 chunks.", ); + // Suggested, never switched on, where far terrain costs the GPU most. + let far = h( + H::FarDetail, + Medium, + if crate::graphics::reduced_far_detail_suggested() { + "Reduced draws far terrain coarser: faster on this integrated GPU." + } else { + "Reduced draws far terrain coarser, for GPUs it slows down." + }, + ); let fov = v( Opt::Fov, Low, @@ -107,11 +118,12 @@ pub fn rows(level: Level) -> Vec { "Sets the options below together. Changing one makes it Custom.", ); let mut rows = match level { - Level::Simple => vec![preset, render, lod, fov, fps, vsync, gui], + Level::Simple => vec![preset, render, lod, far, fov, fps, vsync, gui], Level::Advanced => vec![ Row::Header("Rendering"), render, lod, + far, v( Opt::SimulationDistance, Medium, @@ -335,6 +347,7 @@ impl H { 0 => labelled("LOD Distance", "Off"), n => labelled("LOD Distance", format!("{n} chunks")), }, + H::FarDetail => labelled("Far Detail", g.far_detail.label()), H::CaveCulling => labelled("Cave Culling", on_off(g.cave_culling)), H::CullLeaves => labelled("Cull Leaves", on_off(g.cull_leaves)), H::EntityCulling => labelled("Entity Culling", on_off(g.entity_culling)), @@ -411,6 +424,9 @@ impl H { H::LodDistance => { g.lod_distance = step(&[0, 64, 128, 256, 512, 1024], g.lod_distance, back) } + H::FarDetail => { + g.far_detail = step(&[FarDetail::Full, FarDetail::Reduced], g.far_detail, back) + } H::CaveCulling => g.cave_culling = !g.cave_culling, H::CullLeaves => g.cull_leaves = !g.cull_leaves, H::EntityCulling => g.entity_culling = !g.entity_culling, diff --git a/crates/horizon-client/src/lod.rs b/crates/horizon-client/src/lod.rs index 0aa7b1f94..f8adb1f16 100644 --- a/crates/horizon-client/src/lod.rs +++ b/crates/horizon-client/src/lod.rs @@ -326,14 +326,17 @@ struct Plan { impl Plan { #[cfg(test)] fn new(camera: [i32; 2], detail: i32, distance: u32) -> Self { - Self::with_previous(camera, detail, distance, &Self::default(), 0) + Self::with_previous(camera, detail, distance, &Self::default(), 0, false) } + /// `reduced`: Reduced far detail (`graphics::FarDetail`), each level from + /// half the distance. fn with_previous( camera: [i32; 2], detail: i32, distance: u32, previous: &Self, elevation: i32, + reduced: bool, ) -> Self { let range = distance.min(1024) as i32 * 16; let mut level = 0; @@ -349,25 +352,35 @@ impl Plan { for x in (camera[0] - range).div_euclid(size)..=(camera[0] + range).div_euclid(size) { let key = TileKey { x, z, level }; result.roots.push(key); - result.visit(key, camera, detail, range, previous); + result.visit(key, camera, detail, range, previous, reduced); } } result } - fn visit(&mut self, key: TileKey, camera: [i32; 2], detail: i32, range: i32, previous: &Self) { + fn visit( + &mut self, + key: TileKey, + camera: [i32; 2], + detail: i32, + range: i32, + previous: &Self, + reduced: bool, + ) { if key.distance(camera) > range { return; } self.nodes.insert(key); - // Keep distant cells small on screen; finest tiles retain individual blocks. - let threshold = key.size() * if previous.split.contains(&key) { 10 } else { 8 }; + // Keep distant cells small on screen; finest tiles retain individual + // blocks. Reduced keeps them twice as large (a quarter of the cells). + let split = if previous.split.contains(&key) { 10 } else { 8 }; + let threshold = key.size() * if reduced { split / 2 } else { split }; if key.level > 0 && (key.distance(camera) < detail * 16 + 16 || key.distance(camera).max(self.elevation) < threshold) { self.split.insert(key); for child in key.children() { - self.visit(child, camera, detail, range, previous); + self.visit(child, camera, detail, range, previous, reduced); } } } @@ -517,8 +530,10 @@ pub struct Lod { /// The plan or the covered columns changed: covered leaves need stand-ins. replanned: bool, invalidated: FxHashSet<(i32, i32)>, - area: Option<([i32; 2], i32, u32, i32)>, + area: Option<([i32; 2], i32, u32, i32, bool)>, plan: Plan, + /// Reduced far detail (`set_reduced_detail`). + reduced_detail: bool, pending: FxHashSet, sample_nearby: bool, detail_masks: FxHashMap, @@ -714,6 +729,7 @@ impl Lod { replanned: true, invalidated: FxHashSet::default(), area: None, + reduced_detail: false, plan: Plan::default(), pending: FxHashSet::default(), sample_nearby: true, @@ -930,6 +946,11 @@ impl Lod { pub fn set_near_loading(&mut self, loading: bool) { self.near_loading = loading; } + /// Reduced far detail (`graphics::FarDetail::Reduced`): the next update + /// replans when it changes. + pub fn set_reduced_detail(&mut self, reduced: bool) { + self.reduced_detail = reduced; + } fn held(&self) -> bool { self.small && self.near_loading } @@ -1021,11 +1042,19 @@ impl Lod { detail, distance, elevation, + self.reduced_detail, ); if self.area != Some(area) { crate::spans::time("lod_plan", || { self.area = Some(area); - self.plan = Plan::with_previous(camera, detail, distance, &self.plan, elevation); + self.plan = Plan::with_previous( + camera, + detail, + distance, + &self.plan, + elevation, + self.reduced_detail, + ); self.ready.retain(|key, _| self.plan.nodes.contains(key)); self.detail_masks .retain(|key, _| self.plan.nodes.contains(key)); @@ -1421,6 +1450,35 @@ mod tests { use super::*; use crate::mesher::TerrainVertex; #[test] + fn reduced_far_detail_only_merges_tiles_away_from_the_near_terrain() { + let leaves = |plan: &Plan| { + plan.nodes + .iter() + .filter(|k| !plan.split.contains(k)) + .count() + }; + for camera in [[0, 0], [100, -40]] { + for distance in [64, 128, 512, 1024] { + let full = Plan::new(camera, 12, distance); + let reduced = Plan::with_previous(camera, 12, distance, &Plan::default(), 0, true); + // Never finer than Full anywhere, and as fine next to the + // full-detail area, whose edge the finest tiles match. + assert!(reduced.split.is_subset(&full.split)); + assert_eq!(reduced.roots, full.roots); + for key in reduced.nodes.iter().filter(|k| !reduced.split.contains(k)) { + if key.distance(camera) < 12 * 16 + 16 { + assert_eq!(key.level, 0, "{key:?}"); + } + } + let (full, reduced) = (leaves(&full), leaves(&reduced)); + assert!( + reduced * 2 < full, + "{reduced} of {full} tiles at {distance}" + ); + } + } + } + #[test] fn far_plan_is_bounded_and_near_tiles_align_with_chunks() { for camera in [[0, 0], [-1, -17], [1023, -4097]] { for distance in [64, 256, 1024] { @@ -1453,7 +1511,7 @@ mod tests { #[test] fn aerial_distance_avoids_unseen_full_detail_outside_the_near_area() { let ground = Plan::new([0, 0], 12, 1024); - let high = Plan::with_previous([0, 0], 12, 1024, &Plan::default(), 1024); + let high = Plan::with_previous([0, 0], 12, 1024, &Plan::default(), 1024, false); assert!(high.nodes.len() < ground.nodes.len()); assert!( high.nodes.contains(&TileKey { @@ -1505,7 +1563,7 @@ mod tests { #[test] fn detail_survives_movement_across_a_split_threshold() { let before = Plan::new([0, 0], 2, 256); - let after = Plan::with_previous([16, 0], 2, 256, &before, 0); + let after = Plan::with_previous([16, 0], 2, 256, &before, 0, false); let mut retained = 0; for key in &before.split { if key.distance([16, 0]) < key.size() * 10 { @@ -1804,7 +1862,7 @@ mod tests { // Exercise the actual worker/update seam: a parent stays displayed // until all four child meshes can replace it in the same update. let camera = [-256.0, 100.0, -256.0]; - lod.area = Some(([-16, -16], 2, 64, 0)); + lod.area = Some(([-16, -16], 2, 64, 0, false)); lod.plan.roots = vec![key]; lod.plan.nodes.insert(key); // As a replan does (`update` only selects after a change). From 8a03758c3a41c9d113864ddab3271bf523c6e8a6 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 11:47:03 +0200 Subject: [PATCH 005/126] Load time: build a pack's content root and load its sprites and models in parallel A content pack's first start rewrote 19 per-state tables one after another and reopened each zip mod's archive for every file it copied (its whole index each time). Every start then decoded the atlases' mod textures and parsed the mods' block models one file at a time on the main thread: with ATM10's 42 data mods that was about 70 % of the sampled startup. - mod_content: the tables are rewritten on up to three threads, largest first; a zip mod's archive is opened once for all its files (horizon-mods' Content::reader). - hud::atlas_sprites and ParsedModels::load list their files first, then decode and parse them on every core (par::par_map, results in the input order). The sprites come out in the order the one-by-one loop gave, and the content root is byte-identical. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/hud.rs | 59 ++++++++++----- crates/horizon-client/src/lib.rs | 1 + crates/horizon-client/src/mod_content.rs | 86 ++++++++++++++++------ crates/horizon-client/src/model_library.rs | 29 ++++++-- crates/horizon-client/src/par.rs | 54 ++++++++++++++ crates/horizon-mods/src/content.rs | 60 +++++++++------ 6 files changed, 216 insertions(+), 73 deletions(-) create mode 100644 crates/horizon-client/src/par.rs diff --git a/crates/horizon-client/src/hud.rs b/crates/horizon-client/src/hud.rs index 0cc99b07b..b0c57f1d7 100644 --- a/crates/horizon-client/src/hud.rs +++ b/crates/horizon-client/src/hud.rs @@ -82,11 +82,13 @@ fn atlas_sprites(root: &Path, packed: &[PackedImage]) -> Vec { use crate::atlas_sources::{self, SpriteOrigin}; let have: std::collections::HashSet<&str> = packed.iter().map(|i| i.0.as_str()).collect(); let textures = atlas_sources::list_textures(root); - let load = |texture: &str, directory: &str| { - decode(&atlas_sources::texture_path(root, texture, directory)).ok() - }; - let mut out: Vec = Vec::new(); - let mut added = std::collections::HashSet::new(); + // Each new name with its origins in the atlases' order: the first that + // loads is the sprite. They load at once (a content pack's atlases list + // tens of thousands of files), and come out in the order a load of one + // after another would give. + let mut names: Vec<(String, Vec<(usize, SpriteOrigin)>)> = Vec::new(); + let mut slots = std::collections::HashMap::new(); + let mut order = 0; for (atlas, sources) in atlas_sources::atlases(root) { // The other atlases' renamed files (GUI sprites, particles...) are // looked up by their texture paths here. @@ -96,18 +98,33 @@ fn atlas_sprites(root: &Path, packed: &[PackedImage]) -> Vec { continue; } let name = id.strip_prefix("minecraft:").unwrap_or(&id).to_owned(); - if have.contains(name.as_str()) || added.contains(&name) { + if have.contains(name.as_str()) { continue; } - let image = match &origin { + // A vanilla file is packed under its own name already: only a + // renamed one is new. Other namespaces' files (content mods) are + // never in the walked directories. + if let SpriteOrigin::File(texture) = &origin + && texture.strip_prefix("minecraft:") == Some(name.as_str()) + { + continue; + } + let slot = *slots.entry(name.clone()).or_insert_with(|| { + names.push((name, Vec::new())); + names.len() - 1 + }); + names[slot].1.push((order, origin)); + order += 1; + } + } + let load = |texture: &str, directory: &str| { + decode(&atlas_sources::texture_path(root, texture, directory)).ok() + }; + let first = |(name, origins): &(String, Vec<(usize, SpriteOrigin)>)| { + origins.iter().find_map(|(order, origin)| { + let image = match origin { SpriteOrigin::File(texture) => { let path = texture.strip_prefix("minecraft:").unwrap_or(texture); - // A vanilla file is packed under its own name already: - // only a renamed one is new. Other namespaces' files - // (content mods) are never in the walked directories. - if texture.starts_with("minecraft:") && path == name { - continue; - } load(texture, "textures").map(|(w, h, p)| { // Animated strips keep their first frame, like the packed files. if h > w && (path.starts_with("block/") || path.starts_with("item/")) { @@ -119,13 +136,15 @@ fn atlas_sprites(root: &Path, packed: &[PackedImage]) -> Vec { } generated => atlas_sources::generate(generated, &load), }; - if let Some((w, h, pixels)) = image { - added.insert(name.clone()); - out.push((name, w, h, pixels)); - } - } - } - out + image.map(|(w, h, pixels)| (*order, (name.clone(), w, h, pixels))) + }) + }; + let mut out: Vec<_> = crate::par::par_map(&names, first) + .into_iter() + .flatten() + .collect(); + out.sort_unstable_by_key(|(order, _)| *order); + out.into_iter().map(|(_, image)| image).collect() } impl HudAtlas { /// A font glyph's atlas cell (8x8 GUI pixels) and advance. diff --git a/crates/horizon-client/src/lib.rs b/crates/horizon-client/src/lib.rs index 7a69de4aa..f5c19bdc6 100644 --- a/crates/horizon-client/src/lib.rs +++ b/crates/horizon-client/src/lib.rs @@ -131,6 +131,7 @@ pub mod osk; pub mod overlay; pub mod pack_screen; pub mod packs; +pub mod par; pub mod particles; pub mod patrol; pub mod perf_overlay; diff --git a/crates/horizon-client/src/mod_content.rs b/crates/horizon-client/src/mod_content.rs index 0497f06b4..52e6d30ff 100644 --- a/crates/horizon-client/src/mod_content.rs +++ b/crates/horizon-client/src/mod_content.rs @@ -996,6 +996,66 @@ impl TagMerge { } } +/// Threads rewriting the tables at once. Each holds a whole table as a tree +/// (gameplay-facts.json's is over a gigabyte with ATM10's mods), so more +/// would mostly add memory. +const TABLE_THREADS: usize = 3; + +/// Rewrites the base's per-state tables for the mods' states into the +/// overlay. They are independent: [`TABLE_THREADS`] threads take them, +/// the largest first. +fn tables(base: &Path, plan: &Plan, overlay: &Overlay<'_>) -> Result<()> { + let mut jobs: Vec<(&str, u64)> = JSON_TABLES + .iter() + .chain(&NBT_TABLES) + .filter_map(|name| Some((*name, fs::metadata(base.join(name)).ok()?.len()))) + .collect(); + jobs.sort_by_key(|(_, size)| std::cmp::Reverse(*size)); + // Their directories become real here, so the threads only write files. + for (name, _) in &jobs { + if let Some(parent) = Path::new(name).parent() { + overlay.dir(parent)?; + } + } + let table = |name: &str| -> Result<()> { + let path = base.join(name); + let bytes = if JSON_TABLES.contains(&name) { + let mut doc = read_json(&path)?; + plan.json(name, &mut doc) + .map_err(|e| format!("{name}: {e}"))?; + serde_json::to_vec(&doc)? + } else { + let (mut named, _) = nbt::read_named(&fs::read(&path)?, Limits::tables()) + .map_err(|e| format!("{name}: {e}"))?; + plan.nbt(&mut named.tag); + nbt::write_named(&named, Limits::tables()).map_err(|e| format!("{name}: {e}"))? + }; + overlay.write(name, &bytes) + }; + let next = std::sync::atomic::AtomicUsize::new(0); + let threads = std::thread::available_parallelism().map_or(1, |n| n.get()); + std::thread::scope(|scope| { + let workers: Vec<_> = (0..threads.min(TABLE_THREADS)) + .map(|_| { + scope.spawn(|| -> std::result::Result<(), String> { + loop { + let i = next.fetch_add(1, std::sync::atomic::Ordering::Relaxed); + let Some((name, _)) = jobs.get(i) else { + return Ok(()); + }; + table(name).map_err(|e| e.to_string())?; + } + }) + }) + .collect(); + workers.into_iter().try_for_each(|w| { + w.join() + .unwrap_or_else(|_| Err("a table thread panicked".into())) + }) + })?; + Ok(()) +} + /// Builds the content root for `mods` over `base` in `out`. Returns the /// warnings for the log: the shared tags a mod replaced. pub fn build(base: &Path, mods: &[ContentMod], out: &Path) -> Result> { @@ -1015,28 +1075,7 @@ pub fn build(base: &Path, mods: &[ContentMod], out: &Path) -> Result let base = &std::path::absolute(base)?; let plan = Plan::new(base, mods)?; let overlay = Overlay::new(base, out)?; - for name in JSON_TABLES { - let path = base.join(name); - if !path.exists() { - continue; - } - let mut doc = read_json(&path)?; - plan.json(name, &mut doc) - .map_err(|e| format!("{name}: {e}"))?; - overlay.write(name, &serde_json::to_vec(&doc)?)?; - } - for name in NBT_TABLES { - let path = base.join(name); - if !path.exists() { - continue; - } - let (mut named, _) = nbt::read_named(&fs::read(&path)?, Limits::tables()) - .map_err(|e| format!("{name}: {e}"))?; - plan.nbt(&mut named.tag); - let bytes = - nbt::write_named(&named, Limits::tables()).map_err(|e| format!("{name}: {e}"))?; - overlay.write(name, &bytes)?; - } + tables(base, &plan, &overlay)?; // Mod files, and every tag addition gathered per tag file. let mut tags: BTreeMap = BTreeMap::new(); let mut warnings = Vec::new(); @@ -1044,8 +1083,9 @@ pub fn build(base: &Path, mods: &[ContentMod], out: &Path) -> Result let mut additions: BTreeMap<&str, Vec> = BTreeMap::new(); for m in mods { let declarations = format!("data/{}/horizon/", m.id); + let mut reader = m.content.reader()?; for file in &m.content.files { - let bytes = m.content.file(file)?; + let bytes = reader.read(file)?; let is_tag = file.starts_with("data/") && file.contains("/tags/"); if is_tag && file.ends_with(".json") { let doc: J = serde_json::from_slice(&bytes).map_err(|e| format!("{file}: {e}"))?; diff --git a/crates/horizon-client/src/model_library.rs b/crates/horizon-client/src/model_library.rs index c6a1a9d87..018bc6af2 100644 --- a/crates/horizon-client/src/model_library.rs +++ b/crates/horizon-client/src/model_library.rs @@ -10,10 +10,12 @@ pub(crate) struct ParsedModels { impl ParsedModels { /// Every `models/**.json` of a namespace directory, by identifier. pub(crate) fn load(root: &Path) -> Self { - let mut out = BTreeMap::new(); let Ok(namespaces) = fs::read_dir(root.join("assets")) else { - return Self { models: out }; + return Self::default(); }; + // Listed first, then read and parsed at once: a content pack has tens + // of thousands of models. + let mut files = Vec::new(); for ns in namespaces.flatten() { let namespace = ns.file_name().to_string_lossy().into_owned(); let base = ns.path().join("models"); @@ -24,20 +26,33 @@ impl ParsedModels { }; for e in entries.flatten() { let path = e.path(); - if path.is_dir() { + // The entry's own type saves a stat per file; a link + // (content roots link into the base) is followed. + let is_dir = match e.file_type() { + Ok(t) if !t.is_symlink() => t.is_dir(), + _ => path.is_dir(), + }; + if is_dir { stack.push(path); } else if path.extension().is_some_and(|x| x == "json") && let Ok(rel) = path.strip_prefix(&base) - && let Ok(text) = fs::read_to_string(&path) - && let Ok(model) = CuboidModel::from_json(&text) { let rel = rel.with_extension("").to_string_lossy().replace('\\', "/"); - out.insert(format!("{namespace}:{rel}"), Arc::new(model)); + files.push((format!("{namespace}:{rel}"), path)); } } } } - Self { models: out } + let parsed = crate::par::par_map(&files, |(_, path)| { + let text = fs::read_to_string(path).ok()?; + CuboidModel::from_json(&text).ok().map(Arc::new) + }); + let models = files + .into_iter() + .zip(parsed) + .filter_map(|((id, _), model)| Some((id, model?))) + .collect(); + Self { models } } /// Blocks require every referenced resource, including parents. Items instead diff --git a/crates/horizon-client/src/par.rs b/crates/horizon-client/src/par.rs new file mode 100644 index 000000000..b4861b7a6 --- /dev/null +++ b/crates/horizon-client/src/par.rs @@ -0,0 +1,54 @@ +//! Loading many small files at once: startup reads tens of thousands of +//! textures and models with a content pack, and one at a time it waits on +//! each open and read in turn. +use std::sync::atomic::{AtomicUsize, Ordering}; + +/// `f` over `items` on the machine's threads, results in `items`' order. +/// Threads take the next item as they finish one, so a run of slow items +/// doesn't hold back the others. +pub fn par_map(items: &[T], f: impl Fn(&T) -> R + Sync) -> Vec { + let threads = std::thread::available_parallelism() + .map_or(1, |n| n.get()) + .min(items.len()); + if threads <= 1 { + return items.iter().map(f).collect(); + } + let next = AtomicUsize::new(0); + let mut out: Vec<(usize, R)> = std::thread::scope(|scope| { + let workers: Vec<_> = (0..threads) + .map(|_| { + scope.spawn(|| { + let mut done = Vec::new(); + loop { + let i = next.fetch_add(1, Ordering::Relaxed); + let Some(item) = items.get(i) else { + return done; + }; + done.push((i, f(item))); + } + }) + }) + .collect(); + workers + .into_iter() + .flat_map(|w| w.join().unwrap_or_else(|e| std::panic::resume_unwind(e))) + .collect() + }); + out.sort_unstable_by_key(|(i, _)| *i); + out.into_iter().map(|(_, r)| r).collect() +} + +#[cfg(test)] +mod tests { + use super::par_map; + + #[test] + fn results_keep_the_items_order() { + let items: Vec = (0..1000).collect(); + assert_eq!( + par_map(&items, |x| x * 2), + items.iter().map(|x| x * 2).collect::>() + ); + assert!(par_map(&[] as &[u32], |x| *x).is_empty()); + } +} diff --git a/crates/horizon-mods/src/content.rs b/crates/horizon-mods/src/content.rs index f17c2bb8a..494e734ec 100644 --- a/crates/horizon-mods/src/content.rs +++ b/crates/horizon-mods/src/content.rs @@ -147,6 +147,33 @@ pub struct Content { pub namespaces: Vec, } +/// Reads a mod's content files ([`Content::reader`]). +pub enum FileReader<'a> { + Dir(&'a Path), + Zip(Box>), +} +impl FileReader<'_> { + /// One content file's bytes. + pub fn read(&mut self, name: &str) -> Result, String> { + check_path(name)?; + let reader: Box = match self { + Self::Dir(root) => { + Box::new(std::fs::File::open(root.join(name)).map_err(|e| format!("{name}: {e}"))?) + } + Self::Zip(zip) => Box::new(zip.by_name(name).map_err(|e| format!("{name}: {e}"))?), + }; + let mut out = Vec::new(); + reader + .take(MAX_FILE + 1) + .read_to_end(&mut out) + .map_err(|e| format!("{name}: {e}"))?; + if out.len() as u64 > MAX_FILE { + return Err(format!("{name} is over {} MiB", MAX_FILE >> 20)); + } + Ok(out) + } +} + /// Why two content mods cannot be on together: a namespace both own (one's /// id or listed namespace is the other's), which would mix their files. /// `a` and `b` are (mod id, owned namespaces). @@ -222,29 +249,16 @@ impl Content { /// One content file's bytes. pub fn file(&self, name: &str) -> Result, String> { - check_path(name)?; - let mut out = Vec::new(); - match &self.source { - Source::Dir(root) => { - let file = - std::fs::File::open(root.join(name)).map_err(|e| format!("{name}: {e}"))?; - file.take(MAX_FILE + 1) - .read_to_end(&mut out) - .map_err(|e| format!("{name}: {e}"))?; - } - Source::Zip(path) => { - let mut zip = open_zip(path)?; - let entry = zip.by_name(name).map_err(|e| format!("{name}: {e}"))?; - entry - .take(MAX_FILE + 1) - .read_to_end(&mut out) - .map_err(|e| format!("{name}: {e}"))?; - } - } - if out.len() as u64 > MAX_FILE { - return Err(format!("{name} is over {} MiB", MAX_FILE >> 20)); - } - Ok(out) + self.reader()?.read(name) + } + + /// A reader of its content files. A packaged mod's archive is opened + /// once for all of them (opening it reads its whole index). + pub fn reader(&self) -> Result, String> { + Ok(match &self.source { + Source::Dir(root) => FileReader::Dir(root), + Source::Zip(path) => FileReader::Zip(Box::new(open_zip(path)?)), + }) } /// Where content may go, and the declarations. From 21baf0dc995299309df2483a9d2bfb38c76f11b2 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 11:53:03 +0200 Subject: [PATCH 006/126] Screen overlays: blur and clamp from the texture's .png.mcmeta TextureMetadataSection's blur and clamp choose how vanilla samples a standalone texture (ReloadableTexture.setSampler). The atlas now keeps each texture's flags and the screen-effect quads (vignette, pumpkin blur, powder snow outline, underwater, equippable camera overlays) sample their sprite rectangle linearly and with clamp or repeat as those flags say, instead of always nearest and repeat. Fixes #335 Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game/render_tick.rs | 1 + crates/horizon-client/src/gfx.rs | 2 +- crates/horizon-client/src/hud.rs | 43 +++++++- crates/horizon-client/src/screen.wgsl | 38 +++++-- crates/horizon-client/src/screen_effects.rs | 102 +++++++++++++++++- 5 files changed, 170 insertions(+), 16 deletions(-) diff --git a/crates/horizon-client/src/game/render_tick.rs b/crates/horizon-client/src/game/render_tick.rs index 4ad9db548..e947d2af5 100644 --- a/crates/horizon-client/src/game/render_tick.rs +++ b/crates/horizon-client/src/game/render_tick.rs @@ -222,6 +222,7 @@ impl Game<'_> { hud_overlays::camera_overlays(size[0] as i32, size[1] as i32, &overlays, &mut scope); self.screen_fx.build(&ScreenInputs { sprites: &self.gui.atlas.sprites, + flags: &self.gui.atlas.flags, aspect: size[0] as f32 / size[1].max(1) as f32, partial, block_overlay, diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 127aaf737..c03193be4 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -1921,7 +1921,7 @@ impl Renderer { source: wgpu::ShaderSource::Wgsl(include_str!("screen.wgsl").into()), }); let screen_attributes = - wgpu::vertex_attr_array![0=>Float32x2,1=>Float32x2,2=>Float32x4,3=>Float32x4]; + wgpu::vertex_attr_array![0=>Float32x2,1=>Float32x2,2=>Float32x4,3=>Float32x4,4=>Uint32]; let screen_vertex = [Some(wgpu::VertexBufferLayout { array_stride: std::mem::size_of::() as u64, step_mode: wgpu::VertexStepMode::Vertex, diff --git a/crates/horizon-client/src/hud.rs b/crates/horizon-client/src/hud.rs index 0cc99b07b..cbf674136 100644 --- a/crates/horizon-client/src/hud.rs +++ b/crates/horizon-client/src/hud.rs @@ -18,11 +18,35 @@ pub struct Rect { pub w: u32, pub h: u32, } +/// `TextureMetadataSection`'s `blur` and `clamp`: how vanilla samples a +/// standalone texture (`ReloadableTexture.setSampler`: linear rather than +/// nearest filtering, clamp-to-edge rather than repeat addressing). +#[derive(Clone, Copy, Debug, Default, PartialEq, Eq)] +pub struct TextureFlags { + pub blur: bool, + pub clamp: bool, +} +impl TextureFlags { + /// The `texture` section of a `.png.mcmeta` file, if it sets either flag. + pub fn from_mcmeta(json: &str) -> Option { + let meta: serde_json::Value = serde_json::from_str(json).ok()?; + let section = meta.get("texture")?; + let flag = |key| section.get(key).and_then(serde_json::Value::as_bool) == Some(true); + let flags = Self { + blur: flag("blur"), + clamp: flag("clamp"), + }; + (flags != Self::default()).then_some(flags) + } +} pub struct HudAtlas { pub pixels: Vec, pub width: u32, pub height: u32, pub sprites: HashMap, + /// Sprites whose `.png.mcmeta` sets `blur` or `clamp`; the others + /// sample as vanilla's defaults (nearest, repeat). + pub flags: HashMap, pub fire_animations: Vec<(Rect, crate::sprites::SpriteAnimation)>, /// The default font (bitmap sheets in this atlas, unifont rasterized on demand). pub font: crate::font::Font, @@ -211,7 +235,7 @@ impl HudAtlas { let s = p.to_string_lossy(); !s.contains("title/background") && !s.contains("realms") && !s.contains("presets") }); - let decode_one = |path: &PathBuf| -> Option<(String, u32, u32, Vec)> { + let decode_one = |path: &PathBuf| -> Option<(PackedImage, Option)> { let name = path .strip_prefix(&textures) .ok()? @@ -226,11 +250,15 @@ impl HudAtlas { } else { pixels }; - (w <= 1024 && (h <= 512 || name.starts_with("font/"))).then_some((name, w, h, pixels)) + let flags = fs::read_to_string(path.with_extension("png.mcmeta")) + .ok() + .and_then(|json| TextureFlags::from_mcmeta(&json)); + (w <= 1024 && (h <= 512 || name.starts_with("font/"))) + .then_some(((name, w, h, pixels), flags)) }; let threads = std::thread::available_parallelism().map_or(2, |n| n.get()); let chunk = files.len().div_ceil(threads).max(1); - let mut images: Vec<_> = std::thread::scope(|scope| { + let decoded: Vec<_> = std::thread::scope(|scope| { let handles: Vec<_> = files .chunks(chunk) .map(|part| { @@ -242,6 +270,14 @@ impl HudAtlas { .flat_map(|h| h.join().unwrap_or_default()) .collect() }); + let mut flags = HashMap::new(); + let mut images: Vec = Vec::with_capacity(decoded.len()); + for (image, image_flags) in decoded { + if let Some(f) = image_flags { + flags.insert(image.0.clone(), f); + } + images.push(image); + } if full { images.extend(atlas_sprites(root, &images)); } @@ -337,6 +373,7 @@ impl HudAtlas { width, height, sprites, + flags, fire_animations, font, white, diff --git a/crates/horizon-client/src/screen.wgsl b/crates/horizon-client/src/screen.wgsl index 62cb2ee6c..a82b0f890 100644 --- a/crates/horizon-client/src/screen.wgsl +++ b/crates/horizon-client/src/screen.wgsl @@ -1,26 +1,50 @@ -// Full-screen camera effects (screen_effects.rs): clip-space quads sampling -// the shared 2D atlas with repeat inside each sprite rectangle. +// Full-screen camera effects (screen_effects.rs): clip-space quads reading +// one sprite rectangle of the shared 2D atlas as if it were its own texture, +// with the sampler vanilla gives it (ReloadableTexture.setSampler: linear +// when `blur`, clamp-to-edge when `clamp`, else nearest and repeat). @group(0) @binding(1) var atlas: texture_2d; -@group(0) @binding(2) var atlas_sampler: sampler; struct Out { @builtin(position) clip: vec4, @location(0) uv: vec2, @location(1) @interpolate(flat) rect: vec4, @location(2) color: vec4, + @location(3) @interpolate(flat) sampling: u32, } @vertex fn vs_screen(@location(0) pos: vec2, @location(1) uv: vec2, - @location(2) rect: vec4, @location(3) color: vec4) -> Out { + @location(2) rect: vec4, @location(3) color: vec4, + @location(4) sampling: u32) -> Out { var out: Out; out.clip = vec4(pos, 0.0, 1.0); out.uv = uv; out.rect = rect; out.color = color; + out.sampling = sampling; return out; } +const SAMPLE_BLUR: u32 = 1u; +const SAMPLE_CLAMP: u32 = 2u; +// A texel of the sprite, addressed by repeat or clamp-to-edge. +fn texel(origin: vec2, size: vec2, p: vec2, clamp_edge: bool) -> vec4 { + var q = ((p % size) + size) % size; + if clamp_edge { q = clamp(p, vec2(0), size - 1); } + return textureLoad(atlas, origin + q, 0); +} fn sample(in: Out) -> vec4 { - let f = fract(in.uv); - let uv = in.rect.xy + f * (in.rect.zw - in.rect.xy); - return textureSampleLevel(atlas, atlas_sampler, uv, 0.0) * in.color; + let dims = vec2(textureDimensions(atlas)); + let origin = vec2(round(in.rect.xy * dims)); + let size = max(vec2(round((in.rect.zw - in.rect.xy) * dims)), vec2(1)); + let clamp_edge = (in.sampling & SAMPLE_CLAMP) != 0u; + let p = in.uv * vec2(size); + if (in.sampling & SAMPLE_BLUR) == 0u { + return texel(origin, size, vec2(floor(p)), clamp_edge) * in.color; + } + // GL_LINEAR: the four texels around the sample point, weighted. + let c = p - 0.5; + let i = vec2(floor(c)); + let t = c - floor(c); + let a = mix(texel(origin, size, i, clamp_edge), texel(origin, size, i + vec2(1, 0), clamp_edge), t.x); + let b = mix(texel(origin, size, i + vec2(0, 1), clamp_edge), texel(origin, size, i + vec2(1, 1), clamp_edge), t.x); + return mix(a, b, t.y) * in.color; } @fragment fn fs_screen(in: Out) -> @location(0) vec4 { let c = sample(in); diff --git a/crates/horizon-client/src/screen_effects.rs b/crates/horizon-client/src/screen_effects.rs index bc7756453..48f468d4d 100644 --- a/crates/horizon-client/src/screen_effects.rs +++ b/crates/horizon-client/src/screen_effects.rs @@ -4,7 +4,10 @@ //! `hud_overlays::camera_overlays` (vignette, pumpkin blur, powder-snow //! outline, nether portal swirl). Positions are clip-space quads; textures //! come from the shared 2D atlas and may repeat. -use crate::{hud::Rect, hud_layout::GuiDraw}; +use crate::{ + hud::{Rect, TextureFlags}, + hud_layout::GuiDraw, +}; use std::collections::HashMap; #[derive(Clone, Copy, Debug, PartialEq, Eq)] @@ -24,6 +27,17 @@ pub struct ScreenVertex { /// Atlas rectangle (u0, v0, u1, v1) of the sprite. pub rect: [f32; 4], pub color: [f32; 4], + /// How the sprite is sampled: [`SAMPLE_BLUR`] and [`SAMPLE_CLAMP`]. + pub sampling: u32, +} +/// Linear filtering (`TextureMetadataSection.blur`), else nearest. +pub const SAMPLE_BLUR: u32 = 1; +/// Clamp-to-edge addressing (`TextureMetadataSection.clamp`), else repeat. +pub const SAMPLE_CLAMP: u32 = 2; +/// The sampling bits of a standalone texture's flags. +pub fn sampling(flags: TextureFlags) -> u32 { + let bit = |on: bool, bit: u32| if on { bit } else { 0 }; + bit(flags.blur, SAMPLE_BLUR) | bit(flags.clamp, SAMPLE_CLAMP) } #[derive(Clone, Debug)] pub struct ScreenQuad { @@ -34,6 +48,8 @@ pub struct ScreenQuad { /// What the camera sees this frame. pub struct ScreenInputs<'a> { pub sprites: &'a HashMap, + /// `.png.mcmeta` sampling of the standalone textures among `sprites`. + pub flags: &'a HashMap, pub aspect: f32, pub partial: f32, /// Particle sprite of the view-blocking block around the eye. @@ -92,17 +108,23 @@ impl ScreenEffects { pub fn build(&self, input: &ScreenInputs) -> Vec { let mut out = Vec::new(); let sprite = |name: &str| input.sprites.get(name).map(|r| [r.u0, r.v0, r.u1, r.v1]); + // Standalone textures (`ReloadableTexture.setSampler`) follow their + // metadata; atlas sprites (block overlay, fire, portal) sample + // nearest with repeat. + let texture_sampling = |name: &str| input.flags.get(name).copied().map_or(0, sampling); let scale = hand_scale(input.aspect); // Screen-effect quads live at view depth 0.5 in the hand projection. let hand_quad = |corners: [[f32; 2]; 4], uv: [[f32; 2]; 4], rect: [f32; 4], - color: [f32; 4]| ScreenQuad { + color: [f32; 4], + sampling: u32| ScreenQuad { vertices: std::array::from_fn(|i| ScreenVertex { pos: [corners[i][0] * scale[0], corners[i][1] * scale[1]], uv: uv[i], rect, color, + sampling, }), blend: Blend::Alpha, }; @@ -117,6 +139,7 @@ impl ScreenEffects { [[1.0, 1.0], [0.0, 1.0], [0.0, 0.0], [1.0, 0.0]], rect, [c, c, c, 1.0], + 0, )); } if let Some((brightness, yaw, pitch)) = input.water @@ -129,6 +152,7 @@ impl ScreenEffects { uv, rect, [brightness, brightness, brightness, 0.1], + texture_sampling("misc/underwater"), )); } if input.on_fire @@ -150,11 +174,12 @@ impl ScreenEffects { [[1.0, 1.0], [0.0, 1.0], [0.0, 0.0], [1.0, 0.0]], rect, [1.0, 1.0, 1.0, alpha], + 0, )); } } // Hud camera overlays: GUI-space full-screen blits (v grows downwards). - let gui = |rect: [f32; 4], color: [f32; 4], blend: Blend| ScreenQuad { + let gui = |rect: [f32; 4], color: [f32; 4], blend: Blend, sampling: u32| ScreenQuad { vertices: std::array::from_fn(|i| { let p = [[-1.0f32, 1.0], [1.0, 1.0], [1.0, -1.0], [-1.0, -1.0]][i]; ScreenVertex { @@ -162,6 +187,7 @@ impl ScreenEffects { uv: [[0.0, 0.0], [1.0, 0.0], [1.0, 1.0], [0.0, 1.0]][i], rect, color, + sampling, } }), blend, @@ -188,7 +214,7 @@ impl ScreenEffects { Blend::Alpha }; if let Some(rect) = sprite(texture) { - out.push(gui(rect, rgba(*color), blend)); + out.push(gui(rect, rgba(*color), blend, texture_sampling(texture))); } } GuiDraw::AtlasSprite { @@ -197,7 +223,7 @@ impl ScreenEffects { .. } => { if let Some(rect) = sprite(name) { - out.push(gui(rect, rgba(*color), Blend::Alpha)); + out.push(gui(rect, rgba(*color), Blend::Alpha, 0)); } } _ => {} @@ -243,8 +269,10 @@ mod tests { }, ); let e = ScreenEffects::default(); + let flags = HashMap::new(); let input = ScreenInputs { sprites: &sprites, + flags: &flags, aspect: 1.6, partial: 0.0, block_overlay: None, @@ -255,5 +283,69 @@ mod tests { let quads = e.build(&input); assert_eq!(quads.len(), 1); assert_eq!(quads[0].blend, Blend::Vignette); + assert_eq!(quads[0].vertices[0].sampling, 0); + } + #[test] + fn standalone_textures_sample_by_their_metadata() { + let rect = Rect { + u0: 0.0, + v0: 0.0, + u1: 1.0, + v1: 1.0, + w: 16, + h: 16, + }; + let sprites: HashMap<_, _> = ["misc/vignette", "misc/underwater", "block/stone"] + .map(|name| (name.to_owned(), rect)) + .into(); + let blur = TextureFlags { + blur: true, + clamp: false, + }; + let clamp = TextureFlags { + blur: false, + clamp: true, + }; + let flags: HashMap<_, _> = [ + ("misc/vignette".to_owned(), blur), + ("misc/underwater".to_owned(), clamp), + // Atlas sprites ignore the texture section. + ("block/stone".to_owned(), blur), + ] + .into(); + let quads = ScreenEffects::default().build(&ScreenInputs { + sprites: &sprites, + flags: &flags, + aspect: 1.6, + partial: 0.0, + block_overlay: Some("block/stone".to_owned()), + water: Some((1.0, 0.0, 0.0)), + on_fire: false, + gui_overlays: &[crate::hud_overlays::vignette(320, 240, 1.0, 0.0)], + }); + let sampling: Vec<_> = quads.iter().map(|q| q.vertices[0].sampling).collect(); + assert_eq!(sampling, [0, SAMPLE_CLAMP, SAMPLE_BLUR]); + } + #[test] + fn mcmeta_texture_section() { + let parse = TextureFlags::from_mcmeta; + assert_eq!( + parse(r#"{"texture":{"blur":true}}"#), + Some(TextureFlags { + blur: true, + clamp: false + }) + ); + assert_eq!( + parse(r#"{"texture":{"clamp":true,"mipmap_strategy":"mean"}}"#), + Some(TextureFlags { + blur: false, + clamp: true + }) + ); + // Defaults (false, false) or no section: the default sampler. + assert_eq!(parse(r#"{"texture":{"blur":false}}"#), None); + assert_eq!(parse(r#"{"animation":{}}"#), None); + assert_eq!(parse("not json"), None); } } From c77863f16314af2f891ee50c770b4ce158197cf4 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 12:08:30 +0200 Subject: [PATCH 007/126] Armour trims on worn armour (player, LAN guests, armour stands) EquipmentLayerRenderer's trim layer: the pattern's textures/trims/entity//.png recoloured from its base palette (palette metadata section) to the material's palette, or to the equipment asset's trim_overrides palette (iron armour with an iron trim uses trim/iron_darker), as PalettedTextureManager does. Each texture is made once, on first use, into one of 32 atlas trim slots (least recently drawn reused), and drawn over the armour layer on the player, on the guests a LAN host sees and on armour stands. Fixes #337 Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game.rs | 4 + .../horizon-client/src/game/armor_stands.rs | 181 ++++++++- crates/horizon-client/src/game/lan.rs | 7 +- crates/horizon-client/src/game/packs.rs | 1 + crates/horizon-client/src/hud.rs | 15 +- crates/horizon-client/src/lib.rs | 1 + crates/horizon-client/src/trims.rs | 354 ++++++++++++++++++ 7 files changed, 553 insertions(+), 10 deletions(-) create mode 100644 crates/horizon-client/src/trims.rs diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 2df6aa9b0..e6ccccaab 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -1372,6 +1372,8 @@ struct Game<'a> { /// (least recently shown first). skin_downloads: horizon_client::skins::Downloader, skin_slots: Vec<(String, usize)>, + /// Atlas trim slots in use: (sprite name, slot), least recently drawn first. + trim_slots: Vec<(String, usize)>, cart_models: minecarts::CartModels, /// The boat the player rides. riding: Option, @@ -6278,6 +6280,7 @@ impl Game<'_> { mut out: Vec, ) -> Vec { self.prepare_entity_culling(camera); + self.prepare_trims(); let fire_yaw = if self.camera_type == perspective::CameraType::ThirdPersonFront { self.yaw + 180.0 } else { @@ -11439,6 +11442,7 @@ impl<'a> Game<'a> { .join("assets/skins"), ), skin_slots: Vec::new(), + trim_slots: Vec::new(), cart_models: prepared.cart_models, riding: None, ender_items: vec![None; 27], diff --git a/crates/horizon-client/src/game/armor_stands.rs b/crates/horizon-client/src/game/armor_stands.rs index 9f174c5ef..121287c4c 100644 --- a/crates/horizon-client/src/game/armor_stands.rs +++ b/crates/horizon-client/src/game/armor_stands.rs @@ -8,12 +8,13 @@ use horizon_client::{ items::ItemStack, mesher::Vertex, mobs::{Mob, Part, anim::Poses}, + trims::{TrimOverride, TrimRegistry, TrimTexture}, }; use horizon_core::{ geometry::{Aabb, Vec3}, random::RandomSource, }; -use std::{collections::HashMap, sync::Arc}; +use std::{collections::HashMap, path::PathBuf, sync::Arc}; /// Armor stand models and the humanoid layers of every equipment asset. pub(super) struct ArmorStandAssets { @@ -25,6 +26,11 @@ pub(super) struct ArmorStandAssets { pub player: HashMap<&'static str, Part>, /// asset id -> layer kind (humanoid / humanoid_leggings) -> (texture, undyed colour). pub equipment: HashMap)>>, + /// asset id -> `trim_overrides`. + pub trim_overrides: HashMap>, + pub trims: TrimRegistry, + /// The resources the trim textures are made from. + pub root: PathBuf, } impl ArmorStandAssets { pub fn load( @@ -48,6 +54,7 @@ impl ArmorStandAssets { player.insert("elytra", part); } let mut equipment = HashMap::new(); + let mut trim_overrides = HashMap::new(); if let Ok(entries) = std::fs::read_dir(root.join("assets/minecraft/equipment")) { for e in entries.flatten() { let path = e.path(); @@ -76,6 +83,7 @@ impl ArmorStandAssets { ); } } + trim_overrides.insert(format!("minecraft:{name}"), TrimOverride::list(&v)); equipment.insert(format!("minecraft:{name}"), kinds); } } @@ -85,30 +93,67 @@ impl ArmorStandAssets { layers, player, equipment, + trim_overrides, + trims: TrimRegistry::load(root), + root: root.to_owned(), } } + /// Trim data of reloaded resources (the models stay). + pub fn reload_trims(&mut self, root: &std::path::Path) { + let fresh = Self::load(root, None); + self.trim_overrides = fresh.trim_overrides; + self.trims = fresh.trims; + self.root = fresh.root; + } + /// `TrimTextureKey`: the trim texture of `stack` on its humanoid + /// layer (`humanoid` or `humanoid_leggings`), if it has a trim. + fn trim_texture(&self, asset: &str, kind: &str, stack: &ItemStack) -> Option { + let (material, pattern) = stack.extra.as_ref()?.trim.as_ref()?; + let overrides = self + .trim_overrides + .get(asset) + .map_or(&[][..], Vec::as_slice); + TrimTexture::resolve(&self.trims, overrides, material, pattern, kind) + } } impl Game<'_> { /// `HumanoidArmorLayer` for the player: (model, texture rect, colour) of /// each worn piece, head to feet. pub(super) fn player_armor_layers(&self) -> Vec<(&Part, [f32; 4], u32)> { - self.armor_layers(self.armor.each_ref().map(|s| s.as_ref().map(|s| &*s.item))) + self.stack_armor_layers(&self.armor) + } + /// `HumanoidArmorLayer` for worn stacks (head to feet), trims included. + pub(super) fn stack_armor_layers( + &self, + armor: &[Option; 4], + ) -> Vec<(&Part, [f32; 4], u32)> { + self.armor_layers( + armor + .each_ref() + .map(|s| s.as_ref().map(|s| (&*s.item, Some(s)))), + ) } /// `HumanoidArmorLayer` for another player's model: the armour it wears /// (`extra.head` .. `extra.feet`). pub(super) fn worn_armor_layers(&self, m: &Mob) -> Vec<(&Part, [f32; 4], u32)> { let e = &m.extra; - self.armor_layers([&e.head, &e.chest, &e.legs, &e.feet].map(|s| s.as_deref())) + self.armor_layers( + [&e.head, &e.chest, &e.legs, &e.feet].map(|s| s.as_deref().map(|i| (i, None))), + ) } - /// The layers of the armour items `worn`, head to feet. - fn armor_layers(&self, worn: [Option<&str>; 4]) -> Vec<(&Part, [f32; 4], u32)> { + /// The layers of the armour items `worn` (with their stacks when known, + /// for trims), head to feet. + fn armor_layers( + &self, + worn: [Option<(&str, Option<&ItemStack>)>; 4], + ) -> Vec<(&Part, [f32; 4], u32)> { let assets = &self.armor_stand_assets; let mut out = Vec::new(); for (item, layer) in worn .into_iter() .zip(["helmet", "chestplate", "leggings", "boots"]) { - let Some(item) = item else { + let Some((item, stack)) = item else { continue; }; let Some(asset) = self @@ -138,9 +183,117 @@ impl Game<'_> { 0xFF00_0000 | (c & 0xFF) << 16 | (c & 0xFF00) | (c >> 16) & 0xFF }); out.push((part, [r.u0, r.v0, r.u1, r.v1], color)); + // EquipmentLayerRenderer: the trim layer over the armour. + if let Some(r) = stack + .and_then(|s| assets.trim_texture(&asset, kind, s)) + .and_then(|t| self.gui.atlas.sprites.get(&t.sprite())) + { + out.push((part, [r.u0, r.v0, r.u1, r.v1], 0xFFFF_FFFF)); + } } out } + /// `PalettedTextureManager.getOrPrepare` for the trims drawn this frame + /// (the player's armour and the armour stands'): each generated texture + /// goes into an atlas trim slot, a free one, else the least recently + /// drawn. + pub(super) fn prepare_trims(&mut self) { + use horizon_client::hud::TRIM_SLOTS; + let assets = &self.armor_stand_assets; + let items = self.res.items(); + let mut wanted: Vec = Vec::new(); + let guests = self.lan.iter().flat_map(|host| host.hub.guests.iter()); + let stacks = self + .armor + .iter() + .chain(guests.flat_map(|g| g.armor.iter())) + .zip( + ["helmet", "chestplate", "leggings", "boots"] + .into_iter() + .cycle(), + ) + .chain(self.armor_stands.iter().flat_map(|a| { + [5usize, 4, 3, 2] + .map(|slot| &a.equipment[slot]) + .into_iter() + .zip(["helmet", "chestplate", "leggings", "boots"]) + })); + for (stack, layer) in stacks { + let Some(stack) = stack.as_ref().filter(|s| s.extra.is_some()) else { + continue; + }; + let Some(asset) = items + .get(&stack.item) + .and_then(|i| i.equip_asset.as_deref()) + else { + continue; + }; + let kind = if layer == "leggings" { + "humanoid_leggings" + } else { + "humanoid" + }; + if let Some(t) = assets.trim_texture(asset, kind, stack) + && !wanted.contains(&t) + { + wanted.push(t); + } + } + for t in wanted { + let name = t.sprite(); + // Entries the atlas no longer has (rebuilt by a resource reload) are free. + let sprites = &self.gui.atlas.sprites; + self.trim_slots.retain(|(n, _)| sprites.contains_key(n)); + if let Some(i) = self.trim_slots.iter().position(|e| e.0 == name) { + let e = self.trim_slots.remove(i); + self.trim_slots.push(e); + continue; + } + let Some((w, h, rgba)) = t.generate(&self.armor_stand_assets.root) else { + continue; + }; + let used: Vec = self.trim_slots.iter().map(|e| e.1).collect(); + let slot = match (0..TRIM_SLOTS).find(|i| !used.contains(i)) { + Some(free) => free, + None => { + let (old, slot) = self.trim_slots.remove(0); + self.gui.atlas.sprites.remove(&old); + slot + } + }; + let Some(area) = self + .gui + .atlas + .sprites + .get(&format!("horizon/trim{slot}")) + .copied() + else { + continue; + }; + if w > area.w || h > area.h { + continue; + } + let (aw, ah) = (self.gui.atlas.width as f32, self.gui.atlas.height as f32); + let (x, y) = ((area.u0 * aw).round(), (area.v0 * ah).round()); + self.map_patches.push(horizon_client::font::Patch { + x: x as u32, + y: y as u32, + width: w, + height: h, + rgba, + }); + let rect = horizon_client::hud::Rect { + u0: area.u0, + v0: area.v0, + u1: (x + w as f32) / aw, + v1: (y + h as f32) / ah, + w, + h, + }; + self.gui.atlas.sprites.insert(name.clone(), rect); + self.trim_slots.push((name, slot)); + } + } /// `ArmorStandItem.useOn`. pub(super) fn place_armor_stand(&mut self, hit: &super::Hit, stack: &ItemStack) -> bool { if &*stack.item != "minecraft:armor_stand" || hit.face == [0, -1, 0] { @@ -560,6 +713,22 @@ impl Game<'_> { 0, out, ); + // EquipmentLayerRenderer: the trim layer over the armour. + if let Some(trim) = assets + .trim_texture(&asset, kind, stack) + .and_then(|t| uv_of(&t.sprite())) + { + horizon_client::mobs::render::draw( + part, + base, + &layer_poses, + trim, + 0xFFFF_FFFF, + packed, + 0, + out, + ); + } } self.cull_entity_vertices(out, entity_start); } diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index f9ea1262b..4fb99e2e9 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -1253,7 +1253,7 @@ impl Game<'_> { }; let atlas = &self.gui.atlas; let lookup = |name: &str| atlas.sprites.get(name).map(|r| [r.u0, r.v0, r.u1, r.v1]); - for m in host.models.values() { + for (conn, m) in &host.models { let entity_start = out.len(); let light = self.world.light( m.position.x.floor() as i32, @@ -1268,7 +1268,10 @@ impl Game<'_> { &lookup, packed, self.res.mob_data(), - &self.worn_armor_layers(m), + &host.hub.guest(*conn).map_or_else( + || self.worn_armor_layers(m), + |g| self.stack_armor_layers(&g.armor), + ), out, ); self.held_item_geometry(m, camera, alpha, packed, true, out); diff --git a/crates/horizon-client/src/game/packs.rs b/crates/horizon-client/src/game/packs.rs index ac08385a0..e635b46d2 100644 --- a/crates/horizon-client/src/game/packs.rs +++ b/crates/horizon-client/src/game/packs.rs @@ -171,6 +171,7 @@ impl Game<'_> { } }; // Everything loaded: switch over. + self.armor_stand_assets.reload_trims(root); self.random_tick_sections.clear(); self.portals.sections.clear(); self.options.resources = root.to_path_buf(); diff --git a/crates/horizon-client/src/hud.rs b/crates/horizon-client/src/hud.rs index 0cc99b07b..69d642246 100644 --- a/crates/horizon-client/src/hud.rs +++ b/crates/horizon-client/src/hud.rs @@ -38,6 +38,9 @@ pub const MINIMAP_SPRITE: &str = "horizon/minimap"; pub const SKIN_SLOTS: usize = 32; /// Reused by the visible rows of the classic world selector. pub const WORLD_ICON_SLOTS: usize = 32; +/// Atlas slots for armour trim textures made at run time (`trims`), each the +/// size of the largest trim texture. +pub const TRIM_SLOTS: usize = 32; pub fn decode(path: &Path) -> Result<(u32, u32, Vec)> { decode_bytes(&fs::read(path)?) } @@ -159,7 +162,7 @@ impl HudAtlas { } /// Empty slots written at run time: map textures (game/maps.rs), the /// minimap, downloaded skins, world icons and the Horizon menu text. - fn slots(images: &mut Vec) { + fn slots(images: &mut Vec, trim: (u32, u32)) { for i in 0..MAP_SLOTS { images.push((format!("horizon/map{i}"), 128, 128, vec![0; 128 * 128 * 4])); } @@ -174,6 +177,14 @@ impl HudAtlas { for i in 0..SKIN_SLOTS { images.push((format!("horizon/skin{i}"), 64, 64, vec![0; 64 * 64 * 4])); } + for i in 0..TRIM_SLOTS { + images.push(( + format!("horizon/trim{i}"), + trim.0, + trim.1, + vec![0; (trim.0 * trim.1 * 4) as usize], + )); + } for i in 0..WORLD_ICON_SLOTS { images.push(( format!("horizon/world-icon{i}"), @@ -256,7 +267,7 @@ impl HudAtlas { } images.push(("horizon/white".into(), 4, 4, vec![255; 64])); if full { - Self::slots(&mut images); + Self::slots(&mut images, crate::trims::slot_size(root)); } images.sort_by(|a, b| b.2.cmp(&a.2).then(b.1.cmp(&a.1))); let width = 4096u32; diff --git a/crates/horizon-client/src/lib.rs b/crates/horizon-client/src/lib.rs index 7a69de4aa..b12981533 100644 --- a/crates/horizon-client/src/lib.rs +++ b/crates/horizon-client/src/lib.rs @@ -179,6 +179,7 @@ pub mod ticket_levels; pub mod title; pub mod title_edition; pub mod toasts; +pub mod trims; pub mod ui; pub mod ui_theme; pub mod vanillagen; diff --git a/crates/horizon-client/src/trims.rs b/crates/horizon-client/src/trims.rs new file mode 100644 index 000000000..e53aeed72 --- /dev/null +++ b/crates/horizon-client/src/trims.rs @@ -0,0 +1,354 @@ +//! Armour trims on worn armour: `EquipmentLayerRenderer`'s trim layer. A +//! trim's texture is `textures/trims/entity//.png` recoloured +//! by `PalettedTextureManager`: every pixel whose colour is in the texture's +//! base palette (its `palette` metadata section, `trim_base`) takes the colour +//! at the same index of the material's palette (`textures/palettes/trim/*`), +//! unless the equipment asset's `trim_overrides` pick another texture or +//! palette (iron armour with an iron trim uses `trim/iron_darker`). +use horizon_assets::palette::apply_palette; +use serde_json::Value; +use std::{collections::HashMap, fs, path::Path}; + +/// An RGBA image: width, height, pixels. +pub type Image = (u32, u32, Vec); + +/// `minecraft:` added to an identifier without a namespace. +fn qualified(id: &str) -> String { + if id.contains(':') { + id.to_owned() + } else { + format!("minecraft:{id}") + } +} + +/// `assets///` of an identifier. +fn asset_path(root: &Path, folder: &str, id: &str, suffix: &str) -> std::path::PathBuf { + let id = qualified(id); + let (namespace, path) = id.split_once(':').unwrap_or(("minecraft", &id)); + root.join("assets") + .join(namespace) + .join(folder) + .join(format!("{path}{suffix}")) +} + +/// `EquipmentClientInfo.TrimOverride`: when the trim matches (`when`'s +/// material and pattern, each optional), use `texture` instead of the +/// pattern's asset id and `palette` (none when absent) as the palette. +#[derive(Clone, Debug, Default, PartialEq, Eq)] +pub struct TrimOverride { + pub material: Option, + pub pattern: Option, + pub texture: Option, + pub palette: Option, +} +impl TrimOverride { + /// An equipment asset's `trim_overrides` list. + pub fn list(equipment: &Value) -> Vec { + let Some(list) = equipment.get("trim_overrides").and_then(Value::as_array) else { + return Vec::new(); + }; + let id = |v: &Value, key: &str| v.get(key).and_then(Value::as_str).map(qualified); + list.iter() + .filter_map(|o| { + let when = o.get("when")?; + Some(Self { + material: id(when, "material"), + pattern: id(when, "pattern"), + texture: id(o, "texture"), + palette: id(o, "palette"), + }) + }) + .collect() + } + /// `TrimPredicate.matches`. + fn matches(&self, material: &str, pattern: &str) -> bool { + self.material.as_deref().is_none_or(|m| m == material) + && self.pattern.as_deref().is_none_or(|p| p == pattern) + } +} + +/// The `trim_pattern` (asset id) and `trim_material` (palette id) registries. +#[derive(Clone, Debug, Default)] +pub struct TrimRegistry { + patterns: HashMap, + materials: HashMap, +} +impl TrimRegistry { + /// Every `data//trim_pattern` and `trim_material` entry. + pub fn load(root: &Path) -> Self { + let mut out = Self::default(); + let Ok(namespaces) = fs::read_dir(root.join("data")) else { + return out; + }; + for ns in namespaces.flatten() { + let namespace = ns.file_name().to_string_lossy().into_owned(); + for (folder, key, map) in [ + ("trim_pattern", "asset_id", &mut out.patterns), + ("trim_material", "palette_id", &mut out.materials), + ] { + let Ok(files) = fs::read_dir(ns.path().join(folder)) else { + continue; + }; + for f in files.flatten() { + let path = f.path(); + if path.extension().is_none_or(|e| e != "json") { + continue; + } + let Some(value) = fs::read(&path) + .ok() + .and_then(|b| serde_json::from_slice::(&b).ok()) + else { + continue; + }; + if let Some(v) = value.get(key).and_then(Value::as_str) { + let name = path.file_stem().unwrap_or_default().to_string_lossy(); + map.insert(format!("{namespace}:{name}"), qualified(v)); + } + } + } + } + out + } + #[cfg(test)] + fn of(patterns: &[(&str, &str)], materials: &[(&str, &str)]) -> Self { + let map = |l: &[(&str, &str)]| { + l.iter() + .map(|(k, v)| (k.to_string(), v.to_string())) + .collect() + }; + Self { + patterns: map(patterns), + materials: map(materials), + } + } +} + +/// The texture and palette of one trim layer. +#[derive(Clone, Debug, PartialEq, Eq, Hash)] +pub struct TrimTexture { + /// `:trims/entity//`, under `textures/`. + pub texture: String, + /// The target palette under `textures/palettes/`; none draws the + /// texture's own colours. + pub palette: Option, +} +impl TrimTexture { + /// `TrimTextureKey.getOrPrepareTexture`: the trim (`material`, + /// `pattern` registry ids) on the `layer` (`humanoid`, + /// `humanoid_leggings`...) of an equipment asset with `overrides`. + pub fn resolve( + registry: &TrimRegistry, + overrides: &[TrimOverride], + material: &str, + pattern: &str, + layer: &str, + ) -> Option { + let (material, pattern) = (qualified(material), qualified(pattern)); + let mut texture = registry.patterns.get(&pattern)?.clone(); + let mut palette = Some(registry.materials.get(&material)?.clone()); + if let Some(o) = overrides.iter().find(|o| o.matches(&material, &pattern)) { + if let Some(t) = &o.texture { + texture.clone_from(t); + } + palette.clone_from(&o.palette); + } + let (namespace, path) = texture.split_once(':')?; + Some(Self { + texture: format!("{namespace}:trims/entity/{layer}/{path}"), + palette, + }) + } + /// The atlas sprite name the generated texture is stored under. + pub fn sprite(&self) -> String { + format!( + "horizon/trim/{}/{}", + self.texture, + self.palette.as_deref().unwrap_or("-") + ) + } + /// `PalettedTextureManager.prepareSlot`: the texture with its base + /// palette's colours swapped for the target palette's (`PaletteMapping`; + /// unchanged when a palette is missing or the sizes differ). None when + /// the texture itself is missing. + pub fn generate(&self, root: &Path) -> Option { + let path = asset_path(root, "textures", &self.texture, ".png"); + let (w, h, pixels) = crate::hud::decode(&path).ok()?; + let Some(palette) = &self.palette else { + return Some((w, h, pixels)); + }; + let base = fs::read(path.with_extension("png.mcmeta")) + .ok() + .and_then(|b| serde_json::from_slice::(&b).ok()) + .and_then(|m| { + m.get("palette")? + .get("base_palette")? + .as_str() + .map(str::to_owned) + }); + let load = |id: &str| { + crate::hud::decode(&asset_path(root, "textures/palettes", id, ".png")) + .ok() + .map(|(_, _, p)| argb(&p)) + }; + let mut mapped = argb(&pixels); + if let (Some(key), Some(target)) = (base.as_deref().and_then(load), load(palette)) { + // Different sizes: PaletteMapping.NONE, the texture as it is. + let _ = apply_palette(&mut mapped, &key, &target); + } + let out = mapped + .iter() + .flat_map(|p| { + let [a, r, g, b] = p.to_be_bytes(); + [r, g, b, a] + }) + .collect(); + Some((w, h, out)) + } +} + +fn argb(rgba: &[u8]) -> Vec { + rgba.as_chunks::<4>() + .0 + .iter() + .map(|p| u32::from_be_bytes([p[3], p[0], p[1], p[2]])) + .collect() +} + +/// The largest trim texture of the resources (the size of the atlas's trim +/// slots), at least vanilla's 64x32. +pub fn slot_size(root: &Path) -> (u32, u32) { + let mut size = (64, 32); + let Ok(namespaces) = fs::read_dir(root.join("assets")) else { + return size; + }; + for ns in namespaces.flatten() { + let Ok(layers) = fs::read_dir(ns.path().join("textures/trims/entity")) else { + continue; + }; + for layer in layers.flatten() { + for f in fs::read_dir(layer.path()).into_iter().flatten().flatten() { + let path = f.path(); + if path.extension().is_some_and(|e| e == "png") + && let Some((w, h)) = png_size(&path) + { + size = (size.0.max(w.min(512)), size.1.max(h.min(512))); + } + } + } + } + size +} + +/// The width and height in a PNG's IHDR chunk. +fn png_size(path: &Path) -> Option<(u32, u32)> { + use std::io::Read; + let mut head = [0u8; 24]; + fs::File::open(path).ok()?.read_exact(&mut head).ok()?; + let be = |i: usize| u32::from_be_bytes(head[i..i + 4].try_into().unwrap()); + (&head[12..16] == b"IHDR").then(|| (be(16), be(20))) +} + +#[cfg(test)] +mod tests { + use super::*; + + fn registry() -> TrimRegistry { + TrimRegistry::of( + &[("minecraft:coast", "minecraft:coast")], + &[ + ("minecraft:iron", "minecraft:trim/iron"), + ("minecraft:gold", "minecraft:trim/gold"), + ], + ) + } + + #[test] + fn material_palette_and_layer_folder() { + let t = TrimTexture::resolve( + ®istry(), + &[], + "minecraft:gold", + "minecraft:coast", + "humanoid_leggings", + ) + .unwrap(); + assert_eq!(t.texture, "minecraft:trims/entity/humanoid_leggings/coast"); + assert_eq!(t.palette.as_deref(), Some("minecraft:trim/gold")); + // Unknown registry entries draw nothing. + assert!( + TrimTexture::resolve( + ®istry(), + &[], + "minecraft:wood", + "minecraft:coast", + "humanoid" + ) + .is_none() + ); + } + + #[test] + fn equipment_overrides_pick_the_darker_palette() { + let iron = serde_json::json!({"trim_overrides": [ + {"palette": "minecraft:trim/iron_darker", "when": {"material": "minecraft:iron"}}, + ]}); + let overrides = TrimOverride::list(&iron); + let resolve = + |m| TrimTexture::resolve(®istry(), &overrides, m, "coast", "humanoid").unwrap(); + assert_eq!( + resolve("iron").palette.as_deref(), + Some("minecraft:trim/iron_darker") + ); + assert_eq!( + resolve("gold").palette.as_deref(), + Some("minecraft:trim/gold") + ); + // An override without a palette leaves the texture's own colours. + let plain = TrimOverride::list(&serde_json::json!({"trim_overrides": [ + {"texture": "minecraft:other", "when": {"pattern": "minecraft:coast"}}, + ]})); + let t = TrimTexture::resolve(®istry(), &plain, "gold", "coast", "humanoid").unwrap(); + assert_eq!(t.texture, "minecraft:trims/entity/humanoid/other"); + assert_eq!(t.palette, None); + } + + #[test] + fn vanilla_trims_are_recoloured() { + let root = Path::new(env!("CARGO_MANIFEST_DIR")).join("../../.local/horizon-client/26.3"); + if !root.join("assets/minecraft/textures/trims").is_dir() { + return; + } + let registry = TrimRegistry::load(&root); + let t = TrimTexture::resolve( + ®istry, + &[], + "minecraft:gold", + "minecraft:coast", + "humanoid", + ) + .unwrap(); + let (w, h, gold) = t.generate(&root).unwrap(); + assert_eq!((w, h), (64, 32)); + let plain = TrimTexture { + palette: None, + ..t.clone() + }; + let (_, _, grey) = plain.generate(&root).unwrap(); + // Every opaque pixel of the grey pattern takes a gold palette colour. + let gold_palette = argb( + &crate::hud::decode(&root.join("assets/minecraft/textures/palettes/trim/gold.png")) + .unwrap() + .2, + ); + let mut opaque = 0; + for (g, c) in grey.chunks(4).zip(gold.chunks(4)) { + if g[3] != 0 { + opaque += 1; + let c = u32::from_be_bytes([0xFF, c[0], c[1], c[2]]); + assert!(gold_palette.contains(&c), "{c:08x}"); + } + } + assert!(opaque > 0); + assert_eq!(slot_size(&root), (64, 32)); + } +} From 38276fbc30fee22a46848691522ab1dc2bfe1d7d Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 12:35:27 +0200 Subject: [PATCH 008/126] Locator bar HUD and waypoint styles LocatorBar: when the server tracks waypoints for the player, the bar above the hotbar shows a dot per waypoint within 60 degrees of the view (farthest first), coloured from the waypoint's colour or its id's hash, with the sprite its style picks by distance (assets/*/waypoint_style/*.json, WaypointStyleManager) and the blinking up or down arrow when the waypoint is above or below the screen. The background is nine-sliced. Hud.nextContextualInfoState picks between the jump bar, the experience bar (100 ticks after an experience change) and the locator bar. Waypoints come from ClientboundTrackedWaypointPacket on remote servers and, on a served world, from the host's own connection in lan/waypoints.rs; entity waypoints in view follow the entity's eyes. Fixes #339 Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game.rs | 62 +- .../horizon-client/src/game/lan_waypoints.rs | 13 +- crates/horizon-client/src/game/locator_bar.rs | 126 +++ crates/horizon-client/src/game/mounts.rs | 29 +- crates/horizon-client/src/game/packs.rs | 1 + crates/horizon-client/src/game/remote.rs | 18 + crates/horizon-client/src/lib.rs | 1 + crates/horizon-client/src/locator_bar.rs | 742 ++++++++++++++++++ 8 files changed, 978 insertions(+), 14 deletions(-) create mode 100644 crates/horizon-client/src/game/locator_bar.rs create mode 100644 crates/horizon-client/src/locator_bar.rs diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 2df6aa9b0..3b511a7d8 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -80,6 +80,7 @@ mod level_particles; mod levels; mod lightning; mod llamas; +mod locator_bar; mod loom; mod mace; mod machines; @@ -1350,6 +1351,14 @@ struct Game<'a> { /// Entities of types Horizon does not simulate. others: Vec, armor_stand_assets: armor_stands::ArmorStandAssets, + /// `WaypointStyleManager`. + waypoint_styles: horizon_client::locator_bar::WaypointStyles, + /// `ClientWaypointManager`: the locator bar's waypoints. + waypoints: horizon_client::locator_bar::ClientWaypoints, + /// The camera the last frame drew from (position, yaw, pitch, fov), for the locator bar. + locator_camera: Option<([f64; 3], f32, f32, f32)>, + /// `LocalPlayer.experienceDisplayStartTick`: (last progress, seen a change, tick). + experience_display: (f32, bool, u64), boats: Vec, boat_models: boats::BoatModels, /// EndCrystalModel's baked layer. @@ -3865,6 +3874,7 @@ impl Game<'_> { None => 0.0, }; self.ticks += 1; + self.track_experience_display(); // `/tick freeze` stops the world but not the player. let running = self.clock.world_runs(); if running { @@ -4717,12 +4727,41 @@ impl Game<'_> { self.draw_extras(&mut batch); } if show_hud { - // The mount's hearts (and the jump bar that replaces the experience bar). - let (vehicle_hearts, jump_bar) = if spectator { - (0, false) + // Hud.nextContextualInfoState: the jump bar, the experience bar or + // the locator bar above the hotbar. + let has_experience = !self.creative && !spectator; + let contextual = horizon_client::locator_bar::ContextualBar::next( + self.waypoints.has_waypoints(), + !spectator && self.jumpable_mount(), + self.mount_jumping(), + has_experience, + self.experience_recent(), + ); + use horizon_client::locator_bar::ContextualBar; + // The mount's hearts (and the jump bar). + let vehicle_hearts = if spectator { + 0 } else { - self.draw_mount_hud(&mut batch, wi, hi) + self.draw_mount_hud( + &mut batch, + wi, + hi, + contextual == ContextualBar::JumpableVehicle, + ) }; + if contextual == ContextualBar::Locator { + let (sprite, [x, y, w, h]) = horizon_client::locator_bar::background(wi, hi); + horizon_client::ui::nine_slice( + &mut batch, + &self.gui.atlas, + sprite, + x as f32, + y as f32, + w as f32, + h as f32, + u32::MAX, + ); + } if !self.creative && !spectator && let Some(p) = &mut self.player @@ -4734,7 +4773,7 @@ impl Game<'_> { hi, self.experience.progress, self.experience.level, - !jump_bar, + contextual == ContextualBar::Experience, &width, ); hud_layout::paint(&mut batch, atlas, &draws); @@ -4784,6 +4823,10 @@ impl Game<'_> { let draws = self.health_hud.layout(&inputs, wi, hi); hud_layout::paint(&mut batch, atlas, &draws); } + if contextual == ContextualBar::Locator { + let draws = self.locator_bar_draws(wi, hi); + hud_layout::paint(&mut batch, &self.gui.atlas, &draws); + } if !spectator { self.draw_selected_name(&mut batch, !self.creative); } @@ -7554,6 +7597,7 @@ impl Game<'_> { Ok(()) } fn close_world(&mut self) -> Result<()> { + self.clear_waypoints(); self.begin_closing_save(false) } fn finish_close_world(&mut self) -> Result<()> { @@ -9581,6 +9625,8 @@ impl Game<'_> { } else { self.fov_degrees(camera_alpha as f32, camera.to_array()) }; + self.locator_camera = + (!live && !title).then_some((camera.to_array(), view_yaw, view_pitch, fov_degrees)); let bob = if title { glam::Mat4::IDENTITY } else { @@ -11419,6 +11465,10 @@ impl<'a> Game<'a> { armor_stands: Vec::new(), others: Vec::new(), armor_stand_assets: prepared.armor_stand_assets, + waypoint_styles: prepared.waypoint_styles, + waypoints: Default::default(), + locator_camera: None, + experience_display: Default::default(), boats: Vec::new(), boat_models: prepared.boat_models, crystal_model: prepared.crystal_model, @@ -11542,6 +11592,7 @@ struct GameCpuResources { map_frame_model: frames::FrameModel, glow_map_frame_model: frames::FrameModel, armor_stand_assets: armor_stands::ArmorStandAssets, + waypoint_styles: horizon_client::locator_bar::WaypointStyles, boat_models: boats::BoatModels, cart_models: minecarts::CartModels, crystal_model: Option, @@ -11561,6 +11612,7 @@ impl GameCpuResources { map_frame_model: frames::bake_frame(root, "item_frame_map"), glow_map_frame_model: frames::bake_frame(root, "glow_item_frame_map"), armor_stand_assets: armor_stands::ArmorStandAssets::load(root, document.as_ref()), + waypoint_styles: horizon_client::locator_bar::WaypointStyles::load(root), boat_models: boats::BoatModels::load(document.as_ref()), cart_models: minecarts::CartModels::load(document.as_ref()), crystal_model: model("minecraft:end_crystal#main"), diff --git a/crates/horizon-client/src/game/lan_waypoints.rs b/crates/horizon-client/src/game/lan_waypoints.rs index ba1512a00..87476dc46 100644 --- a/crates/horizon-client/src/game/lan_waypoints.rs +++ b/crates/horizon-client/src/game/lan_waypoints.rs @@ -9,6 +9,10 @@ use horizon_client::{ }, }; +/// The host player's connection id in the waypoint managers: its packets +/// go to this client's locator bar rather than to a guest. +const HOST_CONN: u32 = u32::MAX; + /// `waypoint_transmit_range`: hidden by crouching, invisibility or a head worn. fn transmit_range(crouching: bool, invisible: bool, head: Option<&ItemStack>) -> f64 { let hiding_head = head.is_some_and(|s| HIDING_HEADS.contains(&&*s.item)); @@ -47,7 +51,7 @@ impl Game<'_> { self.dim.id(), waypoints::Player { uuid: h.uuid, - conn: None, + conn: Some(HOST_CONN), position: h.position, spectator: self.spectator(), transmit_range: transmit_range( @@ -123,7 +127,12 @@ impl Game<'_> { } } for (conn, packet) in out { - if let Some(g) = host.hub.guest(conn) { + if conn == HOST_CONN { + // The host's own connection: its locator bar. + if let horizon_protocol::packets::play::Clientbound::TrackedWaypoint(w) = &packet { + self.handle_waypoint(w); + } + } else if let Some(g) = host.hub.guest(conn) { g.send(&packet); } } diff --git a/crates/horizon-client/src/game/locator_bar.rs b/crates/horizon-client/src/game/locator_bar.rs new file mode 100644 index 000000000..aa69f7e7d --- /dev/null +++ b/crates/horizon-client/src/game/locator_bar.rs @@ -0,0 +1,126 @@ +//! The locator bar on this client (horizon_client::locator_bar): the +//! waypoints a server tracks for the player (`handleWaypoint`; on a served +//! world the host's own connection in lan/waypoints.rs), the experience +//! bar's priority after a change, and the dots drawn from the last frame's +//! camera. +use super::Game; +use horizon_client::{ + hud_layout::GuiDraw, + locator_bar::{ClientWaypoints, View}, +}; +use horizon_protocol::packets::play::TrackedWaypoint; + +/// `Player.getEyeHeight` while standing. +const PLAYER_EYES: f64 = 1.62; + +fn uuid(ints: [i32; 4]) -> u128 { + ints.iter() + .fold(0u128, |acc, &i| acc << 32 | u128::from(i as u32)) +} + +impl Game<'_> { + /// `ClientPacketListener.handleWaypoint`. + pub(super) fn handle_waypoint(&mut self, packet: &TrackedWaypoint) { + self.waypoints.apply(packet); + } + /// A new connection or world starts with no waypoints. + pub(super) fn clear_waypoints(&mut self) { + self.waypoints = ClientWaypoints::default(); + } + /// `LocalPlayer.setExperienceValues`: a change of progress shows the + /// experience bar for 100 ticks, except the first one + /// (`experienceDisplayStartTick` starts at `Integer.MIN_VALUE`). + pub(super) fn track_experience_display(&mut self) { + let progress = self.experience.progress; + let (last, seen, _) = &mut self.experience_display; + if progress != *last { + *last = progress; + if *seen { + self.experience_display.2 = self.ticks; + } else { + *seen = true; + } + } + // EnchantmentScreen and AnvilScreen.containerTick keep it up. + if self.station.as_ref().is_some_and(|s| { + matches!( + s.kind, + super::stations::Kind::Enchanting | super::stations::Kind::Anvil + ) + }) { + self.experience_display.2 = self.ticks; + } + } + /// `Hud.willPrioritizeExperienceInfo`. + pub(super) fn experience_recent(&self) -> bool { + let (_, _, start) = self.experience_display; + start != 0 && start + 100 > self.ticks + } + /// The local player's UUID, as servers know it. + fn own_uuid(&self) -> u128 { + match &self.remote { + Some(r) => r.profile(), + None => self.level.player_uuid.map_or(0, uuid), + } + } + /// An entity's block position and (interpolated) eyes, by UUID. + fn waypoint_entity(&self, id: u128, alpha: f64) -> Option<([i32; 3], [f64; 3])> { + let at = |p: [f64; 3], q: [f64; 3], eyes: f64| { + let pos: [f64; 3] = std::array::from_fn(|i| q[i] + (p[i] - q[i]) * alpha); + (p.map(|c| c.floor() as i32), [pos[0], pos[1] + eyes, pos[2]]) + }; + if let Some(r) = &self.remote { + let entity = r.player_entity(id)?; + let m = self.mobs.iter().find(|m| m.id == entity)?; + let v = |v: horizon_core::geometry::Vec3| [v.x, v.y, v.z]; + return Some(at(v(m.position), v(m.previous), m.eye_height())); + } + let host = self.lan.as_ref()?; + let g = host.hub.guests.iter().find(|g| g.uuid == id && g.placed)?; + Some(at(g.position, g.previous_position, PLAYER_EYES)) + } + /// `LocatorBar.extractRenderState` from the last frame's camera. + pub(super) fn locator_bar_draws(&self, gui_width: i32, gui_height: i32) -> Vec { + let (Some((camera_pos, yaw, pitch, fov)), Some(p)) = (self.locator_camera, &self.player) + else { + return Vec::new(); + }; + let alpha = self.clock.camera_fraction(); + // Camera.getViewRotationProjectionMatrix, through view space: the + // depth along the look direction and the height on screen. + let (sy, cy) = ( + f64::from(yaw.to_radians()).sin(), + f64::from(yaw.to_radians()).cos(), + ); + let (sp, cp) = ( + f64::from(pitch.to_radians()).sin(), + f64::from(pitch.to_radians()).cos(), + ); + let forward = [-sy * cp, -sp, cy * cp]; + let up = [-sy * sp, cp, cy * sp]; + let focal = 1.0 / f64::from((fov / 2.0).to_radians()).tan(); + let project = |o: [f64; 3]| { + let dot = |a: [f64; 3]| a[0] * o[0] + a[1] * o[1] + a[2] * o[2]; + let depth = dot(forward); + let y = dot(up) * focal / depth; + // Points behind the camera land past the far plane (z > 1). + [0.0, y, if depth < 0.0 { 2.0 } else { 0.5 }] + }; + let entity = |id: u128| self.waypoint_entity(id, alpha); + let view = View { + gui_width, + gui_height, + camera_uuid: self.own_uuid(), + camera_entity_pos: [p.position.x, p.position.y, p.position.z], + camera_pos, + yaw, + pitch, + fov, + project: &project, + entity: &entity, + styles: &self.waypoint_styles, + tick: self.ticks, + }; + self.waypoints.draw(&view) + } +} diff --git a/crates/horizon-client/src/game/mounts.rs b/crates/horizon-client/src/game/mounts.rs index 42eac1e9b..0b25f961b 100644 --- a/crates/horizon-client/src/game/mounts.rs +++ b/crates/horizon-client/src/game/mounts.rs @@ -453,25 +453,40 @@ impl Game<'_> { _ => {} } } - /// `Hud.extractVehicleHealth` and the jump bar that replaces the - /// experience bar on a saddled jumper. Returns the mount's heart count - /// (`getVehicleMaxHearts`) and whether the jump bar shows. - pub(super) fn draw_mount_hud(&self, batch: &mut HudBatch, w: i32, h: i32) -> (i32, bool) { + /// `Player.jumpableVehicle`: a saddled mount that jumps. + pub(super) fn jumpable_mount(&self) -> bool { + self.mount_index() + .is_some_and(|i| self.mobs[i].extra.saddled) + } + /// `willPrioritizeJumpInfo`: charging a jump or recharging. + pub(super) fn mount_jumping(&self) -> bool { + self.mount.jump_scale > 0.0 || self.mount.jump_ticks < 0 + } + /// `Hud.extractVehicleHealth`, and the jump bar when it is the + /// contextual bar (`jump_bar`). Returns the mount's heart count + /// (`getVehicleMaxHearts`). + pub(super) fn draw_mount_hud( + &self, + batch: &mut HudBatch, + w: i32, + h: i32, + jump_bar: bool, + ) -> i32 { let Some(i) = self.mount_index() else { - return (0, false); + return 0; }; let m = &self.mobs[i]; let atlas = &self.gui.atlas; let hearts = horizon_client::hud_layout::vehicle_max_hearts(m.attrs.max_health); let draws = horizon_client::hud_layout::vehicle_health(w, h, hearts, m.health); horizon_client::hud_layout::paint(batch, atlas, &draws); - if m.extra.saddled { + if jump_bar { // JumpableVehicleBar: the cooldown shows while the jump recharges. let cooldown = i32::from(self.mount.jump_ticks < 0); let draws = horizon_client::hud_overlays::jump_bar(w, h, cooldown, self.mount.jump_scale); horizon_client::hud_layout::paint(batch, atlas, &draws); } - (hearts, m.extra.saddled) + hearts } } diff --git a/crates/horizon-client/src/game/packs.rs b/crates/horizon-client/src/game/packs.rs index ac08385a0..f4f0a760f 100644 --- a/crates/horizon-client/src/game/packs.rs +++ b/crates/horizon-client/src/game/packs.rs @@ -171,6 +171,7 @@ impl Game<'_> { } }; // Everything loaded: switch over. + self.waypoint_styles = horizon_client::locator_bar::WaypointStyles::load(root); self.random_tick_sections.clear(); self.portals.sections.clear(); self.options.resources = root.to_path_buf(); diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 5b8072d7f..9570f8675 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -295,6 +295,7 @@ impl Game<'_> { r.clear_sections(); } self.apply_settings(); + self.clear_waypoints(); self.remote = Some(Remote { session, brand: "unknown".into(), @@ -369,6 +370,7 @@ impl Game<'_> { // Leaving on purpose: nothing for auto-reconnect to retry. self.extras_left(); } + self.clear_waypoints(); if let Some(mut r) = self.remote.take() { r.session.disconnect(); } @@ -1760,6 +1762,7 @@ impl Game<'_> { self.capture(false); } } + C::TrackedWaypoint(p) => self.handle_waypoint(&p), C::SetExperience(p) => { self.experience = Experience { level: p.level, @@ -2520,6 +2523,7 @@ impl Game<'_> { fn tick_remote_level(&mut self) -> Result<()> { self.ticks += 1; + self.track_experience_display(); // Options.broadcastOptions: a changed render distance is sent again. let view = client_view_distance(self.settings.render_distance); if let Some(r) = self.remote.as_mut() @@ -4472,6 +4476,20 @@ impl horizon_client::interaction_input::InteractionWorld for RemoteInputWorld<'_ } } +impl Remote { + /// The local player's profile UUID. + pub(super) fn profile(&self) -> u128 { + self.profile + } + /// The entity id of a player in the level, by profile UUID. + pub(super) fn player_entity(&self, uuid: u128) -> Option { + self.level_players + .iter() + .find(|(_, u)| **u == uuid) + .map(|(id, _)| *id as u32) + } +} + #[cfg(test)] mod tests { use super::Game; diff --git a/crates/horizon-client/src/lib.rs b/crates/horizon-client/src/lib.rs index 7a69de4aa..946be9811 100644 --- a/crates/horizon-client/src/lib.rs +++ b/crates/horizon-client/src/lib.rs @@ -102,6 +102,7 @@ pub mod landing; pub mod lang; pub mod level_loading; pub mod light; +pub mod locator_bar; pub mod lod; pub mod logging; pub mod menu; diff --git a/crates/horizon-client/src/locator_bar.rs b/crates/horizon-client/src/locator_bar.rs new file mode 100644 index 000000000..ecead2c52 --- /dev/null +++ b/crates/horizon-client/src/locator_bar.rs @@ -0,0 +1,742 @@ +//! The locator bar: `ClientWaypointManager` (the waypoints the server +//! tracks for this player, from `ClientboundTrackedWaypointPacket`), +//! `WaypointStyleManager` (`waypoint_style/*.json`: near and far distances +//! and the dot sprites between them) and `LocatorBar`, the contextual bar +//! that draws a dot per waypoint within 60 degrees of the view, with an +//! arrow when it is above or below the screen. +use crate::hud_layout::{Blend, GuiDraw}; +use horizon_assets::animation::{AnimationClip, AnimationMetadata}; +use horizon_core::geometry::trig; +use horizon_protocol::packets::play::{ + TrackedWaypoint, WaypointId, WaypointTarget, waypoint_operation, +}; +use std::{borrow::Cow, collections::HashMap, fs, path::Path}; + +/// `WaypointStyle`: the sprites (under `hud/locator_bar_dot/`) from near to far. +#[derive(Clone, Debug, PartialEq)] +pub struct WaypointStyle { + pub near_distance: i32, + pub far_distance: i32, + pub sprites: Vec, +} +impl WaypointStyle { + /// `WaypointStyleManager.MISSING`. + fn missing() -> Self { + Self { + near_distance: 0, + far_distance: 1, + sprites: vec!["hud/locator_bar_dot/missingno".into()], + } + } + /// `WaypointStyle.CODEC` and `validate`: None when the file is invalid. + pub fn parse(json: &str) -> Option { + let v: serde_json::Value = serde_json::from_str(json).ok()?; + let distance = |key: &str, default: i32| match v.get(key) { + None => Some(default), + Some(d) => d + .as_i64() + .filter(|d| (0..=60_000_000).contains(d)) + .map(|d| d as i32), + }; + let near_distance = distance("near_distance", 128)?; + let far_distance = distance("far_distance", 332)?; + let sprites = v + .get("sprites")? + .as_array()? + .iter() + .map(|s| { + let id = s.as_str()?; + let (namespace, path) = id.split_once(':').unwrap_or(("minecraft", id)); + // Sprites of the gui atlas are named by path (minecraft only). + (namespace == "minecraft").then(|| format!("hud/locator_bar_dot/{path}")) + }) + .collect::>>()?; + (!sprites.is_empty() && near_distance > 0 && near_distance < far_distance).then_some(Self { + near_distance, + far_distance, + sprites, + }) + } + /// `WaypointStyle.sprite`. + pub fn sprite(&self, distance: f32) -> &str { + let (first, last) = (&self.sprites[0], &self.sprites[self.sprites.len() - 1]); + if distance < self.near_distance as f32 { + return first; + } + if distance >= self.far_distance as f32 { + return last; + } + match self.sprites.len() { + 1 => first, + 3 => &self.sprites[1], + n => { + let t = (distance - self.near_distance as f32) + / (self.far_distance - self.near_distance) as f32; + // Mth.lerpInt(t, 1, n - 1). + &self.sprites[(1 + (t * (n as f32 - 2.0)).floor() as i32) as usize] + } + } + } +} + +/// An animated GUI sprite (`.png.mcmeta` animation, ticked with the GUI +/// atlas): its image and frame sizes and the frame sequence. +#[derive(Clone, Debug)] +pub struct SpriteFrames { + image: [i32; 2], + frame: [i32; 2], + clip: AnimationClip, +} +impl SpriteFrames { + /// None for a still sprite or invalid metadata. + fn load(png: &Path) -> Option { + let text = fs::read_to_string(png.with_extension("png.mcmeta")).ok()?; + let meta: HashMap> = + serde_json::from_str(&text).ok()?; + let animation = AnimationMetadata::from_json(meta.get("animation")?.get()).ok()?; + // The PNG header: width and height at bytes 16..24 of IHDR. + let mut header = [0u8; 24]; + std::io::Read::read_exact(&mut fs::File::open(png).ok()?, &mut header).ok()?; + let dim = |at: usize| i32::from_be_bytes(header[at..at + 4].try_into().unwrap_or_default()); + let image = [dim(16), dim(20)]; + let frame = animation.frame_size(image[0], image[1]); + if frame[0] <= 0 || frame[1] <= 0 || image[0] % frame[0] != 0 || image[1] % frame[1] != 0 { + return None; + } + let count = (image[0] / frame[0]) * (image[1] / frame[1]); + let clip = animation.clip(count as u32).ok()??; + Some(Self { image, frame, clip }) + } + /// The `region` (image width, height, u, v) of the frame shown at `tick`. + fn region(&self, tick: u64) -> [i32; 4] { + let index = self.clip.sample(tick).frame as i32; + let columns = self.image[0] / self.frame[0]; + [ + self.image[0], + self.image[1], + index % columns * self.frame[0], + index / columns * self.frame[1], + ] + } +} + +/// `WaypointStyleManager`: every `assets//waypoint_style/*.json`, +/// plus the animations of the bar's own sprites (the arrows blink). +#[derive(Clone, Debug, Default)] +pub struct WaypointStyles( + HashMap, + HashMap, +); +impl WaypointStyles { + pub fn load(root: &Path) -> Self { + let mut frames = HashMap::new(); + let hud = root.join("assets/minecraft/textures/gui/sprites/hud"); + let dots = fs::read_dir(hud.join("locator_bar_dot")) + .into_iter() + .flatten() + .flatten() + .map(|e| e.path()); + let arrows = ["locator_bar_arrow_up", "locator_bar_arrow_down"] + .map(|a| hud.join(format!("{a}.png"))); + for png in arrows.into_iter().chain(dots) { + if png.extension().is_none_or(|e| e != "png") { + continue; + } + let Some(f) = SpriteFrames::load(&png) else { + continue; + }; + let name = png + .strip_prefix(hud.parent().unwrap_or(&hud)) + .map(|r| r.with_extension("").to_string_lossy().replace('\\', "/")) + .unwrap_or_default(); + frames.insert(name, f); + } + let mut out = HashMap::new(); + for ns in fs::read_dir(root.join("assets")) + .into_iter() + .flatten() + .flatten() + { + let namespace = ns.file_name().to_string_lossy().into_owned(); + for f in fs::read_dir(ns.path().join("waypoint_style")) + .into_iter() + .flatten() + .flatten() + { + let path = f.path(); + if path.extension().is_none_or(|e| e != "json") { + continue; + } + let name = path.file_stem().unwrap_or_default().to_string_lossy(); + if let Some(style) = fs::read_to_string(&path) + .ok() + .and_then(|t| WaypointStyle::parse(&t)) + { + out.insert(format!("{namespace}:{name}"), style); + } else { + log::warn!("Horizon: invalid waypoint style {}", path.display()); + } + } + } + Self(out, frames) + } + /// The sprite at `tick`, with its animation frame when it has one. + fn sprite(&self, name: &str, x: i32, y: i32, w: i32, h: i32, color: u32, tick: u64) -> GuiDraw { + let mut d = sprite(name, x, y, w, h, color); + if let (Some(f), GuiDraw::Sprite { region, .. }) = (self.1.get(name), &mut d) { + *region = Some(f.region(tick)); + } + d + } + /// `get`: the style, or the missing one. + pub fn get(&self, id: &str) -> Cow<'_, WaypointStyle> { + let id = if id.contains(':') { + Cow::Borrowed(id) + } else { + Cow::Owned(format!("minecraft:{id}")) + }; + self.0 + .get(&*id) + .map_or_else(|| Cow::Owned(WaypointStyle::missing()), Cow::Borrowed) + } +} + +/// `ClientWaypointManager`: the tracked waypoints by identifier. +#[derive(Clone, Debug, Default)] +pub struct ClientWaypoints { + waypoints: Vec, +} +impl ClientWaypoints { + /// `ClientboundTrackedWaypointPacket.apply`. + pub fn apply(&mut self, packet: &TrackedWaypoint) { + let at = self.waypoints.iter().position(|w| w.id == packet.id); + match packet.operation { + waypoint_operation::TRACK => match at { + Some(i) => self.waypoints[i] = packet.clone(), + None => self.waypoints.push(packet.clone()), + }, + waypoint_operation::UNTRACK => { + if let Some(i) = at { + self.waypoints.remove(i); + } + } + // `TrackedWaypoint.update`: only the same kind of waypoint moves. + _ => { + if let Some(w) = at.map(|i| &mut self.waypoints[i]) { + use WaypointTarget as T; + if matches!( + (w.target, packet.target), + (T::Block(_), T::Block(_)) + | (T::Chunk(_), T::Chunk(_)) + | (T::Azimuth(_), T::Azimuth(_)) + ) { + w.target = packet.target; + } + } + } + } + } + pub fn has_waypoints(&self) -> bool { + !self.waypoints.is_empty() + } + pub fn clear(&mut self) { + self.waypoints.clear(); + } +} + +/// What the locator bar needs of the camera and the world this frame. +pub struct View<'a> { + pub gui_width: i32, + pub gui_height: i32, + /// The camera entity's UUID, its block position and its position. + pub camera_uuid: u128, + pub camera_entity_pos: [f64; 3], + /// `Camera.position()` and `yRot()`, `xRot()`, `getFov()` in degrees. + pub camera_pos: [f64; 3], + pub yaw: f32, + pub pitch: f32, + pub fov: f32, + /// `Camera.getViewRotationProjectionMatrix`, applied to a point + /// relative to the camera: normalised device coordinates. + pub project: &'a dyn Fn([f64; 3]) -> [f64; 3], + /// An entity with this UUID in the level: (block position, eye position). + pub entity: &'a dyn Fn(u128) -> Option<([i32; 3], [f64; 3])>, + pub styles: &'a WaypointStyles, + /// Client ticks, for animated sprites. + pub tick: u64, +} + +/// `TrackedWaypoint.PitchDirection`. +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub enum Pitch { + None, + Up, + Down, +} + +/// `UUID.hashCode`. +fn uuid_hash(uuid: u128) -> i32 { + let hilo = (uuid >> 64) as u64 ^ uuid as u64; + ((hilo >> 32) as i32) ^ (hilo as i32) +} +/// `String.hashCode`. +fn string_hash(s: &str) -> i32 { + s.encode_utf16() + .fold(0i32, |h, c| h.wrapping_mul(31).wrapping_add(i32::from(c))) +} + +/// `ARGB.setBrightness`. +pub fn set_brightness(color: u32, brightness: f32) -> u32 { + let [alpha, r, g, b] = color.to_be_bytes().map(i32::from); + let max = r.max(g).max(b); + let min = r.min(g).min(b); + let range = (max - min) as f32; + let saturation = if max != 0 { range / max as f32 } else { 0.0 }; + let argb = + |r: i32, g: i32, b: i32| u32::from_be_bytes([alpha as u8, r as u8, g as u8, b as u8]); + let round = |v: f32| (v * 255.0).round() as i32; + if saturation == 0.0 { + let v = round(brightness); + return argb(v, v, v); + } + let (cr, cg, cb) = ( + (max - r) as f32 / range, + (max - g) as f32 / range, + (max - b) as f32 / range, + ); + let mut hue = if r == max { + cb - cg + } else if g == max { + 2.0 + cr - cb + } else { + 4.0 + cg - cr + } / 6.0; + if hue < 0.0 { + hue += 1.0; + } + let segment = (hue - hue.floor()) * 6.0; + let offset = segment - segment.floor(); + let primary = brightness * (1.0 - saturation); + let secondary = brightness * (1.0 - saturation * offset); + let tertiary = brightness * (1.0 - saturation * (1.0 - offset)); + let full = round(brightness); + match segment as i32 { + 0 => argb(full, round(tertiary), round(primary)), + 1 => argb(round(secondary), full, round(primary)), + 2 => argb(round(primary), full, round(tertiary)), + 3 => argb(round(primary), round(secondary), full), + 4 => argb(round(tertiary), round(primary), full), + 5 => argb(full, round(primary), round(secondary)), + _ => argb(r, g, b), + } +} + +/// `Mth.wrapDegrees`. +fn wrap_degrees(angle: f32) -> f32 { + let mut a = angle % 360.0; + if a >= 180.0 { + a -= 360.0; + } + if a < -180.0 { + a += 360.0; + } + a +} + +fn centre(v: [i32; 3]) -> [f64; 3] { + v.map(|c| f64::from(c) + 0.5) +} + +impl View<'_> { + /// `Vec3iWaypoint.position`: the tracked entity's eyes when it is within + /// 3 blocks (Manhattan) of the waypoint, else the block's centre. + fn block_position(&self, w: &TrackedWaypoint, v: [i32; 3]) -> [f64; 3] { + if let WaypointId::Uuid(uuid) = w.id + && let Some((block, eyes)) = (self.entity)(uuid) + { + let manhattan: i32 = (0..3).map(|i| (block[i] - v[i]).abs()).sum(); + if manhattan <= 3 { + return eyes; + } + } + centre(v) + } + /// `yawAngleToCamera` of a point: `degreesDifference(camera yaw, the + /// angle of camera - point turned clockwise by 90 degrees)`. + fn yaw_to(&self, p: [f64; 3]) -> f64 { + let c = self.camera_pos; + // Vec3.rotateClockwise90: (-z, y, x). + let (x, z) = (-(c[2] - p[2]), c[0] - p[0]); + let angle = trig::atan2(z, x) as f32 * (180.0 / std::f32::consts::PI); + f64::from(wrap_degrees(angle - self.yaw)) + } + /// `ChunkPos.getMiddleBlockPosition(y)`'s centre. + fn chunk_middle(chunk: [i32; 2], y: i32) -> [f64; 3] { + centre([chunk[0] * 16 + 8, y, chunk[1] * 16 + 8]) + } + fn yaw_angle(&self, w: &TrackedWaypoint) -> f64 { + match w.target { + WaypointTarget::Empty => f64::NAN, + WaypointTarget::Block(v) => self.yaw_to(self.block_position(w, v)), + WaypointTarget::Chunk(c) => { + self.yaw_to(Self::chunk_middle(c, self.camera_pos[1] as i32)) + } + WaypointTarget::Azimuth(a) => { + f64::from(wrap_degrees(a * (180.0 / std::f32::consts::PI) - self.yaw)) + } + } + } + /// `GameRenderer.projectHorizonToScreen`. + fn horizon(&self) -> f64 { + if self.pitch <= -90.0 { + return f64::NEG_INFINITY; + } + if self.pitch >= 90.0 { + return f64::INFINITY; + } + // Math.tan of the float products, in double. + let rad = std::f32::consts::PI / 180.0; + f64::from(self.pitch * rad).tan() / f64::from(self.fov / 2.0 * rad).tan() + } + fn pitch_direction(&self, w: &TrackedWaypoint) -> Pitch { + let by = |y: f64| { + if y < -1.0 { + Pitch::Down + } else if y > 1.0 { + Pitch::Up + } else { + Pitch::None + } + }; + match w.target { + WaypointTarget::Empty => Pitch::None, + WaypointTarget::Chunk(_) | WaypointTarget::Azimuth(_) => by(self.horizon()), + WaypointTarget::Block(v) => { + let p = self.block_position(w, v); + let c = self.camera_pos; + let s = (self.project)([p[0] - c[0], p[1] - c[1], p[2] - c[2]]); + let behind = s[2] > 1.0; + match by(if behind { -s[1] } else { s[1] }) { + Pitch::None if behind && s[1] > 0.0 => Pitch::Up, + Pitch::None if behind && s[1] < 0.0 => Pitch::Down, + p => p, + } + } + } + } + /// `distanceSquared` from the camera entity. + fn distance_sq(&self, w: &TrackedWaypoint) -> f64 { + let e = self.camera_entity_pos; + let d = |p: [f64; 3]| (0..3).map(|i| (p[i] - e[i]).powi(2)).sum::(); + match w.target { + WaypointTarget::Block(v) => d(centre(v)), + WaypointTarget::Chunk(c) => d(Self::chunk_middle(c, e[1].floor() as i32)), + WaypointTarget::Empty | WaypointTarget::Azimuth(_) => f64::INFINITY, + } + } +} + +/// `LocatorBar.extractBackground`: the nine-sliced sprite and its rectangle. +pub fn background(gui_width: i32, gui_height: i32) -> (&'static str, [i32; 4]) { + ( + "gui/sprites/hud/locator_bar_background", + [gui_width / 2 - 91, gui_height - 32 + 3, 182, 5], + ) +} + +fn sprite(name: &str, x: i32, y: i32, w: i32, h: i32, color: u32) -> GuiDraw { + GuiDraw::Sprite { + sprite: Cow::Owned(name.to_owned()), + x, + y, + w, + h, + region: None, + color, + blend: Blend::Textured, + } +} + +impl ClientWaypoints { + /// `LocatorBar.extractRenderState`: the farthest waypoint first. + pub fn draw(&self, view: &View) -> Vec { + let top = view.gui_height - 32 + 3; + let mut sorted: Vec<(f64, &TrackedWaypoint)> = self + .waypoints + .iter() + .map(|w| (view.distance_sq(w), w)) + .collect(); + sorted.sort_by(|a, b| b.0.total_cmp(&a.0)); + let mut out = Vec::new(); + for (distance_sq, w) in sorted { + if w.id == WaypointId::Uuid(view.camera_uuid) { + continue; + } + let angle = view.yaw_angle(w); + // `!(angle <= -60) && !(angle > 60)`: NaN draws, at the centre. + if angle <= -60.0 || angle > 60.0 { + continue; + } + let middle = ((view.gui_width - 9) as f32 / 2.0).ceil() as i32; + let style = view.styles.get(&w.style); + let distance = (distance_sq as f32).sqrt(); + let color = w.color.map_or_else( + || { + let hash = match &w.id { + WaypointId::Uuid(u) => uuid_hash(*u), + WaypointId::Name(n) => string_hash(n), + }; + set_brightness(0xFF00_0000 | hash as u32, 0.9) + }, + |c| c as u32, + ); + let dot = (angle * 173.0 / 2.0 / 60.0).floor() as i32; + out.push(view.styles.sprite( + style.sprite(distance), + middle + dot, + top - 2, + 9, + 9, + color, + view.tick, + )); + let arrow = match view.pitch_direction(w) { + Pitch::None => continue, + Pitch::Down => (6, "hud/locator_bar_arrow_down"), + Pitch::Up => (-6, "hud/locator_bar_arrow_up"), + }; + out.push(view.styles.sprite( + arrow.1, + middle + dot + 1, + top + arrow.0, + 7, + 5, + u32::MAX, + view.tick, + )); + } + out + } +} + +/// `Hud.ContextualInfo`: which bar sits above the hotbar. +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub enum ContextualBar { + Empty, + Experience, + Locator, + JumpableVehicle, +} +impl ContextualBar { + /// `Hud.nextContextualInfoState`: `recent_experience` is + /// `willPrioritizeExperienceInfo` (experience changed in the last 100 + /// ticks), `jumping` is `willPrioritizeJumpInfo`. + pub fn next( + waypoints: bool, + jumpable_vehicle: bool, + jumping: bool, + has_experience: bool, + recent_experience: bool, + ) -> Self { + if waypoints { + if jumpable_vehicle && jumping { + Self::JumpableVehicle + } else if has_experience && recent_experience { + Self::Experience + } else { + Self::Locator + } + } else if jumpable_vehicle { + Self::JumpableVehicle + } else if has_experience { + Self::Experience + } else { + Self::Empty + } + } +} + +#[cfg(test)] +mod tests { + use super::*; + + fn tracked(operation: i32, id: u128, target: WaypointTarget) -> TrackedWaypoint { + TrackedWaypoint { + operation, + id: WaypointId::Uuid(id), + style: "minecraft:default".into(), + color: None, + target, + } + } + + #[test] + fn styles_pick_sprites_by_distance() { + let default = WaypointStyle::parse( + r#"{"sprites":["minecraft:default_0","minecraft:default_1","minecraft:default_2","minecraft:default_3"]}"#, + ) + .unwrap(); + assert_eq!((default.near_distance, default.far_distance), (128, 332)); + assert_eq!(default.sprite(10.0), "hud/locator_bar_dot/default_0"); + assert_eq!(default.sprite(128.0), "hud/locator_bar_dot/default_1"); + // lerpInt((d - 128) / 204, 1, 3): halfway is the third sprite. + assert_eq!(default.sprite(229.0), "hud/locator_bar_dot/default_1"); + assert_eq!(default.sprite(230.0), "hud/locator_bar_dot/default_2"); + assert_eq!(default.sprite(332.0), "hud/locator_bar_dot/default_3"); + let bowtie = WaypointStyle::parse( + r#"{"near_distance":64,"sprites":["minecraft:bowtie","minecraft:default_0","minecraft:default_1","minecraft:default_2","minecraft:default_3"]}"#, + ) + .unwrap(); + assert_eq!(bowtie.sprite(63.0), "hud/locator_bar_dot/bowtie"); + // lerpInt((d - 64) / 268, 1, 4). + assert_eq!(bowtie.sprite(64.0), "hud/locator_bar_dot/default_0"); + assert_eq!(bowtie.sprite(200.0), "hud/locator_bar_dot/default_1"); + assert_eq!(bowtie.sprite(300.0), "hud/locator_bar_dot/default_2"); + // Three sprites: the middle one between near and far. + let three = WaypointStyle::parse(r#"{"sprites":["a","b","c"]}"#).unwrap(); + assert_eq!(three.sprite(200.0), "hud/locator_bar_dot/b"); + // validate: sprites, near > 0, far > near. + assert!(WaypointStyle::parse(r#"{"sprites":[]}"#).is_none()); + assert!(WaypointStyle::parse(r#"{"near_distance":0,"sprites":["a"]}"#).is_none()); + assert!(WaypointStyle::parse(r#"{"near_distance":400,"sprites":["a"]}"#).is_none()); + assert_eq!( + WaypointStyles::default().get("minecraft:none").sprite(5.0), + "hud/locator_bar_dot/missingno" + ); + } + + #[test] + fn packets_track_update_and_untrack() { + let mut w = ClientWaypoints::default(); + w.apply(&tracked( + waypoint_operation::TRACK, + 1, + WaypointTarget::Block([1, 2, 3]), + )); + assert!(w.has_waypoints()); + w.apply(&tracked( + waypoint_operation::UPDATE, + 1, + WaypointTarget::Block([4, 5, 6]), + )); + assert_eq!(w.waypoints[0].target, WaypointTarget::Block([4, 5, 6])); + // Another kind of waypoint doesn't update it. + w.apply(&tracked( + waypoint_operation::UPDATE, + 1, + WaypointTarget::Azimuth(1.0), + )); + assert_eq!(w.waypoints[0].target, WaypointTarget::Block([4, 5, 6])); + w.apply(&tracked( + waypoint_operation::UNTRACK, + 1, + WaypointTarget::Empty, + )); + assert!(!w.has_waypoints()); + } + + #[test] + fn brightness_like_argb() { + // Pure red at 0.9: Math.round(0.9 * 255) = 230. + assert_eq!(set_brightness(0xFFFF_0000, 0.9), 0xFFE6_0000); + assert_eq!(set_brightness(0xFF80_8080, 0.9), 0xFFE6_E6E6); + assert_eq!(uuid_hash(0x0000_0001_0000_0000_0000_0000_0000_0002), 3); + assert_eq!(string_hash("ab"), 97 * 31 + 98); + } + + #[test] + fn arrows_blink_through_their_frames() { + // locator_bar_arrow_up.png.mcmeta: 7x10, two 5-pixel frames. + let meta = r#"{"frames":[{"index":0,"time":10},{"index":1,"time":4}],"height":5}"#; + let animation = AnimationMetadata::from_json(meta).unwrap(); + let frames = SpriteFrames { + image: [7, 10], + frame: animation.frame_size(7, 10), + clip: animation.clip(2).unwrap().unwrap(), + }; + assert_eq!(frames.region(0), [7, 10, 0, 0]); + assert_eq!(frames.region(9), [7, 10, 0, 0]); + assert_eq!(frames.region(10), [7, 10, 0, 5]); + assert_eq!(frames.region(14), [7, 10, 0, 0]); + } + + #[test] + fn dots_sit_on_the_bar_by_angle() { + let styles = WaypointStyles( + [( + "minecraft:default".to_owned(), + WaypointStyle { + near_distance: 128, + far_distance: 332, + sprites: vec!["hud/locator_bar_dot/default_0".into()], + }, + )] + .into(), + HashMap::new(), + ); + let project = |p: [f64; 3]| [p[0], p[1], 0.5]; + let entity = |_: u128| None; + let view = View { + gui_width: 427, + gui_height: 240, + camera_uuid: 9, + camera_entity_pos: [0.5, 64.0, 0.5], + camera_pos: [0.5, 65.62, 0.5], + yaw: 0.0, + pitch: 0.0, + fov: 70.0, + project: &project, + entity: &entity, + styles: &styles, + tick: 0, + }; + let mut w = ClientWaypoints::default(); + // Yaw 0 looks towards +z: a waypoint straight ahead sits in the middle. + w.apply(&tracked( + waypoint_operation::TRACK, + 1, + WaypointTarget::Block([0, 65, 40]), + )); + // One behind the camera and the camera's own waypoint are not drawn. + w.apply(&tracked( + waypoint_operation::TRACK, + 2, + WaypointTarget::Block([0, 65, -40]), + )); + w.apply(&tracked( + waypoint_operation::TRACK, + 9, + WaypointTarget::Block([0, 65, 40]), + )); + let draws = w.draw(&view); + assert_eq!(draws.len(), 1); + let GuiDraw::Sprite { x, y, .. } = draws[0] else { + panic!("{draws:?}"); + }; + assert_eq!((x, y), (209, 209)); + // 30 degrees to the right: floor(30 * 173 / 120) = 43 pixels. + let east = ClientWaypoints { + waypoints: vec![tracked( + waypoint_operation::TRACK, + 3, + WaypointTarget::Azimuth(30f32.to_radians()), + )], + }; + let GuiDraw::Sprite { x, .. } = east.draw(&view)[0] else { + panic!(); + }; + assert_eq!(x, 209 + 43); + } + + #[test] + fn contextual_bar_priorities() { + use ContextualBar as B; + assert_eq!(B::next(true, false, false, true, false), B::Locator); + assert_eq!(B::next(true, false, false, true, true), B::Experience); + assert_eq!(B::next(true, true, true, true, true), B::JumpableVehicle); + assert_eq!(B::next(false, false, false, true, true), B::Experience); + assert_eq!(B::next(false, false, false, false, false), B::Empty); + // Creative players see the bar too. + assert_eq!(B::next(true, false, false, false, false), B::Locator); + } +} From 9d58d6f525babf5a1478d98cab34cb9cc73f268a Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 13:31:27 +0200 Subject: [PATCH 009/126] Random ticks: a section ticks while it holds a randomly ticking block, as in vanilla Vanilla random-ticks a section while its count of randomly ticking blocks and fluids is above zero (LevelChunkSection.isRandomlyTicking), and asks as it reaches each section. Horizon ticked every section whose palette listed such a state, even after the last one was gone, and decided before the tick's scheduled ticks, which drew positions vanilla doesn't and shifted its position sequence. RandomTickSections now reads each section's blocks (PalettedContainer::has), again only for the sections that changed, and tick_chunk_random asks for each section when it reaches it; the game reads a chunk's sections again only after a block changed. New harness random_tick_sections compares the sections and positions with vanilla's real section counts. Co-Authored-By: Claude Opus 5.5 --- .../examples/random_tick_sections_probe.rs | 132 ++++++++++++++++ crates/horizon-client/src/game.rs | 48 +++--- .../src/random_tick_sections.rs | 149 +++++++++++------- crates/horizon-core/src/paletted.rs | 57 +++++++ crates/horizon-world/src/level/mod.rs | 8 +- crates/horizon-world/src/level/tick.rs | 17 +- .../VanillaRandomTickSectionsOracle.java | 102 ++++++++++++ tools/test_random_tick_sections_parity.py | 73 +++++++++ 8 files changed, 504 insertions(+), 82 deletions(-) create mode 100644 crates/horizon-client/examples/random_tick_sections_probe.rs create mode 100644 mods/horizon/src/test/java/dev/horizonlab/parity/VanillaRandomTickSectionsOracle.java create mode 100644 tools/test_random_tick_sections_parity.py diff --git a/crates/horizon-client/examples/random_tick_sections_probe.rs b/crates/horizon-client/examples/random_tick_sections_probe.rs new file mode 100644 index 000000000..cb8a8b742 --- /dev/null +++ b/crates/horizon-client/examples/random_tick_sections_probe.rs @@ -0,0 +1,132 @@ +//! Random-tick sections companion for tools/test_random_tick_sections_parity.py: +//! the game's `RandomTickSections` choosing the sections of a chunk that +//! `Behaviours::tick_chunk_random` ticks, after the case's edits (see +//! VanillaRandomTickSectionsOracle for the format; the `#resources` line names +//! the prepared resources). The level the ticks run against reads as air +//! everywhere, so nothing ticks for real: its reads are the drawn positions. +use horizon_client::{ + blocks::BlockFacts, + chunk::{Chunk, MIN_Y, Section}, + random_tick_sections::RandomTickSections, +}; +use horizon_core::{ + position::{BlockPos, ChunkPos}, + random::LegacyRandom, +}; +use horizon_world::{ + fluid::FluidKind, + level::{GameRules, LevelAccess, LevelEvent, Ticks, data}, + registry::BlockStateId, +}; +use std::{cell::RefCell, error::Error, fmt::Write, path::PathBuf, sync::Arc}; + +struct Air { + reads: RefCell>, + random: LegacyRandom, + speed: i32, +} +impl LevelAccess for Air { + fn block_state(&self, pos: BlockPos) -> BlockStateId { + self.reads.borrow_mut().push(pos); + BlockStateId(0) + } + fn set_raw(&mut self, _: BlockPos, _: BlockStateId) -> Option { + None + } + fn is_loaded(&self, _: BlockPos) -> bool { + true + } + fn random(&mut self) -> &mut LegacyRandom { + &mut self.random + } + fn game_time(&self) -> i64 { + 0 + } + fn game_rules(&self) -> GameRules { + GameRules { + random_tick_speed: self.speed, + ..Default::default() + } + } + fn emit(&mut self, _: LevelEvent) {} +} + +fn main() -> Result<(), Box> { + let args: Vec = std::env::args().collect(); + let input = std::fs::read_to_string(&args[1])?; + let root = input + .lines() + .find_map(|l| l.strip_prefix("#resources ")) + .map(PathBuf::from) + .ok_or("no #resources line")?; + let registry = data::load_registry(&root)?; + let (facts, behaviours) = BlockFacts::load_pair(&root, ®istry)?; + let mut output = String::new(); + for line in input.lines().filter(|l| !l.starts_with('#')) { + let mut words = line.split(' '); + let mut ticks = Ticks::new(0); + ticks.random_tick_value = words.next().ok_or("no randValue")?.parse()?; + let mut level = Air { + reads: RefCell::default(), + random: LegacyRandom::new(0), + speed: words.next().ok_or("no speed")?.parse()?, + }; + let mut chunk = Arc::new(Chunk::empty(0, 0)); + let mut cache = RandomTickSections::default(); + for word in words { + let op: Vec<&str> = word.split(':').collect(); + let int = |i: usize| -> Result> { Ok(op[i].parse()?) }; + match op[0] { + "s" => { + let (section, index) = (int(1)?, int(2)?); + Arc::make_mut(&mut chunk).set( + index & 15, + MIN_Y + section * 16 + (index >> 8), + index >> 4 & 15, + int(3)? as u32, + ); + } + "f" => { + let (a, b, m) = (int(2)? as u32, int(3)? as u32, int(4)? as usize); + let values = std::array::from_fn(|i| if i % m == m - 1 { b } else { a }); + Arc::make_mut(&mut Arc::make_mut(&mut chunk).sections[int(1)? as usize]) + .blocks = Section::from_blocks(&values); + } + "t" => { + output.push('|'); + level.reads.borrow_mut().clear(); + behaviours.tick_chunk_random( + &mut level, + &mut ticks, + ChunkPos::new(0, 0), + |_, min_y| cache.get((0, 0), &chunk, &facts).contains(min_y), + ); + for pos in level.reads.borrow().iter() { + let state = chunk.block(pos.x, pos.y, pos.z); + let fluid = matches!( + behaviours.fluid(state).kind(), + FluidKind::Lava | FluidKind::FlowingLava + ); + write!( + output, + " {},{},{},{}{}", + pos.x, + pos.y, + pos.z, + if behaviours.is_randomly_ticking(state) { + 'B' + } else { + '-' + }, + if fluid { 'F' } else { '-' }, + )?; + } + } + other => return Err(format!("unknown op {other}").into()), + } + } + writeln!(output, " | {}", ticks.random_tick_value)?; + } + std::fs::write(&args[2], output)?; + Ok(()) +} diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index bad635c5c..afdb2ee37 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -515,6 +515,7 @@ struct GameLevel<'w> { spill: &'w mut spill::Spill, /// Where the chunk tickets let blocks tick. tickets: horizon_client::ticket_levels::Levels, + random_tick_sections: &'w mut horizon_client::random_tick_sections::RandomTickSections, } struct PlayerCollision { y: f64, @@ -2276,6 +2277,7 @@ impl Game<'_> { pending: &mut self.pending, spill: &mut self.spill, tickets: self.tickets.levels(), + random_tick_sections: &mut self.random_tick_sections, }; let result = f(self.res.behaviours(), &mut level, &mut self.block_ticks); self.flush_spill(); @@ -2370,18 +2372,15 @@ impl Game<'_> { self.sync_tick_chunks(); self.start_ticking_chunks(); let levels = self.tickets.levels(); - let mut ticking = Vec::new(); - let facts = self.res.facts(); - for (&(x, z), chunk) in &self.world.chunks { - if !levels.random_ticking(x, z) || !ticking_chunk(&self.world, x, z) { - continue; - } - // Capture eligibility before inside-block and scheduled updates, as - // before. Keep the world map's chunk order, including empty chunks - // (tick_chunk_random still draws for precipitation in those). - let sections = self.random_tick_sections.get((x, z), chunk, facts); - ticking.push((x, z, sections)); - } + // Keep the world map's chunk order, including empty chunks + // (tick_chunk_random still draws for precipitation in those). + let ticking: Vec<_> = self + .world + .chunks + .keys() + .copied() + .filter(|&(x, z)| levels.random_ticking(x, z) && ticking_chunk(&self.world, x, z)) + .collect(); // Entity.checkInsideBlocks for the plates, tripwires and detector rails // under the players (the host and the LAN guests) and the minecarts. let mut inside = Vec::new(); @@ -2423,13 +2422,24 @@ impl Game<'_> { self.process_level_events()?; self.tick_scheduled()?; self.with_level(|b, level, ticks| { - for (x, z, sections) in ticking { - b.tick_chunk_random( - level, - ticks, - horizon_core::position::ChunkPos::new(x, z), - sections, - ); + for (x, z) in ticking { + // The sections are read again only after a block changed. + let mut read = None; + let mut sections = Default::default(); + let pos = horizon_core::position::ChunkPos::new(x, z); + b.tick_chunk_random(level, ticks, pos, |level, min_y| { + if read != Some(level.world.revision) { + read = Some(level.world.revision); + sections = level + .world + .chunks + .get(&(x, z)) + .map_or_else(Default::default, |chunk| { + level.random_tick_sections.get((x, z), chunk, level.facts) + }); + } + sections.contains(min_y) + }); } b.run_block_events(level, ticks); b.tick_block_entities(level, ticks); diff --git a/crates/horizon-client/src/random_tick_sections.rs b/crates/horizon-client/src/random_tick_sections.rs index ce5da051b..23d6a3dbe 100644 --- a/crates/horizon-client/src/random_tick_sections.rs +++ b/crates/horizon-client/src/random_tick_sections.rs @@ -1,7 +1,8 @@ -//! Memoized palette eligibility for the game thread's random-tick snapshot. +//! Which sections of the game thread's chunks random-tick +//! (`LevelChunkSection.isRandomlyTicking`), memoized per section. use crate::{ blocks::BlockFacts, - chunk::{Chunk, MIN_Y, SECTIONS}, + chunk::{Chunk, MIN_Y, SECTIONS, Section}, fast_hash::FxHashMap, }; use horizon_world::registry::BlockStateId; @@ -10,6 +11,13 @@ use std::sync::{Arc, Weak}; /// A value snapshot, in ascending section order, with no per-chunk allocation. #[derive(Clone, Copy, Debug, Default, PartialEq, Eq)] pub struct Sections(u32); +impl Sections { + /// Whether the section starting at block `min_y` is in the set. + pub fn contains(self, min_y: i32) -> bool { + let index = (min_y - MIN_Y) >> 4; + (0..SECTIONS as i32).contains(&index) && self.0 >> index & 1 != 0 + } +} impl Iterator for Sections { type Item = i32; fn next(&mut self) -> Option { @@ -29,12 +37,20 @@ impl ExactSizeIterator for Sections {} struct Cached { chunk: Weak, + /// The section each bit of `sections` was read from. + read: [Weak
; SECTIONS], sections: Sections, } -/// Resident chunks are immutable behind `Arc`; edits use `Arc::make_mut`. -/// A weak reference detects both edits and replacement, without retaining block -/// data or forcing a deep copy on the next edit. It also prevents address reuse. -/// Clear this cache whenever the gameplay facts change (including resource reload). +/// Vanilla keeps a count of randomly ticking blocks and fluids per section, +/// updated by every `setBlockState`, and ticks the sections where it is above +/// zero. Here a section's answer is read from its blocks after any edit: +/// resident chunks and sections are immutable behind `Arc` and edited through +/// `Arc::make_mut`, so a weak reference tells an edited or replaced one from +/// the one read, without retaining block data or forcing a deep copy on the +/// next edit, and prevents address reuse. An unchanged chunk costs one +/// pointer comparison; a changed one, a comparison per section and a read of +/// the sections that changed. Clear this cache whenever the gameplay facts +/// change (including resource reload). #[derive(Default)] pub struct RandomTickSections { chunks: FxHashMap<(i32, i32), Cached>, @@ -46,6 +62,7 @@ impl RandomTickSections { pub fn remove(&mut self, key: &(i32, i32)) { self.chunks.remove(key); } + /// The sections of `chunk` holding a randomly ticking block or fluid. pub fn get(&mut self, key: (i32, i32), chunk: &Arc, facts: &BlockFacts) -> Sections { self.get_with(key, chunk, |id| facts.get(BlockStateId(id)).random_ticks) } @@ -60,17 +77,23 @@ impl RandomTickSections { } let cached = self.chunks.entry(key).or_insert_with(|| Cached { chunk: Weak::new(), + read: std::array::from_fn(|_| Weak::new()), sections: Sections::default(), }); if cached.chunk.as_ptr() != Arc::as_ptr(chunk) { - let mut mask = 0; - for (i, section) in chunk.sections.iter().enumerate() { - // Preserve maybe_has, including unused entries and global palettes. - if section.blocks.maybe_has(&mut random) { - mask |= 1 << i; + for (i, (section, read)) in chunk.sections.iter().zip(&mut cached.read).enumerate() { + if read.as_ptr() == Arc::as_ptr(section) { + continue; } + // `isRandomlyTicking`: the blocks themselves, not the palette, + // which keeps the states no block uses any more. + if section.blocks.has(&mut random) { + cached.sections.0 |= 1 << i; + } else { + cached.sections.0 &= !(1 << i); + } + *read = Arc::downgrade(section); } - cached.sections = Sections(mask); cached.chunk = Arc::downgrade(chunk); } cached.sections @@ -97,10 +120,24 @@ mod tests { [MIN_Y] ); assert_eq!(worker.get(0, MIN_Y, 0), 0); - // Even after the last ticking block is removed, its unused palette entry counts. + // Once the last ticking block is gone the section stops ticking, as + // vanilla's count drops to zero, though its palette still lists it. Arc::make_mut(&mut chunk).set(0, MIN_Y, 0, 0); - assert_eq!(cache.get_with((0, 0), &chunk, |id| id == 1).len(), 1); - Arc::make_mut(&mut Arc::make_mut(&mut chunk).sections[0]).compact(); + assert!(chunk.sections[0].blocks.maybe_has(|id| id == 1)); + assert_eq!(cache.get_with((0, 0), &chunk, |id| id == 1).len(), 0); + // Only the edited section is read again (its palette: air, then 1). + Arc::make_mut(&mut chunk).set(0, MIN_Y + 16, 0, 1); + let mut asked = Vec::new(); + let sections = cache.get_with((0, 0), &chunk, |id| { + asked.push(id); + id == 1 + }); + assert_eq!( + (sections.collect::>(), asked), + (vec![MIN_Y + 16], vec![0, 1]) + ); + Arc::make_mut(&mut chunk).set(0, MIN_Y + 16, 0, 0); + Arc::make_mut(&mut Arc::make_mut(&mut chunk).sections[1]).compact(); assert_eq!(cache.get_with((0, 0), &chunk, |id| id == 1).len(), 0); Arc::make_mut(&mut chunk).sections[SECTIONS - 1] = Arc::new(Section::default()); cache.clear(); // resource reload, with changed facts for the same state IDs @@ -138,10 +175,12 @@ mod tests { } let chunk = Arc::new(chunk); let mut cache = RandomTickSections::default(); - // Global maybe_has considers the entire ID range, including absent states. + // Global palettes: the states the blocks hold, not the whole ID range. + assert_eq!(cache.get_with((0, 0), &chunk, |id| id == 40000).len(), 0); + cache.clear(); assert_eq!( cache - .get_with((0, 0), &chunk, |id| id == 40000) + .get_with((0, 0), &chunk, |id| id == 299) .collect::>(), [MIN_Y, MIN_Y + 9 * 16, MIN_Y + (SECTIONS as i32 - 1) * 16] ); @@ -201,7 +240,7 @@ mod tick_parity { } #[test] - fn actual_random_ticks_match_original_scan() { + fn actual_random_ticks_match_a_block_scan() { let root = std::env::var_os("HORIZON_RESOURCES") .map(PathBuf::from) .unwrap_or_else(|| { @@ -228,6 +267,7 @@ mod tick_parity { let registry = data::load_registry(&root).unwrap(); let (mut facts, behaviours) = BlockFacts::load_pair(&root, ®istry).unwrap(); let grass = registry.default_state("minecraft:grass_block").unwrap(); + let stone = registry.default_state("minecraft:stone").unwrap(); let chunk = |x| { let mut c = Chunk::empty(x, 0); c.lit = true; @@ -280,6 +320,15 @@ mod tick_parity { 40 | 41 => { Arc::make_mut(level.chunks.get_mut(&(0, 0)).unwrap()).lit = step == 41; } + 70 => { + // Every block of a ticking section replaced: its + // palette still lists grass, but nothing ticks there. + let c = Arc::make_mut(level.chunks.get_mut(&(-1, 0)).unwrap()); + for i in 0..4096 { + c.set(i & 15, MIN_Y + 4 * 16 + (i >> 8), i >> 4 & 15, stone.0); + } + assert!(c.sections[4].blocks.maybe_has(|id| id == grass.0)); + } _ => {} } } @@ -290,47 +339,41 @@ mod tick_parity { facts.states[grass.0 as usize].random_ticks = step == 60; cache.clear(); } - let old: Vec<_> = original - .chunks - .iter() - .filter(|(_, c)| c.lit) - .map(|(&key, c)| { - let sections: Vec<_> = c - .sections - .iter() - .enumerate() - .filter(|(_, s)| { - s.blocks - .maybe_has(|id| facts.get(BlockStateId(id)).random_ticks) - }) - .map(|(i, _)| MIN_Y + i as i32 * 16) - .collect(); - (key, sections) - }) - .collect(); - let new: Vec<_> = cached - .chunks - .iter() - .filter(|(_, c)| c.lit) - .map(|(&key, c)| (key, cache.get(key, c, &facts))) - .collect(); - assert_eq!( - old, - new.iter() - .map(|(k, s)| (*k, s.collect::>())) - .collect::>() - ); - // Stand in for an inside-block/scheduled write AFTER eligibility capture. + // A write between ticks. if step == 20 { for level in [&mut original, &mut cached] { level.set_raw(BlockPos::new(0, MIN_Y + 16, 0), grass); } } - for ((x, z), sections) in old { - behaviours.tick_chunk_random(&mut original, &mut a, ChunkPos::new(x, z), sections); + let lit = |level: &Level| { + let mut keys: Vec<_> = level + .chunks + .iter() + .filter(|(_, c)| c.lit) + .map(|(&key, _)| key) + .collect(); + keys.sort(); + keys + }; + let random = |id| facts.get(BlockStateId(id)).random_ticks; + for (x, z) in lit(&original) { + // Vanilla's rule, asked as each section is reached: any of its + // 4,096 blocks ticks randomly. + let reference = |level: &mut Level, min_y: i32| { + let chunk = &level.chunks[&(x, z)]; + (0..16).any(|y| { + (0..16).any(|z| (0..16).any(|x| random(chunk.get(x, min_y + y, z)))) + }) + }; + behaviours.tick_chunk_random(&mut original, &mut a, ChunkPos::new(x, z), reference); } - for ((x, z), sections) in new { - behaviours.tick_chunk_random(&mut cached, &mut b, ChunkPos::new(x, z), sections); + for (x, z) in lit(&cached) { + let memoized = |level: &mut Level, min_y| { + cache + .get((x, z), &level.chunks[&(x, z)], &facts) + .contains(min_y) + }; + behaviours.tick_chunk_random(&mut cached, &mut b, ChunkPos::new(x, z), memoized); } assert_eq!(original.reads, cached.reads, "ordered reads at tick {step}"); assert_eq!(original.events, cached.events, "events at tick {step}"); diff --git a/crates/horizon-core/src/paletted.rs b/crates/horizon-core/src/paletted.rs index 3d56bb987..dad7f76a0 100644 --- a/crates/horizon-core/src/paletted.rs +++ b/crates/horizon-core/src/paletted.rs @@ -674,6 +674,41 @@ impl PalettedContainer { Palette::Global => (0..1u32 << self.bits.min(31)).any(predicate), } } + /// Whether any entry satisfies `predicate`. Unlike [`Self::maybe_has`], + /// palette entries no entry uses any more don't count. + pub fn has(&self, mut predicate: impl FnMut(u32) -> bool) -> bool { + let matching: Vec = match &self.palette { + Palette::Single(value) => return predicate(*value), + Palette::List(list) => list.iter().map(|&v| predicate(v)).collect(), + Palette::Global => Vec::new(), + }; + if matches!(self.palette, Palette::List(_)) { + if !matching.contains(&true) { + return false; + } + if !matching.contains(&false) { + return true; + } + } + let bits = usize::from(self.bits); + let per = 64 / bits; + let m = mask(self.bits); + let mut left = self.strategy.entries(); + for &word in &self.words { + for slot in 0..per.min(left) { + let id = ((word >> (slot * bits)) & m) as usize; + let hit = match self.palette { + Palette::Global => predicate(id as u32), + _ => matching[id], + }; + if hit { + return true; + } + } + left = left.saturating_sub(per); + } + false + } /// Heap bytes held by the palette and the storage. pub fn heap_bytes(&self) -> usize { self.words.capacity() * 8 @@ -771,9 +806,31 @@ mod tests { let wire = PalettedContainer::from_wire(strategy, bits, palette, words.to_vec()).unwrap(); assert_eq!(wire, c); + for wanted in [0, 7, 14, 35, 7 * 699, 5] { + assert_eq!( + c.has(|v| v == wanted || v == wanted + 7), + plain.iter().any(|&v| v == wanted || v == wanted + 7), + "has {wanted} in {distinct} values" + ); + } } } #[test] + fn has_ignores_stale_palette_entries() { + let mut c = PalettedContainer::new(BLOCKS, 0); + assert!(c.has(|v| v == 0) && !c.has(|v| v == 3)); + c.set(4095, 3); + assert!(c.has(|v| v == 3)); + c.set(4095, 0); + assert!(c.maybe_has(|v| v == 3) && !c.has(|v| v == 3)); + for v in 1..=300 { + c.set(v as usize, v); + } + assert!(c.is_global() && c.has(|v| v == 300)); + c.set(300, 0); + assert!(c.maybe_has(|v| v == 300) && !c.has(|v| v == 300)); + } + #[test] fn uniform_detection_ignores_stale_palette_entries() { let mut c = PalettedContainer::new(BLOCKS, 0); c.set(10, 3); diff --git a/crates/horizon-world/src/level/mod.rs b/crates/horizon-world/src/level/mod.rs index de7312cb1..1c338f2ed 100644 --- a/crates/horizon-world/src/level/mod.rs +++ b/crates/horizon-world/src/level/mod.rs @@ -19,9 +19,9 @@ //! `ServerLevel.tickChunk`'s random ticks: for each non-empty section, //! `randomTickSpeed` (game rule, default 3) positions are drawn with //! `Level.getBlockRandomPos` and randomly-ticking block and fluid states are -//! ticked. The caller decides which sections are randomly ticking (vanilla -//! counts randomly-ticking states per section); [`Behaviours::random_tick`] -//! ticks a single position. +//! ticked. The caller says which sections are randomly ticking when each is +//! reached (vanilla counts randomly-ticking states per section); +//! [`Behaviours::random_tick`] ticks a single position. //! 3. [`Behaviours::run_block_events`] runs queued block events (pistons), //! then (after entities) [`Behaviours::tick_block_entities`] advances //! moving pistons ([`Ticks::moving_pistons`]). @@ -69,7 +69,7 @@ //! level.time += 1; //! behaviours.tick_scheduled(&mut level, &mut ticks); //! for chunk in ticking_chunks { -//! behaviours.tick_chunk_random(&mut level, &mut ticks, chunk, randomly_ticking_section_min_ys(chunk)); +//! behaviours.tick_chunk_random(&mut level, &mut ticks, chunk, |level, min_y| level.randomly_ticking(chunk, min_y)); //! } //! behaviours.run_block_events(&mut level, &mut ticks); //! /* tick entities */ diff --git a/crates/horizon-world/src/level/tick.rs b/crates/horizon-world/src/level/tick.rs index 1c45990a0..e9e4f6791 100644 --- a/crates/horizon-world/src/level/tick.rs +++ b/crates/horizon-world/src/level/tick.rs @@ -1615,16 +1615,18 @@ impl Behaviours { }; ticks.handling_tick = false; } - /// Random-tick one chunk (`ServerLevel.tickChunk` block part). `sections` - /// yields the minimum block Y of every section the caller considers - /// randomly ticking (vanilla: sections containing randomly-ticking states), - /// in ascending order. Draws `randomTickSpeed` positions per section. + /// Random-tick one chunk (`ServerLevel.tickChunk` block part). Visits the + /// sections from the bottom up and draws `randomTickSpeed` positions in + /// each one `ticking(level, min_y)` reports randomly ticking + /// (`LevelChunkSection.isRandomlyTicking`: it holds a randomly ticking + /// block or fluid). Vanilla asks as it reaches each section, so the ticks + /// of the sections below count. pub fn tick_chunk_random( &self, level: &mut L, ticks: &mut Ticks, chunk: ChunkPos, - sections: impl IntoIterator, + mut ticking: impl FnMut(&mut L, i32) -> bool, ) { let speed = level.game_rules().random_tick_speed; if speed <= 0 { @@ -1639,7 +1641,10 @@ impl Behaviours { } } } - for min_y in sections { + for min_y in (level.min_y()..level.max_y()).step_by(16) { + if !ticking(level, min_y) { + continue; + } for _ in 0..speed { let pos = ticks.block_random_pos(min_x, min_y, min_z, 15); self.sim(level, ticks).random_tick_at(pos); diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaRandomTickSectionsOracle.java b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaRandomTickSectionsOracle.java new file mode 100644 index 000000000..a0dc5d914 --- /dev/null +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaRandomTickSectionsOracle.java @@ -0,0 +1,102 @@ +package dev.horizonlab.parity; + +import java.io.*; +import java.lang.reflect.Field; +import java.nio.charset.StandardCharsets; +import java.nio.file.*; +import net.minecraft.core.BlockPos; +import net.minecraft.util.RandomSource; +import net.minecraft.world.level.Level; +import net.minecraft.world.level.block.Block; +import net.minecraft.world.level.block.state.BlockState; +import net.minecraft.world.level.chunk.LevelChunkSection; +import net.minecraft.world.level.chunk.PalettedContainerFactory; + +/** + * Original oracle for which sections of a chunk random-tick and where: the + * real LevelChunkSection block counts (setBlockState, and recalcBlockCounts + * for a section built from a filled container, as a loaded one is) and + * isRandomlyTicking, with the block part of ServerLevel.tickChunk's section + * loop around them (the precipitation draws included, on a level random + * seeded 0) and the real Level.getBlockRandomPos drawing the positions. + * + * Each case line is "randValue speed op...", ops being "s:section:index:state" + * (setBlockState, index y << 8 | z << 4 | x), "f:section:a:b:m" (a section + * loaded from a container holding b where index % m == m - 1, a elsewhere) and + * "t" (one tick). Prints, per tick, every drawn position with whether its + * block and its fluid tick randomly, then the final randValue. + */ +public final class VanillaRandomTickSectionsOracle { + static final int SECTIONS = 24; + static final int MIN_Y = -64; + + public static void main(String[] args) throws Exception { + ParityData.init(); + var factory = PalettedContainerFactory.create(ParityData.access); + Level level = ParityData.level; + Field randValue = Level.class.getDeclaredField("randValue"); + randValue.setAccessible(true); + try (var out = new PrintWriter(Files.newBufferedWriter(Path.of(args[1]), StandardCharsets.UTF_8)); + var lines = Files.lines(Path.of(args[0]))) { + for (var line : (Iterable) lines::iterator) { + if (line.startsWith("#")) continue; + String[] words = line.trim().split(" "); + randValue.setInt(level, Integer.parseInt(words[0])); + int speed = Integer.parseInt(words[1]); + RandomSource random = RandomSource.create(0); + LevelChunkSection[] sections = new LevelChunkSection[SECTIONS]; + for (int i = 0; i < SECTIONS; i++) sections[i] = new LevelChunkSection(factory); + StringBuilder result = new StringBuilder(); + for (int w = 2; w < words.length; w++) { + String[] op = words[w].split(":"); + switch (op[0]) { + case "s" -> { + int index = Integer.parseInt(op[2]); + sections[Integer.parseInt(op[1])].setBlockState(index & 15, index >> 8, index >> 4 & 15, + state(op[3])); + } + case "f" -> { + BlockState a = state(op[2]), b = state(op[3]); + int m = Integer.parseInt(op[4]); + var states = factory.createForBlockStates(); + for (int index = 0; index < 4096; index++) { + states.getAndSetUnchecked(index & 15, index >> 8, index >> 4 & 15, + index % m == m - 1 ? b : a); + } + sections[Integer.parseInt(op[1])] = new LevelChunkSection(states, factory.createForBiomes()); + } + case "t" -> { + result.append('|'); + // ServerLevel.tickChunk, for a chunk at 0, 0. Its + // precipitation positions use randValue too. + for (int i = 0; i < speed; i++) { + if (random.nextInt(48) == 0) level.getBlockRandomPos(0, 0, 0, 15); + } + if (speed <= 0) continue; + for (int s = 0; s < SECTIONS; s++) { + LevelChunkSection section = sections[s]; + if (!section.isRandomlyTicking()) continue; + int minY = MIN_Y + s * 16; + for (int i = 0; i < speed; i++) { + BlockPos pos = level.getBlockRandomPos(0, minY, 0, 15); + BlockState state = section.getBlockState(pos.getX(), pos.getY() - minY, pos.getZ()); + result.append(' ').append(pos.getX()).append(',').append(pos.getY()).append(',') + .append(pos.getZ()).append(',') + .append(state.isRandomlyTicking() ? 'B' : '-') + .append(state.getFluidState().isRandomlyTicking() ? 'F' : '-'); + } + } + } + default -> throw new IllegalArgumentException(words[w]); + } + } + out.println(result.append(" | ").append(randValue.getInt(level))); + } + } + System.exit(0); + } + + static BlockState state(String id) { + return Block.BLOCK_STATE_REGISTRY.byId(Integer.parseInt(id)); + } +} diff --git a/tools/test_random_tick_sections_parity.py b/tools/test_random_tick_sections_parity.py new file mode 100644 index 000000000..632808523 --- /dev/null +++ b/tools/test_random_tick_sections_parity.py @@ -0,0 +1,73 @@ +#!/usr/bin/env python3 +"""Compare which sections of a chunk random-tick, and the positions drawn in them, with the pinned client. + +Vanilla random-ticks a section while its count of randomly ticking blocks and fluids is above zero +(LevelChunkSection.isRandomlyTicking, counted by setBlockState and recalcBlockCounts), whatever its palette still lists. +Each case loads sections (every block state fills one, alone, so each state's own answer is compared; others mix a +ticking and a non-ticking state), ticks, sets and removes randomly ticking blocks (leaving them in the palette), and +ticks again. Vanilla runs ServerLevel.tickChunk's section loop on real sections with the real getBlockRandomPos +(VanillaRandomTickSectionsOracle); Horizon runs Behaviours::tick_chunk_random with the game's RandomTickSections +(examples/random_tick_sections_probe). Both print every drawn position, whether its block and its fluid tick +randomly, and the final randValue. +""" +import itertools +import json +import random + +try: + from . import lab, oracle_harness as harness +except ImportError: + import lab, oracle_harness as harness + +COUNT = 3000 +SECTIONS = 24 + + +def make_cases(build): + resources = lab.LOCAL / 'horizon-client' / '26.3' + states = json.loads((resources / 'gameplay-facts.json').read_text())['states'] + ticking = [s['id'] for s in states if s['random_ticks']] + still = [s['id'] for s in states if not s['random_ticks']] + sweep = itertools.cycle(range(len(states))) + rng = random.Random(0x5449434B) + lines = [f'#resources {resources}'] + for _ in range(COUNT): + ops = [] + loaded = rng.sample(range(SECTIONS), 14) + for section in loaded[:12]: + state = next(sweep) + ops.append(f'f:{section}:{state}:{state}:1') + mixed = loaded[12:] + for section in mixed: + ops.append(f'f:{section}:{rng.choice(still)}:{rng.choice(ticking)}:{rng.choice([1, 2, 7, 64, 4096])}') + ops.append('t') + placed = [] + for _ in range(rng.randrange(1, 6)): + section, index = rng.randrange(SECTIONS), rng.randrange(4096) + ops.append(f's:{section}:{index}:{rng.choice(ticking)}') + placed.append((section, index)) + ops.append('t') + # Take them away again, and the lone ticking block of the mixed sections: + # their palettes keep the states. + for section, index in placed + [(section, 4095) for section in mixed]: + ops.append(f's:{section}:{index}:{rng.choice([0, 0, rng.choice(still)])}') + ops.append('t') + ops.append('t') + lines.append(f'{rng.randrange(-2**31, 2**31)} {rng.choice([0, 1, 2, 3, 3, 3, 4])} {" ".join(ops)}') + path = build / 'cases.txt' + path.write_text('\n'.join(lines) + '\n') + return path, COUNT + + +if __name__ == '__main__': + harness.differential( + 'random-tick-sections-parity', 'VanillaRandomTickSectionsOracle', 'random_tick_sections_probe', make_cases, + 'Which sections of a chunk random-tick (block and fluid counts over loads, sets and removals, not the palette) ' + 'and the positions tickChunk draws in them, with each position\'s block and fluid random-tick flags. The ' + 'blocks\' random-tick behaviour itself is test_random_tick_parity\'s.', + sources=[lab.ROOT / 'crates/horizon-client/src/random_tick_sections.rs', + lab.ROOT / 'crates/horizon-client/src/chunk.rs', + lab.ROOT / 'crates/horizon-core/src/paletted.rs', + lab.ROOT / 'crates/horizon-world/src/level/tick.rs', + lab.ROOT / 'crates/horizon-world/src/level/ticks.rs'], + expected_lines=COUNT) From 4e45a3bddfd2f0a3090d729ac95a02ab9d11a43e Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 12:36:09 +0200 Subject: [PATCH 010/126] Credits and end poem (WinScreen) Leaving the End through the exit portal for the first time now rolls the end poem, the credits and the post-credits text (WinScreen), as does a server's WIN_GAME event; Options -> Credits & Attribution -> Credits rolls the credits alone. The texts come from the resource root (texts/end.txt, credits.json, postcredits.txt), so packs can replace them. - win_screen.rs: vanilla's line building (PLAYERNAME, the obfuscated names from LegacyRandom(8124371), wrapping at 256), scroll speeds and keys (Space, Ctrl, Up, Escape), the last line pinned mid-screen, the logo, the vignette and the backgrounds. - HUD: Blend::Vignette (RenderPipelines.VIGNETTE) and Blend::EndPortal (the End portal effect as a GUI fill, the poem's background). - Obfuscated text draws a random glyph of the same width each frame. - seenCredits is read and saved; the player stays out of the world while the poem rolls and arrives in the Overworld after it. - horizon-ctl `credits [poem] [SCROLL]` and `options credits`. Fixes #338 Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/font.rs | 71 +++ crates/horizon-client/src/game.rs | 27 +- crates/horizon-client/src/game/agent.rs | 1 + crates/horizon-client/src/game/control.rs | 25 + crates/horizon-client/src/game/end.rs | 5 +- crates/horizon-client/src/game/music.rs | 8 +- crates/horizon-client/src/game/options.rs | 1 + crates/horizon-client/src/game/remote.rs | 4 + .../horizon-client/src/game/startup_menu.rs | 40 ++ crates/horizon-client/src/game/win.rs | 150 ++++++ crates/horizon-client/src/hud.rs | 108 ++++- crates/horizon-client/src/hud.wgsl | 51 +- crates/horizon-client/src/lib.rs | 1 + crates/horizon-client/src/options_ui.rs | 52 +- crates/horizon-client/src/save.rs | 4 + crates/horizon-client/src/win_screen.rs | 452 ++++++++++++++++++ 16 files changed, 982 insertions(+), 18 deletions(-) create mode 100644 crates/horizon-client/src/game/win.rs create mode 100644 crates/horizon-client/src/win_screen.rs diff --git a/crates/horizon-client/src/font.rs b/crates/horizon-client/src/font.rs index aeedb92bd..3039fdb40 100644 --- a/crates/horizon-client/src/font.rs +++ b/crates/horizon-client/src/font.rs @@ -52,6 +52,10 @@ struct Cache { cursor: (u32, u32), pending: Vec, hex: Option>, + /// `FontSet.glyphsByWidth` for obfuscated text (built on first use). + by_width: Option>>, + /// `Font.random`: picks obfuscated glyphs. + random: horizon_core::random::LegacyRandom, } pub struct Font { bitmap: HashMap, @@ -285,6 +289,12 @@ impl Font { cursor: (0, 0), pending: Vec::new(), hex: None, + by_width: None, + random: horizon_core::random::LegacyRandom::new( + std::time::SystemTime::now() + .duration_since(std::time::UNIX_EPOCH) + .map_or(0, |d| d.as_nanos() as i64), + ), }), uniform: false, japanese: false, @@ -353,6 +363,7 @@ impl Font { cache.glyphs.clear(); cache.cursor = (0, 0); cache.hex = None; + cache.by_width = None; } /// The glyph for a character (FontSet.getGlyph). pub fn glyph(&self, c: char) -> Glyph { @@ -427,6 +438,66 @@ impl Font { offset: 0.5, }) } + /// `FontSet.getRandomGlyph`: what an obfuscated character draws, a random + /// glyph as wide as `advance` (rounded up), else the missing glyph. + /// + /// Vanilla picks among every glyph of the font set, Unifont's included. + /// Those are rasterized into a fixed atlas region on demand, which a + /// line of obfuscated text would fill in seconds, so the candidates are + /// the glyphs already in the atlas (the bitmap sheets and spaces), or with + /// "Force Unicode Font" the Unifont glyphs below U+0250. + pub fn random_glyph(&self, advance: f32) -> Glyph { + use horizon_core::random::RandomSource; + let width = advance.ceil() as u32; + let pick = { + let mut cache = self.cache.borrow_mut(); + if cache.by_width.is_none() { + let by_width = self.glyphs_by_width(&mut cache); + cache.by_width = Some(by_width); + } + let Cache { + by_width, random, .. + } = &mut *cache; + by_width + .as_ref() + .and_then(|m| m.get(&width)) + .and_then(|chars| { + let i = random.next_int_bound(chars.len() as i32).ok()?; + chars.get(i as usize).copied() + }) + }; + pick.map_or(self.missing, |c| self.glyph(c)) + } + fn glyphs_by_width(&self, cache: &mut Cache) -> HashMap> { + let mut chars: Vec<(char, f32)> = self.space.iter().map(|(c, a)| (*c, *a)).collect(); + if self.uniform { + if cache.hex.is_none() { + cache.hex = Some(self.load_hex()); + } + for code in 0..0x250u32 { + let hex = cache.hex.iter().flatten().find_map(|p| p.glyphs.get(&code)); + if let (Some(c), Some(h)) = (char::from_u32(code), hex) + && !self.space.contains_key(&c) + { + let width = h.right.saturating_sub(h.left) + 1; + chars.push((c, (width / 2 + 1) as f32)); + } + } + } else { + chars.extend( + self.bitmap + .iter() + .filter(|(c, _)| !self.space.contains_key(c)) + .map(|(c, g)| (*c, g.advance)), + ); + } + chars.sort_by_key(|(c, _)| *c); + let mut out: HashMap> = HashMap::new(); + for (c, advance) in chars { + out.entry(advance.ceil() as u32).or_default().push(c); + } + out + } /// Atlas pixels rasterized since the last call. pub fn take_patches(&self) -> Vec { std::mem::take(&mut self.cache.borrow_mut().pending) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index bad635c5c..02d31b494 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -155,6 +155,7 @@ mod ui_control; mod vault; mod villagers; mod wandering_trader; +mod win; mod wind; mod wither; mod world_loading; @@ -453,6 +454,8 @@ enum Screen { WorldOptions, /// CommandBlockEditScreen (game/command_blocks.rs). CommandBlock, + /// WinScreen: the end poem and the credits (game/win.rs). + Win, } struct Mining { pos: [i32; 3], @@ -1341,6 +1344,8 @@ struct Game<'a> { respawn_travel: Option, /// The next enter_dimension call comes from an End portal. end_portal_travel: bool, + /// The open WinScreen (game/win.rs). + win: Option, end: end::EndState, block_ticks: Ticks, tick_chunks: horizon_client::tick_chunk_membership::TickChunkMembership, @@ -3748,6 +3753,9 @@ impl Game<'_> { return Ok(()); } if let Some((_, target)) = &self.travelling { + if self.win_screen_holds_arrival() { + return Ok(()); + } let (cx, cz) = ( (target.x.floor() as i32) >> 4, (target.z.floor() as i32) >> 4, @@ -4429,7 +4437,8 @@ impl Game<'_> { | Screen::Advancements | Screen::WorldOptions | Screen::CommandBlock - ) || self.book.is_some()) + ) || self.book.is_some() + || self.win_screen_pauses()) } /// `MouseHandler.grabMouse` / `releaseMouse`. Both put the pointer at /// the window's centre, so a screen opened from gameplay (inventory, @@ -4637,6 +4646,10 @@ impl Game<'_> { fn hud_layers(&mut self, size: [u32; 2]) -> HudBatch { let mut batch = HudBatch::new(size); let (w, h) = (batch.width, batch.height); + if self.screen == Screen::Win { + self.draw_win_screen(&mut batch); + return batch; + } if self.screen == Screen::Options { self.draw_options(&mut batch); return batch; @@ -4846,7 +4859,7 @@ impl Game<'_> { self.draw_creative(&mut batch); } Screen::Chat => self.draw_chat_screen(&mut batch), - Screen::Playing | Screen::Options => {} + Screen::Playing | Screen::Options | Screen::Win => {} } self.draw_toasts(&mut batch); self.remote_hud(&mut batch); @@ -9846,7 +9859,7 @@ impl Game<'_> { let blurred = !horizon_client::ui_theme::horizon() && (loading || self.title.as_ref().is_some_and(|t| { - self.screen == Screen::Options + matches!(self.screen, Screen::Options | Screen::Win) || !matches!(t.mode, horizon_client::title::Mode::Main) })); let radius = self.settings.menu_blur as f32; @@ -9932,6 +9945,7 @@ impl Game<'_> { Screen::WorldOptions => self.world_options_escape(), Screen::CommandBlock => self.close_command_block(), Screen::Chat => self.close_chat(), + Screen::Win => self.close_win_screen()?, }, KeyCode::Digit1 | KeyCode::Digit2 @@ -10539,6 +10553,7 @@ impl ApplicationHandler for Game<'_> { let d = scaled(raw_y) as f32; if let Some(title) = &mut self.title && !horizon_client::ui_theme::horizon() + && self.screen != Screen::Win { let size = self .window @@ -10597,6 +10612,7 @@ impl ApplicationHandler for Game<'_> { self.advancements_scroll(scaled(raw_x) as f32, d); } } + WindowEvent::MouseInput { .. } if self.screen == Screen::Win => {} WindowEvent::MouseInput { state, button, .. } if self.screen == Screen::Options => { if self.options_waiting_for_key() && state == ElementState::Pressed { self.options_bind_mouse(button)?; @@ -10858,6 +10874,9 @@ impl ApplicationHandler for Game<'_> { { self.world_options_key(&event) } + WindowEvent::KeyboardInput { event, .. } if self.screen == Screen::Win => { + self.win_key(&event)? + } WindowEvent::KeyboardInput { event, .. } if self.screen == Screen::CommandBlock => { self.command_block_key(&event) } @@ -10994,6 +11013,7 @@ impl ApplicationHandler for Game<'_> { } else if self.title.is_some() { self.tick_backdrop(); } + self.tick_win_screen()?; self.tick_music(); self.tick_sound_engine(); self.clock.record(started.elapsed()); @@ -11420,6 +11440,7 @@ impl<'a> Game<'a> { respawn_config: None, respawn_travel: None, end_portal_travel: false, + win: None, end: Default::default(), block_ticks: Ticks::new(0), tick_chunks: Default::default(), diff --git a/crates/horizon-client/src/game/agent.rs b/crates/horizon-client/src/game/agent.rs index 9a5cd6a58..1fa422f92 100644 --- a/crates/horizon-client/src/game/agent.rs +++ b/crates/horizon-client/src/game/agent.rs @@ -404,6 +404,7 @@ impl Game<'_> { Screen::Advancements => "advancements", Screen::WorldOptions => "world-options", Screen::CommandBlock => "command-block", + Screen::Win => "win", } } pub(super) fn inventory_counts(&self) -> BTreeMap { diff --git a/crates/horizon-client/src/game/control.rs b/crates/horizon-client/src/game/control.rs index 6cbbf5007..6a79419a1 100644 --- a/crates/horizon-client/src/game/control.rs +++ b/crates/horizon-client/src/game/control.rs @@ -42,6 +42,7 @@ const HELP: &[&str] = &[ "chat MESSAGE send chat or a /command to the server", "disconnect leave the server for the server list", "respawn respawn after death on a server", + "credits [poem] [SCROLL] roll the credits (with the end poem), or hold them SCROLL pixels in", "quit save and exit", ]; @@ -555,6 +556,7 @@ impl Game<'_> { "graphics" => Page::Graphics, "graphics-advanced" => Page::GraphicsAdvanced, "extras" => Page::Extras, + "credits" => Page::Credits, other => return Err(format!("unknown options page {other}").into()), }; if self.screen == Screen::Playing && self.title.is_none() { @@ -630,6 +632,25 @@ impl Game<'_> { self.connect_server(arg(1)?, &name)?; ok() } + "credits" => { + let poem = words.get(1) == Some(&"poem"); + let hold = words + .get(1 + usize::from(poem)) + .map(|s| s.parse::()) + .transpose()?; + if self.screen != Screen::Win { + let finish = if self.screen == Screen::Options { + super::win::Finish::Options + } else { + super::win::Finish::Closed + }; + self.open_win_screen(poem, finish); + } + if let Some(scroll) = hold { + self.hold_win_screen(scroll); + } + ok() + } "respawn" => { if self.remote.is_none() || self.screen != Screen::Dead { return Err("respawn needs the death screen on a server".into()); @@ -712,6 +733,9 @@ impl Game<'_> { } fn screen_name(&self) -> &'static str { + if self.screen == Screen::Win { + return "win"; + } if self.title.is_some() { return "title"; } @@ -728,6 +752,7 @@ impl Game<'_> { Screen::Advancements => "advancements", Screen::WorldOptions => "world-options", Screen::CommandBlock => "command-block", + Screen::Win => "win", } } diff --git a/crates/horizon-client/src/game/end.rs b/crates/horizon-client/src/game/end.rs index a7813c767..f5ddf537b 100644 --- a/crates/horizon-client/src/game/end.rs +++ b/crates/horizon-client/src/game/end.rs @@ -377,7 +377,10 @@ impl Game<'_> { f64::from(p.dimensions.width), f64::from(p.dimensions.height), ); - if portal { + if portal && self.dim == Dim::End && !self.level.seen_credits { + // EndPortalBlock.entityInside: the first exit shows the credits. + self.show_end_credits()?; + } else if portal { if self.portals.player.cooldown == 0 { let target = if self.dim == Dim::End { Dim::Overworld diff --git a/crates/horizon-client/src/game/music.rs b/crates/horizon-client/src/game/music.rs index 9198a78a1..6f8b5e7ae 100644 --- a/crates/horizon-client/src/game/music.rs +++ b/crates/horizon-client/src/game/music.rs @@ -12,7 +12,7 @@ impl Game<'_> { pub(super) fn tick_music(&mut self) { let (music, volume) = self.situational_music(); // LevelLoadingScreen: no new track before the player is in the world. - let loading = self.title.is_none() && self.player.is_none(); + let loading = self.title.is_none() && self.player.is_none() && self.win.is_none(); self.music .tick(music.as_ref(), volume, loading, &mut self.audio); } @@ -59,7 +59,11 @@ impl Game<'_> { None => (empty, 1.0), }; let situation = Situation { - screen_music: None, + // WinScreen.getBackgroundMusic. + screen_music: self + .win + .is_some() + .then(horizon_client::music::Music::credits), in_world: eye.is_some(), in_end: self.dim == super::Dim::End, boss_music: self.boss_music(), diff --git a/crates/horizon-client/src/game/options.rs b/crates/horizon-client/src/game/options.rs index 61036d18c..ff9e4f28f 100644 --- a/crates/horizon-client/src/game/options.rs +++ b/crates/horizon-client/src/game/options.rs @@ -235,6 +235,7 @@ impl Game<'_> { let _ = std::fs::create_dir_all(&dir); super::packs::open_folder(&dir); } + Event::Credits => self.open_win_screen(false, super::win::Finish::Options), } } Ok(()) diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 09e03e719..fcc7bee08 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -1840,6 +1840,10 @@ impl Game<'_> { ); } } + // WIN_GAME: the poem and credits, then PERFORM_RESPAWN. + 4 if self.screen != Screen::Win => { + self.open_win_screen(true, super::win::Finish::RemoteRespawn); + } 1 => { self.world.weather.raining = true; self.world.weather.rain_level = (0.0, 0.0); diff --git a/crates/horizon-client/src/game/startup_menu.rs b/crates/horizon-client/src/game/startup_menu.rs index ffbbe7193..4253cbe65 100644 --- a/crates/horizon-client/src/game/startup_menu.rs +++ b/crates/horizon-client/src/game/startup_menu.rs @@ -12,6 +12,8 @@ pub(super) struct StartupMenu { title: Option, options: OptionsUi, options_open: bool, + /// The credits from Credits & Attribution, and their last frame. + win: Option<(horizon_client::win_screen::WinScreen, Instant)>, root: PathBuf, cursor: (f32, f32), pointer: (f64, f64), @@ -378,6 +380,21 @@ impl Loading { let _ = std::fs::create_dir_all(&dir); packs::open_folder(&dir); } + Event::Credits => { + if let Some(gui) = &self.gui { + let name = self.options.as_ref().map_or_else( + || horizon_client::offline_name::generate(0), + Options::player_name, + ); + let screen = horizon_client::win_screen::WinScreen::new( + false, + &self.menu.root, + &name, + &gui.atlas.font, + ); + self.menu.win = Some((screen, Instant::now())); + } + } Event::ButtonClick => {} } } @@ -473,6 +490,20 @@ impl Loading { } } _ if self.gui.is_none() || self.menu.pending.is_some() => {} + WindowEvent::KeyboardInput { event, .. } if self.menu.win.is_some() => { + if let PhysicalKey::Code(code) = event.physical_key { + let pressed = event.state == ElementState::Pressed; + if code == KeyCode::Escape && pressed { + self.menu.win = None; + } else if let Some(key) = horizon_client::win_screen::Key::from_code(code) + && let Some((win, _)) = &mut self.menu.win + { + win.key(key, pressed); + } + } + } + WindowEvent::MouseInput { .. } | WindowEvent::MouseWheel { .. } + if self.menu.win.is_some() => {} WindowEvent::CursorMoved { position, .. } => { self.menu.pointer = (position.x, position.y); self.update_menu_cursor(); @@ -610,6 +641,15 @@ impl Loading { self.progress.line(), self.progress.fraction(), ); + } else if let Some((win, frame)) = &mut self.menu.win { + let now = Instant::now(); + // 20 ticks a second: the startup menu runs no tick rate. + let delta_ticks = now.duration_since(*frame).as_secs_f32() * 20.0; + *frame = now; + win.draw(batch, &gui.atlas, delta_ticks, Default::default()); + if win.finished(batch.height) { + self.menu.win = None; + } } else if self.menu.options_open { self.menu .options diff --git a/crates/horizon-client/src/game/win.rs b/crates/horizon-client/src/game/win.rs new file mode 100644 index 000000000..a9cf6379a --- /dev/null +++ b/crates/horizon-client/src/game/win.rs @@ -0,0 +1,150 @@ +//! `WinScreen` in the game: the poem and credits after leaving the End for +//! the first time (`EndPortalBlock.entityInside` -> `ServerPlayer.showEndCredits`, +//! or a server's `WIN_GAME` event), and the credits from Credits & +//! Attribution. +use super::{Game, Screen}; +use horizon_client::{ + Result, + hud::{EndPortalFill, HudBatch}, + win_screen::{Key, WinScreen}, +}; +use std::time::Instant; +use winit::{ + event::{ElementState, KeyEvent}, + keyboard::{KeyCode, PhysicalKey}, +}; + +/// What closing the screen does (`WinScreen.onFinished`). +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub(super) enum Finish { + /// `PERFORM_RESPAWN` in single player: the player, out of the End since + /// the credits began, arrives in the Overworld. + Respawn, + /// `PERFORM_RESPAWN` sent to the server. + RemoteRespawn, + /// Back to Credits & Attribution. + Options, + /// Back to the game (`horizon-ctl credits`). + Closed, +} +pub(super) struct Win { + screen: WinScreen, + finish: Finish, + /// The last drawn frame, for the scroll's game-time delta. + frame: Instant, +} +impl Game<'_> { + pub(super) fn open_win_screen(&mut self, poem: bool, finish: Finish) { + let screen = WinScreen::new( + poem, + &self.options.resources, + &self.options.player_name(), + &self.gui.atlas.font, + ); + self.win = Some(Win { + screen, + finish, + frame: Instant::now(), + }); + self.keys.clear(); + self.screen = Screen::Win; + self.capture(false); + } + /// `ServerPlayer.showEndCredits`: the player leaves the End now (no + /// longer in any level until the credits end) and has seen the credits. + pub(super) fn show_end_credits(&mut self) -> Result<()> { + self.level.seen_credits = true; + self.open_win_screen(true, Finish::Respawn); + self.end_portal_travel = true; + let result = self.enter_dimension(super::Dim::Overworld); + self.end_portal_travel = false; + result + } + /// Stop the scroll `scroll` pixels in (`horizon-ctl credits ... SCROLL`). + pub(super) fn hold_win_screen(&mut self, scroll: f32) { + if let Some(win) = self.win.as_mut() { + win.screen.hold(scroll); + } + } + /// `WinScreen.isPauseScreen`: only the credits without the poem pause. + pub(super) fn win_screen_pauses(&self) -> bool { + self.win.as_ref().is_some_and(|w| !w.screen.poem) + } + /// The player waits out of the world while the poem rolls. + pub(super) fn win_screen_holds_arrival(&self) -> bool { + self.win + .as_ref() + .is_some_and(|w| w.finish == Finish::Respawn) + } + pub(super) fn draw_win_screen(&mut self, batch: &mut HudBatch) { + let Some(win) = self.win.as_mut() else { + return; + }; + let now = Instant::now(); + // DeltaTracker.getGameTimeDeltaTicks: the frame's length in ticks. + let delta_ticks = + now.duration_since(win.frame).as_secs_f32() / self.clock.tick_duration().as_secs_f32(); + win.frame = now; + let sprite = |n: &str| { + self.gui + .atlas + .sprites + .get(n) + .map_or([0.0; 4], |r| [r.u0, r.v0, r.u1 - r.u0, r.v1 - r.v0]) + }; + let fill = EndPortalFill { + sprites: [ + sprite("environment/end_sky"), + sprite("entity/end_portal/end_portal"), + ], + game_time: (self.world.game_time % 24000) as f32 / 24000.0, + }; + win.screen.draw(batch, &self.gui.atlas, delta_ticks, fill); + } + /// `WinScreen.keyPressed` / `keyReleased`; Escape closes it (`onClose`). + pub(super) fn win_key(&mut self, event: &KeyEvent) -> Result<()> { + let PhysicalKey::Code(code) = event.physical_key else { + return Ok(()); + }; + let pressed = event.state == ElementState::Pressed; + if code == KeyCode::Escape && pressed { + return self.close_win_screen(); + } + let Some(key) = Key::from_code(code) else { + return Ok(()); + }; + if let Some(win) = self.win.as_mut() { + win.screen.key(key, pressed); + } + Ok(()) + } + /// `WinScreen.tick`: done once everything has rolled past the top. + pub(super) fn tick_win_screen(&mut self) -> Result<()> { + let height = self.gui_size().1; + if self.win.as_ref().is_some_and(|w| w.screen.finished(height)) { + self.close_win_screen()?; + } + Ok(()) + } + /// `WinScreen.respawn` (`onFinished`) and `removed`: the credits music stops. + pub(super) fn close_win_screen(&mut self) -> Result<()> { + let Some(win) = self.win.take() else { + return Ok(()); + }; + let credits = horizon_client::music::Music::credits(); + self.music + .stop_playing_music(&credits, None, &mut self.audio); + match win.finish { + Finish::Options => self.screen = Screen::Options, + Finish::Closed if self.title.is_some() => self.screen = Screen::Playing, + Finish::Respawn | Finish::RemoteRespawn | Finish::Closed => { + if win.finish == Finish::RemoteRespawn { + self.remote_respawn(); + } + self.screen = Screen::Playing; + self.capture(true); + } + } + Ok(()) + } +} diff --git a/crates/horizon-client/src/hud.rs b/crates/horizon-client/src/hud.rs index 0cc99b07b..29faf5a2a 100644 --- a/crates/horizon-client/src/hud.rs +++ b/crates/horizon-client/src/hud.rs @@ -363,6 +363,8 @@ pub struct HudBatch { pub patches: Vec<crate::font::Patch>, /// Vertex ranges with another blend or depth/scissor state, in order. pub blends: Vec<(std::ops::Range<u32>, Blend)>, + /// The textures and time of the `Blend::EndPortal` runs. + pub end_portal: EndPortalFill, } /// How a run of HUD vertices blends and tests depth. #[derive(Clone, Copy, PartialEq, Eq, Debug)] @@ -375,6 +377,19 @@ pub enum Blend { Additive, /// Alpha blending with an isolated depth buffer and a pixel scissor. Depth([u32; 4]), + /// `RenderPipelines.VIGNETTE`: the destination darkened by the texture + /// (`ZERO, ONE_MINUS_SRC_COLOR`). + Vignette, + /// `RenderPipelines.END_PORTAL` as a GUI fill: the End portal's layers + /// projected from the screen (`HudBatch::end_portal` sets the textures). + EndPortal, +} +/// What a `Blend::EndPortal` fill samples: the atlas rects (u0, v0, width, +/// height) of `end_sky.png` and `end_portal.png`, and the `GameTime` uniform. +#[derive(Clone, Copy, Debug, Default, PartialEq)] +pub struct EndPortalFill { + pub sprites: [[f32; 4]; 2], + pub game_time: f32, } pub fn rgba(r: u8, g: u8, b: u8, a: u8) -> u32 { u32::from(a) << 24 | u32::from(b) << 16 | u32::from(g) << 8 | u32::from(r) @@ -398,6 +413,7 @@ impl HudBatch { height: (window[1] as f32 / scale as f32).ceil(), patches: Vec::new(), blends: Vec::new(), + end_portal: EndPortalFill::default(), } } /// Draw the vertices added since `start` with the inverting blend. @@ -695,7 +711,12 @@ impl HudBatch { let mut glyphs = Vec::new(); let mut cursor = x; for (i, (ch, style)) in text.chars().enumerate() { - let g = font.glyph(ch); + let mut g = font.glyph(ch); + // Font.StringRenderOutput.accept: obfuscated characters draw a + // random glyph of the same width each frame. + if style.obfuscated == Some(true) && ch != ' ' { + g = font.random_glyph(g.advance); + } let c = style.color.map_or(color, |rgb| { rgba((rgb >> 16) as u8, (rgb >> 8) as u8, rgb as u8, alpha) }); @@ -789,6 +810,20 @@ impl HudBatch { #[derive(Clone, Copy, bytemuck::Pod, bytemuck::Zeroable)] struct HudUniform { size: [f32; 4], + /// `EndPortalFill`: the two sprites, then the game time in x. + end_portal: [[f32; 4]; 3], +} +impl HudUniform { + fn new(size: [f32; 4], fill: EndPortalFill) -> Self { + Self { + size, + end_portal: [ + fill.sprites[0], + fill.sprites[1], + [fill.game_time, 0.0, 0.0, 0.0], + ], + } + } } pub struct HudRenderer { pub fire_animations: Vec<(Rect, crate::sprites::SpriteAnimation, usize)>, @@ -799,6 +834,8 @@ pub struct HudRenderer { invert_pipeline: wgpu::RenderPipeline, additive_pipeline: wgpu::RenderPipeline, depth_pipeline: wgpu::RenderPipeline, + vignette_pipeline: wgpu::RenderPipeline, + end_portal_pipeline: wgpu::RenderPipeline, group: wgpu::BindGroup, uniform: wgpu::Buffer, buffer: wgpu::Buffer, @@ -821,7 +858,7 @@ impl HudRenderer { }); let uniform = device.create_buffer_init(&wgpu::util::BufferInitDescriptor { label: Some("HUD size"), - contents: bytemuck::bytes_of(&HudUniform { size: [1.0; 4] }), + contents: bytemuck::bytes_of(&HudUniform::new([1.0; 4], EndPortalFill::default())), usage: wgpu::BufferUsages::UNIFORM | wgpu::BufferUsages::COPY_DST, }); let layout = device.create_bind_group_layout(&wgpu::BindGroupLayoutDescriptor { @@ -829,7 +866,7 @@ impl HudRenderer { entries: &[ wgpu::BindGroupLayoutEntry { binding: 0, - visibility: wgpu::ShaderStages::VERTEX, + visibility: wgpu::ShaderStages::VERTEX_FRAGMENT, ty: wgpu::BindingType::Buffer { ty: wgpu::BufferBindingType::Uniform, has_dynamic_offset: false, @@ -957,6 +994,31 @@ impl HudRenderer { "fs_main", false, ); + // RenderPipelines.VIGNETTE: ZERO, ONE_MINUS_SRC_COLOR, ZERO, ONE. + let vignette_pipeline = create( + "HUD vignette", + wgpu::BlendState { + color: wgpu::BlendComponent { + src_factor: wgpu::BlendFactor::Zero, + dst_factor: wgpu::BlendFactor::OneMinusSrc, + operation: wgpu::BlendOperation::Add, + }, + alpha: wgpu::BlendComponent { + src_factor: wgpu::BlendFactor::Zero, + dst_factor: wgpu::BlendFactor::One, + operation: wgpu::BlendOperation::Add, + }, + }, + "fs_main", + false, + ); + // RenderPipelines.END_PORTAL: opaque. + let end_portal_pipeline = create( + "HUD end portal", + wgpu::BlendState::REPLACE, + "fs_end_portal", + false, + ); let capacity = 1 << 16; let buffer = device.create_buffer(&wgpu::BufferDescriptor { label: Some("HUD vertices"), @@ -971,6 +1033,8 @@ impl HudRenderer { invert_pipeline, additive_pipeline, depth_pipeline, + vignette_pipeline, + end_portal_pipeline, group, uniform, buffer, @@ -1064,9 +1128,10 @@ impl HudRenderer { encoder, &self.uniform, 0, - bytemuck::bytes_of(&HudUniform { - size: [size[0] as f32, size[1] as f32, batch.scale, 0.0], - }), + bytemuck::bytes_of(&HudUniform::new( + [size[0] as f32, size[1] as f32, batch.scale, 0.0], + batch.end_portal, + )), ); } /// Draw the batch `prepare` staged. @@ -1135,6 +1200,8 @@ impl HudRenderer { Blend::Invert => &self.invert_pipeline, Blend::Additive => &self.additive_pipeline, Blend::Depth(_) => &self.depth_pipeline, + Blend::Vignette => &self.vignette_pipeline, + Blend::EndPortal => &self.end_portal_pipeline, }); pass.draw(range.clone(), 0..1); } @@ -1147,10 +1214,10 @@ impl HudRenderer { mod tests { use super::*; - #[test] - fn the_fonts_only_atlas_measures_text_like_the_full_one() { - // A synthetic default font: two 8x8 glyphs, 3 and 5 pixels wide. - let root = std::env::temp_dir().join(format!("horizon-fonts-atlas-{}", std::process::id())); + /// A synthetic default font: two 8x8 glyphs, 3 and 5 pixels wide. + fn two_glyph_font(name: &str) -> std::path::PathBuf { + let root = + std::env::temp_dir().join(format!("horizon-fonts-{name}-{}", std::process::id())); let font = root.join("assets/minecraft/font"); let textures = root.join("assets/minecraft/textures/font"); fs::create_dir_all(&font).unwrap(); @@ -1175,6 +1242,11 @@ mod tests { .unwrap() .write_image_data(&pixels) .unwrap(); + root + } + #[test] + fn the_fonts_only_atlas_measures_text_like_the_full_one() { + let root = two_glyph_font("atlas"); let full = HudAtlas::build(&root).unwrap(); let fonts = HudAtlas::fonts(&root).unwrap(); let _ = fs::remove_dir_all(&root); @@ -1183,6 +1255,21 @@ mod tests { assert!(width > 0.0); assert_eq!(fonts.font.width("abba"), width); } + #[test] + fn obfuscated_glyphs_keep_the_width() { + let root = two_glyph_font("obfuscated"); + let fonts = HudAtlas::fonts(&root).unwrap(); + let _ = fs::remove_dir_all(&root); + let (a, b) = (fonts.font.glyph('a').advance, fonts.font.glyph('b').advance); + assert_ne!(a, b); + for _ in 0..20 { + assert_eq!(fonts.font.random_glyph(a).advance, a); + assert_eq!(fonts.font.random_glyph(b).advance, b); + } + // No glyph that wide: FontSet's missing glyph. + let missing = fonts.font.random_glyph(30.0); + assert!(missing.rect.is_none() && missing.right == 5.0); + } #[test] fn effect_icons_are_painted_from_the_mob_effect_directory() { @@ -1340,6 +1427,7 @@ mod tests { height: height as f32, patches: Vec::new(), blends: Vec::new(), + end_portal: EndPortalFill::default(), }; for (image_width, image_height) in [(195, 136), (176, 166), (176, 222)] { assert_eq!( diff --git a/crates/horizon-client/src/hud.wgsl b/crates/horizon-client/src/hud.wgsl index 17d50d51a..ebb6dc2cb 100644 --- a/crates/horizon-client/src/hud.wgsl +++ b/crates/horizon-client/src/hud.wgsl @@ -1,4 +1,9 @@ -struct Hud { size: vec4<f32> } +struct Hud { + size: vec4<f32>, + // Blend::EndPortal: atlas rects (u0, v0, width, height) of end_sky.png and + // end_portal.png, then vanilla's GameTime in x. + end_portal: array<vec4<f32>, 3>, +} @group(0) @binding(0) var<uniform> hud: Hud; @group(0) @binding(1) var atlas: texture_2d<f32>; @group(0) @binding(2) var atlas_sampler: sampler; @@ -6,6 +11,8 @@ struct Out { @builtin(position) clip: vec4<f32>, @location(0) uv: vec2<f32>, @location(1) color: vec4<f32>, + // projection_from_position(gl_Position): the End portal's texProj0. + @location(2) proj: vec4<f32>, } @vertex fn vs_main(@location(0) pos: vec2<f32>, @location(1) uv: vec2<f32>, @location(2) color: vec4<f32>, @location(3) depth: f32) -> Out { let pixels = pos * hud.size.z; @@ -13,6 +20,7 @@ struct Out { out.clip = vec4(pixels.x / hud.size.x * 2.0 - 1.0, 1.0 - pixels.y / hud.size.y * 2.0, depth, 1.0); out.uv = uv; out.color = color; + out.proj = vec4(out.clip.xy * 0.5 + 0.5, out.clip.zw); return out; } @fragment fn fs_main(in: Out) -> @location(0) vec4<f32> { @@ -31,3 +39,44 @@ struct Out { if c.a == 0.0 { discard; } return c; } +// rendertype_end_portal.fsh (entity.wgsl has the same for portal blocks). +const PORTAL_COLORS = array<vec3<f32>, 16>( + vec3(0.022087, 0.098399, 0.110818), + vec3(0.011892, 0.095924, 0.089485), + vec3(0.027636, 0.101689, 0.100326), + vec3(0.046564, 0.109883, 0.114838), + vec3(0.064901, 0.117696, 0.097189), + vec3(0.063761, 0.086895, 0.123646), + vec3(0.084817, 0.111994, 0.166380), + vec3(0.097489, 0.154120, 0.091064), + vec3(0.106152, 0.131144, 0.195191), + vec3(0.097721, 0.110188, 0.187229), + vec3(0.133516, 0.138278, 0.148582), + vec3(0.070006, 0.243332, 0.235792), + vec3(0.196766, 0.142899, 0.214696), + vec3(0.047281, 0.315338, 0.321970), + vec3(0.204675, 0.390010, 0.302066), + vec3(0.080955, 0.314821, 0.661491), +); +fn portal_sample(rect: vec4<f32>, p: vec4<f32>) -> vec3<f32> { + let st = fract(p.xy / p.w); + return textureSampleLevel(atlas, atlas_sampler, rect.xy + st * rect.zw, 0.0).rgb; +} +fn portal_layer(p: vec4<f32>, layer: f32) -> vec4<f32> { + let a = radians((layer * layer * 4321.0 + layer * 9.0) * 2.0); + let c = cos(a); + let s = sin(a); + let k = (4.5 - layer / 4.0) * 2.0; + var v = vec4(k * (c * p.x - s * p.y), k * (s * p.x + c * p.y), p.z, p.w); + v = vec4(v.x + 17.0 / layer * v.w, v.y + (2.0 + layer / 1.5) * (hud.end_portal[2].x * 1.5) * v.w, v.z, v.w); + return vec4(0.5 * v.x + 0.25 * v.w, 0.5 * v.y + 0.25 * v.w, v.z, v.w); +} +// RenderPipelines.END_PORTAL (WinScreen's poem background): end_sky and 15 +// layers of end_portal.png. +@fragment fn fs_end_portal(in: Out) -> @location(0) vec4<f32> { + var c = portal_sample(hud.end_portal[0], in.proj) * PORTAL_COLORS[0]; + for (var i = 0; i < 15; i++) { + c += portal_sample(hud.end_portal[1], portal_layer(in.proj, f32(i + 1))) * PORTAL_COLORS[i]; + } + return vec4(c, 1.0); +} diff --git a/crates/horizon-client/src/lib.rs b/crates/horizon-client/src/lib.rs index 4cf0c5c48..25be4a0c4 100644 --- a/crates/horizon-client/src/lib.rs +++ b/crates/horizon-client/src/lib.rs @@ -186,6 +186,7 @@ pub mod vanillagen; pub mod vault; pub mod weather; pub mod widgets; +pub mod win_screen; pub mod window; pub mod world; pub mod world_spawn; diff --git a/crates/horizon-client/src/options_ui.rs b/crates/horizon-client/src/options_ui.rs index 7d86263df..2290e9632 100644 --- a/crates/horizon-client/src/options_ui.rs +++ b/crates/horizon-client/src/options_ui.rs @@ -871,6 +871,8 @@ pub enum Page { Controller, PadBinds, Extras, + /// CreditsAndAttributionScreen. + Credits, } #[derive(Clone, Debug, PartialEq)] enum Act { @@ -893,6 +895,8 @@ enum Act { /// Pick shader pack `i` of `OptionsUi::shader_packs` (again: off). ToggleShaderPack(usize), OpenShaderPackFolder, + /// Credits & Attribution's Credits button (WinScreen without the poem). + Credits, } enum WKind { Button { @@ -942,6 +946,8 @@ pub enum Event { OpenModFolder, /// Create `shaderpacks/` if needed and open it. OpenShaderPackFolder, + /// Roll the credits (`CreditsAndAttributionScreen.openCreditsScreen`). + Credits, } /// `SliderableValueSet.applyValueImmediately`: these apply 600 ms after /// the last change (`OptionInstanceSliderButton.delayedApplyAt`). @@ -1200,6 +1206,7 @@ impl OptionsUi { Page::Controller => "Controller Settings", Page::PadBinds => "Controller Binds", Page::Extras => "Horizon Extras", + Page::Credits => "credits_and_attribution.screen.title", } } fn scrollbar_x(&self, width: f32) -> f32 { @@ -1580,8 +1587,10 @@ impl OptionsUi { ("options.accessibility", Some(Page::Accessibility)), ("Mods...", Some(Page::Mods)), ("Horizon Extras...", Some(Page::Extras)), + ("options.credits_and_attribution", Some(Page::Credits)), ]; - let gy = (61.0 + 30.0f32).min(h - 33.0 - 120.0); + let rows = entries.len().div_ceil(2) as f32; + let gy = (61.0 + 30.0f32).min(h - 33.0 - rows * 24.0); for (i, (key, page)) in entries.iter().enumerate() { let x = cx - 158.0 + 4.0 + (i % 2) as f32 * 158.0; let y = gy + (i / 2) as f32 * 24.0; @@ -1592,6 +1601,46 @@ impl OptionsUi { top = 0.0; bottom = 0.0; } + Page::Credits => { + // CreditsAndAttributionScreen: the title header, three 210-wide + // buttons 8 apart (HeaderAndFooterLayout: 30 below the header + // unless the footer is closer), Done. + out.push(Widget { + x: 0.0, + y: 12.0, + w, + h: 9.0, + kind: WKind::Text { + text: tr(Self::title(page)), + color: u32::MAX, + centered: true, + }, + list: false, + }); + let y = (33.0 + 30.0f32).min(h - 33.0 - 76.0); + let x = cx - 105.0; + out.push(button( + x, + y, + 210.0, + tr("credits_and_attribution.button.credits"), + Act::Credits, + )); + // ConfirmLinkScreen to minecraft.net: Horizon opens no links. + for (i, key) in [ + "credits_and_attribution.button.attribution", + "credits_and_attribution.button.licenses", + ] + .into_iter() + .enumerate() + { + let y = y + 28.0 * (i + 1) as f32; + out.push(inactive(button(x, y, 210.0, tr(key), Act::None))); + } + out.push(done(h - 27.0)); + top = 0.0; + bottom = 0.0; + } Page::KeyBinds => { top = 38.0; out.push(Widget { @@ -2487,6 +2536,7 @@ impl OptionsUi { events.push(Event::Changed); } Act::OpenShaderPackFolder => events.push(Event::OpenShaderPackFolder), + Act::Credits => events.push(Event::Credits), Act::None => {} } } diff --git a/crates/horizon-client/src/save.rs b/crates/horizon-client/src/save.rs index 2e1eb8455..0428670f4 100644 --- a/crates/horizon-client/src/save.rs +++ b/crates/horizon-client/src/save.rs @@ -2209,6 +2209,8 @@ pub struct Level { pub inventory_components: HashMap<u8, Box<crate::item_data::StackData>>, /// Player.XpSeed: the enchanting table seed. pub xp_seed: i32, + /// ServerPlayer.seenCredits: the end poem has been shown. + pub seen_credits: bool, /// Player.active_effects: (id, duration, amplifier, ambient, show_icon). pub active_effects: Vec<(String, i32, i32, bool, bool)>, /// Player.EnderItems: the ender chest inventory (27 slots). @@ -2400,6 +2402,7 @@ impl Level { self.selected_slot = n("SelectedItemSlot").unwrap_or(0) as i32; self.fall_distance = f("fall_distance").unwrap_or(0.0); self.on_ground = n("OnGround").unwrap_or(0) != 0; + self.seen_credits = n("seenCredits").unwrap_or(0) != 0; if let Some(mode) = n("playerGameType") { self.creative = mode == 1; self.game_mode = mode as i32; @@ -2621,6 +2624,7 @@ impl Level { if let Some(pos) = self.position { entries.push(("Pos", doubles(&pos))); } + entries.push(("seenCredits", Tag::Byte(i8::from(self.seen_credits)))); // A respawn point other than the world spawn: an anchor elsewhere, or a bed. if let Some((dimension, block, yaw, forced)) = &self.respawn_elsewhere { let mut respawn = vec![ diff --git a/crates/horizon-client/src/win_screen.rs b/crates/horizon-client/src/win_screen.rs new file mode 100644 index 000000000..8d2a1c145 --- /dev/null +++ b/crates/horizon-client/src/win_screen.rs @@ -0,0 +1,452 @@ +//! `WinScreen`: the end poem, the credits and the post-credits text rolling up +//! under the logo, after the player leaves the End for the first time (with +//! the poem) or from Credits & Attribution (the credits alone). The texts come +//! from the resource root, so resource packs can replace them. +use crate::{ + font::Font, + hud::{Blend, EndPortalFill, HudAtlas, HudBatch}, + text::{self, Style, Text}, +}; +use horizon_core::random::{LegacyRandom, RandomSource}; +use std::{collections::HashSet, path::Path}; + +/// `WinScreen.OBFUSCATE_TOKEN`: `§f§k§a§b` marks where the poem hides a name. +const OBFUSCATE_TOKEN: &str = "\u{a7}f\u{a7}k\u{a7}a\u{a7}b"; +/// `WinScreen.NAME_PREFIX`. +const NAME_PREFIX: &str = " "; +/// `WinScreen.SECTION_HEADING`. +const SECTION_HEADING: &str = "============"; +/// A key the screen reacts to (`keyPressed` / `keyReleased`). +#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)] +pub enum Key { + /// `KeyEvent.isUp`: the up arrow scrolls back. + Up, + /// Space speeds the scroll up. + Space, + /// Each held Control key speeds it up more. + LeftControl, + RightControl, +} +impl Key { + pub fn from_code(code: winit::keyboard::KeyCode) -> Option<Self> { + use winit::keyboard::KeyCode; + match code { + KeyCode::ArrowUp => Some(Self::Up), + KeyCode::Space => Some(Self::Space), + KeyCode::ControlLeft => Some(Self::LeftControl), + KeyCode::ControlRight => Some(Self::RightControl), + _ => None, + } + } +} +pub struct WinScreen { + pub poem: bool, + lines: Vec<Text>, + centered: HashSet<usize>, + total_scroll_length: i32, + scroll: f32, + speedup_active: bool, + speedup_modifiers: HashSet<Key>, + unmodified_scroll_speed: f32, + scroll_speed: f32, + direction: i32, +} +impl WinScreen { + /// `WinScreen.<init>` and `init`: the poem (`texts/end.txt`) when `poem`, + /// the credits (`texts/credits.json`), then `texts/postcredits.txt`. + pub fn new(poem: bool, root: &Path, player: &str, font: &Font) -> Self { + let speed = if poem { 0.5 } else { 0.75 }; + let mut screen = Self { + poem, + lines: Vec::new(), + centered: HashSet::new(), + total_scroll_length: 0, + scroll: 0.0, + speedup_active: false, + speedup_modifiers: HashSet::new(), + unmodified_scroll_speed: speed, + scroll_speed: speed, + direction: 1, + }; + let texts = root.join("assets/minecraft/texts"); + let read = |name: &str| match std::fs::read_to_string(texts.join(name)) { + Ok(s) => Some(s), + Err(e) => { + log::error!("Couldn't load credits from file minecraft:texts/{name}: {e}"); + None + } + }; + if poem && let Some(s) = read("end.txt") { + screen.add_poem_file(&s, player, font); + } + if let Some(s) = read("credits.json") { + match serde_json::from_str(&s) { + Ok(json) => screen.add_credits_file(&json), + Err(e) => { + log::error!("Couldn't load credits from file minecraft:texts/credits.json: {e}") + } + } + } + if poem && let Some(s) = read("postcredits.txt") { + screen.add_poem_file(&s, player, font); + } + screen.total_scroll_length = screen.lines.len() as i32 * 12; + screen + } + /// `addPoemFile`: each line with the player's name in, its obfuscated + /// spans turned into 3 to 6 scrambled characters, wrapped at 256 pixels + /// and followed by an empty line; 8 more empty lines at the end. + fn add_poem_file(&mut self, file: &str, player: &str, font: &Font) { + let mut random = LegacyRandom::new(8124371); + // BufferedReader.readLine: \n, \r or \r\n end a line; no empty last line. + let mut lines: Vec<&str> = file + .split('\n') + .map(|l| l.strip_suffix('\r').unwrap_or(l)) + .collect(); + if file.ends_with('\n') { + lines.pop(); + } + for line in lines.iter().flat_map(|l| l.split('\r')) { + let mut line = line.replace("PLAYERNAME", player); + while let Some(pos) = line.find(OBFUSCATE_TOKEN) { + let n = random.next_int_bound(4).unwrap_or(0) as usize + 3; + line = format!( + "{}\u{a7}f\u{a7}k{}{}", + &line[..pos], + &"XXXXXXXX"[..n], + &line[pos + OBFUSCATE_TOKEN.len()..] + ); + } + let text = Text::legacy(&line); + self.lines + .extend(font.split_lines(&text, 256.0).into_iter().map(|(t, _)| t)); + self.add_empty_line(); + } + for _ in 0..8 { + self.add_empty_line(); + } + } + /// `addCreditsFile`: each section's heading, then each discipline's name + /// and its titles with the names under them. + fn add_credits_file(&mut self, json: &serde_json::Value) { + let colored = |s: &str, color: u32| Text::styled(s, Style::color(color)); + let heading = || colored(SECTION_HEADING, text::WHITE); + for section in json.as_array().into_iter().flatten() { + let name = section["section"].as_str().unwrap_or_default(); + self.add_credits_line(heading(), true); + self.add_credits_line(colored(name, text::YELLOW), true); + self.add_credits_line(heading(), true); + self.add_empty_line(); + self.add_empty_line(); + for discipline in section["disciplines"].as_array().into_iter().flatten() { + let name = discipline["discipline"].as_str().unwrap_or_default(); + if !name.is_empty() { + self.add_credits_line(colored(name, text::YELLOW), true); + self.add_empty_line(); + self.add_empty_line(); + } + for title in discipline["titles"].as_array().into_iter().flatten() { + let name = title["title"].as_str().unwrap_or_default(); + self.add_credits_line(colored(name, text::GRAY), false); + for name in title["names"].as_array().into_iter().flatten() { + let line = format!("{NAME_PREFIX}{}", name.as_str().unwrap_or_default()); + self.add_credits_line(colored(&line, text::WHITE), false); + } + self.add_empty_line(); + self.add_empty_line(); + } + } + } + } + fn add_empty_line(&mut self) { + self.lines.push(Text::empty()); + } + fn add_credits_line(&mut self, line: Text, centered: bool) { + if centered { + self.centered.insert(self.lines.len()); + } + self.lines.push(line); + } + /// The lines in order and whether each is centred. + pub fn lines(&self) -> impl Iterator<Item = (&Text, bool)> { + self.lines + .iter() + .enumerate() + .map(|(i, l)| (l, self.centered.contains(&i))) + } + fn calculate_scroll_speed(&self) -> f32 { + let speed = if self.speedup_active { + self.unmodified_scroll_speed * (5.0 + self.speedup_modifiers.len() as f32 * 15.0) + } else { + self.unmodified_scroll_speed + }; + speed * self.direction as f32 + } + /// `keyPressed` / `keyReleased` (Escape closes the screen: `onClose`). + pub fn key(&mut self, key: Key, pressed: bool) { + match (key, pressed) { + (Key::Up, _) => self.direction = if pressed { -1 } else { 1 }, + (Key::Space, _) => self.speedup_active = pressed, + (_, true) => { + self.speedup_modifiers.insert(key); + } + (_, false) => { + self.speedup_modifiers.remove(&key); + } + } + self.scroll_speed = self.calculate_scroll_speed(); + } + /// `tick`: once the text has rolled past the top, the screen is done + /// (`respawn`, or back to the screen that opened it). + pub fn finished(&self, height: f32) -> bool { + let height = height as i32; + self.scroll > (self.total_scroll_length + height + height + 24) as f32 + } + pub fn scroll(&self) -> f32 { + self.scroll + } + /// Stay `scroll` pixels in (until a key changes the speed), for + /// screenshots. + pub fn hold(&mut self, scroll: f32) { + self.scroll = scroll; + self.scroll_speed = 0.0; + } + /// `extractRenderState` after a frame of `delta_ticks` game ticks: + /// `extractBackground`, the vignette, then the logo and the lines + /// scrolled up. The poem's End portal background samples `end_portal`; + /// the credits draw the scrolling menu background (over the blurred + /// panorama on the title screen). + pub fn draw( + &mut self, + batch: &mut HudBatch, + atlas: &HudAtlas, + delta_ticks: f32, + end_portal: EndPortalFill, + ) { + let (w, h) = (batch.width, batch.height); + if self.poem { + let start = batch.vertices.len(); + batch.fill(atlas, 0.0, 0.0, w, h, u32::MAX); + batch.blend_since(start, Blend::EndPortal); + batch.end_portal = end_portal; + } else { + self.menu_background(batch, atlas, w, h); + } + // extractVignette: credits_vignette.png stretched over the screen. + if let Some(r) = atlas.sprites.get("misc/credits_vignette").copied() { + let start = batch.vertices.len(); + batch.rect_uv(0.0, 0.0, w, h, r, u32::MAX); + batch.blend_since(start, Blend::Vignette); + } + self.scroll = (self.scroll + delta_ticks * self.scroll_speed).max(0.0); + let logo_x = (w / 2.0).floor() - 128.0; + let logo_y = h + 50.0; + // Everything below is drawn translated by `y_offs`. + let y_offs = -self.scroll; + // LogoRenderer(false) at full alpha. + let edition_x = (w / 2.0).floor() - 64.0; + batch.sprite_region( + atlas, + "gui/title/minecraft", + [logo_x, logo_y + y_offs, 256.0, 44.0], + 256.0, + 64.0, + ); + batch.sprite_region( + atlas, + crate::title_edition::SPRITE, + [edition_x, logo_y + 44.0 - 7.0 + y_offs, 128.0, 14.0], + 128.0, + 16.0, + ); + let mut y_pos = logo_y + 100.0; + let last = self.lines.len().saturating_sub(1); + for (i, line) in self.lines.iter().enumerate() { + let mut shift = y_offs; + if i == last { + // The last line stops in the middle of the screen. + let diff = y_pos + y_offs - ((h as i32 / 2) as f32 - 6.0); + if diff < 0.0 { + shift -= diff; + } + } + if y_pos + y_offs + 12.0 + 8.0 > 0.0 && y_pos + y_offs < h { + let x = if self.centered.contains(&i) { + // GuiGraphicsExtractor.centeredText: x - width / 2. + logo_x + 128.0 - (atlas.font.width_text(line) as i32 / 2) as f32 + } else { + logo_x + }; + batch.text_styled(atlas, line, x, y_pos + shift, u32::MAX, true); + } + y_pos += 12.0; + } + } + /// `extractMenuBackground`: `menu_background.png` tiled at 32 pixels, + /// scrolled by half the text's scroll. + fn menu_background(&self, batch: &mut HudBatch, atlas: &HudAtlas, w: f32, h: f32) { + let v = (self.scroll * 0.5).rem_euclid(32.0); + let start = batch.vertices.len(); + crate::ui::tiled( + batch, + atlas, + "gui/menu_background", + 0.0, + -v, + w, + h + 32.0, + 32.0, + u32::MAX, + ); + batch.clip_since(start, 0.0, 0.0, w, h); + } +} + +#[cfg(test)] +mod tests { + use super::*; + + /// A resource root with only the credits texts: every glyph is the + /// missing one, 6 pixels wide. + fn screen(poem: bool, end: &str, credits: &str, post: &str) -> WinScreen { + let root = std::env::temp_dir().join(format!( + "horizon-win-screen-{}-{poem}-{}", + std::process::id(), + end.len() + )); + let texts = root.join("assets/minecraft/texts"); + std::fs::create_dir_all(&texts).unwrap(); + std::fs::write(texts.join("end.txt"), end).unwrap(); + std::fs::write(texts.join("credits.json"), credits).unwrap(); + std::fs::write(texts.join("postcredits.txt"), post).unwrap(); + let atlas = HudAtlas::fonts(&root).unwrap(); + let screen = WinScreen::new(poem, &root, "Steve", &atlas.font); + let _ = std::fs::remove_dir_all(&root); + screen + } + const CREDITS: &str = r#"[{"section":"Studio","disciplines":[ + {"discipline":"","titles":[{"title":"Head","names":["Ada","Bo"]}]}, + {"discipline":"Art","titles":[{"title":"Artist","names":[]}]}]}]"#; + + #[test] + fn the_poem_names_the_player_and_scrambles_its_hidden_names() { + let s = screen( + true, + "\u{a7}3Hello PLAYERNAME.\r\n\n\u{a7}2\u{a7}f\u{a7}k\u{a7}a\u{a7}bkey\n", + "[]", + "End.", + ); + let lines: Vec<(String, bool)> = s.lines().map(|(t, c)| (t.plain(), c)).collect(); + // Each line then an empty one; the empty line adds no text line; 8 + // empty lines after each file. + let mut want = vec!["Hello Steve.", ""]; + want.push(""); + // LegacyRandom(8124371).nextInt(4) + 3 scrambled characters. + let n = LegacyRandom::new(8124371).next_int_bound(4).unwrap() as usize + 3; + let hidden = format!("{}key", &"XXXXXXXX"[..n]); + want.extend([hidden.as_str(), ""]); + want.extend([""; 8]); + want.extend(["End.", ""]); + want.extend([""; 8]); + assert_eq!( + lines, + want.iter() + .map(|l| (l.to_string(), false)) + .collect::<Vec<_>>() + ); + let hidden_line = s.lines().nth(3).unwrap().0; + let styles: Vec<_> = hidden_line.chars().map(|(_, s)| s.obfuscated).collect(); + assert!(styles[..n].iter().all(|o| *o == Some(true))); + assert_eq!(s.total_scroll_length, lines.len() as i32 * 12); + } + + #[test] + fn long_poem_lines_wrap_at_256_pixels() { + // 6-pixel glyphs: 42 fit a line, and the space at each break goes. + let line = vec!["a"; 50].join(" "); + let s = screen(true, &line, "[]", ""); + let lines: Vec<String> = s.lines().take(4).map(|(t, _)| t.plain()).collect(); + assert_eq!( + lines.iter().map(|l| l.chars().count()).collect::<Vec<_>>(), + [41, 41, 15, 0] + ); + assert!(lines.iter().all(|l| !l.starts_with(' '))); + } + #[test] + fn credits_centre_the_headings_and_list_the_names() { + let s = screen(false, "ignored", CREDITS, "ignored"); + let lines: Vec<(String, bool)> = s.lines().map(|(t, c)| (t.plain(), c)).collect(); + let l = |s: &str, c| (s.to_string(), c); + let names = |n: &str| l(&format!("{NAME_PREFIX}{n}"), false); + assert_eq!( + lines, + vec![ + l(SECTION_HEADING, true), + l("Studio", true), + l(SECTION_HEADING, true), + l("", false), + l("", false), + l("Head", false), + names("Ada"), + names("Bo"), + l("", false), + l("", false), + l("Art", true), + l("", false), + l("", false), + l("Artist", false), + l("", false), + l("", false), + ] + ); + let color = |i: usize| s.lines().nth(i).unwrap().0.chars().next().unwrap().1.color; + assert_eq!( + [color(0), color(1), color(5), color(6), color(10)], + [ + Some(text::WHITE), + Some(text::YELLOW), + Some(text::GRAY), + Some(text::WHITE), + Some(text::YELLOW) + ] + ); + } + + #[test] + fn keys_set_the_scroll_speed_and_direction() { + let mut s = screen(false, "", CREDITS, ""); + assert_eq!(s.scroll_speed, 0.75); + s.key(Key::Space, true); + assert_eq!(s.scroll_speed, 0.75 * 5.0); + s.key(Key::LeftControl, true); + s.key(Key::RightControl, true); + assert_eq!(s.scroll_speed, 0.75 * 35.0); + s.key(Key::Up, true); + assert_eq!(s.scroll_speed, -0.75 * 35.0); + s.key(Key::Space, false); + assert_eq!(s.scroll_speed, -0.75); + s.key(Key::Up, false); + s.key(Key::LeftControl, false); + assert_eq!(s.scroll_speed, 0.75); + // The poem rolls at 0.5 pixels a tick. + assert_eq!(screen(true, "", CREDITS, "").scroll_speed, 0.5); + } + + #[test] + fn the_screen_ends_once_everything_rolled_past() { + let mut s = screen(false, "", CREDITS, ""); + let atlas = HudAtlas::fonts(Path::new("/nonexistent")).unwrap(); + let mut batch = HudBatch::new([640, 480]); + let h = batch.height; + let end = (s.total_scroll_length as f32 + 2.0 * h + 24.0) / 0.75; + s.draw(&mut batch, &atlas, end - 1.0, EndPortalFill::default()); + assert!(!s.finished(h)); + // Scrolling back never goes above the start. + s.key(Key::Up, true); + s.draw(&mut batch, &atlas, end * 2.0, EndPortalFill::default()); + assert_eq!(s.scroll(), 0.0); + s.key(Key::Up, false); + s.draw(&mut batch, &atlas, end + 1.0, EndPortalFill::default()); + assert!(s.finished(h)); + } +} From 7e410d93b3f38dd92b349c1608fb5eb5ad85479a Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 14:27:47 +0200 Subject: [PATCH 011/126] Fonts: TrueType providers and the font picked by text components Every font definition of the resources (and packs) is now loaded, not just font/default.json, and a text component's "font" field picks one: "minecraft:alt" draws the enchanting table's Galactic alphabet, "minecraft:illageralt" the illager runes, a pack's own font its glyphs, and a font that doesn't exist draws every character as the missing glyph (FontManager.getFontSetRaw). - font.rs: one FontSet per font id with its providers in order (space, bitmap, unihex, ttf) and their filters ("uniform", "jp"). Bitmap sheets outside the atlas (another namespace or folder) are copied into the glyph region when first drawn. - TrueTypeGlyphProvider: "ttf" providers (file under font/, size, oversample, shift, skip; CFF fonts refused) rasterized with ab_glyph into the glyph region as rrrr coverage (text_intensity), metrics as GlyphBitmap (bearings over the oversampling, whole-pixel advances). - text::Style gains the font id; it is parsed from JSON and SNBT components, pack descriptions and scoreboard number formats, inherited by children and written back. - Obfuscated text picks its random glyph in the style's font. Fixes #336 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/component.rs | 23 + crates/horizon-client/src/font.rs | 1053 +++++++++++++++++------ crates/horizon-client/src/hud.rs | 11 +- crates/horizon-client/src/packs.rs | 1 + crates/horizon-client/src/scoreboard.rs | 1 + crates/horizon-client/src/text.rs | 16 +- 6 files changed, 835 insertions(+), 270 deletions(-) diff --git a/crates/horizon-client/src/component.rs b/crates/horizon-client/src/component.rs index 0e04eab5e..68460054b 100644 --- a/crates/horizon-client/src/component.rs +++ b/crates/horizon-client/src/component.rs @@ -167,6 +167,7 @@ fn object_style(o: &serde_json::Map<String, Value>) -> Style { style.underlined = flag("underlined"); style.strikethrough = flag("strikethrough"); style.obfuscated = flag("obfuscated"); + style.font = o.get("font").and_then(crate::text::font_id); style } /// `ComponentSerialization.CODEC` decoding into text. `selector` components @@ -266,4 +267,26 @@ mod tests { let (v, _) = parse_snbt("[\"a\",{\"text\":\"b\"}]").unwrap(); assert_eq!(to_text(&v, &mut |_| Text::empty()).plain(), "ab"); } + + #[test] + fn the_font_is_inherited_and_kept() { + let (v, _) = + parse_snbt(r#"{text:"a",font:"alt",extra:["b",{text:"c",font:"minecraft:uniform"}]}"#) + .unwrap(); + let t = to_text(&v, &mut |_| Text::empty()); + let fonts: Vec<_> = t.chars().map(|(_, s)| s.font.clone()).collect(); + let (alt, uniform) = ( + Some("minecraft:alt".into()), + Some("minecraft:uniform".into()), + ); + assert_eq!(fonts, [alt.clone(), alt, uniform]); + // Back to JSON with the field, which a re-read keeps. + let again = to_text(&t.component(), &mut |_| Text::empty()); + let kept: Vec<_> = again.chars().map(|(_, s)| s.font.clone()).collect(); + assert_eq!(kept, fonts); + // Not an identifier: no font. + let (v, _) = parse_snbt(r#"{text:"a",font:"Bad Font"}"#).unwrap(); + let t = to_text(&v, &mut |_| Text::empty()); + assert_eq!(t.spans[0].style.font, None); + } } diff --git a/crates/horizon-client/src/font.rs b/crates/horizon-client/src/font.rs index 3039fdb40..c5e5760f3 100644 --- a/crates/horizon-client/src/font.rs +++ b/crates/horizon-client/src/font.rs @@ -1,19 +1,27 @@ -//! The default font (FontSet over `font/default.json`): space and bitmap -//! providers from the shared atlas, the unihex (GNU Unifont) fallback whose -//! glyphs are rasterized on demand into a reserved atlas region, vanilla -//! glyph metrics (ascent, oversampling, advances, bold/shadow offsets), -//! styled drawing and StringSplitter-style line wrapping. +//! Fonts (FontManager / FontSet): `font/default.json` and every other font a +//! text component names (`minecraft:alt`, `minecraft:uniform`, a pack's own), +//! each a list of providers tried in order: `space`, `bitmap` (sheets in the +//! shared atlas, or rasterized on demand when a pack's sheet is not in it), +//! `unihex` (GNU Unifont) and `ttf` (TrueTypeGlyphProvider, rasterized with +//! ab_glyph). Glyphs drawn at run time go into a reserved atlas region. +//! Vanilla glyph metrics (ascent, oversampling, advances, bold/shadow +//! offsets), styled drawing and StringSplitter-style line wrapping. use crate::{ hud::Rect, text::{Style, Text}, zip::Zip, }; +use ab_glyph::{Font as _, ScaleFont as _}; use std::{ cell::RefCell, collections::HashMap, path::{Path, PathBuf}, + sync::Arc, }; +/// `FontDescription.DEFAULT`. +pub const DEFAULT: &str = "minecraft:default"; + /// A glyph ready to draw: atlas UVs and its box relative to the pen /// position (GlyphBitmap left/top/right/bottom), in GUI pixels. #[derive(Clone, Copy, Debug)] @@ -24,7 +32,7 @@ pub struct Glyph { pub right: f32, pub bottom: f32, pub advance: f32, - /// Shadow and bold offset (1 for bitmap glyphs, 0.5 for unihex). + /// Shadow and bold offset (1 for bitmap and TrueType glyphs, 0.5 for unihex). pub offset: f32, } /// Pixels to copy into the shared atlas before the next HUD draw. @@ -43,23 +51,77 @@ struct HexGlyph { left: u32, right: u32, } -#[derive(Default)] -struct HexProvider { - glyphs: HashMap<u32, HexGlyph>, +/// A provider's `filter` (`FontOption.Filter`): the options it needs. +#[derive(Clone, Copy, Default)] +struct Filter { + uniform: Option<bool>, + jp: Option<bool>, +} +impl Filter { + fn of(provider: &serde_json::Value) -> Self { + let f = &provider["filter"]; + Self { + uniform: f["uniform"].as_bool(), + jp: f["jp"].as_bool(), + } + } + fn passes(self, uniform: bool, japanese: bool) -> bool { + self.uniform.is_none_or(|v| v == uniform) && self.jp.is_none_or(|v| v == japanese) + } +} +/// A bitmap glyph whose sheet is not in the atlas: the cell to copy. +struct SheetCell { + sheet: Arc<(u32, Vec<u8>)>, + x: u32, + y: u32, + w: u32, + h: u32, + glyph: Glyph, +} +enum BitmapGlyph { + Atlas(Glyph), + Sheet(SheetCell), +} +/// `TrueTypeGlyphProvider`. +struct TrueType { + font: ab_glyph::FontVec, + ids: HashMap<char, ab_glyph::GlyphId>, + /// FT_Set_Pixel_Sizes: `size * oversample` pixels to the em. + scale: ab_glyph::PxScale, + oversample: f32, + /// FT_Set_Transform's delta, in oversampled pixels (y down). + shift: (f32, f32), +} +enum Provider { + Space(HashMap<char, f32>), + Bitmap(Filter, HashMap<char, BitmapGlyph>), + /// The definition, and its glyphs once read. + Unihex(Filter, serde_json::Value, Option<HashMap<u32, HexGlyph>>), + TrueType(Filter, Box<TrueType>), +} +/// One font (`FontSet`): its providers and the glyphs resolved so far. +struct FontSet { + providers: Vec<Provider>, + glyphs: HashMap<char, Glyph>, + /// `glyphsByWidth` for obfuscated text (built on first use). + by_width: Option<HashMap<u32, Vec<char>>>, +} +/// The atlas region glyphs are rasterized into, filled in rows. +struct Region { + cursor: (u32, u32), + row: u32, + pending: Vec<Patch>, } struct Cache { - glyphs: HashMap<char, Glyph>, - cursor: (u32, u32), - pending: Vec<Patch>, - hex: Option<Vec<HexProvider>>, - /// `FontSet.glyphsByWidth` for obfuscated text (built on first use). - by_width: Option<HashMap<u32, Vec<char>>>, + /// Every font by id, the default one first (the common lookup). + sets: Vec<(String, FontSet)>, + region: Region, /// `Font.random`: picks obfuscated glyphs. random: horizon_core::random::LegacyRandom, } pub struct Font { - bitmap: HashMap<char, Glyph>, - space: HashMap<char, f32>, + /// The atlas rects of the sheets under `textures/font`. + sheets: HashMap<String, Rect>, missing: Glyph, white: Rect, root: PathBuf, @@ -67,9 +129,9 @@ pub struct Font { atlas: (u32, u32), region: (u32, u32), cache: RefCell<Cache>, - /// "Force Unicode Font": skip the bitmap providers (font/uniform.json). + /// "Force Unicode Font": the `uniform` filter option. pub uniform: bool, - /// "Japanese Glyph Variants": enable providers filtered on `jp`. + /// "Japanese Glyph Variants": the `jp` filter option. pub japanese: bool, } fn parse_hex_digit(b: u8) -> Option<u32> { @@ -178,9 +240,324 @@ fn glyph_rect(x: u32, y: u32, w: u32, h: u32, atlas: (u32, u32)) -> Rect { h, } } +/// The unscaled pixel width of a bitmap cell (`BitmapProvider.getActualGlyphWidth`). +fn used_width(pixels: &[u8], stride: u32, (cx, cy, cw, ch): (u32, u32, u32, u32)) -> u32 { + (0..cw) + .rev() + .find(|&x| { + (0..ch).any(|y| { + pixels + .get((((cy + y) * stride + cx + x) * 4 + 3) as usize) + .is_some_and(|a| *a != 0) + }) + }) + .map_or(0, |x| x + 1) +} +/// `BitmapProvider.Definition.load`: each character's glyph, from the atlas +/// when the sheet is in it (`pixels` its RGBA), else from the sheet's own +/// pixels, copied into the atlas when first drawn. +fn load_bitmap( + root: &Path, + p: &serde_json::Value, + sheets: &HashMap<String, Rect>, + pixels: &[u8], + atlas: (u32, u32), +) -> HashMap<char, BitmapGlyph> { + let mut out = HashMap::new(); + let file = p["file"].as_str().unwrap_or(""); + let (ns, name) = file.split_once(':').unwrap_or(("minecraft", file)); + let in_atlas = (ns == "minecraft") + .then(|| sheets.get(name.trim_end_matches(".png")).copied()) + .flatten(); + // The sheet: its size, and its pixels when they are not in the atlas. + let (sw, sh, sheet) = match in_atlas { + Some(rect) => (rect.w, rect.h, None), + None => match crate::hud::decode(&root.join(resource_path(file, "textures", ""))) { + Ok((w, h, rgba)) => (w, h, Some(Arc::new((w, rgba)))), + Err(_) => { + log::warn!("font sheet {file} could not be read"); + return out; + } + }, + }; + let rows: Vec<Vec<char>> = p["chars"] + .as_array() + .into_iter() + .flatten() + .filter_map(|r| r.as_str().map(|s| s.chars().collect())) + .collect(); + if rows.is_empty() || rows[0].is_empty() { + return out; + } + let cell_w = sw / rows[0].len() as u32; + let cell_h = sh / rows.len() as u32; + let height = p["height"].as_f64().unwrap_or(8.0) as f32; + let ascent = p["ascent"].as_f64().unwrap_or(7.0) as f32; + let scale = height / cell_h as f32; + let origin = in_atlas.map_or((0, 0), |rect| { + ( + (rect.u0 * atlas.0 as f32).round() as u32, + (rect.v0 * atlas.1 as f32).round() as u32, + ) + }); + for (r, row) in rows.iter().enumerate() { + for (c, ch) in row.iter().enumerate() { + if *ch == '\0' || out.contains_key(ch) { + continue; + } + let (x, y) = (c as u32 * cell_w, r as u32 * cell_h); + let used = match &sheet { + Some(s) => used_width(&s.1, s.0, (x, y, cell_w, cell_h)), + None => used_width( + pixels, + atlas.0, + (origin.0 + x, origin.1 + y, cell_w, cell_h), + ), + }; + let top = 7.0 - ascent; + let glyph = Glyph { + rect: None, + left: 0.0, + top, + right: cell_w as f32 * scale, + bottom: top + cell_h as f32 * scale, + advance: (0.5 + used as f32 * scale).floor() + 1.0, + offset: 1.0, + }; + let glyph = match &sheet { + None => BitmapGlyph::Atlas(Glyph { + rect: Some(glyph_rect( + origin.0 + x, + origin.1 + y, + cell_w, + cell_h, + atlas, + )), + ..glyph + }), + Some(s) => BitmapGlyph::Sheet(SheetCell { + sheet: s.clone(), + x, + y, + w: cell_w, + h: cell_h, + glyph, + }), + }; + out.insert(*ch, glyph); + } + } + out +} +/// `TrueTypeGlyphProviderDefinition.load`: a TrueType file (not CFF) under +/// `font/`, its Unicode characters but the `skip` ones. +fn load_true_type(root: &Path, p: &serde_json::Value) -> Option<TrueType> { + let file = p["file"].as_str()?; + let data = std::fs::read(root.join(resource_path(file, "font", ""))) + .map_err(|e| log::warn!("font file {file}: {e}")) + .ok()?; + // FT_Get_Font_Format must say TrueType: CFF outlines ("OTTO") are refused. + if data.starts_with(b"OTTO") { + log::warn!("font file {file} is not in TTF format"); + return None; + } + let font = ab_glyph::FontVec::try_from_vec(data) + .map_err(|e| log::warn!("font file {file}: {e}")) + .ok()?; + let size = p["size"].as_f64().unwrap_or(11.0) as f32; + let oversample = p["oversample"].as_f64().unwrap_or(1.0) as f32; + let shift = p["shift"].as_array().map_or((0.0, 0.0), |s| { + let f = |i: usize| s.get(i).and_then(|v| v.as_f64()).unwrap_or(0.0) as f32; + (f(0), f(1)) + }); + let skip: Vec<char> = match &p["skip"] { + serde_json::Value::String(s) => s.chars().collect(), + serde_json::Value::Array(a) => a + .iter() + .filter_map(|v| v.as_str()) + .flat_map(str::chars) + .collect(), + _ => Vec::new(), + }; + let ids = font + .codepoint_ids() + .filter(|(id, c)| id.0 != 0 && !skip.contains(c)) + .map(|(id, c)| (c, id)) + .collect(); + let pixels_per_em = (size * oversample).round(); + // ab_glyph scales by the font's height; FreeType by its em. + let units = font.units_per_em().unwrap_or(1000.0); + let scale = ab_glyph::PxScale::from(pixels_per_em * font.height_unscaled() / units); + Some(TrueType { + font, + ids, + scale, + oversample, + shift: (shift.0 * oversample, shift.1 * oversample), + }) +} +impl TrueType { + /// The advance in GUI pixels: hinted FreeType advances are whole + /// oversampled pixels. + fn advance(&self, id: ab_glyph::GlyphId) -> f32 { + self.font.as_scaled(self.scale).h_advance(id).round() / self.oversample + } + /// `loadGlyph` and its bitmap: the grey coverage as `rrrr` texels + /// (`text_intensity`), below 0.1 cut (its discard). + fn glyph(&self, id: ab_glyph::GlyphId) -> (Glyph, Option<(u32, u32, Vec<u8>)>) { + let advance = self.advance(id); + let glyph = + id.with_scale_and_position(self.scale, ab_glyph::point(self.shift.0, self.shift.1)); + let empty = Glyph { + rect: None, + left: 0.0, + top: 0.0, + right: 0.0, + bottom: 0.0, + advance, + offset: 1.0, + }; + let Some(outline) = self.font.outline_glyph(glyph) else { + return (empty, None); + }; + let bounds = outline.px_bounds(); + let (w, h) = (bounds.width() as u32, bounds.height() as u32); + if w == 0 || h == 0 { + return (empty, None); + } + let mut rgba = vec![0u8; (w * h * 4) as usize]; + outline.draw(|x, y, coverage| { + let v = if coverage < 0.1 { + 0 + } else { + (coverage.min(1.0) * 255.0).round() as u8 + }; + let i = ((y * w + x) * 4) as usize; + if let Some(px) = rgba.get_mut(i..i + 4) { + px.copy_from_slice(&[v; 4]); + } + }); + let os = self.oversample; + // GlyphBitmap: bitmap_left / bitmap_top over the oversampling, and + // top = 7 - bearingTop. + let (left, top) = (bounds.min.x / os, 7.0 + bounds.min.y / os); + ( + Glyph { + rect: None, + left, + top, + right: left + w as f32 / os, + bottom: top + h as f32 / os, + advance, + offset: 1.0, + }, + Some((w, h, rgba)), + ) + } +} +fn load_hex(root: &Path, p: &serde_json::Value) -> HashMap<u32, HexGlyph> { + let mut glyphs = HashMap::new(); + let Some(file) = p["hex_file"].as_str() else { + return glyphs; + }; + let path = root.join(resource_path(file, "", "").replace("//", "/")); + let Ok(zip) = Zip::open(&path) else { + return glyphs; + }; + let names: Vec<String> = zip + .names() + .filter(|n| n.ends_with(".hex")) + .map(str::to_owned) + .collect(); + for name in names { + if let Ok(bytes) = zip.read(&name) { + parse_hex(&bytes, &mut glyphs); + } + } + for o in p["size_overrides"].as_array().into_iter().flatten() { + let bound = |k: &str| { + o[k].as_str() + .and_then(|s| s.chars().next()) + .map_or(0, u32::from) + }; + let (left, right) = ( + o["left"].as_u64().unwrap_or(0) as u32, + o["right"].as_u64().unwrap_or(15) as u32, + ); + for c in bound("from")..=bound("to") { + if let Some(g) = glyphs.get_mut(&c) { + g.left = left; + g.right = right; + } + } + } + glyphs +} +/// The ids of every font definition (`font/**/*.json` of each namespace). +fn font_ids(root: &Path) -> Vec<String> { + fn walk(dir: &Path, prefix: &str, out: &mut Vec<String>) { + for entry in std::fs::read_dir(dir).into_iter().flatten().flatten() { + let path = entry.path(); + let name = entry.file_name().to_string_lossy().into_owned(); + if path.is_dir() { + walk(&path, &format!("{prefix}{name}/"), out); + } else if let Some(stem) = name.strip_suffix(".json") { + out.push(format!("{prefix}{stem}")); + } + } + } + let mut ids = Vec::new(); + for ns in std::fs::read_dir(root.join("assets")) + .into_iter() + .flatten() + .flatten() + { + let ns = ns.file_name().to_string_lossy().into_owned(); + walk( + &root.join("assets").join(&ns).join("font"), + &format!("{ns}:"), + &mut ids, + ); + } + ids.sort(); + ids +} +impl Region { + /// Place `w x h` pixels in the region (rows left to right); their atlas + /// position, or none when it is full. + fn place( + &mut self, + w: u32, + h: u32, + rgba: Vec<u8>, + atlas: (u32, u32), + region: (u32, u32), + ) -> Option<(u32, u32)> { + let (mut x, mut y) = self.cursor; + if x + w + 1 > atlas.0 { + x = 0; + y += self.row + 1; + self.row = 0; + } + if y + h > region.1 { + return None; + } + let (ax, ay) = (x, region.0 + y); + self.pending.push(Patch { + x: ax, + y: ay, + width: w, + height: h, + rgba, + }); + self.cursor = (x + w + 1, y); + self.row = self.row.max(h); + Some((ax, ay)) + } +} impl Font { - /// Build from the atlas holding the bitmap font sheets. `pixels` is the - /// RGBA atlas (for glyph widths) and `region` the reserved rows. + /// Build from the atlas holding the bitmap font sheets (`sprites`, of + /// `atlas` size) with `region` the reserved rows. pub fn load( root: &Path, sprites: &HashMap<String, Rect>, @@ -189,107 +566,33 @@ impl Font { region: (u32, u32), white: Rect, ) -> Self { - let mut bitmap = HashMap::new(); - let mut space = HashMap::new(); - let mut all = Vec::new(); - providers(root, "minecraft:default", 0, &mut all); - for provider in &all { - match provider["type"].as_str() { - Some("space") => { - for (k, v) in provider["advances"].as_object().into_iter().flatten() { - if let (Some(c), Some(a)) = (k.chars().next(), v.as_f64()) { - space.entry(c).or_insert(a as f32); - } - } - } - Some("bitmap") => { - // Only non-uniform bitmap sheets exist in the default font. - let file = provider["file"].as_str().unwrap_or(""); - let name = file - .trim_start_matches("minecraft:") - .trim_end_matches(".png"); - let name = name.to_string(); - let Some(rect) = sprites.get(&name).copied() else { - continue; - }; - let rows: Vec<Vec<char>> = provider["chars"] - .as_array() - .into_iter() - .flatten() - .filter_map(|r| r.as_str().map(|s| s.chars().collect())) - .collect(); - if rows.is_empty() || rows[0].is_empty() { - continue; - } - let cell_w = rect.w / rows[0].len() as u32; - let cell_h = rect.h / rows.len() as u32; - let height = provider["height"].as_f64().unwrap_or(8.0) as f32; - let ascent = provider["ascent"].as_f64().unwrap_or(7.0) as f32; - let scale = height / cell_h as f32; - let (ax, ay) = ( - (rect.u0 * atlas.0 as f32).round() as u32, - (rect.v0 * atlas.1 as f32).round() as u32, - ); - for (r, row) in rows.iter().enumerate() { - for (c, ch) in row.iter().enumerate() { - if *ch == '\0' || bitmap.contains_key(ch) { - continue; - } - let (cx, cy) = (ax + c as u32 * cell_w, ay + r as u32 * cell_h); - // BitmapProvider.getActualGlyphWidth. - let mut used = 0; - for x in (0..cell_w).rev() { - if (0..cell_h).any(|y| { - pixels - .get((((cy + y) * atlas.0 + cx + x) * 4 + 3) as usize) - .is_some_and(|a| *a != 0) - }) { - used = x + 1; - break; - } - } - let top = 7.0 - ascent; - bitmap.insert( - *ch, - Glyph { - rect: Some(glyph_rect(cx, cy, cell_w, cell_h, atlas)), - left: 0.0, - top, - right: cell_w as f32 * scale, - bottom: top + cell_h as f32 * scale, - advance: (0.5 + used as f32 * scale).floor() + 1.0, - offset: 1.0, - }, - ); - } - } - } - _ => {} - } - } - let missing = Glyph { - rect: None, - left: 0.0, - top: 0.0, - right: 5.0, - bottom: 8.0, - advance: 6.0, - offset: 1.0, - }; - Self { - bitmap, - space, - missing, + let sheets = sprites + .iter() + .filter(|(k, _)| k.starts_with("font/")) + .map(|(k, v)| (k.clone(), *v)) + .collect(); + let font = Self { + sheets, + missing: Glyph { + rect: None, + left: 0.0, + top: 0.0, + right: 5.0, + bottom: 8.0, + advance: 6.0, + offset: 1.0, + }, white, root: root.to_owned(), atlas, region, cache: RefCell::new(Cache { - glyphs: HashMap::new(), - cursor: (0, 0), - pending: Vec::new(), - hex: None, - by_width: None, + sets: Vec::new(), + region: Region { + cursor: (0, 0), + row: 0, + pending: Vec::new(), + }, random: horizon_core::random::LegacyRandom::new( std::time::SystemTime::now() .duration_since(std::time::UNIX_EPOCH) @@ -298,120 +601,161 @@ impl Font { }), uniform: false, japanese: false, - } + }; + // FontManager.prepare: every font definition of the resources. + let mut ids = font_ids(root); + ids.sort_by_key(|id| id != DEFAULT); + let sets = ids + .into_iter() + .map(|id| { + let set = font.load_set(&id, pixels); + (id, set) + }) + .collect(); + font.cache.borrow_mut().sets = sets; + font } - fn load_hex(&self) -> Vec<HexProvider> { + /// `FontManager`: a font's providers with references expanded. + fn load_set(&self, id: &str, pixels: &[u8]) -> FontSet { let mut all = Vec::new(); - providers(&self.root, "minecraft:default", 0, &mut all); - let mut out = Vec::new(); - for p in all.iter().filter(|p| p["type"] == "unihex") { - if let Some(filter) = p["filter"].as_object() { - let pass = filter.iter().all(|(k, v)| match k.as_str() { - "jp" => v.as_bool() == Some(self.japanese), - "uniform" => v.as_bool() == Some(self.uniform), - _ => true, - }); - if !pass { - continue; - } - } - let Some(file) = p["hex_file"].as_str() else { - continue; - }; - let path = self - .root - .join(resource_path(file, "", "").replace("//", "/")); - let Ok(zip) = Zip::open(&path) else { continue }; - let mut provider = HexProvider::default(); - let names: Vec<String> = zip - .names() - .filter(|n| n.ends_with(".hex")) - .map(str::to_owned) - .collect(); - for name in names { - if let Ok(bytes) = zip.read(&name) { - parse_hex(&bytes, &mut provider.glyphs); - } - } - for o in p["size_overrides"].as_array().into_iter().flatten() { - let from = o["from"] - .as_str() - .and_then(|s| s.chars().next()) - .map_or(0, u32::from); - let to = o["to"] - .as_str() - .and_then(|s| s.chars().next()) - .map_or(0, u32::from); - let (left, right) = ( - o["left"].as_u64().unwrap_or(0) as u32, - o["right"].as_u64().unwrap_or(15) as u32, - ); - for c in from..=to { - if let Some(g) = provider.glyphs.get_mut(&c) { - g.left = left; - g.right = right; - } - } - } - out.push(provider); + providers(&self.root, id, 0, &mut all); + let providers = all + .iter() + .filter_map(|p| match p["type"].as_str()? { + "space" => Some(Provider::Space( + p["advances"] + .as_object() + .into_iter() + .flatten() + .filter_map(|(k, v)| Some((k.chars().next()?, v.as_f64()? as f32))) + .collect(), + )), + "bitmap" => Some(Provider::Bitmap( + Filter::of(p), + load_bitmap(&self.root, p, &self.sheets, pixels, self.atlas), + )), + "unihex" => Some(Provider::Unihex(Filter::of(p), p.clone(), None)), + "ttf" => Some(Provider::TrueType( + Filter::of(p), + Box::new(load_true_type(&self.root, p)?), + )), + _ => None, + }) + .collect(); + FontSet { + providers, + glyphs: HashMap::new(), + by_width: None, } - out } - /// Forget rasterized fallback glyphs (after changing font options). + /// Forget rasterized glyphs (after changing font options). pub fn reset_cache(&self) { let mut cache = self.cache.borrow_mut(); - cache.glyphs.clear(); - cache.cursor = (0, 0); - cache.hex = None; - cache.by_width = None; + for (_, set) in &mut cache.sets { + set.glyphs.clear(); + set.by_width = None; + } + cache.region.cursor = (0, 0); + cache.region.row = 0; } - /// The glyph for a character (FontSet.getGlyph). + /// The glyph for a character in the default font (FontSet.getGlyph). pub fn glyph(&self, c: char) -> Glyph { - if let Some(a) = self.space.get(&c) { - return Glyph { - rect: None, - left: 0.0, - top: 0.0, - right: 0.0, - bottom: 0.0, - advance: *a, - offset: 1.0, - }; - } - if !self.uniform - && let Some(g) = self.bitmap.get(&c) - { - return *g; - } - if let Some(g) = self.cache.borrow().glyphs.get(&c) { - return *g; + self.glyph_of(DEFAULT, c) + } + /// The glyph for a character drawn in `style`'s font (its id is + /// already complete, see `text::font_id`). + pub fn glyph_styled(&self, c: char, style: &Style) -> Glyph { + self.glyph_of(style.font.as_deref().unwrap_or(DEFAULT), c) + } + /// The glyph for a character in the font `id` (`alt` is `minecraft:alt`). + pub fn glyph_in(&self, id: &str, c: char) -> Glyph { + if id.contains(':') { + self.glyph_of(id, c) + } else { + self.glyph_of(&format!("minecraft:{id}"), c) } + } + /// The first active provider's glyph, else the missing glyph. + fn glyph_of(&self, id: &str, c: char) -> Glyph { let mut cache = self.cache.borrow_mut(); - if cache.hex.is_none() { - cache.hex = Some(self.load_hex()); - } - let hex = cache.hex.as_ref().and_then(|providers| { - providers - .iter() - .find_map(|p| p.glyphs.get(&u32::from(c)).copied()) - }); - let glyph = match hex { - Some(h) => self.rasterize(&mut cache, h).unwrap_or(self.missing), - None => self.missing, + let Cache { sets, region, .. } = &mut *cache; + // FontManager.getFontSetRaw: a font that doesn't exist draws every + // character as the missing glyph. + let Some((_, set)) = sets.iter_mut().find(|(k, _)| k == id) else { + return self.missing; }; - cache.glyphs.insert(c, glyph); + if let Some(g) = set.glyphs.get(&c) { + return *g; + } + let glyph = self.resolve(set, region, c).unwrap_or(self.missing); + set.glyphs.insert(c, glyph); glyph } - fn rasterize(&self, cache: &mut Cache, h: HexGlyph) -> Option<Glyph> { + fn resolve(&self, set: &mut FontSet, region: &mut Region, c: char) -> Option<Glyph> { + let (uniform, japanese) = (self.uniform, self.japanese); + for provider in &mut set.providers { + match provider { + Provider::Space(advances) => { + if let Some(a) = advances.get(&c) { + return Some(Glyph { + rect: None, + left: 0.0, + top: 0.0, + right: 0.0, + bottom: 0.0, + advance: *a, + offset: 1.0, + }); + } + } + Provider::Bitmap(filter, glyphs) if filter.passes(uniform, japanese) => { + match glyphs.get(&c) { + Some(BitmapGlyph::Atlas(g)) => return Some(*g), + Some(BitmapGlyph::Sheet(cell)) => { + let (stride, pixels) = (&cell.sheet.0, &cell.sheet.1); + let mut rgba = Vec::with_capacity((cell.w * cell.h * 4) as usize); + for y in cell.y..cell.y + cell.h { + let at = ((y * stride + cell.x) * 4) as usize; + rgba.extend_from_slice(&pixels[at..at + (cell.w * 4) as usize]); + } + let (x, y) = + region.place(cell.w, cell.h, rgba, self.atlas, self.region)?; + return Some(Glyph { + rect: Some(glyph_rect(x, y, cell.w, cell.h, self.atlas)), + ..cell.glyph + }); + } + None => {} + } + } + Provider::Unihex(filter, def, glyphs) if filter.passes(uniform, japanese) => { + let glyphs = glyphs.get_or_insert_with(|| load_hex(&self.root, def)); + if let Some(h) = glyphs.get(&u32::from(c)).copied() { + return self.rasterize_hex(region, h); + } + } + Provider::TrueType(filter, ttf) if filter.passes(uniform, japanese) => { + if let Some(id) = ttf.ids.get(&c) { + let (glyph, bitmap) = ttf.glyph(*id); + return match bitmap { + Some((w, h, rgba)) => { + let (x, y) = region.place(w, h, rgba, self.atlas, self.region)?; + Some(Glyph { + rect: Some(glyph_rect(x, y, w, h, self.atlas)), + ..glyph + }) + } + None => Some(glyph), + }; + } + } + _ => {} + } + } + None + } + fn rasterize_hex(&self, region: &mut Region, h: HexGlyph) -> Option<Glyph> { let width = h.right.saturating_sub(h.left) + 1; - let (mut x, mut y) = cache.cursor; - if x + width + 1 > self.atlas.0 { - x = 0; - y += 17; - } - if y + 16 > self.region.1 { - return None; - } let mut rgba = Vec::with_capacity((width * 16 * 4) as usize); for row in h.rows { for bit in h.left..=h.right { @@ -419,17 +763,9 @@ impl Font { rgba.extend(if set { [255; 4] } else { [0; 4] }); } } - let (ax, ay) = (x, self.region.0 + y); - cache.pending.push(Patch { - x: ax, - y: ay, - width, - height: 16, - rgba, - }); - cache.cursor = (x + width + 1, y); + let (x, y) = region.place(width, 16, rgba, self.atlas, self.region)?; Some(Glyph { - rect: Some(glyph_rect(ax, ay, width, 16, self.atlas)), + rect: Some(glyph_rect(x, y, width, 16, self.atlas)), left: 0.0, top: 0.0, right: width as f32 / 2.0, @@ -439,26 +775,29 @@ impl Font { }) } /// `FontSet.getRandomGlyph`: what an obfuscated character draws, a random - /// glyph as wide as `advance` (rounded up), else the missing glyph. + /// glyph of the font as wide as `advance` (rounded up), else the missing + /// glyph. /// /// Vanilla picks among every glyph of the font set, Unifont's included. /// Those are rasterized into a fixed atlas region on demand, which a /// line of obfuscated text would fill in seconds, so the candidates are - /// the glyphs already in the atlas (the bitmap sheets and spaces), or with - /// "Force Unicode Font" the Unifont glyphs below U+0250. - pub fn random_glyph(&self, advance: f32) -> Glyph { + /// the glyphs already in the atlas (the bitmap sheets there and spaces), + /// or for a font without any (Force Unicode Font, a TrueType font) its + /// glyphs below U+0250. + pub fn random_glyph(&self, style: &Style, advance: f32) -> Glyph { use horizon_core::random::RandomSource; + let id = style.font.as_deref().unwrap_or(DEFAULT); let width = advance.ceil() as u32; let pick = { let mut cache = self.cache.borrow_mut(); - if cache.by_width.is_none() { - let by_width = self.glyphs_by_width(&mut cache); - cache.by_width = Some(by_width); + let Cache { sets, random, .. } = &mut *cache; + let Some((_, set)) = sets.iter_mut().find(|(k, _)| k == id) else { + return self.missing; + }; + if set.by_width.is_none() { + set.by_width = Some(self.glyphs_by_width(set)); } - let Cache { - by_width, random, .. - } = &mut *cache; - by_width + set.by_width .as_ref() .and_then(|m| m.get(&width)) .and_then(|chars| { @@ -466,44 +805,79 @@ impl Font { chars.get(i as usize).copied() }) }; - pick.map_or(self.missing, |c| self.glyph(c)) + pick.map_or(self.missing, |c| self.glyph_of(id, c)) } - fn glyphs_by_width(&self, cache: &mut Cache) -> HashMap<u32, Vec<char>> { - let mut chars: Vec<(char, f32)> = self.space.iter().map(|(c, a)| (*c, *a)).collect(); - if self.uniform { - if cache.hex.is_none() { - cache.hex = Some(self.load_hex()); - } - for code in 0..0x250u32 { - let hex = cache.hex.iter().flatten().find_map(|p| p.glyphs.get(&code)); - if let (Some(c), Some(h)) = (char::from_u32(code), hex) - && !self.space.contains_key(&c) - { - let width = h.right.saturating_sub(h.left) + 1; - chars.push((c, (width / 2 + 1) as f32)); + fn glyphs_by_width(&self, set: &mut FontSet) -> HashMap<u32, Vec<char>> { + let (uniform, japanese) = (self.uniform, self.japanese); + let mut chars = std::collections::BTreeSet::new(); + let mut in_atlas = false; + for provider in &set.providers { + match provider { + Provider::Space(advances) => chars.extend(advances.keys().copied()), + Provider::Bitmap(filter, glyphs) if filter.passes(uniform, japanese) => { + for (c, g) in glyphs { + if matches!(g, BitmapGlyph::Atlas(_)) { + in_atlas = true; + chars.insert(*c); + } + } } + _ => {} } - } else { - chars.extend( - self.bitmap - .iter() - .filter(|(c, _)| !self.space.contains_key(c)) - .map(|(c, g)| (*c, g.advance)), - ); } - chars.sort_by_key(|(c, _)| *c); + if !in_atlas { + // Nothing in the atlas: the glyphs below U+0250, rasterized as used. + chars.extend((0..0x250u32).filter_map(char::from_u32)); + } let mut out: HashMap<u32, Vec<char>> = HashMap::new(); - for (c, advance) in chars { - out.entry(advance.ceil() as u32).or_default().push(c); + for c in chars { + if let Some(advance) = self.provider_advance(set, c) { + out.entry(advance.ceil() as u32).or_default().push(c); + } } out } + /// A character's advance in `set` (its first provider that has it), + /// without rasterizing it. + fn provider_advance(&self, set: &mut FontSet, c: char) -> Option<f32> { + let (uniform, japanese) = (self.uniform, self.japanese); + for provider in &mut set.providers { + match provider { + Provider::Space(advances) => { + if let Some(a) = advances.get(&c) { + return Some(*a); + } + } + Provider::Bitmap(filter, glyphs) if filter.passes(uniform, japanese) => { + match glyphs.get(&c) { + Some(BitmapGlyph::Atlas(g)) => return Some(g.advance), + Some(BitmapGlyph::Sheet(cell)) => return Some(cell.glyph.advance), + None => {} + } + } + Provider::Unihex(filter, def, glyphs) if filter.passes(uniform, japanese) => { + let glyphs = glyphs.get_or_insert_with(|| load_hex(&self.root, def)); + if let Some(h) = glyphs.get(&u32::from(c)) { + let width = h.right.saturating_sub(h.left) + 1; + return Some((width / 2 + 1) as f32); + } + } + Provider::TrueType(filter, ttf) if filter.passes(uniform, japanese) => { + if let Some(id) = ttf.ids.get(&c) { + return Some(ttf.advance(*id)); + } + } + _ => {} + } + } + None + } /// Atlas pixels rasterized since the last call. pub fn take_patches(&self) -> Vec<Patch> { - std::mem::take(&mut self.cache.borrow_mut().pending) + std::mem::take(&mut self.cache.borrow_mut().region.pending) } pub fn advance(&self, c: char, style: &Style) -> f32 { - let g = self.glyph(c); + let g = self.glyph_styled(c, style); g.advance + if style.is_bold() { g.offset } else { 0.0 } } /// Font.width of plain text (legacy codes are formatting, not glyphs). @@ -689,4 +1063,155 @@ mod tests { assert_eq!(r.v1, ((y + h) as f32 - 0.01) / 4096.0); } } + + /// A resource root with these font definitions and files. + fn root(name: &str, files: &[(&str, &[u8])]) -> PathBuf { + let root = std::env::temp_dir().join(format!("horizon-font-{name}-{}", std::process::id())); + let _ = std::fs::remove_dir_all(&root); + for (path, bytes) in files { + let path = root.join(path); + std::fs::create_dir_all(path.parent().unwrap()).unwrap(); + std::fs::write(path, bytes).unwrap(); + } + root + } + fn white() -> Rect { + Rect { + u0: 0.0, + v0: 0.0, + u1: 0.0, + v1: 0.0, + w: 1, + h: 1, + } + } + fn load(root: &Path) -> Font { + Font::load( + root, + &HashMap::new(), + &[], + (4096, 1024), + (512, 512), + white(), + ) + } + fn png(width: u32, height: u32, opaque: impl Fn(u32, u32) -> bool) -> Vec<u8> { + let mut pixels = Vec::new(); + for y in 0..height { + for x in 0..width { + pixels.extend(if opaque(x, y) { [255; 4] } else { [0; 4] }); + } + } + let mut out = Vec::new(); + let mut encoder = png::Encoder::new(&mut out, width, height); + encoder.set_color(png::ColorType::Rgba); + encoder.set_depth(png::BitDepth::Eight); + encoder + .write_header() + .unwrap() + .write_image_data(&pixels) + .unwrap(); + out + } + + #[test] + fn true_type_glyphs_are_rasterized_at_the_provider_size() { + let def = br#"{"providers":[{"type":"ttf","file":"minecraft:mono.ttf","size":11,"oversample":2,"shift":[0.5,1],"skip":["B"]}]}"#; + let root = root( + "ttf", + &[ + ("assets/minecraft/font/default.json", def), + ( + "assets/minecraft/font/mono.ttf", + horizon_theme::fonts::GEIST_MONO, + ), + ], + ); + let font = load(&root); + let _ = std::fs::remove_dir_all(&root); + let a = font.glyph('A'); + let rect = a.rect.expect("A is drawn"); + // Oversampled 2x: the bitmap is twice the glyph's GUI size. + assert_eq!(rect.w as f32 / 2.0, a.right - a.left); + assert_eq!(rect.h as f32 / 2.0, a.bottom - a.top); + // A monospaced font: every advance is the same, in half pixels. + assert_eq!(a.advance, font.glyph('i').advance); + assert_eq!((a.advance * 2.0).fract(), 0.0); + assert!(a.advance > 4.0 && a.advance < 9.0, "{}", a.advance); + // Capitals sit on the baseline at y = 7, shifted down a pixel. + assert!((a.bottom - 8.0).abs() <= 0.5, "{}", a.bottom); + assert_eq!(a.offset, 1.0); + // The space has an advance and nothing to draw. + let space = font.glyph(' '); + assert!(space.rect.is_none() && space.advance > 0.0); + // Skipped characters fall through to the missing glyph. + assert_eq!(font.glyph('B').advance, 6.0); + // Coverage as `rrrr` texels, faint coverage cut. + let patches = font.take_patches(); + assert_eq!(patches.len(), 2); + let texels: Vec<&[u8]> = patches.iter().flat_map(|p| p.rgba.chunks(4)).collect(); + assert!(texels.iter().all(|t| t.iter().all(|v| *v == t[0]))); + assert!(texels.iter().all(|t| t[0] == 0 || t[0] >= 25)); + assert!(texels.iter().any(|t| t[0] == 255)); + } + + #[test] + fn styles_pick_their_font_and_unknown_fonts_draw_missing_glyphs() { + let sheet = png(16, 8, |x, _| x < 2 || (8..14).contains(&x)); + let default = br#"{"providers":[{"type":"space","advances":{" ":4}},{"type":"bitmap","file":"minecraft:font/a.png","ascent":7,"chars":["ab"]}]}"#; + let alt = br#"{"providers":[{"type":"bitmap","file":"minecraft:font/a.png","ascent":7,"chars":["ba"]}]}"#; + let root = root( + "styles", + &[ + ("assets/minecraft/font/default.json", default), + ("assets/minecraft/font/alt.json", alt), + ("assets/minecraft/textures/font/a.png", &sheet), + ], + ); + let font = load(&root); + let _ = std::fs::remove_dir_all(&root); + // The sheet is not in this atlas: glyphs are copied in when first drawn. + assert_eq!(font.glyph('a').advance, 3.0); + assert_eq!(font.glyph('b').advance, 7.0); + let alt = Style { + font: Some("minecraft:alt".into()), + ..Style::default() + }; + assert_eq!(font.glyph_styled('a', &alt).advance, 7.0); + assert_eq!(font.glyph_in("alt", 'b').advance, 3.0); + assert!(font.glyph_styled('a', &alt).rect.is_some()); + // Not in alt (no space provider there), or no such font at all. + assert_eq!(font.glyph_styled(' ', &alt).advance, 6.0); + let missing = Style { + font: Some("minecraft:nope".into()), + ..Style::default() + }; + assert_eq!(font.glyph_styled(' ', &missing).advance, 6.0); + assert_eq!(font.advance('a', &alt), 7.0); + let text = Text::literal("ab").with_style(&alt); + assert_eq!(font.width_text(&text), 10.0); + assert_eq!(font.random_glyph(&alt, 7.0).advance, 7.0); + assert!(!font.take_patches().is_empty()); + } + + #[test] + fn provider_filters_follow_the_font_options() { + let sheet = png(8, 8, |x, _| x < 4); + let default = br#"{"providers":[{"type":"reference","id":"minecraft:include/sheet","filter":{"uniform":false}},{"type":"space","advances":{"a":2}}]}"#; + let sheet_def = br#"{"providers":[{"type":"bitmap","file":"minecraft:font/s.png","ascent":7,"chars":["a"]}]}"#; + let root = root( + "filters", + &[ + ("assets/minecraft/font/default.json", default), + ("assets/minecraft/font/include/sheet.json", sheet_def), + ("assets/minecraft/textures/font/s.png", &sheet), + ], + ); + let mut font = load(&root); + let _ = std::fs::remove_dir_all(&root); + assert_eq!(font.glyph('a').advance, 5.0); + font.uniform = true; + font.reset_cache(); + assert_eq!(font.glyph('a').advance, 2.0); + } } diff --git a/crates/horizon-client/src/hud.rs b/crates/horizon-client/src/hud.rs index 29faf5a2a..3c33ecb18 100644 --- a/crates/horizon-client/src/hud.rs +++ b/crates/horizon-client/src/hud.rs @@ -711,11 +711,12 @@ impl HudBatch { let mut glyphs = Vec::new(); let mut cursor = x; for (i, (ch, style)) in text.chars().enumerate() { - let mut g = font.glyph(ch); + // The style's font (`Style.getFont`), the default one unless set. + let mut g = font.glyph_styled(ch, style); // Font.StringRenderOutput.accept: obfuscated characters draw a // random glyph of the same width each frame. if style.obfuscated == Some(true) && ch != ' ' { - g = font.random_glyph(g.advance); + g = font.random_glyph(style, g.advance); } let c = style.color.map_or(color, |rgb| { rgba((rgb >> 16) as u8, (rgb >> 8) as u8, rgb as u8, alpha) @@ -1263,11 +1264,11 @@ mod tests { let (a, b) = (fonts.font.glyph('a').advance, fonts.font.glyph('b').advance); assert_ne!(a, b); for _ in 0..20 { - assert_eq!(fonts.font.random_glyph(a).advance, a); - assert_eq!(fonts.font.random_glyph(b).advance, b); + assert_eq!(fonts.font.random_glyph(&Default::default(), a).advance, a); + assert_eq!(fonts.font.random_glyph(&Default::default(), b).advance, b); } // No glyph that wide: FontSet's missing glyph. - let missing = fonts.font.random_glyph(30.0); + let missing = fonts.font.random_glyph(&Default::default(), 30.0); assert!(missing.rect.is_none() && missing.right == 5.0); } diff --git a/crates/horizon-client/src/packs.rs b/crates/horizon-client/src/packs.rs index 7af7518f8..7bd4fd782 100644 --- a/crates/horizon-client/src/packs.rs +++ b/crates/horizon-client/src/packs.rs @@ -87,6 +87,7 @@ fn style_of(o: &serde_json::Map<String, serde_json::Value>) -> Style { underlined: flag("underlined"), strikethrough: flag("strikethrough"), obfuscated: flag("obfuscated"), + font: o.get("font").and_then(crate::text::font_id), ..Style::default() } } diff --git a/crates/horizon-client/src/scoreboard.rs b/crates/horizon-client/src/scoreboard.rs index e063c6f09..4796be51a 100644 --- a/crates/horizon-client/src/scoreboard.rs +++ b/crates/horizon-client/src/scoreboard.rs @@ -118,6 +118,7 @@ pub fn style_from_json(v: &Value) -> Style { s.underlined = flag("underlined"); s.strikethrough = flag("strikethrough"); s.obfuscated = flag("obfuscated"); + s.font = o.get("font").and_then(text::font_id); s } impl NumberFormat { diff --git a/crates/horizon-client/src/text.rs b/crates/horizon-client/src/text.rs index 3874efd17..9f39155d1 100644 --- a/crates/horizon-client/src/text.rs +++ b/crates/horizon-client/src/text.rs @@ -61,6 +61,13 @@ pub struct Style { pub click: Option<ClickEvent>, /// Hover text. pub hover: Option<Box<Text>>, + /// The font (`FontDescription.Resource`), a full id like + /// `minecraft:alt`; the default font when unset. + pub font: Option<String>, +} +/// A style's `font` field: an identifier (`alt` is `minecraft:alt`). +pub fn font_id(v: &Value) -> Option<String> { + crate::command::args::parse_identifier(v.as_str()?) } impl Style { pub fn color(c: u32) -> Self { @@ -83,6 +90,9 @@ impl Style { if self.hover.is_none() { self.hover.clone_from(&base.hover); } + if self.font.is_none() { + self.font.clone_from(&base.font); + } } pub fn is_bold(&self) -> bool { self.bold == Some(true) @@ -451,7 +461,7 @@ impl Text { } /// The style fields of a component's JSON. -const STYLE_KEYS: [&str; 8] = [ +const STYLE_KEYS: [&str; 9] = [ "color", "bold", "italic", @@ -460,6 +470,7 @@ const STYLE_KEYS: [&str; 8] = [ "obfuscated", "click_event", "hover_event", + "font", ]; /// Style.Serializer: the fields a style sets. fn style_json(style: &Style) -> Vec<(String, Value)> { @@ -500,6 +511,9 @@ fn style_json(style: &Style) -> Vec<(String, Value)> { json!({ "action": "show_text", "value": hover.component() }), )); } + if let Some(font) = &style.font { + out.push(("font".to_owned(), font.clone().into())); + } out } From a069c2716f9a2bcf394859a53e44e0538825f9ad Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 15:24:07 +0200 Subject: [PATCH 012/126] Random ticks: ask for the next ticking section, and read a section's blocks faster tick_chunk_random asks for the lowest randomly ticking section from a height up, instead of asking about every section: a chunk costs one question per section that ticks, not 24. PalettedContainer::has tests whole words for the few matching palette indices (a field-wise zero test) instead of reading every entry, so a section read again after an edit costs a few hundred word operations. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../examples/random_tick_sections_probe.rs | 2 +- crates/horizon-client/src/game.rs | 4 +- .../src/random_tick_sections.rs | 47 ++++++-- crates/horizon-core/src/paletted.rs | 105 +++++++++++++----- crates/horizon-world/src/level/mod.rs | 2 +- crates/horizon-world/src/level/tick.rs | 18 +-- 6 files changed, 127 insertions(+), 51 deletions(-) diff --git a/crates/horizon-client/examples/random_tick_sections_probe.rs b/crates/horizon-client/examples/random_tick_sections_probe.rs index cb8a8b742..91c861f45 100644 --- a/crates/horizon-client/examples/random_tick_sections_probe.rs +++ b/crates/horizon-client/examples/random_tick_sections_probe.rs @@ -99,7 +99,7 @@ fn main() -> Result<(), Box<dyn Error>> { &mut level, &mut ticks, ChunkPos::new(0, 0), - |_, min_y| cache.get((0, 0), &chunk, &facts).contains(min_y), + |_, from| cache.get((0, 0), &chunk, &facts).from(from), ); for pos in level.reads.borrow().iter() { let state = chunk.block(pos.x, pos.y, pos.z); diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index afdb2ee37..20e75fcdf 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -2427,7 +2427,7 @@ impl Game<'_> { let mut read = None; let mut sections = Default::default(); let pos = horizon_core::position::ChunkPos::new(x, z); - b.tick_chunk_random(level, ticks, pos, |level, min_y| { + b.tick_chunk_random(level, ticks, pos, |level, from| { if read != Some(level.world.revision) { read = Some(level.world.revision); sections = level @@ -2438,7 +2438,7 @@ impl Game<'_> { level.random_tick_sections.get((x, z), chunk, level.facts) }); } - sections.contains(min_y) + sections.from(from) }); } b.run_block_events(level, ticks); diff --git a/crates/horizon-client/src/random_tick_sections.rs b/crates/horizon-client/src/random_tick_sections.rs index 23d6a3dbe..ebab40a7b 100644 --- a/crates/horizon-client/src/random_tick_sections.rs +++ b/crates/horizon-client/src/random_tick_sections.rs @@ -12,10 +12,10 @@ use std::sync::{Arc, Weak}; #[derive(Clone, Copy, Debug, Default, PartialEq, Eq)] pub struct Sections(u32); impl Sections { - /// Whether the section starting at block `min_y` is in the set. - pub fn contains(self, min_y: i32) -> bool { - let index = (min_y - MIN_Y) >> 4; - (0..SECTIONS as i32).contains(&index) && self.0 >> index & 1 != 0 + /// The minimum Y of the lowest section in the set from block `min_y` up. + pub fn from(self, min_y: i32) -> Option<i32> { + let index = ((min_y - MIN_Y) >> 4).max(0) as u32; + Sections(self.0 & u32::MAX.checked_shl(index).unwrap_or(0)).next() } } impl Iterator for Sections { @@ -184,6 +184,27 @@ mod tests { .collect::<Vec<_>>(), [MIN_Y, MIN_Y + 9 * 16, MIN_Y + (SECTIONS as i32 - 1) * 16] ); + let sections = cache.get_with((0, 0), &chunk, |id| id == 299); + let top = MIN_Y + (SECTIONS as i32 - 1) * 16; + let from = |y| sections.from(y); + assert_eq!( + [ + from(MIN_Y - 16), + from(MIN_Y), + from(MIN_Y + 16), + from(MIN_Y + 9 * 16) + ], + [ + Some(MIN_Y), + Some(MIN_Y), + Some(MIN_Y + 9 * 16), + Some(MIN_Y + 9 * 16) + ] + ); + assert_eq!( + [from(top), from(top + 16), from(top + 1000)], + [Some(top), None, None] + ); } } @@ -359,19 +380,21 @@ mod tick_parity { for (x, z) in lit(&original) { // Vanilla's rule, asked as each section is reached: any of its // 4,096 blocks ticks randomly. - let reference = |level: &mut Level, min_y: i32| { + let reference = |level: &mut Level, from: i32| { let chunk = &level.chunks[&(x, z)]; - (0..16).any(|y| { - (0..16).any(|z| (0..16).any(|x| random(chunk.get(x, min_y + y, z)))) - }) + (from..MIN_Y + SECTIONS as i32 * 16) + .step_by(16) + .find(|&min_y| { + (0..16).any(|y| { + (0..16).any(|z| (0..16).any(|x| random(chunk.get(x, min_y + y, z)))) + }) + }) }; behaviours.tick_chunk_random(&mut original, &mut a, ChunkPos::new(x, z), reference); } for (x, z) in lit(&cached) { - let memoized = |level: &mut Level, min_y| { - cache - .get((x, z), &level.chunks[&(x, z)], &facts) - .contains(min_y) + let memoized = |level: &mut Level, from| { + cache.get((x, z), &level.chunks[&(x, z)], &facts).from(from) }; behaviours.tick_chunk_random(&mut cached, &mut b, ChunkPos::new(x, z), memoized); } diff --git a/crates/horizon-core/src/paletted.rs b/crates/horizon-core/src/paletted.rs index dad7f76a0..43189f425 100644 --- a/crates/horizon-core/src/paletted.rs +++ b/crates/horizon-core/src/paletted.rs @@ -677,37 +677,43 @@ impl PalettedContainer { /// Whether any entry satisfies `predicate`. Unlike [`Self::maybe_has`], /// palette entries no entry uses any more don't count. pub fn has(&self, mut predicate: impl FnMut(u32) -> bool) -> bool { - let matching: Vec<bool> = match &self.palette { + let list = match &self.palette { Palette::Single(value) => return predicate(*value), - Palette::List(list) => list.iter().map(|&v| predicate(v)).collect(), - Palette::Global => Vec::new(), + Palette::List(list) => list, + Palette::Global => { + return (0..self.strategy.entries()).any(|i| predicate(self.raw(i) as u32)); + } }; - if matches!(self.palette, Palette::List(_)) { - if !matching.contains(&true) { - return false; - } - if !matching.contains(&false) { - return true; - } + let matching: Vec<bool> = list.iter().map(|&v| predicate(v)).collect(); + let count = matching.iter().filter(|&&m| m).count(); + if count == 0 || count == list.len() { + return count != 0; } - let bits = usize::from(self.bits); + let (bits, entries) = (usize::from(self.bits), self.strategy.entries()); let per = 64 / bits; - let m = mask(self.bits); - let mut left = self.strategy.entries(); - for &word in &self.words { - for slot in 0..per.min(left) { - let id = ((word >> (slot * bits)) & m) as usize; - let hit = match self.palette { - Palette::Global => predicate(id as u32), - _ => matching[id], - }; - if hit { - return true; - } - } - left = left.saturating_sub(per); + // The words whose fields all hold entries; the last may be partial. + let full = entries / per; + if count <= 4 { + // A field-wise zero test of each word XORed with the matching + // index in every field: `(v - lo) & !v & hi` is non-zero exactly + // when some field of `v` is zero. + let lo = (0..per).fold(0u64, |a, f| a | 1 << (f * bits)); + let hi = lo << (bits - 1); + let words = &self.words[..full]; + let found = matching + .iter() + .enumerate() + .filter(|(_, m)| **m) + .any(|(i, _)| { + let pattern = lo * i as u64; + words.iter().any(|&w| { + let v = w ^ pattern; + v.wrapping_sub(lo) & !v & hi != 0 + }) + }); + return found || (full * per..entries).any(|i| matching[self.raw(i)]); } - false + (0..entries).any(|i| matching[self.raw(i)]) } /// Heap bytes held by the palette and the storage. pub fn heap_bytes(&self) -> usize { @@ -816,6 +822,53 @@ mod tests { } } #[test] + fn has_matches_a_scan_at_every_width() { + let mut state = 0x9E37_79B9_7F4A_7C15u64; + for (strategy, distinct) in [ + (BLOCKS, 2u32), + (BLOCKS, 3), + (BLOCKS, 17), + (BLOCKS, 33), + (BLOCKS, 65), + (BLOCKS, 129), + (BIOMES, 2), + (BIOMES, 3), + (BIOMES, 5), + ] { + let entries = strategy.entries(); + let mut c = PalettedContainer::new(strategy, 0); + let mut plain = vec![0u32; entries]; + for i in 0..entries { + let v = (rng(&mut state) % u64::from(distinct)) as u32; + c.set(i, v); + plain[i] = v; + } + // Take some values away again (stale entries), the last index too. + for gone in [0, 1, distinct - 1] { + for i in 0..entries { + if plain[i] == gone { + c.set(i, distinct); + plain[i] = distinct; + } + } + for m in [3, 5, 7] { + let hit = |v: u32| v % m == gone % m; + assert_eq!(c.has(hit), plain.iter().any(|&v| hit(v))); + } + for wanted in 0..=distinct { + for other in [wanted, wanted + 1, wanted + 2, wanted + 3, wanted + 4] { + let hit = |v: u32| v == wanted || v == other; + assert_eq!( + c.has(hit), + plain.iter().any(|&v| hit(v)), + "{distinct} values, {wanted}/{other}, without {gone}" + ); + } + } + } + } + } + #[test] fn has_ignores_stale_palette_entries() { let mut c = PalettedContainer::new(BLOCKS, 0); assert!(c.has(|v| v == 0) && !c.has(|v| v == 3)); diff --git a/crates/horizon-world/src/level/mod.rs b/crates/horizon-world/src/level/mod.rs index 1c338f2ed..e343e06a7 100644 --- a/crates/horizon-world/src/level/mod.rs +++ b/crates/horizon-world/src/level/mod.rs @@ -69,7 +69,7 @@ //! level.time += 1; //! behaviours.tick_scheduled(&mut level, &mut ticks); //! for chunk in ticking_chunks { -//! behaviours.tick_chunk_random(&mut level, &mut ticks, chunk, |level, min_y| level.randomly_ticking(chunk, min_y)); +//! behaviours.tick_chunk_random(&mut level, &mut ticks, chunk, |level, from| level.next_ticking_section(chunk, from)); //! } //! behaviours.run_block_events(&mut level, &mut ticks); //! /* tick entities */ diff --git a/crates/horizon-world/src/level/tick.rs b/crates/horizon-world/src/level/tick.rs index e9e4f6791..0f640ef3a 100644 --- a/crates/horizon-world/src/level/tick.rs +++ b/crates/horizon-world/src/level/tick.rs @@ -1617,16 +1617,17 @@ impl Behaviours { } /// Random-tick one chunk (`ServerLevel.tickChunk` block part). Visits the /// sections from the bottom up and draws `randomTickSpeed` positions in - /// each one `ticking(level, min_y)` reports randomly ticking - /// (`LevelChunkSection.isRandomlyTicking`: it holds a randomly ticking - /// block or fluid). Vanilla asks as it reaches each section, so the ticks - /// of the sections below count. + /// each randomly ticking one (`LevelChunkSection.isRandomlyTicking`: it + /// holds a randomly ticking block or fluid). `next_ticking(level, min_y)` + /// is the minimum Y of the lowest such section from `min_y` up, as the + /// chunk is now: vanilla asks as it reaches each section, so the ticks of + /// the sections below count. pub fn tick_chunk_random<L: LevelAccess + ?Sized>( &self, level: &mut L, ticks: &mut Ticks, chunk: ChunkPos, - mut ticking: impl FnMut(&mut L, i32) -> bool, + mut next_ticking: impl FnMut(&mut L, i32) -> Option<i32>, ) { let speed = level.game_rules().random_tick_speed; if speed <= 0 { @@ -1641,14 +1642,13 @@ impl Behaviours { } } } - for min_y in (level.min_y()..level.max_y()).step_by(16) { - if !ticking(level, min_y) { - continue; - } + let mut from = level.min_y(); + while let Some(min_y) = next_ticking(level, from).filter(|&y| y < level.max_y()) { for _ in 0..speed { let pos = ticks.block_random_pos(min_x, min_y, min_z, 15); self.sim(level, ticks).random_tick_at(pos); } + from = min_y + 16; } } /// Random-tick a single position (block then fluid), as `tickChunk` does. From bd36508c298cfee286986088a1b30ecdac68d34b Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 12:34:20 +0200 Subject: [PATCH 013/126] lan_e2e levels: players in their own levels on the server thread; design note A new `levels` check (--server-thread) runs the host and a guest in different dimensions: execute in ... tp, mobs ticking in two levels at once with unique ids, rejoin and save/reload with the guest in the Nether, death there, the host through a Nether portal alone, the guest through an End portal and the exit portal alone. All of it already works on the server thread. docs/server-levels.md says how the server's levels map onto vanilla's, what the dedicated server and the server thread share, the cost of an extra level and what's left. docs/server.md no longer says players can't change dimension. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- docs/server-levels.md | 90 ++++++++++++++++++ docs/server.md | 2 +- tools/lan_e2e.py | 212 +++++++++++++++++++++++++++++++++++++++++- 3 files changed, 301 insertions(+), 3 deletions(-) create mode 100644 docs/server-levels.md diff --git a/docs/server-levels.md b/docs/server-levels.md new file mode 100644 index 000000000..0190c0c03 --- /dev/null +++ b/docs/server-levels.md @@ -0,0 +1,90 @@ +# A server's levels: one per dimension + +Vanilla's `MinecraftServer` holds a `ServerLevel` per dimension, and each player is in one of them. +Horizon's server does the same. That covers the dedicated server and single player's server thread +(`Game::serving`, the default since #1114). So a LAN world's host and each guest can be in different +dimensions at the same time. + +## How the single-level `Game` maps onto vanilla's levels + +The game's tick code reads one level: the one held in `Game`'s own fields (the world, its streaming +and save, block ticks, entities, block entities and their per-level queues). `game/levels.rs` keeps +the other dimensions' levels as `Parked` values and swaps one into place (`enter_level`). The swap is +`mem::swap` of each per-level field, so the tick code runs unchanged, one level at a time. + +| Vanilla | Horizon | +| --- | --- | +| `MinecraftServer.levels` | the level in place plus `Levels::parked` | +| `MinecraftServer.tickChildren`, every level | `tick_server`: each level with a player in it, in Overworld, Nether, End order. The first pass reads the network and runs the shared parts (clock, weather, functions, autosave). | +| `ServerLevel.players` | `Hub::here`: the guests whose `dimension` is the level in place | +| `ServerPlayer.teleport` into another level | `server_travel.rs`: a Respawn packet, then the teleport once the destination has loaded (portals and `execute in … tp`) | +| `PlayerList.respawn` | `guest_respawn`: back into the Overworld's level | +| `ServerLevel.noPlayersEmptyTime`, chunk unloading | `close_idle_levels`: a level other than the Overworld with nobody in it for 300 ticks is saved and closed | +| the levels' shared `LevelData` | not swapped: game time, day time, weather, game rules, scoreboard, maps, entity ids (`next_entity`, unique across levels) | + +The packets of a guest are read in its own level's pass (`Hub::tick_level`), so its actions and +commands run with its level in place. + +The window's own game (`--no-server-thread`, `HORIZON_SERVER_THREAD=0`, and the command harness) keeps +one level, which follows its player (`enter_dimension`). LAN guests of a world run that way stay in the +host's dimension. That mode is the escape hatch now, so it gets no multi-level work. + +## One code path for both + +The dedicated server and the server thread are the same code. The server thread runs a `Game` with +`options.dedicated` set and a hub without a host player. The window joins it through memory as one +more player. Everything above serves both, and `server_dimension_players` (vanilla clients on Horizon's +dedicated server) and `lan_e2e --server-thread` (Horizon clients on the server thread) check it from +the two sides. + +## Cost of an extra level + +Measured on the Mac mini (M4 Pro) at render distance 12, on 2026-10-22. The host and a guest each +played a fresh world on the server thread. RSS is the host's whole process, window included. Tick time +is `/tick query`'s average over 100 ticks. + +| Where the players are | Average tick | P95 | Host RSS | +| --- | --- | --- | --- | +| both in the Overworld | 1.0 ms | 1.3 ms | 1194 MB | +| guest in the Nether (two levels tick) | 2.2 ms | 2.9 ms | 1238 MB | +| guest in the End (the Nether still parked) | 0.9 ms | 1.1 ms | 1324 MB | +| both back, the Nether and End closed after 300 idle ticks | 0.8 ms | 0.9 ms | 1335 MB | + +- A level costs only while a player is in it: its chunks around that player, their entities, and the + tick. With nobody outside the Overworld, `tick_server` runs one pass, as before. +- A closed level's memory goes back to the allocator, not always to the system. +- Entering a level the first time opens its region files and streaming (`open_level`). That cost + comes once, before the player's chunks load. + +## Saving + +`save_game` saves the level in place, then every parked level (`save_parked_levels`). Each level has +its own region folder, as in vanilla (`DIM-1`, `DIM1`). A level closed for being idle is saved first. +Each player's saved data holds its dimension (`Dimension`). A guest who leaves in +the Nether, or whose host saves and quits, joins again in the Nether where it was. + +## What's checked + +`python3 tools/lan_e2e.py --server-thread --check portals --check levels`: + +- `portals`: the guest goes to the Nether through a portal while the host stays. The host then goes + to the End while the guest is in the Nether, so three levels run at once, and both come back. +- `levels`, with the host and the guest each in a level of its own: + - `execute in the_nether run tp` moves the guest alone. + - Mobs and armour stands fall in two levels at once, and every entity id is unique across the + levels. + - The guest leaves in the Nether and joins again there. + - The guest dies in the Nether and respawns in the Overworld. + - The host takes a Nether portal alone. + - The guest takes an End portal and then the exit portal alone. + - The host saves, quits and opens the world again with the guest in the Nether, and the guest + joins again there. + +## Not done yet + +- **End credits for server players.** The first exit from the End should show a player the credits + (`EndPortalBlock.entityInside`, `seenCredits`). The client's WinScreen is #338. +- **Entities through portals between levels.** Mobs, items and minecarts that enter a portal on a + server, and portal tickets (`TeleportTransition.PLACE_PORTAL_TICKET`), are not handled. +- **Unlimited selectors.** `@e` without a distance or volume reads only the source's level. Vanilla's + reads every level. diff --git a/docs/server.md b/docs/server.md index d7959aed0..6a73e768f 100644 --- a/docs/server.md +++ b/docs/server.md @@ -90,7 +90,7 @@ not tick cost, so it is in scope here (see section 9). |---|---| | `online-mode=true` | **Works** (ServerLoginPacketListenerImpl): a 1024-bit RSA key pair at start ("Generating keypair"), the encryption request, the shared secret and challenge, AES/CFB8, and the session service's `hasJoined` check (with the address when `prevent-proxy-connections` is on), with vanilla's log lines and messages. `test_online_mode_parity.py` runs the same logins against vanilla's server and Horizon's with a mock session service. | | Secure chat | **Works** (`SignedMessageChain`, `LastSeenMessagesValidator`, `MessageSignatureCache`): the chat session update and its profile key, checked against the services' `playerCertificateKeys`; signed chat, `say`, `me` and `msg`, relayed with their signatures and last-seen lists; `enforce-secure-profile` (with `online-mode`) refuses unsigned chat; and vanilla's log lines (`[Not Secure]`, the decoder's warnings, the kicks). Offline servers and players without a chat session chat unsigned, as on vanilla. `test_secure_chat_parity.py` runs the same signed and unsigned players against vanilla's server and Horizon's, with test keys and a mock services server. | -| Nether and End | **Players can't change dimension.** The engine keeps one dimension loaded (`Game::enter_dimension` moves only the local single-player player), and the hub serves one `dimension` to everyone. | +| Nether and End | **Works**: the server holds a level per dimension, and each player is in its own (portals, `execute in … tp`, respawn). `test_server_dimension_players_parity.py` checks it against vanilla. How it works, its cost and what's left: [server-levels.md](server-levels.md). | | Refused logins | Logged as vanilla does: `Disconnecting <name> (/address): <reason>`, then `<name> (/address) lost connection: <reason>`, and the session errors (`Username '<name>' tried to join with an invalid session`, `Couldn't verify username because servers are unavailable`). | | Gameplay for remote players | Checked against vanilla's server with a vanilla-codec client (#484, `tools/test_dedicated_server_parity.py`): a right click with an item on a block uses it once, a dead player's commands run, players on a team without friendly fire don't hurt each other, and a player's projectiles are theirs (their ender pearl takes them). The recipe book, status effects and block sync while digging (#500) work. Left: a player's projectiles don't hit other players (no bow PvP between guests), and a mob a guest kills counts in the host's statistics and advancements, not the guest's (`mob_died` runs as the host). | | Defaults that surprise owners | `white-list=true` is vanilla 26.3's default, so a fresh server refuses everyone until they are added. That matches vanilla, so the first-run flow (section 3) asks about the whitelist up front. | diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 9b883b163..304668322 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -67,6 +67,10 @@ address. The script then checks, from both sides, what a guest's game used to ge - portals: (--server-thread) the server holds a level per dimension: the guest goes to the Nether through a portal while the host stays, then the host goes to the End while the guest is in the Nether, and both come back. +- levels: (--server-thread) the host and the guest each in a level of their own: `execute in` builds + and teleports into another level, mobs fall in two levels at once with ids unique across + them, the guest rejoins in the Nether, dies there and respawns in the Overworld, the host + takes a Nether portal alone, the guest takes an End portal and the exit portal alone, and the host saves, quits and reopens with the guest in the Nether. - commands: the guest's chat completes commands and their arguments over the server's command tree (Tab), and runs what it completed; - recipes: the guest's recipe book lists the planks recipe the logs unlock, and clicking it @@ -155,7 +159,7 @@ ROOT = Path(__file__).resolve().parents[1] GUEST_NAME = 'Guest' # The host plays single player on its server thread (--server-thread). SERVER_THREAD = False -CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'levels'] class Game: @@ -525,6 +529,209 @@ def portals(host, guest, out, x, y, z, hx, hy, hz): return {'guest_nether': arrived, 'host_end': [ex, ey, ez], 'back': pos_of(guest)} +NETHER, END, OVERWORLD = 'minecraft:the_nether', 'minecraft:the_end', 'minecraft:overworld' + + +def check_levels(host, guest, out): + """(--server-thread) Each player in its own level (MinecraftServer.levels), the host and the guest + apart: the steps run in order, each reported, and the check fails if any did.""" + if not SERVER_THREAD: + return 'skipped (needs --server-thread)' + start = {g.name: pos_of(g) for g in (host, guest)} + steps, failed = {}, [] + guest('command', command='gamemode creative') + try: + for name, step in LEVEL_STEPS: + try: + steps[name] = step(host, guest, out) + except (Failed, AssertionError, StopIteration, KeyError) as e: + steps[name], failed = repr(e), failed + [name] + for g in (host, guest): + back_to_game(g) + print(f'[lan] levels {name}: {"FAIL" if name in failed else "PASS"} {steps[name]}') + finally: + for g in (host, guest): + back_to_game(g) + if g('state').get('screen') == 'dead': + g.raw('respawn') + g.wait(20) + x, y, z = start[g.name] + g('command', command=f'execute in {OVERWORLD} run tp @s {x:.2f} {y:.2f} {z:.2f}') + guest('command', command='gamemode survival') + guest.wait(40) + assert not failed, f'failed: {failed}; {steps}' + return steps + + +def level_floor(game, x, y, z): + """An obsidian floor under x y z with air above it, in the level `game` is in (fill needs the + chunks loaded: ServerLevel.hasChunksAt).""" + game('command', command=f'fill {x - 4} {y - 1} {z - 4} {x + 4} {y - 1} {z + 4} minecraft:obsidian') + game('command', command=f'fill {x - 4} {y} {z - 4} {x + 4} {y + 4} {z + 4} minecraft:air') + + +def into_level(game, dimension, x, y, z): + """`execute in DIMENSION run tp` to x y z, onto a floor built once the level has loaded around it.""" + game('command', command=f'execute in {dimension} run tp @s {x + 0.5} {y} {z + 0.5}') + state = wait_dimension(game, dimension, 400) + game.wait(20) + level_floor(game, x, y, z) + game('command', command=f'tp @s {x + 0.5} {y} {z + 0.5}') + game.wait(20) + return state + + +def dims(host, guest): + return host('state').get('dimension'), guest('state').get('dimension') + + +def level_execute(host, guest, out): + """`execute in the_nether run tp` takes the guest alone.""" + x, z = (int(v // 1) for v in pos_of(guest)[::2]) + there = into_level(guest, NETHER, x, 100, z) + below = guest.raw('block', x, 99, z) + assert dims(host, guest) == (OVERWORLD, NETHER), f'host, guest in {dims(host, guest)}' + assert there.get('dimension') == NETHER and below.get('block') == 'minecraft:obsidian', f'{there} on {below}' + return {'guest': pos_of(guest)} + + +def level_ticking(host, guest, out): + """Mobs and objects fall in both levels at once (each level with a player ticks); every entity + has its own id across the levels.""" + gx, gy, gz = pos_of(guest) + hx, hy, hz = pos_of(host) + # A floor of its own beside the host (earlier checks may have broken the open one there). + bx, by, bz = int(hx // 1), int(hy // 1), int(hz // 1) + host('command', command=f'fill {bx - 4} {by - 1} {bz - 4} {bx + 4} {by - 1} {bz - 2} minecraft:stone') + host('command', command=f'fill {bx - 4} {by} {bz - 4} {bx + 4} {by + 4} {bz - 2} minecraft:air') + guest('command', command=f'summon minecraft:pig {gx + 2.5:.2f} {gy + 3:.2f} {gz:.2f}') + guest('command', command=f'summon minecraft:armor_stand {gx - 2.5:.2f} {gy + 3:.2f} {gz:.2f}') + host('command', command=f'summon minecraft:pig {hx + 2.5:.2f} {hy + 3:.2f} {hz - 3:.2f}') + host('command', command=f'summon minecraft:armor_stand {hx - 2.5:.2f} {hy + 3:.2f} {hz - 3:.2f}') + try: + guest.wait(60) + seen = {} + for name, g, floor in (('guest', guest, gy), ('host', host, hy)): + mobs = [m for m in g.raw('mobs', 8)['near'] if m['kind'] == 'minecraft:pig'] + stands = [o for o in g('status')['objects'] if o['kind'] == 'minecraft:armor_stand'] + seen[name] = {'pigs': [(m['id'], round(m['pos'][1], 2)) for m in mobs], + 'stands': [(o['id'], round(o['position'][1], 2)) for o in stands], 'floor': floor} + finally: + guest('command', command='kill @e[type=!minecraft:player,distance=..8]') + host('command', command='kill @e[type=!minecraft:player,distance=..8]') + for name, s in seen.items(): + heights = [y for _, y in s['pigs'] + s['stands']] + assert len(s['pigs']) == 1 and len(s['stands']) == 1, f'{name} sees {s}' + assert all(abs(y - s['floor']) < 0.1 for y in heights), f"{name}'s did not fall to the floor: {seen}" + ids = [i for s in seen.values() for i, _ in s['pigs'] + s['stands']] + assert len(set(ids)) == len(ids), f'ids shared across the levels: {seen}' + return seen + + +def level_rejoin(host, guest, out): + """The guest leaves in the Nether and joins again there (its player data keeps its level).""" + before = pos_of(guest) + port = host.raw('lan', 'status')['port'] + guest.raw('disconnect') + time.sleep(2) + guest.raw('connect', f'127.0.0.1:{port}', GUEST_NAME) + guest.raw('wait-for', 'loaded', '--timeout', 300) + guest.wait(20) + after = pos_of(guest) + assert dims(host, guest) == (OVERWORLD, NETHER), f'host, guest in {dims(host, guest)}' + assert all(abs(a - b) < 1 for a, b in zip(before, after)), f'left at {before}, back at {after}' + return {'at': after} + + +def level_death(host, guest, out): + """The guest dies in the Nether and respawns in the Overworld; the host stays where it is.""" + guest('command', command='kill @s') + guest.wait(20) + guest.raw('respawn') + back = wait_dimension(guest, OVERWORLD, 400) + guest.wait(20) + assert back.get('dimension') == OVERWORLD, f'the guest respawned in {back.get("dimension")}' + assert dims(host, guest) == (OVERWORLD, OVERWORLD), f'host, guest in {dims(host, guest)}' + return {'respawned': back['player']['position']} + + +def level_host_nether(host, guest, out): + """The host goes through a Nether portal while the guest stays in the Overworld.""" + hx, hy, hz = (int(v // 1) for v in pos_of(host)) + nether_portal(host, hx, hy, hz - 3) + try: + host('command', command=f'tp @s {hx + 0.5} {hy} {hz - 2.5}') + there = wait_dimension(host, NETHER, 600) + host.wait(20) + result = dims(host, guest) + assert there.get('dimension') == NETHER, f'the host is in {there.get("dimension")}' + assert result == (NETHER, OVERWORLD), f'host, guest in {result}' + return {'host': there['player']['position']} + finally: + host('command', command=f'execute in {OVERWORLD} run fill {hx - 1} {hy} {hz - 3} {hx + 2} {hy + 3} {hz - 3} ' + 'minecraft:air') + host('command', command=f'execute in {OVERWORLD} run tp @s {hx + 0.5} {hy} {hz + 0.5}') + wait_dimension(host, OVERWORLD, 400) + + +def level_guest_end(host, guest, out): + """The guest steps into an End portal alone and lands on the obsidian platform; an exit portal + takes it back to the Overworld.""" + x, y, z = (int(v // 1) for v in pos_of(guest)) + guest('command', command=f'setblock {x + 2} {y} {z} minecraft:end_portal') + try: + guest('command', command=f'tp @s {x + 2.5} {y} {z + 0.5}') + wait_dimension(guest, END, 600) + # The arrival waits for the platform's chunks; its portal cooldown (10 ticks) runs out after, + # and a player who stands in a portal while it runs stays (Entity.setAsInsidePortal). + guest.wait(60) + landed = pos_of(guest) + assert dims(host, guest) == (OVERWORLD, END), f'host, guest in {dims(host, guest)}' + assert [int(v // 1) for v in landed] == [100, 49, 0], f'the guest landed at {landed}' + finally: + guest('command', command=f'execute in {OVERWORLD} run setblock {x + 2} {y} {z} minecraft:air') + ex, ey, ez = (int(v // 1) for v in landed) + guest('command', command=f'setblock {ex + 2} {ey} {ez} minecraft:end_portal') + guest('command', command=f'tp @s {ex + 2.5} {ey} {ez + 0.5}') + home = wait_dimension(guest, OVERWORLD, 600) + guest.wait(20) + assert dims(host, guest) == (OVERWORLD, OVERWORLD), f'host, guest in {dims(host, guest)}' + return {'landed': landed, 'home': home['player']['position']} + + +def level_reload(host, guest, out): + """The host saves and quits with the guest in the Nether, opens the world again and opens it to the + LAN; the guest joins again where it was, in the Nether.""" + x, z = (int(v // 1) for v in pos_of(guest)[::2]) + into_level(guest, NETHER, x, 100, z) + before = pos_of(guest) + host.raw('disconnect') + # The world saves on its server thread before the title screen shows. + for attempt in range(60): + time.sleep(1) + try: + host.raw('open', 'Lan') + break + except Failed: + if attempt == 59: + raise + host('wait_ready', seconds=400) + port = host.raw('lan', 'open', 0, 'commands')['port'] + back_to_game(guest) + guest.raw('connect', f'127.0.0.1:{port}', GUEST_NAME) + guest.raw('wait-for', 'loaded', '--timeout', 300) + guest.wait(20) + after = pos_of(guest) + assert dims(host, guest) == (OVERWORLD, NETHER), f'host, guest in {dims(host, guest)}' + assert all(abs(a - b) < 1 for a, b in zip(before, after)), f'left at {before}, back at {after}' + return {'at': after} + + +LEVEL_STEPS = [('execute', level_execute), ('ticking', level_ticking), ('rejoin', level_rejoin), + ('death', level_death), ('host_nether', level_host_nether), + ('guest_end', level_guest_end), ('reload', level_reload)] + + def check_damage(host, guest, out): guest('command', command='gamemode survival') guest.wait(10) @@ -2591,7 +2798,8 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles, 'blast': check_blast, 'light': check_light, 'plates': check_plates, 'swings': check_swings, 'cracks': check_cracks, - 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict} + 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, + 'levels': check_levels} def run(ctl, out, resources, checks): From 84171cfc94c048807520c426cf9a4af05aaf289f Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 15:19:17 +0200 Subject: [PATCH 014/126] lan_e2e portals: wait for the guest to be placed in its Nether portal On a server the guest is held where it entered the Nether until the chunks around the destination are lit, then placed in its portal. The check read the guest's position 40 ticks after the dimension changed, which on a busy machine was still the held spot, and then stepped the guest out of a portal that wasn't there. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- tools/lan_e2e.py | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 304668322..e781cdea6 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -496,12 +496,17 @@ def portals(host, guest, out, x, y, z, hx, hy, hz): guest('command', command=f'tp @s {x + 0.5} {y} {z + 3.5}') # players_nether_portal_default_delay: 80 ticks in survival. there = wait_dimension(guest, 'minecraft:the_nether', 600) - guest.wait(40) + # On a server the guest is held where it entered until the chunks around the destination are + # lit, then placed in its portal: wait for that before reading where it arrived. + for _ in range(30): + guest.wait(20) + arrived = [int(v // 1) for v in pos_of(guest)] + if guest.raw('block', *arrived).get('block') == 'minecraft:nether_portal': + break guest.shot(out, 'portals-nether') host_dim = host('state').get('dimension') assert there.get('dimension') == 'minecraft:the_nether', f'the guest is in {there.get("dimension")}' assert host_dim == 'minecraft:overworld', f'the host went to {host_dim} with the guest' - arrived = [int(v // 1) for v in pos_of(guest)] below = guest.raw('block', arrived[0], arrived[1] - 1, arrived[2]) assert below.get('loaded') and below.get('block') != 'minecraft:air', f'under the guest in the Nether: {below}' # The host takes an End portal while the guest is in the Nether: three levels at once. From 9fe228cd1e2753e252f40a2f49150779316423cf Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 12:51:16 +0200 Subject: [PATCH 015/126] Server commands run in their source's level (execute in, execute at) On a server (dedicated, or single player's server thread) each dimension is its own level, but a command ran in whichever level was in place. So a guest in the Nether running `execute in minecraft:overworld run setblock ...` got "That position is not loaded", and `execute at <a player in another level>` used the wrong level's blocks. with_source now puts the source's level in place for the command (CommandSourceStack.getLevel), as as_target already does for a player in another level, and puts the old one back after. `execute at` takes the entity's level (withLevel(entity.level())), and a player's level is the guest's own (target_level) even while another level is in place. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game/commands.rs | 32 +++++++++++-------- .../src/game/commands/execute.rs | 14 ++++++-- crates/horizon-client/src/game/levels.rs | 18 +++++++++++ docs/server-levels.md | 4 ++- tools/lan_e2e.py | 29 ++++++++++++++--- 5 files changed, 74 insertions(+), 23 deletions(-) diff --git a/crates/horizon-client/src/game/commands.rs b/crates/horizon-client/src/game/commands.rs index f174f98c1..570a64c09 100644 --- a/crates/horizon-client/src/game/commands.rs +++ b/crates/horizon-client/src/game/commands.rs @@ -294,6 +294,18 @@ impl Game<'_> { } // ---- entities ------------------------------------------------------- + /// The level `t` is in (`Entity.level`): a server's players have their + /// own, which need not be the one in place; everything else is in the + /// level in place. + pub(super) fn target_level(&self, t: Target) -> Dim { + let conn = match t { + Target::Player => self.lan_acting, + Target::Guest(conn) => Some(conn), + _ => None, + }; + conn.and_then(|c| self.command_guest(c)) + .map_or(self.dim, |g| Dim::from_id(&g.dimension)) + } pub(super) fn target_position(&self, t: Target) -> Option<[f64; 3]> { match t { Target::Player => self @@ -1191,15 +1203,12 @@ impl Game<'_> { pos: [f64; 3], rotation: Option<[f32; 2]>, ) -> bool { - let (conn, at) = match t { - Target::Player => (self.lan_acting, self.dim), - Target::Guest(conn) => ( - Some(conn), - self.command_guest(conn) - .map_or(self.dim, |g| super::Dim::from_id(&g.dimension)), - ), - _ => (None, self.dim), + let conn = match t { + Target::Player => self.lan_acting, + Target::Guest(conn) => Some(conn), + _ => None, }; + let at = self.target_level(t); let Some(conn) = conn.filter(|_| at != level && self.options.dedicated.is_some()) else { return false; }; @@ -1222,12 +1231,7 @@ impl Game<'_> { let dest = self.entities(ctx, "destination", false)?[0]; let pos = self.target_position(dest).unwrap_or(self.source_position()); // Into the destination's level. - let level = match dest { - Target::Guest(conn) => self - .command_guest(conn) - .map_or(self.dim, |g| super::Dim::from_id(&g.dimension)), - _ => self.dim, - }; + let level = self.target_level(dest); // TeleportCommand.teleportToEntity: the destination's rotation too. let rotation = Some(self.target_rotation(dest)); for &t in &targets { diff --git a/crates/horizon-client/src/game/commands/execute.rs b/crates/horizon-client/src/game/commands/execute.rs index 221ebb238..463cd542e 100644 --- a/crates/horizon-client/src/game/commands/execute.rs +++ b/crates/horizon-client/src/game/commands/execute.rs @@ -155,14 +155,20 @@ impl Game<'_> { _ => s.pos, } } - /// Evaluate `f` with `source` as the command source. + /// Evaluate `f` with `source` as the command source, in the source's + /// level (`CommandSourceStack.getLevel`): a server puts that level in + /// place for it. pub(in crate::game) fn with_source<T>( &mut self, source: Source, f: impl FnOnce(&mut Self) -> T, ) -> T { let previous = self.command_source.replace(source); + let back = self.enter_command_level(source.dimension); let out = f(self); + if let Some(back) = back { + self.enter_command_level(back); + } self.command_source = previous; out } @@ -447,11 +453,13 @@ impl Game<'_> { "at" => targets(self)? .into_iter() .filter_map(|t| { + // CommandSourceStack.withLevel(entity.level()). + let level = self.target_level(t); Some(Source { pos: self.target_position(t)?, rot: self.target_rotation(t), - dimension: self.dim, - level: None, + dimension: level, + level: (level != self.dim).then_some(level), ..s }) }) diff --git a/crates/horizon-client/src/game/levels.rs b/crates/horizon-client/src/game/levels.rs index 7df5541b4..3b73a2e20 100644 --- a/crates/horizon-client/src/game/levels.rs +++ b/crates/horizon-client/src/game/levels.rs @@ -253,6 +253,24 @@ impl Game<'_> { Ok(()) } + /// Put `dim`'s level in place for a command whose source is there + /// (`execute in`, `execute at` a player in another level), opening it if + /// nobody is in it; returns the level to put back afterwards. Only a + /// server holds other levels. + pub(super) fn enter_command_level(&mut self, dim: Dim) -> Option<Dim> { + if self.options.dedicated.is_none() || dim == self.dim { + return None; + } + let back = self.dim; + match self.enter_level(None, dim) { + Ok(()) => Some(back), + Err(e) => { + log::error!("could not open {}: {e}", dim.id()); + None + } + } + } + /// One server tick (`MinecraftServer.tickServer`): each level with /// players in turn (`tickChildren`), its chunks streamed and loaded and /// its world ticked. The first pass reads the network and runs the diff --git a/docs/server-levels.md b/docs/server-levels.md index 0190c0c03..45fbf03e3 100644 --- a/docs/server-levels.md +++ b/docs/server-levels.md @@ -20,6 +20,7 @@ the other dimensions' levels as `Parked` values and swaps one into place (`enter | `ServerPlayer.teleport` into another level | `server_travel.rs`: a Respawn packet, then the teleport once the destination has loaded (portals and `execute in … tp`) | | `PlayerList.respawn` | `guest_respawn`: back into the Overworld's level | | `ServerLevel.noPlayersEmptyTime`, chunk unloading | `close_idle_levels`: a level other than the Overworld with nobody in it for 300 ticks is saved and closed | +| `CommandSourceStack.getLevel` | `with_source` puts the source's level in place for a command (`execute in`, `execute at` a player in another level) | | the levels' shared `LevelData` | not swapped: game time, day time, weather, game rules, scoreboard, maps, entity ids (`next_entity`, unique across levels) | The packets of a guest are read in its own level's pass (`Hub::tick_level`), so its actions and @@ -70,7 +71,8 @@ the Nether, or whose host saves and quits, joins again in the Nether where it wa - `portals`: the guest goes to the Nether through a portal while the host stays. The host then goes to the End while the guest is in the Nether, so three levels run at once, and both come back. - `levels`, with the host and the guest each in a level of its own: - - `execute in the_nether run tp` moves the guest alone. + - `execute in the_nether run tp` moves the guest alone. From the Nether, `execute in overworld` and + `execute at` the host change and test blocks in the host's level. - Mobs and armour stands fall in two levels at once, and every entity id is unique across the levels. - The guest leaves in the Nether and joins again there. diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index e781cdea6..66297b909 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -67,10 +67,12 @@ address. The script then checks, from both sides, what a guest's game used to ge - portals: (--server-thread) the server holds a level per dimension: the guest goes to the Nether through a portal while the host stays, then the host goes to the End while the guest is in the Nether, and both come back. -- levels: (--server-thread) the host and the guest each in a level of their own: `execute in` builds - and teleports into another level, mobs fall in two levels at once with ids unique across - them, the guest rejoins in the Nether, dies there and respawns in the Overworld, the host - takes a Nether portal alone, the guest takes an End portal and the exit portal alone, and the host saves, quits and reopens with the guest in the Nether. +- levels: (--server-thread) the host and the guest each in a level of their own: `execute in` + teleports into another level, and `execute in` and `at` change and test blocks there; + mobs fall in two levels at once, with ids unique across them; the guest rejoins in the + Nether, dies there and respawns in the Overworld; the host takes a Nether portal alone; + the guest takes an End portal and the exit portal alone; and the host saves, quits and + reopens with the guest in the Nether. - commands: the guest's chat completes commands and their arguments over the server's command tree (Tab), and runs what it completed; - recipes: the guest's recipe book lists the planks recipe the logs unlock, and clicking it @@ -591,12 +593,29 @@ def dims(host, guest): def level_execute(host, guest, out): - """`execute in the_nether run tp` takes the guest alone.""" + """`execute in the_nether run tp` takes the guest alone. From the Nether, the guest's commands + reach the host's level (CommandSourceStack.getLevel): `execute in overworld` and `execute at` + the host put a block beside the host, and `execute if block` reads it.""" x, z = (int(v // 1) for v in pos_of(guest)[::2]) + hx, hy, hz = (int(v // 1) for v in pos_of(host)) there = into_level(guest, NETHER, x, 100, z) below = guest.raw('block', x, 99, z) + gold = f'{hx} {hy} {hz + 2} minecraft:gold_block' + try: + guest('command', command=f'execute in {OVERWORLD} run setblock {gold}') + guest('command', command=f'execute at {host.player} run setblock ~ ~ ~-2 minecraft:diamond_block') + guest('command', command=f'execute in {OVERWORLD} if block {gold} in {NETHER} ' + f'run setblock {x} 99 {z} minecraft:gold_block') + host.wait(10) + placed = [host.raw('block', hx, hy, hz + 2), host.raw('block', hx, hy, hz - 2)] + found = guest.raw('block', x, 99, z) + finally: + host('command', command=f'fill {hx} {hy} {hz - 2} {hx} {hy} {hz + 2} minecraft:air') assert dims(host, guest) == (OVERWORLD, NETHER), f'host, guest in {dims(host, guest)}' assert there.get('dimension') == NETHER and below.get('block') == 'minecraft:obsidian', f'{there} on {below}' + assert [p.get('block') for p in placed] == ['minecraft:gold_block', 'minecraft:diamond_block'], \ + f'beside the host: {placed}' + assert found.get('block') == 'minecraft:gold_block', f'execute in overworld if block: {found}' return {'guest': pos_of(guest)} From 86fdc720696f99f591b8f1519aedbab56340577d Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 12:51:16 +0200 Subject: [PATCH 016/126] Server players go through End gateways handle_server_portal ignored End gateways, so on a server (dedicated, or single player's server thread) no player could use one: the in-frame game's gateway code moved only its own player. A gateway that is not cooling down now takes a server player at once (EndGatewayBlock.entityInside, triggerCooldown, setAsInsidePortal), within the End, keeping its motion and look (Relative.DELTA and ROTATION). An exact exit is reached straight away; otherwise the player waits at the destination while it loads, and the exit is found or built there (the in-frame resolve_gateway, shared through gateway_job). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game/end.rs | 26 ++++++--- .../horizon-client/src/game/server_travel.rs | 57 ++++++++++++++++++- crates/horizon-client/src/lan/hub.rs | 21 ++++++- docs/server-levels.md | 4 +- tools/lan_e2e.py | 31 ++++++++-- 5 files changed, 117 insertions(+), 22 deletions(-) diff --git a/crates/horizon-client/src/game/end.rs b/crates/horizon-client/src/game/end.rs index a7813c767..08eb8ad33 100644 --- a/crates/horizon-client/src/game/end.rs +++ b/crates/horizon-client/src/game/end.rs @@ -23,7 +23,7 @@ const GATEWAY_FILE: &str = "horizon-end-gateways.json"; /// A gateway teleport waiting for its destination chunks. #[derive(Clone, Copy, Debug)] -enum GatewayJob { +pub(super) enum GatewayJob { /// TheEndGatewayBlockEntity.findOrCreateValidTeleportPos from this gateway. Find { gateway: [i32; 3] }, /// A known exit (exact, or findExitPosition around it). @@ -735,6 +735,20 @@ impl Game<'_> { fn enter_gateway(&mut self, gateway: [i32; 3]) -> Result<()> { // TheEndGatewayBlockEntity.triggerCooldown: 40 ticks. self.end.gateway_cooldown = 40; + let (job, destination) = self.gateway_job(gateway); + let Some(player) = self.player.take() else { + return Ok(()); + }; + self.end.job = Some(job); + self.end_travel = true; + self.travelling = Some((player, destination)); + Ok(()) + } + + /// Where `gateway` leads (TheEndGatewayBlockEntity.getPortalPosition): + /// its exit, or the search for one, and the spot to load before either + /// is resolved ([`Game::resolve_gateway`]). + pub(super) fn gateway_job(&mut self, gateway: [i32; 3]) -> (GatewayJob, Vec3) { let known = self.gateway_exits().get(&gateway).copied(); let job = match known { Some((exit, exact)) => GatewayJob::Known { exit, exact }, @@ -760,13 +774,7 @@ impl Game<'_> { Vec3::new(d.x, 75.0, d.y) } }; - let Some(player) = self.player.take() else { - return Ok(()); - }; - self.end.job = Some(job); - self.end_travel = true; - self.travelling = Some((player, destination)); - Ok(()) + (job, destination) } fn chunk_empty(&self, x: f64, z: f64) -> Option<bool> { @@ -803,7 +811,7 @@ impl Game<'_> { /// The teleport position of a gateway job, creating the exit gateway (and /// an island when the chunk has no landing spot) for new destinations. - fn resolve_gateway(&mut self, job: GatewayJob, target: Vec3) -> Result<Vec3> { + pub(super) fn resolve_gateway(&mut self, job: GatewayJob, target: Vec3) -> Result<Vec3> { let bottom_center = |p: [i32; 3]| { Vec3::new( f64::from(p[0]) + 0.5, diff --git a/crates/horizon-client/src/game/server_travel.rs b/crates/horizon-client/src/game/server_travel.rs index 1d857c1fe..b7462baa8 100644 --- a/crates/horizon-client/src/game/server_travel.rs +++ b/crates/horizon-client/src/game/server_travel.rs @@ -7,6 +7,7 @@ //! another level: a Respawn packet keeping all data, then a teleport to the //! exit once the destination has loaded around them. +use super::end::GatewayJob; use super::nether_portal::{PLAYER_DELAY, Plan}; use super::{Dim, Game, lan::LanHost}; use horizon_client::lan::hub::TickCtx; @@ -22,6 +23,9 @@ pub(super) struct Trip { end: bool, /// The Nether portal plan, whose exit is found or built on arrival. plan: Option<Plan>, + /// Through an End gateway, within the level: its exit, found or built + /// on arrival. + gateway: Option<GatewayJob>, /// Sent by a command: the player is already where it goes. placed: bool, } @@ -95,7 +99,7 @@ impl Game<'_> { if let Some(pos) = self.nether_portal_inside(at) { self.portals.player.set_inside(pos, PLAYER_DELAY); } - let (end_portal, _) = self.inside_end_portals(at, WIDTH, HEIGHT); + let (end_portal, gateway) = self.inside_end_portals(at, WIDTH, HEIGHT); if end_portal { if self.portals.player.cooldown == 0 { let target = if self.dim == Dim::End { @@ -109,6 +113,19 @@ impl Game<'_> { self.portals.player.cooldown = 10; return; } + // EndGatewayBlock.entityInside: a gateway that is not cooling down + // takes the player at once (no transition time) and cools down + // (triggerCooldown), even for a player still on its own cooldown. + if let Some(g) = gateway + && self.gateway_enter(g) + { + if self.portals.player.cooldown == 0 { + self.start_gateway_trip(host, conn, g); + } + // setPortalCooldown: after the trip, or again while cooling down. + self.portals.player.cooldown = 10; + return; + } let rule = if invulnerable { "players_nether_portal_creative_delay" } else { @@ -197,6 +214,7 @@ impl Game<'_> { target: destination, end, plan, + gateway: None, placed: false, }); if let Err(e) = self.enter_level(Some(host), source) { @@ -204,6 +222,32 @@ impl Game<'_> { } } + /// `TheEndGatewayBlockEntity.getPortalPosition` and the teleport within + /// the End (keeping the player's motion and look): straight to an exact + /// exit, else once the destination has loaded around the player, who + /// waits there (its exit is found among those blocks, or built). + fn start_gateway_trip(&mut self, host: &mut LanHost, conn: u32, gateway: [i32; 3]) { + let Some(i) = host.hub.guests.iter().position(|g| g.conn == conn) else { + return; + }; + let (job, destination) = self.gateway_job(gateway); + let at = [destination.x, destination.y, destination.z]; + // Relative.union(DELTA, ROTATION). + host.hub.teleport_keeping_motion(i, at); + if let GatewayJob::Known { exact: true, .. } = job { + return; + } + self.server_trips.push(Trip { + conn, + dim: self.dim, + target: destination, + end: false, + plan: None, + gateway: Some(job), + placed: false, + }); + } + /// The trips into the level in place whose destination has loaded /// around their target: the exit (the Nether portal found or built, the /// End platform, the Overworld's spawn column) and the teleport there. @@ -232,7 +276,15 @@ impl Game<'_> { } self.resolve_arrivals(); let yaw = host.hub.guests[i].yaw; - let (position, yaw) = if trip.end { + let (position, yaw) = if let Some(job) = trip.gateway { + match self.resolve_gateway(job, trip.target) { + Ok(at) => (at, yaw), + Err(e) => { + log::error!("End gateway exit: {e}"); + (trip.target, yaw) + } + } + } else if trip.end { match self.end_arrival(trip.target) { Ok((at, turned)) => (at, turned.unwrap_or(yaw)), Err(e) => { @@ -293,6 +345,7 @@ impl Game<'_> { target: Vec3::new(t.at[0], t.at[1], t.at[2]), end: false, plan: None, + gateway: None, placed: true, }); if let Err(e) = self.enter_level(Some(host), source) { diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index af0c1ac83..5be044e5d 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -818,6 +818,20 @@ impl Hub { /// ServerGamePacketListenerImpl.teleport: move the client and wait for its confirmation. pub fn teleport(&mut self, i: usize, position: Option<[f64; 3]>) { + self.teleport_relative(i, position, 0); + } + + /// A teleport to `position` that keeps the player's motion and look + /// (`Relative.DELTA` and `Relative.ROTATION`: an End gateway's). + pub fn teleport_keeping_motion(&mut self, i: usize, position: [f64; 3]) { + use play::relative::{DELTA_X, DELTA_Y, DELTA_Z, ROTATE_DELTA, X_ROT, Y_ROT}; + let relatives = Y_ROT | X_ROT | DELTA_X | DELTA_Y | DELTA_Z | ROTATE_DELTA; + self.teleport_relative(i, Some(position), relatives); + } + + /// ServerGamePacketListenerImpl.teleport with `relatives`: the rotation + /// and motion they name are sent as zero changes. + fn teleport_relative(&mut self, i: usize, position: Option<[f64; 3]>, relatives: i32) { let ticks = self.ticks; let g = &mut self.guests[i]; g.teleport_tick = ticks; @@ -828,13 +842,14 @@ impl Hub { g.teleport_counter = (g.teleport_counter + 1) & 0x7FFF_FFFF; let id = g.teleport_counter; g.awaiting_teleport = Some((id, g.position)); + let turn = relatives & (play::relative::Y_ROT | play::relative::X_ROT) != 0; g.send(&C::PlayerPosition(play::PlayerPosition { teleport: id, position: g.position, delta: [0.0; 3], - yaw: g.yaw, - pitch: g.pitch, - relatives: 0, + yaw: if turn { 0.0 } else { g.yaw }, + pitch: if turn { 0.0 } else { g.pitch }, + relatives, })); } diff --git a/docs/server-levels.md b/docs/server-levels.md index 45fbf03e3..eee730f89 100644 --- a/docs/server-levels.md +++ b/docs/server-levels.md @@ -17,7 +17,7 @@ the other dimensions' levels as `Parked` values and swaps one into place (`enter | `MinecraftServer.levels` | the level in place plus `Levels::parked` | | `MinecraftServer.tickChildren`, every level | `tick_server`: each level with a player in it, in Overworld, Nether, End order. The first pass reads the network and runs the shared parts (clock, weather, functions, autosave). | | `ServerLevel.players` | `Hub::here`: the guests whose `dimension` is the level in place | -| `ServerPlayer.teleport` into another level | `server_travel.rs`: a Respawn packet, then the teleport once the destination has loaded (portals and `execute in … tp`) | +| `ServerPlayer.teleport` into another level | `server_travel.rs`: a Respawn packet, then the teleport once the destination has loaded (portals and `execute in … tp`). An End gateway teleports within the End. | | `PlayerList.respawn` | `guest_respawn`: back into the Overworld's level | | `ServerLevel.noPlayersEmptyTime`, chunk unloading | `close_idle_levels`: a level other than the Overworld with nobody in it for 300 ticks is saved and closed | | `CommandSourceStack.getLevel` | `with_source` puts the source's level in place for a command (`execute in`, `execute at` a player in another level) | @@ -78,7 +78,7 @@ the Nether, or whose host saves and quits, joins again in the Nether where it wa - The guest leaves in the Nether and joins again there. - The guest dies in the Nether and respawns in the Overworld. - The host takes a Nether portal alone. - - The guest takes an End portal and then the exit portal alone. + - The guest takes an End portal, an End gateway and then the exit portal alone. - The host saves, quits and opens the world again with the guest in the Nether, and the guest joins again there. diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 66297b909..ddbec78af 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -71,8 +71,8 @@ address. The script then checks, from both sides, what a guest's game used to ge teleports into another level, and `execute in` and `at` change and test blocks there; mobs fall in two levels at once, with ids unique across them; the guest rejoins in the Nether, dies there and respawns in the Overworld; the host takes a Nether portal alone; - the guest takes an End portal and the exit portal alone; and the host saves, quits and - reopens with the guest in the Nether. + the guest takes an End portal, an End gateway and the exit portal alone; and the host + saves, quits and reopens with the guest in the Nether. - commands: the guest's chat completes commands and their arguments over the server's command tree (Tab), and runs what it completed; - recipes: the guest's recipe book lists the planks recipe the logs unlock, and clicking it @@ -699,8 +699,8 @@ def level_host_nether(host, guest, out): def level_guest_end(host, guest, out): - """The guest steps into an End portal alone and lands on the obsidian platform; an exit portal - takes it back to the Overworld.""" + """The guest steps into an End portal alone and lands on the obsidian platform, an End gateway + takes it across the End, and an exit portal takes it back to the Overworld.""" x, y, z = (int(v // 1) for v in pos_of(guest)) guest('command', command=f'setblock {x + 2} {y} {z} minecraft:end_portal') try: @@ -714,13 +714,32 @@ def level_guest_end(host, guest, out): assert [int(v // 1) for v in landed] == [100, 49, 0], f'the guest landed at {landed}' finally: guest('command', command=f'execute in {OVERWORLD} run setblock {x + 2} {y} {z} minecraft:air') - ex, ey, ez = (int(v // 1) for v in landed) + # A gateway far out with an exact exit at the End spawn, as end_gateway_return's + # (TheEndGatewayBlockEntity.getPortalPosition), takes the guest back there within the End. + guest('command', command='tp @s 700.5 80 0.5') + guest.wait(60) + level_floor(guest, 700, 80, 0) + guest('command', command='tp @s 700.5 80 0.5') + guest.wait(20) + guest('command', command='setblock 702 80 0 minecraft:end_gateway{exit_portal:[I;100,50,0],exact_teleport:1b}') + guest('command', command='tp @s 702.5 80 0.5') + gateway = None + for _ in range(20): + guest.wait(10) + gateway = pos_of(guest) + if abs(gateway[0] - 702.5) > 50: + break + assert dims(host, guest) == (OVERWORLD, END), f'host, guest in {dims(host, guest)}' + assert abs(gateway[0] - 100.5) < 1 and abs(gateway[2] - 0.5) < 1 and 49 <= gateway[1] <= 50, \ + f'the gateway left the guest at {gateway}' + guest.wait(40) + ex, ey, ez = (int(v // 1) for v in pos_of(guest)) guest('command', command=f'setblock {ex + 2} {ey} {ez} minecraft:end_portal') guest('command', command=f'tp @s {ex + 2.5} {ey} {ez + 0.5}') home = wait_dimension(guest, OVERWORLD, 600) guest.wait(20) assert dims(host, guest) == (OVERWORLD, OVERWORLD), f'host, guest in {dims(host, guest)}' - return {'landed': landed, 'home': home['player']['position']} + return {'landed': landed, 'gateway': gateway, 'home': home['player']['position']} def level_reload(host, guest, out): From 2ced9a451dcb900d73719308e86d740fd923306f Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 12:51:16 +0200 Subject: [PATCH 017/126] Server players respawn at their point in the Nether (anchors, spawnpoint) A server's player (a LAN guest, and since the server thread the single player too) always respawned in the Overworld. Its respawn anchor was dropped when its action ended, and its save kept only an Overworld point. - The guest keeps a respawn point outside the Overworld (respawn_elsewhere, saved as the player's `respawn`) and has it in place while it acts, so an anchor it uses is its own. - guest_respawn respawns it in that point's level, waits there for the chunks, then resolves the point through its block (findRespawnAndUseSpawnBlock): beside the anchor, using a charge, or the world spawn and block.minecraft.spawn.not_valid when the block is gone. - `spawnpoint` in another level than the Overworld sets a forced point there (SetSpawnCommand) instead of Overworld coordinates, and a forced point that is no anchor holds where a player fits (isPossibleToRespawnInThis), in the window's own game too. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 19 ++--- crates/horizon-client/src/game/commands.rs | 23 ++++-- crates/horizon-client/src/game/lan_actions.rs | 43 ++++++++--- .../horizon-client/src/game/respawn_anchor.rs | 41 +++++++++- .../horizon-client/src/game/server_travel.rs | 77 ++++++++++++++++++- crates/horizon-client/src/lan/guest.rs | 5 ++ crates/horizon-client/src/lan/playerdata.rs | 2 + docs/server-levels.md | 5 +- tools/lan_e2e.py | 48 +++++++++++- 9 files changed, 224 insertions(+), 39 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index f706e9348..04c8d5ed1 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -7437,16 +7437,11 @@ impl Game<'_> { self.sleep_timer = 0; self.spawn = None; self.respawn_travel = None; - self.respawn_config = - self.level - .respawn_elsewhere - .as_ref() - .map(|(dim, pos, yaw, forced)| respawn_anchor::RespawnConfig { - dim: Dim::from_id(dim), - pos: *pos, - yaw: *yaw, - forced: *forced, - }); + self.respawn_config = self + .level + .respawn_elsewhere + .as_ref() + .map(respawn_anchor::RespawnConfig::from_saved); self.spawn_origin = None; self.spawn_spiral = Default::default(); self.player_spawn = None; @@ -9424,9 +9419,7 @@ impl Game<'_> { level.weather = self.world.weather; level.day_time = self.world.day_time; level.spawn = self.spawn.map(|s| [s.x, s.y, s.z]); - level.respawn_elsewhere = self - .respawn_config - .map(|c| (c.dim.id().to_owned(), c.pos, c.yaw, c.forced)); + level.respawn_elsewhere = self.respawn_config.map(|c| c.saved()); level.rotation = [self.yaw, self.pitch]; level.xp_level = self.experience.level; level.xp_progress = self.experience.progress; diff --git a/crates/horizon-client/src/game/commands.rs b/crates/horizon-client/src/game/commands.rs index 570a64c09..c6877a839 100644 --- a/crates/horizon-client/src/game/commands.rs +++ b/crates/horizon-client/src/game/commands.rs @@ -2285,12 +2285,23 @@ impl Game<'_> { }; let yaw = ((rot[0] + 180.0).rem_euclid(360.0)) - 180.0; let pitch = rot[1].clamp(-90.0, 90.0); - self.spawn = Some(Vec3::new( - f64::from(pos[0]) + 0.5, - f64::from(pos[1]), - f64::from(pos[2]) + 0.5, - )); - self.respawn_config = None; + // SetSpawnCommand: a forced point in the source's level. + if self.dim == Dim::Overworld { + self.spawn = Some(Vec3::new( + f64::from(pos[0]) + 0.5, + f64::from(pos[1]), + f64::from(pos[2]) + 0.5, + )); + self.respawn_config = None; + } else { + self.spawn = None; + self.respawn_config = Some(super::respawn_anchor::RespawnConfig { + dim: self.dim, + pos, + yaw, + forced: true, + }); + } let dim = Text::literal(self.dim.id()); let p = pos.map(|v| Text::literal(v.to_string())); let mut args = vec![ diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index bc224da9e..60a403871 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -5,7 +5,7 @@ //! blocks, attacking and the commands all behave exactly as they do for the //! host, and every world change they cause reaches all players through the //! block log, the level events and the entity tracker. -use super::{Game, GuestUse, Hit, Mining, Screen, lan::LanHost}; +use super::{Game, GuestUse, Hit, Mining, Screen, lan::LanHost, respawn_anchor::RespawnConfig}; use horizon_client::{ command::vanilla, containers::BlockEntity, @@ -303,6 +303,7 @@ impl Game<'_> { g.spawn.map(|s| Vec3::new(s[0], s[1], s[2])), ); let respawn = (self.respawn_config.take(), self.level.spawn); + self.respawn_config = g.respawn_elsewhere.as_ref().map(RespawnConfig::from_saved); let message = self.message.take(); // The guest's own ender inventory; one the host has open goes back // into the host's while the guest acts. @@ -464,7 +465,8 @@ impl Game<'_> { let bed = std::mem::replace(&mut self.sleeping, sleeping); let guest_sleep_timer = std::mem::replace(&mut self.sleep_timer, sleep_timer); let guest_spawn = std::mem::replace(&mut self.spawn, spawn).map(|s| [s.x, s.y, s.z]); - (self.respawn_config, self.level.spawn) = respawn; + let guest_respawn = std::mem::replace(&mut self.respawn_config, respawn.0); + self.level.spawn = respawn.1; // ServerPlayer.displayClientMessage(_, true): the guest's action bar. let guest_message = std::mem::replace(&mut self.message, message); self.riding = riding; @@ -493,6 +495,7 @@ impl Game<'_> { let g = &mut host.hub.guests[i]; let fell_asleep = bed.is_some() && g.bed.is_none(); (g.bed, g.sleep_timer, g.spawn) = (bed, guest_sleep_timer, guest_spawn); + g.respawn_elsewhere = guest_respawn.map(|c| c.saved()); g.sleeping = g.bed.is_some(); if let Some((text, _)) = guest_message { g.send(&C::SystemChat(play::SystemChat { @@ -1417,17 +1420,32 @@ impl Game<'_> { if !host.hub.guests[i].dead { return; } - // PlayerList.respawn: a server's player comes back in the Overworld, - // where the world spawn is (respawn anchors and beds aside). + // PlayerList.respawn: a server's player comes back in its respawn + // point's level: the Overworld, where the world spawn and beds are, + // or another one's anchor or forced point, which its block resolves + // once the level has loaded around it. + let server = self.options.dedicated.is_some(); + let elsewhere = host.hub.guests[i] + .respawn_elsewhere + .as_ref() + .filter(|_| server) + .map(RespawnConfig::from_saved); + let level = elsewhere.map_or(super::Dim::Overworld, |c| c.dim); + let spawn = elsewhere.map_or(spawn, |c| { + [ + f64::from(c.pos[0]) + 0.5, + f64::from(c.pos[1]), + f64::from(c.pos[2]) + 0.5, + ] + }); let back = self.dim; - let away = self.options.dedicated.is_some() - && host.hub.guests[i].dimension != super::Dim::Overworld.id(); - if away { + let away = server && host.hub.guests[i].dimension != level.id(); + if server { self.server_trips.retain(|t| !t.is(conn)); - if let Err(e) = self.enter_level(Some(host), super::Dim::Overworld) { - log::error!("could not open the Overworld: {e}"); - return; - } + } + if away && let Err(e) = self.enter_level(Some(host), level) { + log::error!("could not open {}: {e}", level.id()); + return; } let g = &mut host.hub.guests[i]; g.dead = false; @@ -1466,6 +1484,9 @@ impl Game<'_> { collision: Some(self.collision), }; host.hub.respawn(i, spawn, &ctx); + if let Some(config) = elsewhere { + self.respawn_trip(conn, config); + } if away && let Err(e) = self.enter_level(Some(host), back) { log::error!("could not reopen {}: {e}", back.id()); } diff --git a/crates/horizon-client/src/game/respawn_anchor.rs b/crates/horizon-client/src/game/respawn_anchor.rs index 4604c076f..9b6ecc203 100644 --- a/crates/horizon-client/src/game/respawn_anchor.rs +++ b/crates/horizon-client/src/game/respawn_anchor.rs @@ -31,6 +31,24 @@ pub(super) struct RespawnConfig { pub forced: bool, } +/// A respawn point as a player's save keeps it (`respawn`): dimension, +/// block, yaw and whether it is forced. +pub(super) type SavedRespawn = (String, [i32; 3], f32, bool); + +impl RespawnConfig { + pub(super) fn from_saved((dim, pos, yaw, forced): &SavedRespawn) -> Self { + Self { + dim: Dim::from_id(dim), + pos: *pos, + yaw: *yaw, + forced: *forced, + } + } + pub(super) fn saved(&self) -> SavedRespawn { + (self.dim.id().to_owned(), self.pos, self.yaw, self.forced) + } +} + /// `RespawnAnchorBlock.RESPAWN_HORIZONTAL_OFFSETS`, then the same a block /// below, a block above, and straight above. const HORIZONTAL: [[i32; 3]; 8] = [ @@ -415,6 +433,16 @@ impl Game<'_> { let (lz, hz) = (bounds.min(Axis::Z), bounds.max(Axis::Z) - 1.0e-5); (self.border.contains(lo, lz) && self.border.contains(hi, hz)).then_some(position) } + /// `Block.isPossibleToRespawnInThis`: neither solid nor liquid; banners, + /// signs and pressure plates override it to always. + fn possible_to_respawn_in(&self, state: BlockStateId) -> bool { + let f = self.res.facts().get(state); + let name = &*f.name; + name.ends_with("_banner") + || name.ends_with("_sign") + || name.ends_with("_pressure_plate") + || !(f.legacy_solid || matches!(name, "minecraft:water" | "minecraft:lava")) + } /// `RespawnAnchorBlock.findStandUpPosition`: a safe spot around the /// anchor, else any spot. pub(super) fn anchor_stand_up(&self, pos: [i32; 3]) -> Option<Vec3> { @@ -428,8 +456,9 @@ impl Game<'_> { } None } - /// `ServerPlayer.findRespawnAndUseSpawnBlock` for an anchor config in the - /// loaded dimension: the position and yaw, using a charge. + /// `ServerPlayer.findRespawnAndUseSpawnBlock` for a config in the loaded + /// dimension: the position and yaw, using an anchor's charge. A forced + /// point (`spawnpoint`) that is no anchor holds if a player fits in it. pub(super) fn find_respawn_and_use( &mut self, c: RespawnConfig, @@ -440,7 +469,13 @@ impl Game<'_> { && (c.forced || self.anchor_charges(state) > 0) && self.anchor_works()) { - return Ok(None); + let [x, y, z] = c.pos; + let free = c.forced + && !self.is_anchor(state) + && self.possible_to_respawn_in(state) + && self.possible_to_respawn_in(self.world.block(x, y + 1, z)); + let at = Vec3::new(f64::from(x) + 0.5, f64::from(y) + 0.1, f64::from(z) + 0.5); + return Ok(free.then_some((at, c.yaw))); } let stand = self.anchor_stand_up(c.pos); if !c.forced diff --git a/crates/horizon-client/src/game/server_travel.rs b/crates/horizon-client/src/game/server_travel.rs index b7462baa8..1b1ec3a6d 100644 --- a/crates/horizon-client/src/game/server_travel.rs +++ b/crates/horizon-client/src/game/server_travel.rs @@ -9,8 +9,9 @@ use super::end::GatewayJob; use super::nether_portal::{PLAYER_DELAY, Plan}; +use super::respawn_anchor::RespawnConfig; use super::{Dim, Game, lan::LanHost}; -use horizon_client::lan::hub::TickCtx; +use horizon_client::{lan::hub::TickCtx, text::Text}; use horizon_core::{geometry::Vec3, position::BlockPos}; /// A trip under way: the player is in the destination's level, whose @@ -26,6 +27,9 @@ pub(super) struct Trip { /// Through an End gateway, within the level: its exit, found or built /// on arrival. gateway: Option<GatewayJob>, + /// A respawn at this point outside the Overworld, resolved through its + /// block on arrival. + respawn: Option<RespawnConfig>, /// Sent by a command: the player is already where it goes. placed: bool, } @@ -215,6 +219,7 @@ impl Game<'_> { end, plan, gateway: None, + respawn: None, placed: false, }); if let Err(e) = self.enter_level(Some(host), source) { @@ -222,6 +227,64 @@ impl Game<'_> { } } + /// A respawned player waits at its point outside the Overworld for the + /// level to load around it. + pub(super) fn respawn_trip(&mut self, conn: u32, config: RespawnConfig) { + let [x, y, z] = config.pos; + self.server_trips.push(Trip { + conn, + dim: config.dim, + target: Vec3::new(f64::from(x) + 0.5, f64::from(y), f64::from(z) + 0.5), + end: false, + plan: None, + gateway: None, + respawn: Some(config), + placed: false, + }); + } + + /// `findRespawnAndUseSpawnBlock` for the player in place, at its point + /// in the level in place: where it stands up, facing the anchor, with + /// the deplete sound; else the point is forgotten + /// (`block.minecraft.spawn.not_valid`). + fn resolve_server_respawn(&mut self, config: RespawnConfig) -> Option<(Vec3, f32)> { + match self.find_respawn_and_use(config, true) { + Ok(Some((at, yaw))) => { + if !config.forced { + let [x, y, z] = config.pos.map(f64::from); + self.audio.play( + "minecraft:block.respawn_anchor.deplete", + Some([x, y, z]), + 1.0, + 1.0, + ); + } + Some((at, yaw)) + } + Ok(None) | Err(_) => { + self.respawn_config = None; + self.system_message(Text::translate("block.minecraft.spawn.not_valid", &[])); + None + } + } + } + + /// TeleportTransition.missingRespawnBlock: the world spawn, in the + /// Overworld. + fn respawn_at_world_spawn(&mut self, host: &mut LanHost, conn: u32) { + let at = self.level.world_spawn.map_or( + self.spawn.map_or([0.5, 80.0, 0.5], |s| [s.x, s.y, s.z]), + |[x, y, z]| [f64::from(x) + 0.5, f64::from(y), f64::from(z) + 0.5], + ); + self.level_teleports.push(LevelTeleport { + conn, + dim: Dim::Overworld, + at, + rotation: None, + }); + self.run_level_teleports(host); + } + /// `TheEndGatewayBlockEntity.getPortalPosition` and the teleport within /// the End (keeping the player's motion and look): straight to an exact /// exit, else once the destination has loaded around the player, who @@ -244,6 +307,7 @@ impl Game<'_> { end: false, plan: None, gateway: Some(job), + respawn: None, placed: false, }); } @@ -276,7 +340,15 @@ impl Game<'_> { } self.resolve_arrivals(); let yaw = host.hub.guests[i].yaw; - let (position, yaw) = if let Some(job) = trip.gateway { + let (position, yaw) = if let Some(config) = trip.respawn { + match self.as_guest(host, trip.conn, |g| g.resolve_server_respawn(config)) { + Some(Some(found)) => found, + _ => { + self.respawn_at_world_spawn(host, trip.conn); + continue; + } + } + } else if let Some(job) = trip.gateway { match self.resolve_gateway(job, trip.target) { Ok(at) => (at, yaw), Err(e) => { @@ -346,6 +418,7 @@ impl Game<'_> { end: false, plan: None, gateway: None, + respawn: None, placed: true, }); if let Err(e) = self.enter_level(Some(host), source) { diff --git a/crates/horizon-client/src/lan/guest.rs b/crates/horizon-client/src/lan/guest.rs index 4be5aa29f..6f939ac9d 100644 --- a/crates/horizon-client/src/lan/guest.rs +++ b/crates/horizon-client/src/lan/guest.rs @@ -86,6 +86,10 @@ pub struct Guest { /// Where the player respawns (a bed's spot; `ServerPlayer.respawnConfig`), /// None for the world spawn. pub spawn: Option<[f64; 3]>, + /// A respawn point outside the Overworld (a respawn anchor, or one + /// `spawnpoint` set there): its dimension, block, yaw and whether it is + /// forced, as the player's save keeps it (`respawn`). + pub respawn_elsewhere: Option<(String, [i32; 3], f32, bool)>, /// Pending ClientboundPlayerPositionPacket id; movement is ignored until /// the client accepts it (ServerGamePacketListenerImpl.awaitingPositionFromClient). pub awaiting_teleport: Option<(i32, [f64; 3])>, @@ -242,6 +246,7 @@ impl Guest { sleep_timer: 0, sent_bed: None, spawn: None, + respawn_elsewhere: None, awaiting_teleport: None, teleport_counter: 0, teleport_tick: 0, diff --git a/crates/horizon-client/src/lan/playerdata.rs b/crates/horizon-client/src/lan/playerdata.rs index 8797f25a2..24a4a9d65 100644 --- a/crates/horizon-client/src/lan/playerdata.rs +++ b/crates/horizon-client/src/lan/playerdata.rs @@ -72,6 +72,7 @@ pub fn apply(guest: &mut Guest, level: &Level) { guest.flying = level.flying; guest.selected = (level.selected_slot.max(0) as usize).min(8); guest.spawn = level.spawn.map(|s| [s[0] + 0.5, s[1], s[2] + 0.5]); + guest.respawn_elsewhere = level.respawn_elsewhere.clone(); guest.saved = level.player_extra.clone(); guest.recipe_book = level.recipe_book.clone(); guest.dimension = match level.dimension.as_str() { @@ -135,6 +136,7 @@ pub fn store(guest: &Guest, level: &mut Level) { level.flying = guest.flying; level.selected_slot = guest.selected as i32; level.spawn = guest.spawn.map(|s| [s[0] - 0.5, s[1], s[2] - 0.5]); + level.respawn_elsewhere = guest.respawn_elsewhere.clone(); level.on_ground = guest.on_ground; level.player_extra = guest.saved.clone(); level.recipe_book = guest.recipe_book.clone(); diff --git a/docs/server-levels.md b/docs/server-levels.md index eee730f89..a44f290c4 100644 --- a/docs/server-levels.md +++ b/docs/server-levels.md @@ -18,7 +18,7 @@ the other dimensions' levels as `Parked` values and swaps one into place (`enter | `MinecraftServer.tickChildren`, every level | `tick_server`: each level with a player in it, in Overworld, Nether, End order. The first pass reads the network and runs the shared parts (clock, weather, functions, autosave). | | `ServerLevel.players` | `Hub::here`: the guests whose `dimension` is the level in place | | `ServerPlayer.teleport` into another level | `server_travel.rs`: a Respawn packet, then the teleport once the destination has loaded (portals and `execute in … tp`). An End gateway teleports within the End. | -| `PlayerList.respawn` | `guest_respawn`: back into the Overworld's level | +| `PlayerList.respawn` | `guest_respawn`: into the respawn point's level, the Overworld unless the player has an anchor or a `spawnpoint` elsewhere (`Guest::respawn_elsewhere`), resolved through its block once that level has loaded | | `ServerLevel.noPlayersEmptyTime`, chunk unloading | `close_idle_levels`: a level other than the Overworld with nobody in it for 300 ticks is saved and closed | | `CommandSourceStack.getLevel` | `with_source` puts the source's level in place for a command (`execute in`, `execute at` a player in another level) | | the levels' shared `LevelData` | not swapped: game time, day time, weather, game rules, scoreboard, maps, entity ids (`next_entity`, unique across levels) | @@ -76,7 +76,8 @@ the Nether, or whose host saves and quits, joins again in the Nether where it wa - Mobs and armour stands fall in two levels at once, and every entity id is unique across the levels. - The guest leaves in the Nether and joins again there. - - The guest dies in the Nether and respawns in the Overworld. + - The guest dies in the Nether and respawns in the Overworld. With a `spawnpoint` and then a + respawn anchor set in the Nether, it respawns there, and the anchor loses a charge. - The host takes a Nether portal alone. - The guest takes an End portal, an End gateway and then the exit portal alone. - The host saves, quits and opens the world again with the guest in the Nether, and the guest diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index ddbec78af..dffa2bde0 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -70,7 +70,8 @@ address. The script then checks, from both sides, what a guest's game used to ge - levels: (--server-thread) the host and the guest each in a level of their own: `execute in` teleports into another level, and `execute in` and `at` change and test blocks there; mobs fall in two levels at once, with ids unique across them; the guest rejoins in the - Nether, dies there and respawns in the Overworld; the host takes a Nether portal alone; + Nether, dies there and respawns in the Overworld, then in the Nether at a `spawnpoint` + and at a respawn anchor set there; the host takes a Nether portal alone; the guest takes an End portal, an End gateway and the exit portal alone; and the host saves, quits and reopens with the guest in the Nether. - commands: the guest's chat completes commands and their arguments over the server's command @@ -679,6 +680,48 @@ def level_death(host, guest, out): return {'respawned': back['player']['position']} +def level_respawn_points(host, guest, out): + """Respawn points outside the Overworld (ServerPlayer.findRespawnAndUseSpawnBlock): a point + `spawnpoint` sets in the Nether (forced), then a charged respawn anchor the guest uses there, + each bring the guest back in the Nether; the anchor loses a charge.""" + home = pos_of(guest) + x, z = (int(v // 1) for v in home[::2]) + into_level(guest, NETHER, x, 100, z) + results = {} + try: + guest('command', command=f'spawnpoint @s {x} 100 {z}') + results['spawnpoint'] = die_and_respawn(guest) + guest('command', command=f'setblock {x + 2} 100 {z} minecraft:respawn_anchor[charges=2]') + guest.wait(10) + guest.raw('interact', x + 2, 100, z) + guest.wait(10) + results['anchor'] = die_and_respawn(guest) + results['charges'] = guest.raw('block', x + 2, 100, z).get('state') + finally: + sx, sy, sz = (int(v // 1) for v in pos_of(host)) + guest('command', command=f'execute in {OVERWORLD} run spawnpoint @s {sx} {sy} {sz}') + guest('command', command=f'execute in {NETHER} run setblock {x + 2} 100 {z} minecraft:air') + guest('command', command=f'execute in {OVERWORLD} run tp @s {home[0]:.2f} {home[1]:.2f} {home[2]:.2f}') + wait_dimension(guest, OVERWORLD, 400) + point, anchor = results['spawnpoint'], results['anchor'] + assert point[0] == NETHER and abs(point[1][0] - x - 0.5) < 0.6 and abs(point[1][2] - z - 0.5) < 0.6, \ + f'the spawnpoint brought the guest to {point}' + assert anchor[0] == NETHER and abs(anchor[1][0] - x - 2.5) < 2 and abs(anchor[1][2] - z - 0.5) < 2, \ + f'the anchor brought the guest to {anchor}' + assert 'charges=1' in (results['charges'] or ''), f'the anchor after the respawn: {results["charges"]}' + return results + + +def die_and_respawn(guest): + """Kill the guest and respawn it: the dimension and position it comes back at, once settled.""" + guest('command', command='kill @s') + guest.wait(20) + guest.raw('respawn') + guest.wait(80) + state = guest('state') + return state.get('dimension'), state['player']['position'] + + def level_host_nether(host, guest, out): """The host goes through a Nether portal while the guest stays in the Overworld.""" hx, hy, hz = (int(v // 1) for v in pos_of(host)) @@ -771,7 +814,8 @@ def level_reload(host, guest, out): LEVEL_STEPS = [('execute', level_execute), ('ticking', level_ticking), ('rejoin', level_rejoin), - ('death', level_death), ('host_nether', level_host_nether), + ('death', level_death), ('respawn_points', level_respawn_points), + ('host_nether', level_host_nether), ('guest_end', level_guest_end), ('reload', level_reload)] From 0eaa13020cc16264f6e0488da7e7108f013750cd Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Thu, 22 Oct 2026 16:18:39 +0100 Subject: [PATCH 018/126] perf: load uniform saved light without expanding nibble layers --- crates/horizon-client/src/save.rs | 214 +++++++++++++++++++++++++- docs/saved-light-loading-benchmark.md | 44 ++++++ 2 files changed, 256 insertions(+), 2 deletions(-) create mode 100644 docs/saved-light-loading-benchmark.md diff --git a/crates/horizon-client/src/save.rs b/crates/horizon-client/src/save.rs index 2e1eb8455..0cfe3c585 100644 --- a/crates/horizon-client/src/save.rs +++ b/crates/horizon-client/src/save.rs @@ -1305,8 +1305,73 @@ pub fn load_light(tag: &Tag, chunk: &mut Chunk, sky_light: bool) { }; layers[si as usize] = (layer("SkyLight"), layer("BlockLight")); } - let above = [if sky_light { 15 } else { 0 }; 256]; - crate::light::light_from_layers(chunk, &layers, above, sky_light); + // Uniform saved layers need no expanded allocation. Both nibbles of + // each byte must match, not merely the bytes across the layer. + let uniform_layer = |layer: &[u8]| { + let first = layer[0]; + (first & 15 == first >> 4 && layer.iter().all(|&v| v == first)).then_some(first & 15) + }; + let mut above = [if sky_light { 15 } else { 0 }; 256]; + for (si, (sky, block)) in layers.into_iter().enumerate().rev() { + let sky = sky.filter(|_| sky_light); + let sky_uniform = sky.map_or_else( + || above.iter().all(|&v| v == above[0]).then_some(above[0]), + uniform_layer, + ); + let block_uniform = block.map_or(Some(0), uniform_layer); + let section = Arc::make_mut(&mut chunk.sections[si]); + if let (Some(s), Some(b)) = (sky_uniform, block_uniform) { + section.light = Light::Uniform(s << 4 | b); + above.fill(s); + } else { + let mut data = Box::new([0u8; 4096]); + match (sky, block) { + (Some(sky), Some(block)) => { + for ((pair, &s), &b) in + data.as_chunks_mut::<2>().0.iter_mut().zip(sky).zip(block) + { + pair[0] = s << 4 | (b & 15); + pair[1] = (s & 0xf0) | (b >> 4); + } + } + (Some(sky), None) => { + for (pair, &s) in data.as_chunks_mut::<2>().0.iter_mut().zip(sky) { + pair[0] = s << 4; + pair[1] = s & 0xf0; + } + } + (None, Some(block)) => { + for (i, (pair, &b)) in data + .as_chunks_mut::<2>() + .0 + .iter_mut() + .zip(block) + .enumerate() + { + pair[0] = above[(i * 2) & 255] << 4 | (b & 15); + pair[1] = above[(i * 2 + 1) & 255] << 4 | (b >> 4); + } + } + (None, None) => { + for layer in data.as_chunks_mut::<256>().0 { + for (v, &s) in layer.iter_mut().zip(&above) { + *v = s << 4; + } + } + } + } + if let Some(sky) = sky { + for (pair, &s) in above.as_chunks_mut::<2>().0.iter_mut().zip(sky) { + pair[0] = s & 15; + pair[1] = s >> 4; + } + } + section.light = Light::Full(data); + } + section.compact(); + } + chunk.lit = true; + chunk.light_loaded = true; } type RegionCache = Mutex<HashMap<(i32, i32), Option<Arc<Mutex<RegionFile>>>>>; @@ -3892,6 +3957,151 @@ mod tests { assert!(!unlit.lit && !unlit.light_loaded); } #[test] + fn saved_light_matches_reference_for_layers_and_metadata() { + fn reference(tag: &Tag, chunk: &mut Chunk, sky_light: bool) { + if tag.get("isLightOn") != Some(&Tag::Byte(1)) { + return; + } + let Some(Tag::List(sections)) = tag.get("sections") else { + return; + }; + let mut layers: Vec<(Option<&[u8]>, Option<&[u8]>)> = vec![(None, None); SECTIONS]; + for section in sections { + let Some(y) = number(section.get("Y")) else { + continue; + }; + let si = y as i32 - (MIN_Y >> 4); + if !(0..SECTIONS as i32).contains(&si) { + continue; + } + let layer = |name: &str| match section.get(name) { + Some(Tag::ByteArray(a)) if a.len() == 2048 => Some(&a[..]), + _ => None, + }; + layers[si as usize] = (layer("SkyLight"), layer("BlockLight")); + } + let above = [if sky_light { 15 } else { 0 }; 256]; + crate::light::light_from_layers(chunk, &layers, above, sky_light); + } + + let section = |y: Tag, sky: Option<Tag>, block: Option<Tag>| { + let mut entries = vec![("Y", y)]; + if let Some(v) = sky { + entries.push(("SkyLight", v)); + } + if let Some(v) = block { + entries.push(("BlockLight", v)); + } + Tag::compound(entries) + }; + let root = |sections| { + Tag::compound([ + ("isLightOn", Tag::Byte(1)), + ("sections", Tag::List(sections)), + ]) + }; + let check = |tag: &Tag| { + for sky_light in [false, true] { + let mut expected = Chunk::empty(-3, 5); + let s = Arc::make_mut(&mut expected.sections[0]); + s.light = Light::Full(Box::new([0xab; 4096])); + s.blocks.set(0, 1); + s.blocks.set(0, 0); + s.biomes.set(0, 1); + s.biomes.set(0, 0); + let mut actual = expected.clone(); + reference(tag, &mut expected, sky_light); + load_light(tag, &mut actual, sky_light); + assert_eq!( + (actual.lit, actual.light_loaded), + (expected.lit, expected.light_loaded) + ); + for (a, b) in actual.sections.iter().zip(&expected.sections) { + assert_eq!( + std::mem::discriminant(&a.light), + std::mem::discriminant(&b.light) + ); + assert_eq!( + format!("{:?}", a.blocks.to_wire()), + format!("{:?}", b.blocks.to_wire()) + ); + assert_eq!( + format!("{:?}", a.biomes.to_wire()), + format!("{:?}", b.biomes.to_wire()) + ); + for i in 0..4096 { + assert_eq!(a.light(i), b.light(i), "index {i}, sky {sky_light}"); + } + } + } + }; + for tag in [ + Tag::compound(Vec::<(&str, Tag)>::new()), + Tag::compound([("isLightOn", Tag::Byte(0))]), + Tag::compound([("isLightOn", Tag::Byte(2))]), + Tag::compound([("isLightOn", Tag::Int(1)), ("sections", Tag::List(vec![]))]), + Tag::compound([("isLightOn", Tag::Byte(1)), ("sections", Tag::Int(0))]), + root(vec![]), + ] { + check(&tag); + } + // Cover every repeated byte, including 0xF0/0x0F: a uniform byte + // array need not hold uniform nibbles. + for byte in 0..=255u8 { + check(&root(vec![section( + Tag::Byte(19), + Some(Tag::ByteArray(vec![byte; 2048])), + Some(Tag::ByteArray(vec![255 - byte; 2048])), + )])); + } + // Every pair of uniform sky/block nibble values, with missing + // sections below inheriting the stored bottom row. + for sky in 0..16u8 { + for block in 0..16u8 { + check(&root(vec![section( + Tag::Byte(1), + Some(Tag::ByteArray(vec![sky * 17; 2048])), + Some(Tag::ByteArray(vec![block * 17; 2048])), + )])); + } + } + for length in [0, 1, 2047, 2048, 2049] { + for invalid in [ + Tag::Int(1), + Tag::List(vec![]), + Tag::ByteArray(vec![0xf0; length]), + ] { + check(&root(vec![section( + Tag::Byte(-4), + Some(invalid.clone()), + Some(invalid), + )])); + } + } + let varied: Vec<u8> = (0..2048) + .map(|i| (i as u8).wrapping_mul(73).wrapping_add(31)) + .collect(); + check(&root(vec![ + section(Tag::Byte(-5), Some(Tag::ByteArray(varied.clone())), None), + section(Tag::Byte(20), Some(Tag::ByteArray(varied.clone())), None), + section( + Tag::String("19".into()), + Some(Tag::ByteArray(varied.clone())), + None, + ), + section(Tag::Byte(19), Some(Tag::ByteArray(varied.clone())), None), + section(Tag::Byte(17), None, Some(Tag::ByteArray(varied.clone()))), + section(Tag::Byte(-4), Some(Tag::ByteArray(varied.clone())), None), + // Last duplicate wins, even when its arrays have wrong types. + section( + Tag::Byte(-4), + Some(Tag::Int(15)), + Some(Tag::ByteArray(vec![7; 2047])), + ), + section(Tag::Byte(0), None, Some(Tag::ByteArray(varied))), + ])); + } + #[test] fn level_round_trips_through_the_vanilla_files() { let dir = std::env::temp_dir().join(format!("horizon-level-{}", std::process::id())); let _ = fs::remove_dir_all(&dir); diff --git a/docs/saved-light-loading-benchmark.md b/docs/saved-light-loading-benchmark.md new file mode 100644 index 000000000..f11d72443 --- /dev/null +++ b/docs/saved-light-loading-benchmark.md @@ -0,0 +1,44 @@ +# Saved-light loading benchmark + +Saved-light reconstruction reduces complete saved-chunk loading by a median **6.179% on the normal world** and **10.981% on the flat world**, incremental to the accepted palette-loading optimization. Every measured process pair improves. The implementation changes only `save.rs::load_light` and its tests. + +## Implementation and scope + +Detect uniform stored nibble layers before allocating expanded resident light. Both nibbles must match: repeated bytes such as `0xF0` and `0x0F` remain nonuniform. Decode two resident light values per stored byte for remaining layers. Preserve section compaction, low-nibble-first indexing, missing-block darkness, missing-sky bottom-row inheritance, skyless behavior, section bounds, last duplicate section, invalid array handling, and loaded flags. Pinned Minecraft 26.3 `DataLayer` and `SkyLightSectionStorage.repeatFirstLayer` bytecode was inspected first. No saved-light optimization overlap was found among the 34 open PRs checked on 2026-10-22. + +## Measurements + +Baseline `411c5574` includes accepted palette loading and aquifer changes; the candidate differs only in saved-light reconstruction. Both loader executables were rebuilt from those sources using identical benchmark source (SHA256 `b6f5042731d7c9d5622758043f7c1e125a3f7d098c57ee0501012474c2df7325`), dependencies, resources and flags. Machine: AMD Ryzen 5 5600X, 6 cores/12 logical CPUs, 32 GiB RAM; Linux 7.2.11-zen1-1-zen; Rust 1.99.0. Release optimization, thin LTO, one codegen unit, client default features disabled; CPU boost enabled, powersave governor, ordinary desktop activity. No builds, tests or profiles overlapped timing. + +Each corpus uses one discarded process pair followed by five measured pairs in alternating baseline/candidate order. Each observation is a process's median of five rounds loading the same sorted 256 full chunks. Checksumming and setup are outside timing; allocation/destruction and region reads/decompression/NBT/native decode/saved light are inside complete loading. Storage is warm. Reductions are medians/ranges of paired reductions; independently reported medians need not give the same ratio. Separate stage loops do not sum to a timing breakdown. + +| Corpus | Complete load, baseline → candidate | Paired reduction (range) | Inflate/NBT, baseline → candidate | Native decode, baseline → candidate | +| --- | ---: | ---: | ---: | ---: | +| Normal vanilla 26.3, seed 12345 | 50.036 → 47.005 ms | 6.179% (5.217–6.836%) | 22.187 → 22.087 ms | 20.464 → 21.621 ms | +| Flat vanilla 26.3 | 12.030 → 10.688 ms | 10.981% (10.423–11.751%) | 4.562 → 4.549 ms | 4.076 → 4.183 ms | + +Values are milliseconds per complete 256-chunk batch. The separate native-decode loop slows by a paired median 4.644% on normal and 3.185% on flat; the flat observations are variable. Its source is unchanged, and the cause of this separate-loop change was not isolated. Complete `SaveDir::load`, which includes native decode and saved light, improves in all ten measured pairs. The earlier two-pair normal pilot improved 5.894% and 6.553%; final-source qualification was repeated after the iterator syntax change. All timed compressed-record and block/biome/light hashes agree. Normal compressed records: `ff9bf9e822e334e117e3d6ba5c26a88b7698456ec6d83bdbe4355ad0af1d6f55`; block/biome/light: `661dd26eed78b051afeca11d8ba69222162b5da72e5d1572a12ce2a3b3a4f764`. + +## Correctness + +All 20 save unit tests pass. The new differential test compares the original loader with the candidate for every repeated packed byte, all 256 pairs of uniform sky/block nibble values, nonuniform inherited rows, missing/wrong layer types and lengths, skyless dimensions, out-of-range/invalid section Y values and duplicate sections. It compares every resident light value, uniform/full representation, block/biome storage and loaded flags. + +A fresh pinned Java 26.3 oracle uses `DataLayer.get` and `SkyLightSectionStorage.repeatFirstLayer` over all 256 repeated byte patterns in both sky modes. Baseline and candidate exactly match all **50,331,648 light values** plus flags (SHA256 `608bab077edc713110f827740cb5d9baf2af9c1a251ea2458441e2d981f25920`). + +The same comprehensive snapshot harness runs on the actual accepted-source baseline and final candidate: **400 normal chunks, 289 flat chunks, and two synthetic unknown-NBT/nonempty-tick cases**. All 691 outputs match byte-for-byte. It covers resident blocks/biomes/light, complete reencoded NBT, heightmaps, block entities and their saved sources/order, structures, unknown NBT, ticks, postprocessing, entities, names and loaded/arrival flags. Light representation is additionally covered by the unit test. Temporary diagnostic sources were removed. + +The final source uses the fixed-size chunk iterator syntax required by Clippy. Its rebuilt executable (SHA256 `40d7031e7d3efe785815b1286af05553807bbc59f66a9275a5f89191f0ecda7e`) is the one used for final qualification; snapshot/oracle harnesses use the same production source. Earlier pilot artifacts are retained separately: section extraction normalized ELF metadata (original timed SHA256 `eb28209fd54b6deedab1ff701c291ae36b8116b2ba52a02d1ec82600b57e427f`; normalized SHA256 `78f2092b2661655fdea8d0fa2247389ccc8f48f37dd9abfbb8d8864867187297`). Those earlier artifacts are superseded by the final-source qualification. + +The required repository quick self-check passes: public-tree validation, formatting, Clippy with warnings denied, **1,443 client/core/world tests**, and the doc-test step. Command: `RUST_TEST_THREADS=1 CARGO_BUILD_JOBS=6 CARGO_TARGET_DIR=/srv/bob-data/horizon-chunk-campaign-check-target python3 tools/pr_ready.py --quick --base origin/main` (11 min 15 s). Tests were serialized after an initial client-test process SIGSEGV; the failed log is retained as `pr-ready-attempt1.txt`. Relevant oracle checks were run separately; `--quick` lists other affected parity harnesses for CI. + +## Reproduction and evidence + +Private/generated evidence: `/srv/bob-data/horizon-chunk-campaign-41055168/saved-light/`. Preserved baseline/candidate sources and executables, source/binary hashes, open-PR catalog, pinned bytecode, build logs, `final-pairs.py`, `final-raw.json`, final qualification logs and `final-summary.json`; earlier pilot/qualification artifacts are retained there. Resources: `/srv/bob-data/horizon/.local/horizon-client/26.3`. Normal corpus: `/srv/bob-data/horizon-chunk-campaign-41055168/vanilla-normal/world/dimensions/minecraft/overworld`; flat: `/srv/bob-data/horizon/.local/locator-bar-parity/generate/world/dimensions/minecraft/overworld`. + +```sh +CARGO_BUILD_JOBS=6 CARGO_TARGET_DIR=/srv/bob-data/horizon-chunk-campaign-target cargo build --locked --release -p horizon-client --no-default-features --example load_bench +load_bench RESOURCES DIMENSION_DIR --rounds 5 --limit 256 --checksum +python3 /srv/bob-data/horizon-chunk-campaign-41055168/saved-light/final-pairs.py final 5 +``` + +These results cover the declared warm saved-load workloads. Cold physical I/O, remote chunk streams and complete gameplay parity are outside this comparison. From 756cf4af07901f18d4e5b8e95a7d293b7f144231 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Thu, 22 Oct 2026 16:18:40 +0100 Subject: [PATCH 019/126] bench: measure read-only saved chunk loading --- crates/horizon-client/examples/load_bench.rs | 153 +++++++++++++++++++ 1 file changed, 153 insertions(+) create mode 100644 crates/horizon-client/examples/load_bench.rs diff --git a/crates/horizon-client/examples/load_bench.rs b/crates/horizon-client/examples/load_bench.rs new file mode 100644 index 000000000..5c30a71ff --- /dev/null +++ b/crates/horizon-client/examples/load_bench.rs @@ -0,0 +1,153 @@ +//! Read-only saved chunk benchmark. All timings exclude resource/corpus setup. +//! +//! load_bench RESOURCES DIMENSION_DIR [--rounds N] [--limit N] [--checksum] +//! Add --profile-worker when a sampling collector cannot sample the main thread. +//! Reports warm filesystem SaveDir::load (read, inflate, NBT, decode and light), +//! plus isolated inflate/NBT and native decode. No files in the save are changed. +use horizon_client::{ + assets::Assets, + biome::Biomes, + blocks::BlockFacts, + save::{SaveDir, SaveTables, decode_with}, +}; +use horizon_world::{nbt::Limits, region::RegionFile}; +use sha2::{Digest, Sha256}; +use std::{hint::black_box, path::PathBuf, sync::Arc, time::Instant}; + +type Result<T> = std::result::Result<T, Box<dyn std::error::Error>>; + +fn main() -> Result<()> { + if std::env::args().any(|a| a == "--profile-worker") { + std::thread::spawn(|| run().map_err(|e| e.to_string())) + .join() + .expect("benchmark worker") + .map_err(Into::into) + } else { + run() + } +} + +fn run() -> Result<()> { + let args: Vec<String> = std::env::args().skip(1).collect(); + let usage = "load_bench RESOURCES DIMENSION_DIR [--rounds N] [--limit N] [--checksum]"; + let root = PathBuf::from(args.first().ok_or(usage)?); + let dimension = PathBuf::from(args.get(1).ok_or(usage)?); + let flag = |name: &str, default: usize| -> Result<usize> { + Ok(match args.iter().position(|a| a == name) { + Some(i) => args.get(i + 1).ok_or(usage)?.parse()?, + None => default, + }) + }; + let rounds = flag("--rounds", 5)?; + let limit = flag("--limit", 256)?; + if rounds == 0 || limit == 0 { + return Err("rounds and limit must be positive".into()); + } + let assets = Assets::load(&root)?; + let facts = BlockFacts::load(&root, assets.registry)?; + let biomes = Biomes::load(&root)?; + let tables = Arc::new(SaveTables::new(&assets).with_block_entities(&facts)); + let source = SaveDir::new(dimension.clone()); + let _ = source.tables.set(tables.clone()); + let mut paths: Vec<_> = std::fs::read_dir(dimension.join("region"))? + .map(|e| e.map(|e| e.path())) + .collect::<std::io::Result<_>>()?; + paths.retain(|p| p.extension().is_some_and(|e| e == "mca")); + paths.sort(); + let mut corpus = Vec::new(); + 'regions: for path in paths { + let mut region = RegionFile::open(path)?; + let mut positions: Vec<_> = region.chunks().map(|(pos, _)| pos).collect(); + positions.sort_by_key(|p| (p.x, p.z)); + for pos in positions { + let record = region.read(pos)?.ok_or("missing record")?; + let tag = record.nbt(Limits::default())?; + if decode_with(&tag, assets.registry, &biomes, Some(&tables)).is_none() { + continue; + } + corpus.push((pos, record, tag)); + if corpus.len() == limit { + break 'regions; + } + } + } + if corpus.is_empty() { + return Err("no full chunks in corpus".into()); + } + let mut records_hash = Sha256::new(); + for (pos, record, _) in &corpus { + records_hash.update(pos.x.to_le_bytes()); + records_hash.update(pos.z.to_le_bytes()); + records_hash.update((record.compressed.len() as u64).to_le_bytes()); + records_hash.update(&record.compressed); + } + println!( + "{}", + serde_json::json!({"corpus": dimension, "chunks": corpus.len(), "rounds": rounds, + "compressed_records_sha256": format!("{:x}", records_hash.finalize()), + "compressed_bytes": corpus.iter().map(|(_, r, _)| r.compressed.len()).sum::<usize>()}) + ); + // Prime SaveDir's region handles and the filesystem cache before measurement. + for (pos, _, _) in &corpus { + black_box( + source + .load(pos.x, pos.z, assets.registry, &biomes) + .ok_or("load failed")?, + ); + } + for round in 0..rounds { + let started = Instant::now(); + for (pos, _, _) in &corpus { + black_box( + source + .load(pos.x, pos.z, assets.registry, &biomes) + .ok_or("load failed")?, + ); + } + let load_s = started.elapsed().as_secs_f64(); + let started = Instant::now(); + for (_, record, _) in &corpus { + black_box(record.nbt(Limits::default())?); + } + let nbt_s = started.elapsed().as_secs_f64(); + let started = Instant::now(); + for (_, _, tag) in &corpus { + black_box( + decode_with(tag, assets.registry, &biomes, Some(&tables)).ok_or("decode failed")?, + ); + } + let decode_s = started.elapsed().as_secs_f64(); + println!( + "{}", + serde_json::json!({"round": round, "load_s": load_s, + "inflate_nbt_s": nbt_s, "decode_s": decode_s}) + ); + } + if args.iter().any(|a| a == "--checksum") { + let mut hash = Sha256::new(); + let mut light_loaded = 0; + for (pos, _, _) in &corpus { + let chunk = source + .load(pos.x, pos.z, assets.registry, &biomes) + .ok_or("load failed")?; + hash.update(pos.x.to_le_bytes()); + hash.update(pos.z.to_le_bytes()); + light_loaded += usize::from(chunk.light_loaded); + for section in &chunk.sections { + for i in 0..4096 { + hash.update(section.get(i).to_le_bytes()); + hash.update([section.light(i)]); + } + for i in 0..64 { + hash.update(section.biomes.get(i).to_le_bytes()); + } + } + } + println!( + "{}", + serde_json::json!({"blocks_biomes_light_sha256": format!("{:x}", hash.finalize()), + "light_loaded": light_loaded}) + ); + } + Ok(()) +} From 05400438c7f034a380815b6ed606b181bb3bdb3b Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Thu, 22 Oct 2026 16:44:32 +0100 Subject: [PATCH 020/126] perf(client): cache weather column direction table --- crates/horizon-client/src/weather.rs | 40 ++++++++++++++++++++++++---- 1 file changed, 35 insertions(+), 5 deletions(-) diff --git a/crates/horizon-client/src/weather.rs b/crates/horizon-client/src/weather.rs index 3eb39e14c..ba15de9ae 100644 --- a/crates/horizon-client/src/weather.rs +++ b/crates/horizon-client/src/weather.rs @@ -114,10 +114,15 @@ pub fn snow_column( /// The constructor's 32x32 table of horizontal column half-widths, indexed /// relative to the camera block. The camera's own column divides 0 by 0. fn column_size(index: usize) -> (f32, f32) { - let delta_x = (index % 32) as f32 - 16.0; - let delta_z = (index / 32) as f32 - 16.0; - let distance = f64::from(delta_x * delta_x + delta_z * delta_z).sqrt() as f32; - (-delta_z / distance, delta_x / distance) + static SIZES: std::sync::LazyLock<[(f32, f32); 32 * 32]> = std::sync::LazyLock::new(|| { + std::array::from_fn(|index| { + let delta_x = (index % 32) as f32 - 16.0; + let delta_z = (index / 32) as f32 - 16.0; + let distance = f64::from(delta_x * delta_x + delta_z * delta_z).sqrt() as f32; + (-delta_z / distance, delta_x / distance) + }) + }); + SIZES[index] } /// `prepareInstances` for one column: rain uses `max_alpha` 1, snow 0.8. @@ -219,6 +224,27 @@ fn pieces(a: f32, b: f32) -> impl Iterator<Item = (f32, f32)> { mod tests { use super::*; + #[test] + fn column_size_table_matches_original_arithmetic() { + for z in 0..32 { + for x in 0..32 { + let delta_x = x as f32 - 16.0; + let delta_z = z as f32 - 16.0; + let distance = f64::from(delta_x * delta_x + delta_z * delta_z).sqrt() as f32; + let expected = [-delta_z / distance, delta_x / distance]; + let actual = column_size(z * 32 + x); + for (actual, expected) in [actual.0, actual.1].into_iter().zip(expected) { + if x == 16 && z == 16 { + assert!(expected.is_nan()); + assert!(actual.is_nan()); + } else { + assert_eq!(actual.to_bits(), expected.to_bits(), "column ({x}, {z})"); + } + } + } + } + } + #[test] fn rain_repeats_every_four_blocks() { let column = Column { @@ -282,6 +308,10 @@ mod tests { light_coords: 0, }; let quad = column_quad(&column, [0.5, 70.0, 0.5], 1.0, 10, 1.0); - assert!(quad[0].pos[0].is_nan()); + for vertex in quad { + assert!(vertex.pos[0].is_nan()); + assert!(vertex.pos[2].is_nan()); + assert!(vertex.pos[1].is_finite()); + } } } From 92b8cd692da2ffb244b4c81bb1a965d4608f956a Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Thu, 22 Oct 2026 16:50:29 +0100 Subject: [PATCH 021/126] perf(client): retain the End sky mesh on the GPU --- crates/horizon-client/src/game.rs | 11 +- crates/horizon-client/src/game/end.rs | 45 +-- crates/horizon-client/src/gfx.rs | 25 +- crates/horizon-client/src/gfx/end_sky.rs | 84 +++++ .../horizon-client/src/gfx/end_sky/tests.rs | 330 ++++++++++++++++++ 5 files changed, 447 insertions(+), 48 deletions(-) create mode 100644 crates/horizon-client/src/gfx/end_sky.rs create mode 100644 crates/horizon-client/src/gfx/end_sky/tests.rs diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index f706e9348..ccc838bbb 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -9812,8 +9812,8 @@ impl Game<'_> { { // Camera.doesMobEffectBlockSky: no sun, moon or stars. self.celestial_geometry(&sky) - } else if self.dim == Dim::End { - (self.end_sky_geometry(), None) + } else if self.dim == Dim::End && self.settings.horizon.sky { + (self.end_flash_geometry(), None) } else { (Vec::new(), None) }; @@ -9860,6 +9860,12 @@ impl Game<'_> { title: title && !live, skybox: self.dim == Dim::Overworld && self.settings.horizon.sky, end_sky: self.dim == Dim::End && self.settings.horizon.sky, + end_sky_sprite: self + .gui + .atlas + .sprites + .get("environment/end_sky") + .map(|r| [r.u0, r.v0, r.u1, r.v1]), environment_fog: (self.dim == Dim::Nether).then_some((sky.fog_start, sky.fog_end)), cave_culling, water_fog, @@ -12363,6 +12369,7 @@ fn loading_frame(hud: &HudBatch) -> Frame<'_> { title: true, skybox: false, end_sky: false, + end_sky_sprite: None, environment_fog: None, water_fog: [0.0; 3], fog: None, diff --git a/crates/horizon-client/src/game/end.rs b/crates/horizon-client/src/game/end.rs index a7813c767..98a595f76 100644 --- a/crates/horizon-client/src/game/end.rs +++ b/crates/horizon-client/src/game/end.rs @@ -138,47 +138,12 @@ impl Game<'_> { } } - /// SkyRenderer.buildEndSky: six faces of end_sky.png tiled 16 times, - /// tinted 0x282828. The atlas does not wrap, so each face is 16×16 quads. - pub(super) fn end_sky_geometry(&self) -> Vec<Vertex> { - let mut out = Vec::with_capacity(6 * 256 * 4); - let Some(r) = self.gui.atlas.sprites.get("environment/end_sky").copied() else { + /// SkyRenderer.renderEndFlash, drawn after the renderer's resident sky mesh. + pub(super) fn end_flash_geometry(&self) -> Vec<Vertex> { + let mut out = Vec::new(); + // The old combined sky/flash draw also skipped the flash without a sky sprite. + if !self.gui.atlas.sprites.contains_key("environment/end_sky") { return out; - }; - use std::f32::consts::FRAC_PI_2; - let faces = [ - glam::Mat4::IDENTITY, - glam::Mat4::from_rotation_x(FRAC_PI_2), - glam::Mat4::from_rotation_x(-FRAC_PI_2), - glam::Mat4::from_rotation_x(std::f32::consts::PI), - glam::Mat4::from_rotation_z(FRAC_PI_2), - glam::Mat4::from_rotation_z(-FRAC_PI_2), - ]; - let step = 200.0 / 16.0; - for pose in faces { - for a in 0..16 { - for b in 0..16 { - let (x0, z0) = (-100.0 + step * a as f32, -100.0 + step * b as f32); - let (x1, z1) = (x0 + step, z0 + step); - let corners = [ - (x0, z0, [r.u0, r.v0]), - (x0, z1, [r.u0, r.v1]), - (x1, z1, [r.u1, r.v1]), - (x1, z0, [r.u1, r.v0]), - ]; - for (x, z, uv) in corners { - let p = pose.transform_point3(glam::Vec3::new(x, -100.0, z)); - out.push(Vertex { - normal: [0; 4], - pos: p.to_array(), - uv, - layer: 2, - color: 0xFF28_2828, - light: 0, - }); - } - } - } } // SkyRenderer.renderEndFlash: the end_flash sprite at height 100, scale 60. let intensity = self.end.flash.intensity(self.clock.fraction() as f32); diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 14c040c5c..fb1cd322e 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -61,6 +61,7 @@ pub fn outline_vertices(edges: &[[f64; 6]], camera: glam::DVec3) -> Vec<[f32; 6] mod arena; mod cull; +mod end_sky; mod flat; mod java_stages; mod lod; @@ -163,8 +164,10 @@ pub struct Frame<'a> { pub title: bool, /// Dimensions without a skybox (the Nether) clear to the fog colour. pub skybox: bool, - /// The End: clear to black and draw `celestial` (the End sky box) behind the world. + /// The End: clear to black and draw the resident sky box behind the world. pub end_sky: bool, + /// End sky atlas bounds (u0, v0, u1, v1); absent when the sprite is missing. + pub end_sky_sprite: Option<[f32; 4]>, /// Environmental fog start/end (Nether 10..96), if any. pub environment_fog: Option<(f32, f32)>, pub water_fog: [f32; 3], @@ -197,8 +200,8 @@ pub struct Frame<'a> { pub additive: &'a [Vertex], /// Name tags over everything, without depth (`TEXT_SEE_THROUGH`). pub see_through: &'a [Vertex], - /// Camera-relative sun and moon, or the End sky box (drawn behind - /// everything, additive). + /// Camera-relative sun and moon, or the animated End flash (additive, + /// behind everything and after the resident End sky box). pub celestial: &'a [Vertex], /// The stars, drawn from their static buffer after the sun and moon: /// the sky's rotation (camera-relative world from star space) and the @@ -337,6 +340,7 @@ pub struct Renderer { see_through_pipeline: wgpu::RenderPipeline, celestial_pipeline: wgpu::RenderPipeline, celestial_buffer: wgpu::Buffer, + end_sky: end_sky::EndSky, stars: stars::Stars, panorama: panorama::Panorama, /// `RenderPipelines.WORLD_BORDER` and its buffers. @@ -2113,6 +2117,7 @@ impl Renderer { see_through_pipeline, celestial_pipeline, celestial_buffer, + end_sky: end_sky::EndSky::default(), stars, panorama, border_pipeline, @@ -3310,6 +3315,9 @@ impl Renderer { ); } let celestial_vertices = frame.celestial.len().min(2048 * 4); + if frame.end_sky && !frame.title { + self.end_sky.prepare(&self.device, frame.end_sky_sprite); + } if celestial_vertices > 0 { self.uploads.buffer( &mut encoder, @@ -3510,12 +3518,17 @@ impl Renderer { if frame.title { self.panorama.draw(&mut pass); pass.set_bind_group(0, &self.group, &[]); - } else if celestial_vertices > 0 { + } else if celestial_vertices > 0 || frame.end_sky { pass.set_pipeline(&self.celestial_pipeline); pass.set_bind_group(0, &self.entity_group, &[]); pass.set_index_buffer(self.indices.slice(..), wgpu::IndexFormat::Uint32); - pass.set_vertex_buffer(0, self.celestial_buffer.slice(..)); - pass.draw_indexed(0..(celestial_vertices as u32 / 4) * 6, 0, 0..1); + if frame.end_sky { + self.end_sky.draw(&mut pass); + } + if celestial_vertices > 0 { + pass.set_vertex_buffer(0, self.celestial_buffer.slice(..)); + pass.draw_indexed(0..(celestial_vertices as u32 / 4) * 6, 0, 0..1); + } pass.set_bind_group(0, &self.group, &[]); } if !frame.title && frame.stars.is_some() { diff --git a/crates/horizon-client/src/gfx/end_sky.rs b/crates/horizon-client/src/gfx/end_sky.rs new file mode 100644 index 000000000..15e9001fc --- /dev/null +++ b/crates/horizon-client/src/gfx/end_sky.rs @@ -0,0 +1,84 @@ +//! The End sky's six tiled faces, retained for the lifetime of the renderer's atlas. +use crate::mesher::Vertex; +use wgpu::util::DeviceExt; + +const VERTICES: u32 = 6 * 16 * 16 * 4; + +#[derive(Default)] +pub(super) struct EndSky { + mesh: Option<([f32; 4], wgpu::Buffer)>, +} + +impl EndSky { + /// Called only when the End sky is enabled. Rebuild on atlas UV changes; + /// resource reload and device recreation also replace the owning renderer. + pub(super) fn prepare(&mut self, device: &wgpu::Device, uv: Option<[f32; 4]>) { + let Some(uv) = uv else { + self.mesh = None; + return; + }; + if self.mesh.as_ref().is_some_and(|(old, _)| *old == uv) { + return; + } + let vertices = vertices(uv); + let buffer = device.create_buffer_init(&wgpu::util::BufferInitDescriptor { + label: Some("End sky vertices"), + contents: bytemuck::cast_slice(&vertices), + usage: wgpu::BufferUsages::VERTEX, + }); + self.mesh = Some((uv, buffer)); + } + + /// The celestial pipeline, atlas bind group and quad indices are already bound. + pub(super) fn draw(&self, pass: &mut wgpu::RenderPass<'_>) { + if let Some((_, buffer)) = &self.mesh { + pass.set_vertex_buffer(0, buffer.slice(..)); + pass.draw_indexed(0..VERTICES / 4 * 6, 0, 0..1); + } + } +} + +/// SkyRenderer.buildEndSky: six faces of end_sky.png tiled 16 times, +/// tinted 0x282828. The atlas does not wrap, so each face is 16×16 quads. +fn vertices(uv: [f32; 4]) -> Vec<Vertex> { + let mut out = Vec::with_capacity(VERTICES as usize); + use std::f32::consts::FRAC_PI_2; + let faces = [ + glam::Mat4::IDENTITY, + glam::Mat4::from_rotation_x(FRAC_PI_2), + glam::Mat4::from_rotation_x(-FRAC_PI_2), + glam::Mat4::from_rotation_x(std::f32::consts::PI), + glam::Mat4::from_rotation_z(FRAC_PI_2), + glam::Mat4::from_rotation_z(-FRAC_PI_2), + ]; + let step = 200.0 / 16.0; + for pose in faces { + for a in 0..16 { + for b in 0..16 { + let (x0, z0) = (-100.0 + step * a as f32, -100.0 + step * b as f32); + let (x1, z1) = (x0 + step, z0 + step); + let corners = [ + (x0, z0, [uv[0], uv[1]]), + (x0, z1, [uv[0], uv[3]]), + (x1, z1, [uv[2], uv[3]]), + (x1, z0, [uv[2], uv[1]]), + ]; + for (x, z, uv) in corners { + let p = pose.transform_point3(glam::Vec3::new(x, -100.0, z)); + out.push(Vertex { + normal: [0; 4], + pos: p.to_array(), + uv, + layer: 2, + color: 0xFF28_2828, + light: 0, + }); + } + } + } + } + out +} + +#[cfg(test)] +mod tests; diff --git a/crates/horizon-client/src/gfx/end_sky/tests.rs b/crates/horizon-client/src/gfx/end_sky/tests.rs new file mode 100644 index 000000000..d01fca18c --- /dev/null +++ b/crates/horizon-client/src/gfx/end_sky/tests.rs @@ -0,0 +1,330 @@ +use super::*; +use crate::gfx::{Globals, Renderer}; +use bytemuck::Zeroable; +use glam::Mat4; + +#[test] +fn geometry_matches_pre_residency_vertex_snapshots() { + use sha2::{Digest, Sha256}; + // Captured from game/end.rs at 34c3c1cf for full, tiled and non-binary UVs. + // Quantize positions only, avoiding platform sin/cos rounding differences; + // quad order, UVs, tint, material and light retain their exact byte values. + for (uv, expected) in [ + ( + [0.0, 0.0, 1.0, 1.0], + "f7ee23457fc557b33ecf09c9afaf858f3d8907e108abf06055f627523f733536", + ), + ( + [0.125, 0.25, 0.375, 0.5], + "f74c4b8d23ec2b7c11b5752821d0733851bf11358f1b26f9448226ff62a6a318", + ), + ( + [0.13, 0.27, 0.41, 0.59], + "f0aaa39c5b22168bdc7c6c329acb4d3598a2feb61ff7b6f2850b644682749b39", + ), + ] { + let mut mesh = vertices(uv); + assert_eq!(mesh.len(), VERTICES as usize); + for vertex in &mut mesh { + vertex.pos = vertex.pos.map(|x| { + let n = (x * 1024.0).round() / 1024.0; + if n == 0.0 { 0.0 } else { n } + }); + } + assert_eq!( + format!("{:x}", Sha256::digest(bytemuck::cast_slice(&mesh))), + expected + ); + } +} + +fn device() -> Option<(wgpu::Device, wgpu::Queue)> { + let instance = wgpu::Instance::new(wgpu::InstanceDescriptor::new_without_display_handle()); + let adapter = pollster::block_on(instance.request_adapter(&Default::default())).ok()?; + eprintln!("End sky test adapter: {:?}", adapter.get_info()); + pollster::block_on(adapter.request_device(&Default::default())).ok() +} + +#[test] +fn resident_buffer_survives_frames_and_refreshes_with_the_atlas() { + let Some((device, _)) = device() else { + eprintln!("no GPU adapter: skipped"); + return; + }; + let mut sky = EndSky::default(); + let uv = [0.125, 0.25, 0.375, 0.5]; + sky.prepare(&device, Some(uv)); + let first = sky.mesh.as_ref().unwrap().1.clone(); + assert_eq!( + first.size(), + u64::from(VERTICES) * size_of::<Vertex>() as u64 + ); + // Immutable: steady-state frames cannot upload into this buffer. + assert_eq!(first.usage(), wgpu::BufferUsages::VERTEX); + for _ in 0..600 { + sky.prepare(&device, Some(uv)); + assert_eq!(sky.mesh.as_ref().unwrap().1, first); + } + let moved = [0.5, 0.5, 0.75, 0.75]; + sky.prepare(&device, Some(moved)); + assert_ne!(sky.mesh.as_ref().unwrap().1, first); + assert_eq!(sky.mesh.as_ref().unwrap().0, moved); + sky.prepare(&device, None); + assert!(sky.mesh.is_none()); + sky.prepare(&device, Some(uv)); + assert_ne!(sky.mesh.as_ref().unwrap().1, first); + // A resource reload/device recreation starts a new renderer-owned cache, + // even if the replacement atlas happens to use exactly the same UVs. + let mut replacement = EndSky::default(); + replacement.prepare(&device, Some(uv)); + assert_ne!( + replacement.mesh.as_ref().unwrap().1, + sky.mesh.as_ref().unwrap().1 + ); +} + +/// The actual entity shader and celestial blend, comparing the old combined +/// vertex stream with a resident sky draw followed by a separate flash draw. +#[test] +fn separate_draws_match_combined_celestial_pixels() { + let Some((device, queue)) = device() else { + eprintln!("no GPU adapter: skipped"); + return; + }; + let shader = device.create_shader_module(wgpu::ShaderModuleDescriptor { + label: Some("End sky differential shader"), + source: wgpu::ShaderSource::Wgsl(crate::gfx::entity_shader().into()), + }); + let attributes = wgpu::vertex_attr_array![0=>Float32x3,1=>Float32x2,2=>Uint32,3=>Unorm8x4,4=>Uint8x4,5=>Snorm8x4]; + let pipeline = device.create_render_pipeline(&wgpu::RenderPipelineDescriptor { + label: Some("End sky differential pipeline"), + layout: None, + vertex: wgpu::VertexState { + module: &shader, + entry_point: Some("vs_entity"), + compilation_options: Default::default(), + buffers: &[Some(wgpu::VertexBufferLayout { + array_stride: size_of::<Vertex>() as u64, + step_mode: wgpu::VertexStepMode::Vertex, + attributes: &attributes, + })], + }, + primitive: wgpu::PrimitiveState { + cull_mode: None, + ..Default::default() + }, + depth_stencil: None, + multisample: Default::default(), + fragment: Some(wgpu::FragmentState { + module: &shader, + entry_point: Some("fs_celestial"), + compilation_options: Default::default(), + targets: &[Some(wgpu::ColorTargetState { + format: wgpu::TextureFormat::Rgba8Unorm, + blend: Some(wgpu::BlendState { + color: wgpu::BlendComponent { + src_factor: wgpu::BlendFactor::SrcAlpha, + dst_factor: wgpu::BlendFactor::One, + operation: wgpu::BlendOperation::Add, + }, + alpha: wgpu::BlendComponent::OVER, + }), + write_mask: wgpu::ColorWrites::ALL, + })], + }), + multiview_mask: None, + cache: None, + }); + let texture = |pixels: &[u8], width, height| { + device.create_texture_with_data( + &queue, + &wgpu::TextureDescriptor { + label: None, + size: wgpu::Extent3d { + width, + height, + depth_or_array_layers: 1, + }, + mip_level_count: 1, + sample_count: 1, + dimension: wgpu::TextureDimension::D2, + format: wgpu::TextureFormat::Rgba8Unorm, + usage: wgpu::TextureUsages::TEXTURE_BINDING, + view_formats: &[], + }, + wgpu::util::TextureDataOrder::LayerMajor, + pixels, + ) + }; + // Asymmetric, translucent texels expose UV/winding and blend-order errors. + let pixels: Vec<u8> = (0..16 * 16) + .flat_map(|i| { + [ + (i * 17) as u8, + (i * 31) as u8, + (i * 7) as u8, + (80 + i % 176) as u8, + ] + }) + .collect(); + let atlas = texture(&pixels, 16, 16).create_view(&Default::default()); + let lightmap = texture(&[255; 4], 1, 1).create_view(&Default::default()); + let sampler = device.create_sampler(&Default::default()); + let uniform = device.create_buffer(&wgpu::BufferDescriptor { + label: None, + size: size_of::<Globals>() as u64, + usage: wgpu::BufferUsages::UNIFORM | wgpu::BufferUsages::COPY_DST, + mapped_at_creation: false, + }); + let group = device.create_bind_group(&wgpu::BindGroupDescriptor { + label: None, + layout: &pipeline.get_bind_group_layout(0), + entries: &[ + wgpu::BindGroupEntry { + binding: 0, + resource: uniform.as_entire_binding(), + }, + wgpu::BindGroupEntry { + binding: 1, + resource: wgpu::BindingResource::TextureView(&atlas), + }, + wgpu::BindGroupEntry { + binding: 2, + resource: wgpu::BindingResource::Sampler(&sampler), + }, + wgpu::BindGroupEntry { + binding: 3, + resource: wgpu::BindingResource::TextureView(&lightmap), + }, + wgpu::BindGroupEntry { + binding: 4, + resource: wgpu::BindingResource::Sampler(&sampler), + }, + ], + }); + let indices = Renderer::quad_indices(&device, VERTICES / 4 + 1); + let mut resident = EndSky::default(); + let uv = [0.125, 0.25, 0.375, 0.5]; + resident.prepare(&device, Some(uv)); + let first = resident.mesh.as_ref().unwrap().1.clone(); + let render = |sky: &EndSky, flash: &[Vertex], combined: bool| { + let target = device.create_texture(&wgpu::TextureDescriptor { + label: None, + size: wgpu::Extent3d { + width: 64, + height: 64, + depth_or_array_layers: 1, + }, + mip_level_count: 1, + sample_count: 1, + dimension: wgpu::TextureDimension::D2, + format: wgpu::TextureFormat::Rgba8Unorm, + usage: wgpu::TextureUsages::RENDER_ATTACHMENT | wgpu::TextureUsages::COPY_SRC, + view_formats: &[], + }); + let view = target.create_view(&Default::default()); + let mut vertices = if combined { vertices(uv) } else { Vec::new() }; + vertices.extend_from_slice(flash); + let buffer = device.create_buffer_init(&wgpu::util::BufferInitDescriptor { + label: None, + contents: bytemuck::cast_slice(&vertices), + usage: wgpu::BufferUsages::VERTEX, + }); + let readback = device.create_buffer(&wgpu::BufferDescriptor { + label: None, + size: 64 * 64 * 4, + usage: wgpu::BufferUsages::COPY_DST | wgpu::BufferUsages::MAP_READ, + mapped_at_creation: false, + }); + let mut encoder = device.create_command_encoder(&Default::default()); + { + let mut pass = encoder.begin_render_pass(&wgpu::RenderPassDescriptor { + color_attachments: &[Some(wgpu::RenderPassColorAttachment { + view: &view, + depth_slice: None, + resolve_target: None, + ops: wgpu::Operations { + load: wgpu::LoadOp::Clear(wgpu::Color::BLACK), + store: wgpu::StoreOp::Store, + }, + })], + ..Default::default() + }); + pass.set_pipeline(&pipeline); + pass.set_bind_group(0, &group, &[]); + pass.set_index_buffer(indices.slice(..), wgpu::IndexFormat::Uint32); + if !combined { + sky.draw(&mut pass); + } + if !vertices.is_empty() { + pass.set_vertex_buffer(0, buffer.slice(..)); + pass.draw_indexed(0..vertices.len() as u32 / 4 * 6, 0, 0..1); + } + } + encoder.copy_texture_to_buffer( + target.as_image_copy(), + wgpu::TexelCopyBufferInfo { + buffer: &readback, + layout: wgpu::TexelCopyBufferLayout { + offset: 0, + bytes_per_row: Some(256), + rows_per_image: Some(64), + }, + }, + target.size(), + ); + queue.submit([encoder.finish()]); + readback + .slice(..) + .map_async(wgpu::MapMode::Read, |r| r.unwrap()); + device.poll(wgpu::PollType::wait_indefinitely()).unwrap(); + readback.slice(..).get_mapped_range().unwrap().to_vec() + }; + let mut cases = 0; + let mut visible_flash_cases = 0; + for yaw in [0.0_f32, 45.0, 90.0, 180.0, 270.0] { + for pitch in [-85.0_f32, -30.0, 0.0, 45.0, 85.0] { + let mut globals = Globals::zeroed(); + globals.view_proj = (Mat4::perspective_rh(90_f32.to_radians(), 1.0, 0.05, 1024.0) + * Mat4::from_rotation_x(pitch.to_radians()) + * Mat4::from_rotation_y(yaw.to_radians())) + .to_cols_array_2d(); + queue.write_buffer(&uniform, 0, bytemuck::bytes_of(&globals)); + let no_flash = render(&resident, &[], true); + for level in [0_u32, 1, 127, 255] { + let flash: Vec<_> = if level == 0 { + Vec::new() + } else { + // Same flash size/height, with an arbitrary EndFlashState pose. + let pose = Mat4::from_rotation_y(1.3) * Mat4::from_rotation_x(-1.6); + [(-60.0, -60.0), (60.0, -60.0), (60.0, 60.0), (-60.0, 60.0)] + .map(|(x, z)| Vertex { + pos: pose.transform_point3(glam::vec3(x, 100.0, z)).to_array(), + uv: [0.75 + x / 480.0, 0.75 + z / 480.0], + layer: 2, + color: level * 0x01010101, + light: 0, + normal: [0; 4], + }) + .to_vec() + }; + resident.prepare(&device, Some(uv)); + let expected = render(&resident, &flash, true); + let actual = render(&resident, &flash, false); + visible_flash_cases += usize::from(expected != no_flash); + assert_eq!(actual, expected, "yaw={yaw} pitch={pitch} flash={level}"); + assert!( + actual.chunks_exact(4).any(|p| p[..3] != [0; 3]), + "empty frame" + ); + assert_eq!(resident.mesh.as_ref().unwrap().1, first); + cases += 1; + } + } + } + assert!( + visible_flash_cases > 0, + "the flash must affect the comparison" + ); + eprintln!("{cases} combined/resident framebuffer cases matched exactly"); +} From 4ad6bb18efe9a08c02504f382502a578510dc19e Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 15:26:45 +0200 Subject: [PATCH 022/126] Natural spawning: resolve the entry's type once, skip the mobsAt recheck where it was picked, measure only nearby players spawn_category_for_position looked up the picked entry's type twice per attempt and asked mobsAt again at the position it had just picked the entry from. The type is now resolved when the entry is picked, and the recheck is skipped at that position (the list there holds the entry). The nearest player distance only feeds comparisons with 24 and the despawn distances (128 at most), so an attempt near its start measures only the players that can be within 128 blocks of it; farther ones read as infinitely far, which every check answers the same. The water-ambient biome tag is read only for that category. Same lists, same random draws. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../examples/natural_spawn_fixture.rs | 22 ++- .../src/game/natural_spawning.rs | 21 +-- .../src/mobs/spawn_selection.rs | 127 ++++++++++++++---- 3 files changed, 119 insertions(+), 51 deletions(-) diff --git a/crates/horizon-client/examples/natural_spawn_fixture.rs b/crates/horizon-client/examples/natural_spawn_fixture.rs index 528f8195d..e4c9b1ce6 100644 --- a/crates/horizon-client/examples/natural_spawn_fixture.rs +++ b/crates/horizon-client/examples/natural_spawn_fixture.rs @@ -111,6 +111,8 @@ struct World<'a> { slime: f32, starts: Vec<Start>, players: Vec<([f64; 3], String)>, + /// Where the non-spectators among them are. + nearest: Vec<[f64; 3]>, respawn: Option<[i32; 3]>, unloaded: HashSet<(i32, i32)>, spawn_mobs: bool, @@ -302,19 +304,8 @@ impl NaturalLevel for World<'_> { fn structure_spawns(&self) -> &StructureSpawns { self.s.structures } - fn nearest_player_distance_sqr(&self, x: f64, y: f64, z: f64) -> Option<f64> { - let mut best: Option<f64> = None; - for (p, mode) in &self.players { - if mode == "spectator" { - continue; - } - let d = [p[0] - x, p[1] - y, p[2] - z]; - let d = d[0] * d[0] + d[1] * d[1] + d[2] * d[2]; - if best.is_none_or(|b| d < b) { - best = Some(d); - } - } - best + fn nearest_player_positions(&self) -> &[[f64; 3]] { + &self.nearest } fn respawn(&self) -> Option<[i32; 3]> { self.respawn @@ -730,6 +721,11 @@ fn main() -> horizon_client::Result<()> { dimension_id: dimension_id.clone(), slime: get("slime", "0.0").parse()?, starts, + nearest: players + .iter() + .filter(|(_, mode)| mode != "spectator") + .map(|(p, _)| *p) + .collect(), players, respawn, unloaded, diff --git a/crates/horizon-client/src/game/natural_spawning.rs b/crates/horizon-client/src/game/natural_spawning.rs index 68aabbbc6..334e9bd7e 100644 --- a/crates/horizon-client/src/game/natural_spawning.rs +++ b/crates/horizon-client/src/game/natural_spawning.rs @@ -71,6 +71,8 @@ pub(super) struct GameLevel<'g, 'a> { pub(super) w: MobWorld<'g>, /// Every player in the level ([`Game::level_players`]). pub(super) players: Vec<LevelPlayer>, + /// Where the non-spectators among them are (`getNearestPlayer`). + pub(super) nearest: Vec<[f64; 3]>, /// Boxes of the mobs this pass created, not yet in the game's list. pub(super) pending: std::cell::RefCell<Vec<Aabb>>, /// The types and boxes of what a spawner created this tick. @@ -190,14 +192,8 @@ impl NaturalLevel for GameLevel<'_, '_> { fn structure_spawns(&self) -> &StructureSpawns { StructureSpawns::shared(&self.game.options.resources) } - fn nearest_player_distance_sqr(&self, x: f64, y: f64, z: f64) -> Option<f64> { - // The nearest player's distance (`nearest_player`), without finding - // which player it is: every spawn attempt asks. - self.players - .iter() - .filter(|p| !p.spectator) - .map(|p| p.distance_sqr(x, y, z)) - .reduce(f64::min) + fn nearest_player_positions(&self) -> &[[f64; 3]] { + &self.nearest } fn respawn(&self) -> Option<[i32; 3]> { // The world spawn point lives in the overworld. @@ -305,10 +301,17 @@ impl horizon_client::mobs::spawner::SpawnerLevel for GameLevel<'_, '_> { } impl<'a> Game<'a> { pub(super) fn natural_level(&self) -> GameLevel<'_, 'a> { + let players = self.level_players(); + let nearest = players + .iter() + .filter(|p| !p.spectator) + .map(|p| [p.position.x, p.position.y, p.position.z]) + .collect(); GameLevel { game: self, w: self.mob_world_base(&[]), - players: self.level_players(), + players, + nearest, pending: Default::default(), pending_ids: Default::default(), } diff --git a/crates/horizon-client/src/mobs/spawn_selection.rs b/crates/horizon-client/src/mobs/spawn_selection.rs index 614a2b2b5..046583a1f 100644 --- a/crates/horizon-client/src/mobs/spawn_selection.rs +++ b/crates/horizon-client/src/mobs/spawn_selection.rs @@ -351,6 +351,9 @@ fn spawns_far_from_player(s: Species, category: Category) -> bool { } /// What natural spawning reads from a level beyond the spawn rules. +/// An entity type's species, width, height and category. +pub type MobType = (Species, f32, f32, Category); + pub trait NaturalLevel: SpawnLevel { fn min_y(&self) -> i32; /// `getMaxY()`: the highest buildable block. @@ -359,7 +362,7 @@ pub trait NaturalLevel: SpawnLevel { fn ambient_light(&self) -> f32; fn has_ceiling(&self) -> bool; /// The entity type's species, width, height and category. - fn mob_type(&self, entity: &str) -> Option<(Species, f32, f32, Category)>; + fn mob_type(&self, entity: &str) -> Option<MobType>; /// The `natural_mob_spawns` lists by category at a position. fn biome_spawns(&self, x: i32, y: i32, z: i32) -> Option<&HashMap<String, Vec<SpawnEntry>>>; /// The `natural_mob_spawns` spawn cost of a type at a position. @@ -376,9 +379,9 @@ pub trait NaturalLevel: SpawnLevel { wanted: &dyn Fn(&str) -> bool, ) -> Vec<StructureAt>; fn structure_spawns(&self) -> &StructureSpawns; - /// `getNearestPlayer(x, y, z, -1, false)`: the squared distance to the - /// nearest player that is not a spectator. - fn nearest_player_distance_sqr(&self, x: f64, y: f64, z: f64) -> Option<f64>; + /// Where the players `getNearestPlayer(x, y, z, -1, false)` measures to + /// are: every one that is not a spectator. + fn nearest_player_positions(&self) -> &[[f64; 3]]; /// The world spawn point, when it is in this dimension. fn respawn(&self) -> Option<[i32; 3]>; /// `ServerLevel.canSpawnEntitiesInChunk`. @@ -870,9 +873,13 @@ impl SpawnState { /// `ChunkMap.getPlayersCloseForSpawning`: none past the natural spawn /// chunk tracker's range of 8 chunks from every player, else the /// non-spectators within 128 blocks of the chunk's centre. - fn players_near(&mut self, cx: i32, cz: i32) -> &[usize] { - let players = &self.players; - self.players_near.entry((cx, cz)).or_insert_with(|| { + fn players_near<'a>( + near: &'a mut FxHashMap<(i32, i32), Vec<usize>>, + players: &[SpawnPlayer], + cx: i32, + cz: i32, + ) -> &'a [usize] { + near.entry((cx, cz)).or_insert_with(|| { let tracked = players.iter().any(|p| { let (px, pz) = ( (p.position[0].floor() as i32) >> 4, @@ -896,8 +903,7 @@ impl SpawnState { }) } fn add_local(&mut self, cx: i32, cz: i32, category: Category) { - let near = self.players_near(cx, cz).to_vec(); - for p in near { + for &p in Self::players_near(&mut self.players_near, &self.players, cx, cz) { self.player_counts.entry(p).or_insert([0; 8])[category.index()] += 1; } } @@ -908,10 +914,10 @@ impl SpawnState { } /// `canSpawnForCategoryLocal` (`LocalMobCapCalculator.canSpawn`). pub fn can_spawn_local(&mut self, category: Category, cx: i32, cz: i32) -> bool { - let near = self.players_near(cx, cz).to_vec(); - near.into_iter().any(|p| { + let near = Self::players_near(&mut self.players_near, &self.players, cx, cz); + near.iter().any(|p| { self.player_counts - .get(&p) + .get(p) .is_none_or(|c| c[category.index()] < category.max()) }) } @@ -1080,9 +1086,11 @@ pub fn spawn_category_for_position<L: NaturalLevel, R: RandomSource>( } let mut spawned: Vec<Aabb> = Vec::new(); let mut cluster = 0u32; + let mut nearest = Nearest::new(start); for _ in 0..3 { let (mut x, mut z) = (x0, z0); - let mut current: Option<SpawnEntry> = None; + // The group's entry, its type and where it was picked. + let mut current: Option<(SpawnEntry, Option<MobType>, [i32; 3])> = None; let mut group_index = 0u32; let mut max = (random.next_float() * 4.0).ceil() as i32; let mut ll = 0; @@ -1092,16 +1100,15 @@ pub fn spawn_category_for_position<L: NaturalLevel, R: RandomSource>( z += random.next_int_bound(6).unwrap_or(0) - random.next_int_bound(6).unwrap_or(0); let (xx, zz) = (f64::from(x) + 0.5, f64::from(z) + 0.5); trace(Event::Try(x, z)); - let Some(distance) = l.nearest_player_distance_sqr(xx, f64::from(y), zz) else { + let Some(distance) = nearest.distance_sqr(l, xx, f64::from(y), zz) else { continue; }; if !right_distance(l, chunk, [x, y, z], distance) { continue; } if current.is_none() { - let reduced = l.biome_tag("minecraft:reduce_water_ambient_spawns", x, y, z); let list = if category == Category::WaterAmbient - && reduced + && l.biome_tag("minecraft:reduce_water_ambient_spawns", x, y, z) && random.next_float() < 0.98 { None @@ -1112,21 +1119,32 @@ pub fn spawn_category_for_position<L: NaturalLevel, R: RandomSource>( break; }; max = sample_count(&entry, random) as i32; - current = Some(entry); + let kind = l.mob_type(&entry.entity); + current = Some((entry, kind, [x, y, z])); } - let entry = current.as_ref().unwrap_or_else(|| unreachable!()); - if !valid_position_for_type(l, random, category, entry, [x, y, z], distance) { + let (entry, kind, picked_at) = current.as_ref().unwrap_or_else(|| unreachable!()); + // The list the entry was picked from holds it where it was picked. + let listed = *picked_at == [x, y, z]; + let valid = valid_position_for_type( + l, + random, + category, + entry, + *kind, + listed, + [x, y, z], + distance, + ); + let Some((species, width, height, type_category)) = (*kind).filter(|_| valid) else { continue; - } + }; let passed = state.can_spawn(l, &entry.entity, [x, y, z]); trace(Event::Test(entry.entity.clone(), [x, y, z], passed)); if !passed { continue; } - // getMobForSpawn: a type the game cannot create ends the pass. - let Some((species, width, height, type_category)) = l.mob_type(&entry.entity) else { - return; - }; + // getMobForSpawn (a type the game cannot create, which would end + // the pass, never passes isValidSpawnPostitionForType). let yaw = random.next_float() * 360.0; let bounds = spawn_box(xx, f64::from(y), zz, width, height); let despawn = f64::from(type_category.despawn_distance().pow(2)); @@ -1167,6 +1185,52 @@ pub fn spawn_category_for_position<L: NaturalLevel, R: RandomSource>( } } } +/// `getNearestPlayer(x, y, z, -1, false)`'s squared distance for the +/// attempts of one start. The spawn checks only compare it with 24² and the +/// despawn distances (128² at most), so it is measured only to the players +/// that can be within 128 blocks of an attempt near the start: when none is, +/// the nearest reads as infinitely far, which every check answers as it +/// answers the real distance. An attempt that wanders farther than +/// `MARGIN` from the start measures every player. +struct Nearest { + /// The players that can be within 128 blocks, once an attempt asked. + nearby: Option<Vec<[f64; 3]>>, + start: (f64, f64), +} +impl Nearest { + const REACH: f64 = 128.0; + const MARGIN: f64 = 64.0; + fn new(start: [i32; 3]) -> Self { + Self { + nearby: None, + start: (f64::from(start[0]) + 0.5, f64::from(start[2]) + 0.5), + } + } + fn distance_sqr<L: NaturalLevel>(&mut self, l: &L, x: f64, y: f64, z: f64) -> Option<f64> { + let all = l.nearest_player_positions(); + if all.is_empty() { + return None; + } + let distance = |p: &[f64; 3]| (p[0] - x).powi(2) + (p[1] - y).powi(2) + (p[2] - z).powi(2); + let (sx, sz) = self.start; + if (x - sx).abs() > Self::MARGIN || (z - sz).abs() > Self::MARGIN { + return all.iter().map(distance).reduce(f64::min); + } + // The others are farther than REACH, across, from every point within + // MARGIN of the start. + let nearby = self.nearby.get_or_insert_with(|| { + all.iter() + .filter(|p| { + let dx = ((p[0] - sx).abs() - Self::MARGIN).max(0.0); + let dz = ((p[2] - sz).abs() - Self::MARGIN).max(0.0); + dx * dx + dz * dz <= Self::REACH * Self::REACH + }) + .copied() + .collect() + }); + Some(nearby.iter().map(distance).fold(f64::INFINITY, f64::min)) + } +} /// `isRightDistanceToPlayerAndSpawnPoint`. fn right_distance<L: NaturalLevel>(l: &L, chunk: (i32, i32), pos: [i32; 3], distance: f64) -> bool { if distance <= 576.0 { @@ -1185,16 +1249,20 @@ fn right_distance<L: NaturalLevel>(l: &L, chunk: (i32, i32), pos: [i32; 3], dist let (cx, cz) = (pos[0] >> 4, pos[2] >> 4); (cx, cz) == chunk || l.can_spawn_in_chunk(cx, cz) } -/// `isValidSpawnPostitionForType`. +/// `isValidSpawnPostitionForType`, for the entry's type (`mob_type`). +/// `listed`: the position is where the entry was picked from `mobsAt`. +#[allow(clippy::too_many_arguments)] fn valid_position_for_type<L: NaturalLevel, R: RandomSource>( l: &L, random: &mut R, category: Category, entry: &SpawnEntry, + kind: Option<MobType>, + listed: bool, pos: [i32; 3], distance: f64, ) -> bool { - let Some((species, width, height, type_category)) = l.mob_type(&entry.entity) else { + let Some((species, width, height, type_category)) = kind else { return false; }; if type_category == Category::Misc { @@ -1205,9 +1273,10 @@ fn valid_position_for_type<L: NaturalLevel, R: RandomSource>( return false; } let [x, y, z] = pos; - if !mobs_at(l, category, x, y, z) - .iter() - .any(|e| same_spawner(e, entry)) + if !listed + && !mobs_at(l, category, x, y, z) + .iter() + .any(|e| same_spawner(e, entry)) { return false; } From e4ea9e0199d3a2bbf4f99aa761e212b2bb897ca9 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Thu, 22 Oct 2026 16:54:09 +0100 Subject: [PATCH 023/126] Cache weather column parameters and animate atlas UVs in shader --- .../examples/weather_fixture.rs | 8 + crates/horizon-client/src/entity.wgsl | 133 +++++++ crates/horizon-client/src/game.rs | 122 +++---- crates/horizon-client/src/gfx.rs | 26 +- crates/horizon-client/src/gfx/weather.rs | 330 ++++++++++++++++++ crates/horizon-client/src/weather.rs | 255 +++++++++++++- tools/test_weather_render_parity.py | 4 +- 7 files changed, 810 insertions(+), 68 deletions(-) create mode 100644 crates/horizon-client/src/gfx/weather.rs diff --git a/crates/horizon-client/examples/weather_fixture.rs b/crates/horizon-client/examples/weather_fixture.rs index 15aab6bdb..3cf6c31be 100644 --- a/crates/horizon-client/examples/weather_fixture.rs +++ b/crates/horizon-client/examples/weather_fixture.rs @@ -11,6 +11,7 @@ fn bits(value: f32) -> String { fn main() -> Result<(), Box<dyn std::error::Error>> { let args: Vec<_> = std::env::args().collect(); let mut output = String::new(); + let mut parameters = weather::ParameterCache::default(); for (case, line) in fs::read_to_string(&args[1])?.lines().enumerate() { let p: Vec<&str> = line.split_whitespace().collect(); let int = |i: usize| p[i].parse::<i32>().unwrap(); @@ -38,6 +39,13 @@ fn main() -> Result<(), Box<dyn std::error::Error>> { bits(column.v_offset), column.light_coords )?; + assert_eq!( + parameters + .get(x, z) + .column(kind != 0, ticks, x, bottom, top, z, light, partial), + column, + "cached parameters differ from original random source at case {case}" + ); let max_alpha = if kind == 0 { 1.0 } else { 0.8 }; for v in weather::column_quad(&column, camera, max_alpha, radius, intensity) { write!( diff --git a/crates/horizon-client/src/entity.wgsl b/crates/horizon-client/src/entity.wgsl index 2c6af26f9..99211ec5f 100644 --- a/crates/horizon-client/src/entity.wgsl +++ b/crates/horizon-client/src/entity.wgsl @@ -43,6 +43,7 @@ struct Out { @location(8) back_color: vec4<f32>, // entity.vsh's lightMapColor, multiplied in after the overlay. @location(9) light_color: vec4<f32>, + @location(10) @interpolate(flat) weather_rect: vec4<f32>, } // Shipped light.glsl; normals are already transformed and RGBA8_SNORM packed. fn entity_light(normal: vec3<f32>, nether: bool) -> f32 { @@ -209,3 +210,135 @@ fn linear_fog(d: f32, start: f32, end: f32) -> f32 { @fragment fn fs_water_mask() -> @location(0) vec4<f32> { return vec4(0.0); } + +// WEATHER_MATH_BEGIN +// Unsigned 64-bit helpers (low word first). Snow adds a random double to a +// float drift before casting to float. Retaining the 53-bit base avoids early +// rounding, including ties, without requiring optional GPU float64 support. +fn weather_shr_jam(v: vec2<u32>, n: u32) -> vec2<u32> { + if n == 0u { return v; } + if n < 32u { + return vec2((v.x >> n) | (v.y << (32u - n)) | select(0u, 1u, (v.x << (32u - n)) != 0u), v.y >> n); + } + if n == 32u { return vec2(v.y | select(0u, 1u, v.x != 0u), 0u); } + if n < 64u { + return vec2((v.y >> (n - 32u)) | select(0u, 1u, v.x != 0u || (v.y << (64u - n)) != 0u), 0u); + } + return vec2(select(0u, 1u, any(v != vec2(0u))), 0u); +} +fn weather_add64(a: vec2<u32>, b: vec2<u32>) -> vec2<u32> { + let lo = a.x + b.x; + return vec2(lo, a.y + b.y + select(0u, 1u, lo < a.x)); +} +fn weather_sub64(a: vec2<u32>, b: vec2<u32>) -> vec2<u32> { + return vec2(a.x - b.x, a.y - b.y - select(0u, 1u, a.x < b.x)); +} +fn weather_double_plus_float(base: vec2<u32>, delta: f32) -> f32 { + // The random base is nonnegative and either zero or >= 2^-53. + if all(base == vec2(0u)) { return select(delta, 0.0, delta == 0.0); } + let db = bitcast<u32>(delta); + let mag = db & 0x7fffffffu; + let be = i32((base.y >> 20u) & 2047u) - 1023; + var de = i32(mag >> 23u) - 127; + var dm = (mag & 0x7fffffu) | 0x800000u; + if mag < 0x800000u { + dm = mag; + if dm == 0u { de = -200; } + else { + let shift = countLeadingZeros(dm) - 8u; + dm <<= shift; + de = -126 - i32(shift); + } + } + let e = max(be, de); + // Leading significand bit at 61, with room for addition and guard bits. + var a = vec2(base.x << 9u, ((base.y & 0xfffffu) | 0x100000u) << 9u | (base.x >> 23u)); + var b = vec2(0u, dm << 6u); + a = weather_shr_jam(a, u32(e - be)); + b = weather_shr_jam(b, u32(e - de)); + var sign = 0u; + var value: vec2<u32>; + if (db >> 31u) == 0u { value = weather_add64(a, b); } + else if a.y > b.y || (a.y == b.y && a.x >= b.x) { value = weather_sub64(a, b); } + else { value = weather_sub64(b, a); sign = 0x80000000u; } + if all(value == vec2(0u)) { return 0.0; } + let leading = select(31u - countLeadingZeros(value.x), 63u - countLeadingZeros(value.y), value.y != 0u); + var exponent = e + i32(leading) - 61; + // Normalize the leading bit to 62. After jamming, bit 38 is the guard + // bit and bits 0..37 distinguish a tie from a value above the midpoint. + let shift = 62u - leading; + if shift >= 32u { value = vec2(0u, value.x << (shift - 32u)); } + else if shift != 0u { value = vec2(value.x << shift, (value.y << shift) | (value.x >> (32u - shift))); } + // Vanilla first rounds the addition to double, then casts to float. + // Round at bit 10 (53 retained bits) before the 24-bit rounding below; + // otherwise a double-rounding midpoint can select the wrong float. + let double_guard = (value.x & 512u) != 0u; + let double_sticky = (value.x & 511u) != 0u; + let double_odd = (value.x & 1024u) != 0u; + value.x &= 0xfffffc00u; + if double_guard && (double_sticky || double_odd) { + value = weather_add64(value, vec2(1024u, 0u)); + } + if (value.y & 0x80000000u) != 0u { + value = weather_shr_jam(value, 1u); + exponent += 1; + } + var mantissa = value.y >> 7u; + let guard = (value.y & 64u) != 0u; + let sticky = (value.y & 63u) != 0u || value.x != 0u; + if guard && (sticky || (mantissa & 1u) != 0u) { mantissa += 1u; } + if mantissa >= 0x1000000u { mantissa >>= 1u; exponent += 1; } + return bitcast<f32>(sign | (u32(exponent + 127) << 23u) | (mantissa & 0x7fffffu)); +} +fn weather_phase(animation: vec4<f32>, bases: vec4<u32>, snow: u32, time: vec4<f32>) -> vec2<f32> { + if snow == 0u { + let ticks = time.x + animation.y; + let t = ticks + time.z; + let step = -t / 32.0; + let offset = step * animation.x; + return vec2(0.0, offset % 32.0); + } + let t = time.x + time.z; + let u_time = t * 0.01; + let du = u_time * animation.z; + let v_time = t * animation.w; + let dv = v_time * 0.001; + let u = weather_double_plus_float(bases.xy, du); + let v = weather_double_plus_float(bases.zw, dv); + let fall_time = time.y + time.z; + let fall = -fall_time / 512.0; + return vec2(u, fall + v); +} +// Atlas sampler is nearest with no mipmaps. Clamp the integer texel inside +// the sprite even when a fractional coordinate rounds up at its far edge. +fn weather_texel(uv: vec2<f32>, rect: vec4<f32>, dimensions: vec2<u32>) -> vec2<i32> { + let size = vec2<f32>(dimensions); + let origin = vec2<i32>(round(rect.xy * size)); + let extent = max(vec2<i32>(round(rect.zw * size)), vec2(1)); + let local = min(vec2<i32>(floor(fract(uv) * vec2<f32>(extent))), extent - vec2(1)); + return origin + local; +} +// WEATHER_MATH_END + +struct WeatherTime { values: vec4<f32> } +@group(1) @binding(1) var<uniform> weather_time: WeatherTime; +@vertex fn vs_weather(@location(0) position: vec3<f32>, @location(1) uv: vec2<f32>, + @location(2) rect: vec4<f32>, @location(3) animation: vec4<f32>, + @location(4) bases: vec4<u32>, @location(5) color: vec4<f32>, + @location(6) light: vec4<u32>, @location(7) snow: u32) -> Out { + let phase = weather_phase(animation, bases, snow, weather_time.values); + var out = entity_vertex(position, uv + phase, 0u, color, light, vec4(0.0)); + out.weather_rect = rect; + return out; +} +@fragment fn fs_weather(in: Out) -> @location(0) vec4<f32> { + // Repeat within this sprite, never across the atlas. The atlas uses nearest + // filtering and no mipmaps, so fractional UVs have no seam derivatives. + let texel = weather_texel(in.uv, in.weather_rect, textureDimensions(atlas)); + var color = textureLoad(atlas, texel, 0) * in.color; + if color.a < 0.1 { discard; } + color *= in.light_color; + let f = max(linear_fog(in.spherical, globals.fog.x, globals.fog.y), + linear_fog(in.cylindrical, globals.fog.z, globals.fog.w)); + return vec4(mix(color.rgb, globals.fog_color.rgb, f * globals.fog_color.a), color.a); +} diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index f706e9348..5c8d64d18 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -1110,6 +1110,7 @@ struct Game<'a> { /// `FogRenderer`'s evolving state. fog: horizon_client::fog::FogState, screen_fx: horizon_client::screen_effects::ScreenEffects, + weather_parameters: horizon_client::weather::ParameterCache, panorama_rotation: horizon_client::gfx::panorama::Rotation, world: World, streaming: Streaming, @@ -8942,89 +8943,84 @@ impl Game<'_> { } } /// WeatherEffectRenderer: rain and snow columns within the weather radius. - fn weather_geometry(&self, camera: glam::DVec3, alpha: f64, out: &mut Vec<Vertex>) { + fn weather_geometry( + &mut self, + camera: glam::DVec3, + alpha: f64, + ) -> Vec<horizon_client::weather::Vertex> { use horizon_client::weather; let (intensity, _) = self.world.weather.levels(alpha as f32); if intensity <= 0.0 { - return; + return Vec::new(); } let atlas = &self.gui.atlas; let (Some(rain_tex), Some(snow_tex)) = ( atlas.sprites.get("environment/rain").copied(), atlas.sprites.get("environment/snow").copied(), ) else { - return; + return Vec::new(); }; let (cx, cy, cz) = ( camera.x.floor() as i32, camera.y.floor() as i32, camera.z.floor() as i32, ); - let radius = self.settings.weather_radius; - let ticks = self.world.game_time; - let partial = alpha as f32; - let eye = [camera.x, camera.y, camera.z]; - // Vanilla draws every rain column before the snow ones. - let mut columns = (Vec::new(), Vec::new()); - for z in cz - radius..=cz + radius { - for x in cx - radius..=cx + radius { + // The 32x32 direction table supports at most a 15-block radius. + let radius = self.settings.weather_radius.clamp(0, 15); + let eye = camera.to_array(); + let mut rain = Vec::new(); + let mut snow_vertices = Vec::new(); + // Saturation keeps extreme camera coordinates from overflowing the loop. + for z in cz.saturating_sub(radius)..=cz.saturating_add(radius) { + for x in cx.saturating_sub(radius)..=cx.saturating_add(radius) { let top = self.rain_height(x, z); - let y0 = (cy - radius).max(top); - let y1 = (cy + radius).max(top); + let y0 = cy.saturating_sub(radius).max(top); + let y1 = cy.saturating_add(radius).max(top); if y1 == y0 { continue; } let Some(snow) = self.precipitation(x, cy, z) else { continue; }; - let mut random = weather::column_random(x, z); + let parameters = self.weather_parameters.get(x, z); let light = self.world.light(x, top.max(cy), z); let coords = i32::from(light & 15) << 4 | i32::from(light >> 4) << 20; - if snow { - columns.1.push(weather::snow_column( - &mut random, - ticks, - x, - y0, - y1, - z, - coords, - partial, - )); + // Only light brightening is needed here; UV phases stay zero. + let lc = if snow { + let (block, sky) = (coords >> 4 & 15, coords >> 20 & 15); + ((block * 3 + 15) / 4) << 4 | ((sky * 3 + 15) / 4) << 20 } else { - columns.0.push(weather::rain_column( - &mut random, - ticks, - x, - y0, - y1, - z, - coords, - partial, - )); + coords + }; + let column = weather::Column { + x, + z, + bottom_y: y0, + top_y: y1, + u_offset: 0.0, + v_offset: 0.0, + light_coords: lc, + }; + let r = if snow { snow_tex } else { rain_tex }; + let vertices = weather::vertices( + &column, + parameters, + snow, + eye, + radius, + intensity, + [r.u0, r.v0, r.u1 - r.u0, r.v1 - r.v0], + ); + if snow { + snow_vertices.extend(vertices); + } else { + rain.extend(vertices); } } } - let rain = columns.0.iter().map(|c| (c, 1.0, rain_tex)); - let snow = columns.1.iter().map(|c| (c, 0.8, snow_tex)); - for (column, max_alpha, r) in rain.chain(snow) { - let quad = weather::column_quad(column, eye, max_alpha, radius, intensity); - let color = quad[0].color; - let lc = quad[0].light_coords; - let light = ((lc >> 20 & 15) * 16) as u32 | (((lc >> 4 & 15) * 16) as u32) << 8; - weather::tile(&quad, |pos, uvs| { - for (p, [u, v]) in pos.into_iter().zip(uvs) { - out.push(Vertex { - normal: [0; 4], - pos: p, - uv: [r.u0 + (r.u1 - r.u0) * u, r.v0 + (r.v1 - r.v0) * v], - layer: 0, - color, - light, - }); - } - }); - } + // Vanilla draws every rain column before the snow ones. + rain.extend(snow_vertices); + rain } /// Player.startSleepInBed: night or thunder, no monsters within 8 blocks; /// the bed becomes the respawn point either way. @@ -9830,11 +9826,12 @@ impl Game<'_> { if !title { self.end_geometry(camera, &mut entities); } - if (!title || live) && self.dim == Dim::Overworld && self.settings.horizon.weather { - horizon_client::spans::time("weather", || { - self.weather_geometry(camera, alpha, &mut entities) - }); - } + let weather = + if (!title || live) && self.dim == Dim::Overworld && self.settings.horizon.weather { + horizon_client::spans::time("weather", || self.weather_geometry(camera, alpha)) + } else { + Vec::new() + }; let border = (!title) .then(|| self.border_draw(camera.to_array(), alpha as f32)) .flatten(); @@ -9845,6 +9842,8 @@ impl Game<'_> { self.gather_dynamic_lights(camera, alpha); } let frame = Frame { + weather: &weather, + weather_time: horizon_client::weather::Time::new(self.world.game_time, alpha as f32), shader: self.shader_inputs(camera, alpha as f32), nether_lighting: self.dim == Dim::Nether, camera, @@ -11438,6 +11437,7 @@ impl<'a> Game<'a> { gui, fog: Default::default(), screen_fx: Default::default(), + weather_parameters: Default::default(), panorama_rotation: Default::default(), world, streaming, @@ -12349,6 +12349,8 @@ fn loading_renderer( /// A title-shaped frame: black clear and panorama, only the HUD is drawn. fn loading_frame(hud: &HudBatch) -> Frame<'_> { Frame { + weather: &[], + weather_time: horizon_client::weather::Time::new(0, 0.0), camera: glam::DVec3::new(0.5, 100.0, 0.5), yaw: 0.0, pitch: 10.0, diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 14c040c5c..41576bd5f 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -33,6 +33,7 @@ fn entity_shader() -> String { } mod entity_batch; +mod weather; use entity_batch::EntityBatch; pub use entity_batch::WATER_MASK_OVERLAY; @@ -189,6 +190,8 @@ pub struct Frame<'a> { pub nether_lighting: bool, /// Camera-relative entity geometry textured from the shared atlas. pub entities: &'a [Vertex], + pub weather: &'a [crate::weather::Vertex], + pub weather_time: crate::weather::Time, /// Horizon Extras' dynamic lights, nearest first (`dynamic_light::select`); empty when off. pub dynamic_lights: &'a [[f32; 4]], /// Cloud mesh inputs; geometry and GPU storage are retained by the renderer. @@ -324,6 +327,7 @@ pub struct Renderer { crosshair_group: wgpu::BindGroup, crosshair_globals: wgpu::Buffer, entity_pipeline: wgpu::RenderPipeline, + weather: weather::Weather, crumbling_pipeline: wgpu::RenderPipeline, /// `RenderPipelines.WATER_MASK`: depth writes only, no colour. water_mask_pipeline: wgpu::RenderPipeline, @@ -1445,6 +1449,12 @@ impl Renderer { ), ], }); + let weather = weather::Weather::new( + &device, + config.format.remove_srgb_suffix(), + &entity_bindings, + &entity_shader, + ); let atlas_sampler = device.create_sampler(&wgpu::SamplerDescriptor { label: Some("Atlas"), ..Default::default() @@ -2101,6 +2111,7 @@ impl Renderer { crosshair_group, crosshair_globals, entity_pipeline, + weather, crumbling_pipeline, water_mask_pipeline, cloud_pipeline, @@ -3229,6 +3240,13 @@ impl Renderer { bytemuck::cast_slice(&all), ); } + self.weather.prepare( + &self.device, + &mut encoder, + &mut self.uploads, + frame.weather, + frame.weather_time, + ); let outline_edges = frame.outline.len().min(MAX_OUTLINE_EDGES as usize); if outline_edges > 0 { let lines = outline_vertices(&frame.outline[..outline_edges], camera); @@ -3246,6 +3264,7 @@ impl Renderer { frame.hand, frame.see_through, ); + let weather_quads = frame.weather.len() as u32 / 4; let world_quads = entity_quads + crumbling_quads + translucent_crumbling_quads + water_mask_quads; let cloud_quads = if let Some(input) = &frame.clouds { @@ -3318,8 +3337,9 @@ impl Renderer { bytemuck::cast_slice(&frame.celestial[..celestial_vertices]), ); } - let max_quads = - (world_quads + additive_quads + hand_quads + see_through_quads).max(cloud_quads); + let max_quads = (world_quads + additive_quads + hand_quads + see_through_quads) + .max(cloud_quads) + .max(weather_quads); if max_quads > self.index_quads { self.index_quads = max_quads.next_power_of_two(); self.indices = Self::quad_indices(&self.device, self.index_quads); @@ -3602,6 +3622,8 @@ impl Renderer { pass.draw_indexed(0..entity_quads * 6, 0, 0..1); pass.set_bind_group(0, &self.group, &[]); } + self.weather.draw(&mut pass, &self.entity_group); + pass.set_bind_group(0, &self.group, &[]); if crumbling_quads > 0 { pass.set_pipeline(&self.crumbling_pipeline); pass.set_bind_group(0, &self.entity_group, &[]); diff --git a/crates/horizon-client/src/gfx/weather.rs b/crates/horizon-client/src/gfx/weather.rs new file mode 100644 index 000000000..15886b8f2 --- /dev/null +++ b/crates/horizon-client/src/gfx/weather.rs @@ -0,0 +1,330 @@ +//! Weather's unsplit quads, using the entity atlas/lightmap resources. +use crate::weather::{Time, Vertex}; + +pub(super) struct Weather { + pipeline: wgpu::RenderPipeline, + group: wgpu::BindGroup, + uniform: wgpu::Buffer, + vertices: wgpu::Buffer, + capacity: usize, + count: u32, +} +impl Weather { + pub fn new( + device: &wgpu::Device, + format: wgpu::TextureFormat, + entities: &wgpu::BindGroupLayout, + shader: &wgpu::ShaderModule, + ) -> Self { + let bindings = device.create_bind_group_layout(&wgpu::BindGroupLayoutDescriptor { + label: Some("Weather time"), + entries: &[wgpu::BindGroupLayoutEntry { + binding: 1, + visibility: wgpu::ShaderStages::VERTEX, + ty: wgpu::BindingType::Buffer { + ty: wgpu::BufferBindingType::Uniform, + has_dynamic_offset: false, + min_binding_size: None, + }, + count: None, + }], + }); + let layout = device.create_pipeline_layout(&wgpu::PipelineLayoutDescriptor { + label: Some("Weather layout"), + bind_group_layouts: &[Some(entities), Some(&bindings)], + ..Default::default() + }); + let attributes = wgpu::vertex_attr_array![0=>Float32x3,1=>Float32x2,2=>Float32x4, + 3=>Float32x4,4=>Uint32x4,5=>Unorm8x4,6=>Uint8x4,7=>Uint32]; + let pipeline = device.create_render_pipeline(&wgpu::RenderPipelineDescriptor { + label: Some("Weather"), + layout: Some(&layout), + vertex: wgpu::VertexState { + module: shader, + entry_point: Some("vs_weather"), + compilation_options: Default::default(), + buffers: &[Some(wgpu::VertexBufferLayout { + array_stride: std::mem::size_of::<Vertex>() as u64, + step_mode: wgpu::VertexStepMode::Vertex, + attributes: &attributes, + })], + }, + primitive: wgpu::PrimitiveState { + topology: wgpu::PrimitiveTopology::TriangleList, + ..Default::default() + }, + depth_stencil: Some(wgpu::DepthStencilState { + format: wgpu::TextureFormat::Depth32Float, + depth_write_enabled: Some(true), + depth_compare: Some(wgpu::CompareFunction::GreaterEqual), + stencil: Default::default(), + bias: Default::default(), + }), + multisample: Default::default(), + fragment: Some(wgpu::FragmentState { + module: shader, + entry_point: Some("fs_weather"), + compilation_options: Default::default(), + targets: &[Some(wgpu::ColorTargetState { + format, + blend: Some(wgpu::BlendState::ALPHA_BLENDING), + write_mask: wgpu::ColorWrites::ALL, + })], + }), + multiview_mask: None, + cache: None, + }); + let uniform = device.create_buffer(&wgpu::BufferDescriptor { + label: Some("Weather time"), + size: 16, + usage: wgpu::BufferUsages::UNIFORM | wgpu::BufferUsages::COPY_DST, + mapped_at_creation: false, + }); + let group = device.create_bind_group(&wgpu::BindGroupDescriptor { + label: Some("Weather time"), + layout: &bindings, + entries: &[wgpu::BindGroupEntry { + binding: 1, + resource: uniform.as_entire_binding(), + }], + }); + Self { + pipeline, + group, + uniform, + vertices: Self::buffer(device, 4), + capacity: 4, + count: 0, + } + } + fn buffer(device: &wgpu::Device, capacity: usize) -> wgpu::Buffer { + device.create_buffer(&wgpu::BufferDescriptor { + label: Some("Weather vertices"), + size: (capacity * std::mem::size_of::<Vertex>()) as u64, + usage: wgpu::BufferUsages::VERTEX | wgpu::BufferUsages::COPY_DST, + mapped_at_creation: false, + }) + } + pub fn prepare( + &mut self, + device: &wgpu::Device, + encoder: &mut wgpu::CommandEncoder, + uploads: &mut super::upload::Uploads, + vertices: &[Vertex], + time: Time, + ) { + self.count = vertices.len() as u32; + if vertices.is_empty() { + return; + } + if vertices.len() > self.capacity { + self.capacity = vertices.len().next_power_of_two(); + self.vertices = Self::buffer(device, self.capacity); + } + uploads.buffer(encoder, &self.vertices, 0, bytemuck::cast_slice(vertices)); + uploads.buffer(encoder, &self.uniform, 0, bytemuck::bytes_of(&time)); + } + pub fn draw(&self, pass: &mut wgpu::RenderPass<'_>, entities: &wgpu::BindGroup) { + if self.count == 0 { + return; + } + pass.set_pipeline(&self.pipeline); + pass.set_bind_group(0, entities, &[]); + pass.set_bind_group(1, &self.group, &[]); + pass.set_vertex_buffer(0, self.vertices.slice(..)); + // The renderer binds the shared triangle-list quad indices. + pass.draw_indexed(0..self.count / 4 * 6, 0, 0..1); + } +} + +#[cfg(test)] +mod tests { + use crate::weather::{Parameters, Time}; + use wgpu::util::DeviceExt; + + #[repr(C)] + #[derive(Clone, Copy, bytemuck::Pod, bytemuck::Zeroable)] + struct Case { + animation: [f32; 4], + bases: [u32; 4], + time: [f32; 4], + uv: [f32; 2], + snow: u32, + _pad: u32, + } + + /// Execute the production WGSL math, rather than a Rust translation of it. + /// Requires a GPU; run explicitly on renderer changes, not on headless CI. + #[test] + #[ignore = "requires a Vulkan/Metal/DX12 adapter"] + fn weather_shader_uvs_match_legacy_bits() { + let instance = wgpu::Instance::new(wgpu::InstanceDescriptor::new_without_display_handle()); + let adapter = + pollster::block_on(instance.request_adapter(&wgpu::RequestAdapterOptions::default())) + .unwrap(); + eprintln!("weather parity adapter: {:?}", adapter.get_info()); + let (device, queue) = + pollster::block_on(adapter.request_device(&wgpu::DeviceDescriptor::default())).unwrap(); + let mut cases = Vec::new(); + let mut expected = Vec::new(); + for i in 0..4096i32 { + let x = i.wrapping_mul(45_238_971); + let z = i.wrapping_mul(-418_711).wrapping_add(i32::MIN); + let p = Parameters::new(x, z); + let bases = p.snow_base.map(f64::to_bits); + for ticks in [-1, 0, 511, 512, 131_071, 131_072, i64::MAX] { + let partial = [0.0, 0.5, 0.999, f32::from_bits(0x3f7fffff)][i as usize % 4]; + for snow in [false, true] { + let column = p.column(snow, ticks, x, -64, 320, z, 0, partial); + let uv = [1.0, if i & 1 == 0 { -16.0 } else { 80.0 }]; + cases.push(Case { + animation: [ + p.rain_speed, + p.rain_tick_offset, + p.snow_drift[0], + p.snow_drift[1], + ], + bases: [ + bases[0] as u32, + (bases[0] >> 32) as u32, + bases[1] as u32, + (bases[1] >> 32) as u32, + ], + time: Time::new(ticks, partial).values, + uv, + snow: u32::from(snow), + _pad: 0, + }); + expected.push([ + (uv[0] + column.u_offset).to_bits(), + (uv[1] + column.v_offset).to_bits(), + ]); + } + } + } + // Force halfway rounding, cancellation, zero, tiny bases and either + // sign of drift. Gaussian seeds alone rarely land on exact midpoints. + for base in [ + 0.0, + 2.0f64.powi(-53), + 0.5, + 0.5 + 2.0f64.powi(-25), + 0.5 + 2.0f64.powi(-25) + 2.0f64.powi(-53), + 0.5 + 2.0f64.powi(-14) + 2.0f64.powi(-53), + 1.0 - 2.0f64.powi(-53), + ] { + for delta in [0.0f32, -0.0, -0.5, 0.5, 1024.0, -1024.0, 2.0f32.powi(-40)] { + // time=100, u scale=.01 -> delta exactly, v is unused. + let bits = base.to_bits(); + cases.push(Case { + animation: [3.0, 0.0, delta, 0.0], + bases: [bits as u32, (bits >> 32) as u32, 0, 0], + time: [100.0, 0.0, 0.0, 0.0], + uv: [0.0, 0.0], + snow: 1, + _pad: 0, + }); + expected.push([((base + f64::from(delta)) as f32).to_bits(), 0]); + } + } + let expected: Vec<[u32; 4]> = expected + .into_iter() + .map(|bits| { + let uv = bits.map(f32::from_bits); + let texel = [ + 256 + ((uv[0] - uv[0].floor()) * 16.0).floor() as u32, + 512 + ((uv[1] - uv[1].floor()) * 32.0).floor() as u32, + ]; + [bits[0], bits[1], texel[0], texel[1]] + }) + .collect(); + let math = include_str!("../entity.wgsl") + .split("// WEATHER_MATH_BEGIN") + .nth(1) + .unwrap() + .split("// WEATHER_MATH_END") + .next() + .unwrap(); + let source = format!( + "{math}\n{}", + r#" +struct Case { animation: vec4<f32>, bases: vec4<u32>, time: vec4<f32>, uv: vec2<f32>, snow: u32, pad: u32 } +@group(0) @binding(0) var<storage, read> cases: array<Case>; +@group(0) @binding(1) var<storage, read_write> results: array<vec4<u32>>; +@compute @workgroup_size(64) fn main(@builtin(global_invocation_id) id: vec3<u32>) { + if id.x >= arrayLength(&cases) { return; } + let c = cases[id.x]; + let uv = c.uv + weather_phase(c.animation, c.bases, c.snow, c.time); + let texel = weather_texel(uv, vec4(0.25, 0.5, 0.015625, 0.03125), vec2(1024u)); + results[id.x] = vec4(bitcast<vec2<u32>>(uv), vec2<u32>(texel)); +}"# + ); + let shader = device.create_shader_module(wgpu::ShaderModuleDescriptor { + label: Some("Weather parity"), + source: wgpu::ShaderSource::Wgsl(source.into()), + }); + let pipeline = device.create_compute_pipeline(&wgpu::ComputePipelineDescriptor { + label: Some("Weather parity"), + layout: None, + module: &shader, + entry_point: Some("main"), + compilation_options: Default::default(), + cache: None, + }); + let input = device.create_buffer_init(&wgpu::util::BufferInitDescriptor { + label: None, + contents: bytemuck::cast_slice(&cases), + usage: wgpu::BufferUsages::STORAGE, + }); + let size = (expected.len() * 16) as u64; + let output = device.create_buffer(&wgpu::BufferDescriptor { + label: None, + size, + usage: wgpu::BufferUsages::STORAGE | wgpu::BufferUsages::COPY_SRC, + mapped_at_creation: false, + }); + let readback = device.create_buffer(&wgpu::BufferDescriptor { + label: None, + size, + usage: wgpu::BufferUsages::MAP_READ | wgpu::BufferUsages::COPY_DST, + mapped_at_creation: false, + }); + let group = device.create_bind_group(&wgpu::BindGroupDescriptor { + label: None, + layout: &pipeline.get_bind_group_layout(0), + entries: &[ + wgpu::BindGroupEntry { + binding: 0, + resource: input.as_entire_binding(), + }, + wgpu::BindGroupEntry { + binding: 1, + resource: output.as_entire_binding(), + }, + ], + }); + let mut encoder = device.create_command_encoder(&Default::default()); + { + let mut pass = encoder.begin_compute_pass(&Default::default()); + pass.set_pipeline(&pipeline); + pass.set_bind_group(0, &group, &[]); + pass.dispatch_workgroups((cases.len() as u32).div_ceil(64), 1, 1); + } + encoder.copy_buffer_to_buffer(&output, 0, &readback, 0, size); + queue.submit([encoder.finish()]); + let (tx, rx) = std::sync::mpsc::channel(); + readback.map_async(wgpu::MapMode::Read, .., move |r| tx.send(r).unwrap()); + device.poll(wgpu::PollType::wait_indefinitely()).unwrap(); + rx.recv().unwrap().unwrap(); + let mapped = readback.get_mapped_range(..).unwrap(); + let actual: &[[u32; 4]] = bytemuck::cast_slice(&mapped); + for (i, (actual, expected)) in actual.iter().zip(&expected).enumerate() { + assert_eq!( + actual, expected, + "case {i}, snow={}, time={:?}, animation={:?}", + cases[i].snow, cases[i].time, cases[i].animation + ); + } + eprintln!("{} GPU weather UV cases matched bit for bit", cases.len()); + } +} diff --git a/crates/horizon-client/src/weather.rs b/crates/horizon-client/src/weather.rs index 3eb39e14c..d687604cb 100644 --- a/crates/horizon-client/src/weather.rs +++ b/crates/horizon-client/src/weather.rs @@ -3,8 +3,9 @@ //! Vanilla draws each column as one camera-facing quad whose texture //! coordinates run past 0..1 (`v` advances a quarter of the texture per block, //! so `rain.png` repeats every 4 blocks) and relies on a repeating sampler. -//! Horizon samples the sprite from its atlas, so [`tile`] splits a quad at -//! every whole texture repeat into pieces that stay inside the sprite. +//! The live renderer repeats UVs inside the atlas sprite in its shader, using +//! cached coordinate-only [`Parameters`]. The reference [`tile`] path splits +//! at whole repeats and remains available for CPU callers and parity probes. use horizon_core::random::{LegacyRandom, RandomSource}; /// `WeatherEffectRenderer.ColumnInstance`. @@ -47,6 +48,176 @@ pub fn column_random(x: i32, z: i32) -> LegacyRandom { LegacyRandom::new(i64::from(column_seed(x, z))) } +/// Coordinate-only random values. Keep the snow bases as doubles: rounding them +/// before adding the float drift changes vanilla's UVs at rounding boundaries. +#[derive(Clone, Copy, Debug)] +pub struct Parameters { + pub rain_speed: f32, + pub rain_tick_offset: f32, + pub snow_base: [f64; 2], + pub snow_drift: [f32; 2], +} +impl Parameters { + pub fn new(x: i32, z: i32) -> Self { + let rain_speed = 3.0 + column_random(x, z).next_float(); + let mut random = column_random(x, z); + let u = random.next_double(); + let du = random.next_gaussian() as f32; + let v = random.next_double(); + let dv = random.next_gaussian() as f32; + Self { + rain_speed, + rain_tick_offset: (x + .wrapping_mul(x) + .wrapping_mul(3121) + .wrapping_add(x.wrapping_mul(45_238_971)) + .wrapping_add(z.wrapping_mul(z).wrapping_mul(418_711)) + .wrapping_add(z.wrapping_mul(13761)) + & 255) as f32, + snow_base: [u, v], + snow_drift: [du, dv], + } + } + + /// CPU reference for fixtures and GPU differential tests. The public random + /// source helpers below retain their original draw/advancement semantics. + #[allow(clippy::too_many_arguments)] + pub fn column( + self, + snow: bool, + ticks: i64, + x: i32, + bottom_y: i32, + top_y: i32, + z: i32, + light_coords: i32, + partial: f32, + ) -> Column { + let time = (ticks & 131_071) as f32 + partial; + let (u_offset, v_offset, light_coords) = if snow { + let u = (self.snow_base[0] + f64::from(time * 0.01 * self.snow_drift[0])) as f32; + let v = (self.snow_base[1] + f64::from(time * self.snow_drift[1] * 0.001)) as f32; + let fall = -((ticks & 511) as f32 + partial) / 512.0; + let (block, sky) = (light_coords >> 4 & 15, light_coords >> 20 & 15); + ( + u, + fall + v, + ((block * 3 + 15) / 4) << 4 | ((sky * 3 + 15) / 4) << 20, + ) + } else { + let offset = -(((ticks & 131_071) as f32 + self.rain_tick_offset) + partial) / 32.0 + * self.rain_speed; + (0.0, offset % 32.0, light_coords) + }; + Column { + x, + z, + bottom_y, + top_y, + u_offset, + v_offset, + light_coords, + } + } +} + +/// Direct-mapped 32x32 cache: at most 1024 coordinate keys, including after +/// teleports or radius changes. Full keys disambiguate collisions and wrapping. +/// Nothing world-dependent is cached, so dimension/biome/pack changes need no +/// invalidation; the caller still samples heights, precipitation and light. +pub struct ParameterCache { + entries: Box<[Option<((i32, i32), Parameters)>]>, +} +impl Default for ParameterCache { + fn default() -> Self { + Self { + entries: vec![None; 32 * 32].into_boxed_slice(), + } + } +} +impl ParameterCache { + pub fn get(&mut self, x: i32, z: i32) -> Parameters { + let index = ((z as u32 & 31) * 32 + (x as u32 & 31)) as usize; + let entry = &mut self.entries[index]; + if let Some((key, parameters)) = entry + && *key == (x, z) + { + return *parameters; + } + let parameters = Parameters::new(x, z); + *entry = Some(((x, z), parameters)); + parameters + } +} + +/// One unsplit camera-relative weather vertex. UV animation and atlas-local +/// repetition happen in the weather shader, rather than rebuilding tiled quads. +#[repr(C)] +#[derive(Clone, Copy, Debug, bytemuck::Pod, bytemuck::Zeroable)] +pub struct Vertex { + pub pos: [f32; 3], + pub uv: [f32; 2], + pub rect: [f32; 4], + pub animation: [f32; 4], + pub bases: [u32; 4], + pub color: u32, + pub light: u32, + pub snow: u32, +} + +/// Current ticks are masked on the CPU before conversion to float, including +/// negative/large tick values. Do not use the renderer's unbounded game_time. +#[repr(C)] +#[derive(Clone, Copy, Debug, bytemuck::Pod, bytemuck::Zeroable)] +pub struct Time { + pub values: [f32; 4], +} +impl Time { + pub fn new(ticks: i64, partial: f32) -> Self { + Self { + values: [(ticks & 131_071) as f32, (ticks & 511) as f32, partial, 0.0], + } + } +} + +/// Emit a single quad, retaining column_quad's position, fade, UV rounding and +/// light semantics. The zero phase leaves the shader to animate both UV axes. +pub fn vertices( + column: &Column, + parameters: Parameters, + snow: bool, + camera: [f64; 3], + radius: i32, + intensity: f32, + rect: [f32; 4], +) -> [Vertex; 4] { + let quad = column_quad( + column, + camera, + if snow { 0.8 } else { 1.0 }, + radius, + intensity, + ); + let lc = column.light_coords; + let light = ((lc >> 20 & 15) * 16) as u32 | (((lc >> 4 & 15) * 16) as u32) << 8; + let [u, v] = parameters.snow_base.map(f64::to_bits); + quad.map(|q| Vertex { + pos: q.pos, + uv: q.uv, + rect, + animation: [ + parameters.rain_speed, + parameters.rain_tick_offset, + parameters.snow_drift[0], + parameters.snow_drift[1], + ], + bases: [u as u32, (u >> 32) as u32, v as u32, (v >> 32) as u32], + color: q.color, + light, + snow: u32::from(snow), + }) +} + /// `createRainColumnInstance`. #[allow(clippy::too_many_arguments)] pub fn rain_column( @@ -135,8 +306,8 @@ pub fn column_quad( let t = (distance_sq / radius_sq).min(1.0); let alpha = (max_alpha + t * (0.5 - max_alpha)) * intensity; let color = ((alpha * 255.0).floor() as i32 as u32) << 24 | 0xFF_FFFF; - let index = - (column.z - camera[2].floor() as i32 + 16) * 32 + column.x - camera[0].floor() as i32 + 16; + let index = (column.z - camera[2].floor() as i32 + 16) * 32 + + (column.x - camera[0].floor() as i32 + 16); let (size_x, size_z) = column_size(index as usize); let (half_x, half_z) = (size_x / 2.0, size_z / 2.0); let (x0, x1) = (relative_x - half_x, relative_x + half_x); @@ -219,6 +390,82 @@ fn pieces(a: f32, b: f32) -> impl Iterator<Item = (f32, f32)> { mod tests { use super::*; + #[test] + fn cached_parameters_match_original_random_draws() { + let mut cache = ParameterCache::default(); + for i in 0..2048i32 { + let x = i.wrapping_mul(45_238_971); + let z = i.wrapping_mul(-418_711).wrapping_add(i32::MIN); + for ticks in [i64::MIN, -1, 0, 511, 512, 131_071, 131_072, i64::MAX] { + for partial in [0.0, 0.5, 0.999] { + for snow in [false, true] { + let mut random = column_random(x, z); + let reference = if snow { + snow_column(&mut random, ticks, x, -64, 320, z, 0xf000f0, partial) + } else { + rain_column(&mut random, ticks, x, -64, 320, z, 0xf000f0, partial) + }; + assert_eq!( + cache + .get(x, z) + .column(snow, ticks, x, -64, 320, z, 0xf000f0, partial), + reference + ); + } + } + } + } + } + + #[test] + fn parameter_cache_reuses_full_keys_and_stays_bounded() { + let mut cache = ParameterCache::default(); + let expected = cache.get(-1, i32::MAX); + // A changed entry proves that a hit does not regenerate random values. + let index = 31 * 32 + 31; + cache.entries[index].as_mut().unwrap().1.rain_speed = 123.0; + assert_eq!(cache.get(-1, i32::MAX).rain_speed, 123.0); + // Colliding positions must replace the entry, rather than reuse it. + cache.get(31, -1); + assert_eq!(cache.get(-1, i32::MAX).rain_speed, expected.rain_speed); + for i in 0..100_000i32 { + cache.get(i.wrapping_mul(3121), i.wrapping_mul(418_711)); + } + assert_eq!(cache.entries.len(), 1024); + assert!(cache.entries.iter().flatten().count() <= 1024); + } + + #[test] + fn unsplit_vertices_keep_live_geometry_light_and_atlas_inputs() { + let x = i32::MAX - 5; + let z = i32::MIN + 5; + let parameters = Parameters::new(x, z); + let camera = [f64::from(x) - 2.25, 80.75, f64::from(z) + 0.25]; + for (bottom_y, top_y, light_coords, radius, intensity, rect) in [ + (64, 90, 0, 5, 0.25, [0.1, 0.2, 0.03, 0.04]), + (85, 95, 0xf000f0, 10, 1.0, [0.5, 0.5, 0.1, 0.2]), + ] { + let column = Column { + x, + z, + bottom_y, + top_y, + light_coords, + u_offset: 0.0, + v_offset: 0.0, + }; + let quad = column_quad(&column, camera, 1.0, radius, intensity); + let vertices = vertices(&column, parameters, false, camera, radius, intensity, rect); + for (a, b) in vertices.iter().zip(quad) { + assert_eq!(a.pos, b.pos); + assert_eq!(a.uv, b.uv); + assert_eq!(a.color, b.color); + assert_eq!(a.rect, rect); + assert_eq!(a.light, if light_coords == 0 { 0 } else { 0xf0f0 }); + } + } + } + #[test] fn rain_repeats_every_four_blocks() { let column = Column { diff --git a/tools/test_weather_render_parity.py b/tools/test_weather_render_parity.py index af713ec80..cf52156e0 100644 --- a/tools/test_weather_render_parity.py +++ b/tools/test_weather_render_parity.py @@ -12,8 +12,8 @@ def make_input(build): rng = random.Random(71) cases = [] for kind in (0, 1): - for ticks in (0, 1, 511, 512, 131071, 131072, 24000 * 37 + 5, 9_000_000_123): - for x, z in ((0, 0), (1, 0), (0, -1), (3, 7), (-10, 10), (10, -10), (-4, -9), (1_000_003, -2_000_011)): + for ticks in (-9223372036854775808, -1, 0, 1, 511, 512, 131071, 131072, 24000 * 37 + 5, 9_000_000_123, 9223372036854775807): + for x, z in ((0, 0), (1, 0), (0, -1), (3, 7), (-10, 10), (10, -10), (-4, -9), (1_000_003, -2_000_011), (30_000_000, -30_000_000), (2_147_483_631, -2_147_483_632)): for bottom, top in ((60, 80), (64, 65), (-64, -44), (300, 310)): light = (rng.randrange(16) << 4) | (rng.randrange(16) << 20) partial = rng.choice(("0.0", "0.5", "0.999", f"{rng.random():.6f}")) From fa14833b41782f59ef6087cce092081e813620e5 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Thu, 22 Oct 2026 16:56:23 +0100 Subject: [PATCH 024/126] perf(client): retain seeded lightning bolt geometry --- crates/horizon-client/src/entity.wgsl | 7 + crates/horizon-client/src/game.rs | 26 +- crates/horizon-client/src/game/lightning.rs | 85 +-- crates/horizon-client/src/gfx.rs | 52 +- crates/horizon-client/src/gfx/lightning.rs | 211 ++++++++ .../src/gfx/lightning/tests/mod.rs | 495 ++++++++++++++++++ 6 files changed, 790 insertions(+), 86 deletions(-) create mode 100644 crates/horizon-client/src/gfx/lightning.rs create mode 100644 crates/horizon-client/src/gfx/lightning/tests/mod.rs diff --git a/crates/horizon-client/src/entity.wgsl b/crates/horizon-client/src/entity.wgsl index 2c6af26f9..3b5dd9dcc 100644 --- a/crates/horizon-client/src/entity.wgsl +++ b/crates/horizon-client/src/entity.wgsl @@ -109,6 +109,13 @@ fn entity_vertex(position: vec3<f32>, uv: vec2<f32>, @location(2) overlay: u32, @location(3) color: vec4<f32>, @location(4) light: vec4<u32>, @location(5) normal: vec4<f32>) -> Out { return entity_vertex(position, uv, overlay, color, light, normal); } +// Retained bolt-local geometry, translated using the same f64 camera +// subtraction as the former CPU path before adding each local f32 position. +@vertex fn vs_lightning(@location(0) position: vec3<f32>, @location(1) uv: vec2<f32>, + @location(2) overlay: u32, @location(3) color: vec4<f32>, @location(4) light: vec4<u32>, @location(5) normal: vec4<f32>, + @location(6) offset: vec3<f32>) -> Out { + return entity_vertex(offset + position, uv, overlay, color, light, normal); +} struct CloudInfo { offset: vec4<f32>, colors: array<vec4<f32>, 4>, diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index f706e9348..c2d3b37e8 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -9782,15 +9782,17 @@ impl Game<'_> { self.entity_geometry(camera, alpha, entities) }); } + let bolts = if title { + Vec::new() + } else { + self.bolt_instances() + }; let mut additive = Vec::new(); - if !title { - self.bolt_geometry(camera, &mut additive); - if self.dim == Dim::End { - let mut dragon = Vec::new(); - self.dragon_geometry(camera, alpha, &mut dragon, &mut additive); - self.dragon_fireball_geometry(camera, alpha, &mut dragon); - entities.extend(dragon); - } + if !title && self.dim == Dim::End { + let mut dragon = Vec::new(); + self.dragon_geometry(camera, alpha, &mut dragon, &mut additive); + self.dragon_fireball_geometry(camera, alpha, &mut dragon); + entities.extend(dragon); } // A Java pack's `clouds` replaces the cloud option (`renderClouds`: // "false", "fast", "true"), as Iris overrides `getCloudsType`. @@ -9902,6 +9904,13 @@ impl Game<'_> { }), entities: &entities, dynamic_lights: &self.dynamic_lights, + lightning: horizon_client::gfx::lightning::Input { + bolts: &bolts, + uv: [ + self.gui.atlas.font.white().u0, + self.gui.atlas.font.white().v0, + ], + }, additive: &additive, see_through: &see_through, celestial: if self.settings.horizon.sky || title { @@ -12377,6 +12386,7 @@ fn loading_frame(hud: &HudBatch) -> Frame<'_> { entities: &[], dynamic_lights: &[], clouds: None, + lightning: Default::default(), additive: &[], see_through: &[], celestial: &[], diff --git a/crates/horizon-client/src/game/lightning.rs b/crates/horizon-client/src/game/lightning.rs index 6c4dd933f..0f43c4c54 100644 --- a/crates/horizon-client/src/game/lightning.rs +++ b/crates/horizon-client/src/game/lightning.rs @@ -5,14 +5,8 @@ //! witches, mooshroom colours, turtles, burnt items), lightning rods, the sky //! flash, the sounds and the branching additive bolt. use super::Game; -use horizon_client::{ - mesher::Vertex, - mobs::{Damage, DamageKind, MobEvent, SpawnSetup, Species}, -}; -use horizon_core::{ - position::BlockPos, - random::{LegacyRandom, RandomSource}, -}; +use horizon_client::mobs::{Damage, DamageKind, MobEvent, SpawnSetup, Species}; +use horizon_core::{position::BlockPos, random::RandomSource}; pub(super) struct Bolt { at: [f64; 3], @@ -349,71 +343,14 @@ impl Game<'_> { || e.stack.item.contains("netherite") }); } - /// `LightningBoltRenderer`: 4 layers of a trunk and two branches, 8 - /// segments of 16 blocks, from the bolt's seed. - pub(super) fn bolt_geometry(&self, camera: glam::DVec3, out: &mut Vec<Vertex>) { - let white = self.gui.atlas.font.white(); - let uv = [white.u0, white.v0]; - // ARGB 0.45, 0.45, 0.5 at 0.3 alpha, packed RGBA. - let color = (76u32 << 24) | (127 << 16) | (114 << 8) | 114; - for b in &self.bolts { - let o = (glam::DVec3::from_array(b.at) - camera).as_vec3(); - let mut random = LegacyRandom::new(b.seed); - let (mut xs, mut zs) = ([0f32; 8], [0f32; 8]); - let (mut x_off, mut z_off) = (0f32, 0f32); - for i in (0..8).rev() { - xs[i] = x_off; - zs[i] = z_off; - x_off += (random.next_int_bound(11).unwrap_or(5) - 5) as f32; - z_off += (random.next_int_bound(11).unwrap_or(5) - 5) as f32; - } - for layer in 0..4 { - let mut random = LegacyRandom::new(b.seed); - for branch in 0..3 { - let trunk = branch == 0; - let start = 7 - branch; - let end = if trunk { 0 } else { start - 3 + 1 }; - let mut sx = xs[start] - x_off; - let mut sz = zs[start] - z_off; - for segment in (end..=start).rev() { - let (ex, ez) = (sx, sz); - let spread = if trunk { 11 } else { 31 }; - sx += (random.next_int_bound(spread).unwrap_or(0) - spread / 2) as f32; - sz += (random.next_int_bound(spread).unwrap_or(0) - spread / 2) as f32; - let mut top = 0.1 + layer as f32 * 0.2; - let mut bottom = top; - if trunk { - top *= segment as f32 * 0.1 + 1.0; - bottom *= (segment as f32 - 1.0) * 0.1 + 1.0; - } - for (rx, rz, lx, lz) in [ - (false, false, true, false), - (true, false, true, true), - (true, true, false, true), - (false, true, false, false), - ] { - let s = |p: bool, r: f32| if p { r } else { -r }; - let y0 = segment as f32 * 16.0; - let corners = [ - [sx + s(rx, bottom), y0, sz + s(rz, bottom)], - [ex + s(rx, top), y0 + 16.0, ez + s(rz, top)], - [ex + s(lx, top), y0 + 16.0, ez + s(lz, top)], - [sx + s(lx, bottom), y0, sz + s(lz, bottom)], - ]; - for c in corners { - out.push(Vertex { - normal: [0; 4], - pos: (o + glam::Vec3::from_array(c)).to_array(), - uv, - layer: 2, - color, - light: 240 | 240 << 8, - }); - } - } - } - } - } - } + /// Simulation-order render inputs; seeded geometry lives in the renderer. + pub(super) fn bolt_instances(&self) -> Vec<horizon_client::gfx::lightning::Bolt> { + self.bolts + .iter() + .map(|b| horizon_client::gfx::lightning::Bolt { + at: b.at, + seed: b.seed, + }) + .collect() } } diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 14c040c5c..243904424 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -63,6 +63,7 @@ mod arena; mod cull; mod flat; mod java_stages; +pub mod lightning; mod lod; mod occlusion; mod pack_stages; @@ -193,7 +194,9 @@ pub struct Frame<'a> { pub dynamic_lights: &'a [[f32; 4]], /// Cloud mesh inputs; geometry and GPU storage are retained by the renderer. pub clouds: Option<crate::clouds::Input<'a>>, - /// Additive translucent geometry after the entities (lightning, dragon rays). + /// Retained lightning bolts, drawn before the other additive entities. + pub lightning: lightning::Input<'a>, + /// Additive translucent geometry after lightning (dragon rays). pub additive: &'a [Vertex], /// Name tags over everything, without depth (`TEXT_SEE_THROUGH`). pub see_through: &'a [Vertex], @@ -334,6 +337,8 @@ pub struct Renderer { cloud_uniform: wgpu::Buffer, cloud_group: wgpu::BindGroup, additive_pipeline: wgpu::RenderPipeline, + lightning_pipeline: wgpu::RenderPipeline, + lightning: lightning::Renderer, see_through_pipeline: wgpu::RenderPipeline, celestial_pipeline: wgpu::RenderPipeline, celestial_buffer: wgpu::Buffer, @@ -1664,8 +1669,17 @@ impl Renderer { alpha_blend, false, ); + let lightning_attributes = wgpu::vertex_attr_array![6=>Float32x3]; + let lightning_vertex = [ + entity_vertex[0].clone(), + Some(wgpu::VertexBufferLayout { + array_stride: std::mem::size_of::<[f32; 3]>() as u64, + step_mode: wgpu::VertexStepMode::Instance, + attributes: &lightning_attributes, + }), + ]; // BlendFunction.LIGHTNING: src alpha, one; no depth writes. - let additive_pipeline = device.create_render_pipeline(&wgpu::RenderPipelineDescriptor { + let additive_descriptor = wgpu::RenderPipelineDescriptor { label: Some("Additive entities"), layout: Some(&entity_layout), vertex: wgpu::VertexState { @@ -1709,6 +1723,16 @@ impl Renderer { }), multiview_mask: None, cache: None, + }; + let additive_pipeline = device.create_render_pipeline(&additive_descriptor); + let lightning_pipeline = device.create_render_pipeline(&wgpu::RenderPipelineDescriptor { + label: Some("Lightning"), + vertex: wgpu::VertexState { + entry_point: Some("vs_lightning"), + buffers: &lightning_vertex, + ..additive_descriptor.vertex.clone() + }, + ..additive_descriptor }); let celestial_pipeline = device.create_render_pipeline(&wgpu::RenderPipelineDescriptor { label: Some("Celestial bodies"), @@ -2110,6 +2134,8 @@ impl Renderer { cloud_uniform, cloud_group, additive_pipeline, + lightning_pipeline, + lightning: lightning::Renderer::new(), see_through_pipeline, celestial_pipeline, celestial_buffer, @@ -3279,6 +3305,13 @@ impl Renderer { } else { 0 }; + self.lightning.prepare( + &self.device, + &mut self.uploads, + &mut encoder, + &frame.lightning, + camera, + ); let all_entities = &self.entity_batch.combined; let hand_quads = (frame.hand.len() / 4) as u32; let additive_quads = (frame.additive.len() / 4) as u32; @@ -3318,8 +3351,13 @@ impl Renderer { bytemuck::cast_slice(&frame.celestial[..celestial_vertices]), ); } - let max_quads = - (world_quads + additive_quads + hand_quads + see_through_quads).max(cloud_quads); + let max_quads = (world_quads + additive_quads + hand_quads + see_through_quads) + .max(cloud_quads) + .max(if frame.lightning.bolts.is_empty() { + 0 + } else { + lightning::QUADS + }); if max_quads > self.index_quads { self.index_quads = max_quads.next_power_of_two(); self.indices = Self::quad_indices(&self.device, self.index_quads); @@ -3622,6 +3660,12 @@ impl Renderer { ); pass.set_bind_group(0, &self.group, &[]); } + if !frame.lightning.bolts.is_empty() { + pass.set_pipeline(&self.lightning_pipeline); + pass.set_bind_group(0, &self.entity_group, &[]); + self.lightning.draw(&mut pass, &frame.lightning); + pass.set_bind_group(0, &self.group, &[]); + } if additive_quads > 0 { pass.set_pipeline(&self.additive_pipeline); pass.set_bind_group(0, &self.entity_group, &[]); diff --git a/crates/horizon-client/src/gfx/lightning.rs b/crates/horizon-client/src/gfx/lightning.rs new file mode 100644 index 000000000..251dbf00e --- /dev/null +++ b/crates/horizon-client/src/gfx/lightning.rs @@ -0,0 +1,211 @@ +//! Seeded, bolt-local lightning meshes retained until their last active bolt disappears. +use crate::{gfx::upload::Uploads, mesher::Vertex}; +use glam::DVec3; +use horizon_core::random::{LegacyRandom, RandomSource}; +use std::collections::HashMap; +use wgpu::util::DeviceExt; + +/// A bolt's render state. Simulation lifetime and flashes stay in the game. +#[derive(Clone, Copy)] +pub struct Bolt { + pub at: [f64; 3], + pub seed: i64, +} + +#[derive(Default)] +pub struct Input<'a> { + pub bolts: &'a [Bolt], + /// Current atlas white texel; a changed rect invalidates retained vertices. + pub uv: [f32; 2], +} + +// Four layers, fourteen segments (eight trunk, two branches of three), four quads. +pub(super) const QUADS: u32 = 4 * 14 * 4; + +/// `LightningBoltRenderer.submit`: keep random draws, layers and quad order unchanged. +fn geometry(seed: i64, uv: [f32; 2]) -> Vec<Vertex> { + let mut out = Vec::with_capacity(QUADS as usize * 4); + // ARGB 0.45, 0.45, 0.5 at 0.3 alpha, packed RGBA. + let color = (76u32 << 24) | (127 << 16) | (114 << 8) | 114; + let mut random = LegacyRandom::new(seed); + let (mut xs, mut zs) = ([0f32; 8], [0f32; 8]); + let (mut x_off, mut z_off) = (0f32, 0f32); + for i in (0..8).rev() { + xs[i] = x_off; + zs[i] = z_off; + x_off += (random.next_int_bound(11).unwrap_or(5) - 5) as f32; + z_off += (random.next_int_bound(11).unwrap_or(5) - 5) as f32; + } + for layer in 0..4 { + let mut random = LegacyRandom::new(seed); + for branch in 0..3 { + let trunk = branch == 0; + let start = 7 - branch; + let end = if trunk { 0 } else { start - 3 + 1 }; + let mut sx = xs[start] - x_off; + let mut sz = zs[start] - z_off; + for segment in (end..=start).rev() { + let (ex, ez) = (sx, sz); + let spread = if trunk { 11 } else { 31 }; + sx += (random.next_int_bound(spread).unwrap_or(0) - spread / 2) as f32; + sz += (random.next_int_bound(spread).unwrap_or(0) - spread / 2) as f32; + let mut top = 0.1 + layer as f32 * 0.2; + let mut bottom = top; + if trunk { + top *= segment as f32 * 0.1 + 1.0; + bottom *= (segment as f32 - 1.0) * 0.1 + 1.0; + } + for (rx, rz, lx, lz) in [ + (false, false, true, false), + (true, false, true, true), + (true, true, false, true), + (false, true, false, false), + ] { + let s = |p: bool, r: f32| if p { r } else { -r }; + let y0 = segment as f32 * 16.0; + let corners = [ + [sx + s(rx, bottom), y0, sz + s(rz, bottom)], + [ex + s(rx, top), y0 + 16.0, ez + s(rz, top)], + [ex + s(lx, top), y0 + 16.0, ez + s(lz, top)], + [sx + s(lx, bottom), y0, sz + s(lz, bottom)], + ]; + for c in corners { + out.push(Vertex { + normal: [0; 4], + pos: c, + uv, + layer: 2, + color, + light: 240 | 240 << 8, + }); + } + } + } + } + } + out +} + +struct Cached<T> { + mesh: T, + used: bool, +} + +/// Shared seeds use the same mesh; storage is bounded by active unique seeds, +/// including after seed changes, removals, dimension switches and disconnects. +struct Cache<T> { + uv: Option<[f32; 2]>, + meshes: HashMap<i64, Cached<T>>, +} +impl<T> Cache<T> { + fn new() -> Self { + Self { + uv: None, + meshes: HashMap::new(), + } + } + + fn prepare(&mut self, input: &Input<'_>, mut build: impl FnMut(i64, [f32; 2]) -> T) { + if self.uv != Some(input.uv) { + self.meshes.clear(); + self.uv = Some(input.uv); + } + for cached in self.meshes.values_mut() { + cached.used = false; + } + for bolt in input.bolts { + self.meshes + .entry(bolt.seed) + .or_insert_with(|| Cached { + mesh: build(bolt.seed, input.uv), + used: true, + }) + .used = true; + } + self.meshes.retain(|_, cached| cached.used); + // HashMap::retain keeps its allocation. Release historical peak capacity + // as well as meshes once the storm (or connection) is gone. + if self.meshes.is_empty() { + self.meshes = HashMap::new(); + } else if self.meshes.capacity() > self.meshes.len() * 4 { + self.meshes.shrink_to_fit(); + } + } +} + +fn offset(bolt: &Bolt, camera: DVec3) -> [f32; 3] { + (DVec3::from_array(bolt.at) - camera).as_vec3().to_array() +} + +pub(super) struct Renderer { + cache: Cache<wgpu::Buffer>, + instances: Option<wgpu::Buffer>, + capacity: usize, +} +impl Renderer { + pub(super) fn new() -> Self { + Self { + cache: Cache::new(), + instances: None, + capacity: 0, + } + } + + pub(super) fn prepare( + &mut self, + device: &wgpu::Device, + uploads: &mut Uploads, + encoder: &mut wgpu::CommandEncoder, + input: &Input<'_>, + camera: DVec3, + ) { + self.cache.prepare(input, |seed, uv| { + device.create_buffer_init(&wgpu::util::BufferInitDescriptor { + label: Some("Lightning vertices"), + contents: bytemuck::cast_slice(&geometry(seed, uv)), + usage: wgpu::BufferUsages::VERTEX, + }) + }); + if input.bolts.is_empty() { + self.instances = None; + self.capacity = 0; + return; + } + if input.bolts.len() > self.capacity || input.bolts.len() < self.capacity / 4 { + self.capacity = input.bolts.len().next_power_of_two(); + self.instances = Some(device.create_buffer(&wgpu::BufferDescriptor { + label: Some("Lightning offsets"), + size: (self.capacity * std::mem::size_of::<[f32; 3]>()) as u64, + usage: wgpu::BufferUsages::VERTEX | wgpu::BufferUsages::COPY_DST, + mapped_at_creation: false, + })); + } + let offsets: Vec<_> = input + .bolts + .iter() + .map(|bolt| offset(bolt, camera)) + .collect(); + uploads.buffer( + encoder, + self.instances.as_ref().unwrap(), + 0, + bytemuck::cast_slice(&offsets), + ); + } + + pub(super) fn draw(&self, pass: &mut wgpu::RenderPass<'_>, input: &Input<'_>) { + let Some(instances) = &self.instances else { + return; + }; + pass.set_vertex_buffer(1, instances.slice(..)); + // Follow simulation order, including repeated seeds; HashMap order must + // never change additive accumulation or the order before dragon rays. + for (i, bolt) in input.bolts.iter().enumerate() { + pass.set_vertex_buffer(0, self.cache.meshes[&bolt.seed].mesh.slice(..)); + pass.draw_indexed(0..QUADS * 6, 0, i as u32..i as u32 + 1); + } + } +} + +#[cfg(test)] +mod tests; diff --git a/crates/horizon-client/src/gfx/lightning/tests/mod.rs b/crates/horizon-client/src/gfx/lightning/tests/mod.rs new file mode 100644 index 000000000..f89f402de --- /dev/null +++ b/crates/horizon-client/src/gfx/lightning/tests/mod.rs @@ -0,0 +1,495 @@ +use super::*; +use std::cell::Cell; + +// Frozen pre-cache generator: compare every Vertex byte, including primitive +// order and the original camera-relative rounding, without game resources. +fn reference(seed: i64, at: [f64; 3], camera: DVec3, uv: [f32; 2]) -> Vec<Vertex> { + let mut out = Vec::new(); + // ARGB 0.45, 0.45, 0.5 at 0.3 alpha, packed RGBA. + let color = (76u32 << 24) | (127 << 16) | (114 << 8) | 114; + let b = Bolt { seed, at }; + { + let o = (glam::DVec3::from_array(b.at) - camera).as_vec3(); + let mut random = LegacyRandom::new(b.seed); + let (mut xs, mut zs) = ([0f32; 8], [0f32; 8]); + let (mut x_off, mut z_off) = (0f32, 0f32); + for i in (0..8).rev() { + xs[i] = x_off; + zs[i] = z_off; + x_off += (random.next_int_bound(11).unwrap_or(5) - 5) as f32; + z_off += (random.next_int_bound(11).unwrap_or(5) - 5) as f32; + } + for layer in 0..4 { + let mut random = LegacyRandom::new(b.seed); + for branch in 0..3 { + let trunk = branch == 0; + let start = 7 - branch; + let end = if trunk { 0 } else { start - 3 + 1 }; + let mut sx = xs[start] - x_off; + let mut sz = zs[start] - z_off; + for segment in (end..=start).rev() { + let (ex, ez) = (sx, sz); + let spread = if trunk { 11 } else { 31 }; + sx += (random.next_int_bound(spread).unwrap_or(0) - spread / 2) as f32; + sz += (random.next_int_bound(spread).unwrap_or(0) - spread / 2) as f32; + let mut top = 0.1 + layer as f32 * 0.2; + let mut bottom = top; + if trunk { + top *= segment as f32 * 0.1 + 1.0; + bottom *= (segment as f32 - 1.0) * 0.1 + 1.0; + } + for (rx, rz, lx, lz) in [ + (false, false, true, false), + (true, false, true, true), + (true, true, false, true), + (false, true, false, false), + ] { + let s = |p: bool, r: f32| if p { r } else { -r }; + let y0 = segment as f32 * 16.0; + let corners = [ + [sx + s(rx, bottom), y0, sz + s(rz, bottom)], + [ex + s(rx, top), y0 + 16.0, ez + s(rz, top)], + [ex + s(lx, top), y0 + 16.0, ez + s(lz, top)], + [sx + s(lx, bottom), y0, sz + s(lz, bottom)], + ]; + for c in corners { + out.push(Vertex { + normal: [0; 4], + pos: (o + glam::Vec3::from_array(c)).to_array(), + uv, + layer: 2, + color, + light: 240 | 240 << 8, + }); + } + } + } + } + } + } + out +} + +fn seeds() -> Vec<i64> { + let mut seeds = vec![0, 1, -1, i64::MIN, i64::MAX, 0x123456789abcdef]; + let mut random = LegacyRandom::new(42); + seeds.extend((0..256).map(|_| random.next_long())); + seeds +} + +/// Pinned 26.3 LightningBoltRenderer.lambda$submit$0, captured with an +/// identity PoseStack and a VertexConsumer recording big-endian xyz floats. +#[test] +fn geometry_matches_pinned_vanilla_vertex_digest() { + use sha2::{Digest, Sha256}; + let mut digest = Sha256::new(); + for seed in seeds() { + for vertex in geometry(seed, [0.0; 2]) { + for value in vertex.pos { + digest.update(value.to_be_bytes()); + } + } + } + assert_eq!( + format!("{:x}", digest.finalize()), + "a9ed25caa50b9aa340faa4bb417b3d533b061f0dce66514e4bb212931444dee6" + ); +} + +#[test] +fn retained_geometry_matches_original_generator() { + let uv = [0.8125, 0.03125]; + for seed in seeds() { + let local = geometry(seed, uv); + assert_eq!(local.len(), QUADS as usize * 4); + for (at, camera) in [ + ([0.0; 3], DVec3::ZERO), + ([12.5, 64.0, -12.5], DVec3::new(-4.25, 71.125, 32.5)), + ( + [29_999_999.5, -64.0, -29_999_999.5], + DVec3::new(29_999_987.125, 67.75, -29_999_983.875), + ), + ] { + let offset = offset(&Bolt { seed, at }, camera); + let translated: Vec<_> = local + .iter() + .map(|v| Vertex { + pos: (glam::Vec3::from_array(offset) + glam::Vec3::from_array(v.pos)) + .to_array(), + ..*v + }) + .collect(); + let expected = reference(seed, at, camera, uv); + assert_eq!( + bytemuck::cast_slice::<_, u8>(&translated), + bytemuck::cast_slice::<_, u8>(&expected), + "seed {seed}" + ); + } + } +} + +#[test] +fn cache_tracks_seed_lifecycle_movement_and_atlas_reload() { + let mut cache = Cache::new(); + let builds = Cell::new(0); + let build = |seed, uv| { + builds.set(builds.get() + 1); + geometry(seed, uv) + }; + let mut bolts = [ + Bolt { + seed: 123, + at: [0.0; 3], + }, + Bolt { + seed: 456, + at: [1.0; 3], + }, + ]; + fn input(bolts: &[Bolt]) -> Input<'_> { + Input { + bolts, + uv: [0.25, 0.5], + } + } + cache.prepare(&input(&bolts), build); + assert_eq!(builds.get(), 2); + assert_eq!(cache.meshes.len(), 2); + // Any number of rendered frames or multiplayer position updates reuse meshes. + for i in 0..100 { + bolts[0].at = [i as f64; 3]; + cache.prepare(&input(&bolts), build); + } + assert_eq!(builds.get(), 2); + // A flash changes the seed; retire its previous mesh immediately. + bolts[0].seed = 789; + cache.prepare(&input(&bolts), build); + assert_eq!(builds.get(), 3); + assert!(!cache.meshes.contains_key(&123)); + // Removal retains other bolts, and repeated seeds still share geometry. + bolts[0].seed = 456; + cache.prepare(&input(&bolts), build); + assert_eq!(builds.get(), 3); + assert_eq!(cache.meshes.len(), 1); + // Atlas replacement must update white texel UVs without changing the seed. + cache.prepare( + &Input { + bolts: &bolts, + uv: [0.75, 0.25], + }, + build, + ); + assert_eq!(builds.get(), 4); + assert_eq!(cache.meshes[&456].mesh[0].uv, [0.75, 0.25]); + // Disconnect/dimension switch/expiry drops every retained resource. + cache.prepare(&Input::default(), build); + assert!(cache.meshes.is_empty()); + assert_eq!(cache.meshes.capacity(), 0); + cache.prepare(&input(&bolts), build); + assert_eq!(builds.get(), 5); +} + +#[test] +fn long_flash_sequence_keeps_only_active_seeds() { + let mut cache = Cache::new(); + for seed in 0..10_000 { + cache.prepare( + &Input { + bolts: &[Bolt { seed, at: [0.0; 3] }], + uv: [0.0; 2], + }, + |seed, _| seed, + ); + assert_eq!(cache.meshes.len(), 1); + assert_eq!(cache.meshes[&seed].mesh, seed); + assert!(cache.meshes.capacity() < 16); + } +} + +/// Exercise the actual entity shader and retained draw path offscreen. Run +/// explicitly, separately from other headless device tests (some GPU drivers +/// fail during concurrent device teardown). Machines without an adapter skip it. +#[test] +#[ignore = "requires GPU; run separately with --ignored --exact"] +fn retained_gpu_draw_matches_transient_additive_draw() { + use bytemuck::Zeroable; + let instance = wgpu::Instance::new(wgpu::InstanceDescriptor::new_without_display_handle()); + let Ok(adapter) = pollster::block_on(instance.request_adapter(&Default::default())) else { + eprintln!("no GPU adapter: skipped"); + return; + }; + eprintln!("lightning differential GPU: {}", adapter.get_info().name); + let (device, queue) = pollster::block_on(adapter.request_device(&Default::default())).unwrap(); + let shader = device.create_shader_module(wgpu::ShaderModuleDescriptor { + label: Some("Lightning differential shader"), + source: wgpu::ShaderSource::Wgsl(crate::gfx::entity_shader().into()), + }); + let attributes = wgpu::vertex_attr_array![0=>Float32x3,1=>Float32x2,2=>Uint32,3=>Unorm8x4,4=>Uint8x4,5=>Snorm8x4]; + let offsets = wgpu::vertex_attr_array![6=>Float32x3]; + let vertices = [Some(wgpu::VertexBufferLayout { + array_stride: std::mem::size_of::<Vertex>() as u64, + step_mode: wgpu::VertexStepMode::Vertex, + attributes: &attributes, + })]; + let retained_vertices = [ + vertices[0].clone(), + Some(wgpu::VertexBufferLayout { + array_stride: 12, + step_mode: wgpu::VertexStepMode::Instance, + attributes: &offsets, + }), + ]; + let pipelines: Vec<_> = [false, true] + .into_iter() + .map(|retained| { + device.create_render_pipeline(&wgpu::RenderPipelineDescriptor { + label: Some("Lightning differential pipeline"), + layout: None, + vertex: wgpu::VertexState { + module: &shader, + entry_point: Some(if retained { + "vs_lightning" + } else { + "vs_entity" + }), + compilation_options: Default::default(), + buffers: if retained { + &retained_vertices + } else { + &vertices + }, + }, + primitive: wgpu::PrimitiveState { + cull_mode: None, + ..Default::default() + }, + depth_stencil: Some(wgpu::DepthStencilState { + format: wgpu::TextureFormat::Depth32Float, + depth_write_enabled: Some(false), + depth_compare: Some(wgpu::CompareFunction::GreaterEqual), + stencil: Default::default(), + bias: Default::default(), + }), + multisample: Default::default(), + fragment: Some(wgpu::FragmentState { + module: &shader, + entry_point: Some("fs_celestial"), + compilation_options: Default::default(), + targets: &[Some(wgpu::ColorTargetState { + format: wgpu::TextureFormat::Rgba8Unorm, + blend: Some(wgpu::BlendState { + color: wgpu::BlendComponent { + src_factor: wgpu::BlendFactor::SrcAlpha, + dst_factor: wgpu::BlendFactor::One, + operation: wgpu::BlendOperation::Add, + }, + alpha: wgpu::BlendComponent { + src_factor: wgpu::BlendFactor::SrcAlpha, + dst_factor: wgpu::BlendFactor::One, + operation: wgpu::BlendOperation::Add, + }, + }), + write_mask: wgpu::ColorWrites::ALL, + })], + }), + multiview_mask: None, + cache: None, + }) + }) + .collect(); + let globals = crate::gfx::Globals { + view_proj: (glam::Mat4::orthographic_rh(-100.0, 100.0, -10.0, 150.0, 0.1, 400.0) + * glam::Mat4::look_at_rh( + glam::Vec3::new(80.0, 30.0, 160.0), + glam::Vec3::new(0.0, 60.0, 0.0), + glam::Vec3::Y, + )) + .to_cols_array_2d(), + ..crate::gfx::Globals::zeroed() + }; + let globals = device.create_buffer_init(&wgpu::util::BufferInitDescriptor { + label: None, + contents: bytemuck::bytes_of(&globals), + usage: wgpu::BufferUsages::UNIFORM, + }); + let size = wgpu::Extent3d { + width: 256, + height: 256, + depth_or_array_layers: 1, + }; + let texture = |format, usage| { + device.create_texture(&wgpu::TextureDescriptor { + label: None, + size, + mip_level_count: 1, + sample_count: 1, + dimension: wgpu::TextureDimension::D2, + format, + usage, + view_formats: &[], + }) + }; + let white = device + .create_texture_with_data( + &queue, + &wgpu::TextureDescriptor { + label: None, + size: wgpu::Extent3d { + width: 1, + height: 1, + depth_or_array_layers: 1, + }, + mip_level_count: 1, + sample_count: 1, + dimension: wgpu::TextureDimension::D2, + format: wgpu::TextureFormat::Rgba8Unorm, + usage: wgpu::TextureUsages::TEXTURE_BINDING, + view_formats: &[], + }, + wgpu::util::TextureDataOrder::LayerMajor, + &[255; 4], + ) + .create_view(&Default::default()); + let sampler = device.create_sampler(&Default::default()); + let groups: Vec<_> = pipelines + .iter() + .map(|pipeline| { + device.create_bind_group(&wgpu::BindGroupDescriptor { + label: None, + layout: &pipeline.get_bind_group_layout(0), + entries: &[ + wgpu::BindGroupEntry { + binding: 0, + resource: globals.as_entire_binding(), + }, + wgpu::BindGroupEntry { + binding: 1, + resource: wgpu::BindingResource::TextureView(&white), + }, + wgpu::BindGroupEntry { + binding: 2, + resource: wgpu::BindingResource::Sampler(&sampler), + }, + wgpu::BindGroupEntry { + binding: 3, + resource: wgpu::BindingResource::TextureView(&white), + }, + wgpu::BindGroupEntry { + binding: 4, + resource: wgpu::BindingResource::Sampler(&sampler), + }, + ], + }) + }) + .collect(); + let mut renderer = Renderer::new(); + let mut uploads = Uploads::new(&device); + let mut bolts = [Bolt { + seed: 123, + at: [29_999_999.5, 64.0, -29_999_999.5], + }; 3]; + bolts[1].seed = -456; + bolts[1].at[0] -= 32.0; + bolts[2].at[2] += 20.0; + let indices = crate::gfx::Renderer::quad_indices(&device, QUADS * 3); + for frame in 0..4 { + let camera = DVec3::new(29_999_997.125 + frame as f64, 62.75, -29_999_998.875); + if frame == 2 { + bolts[0].seed = 789; + } + let input = Input { + bolts: &bolts[..if frame == 3 { 1 } else { 3 }], + uv: if frame == 3 { [0.75; 2] } else { [0.5; 2] }, + }; + let expected: Vec<_> = input + .bolts + .iter() + .flat_map(|bolt| reference(bolt.seed, bolt.at, camera, input.uv)) + .collect(); + let transient = device.create_buffer_init(&wgpu::util::BufferInitDescriptor { + label: None, + contents: bytemuck::cast_slice(&expected), + usage: wgpu::BufferUsages::VERTEX, + }); + let mut encoder = device.create_command_encoder(&Default::default()); + renderer.prepare(&device, &mut uploads, &mut encoder, &input, camera); + let mut readbacks = Vec::new(); + for mode in 0..2 { + let color = texture( + wgpu::TextureFormat::Rgba8Unorm, + wgpu::TextureUsages::RENDER_ATTACHMENT | wgpu::TextureUsages::COPY_SRC, + ); + let view = color.create_view(&Default::default()); + let depth = texture( + wgpu::TextureFormat::Depth32Float, + wgpu::TextureUsages::RENDER_ATTACHMENT, + ) + .create_view(&Default::default()); + { + let mut pass = encoder.begin_render_pass(&wgpu::RenderPassDescriptor { + label: None, + color_attachments: &[Some(wgpu::RenderPassColorAttachment { + view: &view, + resolve_target: None, + depth_slice: None, + ops: wgpu::Operations { + load: wgpu::LoadOp::Clear(wgpu::Color::TRANSPARENT), + store: wgpu::StoreOp::Store, + }, + })], + depth_stencil_attachment: Some(wgpu::RenderPassDepthStencilAttachment { + view: &depth, + depth_ops: Some(wgpu::Operations { + load: wgpu::LoadOp::Clear(0.0), + store: wgpu::StoreOp::Discard, + }), + stencil_ops: None, + }), + ..Default::default() + }); + pass.set_pipeline(&pipelines[mode]); + pass.set_bind_group(0, &groups[mode], &[]); + pass.set_index_buffer(indices.slice(..), wgpu::IndexFormat::Uint32); + if mode == 0 { + pass.set_vertex_buffer(0, transient.slice(..)); + pass.draw_indexed(0..expected.len() as u32 / 4 * 6, 0, 0..1); + } else { + renderer.draw(&mut pass, &input); + } + } + let read = device.create_buffer(&wgpu::BufferDescriptor { + label: None, + size: 256 * 256 * 4, + usage: wgpu::BufferUsages::COPY_DST | wgpu::BufferUsages::MAP_READ, + mapped_at_creation: false, + }); + encoder.copy_texture_to_buffer( + color.as_image_copy(), + wgpu::TexelCopyBufferInfo { + buffer: &read, + layout: wgpu::TexelCopyBufferLayout { + offset: 0, + bytes_per_row: Some(1024), + rows_per_image: None, + }, + }, + size, + ); + readbacks.push(read); + } + uploads.finish(&encoder); + queue.submit([encoder.finish()]); + for read in &readbacks { + read.slice(..) + .map_async(wgpu::MapMode::Read, |r| r.unwrap()); + } + device.poll(wgpu::PollType::wait_indefinitely()).unwrap(); + let pixels: Vec<Vec<u8>> = readbacks + .iter() + .map(|read| read.slice(..).get_mapped_range().unwrap().to_vec()) + .collect(); + assert!(pixels[0].iter().any(|&b| b != 0), "empty reference frame"); + assert_eq!(pixels[0], pixels[1], "frame {frame}: GPU output differs"); + } +} From abb7a971363bf2244b63585a8daf9a9d7c620744 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 13:45:18 +0200 Subject: [PATCH 025/126] Animated sprites on the GPU: frames uploaded once, one dispatch per mip level Every animation frame's mip chain goes to video memory once, at the sprite's own size, as vanilla keeps its animated sprites' frames on the GPU. A tick that changes sprites writes one 20-byte job per changed sprite, and a compute dispatch per mip level repeats the chain into the array's larger layers and mixes interpolated frames (animate_sprite_interpolate), instead of blending on the CPU at the array's size and copying each sprite level by level. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/gfx.rs | 365 +------------ crates/horizon-client/src/gfx/animate.rs | 590 +++++++++++++++++++++ crates/horizon-client/src/gfx/animate.wgsl | 48 ++ crates/horizon-client/src/sprites.rs | 13 +- 4 files changed, 663 insertions(+), 353 deletions(-) create mode 100644 crates/horizon-client/src/gfx/animate.rs create mode 100644 crates/horizon-client/src/gfx/animate.wgsl diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 14c040c5c..7298d4292 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -59,6 +59,7 @@ pub fn outline_vertices(edges: &[[f64; 6]], camera: glam::DVec3) -> Vec<[f32; 6] .collect() } +mod animate; mod arena; mod cull; mod flat; @@ -363,8 +364,6 @@ pub struct Renderer { sprite_textures: Vec<wgpu::Texture>, /// A 1-layer array bound where a pack needs fewer arrays. sprite_unused: wgpu::TextureView, - /// Layers per sprite array ([`SPRITE_SPLIT`] but in tests). - sprite_split: u32, mip_levels: u32, /// The mipmap levels sampled (the Mipmap Levels option), at most `mip_levels - 1`. mipmaps: u32, @@ -372,7 +371,7 @@ pub struct Renderer { sprite_sampler: wgpu::Sampler, lightmap_view: wgpu::TextureView, lightmap_sampler: wgpu::Sampler, - animations: AnimatedSprites, + animations: animate::SpriteAnimator, uploads: upload::Uploads, /// Section meshes are staged through their own belt into /// `section_copies`, which the next frame records its commands after: @@ -1274,7 +1273,9 @@ impl Renderer { sample_count: 1, dimension: wgpu::TextureDimension::D2, format: wgpu::TextureFormat::Rgba8Unorm, - usage: wgpu::TextureUsages::TEXTURE_BINDING | wgpu::TextureUsages::COPY_DST, + usage: wgpu::TextureUsages::TEXTURE_BINDING + | wgpu::TextureUsages::COPY_DST + | wgpu::TextureUsages::STORAGE_BINDING, view_formats: &[], }, wgpu::util::TextureDataOrder::LayerMajor, @@ -1282,6 +1283,14 @@ impl Renderer { ) }) .collect(); + let animations = animate::SpriteAnimator::new( + &device, + animations, + sprite_size, + sprite_mips, + &sprite_textures, + split, + ); let sprite_unused = device .create_texture(&wgpu::TextureDescriptor { label: Some("Block sprites (unused)"), @@ -2133,14 +2142,13 @@ impl Renderer { lightmap, sprite_textures, sprite_unused, - sprite_split: split, mip_levels, mipmaps: mip_levels - 1, terrain_layout: bindings, sprite_sampler, lightmap_view, lightmap_sampler, - animations: AnimatedSprites::new(animations, sprite_size, sprite_mips), + animations, uploads, section_uploads, section_copies: None, @@ -2733,29 +2741,7 @@ impl Renderer { self.lightmap_uploaded = true; } fn animate(&mut self, encoder: &mut wgpu::CommandEncoder, tick: u64) { - animate_sprites( - &mut self.animations, - tick, - self.mip_levels, - |layer, level, size, pixels| { - self.uploads.texture( - encoder, - wgpu::TexelCopyTextureInfo { - texture: &self.sprite_textures[(layer / self.sprite_split) as usize], - mip_level: level, - origin: wgpu::Origin3d { - x: 0, - y: 0, - z: layer % self.sprite_split, - }, - aspect: wgpu::TextureAspect::All, - }, - size, - size, - pixels, - ); - }, - ); + self.animations.animate(encoder, &mut self.uploads, tick); } pub fn render(&mut self, frame: &Frame) -> Result<bool> { let rendered = self.draw_frame(frame); @@ -4427,171 +4413,10 @@ pub(crate) fn sprite_mipmap_limit(requested: u32, size: u32, minimum: u32, avail let upscale = (size / minimum.max(1)).max(1).ilog2(); requested.saturating_add(upscale).min(available - 1) } -/// Room for every frame of the vanilla animations (594 frames, 13 MB of mip -/// chains in 64-pixel layers), so no frame's chain is rebuilt on the render -/// thread when its animation comes back to it; larger packs stay bounded. -const ANIMATION_MIP_BUDGET: usize = 32 << 20; -const ANIMATION_MIP_ENTRIES: usize = 4096; - -/// One immutable resource snapshot and its lazily generated frame mips. A new -/// renderer on resource reload drops this entire snapshot, including its cache: -/// frame indices can never alias another resource's pixels, size or settings. -struct AnimatedSprites { - /// Each animated sprite and what its layer holds (`None`: not uploaded yet). - animations: Vec<(SpriteAnimation, Option<crate::sprites::FrameBlend>)>, - size: u32, - settings: Vec<crate::mipmap::Settings>, - // Cache bookkeeping must not consume randomness or affect other maps' seeding. - cache: crate::fast_hash::FxHashMap<(usize, usize), Vec<u8>>, - /// Retained pixel-buffer capacities, not just their initialized lengths. - cache_bytes: usize, - budget: usize, -} -impl AnimatedSprites { - fn new( - animations: &[SpriteAnimation], - size: u32, - settings: &[crate::mipmap::Settings], - ) -> Self { - Self { - animations: animations.iter().cloned().map(|a| (a, None)).collect(), - size, - settings: settings.to_vec(), - cache: Default::default(), - cache_bytes: 0, - budget: ANIMATION_MIP_BUDGET, - } - } -} -fn animate_sprites( - state: &mut AnimatedSprites, - tick: u64, - max_levels: u32, - mut write: impl FnMut(u32, u32, u32, &[u8]), -) { - let size = state.size; - let levels = size.trailing_zeros() + 1; - let AnimatedSprites { - animations, - settings, - cache, - cache_bytes, - budget, - .. - } = state; - for (index, (animation, previous)) in animations.iter_mut().enumerate() { - let blend = animation.blend(tick); - if *previous == Some(blend) { - continue; - } - *previous = Some(blend); - let (animation, settings) = (&*animation, &**settings); - let chain = |frame: usize| { - move || mip_chain(animation.pixels(frame), size, settings, animation.layer, 1).0 - }; - let (current, mixed); - let mips: &[u8] = if blend.millis > 0 { - let mut mix = frame_mips( - cache, - cache_bytes, - *budget, - (index, blend.frame), - chain(blend.frame), - ) - .into_owned(); - let next = frame_mips( - cache, - cache_bytes, - *budget, - (index, blend.next), - chain(blend.next), - ); - mix_frames(&mut mix, &next, blend.millis); - mixed = mix; - &mixed - } else { - current = frame_mips( - cache, - cache_bytes, - *budget, - (index, blend.frame), - chain(blend.frame), - ); - ¤t - }; - let mut offset = 0; - for level in 0..levels.min(max_levels) { - let edge = size >> level; - let bytes = (edge * edge * 4) as usize; - write(animation.layer, level, edge, &mips[offset..offset + bytes]); - offset += bytes; - } - } -} -/// `animate_sprite_interpolate.fsh`: `mix(current, next, millis / 1000)` per -/// channel of every mipmap level, stored as 8-bit unorm. -/// One frame's mip chain: from the cache, or generated and kept while the budget has room. -/// Frames that do not fit still go through the same generation path. -fn frame_mips<'a>( - cache: &'a mut crate::fast_hash::FxHashMap<(usize, usize), Vec<u8>>, - cache_bytes: &mut usize, - budget: usize, - key: (usize, usize), - generate: impl FnOnce() -> Vec<u8>, -) -> std::borrow::Cow<'a, [u8]> { - let room = cache.len() < ANIMATION_MIP_ENTRIES; - match cache.entry(key) { - std::collections::hash_map::Entry::Occupied(entry) => entry.into_mut().as_slice().into(), - std::collections::hash_map::Entry::Vacant(entry) => { - let pixels = generate(); - // Bound both pixel storage and map metadata. Keep admitted frames - // rather than churning them on large/unique workloads. - if room && pixels.capacity() <= budget - *cache_bytes { - *cache_bytes += pixels.capacity(); - entry.insert(pixels).as_slice().into() - } else { - pixels.into() - } - } - } -} -fn mix_frames(current: &mut [u8], next: &[u8], millis: u32) { - let t = millis as f32 / 1000.0; - for (c, n) in current.iter_mut().zip(next) { - let (a, b) = (f32::from(*c) / 255.0, f32::from(*n) / 255.0); - *c = round_unorm8((a * (1.0 - t) + b * t) * 255.0); - } -} -/// `x.round() as u8` for `x >= 0`, without the `roundf` library call that -/// x86-64 makes for every `f32::round` (it has no rounding instruction before -/// SSE4.1): the fraction `x - trunc(x)` is exact below 2^23, so rounding half -/// away from zero is adding one when it is at least a half. -#[inline] -fn round_unorm8(x: f32) -> u8 { - let whole = x as u8; - whole.saturating_add(u8::from(x - f32::from(whole) >= 0.5)) -} #[cfg(test)] mod sprite_upload_tests { use super::*; #[test] - fn blended_frames_round_like_f32_round() { - for millis in (0..1000).step_by(7).chain([999]) { - let t = millis as f32 / 1000.0; - for a in 0..=255u8 { - for b in 0..=255u8 { - let x = (f32::from(a) / 255.0 * (1.0 - t) + f32::from(b) / 255.0 * t) * 255.0; - assert_eq!(round_unorm8(x), x.round() as u8, "{a} {b} {millis}"); - } - } - } - for x in [ - 0.0, 0.49999997, 0.5, 1.5, 2.5, 254.49998, 254.5, 255.0, 255.00002, 300.0, - ] { - assert_eq!(round_unorm8(x), x.round() as u8, "{x}"); - } - } - #[test] fn real_rail_mips_do_not_change_with_larger_array_layers() { let root = std::path::Path::new(env!("CARGO_MANIFEST_DIR")) .join("../../.local/horizon-client") @@ -4654,84 +4479,6 @@ mod sprite_upload_tests { assert_eq!(sprite_mipmap_limit(levels, 16, 16, 5), levels); } } - #[test] - fn animation_updates_entire_layer_every_mip_once() { - for size in [16, 32] { - let animation = crate::sprites::test_animation(size, 7); - let pixels = animation.pixels(animation.frame(1)).to_vec(); - let settings = []; - let (expected, levels) = mip_chain(&pixels, size, &settings, 7, 1); - let mut animations = AnimatedSprites::new(&[animation], size, &settings); - animations.animations[0].1 = Some(animations.animations[0].0.blend(0)); - let mut writes = Vec::new(); - let mut record = |layer, level, edge, data: &[u8]| { - assert_eq!(layer, 7); - assert_eq!(edge, size >> level); - assert_eq!(data.len(), (edge * edge * 4) as usize); - writes.push(data.to_vec()); - }; - animate_sprites(&mut animations, 0, levels, &mut record); - animate_sprites(&mut animations, 1, levels, &mut record); - animate_sprites(&mut animations, 1, levels, &mut record); - assert_eq!(writes.len(), levels as usize); - assert_eq!(writes[0], pixels); - assert_eq!(writes.concat(), expected); - } - } - - #[test] - fn cached_and_uncached_uploads_match_through_loops_and_mip_changes() { - for size in [16, 32] { - let animations = [crate::sprites::test_animation(size, 7)]; - let settings = vec![ - crate::mipmap::Settings { - strategy: crate::mipmap::Strategy::StrictCutout, - alpha_cutoff_bias: -0.2, - ..Default::default() - }; - 8 - ]; - let mut cached = AnimatedSprites::new(&animations, size, &settings); - let mut uncached = AnimatedSprites::new(&animations, size, &settings); - uncached.budget = 0; - for tick in [0, 0, 1, 2, 3, 33, 32, 32, 1, 0] { - let levels = (tick % 7) as u32; - let mut expected = Vec::new(); - let mut actual = Vec::new(); - animate_sprites(&mut uncached, tick, levels, |layer, level, edge, bytes| { - expected.push((layer, level, edge, bytes.to_vec())); - }); - animate_sprites(&mut cached, tick, levels, |layer, level, edge, bytes| { - actual.push((layer, level, edge, bytes.to_vec())); - }); - assert_eq!(actual, expected); - } - assert_eq!(cached.cache.len(), 2); - assert_eq!(uncached.cache_bytes, 0); - assert_eq!( - cached.cache_bytes, - cached.cache.values().map(Vec::capacity).sum::<usize>() - ); - } - } - - #[test] - fn budget_exhaustion_keeps_admitted_frames_and_uploads_misses() { - let size = 16; - let animation = crate::sprites::test_animation(size, 0); - let bytes = mip_chain(animation.pixels(0), size, &[], 0, 1).0.capacity(); - let mut state = AnimatedSprites::new(&[animation], size, &[]); - state.budget = bytes; - for tick in 0..8 { - let mut writes = 0; - animate_sprites(&mut state, tick, 5, |_, _, _, _| writes += 1); - assert_eq!(writes, 5); - assert_eq!(state.cache_bytes, bytes); - assert_eq!(state.cache.len(), 1); - assert!(state.cache.contains_key(&(0, 0))); - } - } - #[test] fn prepared_texture_uploads_preserve_layer_order_and_settings() { let size = 4; @@ -4784,86 +4531,4 @@ mod sprite_upload_tests { assert_eq!(chain.capacity(), chain.len()); } } - - #[test] - fn every_vanilla_animation_frame_stays_cached() { - // Vanilla's 594 animation frames in 64-pixel layers: 297 two-frame clips. - let animations: Vec<_> = (0..297) - .map(|layer| crate::sprites::test_animation(64, layer)) - .collect(); - let mut state = AnimatedSprites::new(&animations, 64, &[]); - for tick in 0..4 { - animate_sprites(&mut state, tick, 7, |_, _, _, _| {}); - } - assert_eq!(state.cache.len(), 594); - assert!(state.cache_bytes <= ANIMATION_MIP_BUDGET); - } - - #[test] - fn entry_limit_also_bounds_metadata_for_tiny_frames() { - let animation = crate::sprites::test_animation(1, 0); - let animations = vec![animation; ANIMATION_MIP_ENTRIES + 1]; - let mut state = AnimatedSprites::new(&animations, 1, &[]); - for tick in 0..2 { - let mut writes = 0; - animate_sprites(&mut state, tick, 1, |_, _, _, _| writes += 1); - assert_eq!(writes, animations.len()); - assert_eq!(state.cache.len(), ANIMATION_MIP_ENTRIES); - assert!(state.cache_bytes <= ANIMATION_MIP_BUDGET); - } - } - - #[test] - fn resource_snapshot_replacement_discards_pixels_size_and_settings() { - let old = crate::sprites::test_animation(16, 0); - let mut state = AnimatedSprites::new(&[old], 16, &[]); - animate_sprites(&mut state, 0, 5, |_, _, _, _| {}); - assert!(!state.cache.is_empty()); - let animation = crate::sprites::test_animation(32, 0); - let settings = [crate::mipmap::Settings { - strategy: crate::mipmap::Strategy::StrictCutout, - alpha_cutoff_bias: -0.4, - ..Default::default() - }]; - let expected = mip_chain(animation.pixels(0), 32, &settings, 0, 1).0; - state = AnimatedSprites::new(&[animation], 32, &settings); - assert_eq!(state.cache_bytes, 0); - assert!(state.cache.is_empty()); - let mut actual = Vec::new(); - animate_sprites(&mut state, 0, 6, |_, _, _, bytes| { - actual.extend_from_slice(bytes) - }); - assert_eq!(actual, expected); - } - - #[test] - fn interpolated_animation_uploads_the_mix_every_tick() { - let animation = crate::sprites::test_clip(16, 3, r#"{"frametime":4,"interpolate":true}"#); - let settings = []; - let (_, levels) = mip_chain(animation.pixels(0), 16, &settings, 3, 1); - let mut cached = AnimatedSprites::new(std::slice::from_ref(&animation), 16, &settings); - let mut uncached = AnimatedSprites::new(std::slice::from_ref(&animation), 16, &settings); - uncached.budget = 0; - for state in [&mut cached, &mut uncached] { - state.animations[0].1 = Some(animation.blend(0)); - } - let mut blues = Vec::new(); - let mut uncached_blues = Vec::new(); - let mut record = |_, level, _, data: &[u8]| { - if level == 0 { - blues.push(data[2]); - } - }; - for tick in [0, 1, 1, 2, 4] { - animate_sprites(&mut cached, tick, levels, &mut record); - animate_sprites(&mut uncached, tick, levels, |_, level, _, data: &[u8]| { - if level == 0 { - uncached_blues.push(data[2]); - } - }); - } - // Frame 0 is blue 0, frame 1 blue 99: a quarter, a half, then frame 1. - assert_eq!(blues, [25, 50, 99]); - assert_eq!(uncached_blues, blues); - } } diff --git a/crates/horizon-client/src/gfx/animate.rs b/crates/horizon-client/src/gfx/animate.rs new file mode 100644 index 000000000..f4528902b --- /dev/null +++ b/crates/horizon-client/src/gfx/animate.rs @@ -0,0 +1,590 @@ +//! Animated block sprites, drawn on the GPU as vanilla 26.3 draws them: +//! `SpriteContents.AnimatedTexture` keeps every frame in video memory, and +//! each tick `animate_sprite_blit` or `animate_sprite_interpolate` draws the +//! frame shown (mixed with the next one for `interpolate`) into the atlas. +//! +//! Every frame's mip chain is uploaded once, at the sprite's own size. A tick +//! that changes sprites writes one small job per changed sprite and runs one +//! compute dispatch per mip level (`animate.wgsl`), which repeats the chain +//! into the array's larger layers by whole pixels and mixes interpolated +//! frames. Blending on the CPU at the array's size and copying every changed +//! sprite level by level (a copy command each, a blit each in Mesa) was about +//! a fifth of the render thread on an integrated GPU. +use super::upload::Uploads; +use crate::mipmap::Settings; +use crate::sprites::{FrameBlend, SpriteAnimation}; +use wgpu::util::DeviceExt; + +/// Bytes of `animate.wgsl`'s `Job`. +const JOB_BYTES: usize = 20; +/// `animate.wgsl`'s workgroup edge. +const WORKGROUP: u32 = 8; + +struct Sprite { + animation: SpriteAnimation, + /// What its layer shows (`None`: the frame the array was created with, + /// rewritten on the first tick). + shown: Option<FrameBlend>, + /// Its layer in its sprite array. + layer: u32, + /// Each frame's mip chain: its offset in words in the group's frames. + frames: Vec<u32>, + /// Edge of the chains' first level. + edge: u32, + group: usize, +} + +/// The animated sprites of one sprite array whose frames share one buffer. +struct Group { + /// Where its jobs start in `SpriteAnimator::jobs`, in bytes. + offset: u64, + /// One bind group per mip level of the array. + levels: Vec<wgpu::BindGroup>, + /// This tick's jobs. + jobs: Vec<u8>, +} + +pub(super) struct SpriteAnimator { + sprites: Vec<Sprite>, + groups: Vec<Group>, + jobs: wgpu::Buffer, + pipeline: wgpu::ComputePipeline, + /// Edge of the arrays' layers. + size: u32, +} + +impl SpriteAnimator { + /// `textures` are the sprite arrays, `split` layers each, `size` pixels + /// wide; `animations` hold their frames at that size. + pub fn new( + device: &wgpu::Device, + animations: &[SpriteAnimation], + size: u32, + settings: &[Settings], + textures: &[wgpu::Texture], + split: u32, + ) -> Self { + let limits = device.limits(); + let limit = limits + .max_storage_buffer_binding_size + .min(limits.max_buffer_size); + let mut frames: Vec<Vec<u8>> = Vec::new(); + // Each group's sprite array and frames buffer. + let mut keys: Vec<(u32, usize)> = Vec::new(); + let mut counts: Vec<usize> = Vec::new(); + let mut sprites = Vec::with_capacity(animations.len()); + for animation in animations { + let chains: Vec<_> = (0..animation.frame_count()) + .map(|frame| source_chain(animation.pixels(frame), size, settings, animation.layer)) + .collect(); + let bytes: u64 = chains.iter().map(|(chain, _)| chain.len() as u64).sum(); + if bytes > limit { + log::warn!( + "Horizon: layer {}'s animation ({bytes} bytes) does not fit in a storage buffer; it stays still", + animation.layer + ); + continue; + } + if frames + .last() + .is_none_or(|data| data.len() as u64 + bytes > limit) + { + frames.push(Vec::new()); + } + let buffer = frames.len() - 1; + let data = &mut frames[buffer]; + let offsets = chains + .iter() + .map(|(chain, _)| { + let offset = (data.len() / 4) as u32; + data.extend_from_slice(chain); + offset + }) + .collect(); + let key = (animation.layer / split, buffer); + let group = keys.iter().position(|&k| k == key).unwrap_or_else(|| { + keys.push(key); + counts.push(0); + keys.len() - 1 + }); + counts[group] += 1; + sprites.push(Sprite { + animation: animation.clone(), + shown: None, + layer: animation.layer % split, + frames: offsets, + edge: chains[0].1, + group, + }); + } + let frames: Vec<_> = frames + .iter() + .map(|data| { + device.create_buffer_init(&wgpu::util::BufferInitDescriptor { + label: Some("Animated sprite frames"), + contents: data, + usage: wgpu::BufferUsages::STORAGE, + }) + }) + .collect(); + let align = u64::from(limits.min_storage_buffer_offset_alignment); + let mut offsets = Vec::with_capacity(counts.len()); + let mut total = 0; + for &count in &counts { + offsets.push(total); + total = (total + (count * JOB_BYTES) as u64).next_multiple_of(align); + } + let jobs = device.create_buffer(&wgpu::BufferDescriptor { + label: Some("Animated sprite jobs"), + size: total.max(align), + usage: wgpu::BufferUsages::STORAGE | wgpu::BufferUsages::COPY_DST, + mapped_at_creation: false, + }); + let module = device.create_shader_module(wgpu::ShaderModuleDescriptor { + label: Some("Animated sprites"), + source: wgpu::ShaderSource::Wgsl(include_str!("animate.wgsl").into()), + }); + let pipeline = device.create_compute_pipeline(&wgpu::ComputePipelineDescriptor { + label: Some("Animated sprites"), + layout: None, + module: &module, + entry_point: Some("animate"), + compilation_options: Default::default(), + cache: None, + }); + let layout = pipeline.get_bind_group_layout(0); + let groups = keys + .iter() + .zip(&counts) + .zip(offsets) + .map(|((&(array, buffer), &count), offset)| { + let texture = &textures[array as usize]; + let levels = (0..texture.mip_level_count()) + .map(|level| { + let view = texture.create_view(&wgpu::TextureViewDescriptor { + label: Some("Animated sprites"), + dimension: Some(wgpu::TextureViewDimension::D2Array), + base_mip_level: level, + mip_level_count: Some(1), + ..Default::default() + }); + device.create_bind_group(&wgpu::BindGroupDescriptor { + label: Some("Animated sprites"), + layout: &layout, + entries: &[ + wgpu::BindGroupEntry { + binding: 0, + resource: frames[buffer].as_entire_binding(), + }, + wgpu::BindGroupEntry { + binding: 1, + resource: wgpu::BindingResource::Buffer(wgpu::BufferBinding { + buffer: &jobs, + offset, + size: wgpu::BufferSize::new((count * JOB_BYTES) as u64), + }), + }, + wgpu::BindGroupEntry { + binding: 2, + resource: wgpu::BindingResource::TextureView(&view), + }, + ], + }) + }) + .collect(); + Group { + offset, + levels, + jobs: Vec::with_capacity(count * JOB_BYTES), + } + }) + .collect(); + Self { + sprites, + groups, + jobs, + pipeline, + size, + } + } + + /// Show every sprite's frame at `tick`, rewriting only the sprites whose + /// frame or mix changed (`SpriteContents.AnimationState.tick`). + pub fn animate( + &mut self, + encoder: &mut wgpu::CommandEncoder, + uploads: &mut Uploads, + tick: u64, + ) { + if self.collect(tick) == 0 { + return; + } + for group in &self.groups { + uploads.buffer(encoder, &self.jobs, group.offset, &group.jobs); + } + let mut pass = encoder.begin_compute_pass(&wgpu::ComputePassDescriptor { + label: Some("Animated sprites"), + timestamp_writes: None, + }); + pass.set_pipeline(&self.pipeline); + for group in &mut self.groups { + let count = (group.jobs.len() / JOB_BYTES) as u32; + if count == 0 { + continue; + } + for (level, bind) in group.levels.iter().enumerate() { + let groups = (self.size >> level).div_ceil(WORKGROUP); + pass.set_bind_group(0, bind, &[]); + pass.dispatch_workgroups(groups, groups, count); + } + group.jobs.clear(); + } + } + + /// Queue a job for every sprite whose blend at `tick` differs from what + /// its layer shows; the number of jobs. + fn collect(&mut self, tick: u64) -> usize { + let mut count = 0; + for sprite in &mut self.sprites { + let blend = sprite.animation.blend(tick); + if sprite.shown == Some(blend) { + continue; + } + sprite.shown = Some(blend); + let job = [ + sprite.layer, + sprite.frames[blend.frame], + sprite.frames[blend.next], + blend.millis, + sprite.edge, + ]; + let jobs = &mut self.groups[sprite.group].jobs; + for word in job { + jobs.extend_from_slice(&word.to_le_bytes()); + } + count += 1; + } + count + } +} + +/// The mip chain a frame's layer is made of, and its first level's edge. +/// `mipmap::generate` makes a sprite scaled up by whole pixels to the +/// array's size from its own size's chain, its first level repeated into the +/// larger levels: that chain, which the shader repeats. Any other sprite: its +/// chain at the array's size. +fn source_chain(pixels: &[u8], size: u32, settings: &[Settings], layer: u32) -> (Vec<u8>, u32) { + let native = settings.get(layer as usize).map_or(0, |s| s.native_size); + let edge = if native.is_power_of_two() && native < size { + native + } else { + size + }; + let frame = crate::sprites::resample(pixels, size, edge); + (super::mip_chain(&frame, edge, settings, layer, 1).0, edge) +} + +#[cfg(test)] +mod tests { + use super::*; + use crate::mipmap::Strategy; + + /// `animate.wgsl` on the CPU: `chain` (first level `edge` wide) as the + /// full chain of a `size` layer, mixed `millis` thousandths of the way + /// towards `next`. + fn reference(chain: &[u8], next: &[u8], millis: u32, edge: u32, size: u32) -> Vec<u8> { + let levels = size.trailing_zeros() + 1; + let mut out = Vec::new(); + for level in 0..levels { + let width = size >> level; + for y in 0..width { + for x in 0..width { + let texel = if width >= edge { + let scale = width / edge; + y / scale * edge + x / scale + } else { + 4 * (edge * edge - width * width) / 3 + y * width + x + } as usize; + for c in 0..4 { + let (a, b) = ( + u32::from(chain[texel * 4 + c]), + u32::from(next[texel * 4 + c]), + ); + out.push(((a * (1000 - millis) + b * millis + 500) / 1000) as u8); + } + } + } + } + out + } + + fn frame(size: u32, seed: u32) -> Vec<u8> { + (0..size * size) + .flat_map(|i| { + let v = i + .wrapping_mul(2654435761) + .wrapping_add(seed.wrapping_mul(40503)); + let alpha = match v >> 29 { + 0 => 0, + 1 => 77, + _ => 255, + }; + [(v >> 3) as u8, (v >> 11) as u8, (v >> 19) as u8, alpha] + }) + .collect() + } + + fn settings(native: u32, strategy: Strategy) -> Settings { + Settings { + native_size: native, + strategy, + alpha_cutoff_bias: -0.1, + ..Default::default() + } + } + + #[test] + fn source_chains_repeat_into_the_array_chain() { + // Sprites scaled up by whole pixels, at the array's size, and of a + // size that is not a power of two (scaled up to the next one). + for (native, size) in [(16, 16), (16, 64), (8, 32), (32, 64), (1, 16), (24, 32)] { + for strategy in [ + Strategy::Auto, + Strategy::Mean, + Strategy::Cutout, + Strategy::StrictCutout, + Strategy::DarkCutout, + ] { + for item in [false, true] { + let settings = [ + Settings::default(), + Settings { + item, + ..settings(native, strategy) + }, + ]; + let pixels = crate::sprites::resample(&frame(native, 3), native, size); + let (expected, _) = super::super::mip_chain(&pixels, size, &settings, 1, 1); + let (chain, edge) = source_chain(&pixels, size, &settings, 1); + let fits = native.is_power_of_two() && native < size; + assert_eq!(edge, if fits { native } else { size }); + assert_eq!( + reference(&chain, &chain, 0, edge, size), + expected, + "{native} in {size}, {strategy:?}, item {item}" + ); + } + } + } + } + + #[test] + fn real_animation_chains_repeat_into_the_array_chain() { + let root = std::path::Path::new(env!("CARGO_MANIFEST_DIR")) + .join("../../.local/horizon-client") + .join(horizon_core::VANILLA_VERSION); + if !root + .join("assets/minecraft/textures/block/water_still.png") + .exists() + { + return; + } + let mut sprites = crate::sprites::Sprites::default(); + for name in [ + "water_still", + "water_flow", + "lava_still", + "fire_0", + "nether_portal", + "sea_lantern", + "prismarine", + "magma", + "kelp", + "straw_bed", + ] { + sprites + .insert(&root, &format!("minecraft:block/{name}")) + .unwrap(); + } + sprites.finish(); + assert_eq!(sprites.size, 64); + assert_eq!(sprites.animations.len(), 9); + for animation in &sprites.animations { + for frame in 0..animation.frame_count() { + let pixels = animation.pixels(frame); + let (expected, _) = + super::super::mip_chain(pixels, 64, &sprites.mips, animation.layer, 1); + let (chain, edge) = source_chain(pixels, 64, &sprites.mips, animation.layer); + assert!(edge < 64, "layer {}", animation.layer); + assert_eq!(reference(&chain, &chain, 0, edge, 64), expected); + } + } + } + + #[test] + fn rounding_matches_f32_mix_but_for_exact_halves() { + // The CPU blend this replaced: f32 mix, then rounded. They differ + // only where the exact mix is a half, which f32 rounded either way. + for millis in 1..1000u32 { + let t = millis as f32 / 1000.0; + for a in 0..=255u32 { + for b in (0..=255u32).step_by(3) { + let f = ((a as f32 / 255.0) * (1.0 - t) + (b as f32 / 255.0) * t) * 255.0; + let exact = a * (1000 - millis) + b * millis; + let ours = (exact + 500) / 1000; + if exact % 1000 != 500 { + assert_eq!(ours, f.round() as u32, "{a} {b} {millis}"); + } + } + } + } + } + + fn device() -> Option<(wgpu::Device, wgpu::Queue)> { + let instance = wgpu::Instance::new(wgpu::InstanceDescriptor::new_without_display_handle()); + let adapter = pollster::block_on(instance.request_adapter(&Default::default())).ok()?; + pollster::block_on(adapter.request_device(&Default::default())).ok() + } + + /// Every layer's full mip chain, layer major. + fn read_back( + device: &wgpu::Device, + queue: &wgpu::Queue, + texture: &wgpu::Texture, + ) -> Vec<Vec<u8>> { + let layers = texture.depth_or_array_layers(); + let mut out = vec![Vec::new(); layers as usize]; + for level in 0..texture.mip_level_count() { + let edge = texture.width() >> level; + let padded = (edge * 4).next_multiple_of(wgpu::COPY_BYTES_PER_ROW_ALIGNMENT); + let buffer = device.create_buffer(&wgpu::BufferDescriptor { + label: None, + size: u64::from(padded * edge * layers), + usage: wgpu::BufferUsages::MAP_READ | wgpu::BufferUsages::COPY_DST, + mapped_at_creation: false, + }); + let mut encoder = device.create_command_encoder(&Default::default()); + encoder.copy_texture_to_buffer( + wgpu::TexelCopyTextureInfo { + texture, + mip_level: level, + origin: wgpu::Origin3d::ZERO, + aspect: wgpu::TextureAspect::All, + }, + wgpu::TexelCopyBufferInfo { + buffer: &buffer, + layout: wgpu::TexelCopyBufferLayout { + offset: 0, + bytes_per_row: Some(padded), + rows_per_image: Some(edge), + }, + }, + wgpu::Extent3d { + width: edge, + height: edge, + depth_or_array_layers: layers, + }, + ); + queue.submit([encoder.finish()]); + buffer + .slice(..) + .map_async(wgpu::MapMode::Read, |r| r.unwrap()); + device.poll(wgpu::PollType::wait_indefinitely()).unwrap(); + let data = buffer.slice(..).get_mapped_range().unwrap(); + for (layer, image) in data.chunks((padded * edge) as usize).enumerate() { + for row in image.chunks(padded as usize) { + out[layer].extend_from_slice(&row[..edge as usize * 4]); + } + } + } + out + } + + #[test] + fn gpu_layers_match_the_cpu_chains_every_tick() { + let Some((device, queue)) = device() else { + return; + }; + let size = 32; + // Layers 1 and 3: 8-pixel sprites with and without interpolation; + // layer 4: one at the array's size. Two layers per array. + let clips = [ + ( + 1, + 8, + r#"{"frametime":3,"interpolate":true,"frames":[0,2,1]}"#, + ), + (3, 8, r#"{"frametime":2}"#), + (4, 32, r#"{"frametime":5,"interpolate":true}"#), + ]; + let mut mips = vec![Settings::default(); 6]; + let animations: Vec<_> = clips + .iter() + .map(|&(layer, native, metadata)| { + mips[layer as usize] = settings(native, Strategy::Cutout); + let frames = (0..3) + .map(|f| crate::sprites::resample(&frame(native, layer * 7 + f), native, size)) + .collect(); + crate::sprites::test_frames(layer, frames, metadata) + }) + .collect(); + let split = 2; + let textures: Vec<_> = (0..3) + .map(|_| { + device.create_texture(&wgpu::TextureDescriptor { + label: None, + size: wgpu::Extent3d { + width: size, + height: size, + depth_or_array_layers: split, + }, + mip_level_count: size.trailing_zeros() + 1, + sample_count: 1, + dimension: wgpu::TextureDimension::D2, + format: wgpu::TextureFormat::Rgba8Unorm, + usage: wgpu::TextureUsages::STORAGE_BINDING | wgpu::TextureUsages::COPY_SRC, + view_formats: &[], + }) + }) + .collect(); + let mut animator = SpriteAnimator::new(&device, &animations, size, &mips, &textures, split); + let mut uploads = Uploads::new(&device); + let mut writes = Vec::new(); + for tick in [0, 0, 1, 2, 3, 4, 7, 7, 12, 30] { + let mut encoder = device.create_command_encoder(&Default::default()); + let shown: Vec<_> = animator.sprites.iter().map(|s| s.shown).collect(); + animator.animate(&mut encoder, &mut uploads, tick); + writes.push( + animator + .sprites + .iter() + .zip(shown) + .filter(|(s, shown)| s.shown != *shown) + .count(), + ); + uploads.finish(&encoder); + queue.submit([encoder.finish()]); + for animation in &animations { + let blend = animation.blend(tick); + let chain = |f| source_chain(animation.pixels(f), size, &mips, animation.layer); + let ((current, edge), (next, _)) = (chain(blend.frame), chain(blend.next)); + let layers = read_back( + &device, + &queue, + &textures[(animation.layer / split) as usize], + ); + assert_eq!( + layers[(animation.layer % split) as usize], + reference(¤t, &next, blend.millis, edge, size), + "layer {} at tick {tick}", + animation.layer + ); + } + } + // Every sprite on the first tick, then only those whose frame or mix + // changed since they were written: the interpolated ones every tick + // but layer 1 at tick 30 (two 9-tick loops after 12), layer 3 when + // its frame turns over (every 2 ticks, but 12 shows 7's frame). + assert_eq!(writes, [3, 0, 2, 3, 2, 3, 3, 0, 2, 1]); + } +} diff --git a/crates/horizon-client/src/gfx/animate.wgsl b/crates/horizon-client/src/gfx/animate.wgsl new file mode 100644 index 000000000..8998a1aa1 --- /dev/null +++ b/crates/horizon-client/src/gfx/animate.wgsl @@ -0,0 +1,48 @@ +// Animated block sprites (gfx/animate.rs), as vanilla's animate_sprite_blit +// and animate_sprite_interpolate shaders draw them: each job writes its +// frame, or the frame mixed with the next one, into one mip level of its +// sprite array layer. One invocation per texel; the job is the z coordinate. +struct Job { + layer: u32, + // Word offsets of the two frames' mip chains in `frames`. + current: u32, + next: u32, + // Thousandths of the way from `current` to `next` (0: `current` alone). + millis: u32, + // Edge of the chains' first level. + edge: u32, +} +@group(0) @binding(0) var<storage, read> frames: array<u32>; +@group(0) @binding(1) var<storage, read> jobs: array<Job>; +@group(0) @binding(2) var level: texture_storage_2d_array<rgba8unorm, write>; + +fn channels(rgba: u32) -> vec4<u32> { + return vec4(rgba & 0xffu, (rgba >> 8u) & 0xffu, (rgba >> 16u) & 0xffu, rgba >> 24u); +} + +@compute @workgroup_size(8, 8) +fn animate(@builtin(global_invocation_id) id: vec3<u32>) { + let size = textureDimensions(level).x; + if id.x >= size || id.y >= size { + return; + } + let job = jobs[id.z]; + // mipmap::generate: the levels at least as large as the chain's first + // repeat it by whole pixels, the smaller ones are the chain's own. + var texel: u32; + if size >= job.edge { + let scale = size / job.edge; + texel = id.y / scale * job.edge + id.x / scale; + } else { + // Every level above this one, each a quarter of the one before. + texel = 4u * (job.edge * job.edge - size * size) / 3u + id.y * size + id.x; + } + var color = channels(frames[job.current + texel]); + if job.millis > 0u { + // mix(current, next, millis / 1000), rounded to the nearest 8-bit + // value (halves up) in integers: the same on every GPU. + let next = channels(frames[job.next + texel]); + color = (color * (1000u - job.millis) + next * job.millis + 500u) / 1000u; + } + textureStore(level, id.xy, job.layer, vec4<f32>(color) / 255.0); +} diff --git a/crates/horizon-client/src/sprites.rs b/crates/horizon-client/src/sprites.rs index b89983966..6d754894a 100644 --- a/crates/horizon-client/src/sprites.rs +++ b/crates/horizon-client/src/sprites.rs @@ -63,6 +63,9 @@ impl SpriteAnimation { pub fn pixels(&self, frame: usize) -> &[u8] { &self.frames[frame] } + pub fn frame_count(&self) -> usize { + self.frames.len() + } } #[derive(Default)] @@ -93,7 +96,7 @@ pub const SPRITE_SIZE: u32 = 16; /// with bigger textures are sampled down to fit. const MAX_ARRAY_BYTES: u64 = 256 << 20; /// Nearest-resample a square RGBA frame to another square size. -fn resample(frame: &[u8], from: u32, to: u32) -> Vec<u8> { +pub(crate) fn resample(frame: &[u8], from: u32, to: u32) -> Vec<u8> { if from == to { return frame.to_vec(); } @@ -327,11 +330,15 @@ pub(crate) fn test_clip(size: u32, layer: u32, metadata: &str) -> SpriteAnimatio .flat_map(|i| [(i % size) as u8, (i / size) as u8, blue, 255]) .collect() }; + test_frames(layer, vec![frame(0), frame(99)], metadata) +} +#[cfg(test)] +pub(crate) fn test_frames(layer: u32, frames: Vec<Vec<u8>>, metadata: &str) -> SpriteAnimation { let metadata = AnimationMetadata::from_json(metadata).unwrap(); SpriteAnimation { layer, - frames: Arc::new(vec![frame(0), frame(99)]), - clip: Arc::new(metadata.clip(2).unwrap().unwrap()), + clip: Arc::new(metadata.clip(frames.len() as u32).unwrap().unwrap()), + frames: Arc::new(frames), } } From da996b9fd13e02ab3e758393b6d428d4ef6f07d0 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 17:06:28 +0200 Subject: [PATCH 026/126] port-pack: check one mod jar (Works, Partly, Doesn't run) from its content and classes `horizon-port-pack check <jar> <out>` carries a single jar into a folder content mod and reads its class files (constant pool, superclass, declared methods) for what the carry can't take: block entities, menus, entities, blocks and items with behaviour of their own, recipe types, worldgen code, Mixins, game events. The verdict and the lists of what ports and what is skipped go to check.json, for the launcher's mod browser to show before install. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/check.rs | 366 ++++++++++++++ crates/horizon-port-pack/src/classes.rs | 642 ++++++++++++++++++++++++ crates/horizon-port-pack/src/lib.rs | 2 + crates/horizon-port-pack/src/main.rs | 17 +- docs/modpacks.md | 16 + 5 files changed, 1042 insertions(+), 1 deletion(-) create mode 100644 crates/horizon-port-pack/src/check.rs create mode 100644 crates/horizon-port-pack/src/classes.rs diff --git a/crates/horizon-port-pack/src/check.rs b/crates/horizon-port-pack/src/check.rs new file mode 100644 index 000000000..16b360ab6 --- /dev/null +++ b/crates/horizon-port-pack/src/check.rs @@ -0,0 +1,366 @@ +//! One mod jar on its own, as the launcher's mod browser installs it: what +//! of it Horizon runs, said before install (Works, Partly, Doesn't run), +//! from the jar itself. The jar is carried over ([`crate::carry`]) into a +//! folder content mod, and its classes are read ([`crate::classes`]) for +//! what the carry can't take: block entities, entities, Mixins, behaviour. +//! +//! - **Works**: content only. Its blocks, items, recipes, loot, tags and +//! worldgen port, and its code only registers them. +//! - **Partly**: the content ports; the code features listed don't. +//! - **Doesn't run**: nothing to port (everything it does is Java code), or +//! the jar can't be carried at all. +use crate::{carry, classes, jar}; +use serde::{Deserialize, Serialize}; +use std::{collections::BTreeMap, fs, io::Read, path::Path}; + +#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)] +#[serde(rename_all = "kebab-case")] +pub enum Verdict { + Works, + Partly, + No, +} + +impl Verdict { + pub fn label(self) -> &'static str { + match self { + Verdict::Works => "Works", + Verdict::Partly => "Partly", + Verdict::No => "Doesn't run", + } + } +} + +/// What checking a jar found. Written as `check.json` beside the carry. +#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)] +pub struct Check { + pub mod_id: String, + pub name: String, + pub version: String, + /// `neoforge`, `forge`, `fabric`, `quilt`, or `` for a plain zip. + pub loader: String, + pub license: String, + pub verdict: Verdict, + /// One line: why this verdict. + pub summary: String, + /// What ports: "12 blocks", "40 recipes"... + pub ports: Vec<String>, + /// What doesn't, with why. + pub skipped: Vec<String>, + /// Required mods, by id. + pub depends: Vec<String>, + /// The folder mod's namespaces (its id first): two mods on at once may + /// not share one. + pub namespaces: Vec<String>, + pub code: classes::Code, +} + +/// The loader a jar is made for, from its metadata file. +fn loader(names: &[String]) -> &'static str { + let has = |n: &str| names.iter().any(|x| x == n); + if has("META-INF/neoforge.mods.toml") { + "neoforge" + } else if has("META-INF/mods.toml") { + "forge" + } else if has("fabric.mod.json") { + "fabric" + } else if has("quilt.mod.json") { + "quilt" + } else { + "" + } +} + +/// Data folders named as before 1.21 (`recipes/`, `loot_tables/`) and none +/// as 1.21 names them: the game doesn't read them, and the carry upgrades +/// from 1.21.1 on. (Some jars keep a stale plural folder beside the new one.) +fn old_layout(names: &[String]) -> bool { + let has = |kinds: [&str; 2]| { + names.iter().any(|n| { + let p: Vec<&str> = n.split('/').collect(); + p.len() > 3 && p[0] == "data" && kinds.contains(&p[2]) && n.ends_with(".json") + }) + }; + has(["recipes", "loot_tables"]) && !has(["recipe", "loot_table"]) +} + +fn plural(n: usize, one: &str, many: &str) -> String { + format!("{n} {}", if n == 1 { one } else { many }) +} + +/// Checks `jar` and carries it over into `out/carry/` (`out/check.json`, +/// `out/carry-report.json` beside it). The carry is the folder mod an +/// install copies. +pub fn check(jar_path: &Path, out: &Path) -> Result<Check, String> { + let info = jar::read(jar_path)?; + let file = fs::File::open(jar_path).map_err(|e| format!("{}: {e}", jar_path.display()))?; + let mut zip = zip::ZipArchive::new(file).map_err(|e| format!("{}: {e}", jar_path.display()))?; + let names: Vec<String> = zip.file_names().map(str::to_owned).collect(); + let mut bytes = Vec::new(); + for n in names.iter().filter(|n| n.ends_with(".class")) { + let mut b = Vec::new(); + if let Ok(mut e) = zip.by_name(n) + && e.size() < 1 << 24 + && e.read_to_end(&mut b).is_ok() + { + bytes.push(b); + } + } + let code = classes::census(bytes.iter().map(Vec::as_slice)); + let mut check = Check { + mod_id: info.mod_id.clone(), + name: info.name.clone(), + version: info.version.clone(), + loader: loader(&names).to_owned(), + license: info.license.clone(), + verdict: Verdict::No, + summary: String::new(), + ports: Vec::new(), + skipped: Vec::new(), + depends: info.depends.clone(), + namespaces: Vec::new(), + code, + }; + fs::create_dir_all(out).map_err(|e| format!("{}: {e}", out.display()))?; + let done = |check: Check| -> Result<Check, String> { + crate::pipeline::write_json(&out.join("check.json"), &check)?; + Ok(check) + }; + if old_layout(&names) { + check.summary = "Made for Minecraft 1.20 or older: Horizon ports mods made for 1.21 \ + and later." + .into(); + return done(check); + } + let alone = |m: &str| m == info.mod_id || m == "minecraft"; + let pack = carry::Pack { + loaded: &alone, + mods: &alone, + }; + let report = match carry::carry( + jar_path, + &info, + out, + None, + &|_| true, + &pack, + &BTreeMap::new(), + ) { + Ok(r) => r, + Err(e) => { + check.summary = format!("Can't be carried over: {e}"); + return done(check); + } + }; + check.namespaces = std::iter::once(info.mod_id.clone()) + .chain(report.namespaces.iter().cloned()) + .collect(); + let c = &info.census; + let recipes = report.recipes_upgraded; + let loot = c.loot_tables + report.loot_tables_added; + let content = + report.blocks.len() + report.items + recipes + loot + report.worldgen + c.structures; + for (n, one, many) in [ + (report.blocks.len(), "block", "blocks"), + (report.items, "item", "items"), + (recipes, "recipe", "recipes"), + (loot, "loot table", "loot tables"), + (report.worldgen, "worldgen file", "worldgen files"), + (c.textures, "texture", "textures"), + ] { + if n > 0 { + check.ports.push(plural(n, one, many)); + } + } + if !report.blocks.is_empty() { + check + .ports + .push("blocks take the closest vanilla block's shape, hardness and sounds".into()); + } + let mut skipped = Vec::new(); + if !report.blocks_unknown.is_empty() { + skipped.push(plural( + report.blocks_unknown.len(), + "block with no vanilla block to copy (left out)", + "blocks with no vanilla block to copy (left out)", + )); + } + if !report.recipes_kept.is_empty() { + skipped.push(plural( + report.recipes_kept.len(), + "recipe of a type Horizon doesn't have", + "recipes of types Horizon doesn't have", + )); + } + if !report.unreadable.is_empty() { + skipped.push(plural( + report.unreadable.len(), + "file the game can't read", + "files the game can't read", + )); + } + let wg = &report.worldgen_types; + let dropped = wg.processors_dropped.values().sum::<usize>(); + if dropped > 0 { + skipped.push(plural( + dropped, + "structure processor written in Java", + "structure processors written in Java", + )); + } + let unsupported = wg.unsupported.values().sum::<usize>(); + if unsupported > 0 { + skipped.push(plural( + unsupported, + "worldgen file of a type written in Java", + "worldgen files of types written in Java", + )); + } + for (f, n) in &check.code.features { + let mut line = f.describe(*n); + if *f == classes::Feature::Events { + let names: Vec<&str> = check + .code + .events + .iter() + .take(3) + .map(String::as_str) + .collect(); + line.push_str(&format!(" ({}", names.join(", "))); + if check.code.events.len() > 3 { + line.push_str(", ..."); + } + line.push(')'); + } + skipped.push(line); + } + check.skipped = skipped; + let behaviour = check.code.behaviour(); + (check.verdict, check.summary) = if content == 0 { + let what = if behaviour || check.code.classes > 0 { + "everything it does is Java code, which Horizon doesn't run" + } else { + "it has no blocks, items, recipes or worldgen" + }; + (Verdict::No, format!("Nothing to port: {what}.")) + } else if check.skipped.is_empty() { + ( + Verdict::Works, + format!( + "Content only: {} port.", + check.ports[..check.ports.len().min(3)].join(", ") + ), + ) + } else { + ( + Verdict::Partly, + format!( + "{} port; not {}.", + check.ports[..check.ports.len().min(2)].join(", "), + check.skipped[..check.skipped.len().min(2)].join(", ") + ), + ) + }; + done(check) +} + +#[cfg(test)] +mod tests { + use super::*; + use std::io::Write; + + fn jar(dir: &Path, files: &[(&str, &[u8])]) -> std::path::PathBuf { + let path = dir.join("m.jar"); + let mut zip = zip::ZipWriter::new(fs::File::create(&path).unwrap()); + for (name, bytes) in files { + zip.start_file(*name, zip::write::SimpleFileOptions::default()) + .unwrap(); + zip.write_all(bytes).unwrap(); + } + zip.finish().unwrap(); + path + } + + const TOML: &[u8] = br#"modLoader = "javafml" +license = "MIT" +[[mods]] +modId = "ruby" +version = "1.0" +displayName = "Ruby" +"#; + + fn temp(name: &str) -> std::path::PathBuf { + let dir = + std::env::temp_dir().join(format!("port-pack-check-{name}-{}", std::process::id())); + let _ = fs::remove_dir_all(&dir); + fs::create_dir_all(&dir).unwrap(); + dir + } + + #[test] + fn content_only_works_and_code_makes_it_partly() { + let dir = temp("content"); + let blockstate = br#"{"variants": {"": {"model": "ruby:block/ruby_block"}}}"#; + let recipe = br#"{"type": "minecraft:crafting_shapeless", "ingredients": ["minecraft:red_dye"], "result": {"id": "ruby:ruby"}}"#; + let plain = [ + ("META-INF/neoforge.mods.toml", TOML), + ("assets/ruby/blockstates/ruby_block.json", blockstate), + ("assets/ruby/models/item/ruby.json", b"{}"), + ("data/ruby/recipe/ruby.json", recipe), + ]; + let c = check(&jar(&dir, &plain), &dir.join("out")).unwrap(); + assert_eq!(c.verdict, Verdict::Works, "{c:?}"); + assert_eq!(c.loader, "neoforge"); + assert_eq!(&c.ports[..3], ["1 block", "1 item", "1 recipe"]); + assert!(dir.join("out/carry/horizon-mod.toml").is_file()); + assert!(dir.join("out/check.json").is_file()); + + let tile = crate::classes::tests_support::class_file( + "ruby/Tile", + "net/minecraft/world/level/block/entity/BlockEntity", + ); + let mut coded = plain.to_vec(); + coded.push(("ruby/Tile.class", &tile)); + let c = check(&jar(&dir, &coded), &dir.join("out")).unwrap(); + assert_eq!(c.verdict, Verdict::Partly); + assert!( + c.skipped[0].starts_with("1 block entity"), + "{:?}", + c.skipped + ); + fs::remove_dir_all(&dir).unwrap(); + } + + #[test] + fn code_only_and_old_layouts_dont_run() { + let dir = temp("code"); + let tile = crate::classes::tests_support::class_file("ruby/Mixin", "java/lang/Object"); + let c = check( + &jar( + &dir, + &[ + ("META-INF/neoforge.mods.toml", TOML), + ("ruby/A.class", &tile), + ], + ), + &dir.join("out"), + ) + .unwrap(); + assert_eq!(c.verdict, Verdict::No); + assert!(c.summary.starts_with("Nothing to port"), "{}", c.summary); + let c = check( + &jar( + &dir, + &[ + ("META-INF/mods.toml", TOML), + ("data/ruby/recipes/ruby.json", b"{}"), + ], + ), + &dir.join("out"), + ) + .unwrap(); + assert_eq!(c.verdict, Verdict::No); + assert!(c.summary.contains("1.20 or older")); + fs::remove_dir_all(&dir).unwrap(); + } +} diff --git a/crates/horizon-port-pack/src/classes.rs b/crates/horizon-port-pack/src/classes.rs new file mode 100644 index 000000000..d39c72e1a --- /dev/null +++ b/crates/horizon-port-pack/src/classes.rs @@ -0,0 +1,642 @@ +//! What a mod's Java code does, read from its class files without running +//! or decompiling them: each class's superclass, interfaces, declared +//! methods and the classes and annotations its constant pool names. The +//! mod's own classes are followed up to the first game class they extend, +//! and that class says what the code is: a block entity, a menu, an entity, +//! a block or item with behaviour of its own, a worldgen feature... +//! +//! Since 26.1 the game ships unobfuscated, and NeoForge has run on Mojang's +//! names since 1.20.5, so game classes and methods are read by name. Fabric +//! jars before 26.1 name them in intermediary (`net/minecraft/class_2248`) +//! and Forge's methods are SRG (`m_60503_`): a class extending such a game +//! class is counted as code of its own, whatever it overrides. +use serde::{Deserialize, Serialize}; +use std::collections::{BTreeMap, BTreeSet, HashMap}; + +/// One class file, as much as this module reads. +#[derive(Debug, Default, Clone, PartialEq)] +pub struct Class { + pub name: String, + pub superclass: String, + pub interfaces: Vec<String>, + /// Declared methods, by name (constructors and lambdas left out). + pub methods: Vec<String>, + /// Every class the constant pool names (`net/minecraft/...`). + pub refs: BTreeSet<String>, + /// Annotation and descriptor strings (`Lorg/spongepowered/asm/mixin/Mixin;`). + pub mixin: bool, +} + +/// Reads a class file's header, constant pool and declared methods. +pub fn parse(bytes: &[u8]) -> Option<Class> { + let mut r = Reader { bytes, at: 0 }; + if r.u4()? != 0xCAFE_BABE { + return None; + } + r.skip(4)?; // minor, major + let count = r.u2()? as usize; + let mut utf8: HashMap<usize, String> = HashMap::new(); + let mut class_of: HashMap<usize, usize> = HashMap::new(); + let mut i = 1; + while i < count { + let tag = r.u1()?; + match tag { + 1 => { + let len = r.u2()? as usize; + let s = r.take(len)?; + utf8.insert(i, String::from_utf8_lossy(s).into_owned()); + } + 7 => { + class_of.insert(i, r.u2()? as usize); + } + 8 | 16 | 19 | 20 => r.skip(2)?, + 3 | 4 | 9..=12 | 17 | 18 => r.skip(4)?, + 15 => r.skip(3)?, + 5 | 6 => { + r.skip(8)?; + i += 1; + } + _ => return None, + } + i += 1; + } + let class_name = |idx: usize| -> String { + class_of + .get(&idx) + .and_then(|u| utf8.get(u)) + .cloned() + .unwrap_or_default() + }; + r.skip(2)?; // access flags + let name = class_name(r.u2()? as usize); + let superclass = class_name(r.u2()? as usize); + let n = r.u2()? as usize; + let mut interfaces = Vec::with_capacity(n); + for _ in 0..n { + interfaces.push(class_name(r.u2()? as usize)); + } + // Fields, then methods: flags, name, descriptor, attributes. + let mut methods = Vec::new(); + for member in 0..2 { + let n = r.u2()?; + for _ in 0..n { + r.skip(2)?; + let name = r.u2()? as usize; + r.skip(2)?; + let attributes = r.u2()?; + for _ in 0..attributes { + r.skip(2)?; + let len = r.u4()? as usize; + r.skip(len)?; + } + if member == 1 + && let Some(m) = utf8.get(&name) + && !m.starts_with('<') + && !m.starts_with("lambda$") + { + methods.push(m.clone()); + } + } + } + let refs = class_of + .values() + .filter_map(|u| utf8.get(u)) + .filter(|s| !s.starts_with('[')) + .cloned() + .collect(); + let mixin = utf8 + .values() + .any(|s| s == "Lorg/spongepowered/asm/mixin/Mixin;"); + Some(Class { + name, + superclass, + interfaces, + methods, + refs, + mixin, + }) +} + +struct Reader<'a> { + bytes: &'a [u8], + at: usize, +} + +impl<'a> Reader<'a> { + fn take(&mut self, n: usize) -> Option<&'a [u8]> { + let s = self.bytes.get(self.at..self.at.checked_add(n)?)?; + self.at += n; + Some(s) + } + fn skip(&mut self, n: usize) -> Option<()> { + self.take(n).map(drop) + } + fn u1(&mut self) -> Option<u8> { + Some(self.take(1)?[0]) + } + fn u2(&mut self) -> Option<u16> { + let b = self.take(2)?; + Some(u16::from_be_bytes([b[0], b[1]])) + } + fn u4(&mut self) -> Option<u32> { + let b = self.take(4)?; + Some(u32::from_be_bytes([b[0], b[1], b[2], b[3]])) + } +} + +/// What a class does, as the port sees it. +#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash, Serialize, Deserialize)] +#[serde(rename_all = "kebab-case")] +pub enum Feature { + /// A block with behaviour of its own (use, ticks, collisions...). + BlockBehaviour, + /// A block with a shape of its own: it ports with its template's. + BlockShape, + /// An item with behaviour of its own (use, on hit...). + ItemBehaviour, + BlockEntity, + Menu, + Entity, + Screen, + Renderer, + /// A worldgen feature, placement or structure type written in Java. + Worldgen, + /// A recipe type (its recipes don't craft) or ingredient type. + Recipe, + Effect, + Enchantment, + Particle, + Command, + Network, + /// Reacts to game events (NeoForge's bus, Fabric's callbacks). + Events, + /// A Mixin: a patch to the game's own code. + Mixin, + /// Extends a game class under obfuscated names (Fabric before 26.1, + /// Forge's methods): what it does can't be read. + Unread, +} + +impl Feature { + /// How the coverage line names `n` of them. + pub fn describe(self, n: usize) -> String { + let (one, many) = match self { + Feature::BlockBehaviour => ( + "block with behaviour of its own (use, ticks, collisions)", + "blocks with behaviour of their own (use, ticks, collisions)", + ), + Feature::BlockShape => ( + "block with a shape of its own: it ports with its template's", + "blocks with shapes of their own: they port with their templates'", + ), + Feature::ItemBehaviour => ( + "item with behaviour of its own (use, on hit)", + "items with behaviour of their own (use, on hit)", + ), + Feature::BlockEntity => ( + "block entity (machine, container or animated block)", + "block entities (machines, containers, animated blocks)", + ), + Feature::Menu => ("menu (a container screen)", "menus (container screens)"), + Feature::Entity => ("mob or entity", "mobs or entities"), + Feature::Screen => ("screen of its own", "screens of its own"), + Feature::Renderer => ("renderer or model in code", "renderers or models in code"), + Feature::Worldgen => ( + "worldgen feature or structure type in code", + "worldgen features or structure types in code", + ), + Feature::Recipe => ( + "recipe type of its own (its recipes don't craft)", + "recipe types of its own (their recipes don't craft)", + ), + Feature::Effect => ("status effect", "status effects"), + Feature::Enchantment => ("enchantment effect in code", "enchantment effects in code"), + Feature::Particle => ("particle type", "particle types"), + Feature::Command => ("command", "commands"), + Feature::Network => ("network message", "network messages"), + Feature::Events => ("game event it reacts to", "game events it reacts to"), + Feature::Mixin => ( + "Mixin (a patch to the game's code)", + "Mixins (patches to the game's code)", + ), + Feature::Unread => ( + "class extending the game under obfuscated names", + "classes extending the game under obfuscated names", + ), + }; + format!("{n} {}", if n == 1 { one } else { many }) + } +} + +/// Block methods that only say how it looks or is placed: the template's +/// do the same for the states a blockstate file lists. +const BLOCK_LOOKS: [&str; 18] = [ + "codec", + "createBlockStateDefinition", + "getStateForPlacement", + "rotate", + "mirror", + "getRenderShape", + "skipRendering", + "getShadeBrightness", + "propagatesSkylightDown", + "getCloneItemStack", + "isPathfindable", + "getFluidState", + "updateShape", + "canBeReplaced", + "getLightBlock", + "useShapeForLightOcclusion", + "getDescriptionId", + "animateTick", +]; +/// Block methods that only change its outline or collision. +const BLOCK_SHAPES: [&str; 6] = [ + "getShape", + "getCollisionShape", + "getVisualShape", + "getOcclusionShape", + "getInteractionShape", + "getBlockSupportShape", +]; +/// Item methods that only say how it looks or is named. +const ITEM_LOOKS: [&str; 6] = [ + "appendHoverText", + "getName", + "isFoil", + "getDescriptionId", + "getBarColor", + "getBarWidth", +]; + +/// The game's own, loader and library classes: the first of these a mod's +/// class chain reaches is what it extends. +fn external(name: &str, own: &BTreeMap<String, Class>) -> bool { + !own.contains_key(name) +} + +fn obfuscated_method(m: &str) -> bool { + let digits = |s: &str| !s.is_empty() && s.bytes().all(|b| b.is_ascii_digit()); + m.strip_prefix("method_").is_some_and(digits) + || m.strip_prefix("m_") + .and_then(|s| s.strip_suffix('_')) + .is_some_and(digits) +} + +/// What a game class (Mojang's names) is, by its package and name. +fn kind_of_game_class(name: &str) -> Option<Feature> { + let rest = name.strip_prefix("net/minecraft/")?; + if rest.starts_with("class_") { + return Some(Feature::Unread); + } + let (package, simple) = rest.rsplit_once('/').unwrap_or(("", rest)); + Some(match package { + "world/level/block/entity" => Feature::BlockEntity, + p if p.starts_with("world/level/block") => Feature::BlockBehaviour, + "world/inventory" if simple.ends_with("Menu") => Feature::Menu, + p if p.starts_with("world/entity") => Feature::Entity, + p if p.starts_with("world/item/crafting") => Feature::Recipe, + p if p.starts_with("world/item/enchantment") => Feature::Enchantment, + p if p.starts_with("world/item") => Feature::ItemBehaviour, + p if p.starts_with("world/level/levelgen") => Feature::Worldgen, + "world/effect" => Feature::Effect, + p if p.starts_with("client/gui/screens") || p.starts_with("client/gui/components") => { + Feature::Screen + } + p if p.starts_with("client/renderer") || p.starts_with("client/model") => Feature::Renderer, + p if p.starts_with("client/particle") || p.starts_with("core/particles") => { + Feature::Particle + } + _ => return None, + }) +} + +/// Events a content mod uses to register what it has: not behaviour. +fn registration_event(name: &str) -> bool { + [ + "BuildCreativeModeTabContentsEvent", + "RegisterEvent", + "Register", + "Lifecycle", + "ModConfigEvent", + "AddPackFindersEvent", + "ItemGroupEvents", + "ClientLifecycleEvents", + "ServerLifecycleEvents", + ] + .iter() + .any(|k| name.rsplit('/').next().unwrap_or(name).contains(k)) + || name.contains("/lifecycle/") + || name.contains("/registries/") + || name.contains("/registry/") +} + +/// The code census: how many of each feature, and examples. +#[derive(Debug, Default, Clone, PartialEq, Serialize, Deserialize)] +pub struct Code { + pub classes: usize, + pub features: BTreeMap<Feature, usize>, + /// The game events it subscribes to, by simple name. + pub events: BTreeSet<String>, + /// Blocks and items with behaviour, and the methods they override. + pub examples: BTreeMap<String, Vec<String>>, +} + +impl Code { + /// Whether it does anything beyond registering blocks and items. + pub fn behaviour(&self) -> bool { + self.features + .keys() + .any(|f| *f != Feature::BlockShape && *f != Feature::Particle) + } +} + +/// Reads every class of a jar. `classes` are the class files' bytes. +pub fn census<'a>(classes: impl IntoIterator<Item = &'a [u8]>) -> Code { + let own: BTreeMap<String, Class> = classes + .into_iter() + .filter_map(parse) + .map(|c| (c.name.clone(), c)) + .collect(); + let mut code = Code { + classes: own.len(), + ..Code::default() + }; + let mut count = |f: Feature| *code.features.entry(f).or_default() += 1; + for c in own.values() { + if c.mixin { + count(Feature::Mixin); + continue; + } + // The first class outside the jar the chain reaches, and the + // methods declared along the way. + let mut methods: BTreeSet<&str> = c.methods.iter().map(String::as_str).collect(); + let mut at = c; + let mut seen = 0; + while !external(&at.superclass, &own) && seen < 64 { + at = &own[&at.superclass]; + methods.extend(at.methods.iter().map(String::as_str)); + seen += 1; + } + let base = at.superclass.as_str(); + let kind = kind_of_game_class(base).or_else(|| { + c.interfaces.iter().find_map(|i| match i.as_str() { + "net/minecraft/network/protocol/common/custom/CustomPacketPayload" => { + Some(Feature::Network) + } + "net/minecraft/world/MenuProvider" => Some(Feature::Menu), + _ => None, + }) + }); + let Some(kind) = kind else { + continue; + }; + let feature = match kind { + Feature::BlockBehaviour => { + let behaviour: Vec<&str> = methods + .iter() + .copied() + .filter(|m| !BLOCK_LOOKS.contains(m) && !BLOCK_SHAPES.contains(m)) + .collect(); + if !behaviour.is_empty() { + code.examples.insert( + c.name.rsplit('/').next().unwrap_or("").to_owned(), + behaviour.iter().map(|m| m.to_string()).collect(), + ); + if behaviour.iter().any(|m| obfuscated_method(m)) { + Some(Feature::Unread) + } else { + Some(Feature::BlockBehaviour) + } + } else if methods.iter().any(|m| BLOCK_SHAPES.contains(m)) { + Some(Feature::BlockShape) + } else { + None + } + } + Feature::ItemBehaviour => { + let behaviour: Vec<&str> = methods + .iter() + .copied() + .filter(|m| !ITEM_LOOKS.contains(m)) + .collect(); + if behaviour.is_empty() { + None + } else { + code.examples.insert( + c.name.rsplit('/').next().unwrap_or("").to_owned(), + behaviour.iter().map(|m| m.to_string()).collect(), + ); + Some(Feature::ItemBehaviour) + } + } + // A class extending an obfuscated game class without declaring + // anything adds nothing to read. + Feature::Unread if methods.is_empty() => None, + k => Some(k), + }; + if let Some(f) = feature { + count(f); + } + } + for c in own.values() { + for r in &c.refs { + let event = (r.starts_with("net/neoforged/neoforge/event/") + || r.starts_with("net/minecraftforge/event/") + || r.starts_with("net/fabricmc/fabric/api/event/") + || r.starts_with("net/fabricmc/fabric/api/entity/event/")) + && !registration_event(r); + if event { + let simple = r.rsplit('/').next().unwrap_or(r); + code.events + .insert(simple.split('$').next().unwrap_or(simple).to_owned()); + } + if r.starts_with("com/mojang/brigadier/") + && !code.features.contains_key(&Feature::Command) + { + code.features.insert(Feature::Command, 1); + } + } + } + if !code.events.is_empty() { + code.features.insert(Feature::Events, code.events.len()); + } + code +} + +#[cfg(test)] +pub(crate) mod tests_support { + /// A class file with `name` extending `superclass`, declaring `methods` + /// and naming `refs` in its constant pool. + pub fn class_with( + name: &str, + superclass: &str, + methods: &[&str], + refs: &[&str], + mixin: bool, + ) -> Vec<u8> { + let mut pool: Vec<Vec<u8>> = Vec::new(); + let utf = |pool: &mut Vec<Vec<u8>>, s: &str| -> u16 { + let mut e = vec![1]; + e.extend((s.len() as u16).to_be_bytes()); + e.extend(s.as_bytes()); + pool.push(e); + pool.len() as u16 + }; + let class = |pool: &mut Vec<Vec<u8>>, s: &str| -> u16 { + let u = utf(pool, s); + let mut e = vec![7]; + e.extend(u.to_be_bytes()); + pool.push(e); + pool.len() as u16 + }; + let this = class(&mut pool, name); + let sup = class(&mut pool, superclass); + for r in refs { + class(&mut pool, r); + } + // A long takes two slots. + pool.push(vec![5, 0, 0, 0, 0, 0, 0, 0, 1]); + pool.push(Vec::new()); + if mixin { + utf(&mut pool, "Lorg/spongepowered/asm/mixin/Mixin;"); + } + let desc = utf(&mut pool, "()V"); + let names: Vec<u16> = methods.iter().map(|m| utf(&mut pool, m)).collect(); + let mut out = vec![0xCA, 0xFE, 0xBA, 0xBE, 0, 0, 0, 65]; + out.extend(((pool.len() + 1) as u16).to_be_bytes()); + for e in &pool { + out.extend(e); + } + out.extend([0, 0x21]); + out.extend(this.to_be_bytes()); + out.extend(sup.to_be_bytes()); + out.extend([0, 0]); // interfaces + out.extend([0, 0]); // fields + out.extend((names.len() as u16).to_be_bytes()); + for n in names { + out.extend([0, 1]); + out.extend(n.to_be_bytes()); + out.extend(desc.to_be_bytes()); + // One attribute, to be skipped. + out.extend([0, 1, 0, 1, 0, 0, 0, 2, 0, 0]); + } + out.extend([0, 0]); // class attributes + out + } + + /// A class extending `superclass` and declaring nothing. + pub fn class_file(name: &str, superclass: &str) -> Vec<u8> { + class_with(name, superclass, &[], &[], false) + } +} + +#[cfg(test)] +mod tests { + use super::tests_support::class_with as class_file; + use super::*; + + #[test] + fn reads_the_header_methods_and_pool() { + let bytes = class_file( + "a/Lamp", + "net/minecraft/world/level/block/Block", + &["<init>", "useWithoutItem", "lambda$x$0"], + &["net/minecraft/world/item/Item"], + false, + ); + let c = parse(&bytes).unwrap(); + assert_eq!(c.name, "a/Lamp"); + assert_eq!(c.superclass, "net/minecraft/world/level/block/Block"); + assert_eq!(c.methods, ["useWithoutItem"]); + assert!(c.refs.contains("net/minecraft/world/item/Item")); + assert!(!c.mixin); + assert!(parse(&bytes[..bytes.len() - 3]).is_none()); + assert!(parse(b"not a class").is_none()); + } + + #[test] + fn follows_own_classes_to_the_game() { + let block = "net/minecraft/world/level/block/Block"; + let files = [ + // Looks only: a template covers it. + class_file("m/Plain", block, &["getStateForPlacement"], &[], false), + class_file("m/Round", block, &["getShape"], &[], false), + // Behaviour two levels down. + class_file("m/Base", block, &["randomTick"], &[], false), + class_file("m/Lamp", "m/Base", &[], &[], false), + class_file( + "m/Tile", + "net/minecraft/world/level/block/entity/BlockEntity", + &[], + &[], + false, + ), + class_file("m/Mix", "java/lang/Object", &[], &[], true), + class_file( + "m/Old", + "net/minecraft/class_2248", + &["method_9534"], + &[], + false, + ), + class_file( + "m/Events", + "java/lang/Object", + &[], + &[ + "net/neoforged/neoforge/event/entity/player/PlayerInteractEvent$RightClickBlock", + "net/neoforged/neoforge/event/BuildCreativeModeTabContentsEvent", + "net/neoforged/neoforge/registries/DeferredRegister", + ], + false, + ), + class_file( + "m/Gem", + "net/minecraft/world/item/Item", + &["appendHoverText"], + &[], + false, + ), + ]; + let code = census(files.iter().map(Vec::as_slice)); + assert_eq!(code.classes, 9); + let n = |f| code.features.get(&f).copied().unwrap_or(0); + assert_eq!(n(Feature::BlockBehaviour), 2, "{code:?}"); + assert_eq!(n(Feature::BlockShape), 1); + assert_eq!(n(Feature::BlockEntity), 1); + assert_eq!(n(Feature::Mixin), 1); + assert_eq!(n(Feature::Unread), 1); + assert_eq!(n(Feature::ItemBehaviour), 0); + assert_eq!( + code.events.iter().collect::<Vec<_>>(), + ["PlayerInteractEvent"] + ); + assert!(code.behaviour()); + } + + #[test] + fn registration_only_is_not_behaviour() { + let files = [ + class_file( + "m/Mod", + "java/lang/Object", + &["register"], + &[ + "net/neoforged/neoforge/registries/DeferredRegister", + "net/minecraft/world/level/block/Block", + ], + false, + ), + class_file( + "m/Pillar", + "net/minecraft/world/level/block/RotatedPillarBlock", + &[], + &[], + false, + ), + ]; + let code = census(files.iter().map(Vec::as_slice)); + assert!(!code.behaviour(), "{code:?}"); + } +} diff --git a/crates/horizon-port-pack/src/lib.rs b/crates/horizon-port-pack/src/lib.rs index 08f9b273f..f729b6c52 100644 --- a/crates/horizon-port-pack/src/lib.rs +++ b/crates/horizon-port-pack/src/lib.rs @@ -6,6 +6,8 @@ //! jars they downloaded and what is carried over from them stay there and //! are never uploaded or committed. pub mod carry; +pub mod check; +pub mod classes; pub mod classify; pub mod fetch; pub mod import; diff --git a/crates/horizon-port-pack/src/main.rs b/crates/horizon-port-pack/src/main.rs index e766a442d..2598b47ed 100644 --- a/crates/horizon-port-pack/src/main.rs +++ b/crates/horizon-port-pack/src/main.rs @@ -19,6 +19,10 @@ //! - `report <work>`: the coverage report, per mod ported, partial, not yet //! or not needed with the reason, in `<work>/coverage.json` and //! `coverage.md`. +//! - `check <jar> <out>`: one mod jar on its own, as the launcher's mod +//! browser installs it: carried over into `<out>/carry/`, its classes +//! read, and the verdict (Works, Partly, Doesn't run) in +//! `<out>/check.json`. //! - `port <pack> <work> [--from <folder>] [--resources <prepared>]`: every //! step for the portable mods, as the launcher's "Import modpack" runs it. //! @@ -30,7 +34,7 @@ use std::{ process::ExitCode, }; -const USAGE: &str = "usage: horizon-port-pack import <pack> <work> | inventory <work> [--offline] | fetch <work> [--from <folder>] [<mod id>...] | carry <work> [--resources <prepared>] [<mod id>...] | report <work> | port <pack> <work> [--from <folder>] [--resources <prepared>]"; +const USAGE: &str = "usage: horizon-port-pack import <pack> <work> | inventory <work> [--offline] | fetch <work> [--from <folder>] [<mod id>...] | carry <work> [--resources <prepared>] [<mod id>...] | report <work> | check <jar> <out> | port <pack> <work> [--from <folder>] [--resources <prepared>]"; fn main() -> ExitCode { let mut args: Vec<String> = std::env::args().skip(1).collect(); @@ -66,6 +70,17 @@ fn main() -> ExitCode { println!("{}", work.join("coverage.md").display()); Ok(()) } + Some("check") => { + let c = horizon_port_pack::check::check(path(1)?, path(2)?)?; + println!("{}: {}. {}", c.mod_id, c.verdict.label(), c.summary); + for p in &c.ports { + println!(" ports: {p}"); + } + for s in &c.skipped { + println!(" skipped: {s}"); + } + Ok(()) + } Some("port") => { let work = path(2)?; pipeline::import(path(1)?, work, log)?; diff --git a/docs/modpacks.md b/docs/modpacks.md index 7d254beca..d062eb941 100644 --- a/docs/modpacks.md +++ b/docs/modpacks.md @@ -302,6 +302,22 @@ cargo run -p horizon-port-pack -- report ~/.horizon/ports/pack # coverage cargo run -p horizon-port-pack -- port ~/Downloads/pack.zip ~/.horizon/ports/pack [--from <folder>] [--resources <root>] ``` +`check <jar> <out>` takes one mod jar on its own, as the launcher's mod browser installs it +([mod-browser.md](mod-browser.md)): it carries the jar into `<out>/carry/` and reads its class +files (constant pool, superclass, declared methods; no decompiling) for what the carry can't +take, then writes the verdict to `<out>/check.json`. **Works**: content only, and the code just +registers it. **Partly**: the content ports, and the code features listed don't (block entities, +menus, entities, blocks and items with behaviour of their own, recipe types, Mixins, game events). +**Doesn't run**: nothing to port, or a jar made for 1.20 or older. Each mod class is followed up to +the first game class it extends; a block subclass that only overrides how it looks or is placed +(`getStateForPlacement`, `rotate`...) is registration. Game classes are read by Mojang's names +(26.1 and later, and NeoForge since 1.20.5); older Fabric jars name them in intermediary, so a +class extending one counts as code that can't be read. On ten 26.3 jars (2026-10-22): Macaw's +Fences, Windows and Furniture, Ecologics, Compressed Blocks, More Decorative Blocks and Moog's +Nether Structures are Partly; Sodium and GeckoLib don't run (Mixins, renderers, nothing to port); +Fabric API doesn't run (its id has a dash, which content mods can't use). A check takes 0.2 s to +3 s, and 24 s for Compressed Blocks (18 MB, 9,360 recipes, writing the carry dominates). + `fetch` gets each jar the player's way, never from us: copied from a folder they have (matched by SHA-1, or through a CurseForge app instance's `minecraftinstance.json`), else downloaded from the link the pack itself gives (a `.mrpack`'s, on the format's hosts only) or, for a CurseForge From 4a350bb0a03c64b34245ddd5e3f526de305988f2 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 17:57:24 +0200 Subject: [PATCH 027/126] port-pack carry: leave out recipes for items it didn't declare A recipe whose result is one of the mod's own items that the carry didn't declare (its block had no vanilla template) loaded and crafted air. Vanilla refuses a recipe for an unknown item; the carry now moves such recipes to outside/ and lists them (recipes_unregistered), and check says "N recipes for left-out blocks". Found by the mod browser's end-to-end run on Macaw's Fences. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/carry.rs | 89 +++++++++++++++++++++++++++ crates/horizon-port-pack/src/check.rs | 47 +++++++++++++- 2 files changed, 135 insertions(+), 1 deletion(-) diff --git a/crates/horizon-port-pack/src/carry.rs b/crates/horizon-port-pack/src/carry.rs index e6056e519..c1fe2b32a 100644 --- a/crates/horizon-port-pack/src/carry.rs +++ b/crates/horizon-port-pack/src/carry.rs @@ -37,6 +37,10 @@ pub struct Report { pub worldgen: usize, /// Recipes left as they were: custom types, NeoForge conditions. pub recipes_kept: Vec<String>, + /// Recipes whose result is one of the mod's own items that isn't declared (its block was + /// left out), moved to `outside/`: vanilla refuses a recipe for an unknown item, and the + /// game would craft air. + pub recipes_unregistered: Vec<String>, pub item_definitions_added: usize, /// Templates and properties came from the NeoForge oracle's facts, not /// from guesses. @@ -1083,6 +1087,9 @@ pub fn carry( report.items += 1; } } + let owned: Vec<String> = owned.iter().map(|n| n.to_string()).collect(); + let owned: Vec<&str> = owned.iter().map(String::as_str).collect(); + unregistered_recipes(&inside, &outside, id, &owned, &mut report)?; let q = |s: &str| toml::Value::String(s.to_owned()).to_string(); let name = if info.name.is_empty() { id } else { &info.name }; let mut manifest = format!( @@ -1109,6 +1116,88 @@ pub fn carry( Ok(report) } +/// The item a recipe makes: `result.id` (1.21 and later), `result.item` or a bare id. +fn recipe_result(recipe: &Value) -> Option<&str> { + let r = &recipe["result"]; + r.as_str() + .or_else(|| r["id"].as_str()) + .or_else(|| r["item"].as_str()) +} + +/// Moves the recipes whose result is an undeclared item of the mod's own namespaces from +/// `inside` to `outside` ([`Report::recipes_unregistered`]). The declared items are the blocks +/// with their item and the items under `data/<id>/horizon/`. +fn unregistered_recipes( + inside: &Path, + outside: &Path, + id: &str, + owned: &[&str], + report: &mut Report, +) -> Result<(), String> { + let decl = inside.join(format!("data/{id}/horizon")); + let mut declared = BTreeSet::new(); + for kind in ["block", "item"] { + for f in fs::read_dir(decl.join(kind)) + .into_iter() + .flatten() + .flatten() + { + let path = f.path(); + let Some(name) = path.file_stem().and_then(|n| n.to_str()) else { + continue; + }; + let has_item = kind == "item" + || fs::read(&path) + .ok() + .and_then(|b| serde_json::from_slice::<Value>(&b).ok()) + .is_none_or(|v| v["item"] != json!(false)); + if has_item { + declared.insert(format!("{id}:{name}")); + } + } + } + for ns in owned { + let dir = inside.join(format!("data/{ns}/recipe")); + let mut stack = vec![dir.clone()]; + while let Some(d) = stack.pop() { + for f in fs::read_dir(&d).into_iter().flatten().flatten() { + let path = f.path(); + if path.is_dir() { + stack.push(path); + continue; + } + let Some(recipe) = fs::read(&path) + .ok() + .and_then(|b| serde_json::from_slice::<Value>(&b).ok()) + else { + continue; + }; + let Some(result) = recipe_result(&recipe) else { + continue; + }; + let unknown = result + .split_once(':') + .is_some_and(|(n, _)| owned.contains(&n) && !declared.contains(result)); + if !unknown { + continue; + } + let rel = path.strip_prefix(inside).map_err(|e| e.to_string())?; + let to = outside.join(rel); + if let Some(parent) = to.parent() { + fs::create_dir_all(parent).map_err(|e| format!("{}: {e}", parent.display()))?; + } + fs::rename(&path, &to).map_err(|e| format!("{}: {e}", to.display()))?; + report.copied = report.copied.saturating_sub(1); + report + .recipes_unregistered + .push(rel.to_string_lossy().into_owned()); + } + } + } + report.recipes_unregistered.sort(); + Ok(()) +} + /// The tags a recipe's ingredients name (`#ns:path` or `{"tag": ...}`). fn tags_used(v: &Value, out: &mut BTreeSet<String>) { match v { diff --git a/crates/horizon-port-pack/src/check.rs b/crates/horizon-port-pack/src/check.rs index 16b360ab6..68331dbc4 100644 --- a/crates/horizon-port-pack/src/check.rs +++ b/crates/horizon-port-pack/src/check.rs @@ -156,7 +156,9 @@ pub fn check(jar_path: &Path, out: &Path) -> Result<Check, String> { .chain(report.namespaces.iter().cloned()) .collect(); let c = &info.census; - let recipes = report.recipes_upgraded; + let recipes = report + .recipes_upgraded + .saturating_sub(report.recipes_unregistered.len()); let loot = c.loot_tables + report.loot_tables_added; let content = report.blocks.len() + report.items + recipes + loot + report.worldgen + c.structures; @@ -185,6 +187,13 @@ pub fn check(jar_path: &Path, out: &Path) -> Result<Check, String> { "blocks with no vanilla block to copy (left out)", )); } + if !report.recipes_unregistered.is_empty() { + skipped.push(plural( + report.recipes_unregistered.len(), + "recipe for a left-out block", + "recipes for left-out blocks", + )); + } if !report.recipes_kept.is_empty() { skipped.push(plural( report.recipes_kept.len(), @@ -331,6 +340,42 @@ displayName = "Ruby" fs::remove_dir_all(&dir).unwrap(); } + #[test] + fn recipes_for_left_out_blocks_are_left_out_too() { + let dir = temp("left-out"); + let odd = br#"{"variants": {"wobble=1": {"model": "ruby:block/odd"}}}"#; + let plain = br#"{"variants": {"": {"model": "ruby:block/ruby_block"}}}"#; + let recipe = |result: &str| { + format!( + r#"{{"type": "minecraft:crafting_shapeless", "ingredients": ["minecraft:red_dye"], "result": {{"id": "{result}"}}}}"# + ) + }; + let (odd_recipe, block_recipe) = (recipe("ruby:odd"), recipe("ruby:ruby_block")); + let files = [ + ("META-INF/neoforge.mods.toml", TOML), + ("assets/ruby/blockstates/odd.json", odd.as_slice()), + ("assets/ruby/blockstates/ruby_block.json", plain.as_slice()), + ("data/ruby/recipe/odd.json", odd_recipe.as_bytes()), + ("data/ruby/recipe/ruby_block.json", block_recipe.as_bytes()), + ]; + let c = check(&jar(&dir, &files), &dir.join("out")).unwrap(); + assert_eq!(c.verdict, Verdict::Partly); + assert!(c.ports.contains(&"1 recipe".to_string()), "{:?}", c.ports); + assert!( + c.skipped + .contains(&"1 recipe for a left-out block".to_string()), + "{:?}", + c.skipped + ); + assert!(!dir.join("out/carry/data/ruby/recipe/odd.json").exists()); + assert!(dir.join("out/outside/data/ruby/recipe/odd.json").exists()); + assert!( + dir.join("out/carry/data/ruby/recipe/ruby_block.json") + .exists() + ); + fs::remove_dir_all(&dir).unwrap(); + } + #[test] fn code_only_and_old_layouts_dont_run() { let dir = temp("code"); From 35305605819cece46b2c53bdc94cc9de5151bd80 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 17:28:12 +0200 Subject: [PATCH 028/126] Launcher: Java mods in the mod browser, checked before install; Modpacks moves into Mods The Mods page gets a Mods tab: Fabric, NeoForge, Forge and Quilt mods for 26.3 (1.21 and later with Show everything). Each result's jar is downloaded (allowed CDNs, checksum), checked with horizon-port-pack (Works, Partly, Doesn't run, with what ports and what doesn't) and the answer cached per file. Install copies the carry into horizon-mods/<id>/ and turns it on in horizon-mods.txt, with required mods that port; libraries with nothing to port are listed as not ported; id or namespace clashes are refused. Remove deletes it and turns it off. The Modpacks page becomes the Mods page's Modpacks tab: imported packs first, then the search. CLI: mods search --kind mod, mods check <project>. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- docs/mod-browser.md | 59 +++- launcher/src/browser.rs | 70 ++++- launcher/src/browser/curseforge.rs | 3 +- launcher/src/browser/installed.rs | 43 ++- launcher/src/browser/installed/tests.rs | 2 +- launcher/src/browser/java.rs | 340 ++++++++++++++++++++++++ launcher/src/browser/modrinth.rs | 10 + launcher/src/browser/tests.rs | 55 +++- launcher/src/cli.rs | 70 ++++- launcher/src/main.rs | 5 +- launcher/src/modpacks_page.rs | 33 +-- launcher/src/mods_page.rs | 139 +++++++++- website/docs/modpacks.md | 2 +- website/docs/mods.md | 12 +- 14 files changed, 760 insertions(+), 83 deletions(-) create mode 100644 launcher/src/browser/java.rs diff --git a/docs/mod-browser.md b/docs/mod-browser.md index 115877075..bc7a80b16 100644 --- a/docs/mod-browser.md +++ b/docs/mod-browser.md @@ -1,25 +1,56 @@ # The launcher's mod browser -Search Modrinth (and CurseForge, once the launcher has a key) for packs Horizon loads, see how well each one runs, -and install it with its checksum checked. This is item 16 of the roadmap and issue #577. The code is in +Search Modrinth (and CurseForge, once the launcher has a key) for Java mods, modpacks, resource packs and shader +packs, see how well each one runs before installing it, and install it with its checksum checked. This is item 16 of the roadmap and issue #577. The code is in `launcher/src/browser.rs` and `launcher/src/browser/`. ## What it offers -Only what Horizon actually loads is offered. Java mod jars (Fabric, NeoForge, Forge) don't run in Horizon -([mods.md](mods.md), [research/java-mod-compat.md](research/java-mod-compat.md)), so they are never searched. -Horizon `.hmod` mods aren't on Modrinth or CurseForge yet (Modrinth has no `horizon` loader). +Horizon doesn't run Java code ([research/java-mod-compat.md](research/java-mod-compat.md)). It ports what a Java mod +carries as data (blocks, items, recipes, loot tables, tags, worldgen, textures, names) with `horizon-port-pack`, and +says before install which of the mod's features that leaves out. Horizon `.hmod` mods aren't on Modrinth or CurseForge +yet (Modrinth has no `horizon` loader). | Kind | Goes to | How well it runs | |---|---|---| +| Java mods (Fabric, NeoForge, Forge, Quilt) | ported into `horizon-mods/<mod id>/` and turned on | Checked from its jar before install: **Works**, **Partly** or **Doesn't run** ([below](#java-mods)) | | Resource packs | `resourcepacks/` beside `options.txt` | **Works** when made for 26.3 ([resource-packs.md](resource-packs.md) lists what Horizon reads). Older packs are **Partly**: they load with vanilla's compatibility warning | | Shader packs (Iris, OptiFine) | `shaderpacks/` | **Partly**: translated to WGSL, the full-screen passes draw and the world and shadow passes don't yet ([shader-packs.md](shader-packs.md)). Packs for other loaders (Canvas, core-shader packs) **don't run** and can't be installed | | Modpacks (`.mrpack`, CurseForge zip) | the Modpacks page's import | **Partly**: Horizon runs the mods it can port, from the player's own downloads ([modpacks.md](modpacks.md)) | -By default a search shows only what runs: resource packs made for 26.3, shader packs for Iris or OptiFine, and every -modpack. **Show everything** lists the rest of the kind too, each marked with how well it runs; what doesn't run is +By default a search shows only what runs: Java mods made for 26.3, resource packs made for 26.3, shader packs for Iris +or OptiFine, and every modpack. **Show everything** lists the rest of the kind too, each marked with how well it runs; what doesn't run is never offered for install. +## Java mods + +Before a mod is offered for install, the launcher reads its jar. For each result it picks the version it would +install (the newest for 26.3; with **Show everything**, else the newest for 1.21 or later, the versions port-pack +upgrades from), downloads that file with the checks below, and runs `horizon-port-pack check` on it +([modpacks.md](modpacks.md#the-pipeline-horizon-port-pack)): the jar is carried over into a folder content mod and its +class files are read, not run, for what the carry can't take. Two checks run at once; the row says **Checking** until +its answer comes. + +- **Works**: content only. Its blocks, items, recipes, loot, tags and worldgen port, and its code only registers + them. Blocks take the closest vanilla block's shape, hardness and sounds (a block's numbers live in Java code; the + NeoForge oracle that reads them for modpacks is a developer tool). +- **Partly**: the content ports; the row lists what doesn't: blocks with no vanilla block to copy, recipes of the + mod's own types, block entities (machines, containers), menus, mobs and entities, blocks and items with behaviour + of their own, worldgen written in Java, Mixins, the game events it reacts to. +- **Doesn't run**: nothing to port (performance mods, libraries, everything in code), a jar made for 1.20 or older, + or a mod id with characters Horizon mods can't use (`fabric-api`). Never offered for install. + +The answer is kept in `mod-browser/checks-1/<checksum>/` under the game folder, with the carry when something +ports; the jar itself isn't kept. A file is checked once. On ten 26.3 jars a check took 0.2 to 3 s (24 s for an +18 MB jar with 9,360 recipes). + +**Install** copies the carry into `horizon-mods/<mod id>/`, turns it on in `horizon-mods.txt` (the game's Options > +Mods lists it) and records it in `mod-browser.json` with its verdict and what didn't port, which the Installed list +shows. Its required mods that port are installed with it; one with nothing to port (a library such as Cloth Config +or GeckoLib) is listed as not ported. A mod that shares its id or a namespace with an installed one is refused. The +game reads mod content when it starts: start it again after installing. **Remove** deletes the folder and turns it +off. + ## Checks on every download - The file must come from Modrinth's or CurseForge's file servers (`cdn.modrinth.com`, `edge.forgecdn.net`, @@ -32,10 +63,11 @@ never offered for install. ## The Mods page -The launcher's **Mods** page has the three kinds as tabs, a search field (Enter searches), **Show everything** and, +The launcher's **Mods** page has the four kinds as tabs (Mods, Modpacks, Resource packs, Shader packs), a search field (Enter searches), **Show everything** and, once CurseForge is set up, a Modrinth / CurseForge switch. Each result is an index row: its summary, author, downloads, source and licence, how well it runs (and why), **Page** (the project's page on its source) and -**Install** (**Import** for a modpack). Installed packs are listed above the results with their version, source, +**Install** (**Import** for a modpack). The Modpacks tab lists the imported packs first, with their coverage +report, **Port** and **Play** ([modpacks.md](modpacks.md)). Installed packs are listed above the results with their version, source, file and the checksum they were checked against, with **Update to …** when a newer version runs and **Remove** (asked twice). @@ -51,14 +83,15 @@ same name the player put there is never overwritten. Packs, as in vanilla and Iris. - **Update** installs the newer version and removes the old file. - **Remove** deletes the file and its entry. Packs installed as dependencies stay. -- **A modpack** is downloaded (checked the same way) into `ports/downloads/` and imported on the Modpacks page, - which says what of it Horizon runs and ports it. +- **A modpack** is downloaded (checked the same way) into `ports/downloads/` and imported; the Modpacks tab says + what of it Horizon runs and ports it. From a terminal (or an agent): ```sh -horizon-launcher mods search faithful # --kind resource|shader|modpack, --everything, --source -horizon-launcher mods install faithful-32x # id or slug; a modpack is imported +horizon-launcher mods search faithful # --kind mod|modpack|resource|shader, --everything, --source +horizon-launcher mods check macaws-fences-and-walls # a Java mod's verdict, what ports and what doesn't (--json) +horizon-launcher mods install faithful-32x # id or slug; a Java mod is ported, a modpack imported horizon-launcher mods list # --json horizon-launcher mods update [faithful-32x] [--check] horizon-launcher mods remove faithful-32x diff --git a/launcher/src/browser.rs b/launcher/src/browser.rs index 49ec1e696..b8248fd7c 100644 --- a/launcher/src/browser.rs +++ b/launcher/src/browser.rs @@ -2,12 +2,14 @@ //! Horizon loads, say how well each result runs, and download a file only after its checksum //! matches (docs/mod-browser.md). //! -//! Only what Horizon actually loads is offered: resource packs (`resourcepacks/`), Java shader -//! packs (`shaderpacks/`, Iris and OptiFine) and modpacks (imported and ported on the Modpacks -//! page). Java mod jars don't run in Horizon (docs/mods.md), so they are never searched. +//! Offered: Java mods (Fabric, NeoForge, Forge), whose content Horizon ports and whose jar is +//! checked before install ([`java`]), modpacks (imported and ported), resource packs +//! (`resourcepacks/`) and Java shader packs (`shaderpacks/`, Iris and OptiFine). Java code itself +//! doesn't run in Horizon (docs/mods.md). pub mod curseforge; pub mod download; pub mod installed; +pub mod java; pub mod modrinth; use serde::{Deserialize, Serialize}; @@ -23,25 +25,34 @@ pub enum Kind { ResourcePack, ShaderPack, Modpack, + /// A Java mod: its content is ported ([`java`]). + Mod, } impl Kind { - pub const ALL: [Kind; 3] = [Kind::ResourcePack, Kind::ShaderPack, Kind::Modpack]; + pub const ALL: [Kind; 4] = [ + Kind::Mod, + Kind::Modpack, + Kind::ResourcePack, + Kind::ShaderPack, + ]; pub fn label(self) -> &'static str { match self { + Kind::Mod => "Mods", Kind::ResourcePack => "Resource packs", Kind::ShaderPack => "Shader packs", Kind::Modpack => "Modpacks", } } - /// The folder beside `options.txt` the file goes in; a modpack is imported instead. + /// The folder beside `options.txt` the file goes in; a modpack is imported and a mod + /// ported instead. pub fn folder(self) -> Option<&'static str> { match self { Kind::ResourcePack => Some("resourcepacks"), Kind::ShaderPack => Some("shaderpacks"), - Kind::Modpack => None, + Kind::Modpack | Kind::Mod => None, } } } @@ -256,11 +267,34 @@ pub fn support(kind: Kind, game_versions: &[String], loaders: &[String]) -> Supp )) } } - Kind::Modpack => Support::Partial( - "Imported on the Modpacks page: Horizon runs the mods it can port, from your own \ - downloads." - .into(), - ), + Kind::Modpack => { + Support::Partial("Horizon runs the mods it can port, from your own downloads.".into()) + } + Kind::Mod => { + if !loaders.iter().any(|l| java::LOADERS.contains(&l.as_str())) { + Support::No("Not a Fabric, NeoForge or Forge mod.".into()) + } else if !game_versions.iter().any(|v| portable_version(v)) { + let newest = newest_release(game_versions).unwrap_or("an unknown version"); + Support::No(format!( + "Made for {newest}: Horizon ports mods made for 1.21 and later." + )) + } else { + Support::Partial( + "Not checked yet: the launcher reads its jar to say what of it ports.".into(), + ) + } + } + } +} + +/// A Minecraft version whose mods port-pack carries over: 1.21 and later (the data folders +/// took their current names in 1.21). +pub fn portable_version(v: &str) -> bool { + let parts: Vec<u32> = v.split('.').map_while(|p| p.parse().ok()).collect(); + match parts.as_slice() { + [1, minor, ..] => *minor >= 21 && v.split('.').count() == parts.len(), + [year, ..] => *year >= 26 && v.split('.').count() == parts.len(), + [] => false, } } @@ -286,6 +320,20 @@ pub fn pick(kind: Kind, versions: &[Version], everything: bool) -> Option<&Versi let mut usable = versions .iter() .filter(|v| v.blocked.is_none() && v.file().is_some()); + if kind == Kind::Mod { + let java = |v: &&Version| { + v.loaders + .iter() + .any(|l| java::LOADERS.contains(&l.as_str())) + }; + let made_for = |v: &&Version| v.game_versions.iter().any(|g| g == GAME); + let ported = |v: &&Version| v.game_versions.iter().any(|g| portable_version(g)); + return usable + .clone() + .filter(java) + .find(made_for) + .or_else(|| usable.filter(java).find(|v| everything && ported(v))); + } let runs = |v: &&Version| match support(kind, &v.game_versions, &v.loaders) { Support::Works => true, // A modpack's version is for its own Minecraft; any shader pack Horizon translates. diff --git a/launcher/src/browser/curseforge.rs b/launcher/src/browser/curseforge.rs index 347cf0d40..04e722bba 100644 --- a/launcher/src/browser/curseforge.rs +++ b/launcher/src/browser/curseforge.rs @@ -24,6 +24,7 @@ fn class(kind: Kind) -> u64 { Kind::ResourcePack => 12, Kind::ShaderPack => 6552, Kind::Modpack => 4471, + Kind::Mod => 6, } } @@ -73,7 +74,7 @@ pub(super) fn search_url(query: &Query) -> String { query.offset, query.limit.clamp(1, 50), ); - if !query.everything && query.kind == Kind::ResourcePack { + if !query.everything && matches!(query.kind, Kind::ResourcePack | Kind::Mod) { url.push_str(&format!("&gameVersion={GAME}")); } if !query.text.is_empty() { diff --git a/launcher/src/browser/installed.rs b/launcher/src/browser/installed.rs index d1aac1af5..1ed9b3cf8 100644 --- a/launcher/src/browser/installed.rs +++ b/launcher/src/browser/installed.rs @@ -1,7 +1,8 @@ //! What the browser installed into the game folder, and installing, updating and removing it. //! //! `mod-browser.json` beside `options.txt` lists each file the browser put in `resourcepacks/` -//! or `shaderpacks/`: where it came from, its version and its checksum. Files the player put +//! or `shaderpacks/`, and each Java mod it ported into `horizon-mods/`: where it came from, its +//! version and its checksum. Files the player put //! there themselves are never touched: the browser only replaces or removes what it lists. use super::{pick, safe_name, Kind, Project, Source, SourceId, Support, Version}; use serde::{Deserialize, Serialize}; @@ -29,6 +30,15 @@ pub struct Entry { /// Installed because another pack needs it. #[serde(default)] pub dependency: bool, + /// A Java mod's verdict when it was installed: `Works` or `Partly`. + #[serde(default, skip_serializing_if = "Option::is_none")] + pub verdict: Option<String>, + /// What of a Java mod didn't port. + #[serde(default, skip_serializing_if = "Vec::is_empty")] + pub skipped: Vec<String>, + /// A Java mod's namespaces: two installed mods never share one. + #[serde(default, skip_serializing_if = "Vec::is_empty")] + pub namespaces: Vec<String>, } #[derive(Debug, Default, Serialize, Deserialize)] @@ -78,9 +88,15 @@ pub struct Step { /// What installing `project` takes, dependencies first, checked before any byte is downloaded: /// every file runs in Horizon and has a version to install. pub fn plan(source: &dyn Source, project: &Project, everything: bool) -> Result<Vec<Step>, String> { + if project.kind == Kind::Modpack { + return Err(format!( + "{} is a modpack: it is imported, not installed.", + project.title + )); + } if project.kind.folder().is_none() { return Err(format!( - "{} is a modpack: it is imported on the Modpacks page.", + "{} is ported, not installed as a file.", project.title )); } @@ -122,10 +138,7 @@ fn add( ) })?; if needed.kind.folder().is_none() { - return Err(format!( - "{} needs the modpack {}.", - project.title, needed.title - )); + return Err(format!("{} needs {}.", project.title, needed.title)); } add(source, needed, everything, true, depth + 1, steps)?; } @@ -146,6 +159,9 @@ pub fn install( home: &Path, progress: &dyn Fn(&str, f32), ) -> Result<Vec<Entry>, String> { + if project.kind == Kind::Mod { + return super::java::install(source, project, everything, home, progress); + } let steps = plan(source, project, everything)?; let mut installed = Installed::load(home); let mut done = Vec::new(); @@ -199,6 +215,9 @@ pub fn install( page: p.page.clone(), // Asked for by the player once: it stays theirs. dependency: step.dependency && old.as_ref().is_none_or(|o| o.dependency), + verdict: None, + skipped: Vec::new(), + namespaces: Vec::new(), }; debug_assert!(path.ends_with(name)); installed @@ -218,10 +237,14 @@ pub fn remove(home: &Path, name: &str) -> Result<Entry, String> { .lookup(name) .cloned() .ok_or_else(|| format!("{name} wasn't installed by the browser."))?; - match fs::remove_file(home.join(&entry.file)) { - Ok(()) => {} - Err(e) if e.kind() == std::io::ErrorKind::NotFound => {} - Err(e) => return Err(format!("{}: {e}", entry.file)), + if entry.kind == Kind::Mod { + super::java::remove(home, &entry)?; + } else { + match fs::remove_file(home.join(&entry.file)) { + Ok(()) => {} + Err(e) if e.kind() == std::io::ErrorKind::NotFound => {} + Err(e) => return Err(format!("{}: {e}", entry.file)), + } } installed .entries diff --git a/launcher/src/browser/installed/tests.rs b/launcher/src/browser/installed/tests.rs index 33dc525ab..af55ec78d 100644 --- a/launcher/src/browser/installed/tests.rs +++ b/launcher/src/browser/installed/tests.rs @@ -227,7 +227,7 @@ fn nothing_is_installed_when_a_check_fails() { let pack = project("pack", Kind::Modpack); assert!(plan(&fake, &pack, false) .unwrap_err() - .contains("Modpacks page")); + .contains("imported, not installed")); fs::remove_dir_all(&home).unwrap(); } diff --git a/launcher/src/browser/java.rs b/launcher/src/browser/java.rs new file mode 100644 index 000000000..76ce43c95 --- /dev/null +++ b/launcher/src/browser/java.rs @@ -0,0 +1,340 @@ +//! Java mods (Fabric, NeoForge, Forge) from the browser (docs/mod-browser.md). Horizon doesn't +//! run their code; it ports what they carry (blocks, items, recipes, loot, tags, worldgen) with +//! `horizon-port-pack`. Before a mod is offered for install its jar is downloaded (checked as +//! every download is), carried over and its classes read (`horizon_port_pack::check`): the +//! verdict (Works, Partly, Doesn't run) and the lists of what ports and what doesn't come from +//! that, and are kept per file so a jar is checked once. +//! +//! Installing copies the carried-over folder mod into `horizon-mods/<mod id>/` beside +//! `options.txt` and turns it on in `horizon-mods.txt`, where the game's Options > Mods reads it. +use super::{installed::Entry, pick, FileRef, Kind, Project, Source, Support, Version}; +use horizon_port_pack::check::{self, Check, Verdict}; +use std::fs; +use std::path::{Path, PathBuf}; + +/// Where the checks are kept, under the game folder. Its name changes when the check finds +/// more, so older answers are checked again. +const CHECKS: &str = "mod-browser/checks-1"; +/// The game's mod folder and on-list, beside `options.txt` (`horizon_client::mod_list`). +pub const MODS_DIR: &str = "horizon-mods"; +const MODS_LIST: &str = "horizon-mods.txt"; +/// How deep required mods are followed. +const MAX_DEPTH: usize = 3; + +/// The loaders whose jars port-pack reads. +pub const LOADERS: [&str; 4] = ["neoforge", "fabric", "forge", "quilt"]; + +/// How well a checked mod runs. +pub fn support_of(check: &Check) -> Support { + match check.verdict { + Verdict::Works => Support::Works, + Verdict::Partly => Support::Partial(check.summary.clone()), + Verdict::No => Support::No(check.summary.clone()), + } +} + +fn checks(home: &Path) -> PathBuf { + home.join(CHECKS) +} + +/// The folder a file's check is kept in, by its checksum. +fn checked_dir(home: &Path, file: &FileRef) -> Option<PathBuf> { + let (_, hash) = file.checksum()?; + let hash: String = hash + .chars() + .filter(char::is_ascii_hexdigit) + .take(40) + .collect(); + (hash.len() >= 32).then(|| checks(home).join(hash)) +} + +fn read_check(dir: &Path) -> Option<Check> { + serde_json::from_str(&fs::read_to_string(dir.join("check.json")).ok()?).ok() +} + +/// The check of `file` if it was made before. +pub fn cached(home: &Path, file: &FileRef) -> Option<Check> { + read_check(&checked_dir(home, file)?) +} + +/// Checks `file`: the cached answer, else its jar downloaded, carried over and read. The jar +/// itself isn't kept; the carry is, when something of it ports, for the install to copy. +pub fn check_file( + home: &Path, + source: &dyn Source, + file: &FileRef, + progress: &dyn Fn(f32), +) -> Result<Check, String> { + let dir = checked_dir(home, file).ok_or("Its source gives no checksum.")?; + if let Some(c) = read_check(&dir) { + return Ok(c); + } + let jar = source.fetch(file, &checks(home).join(".downloads"), progress)?; + let part = dir.with_extension("part"); + let _ = fs::remove_dir_all(&part); + let result = check::check(&jar, &part); + let _ = fs::remove_file(&jar); + let c = result.inspect_err(|_| { + let _ = fs::remove_dir_all(&part); + })?; + if c.verdict == Verdict::No { + for d in ["carry", "outside"] { + let _ = fs::remove_dir_all(part.join(d)); + } + } + let _ = fs::remove_dir_all(&dir); + fs::rename(&part, &dir).map_err(|e| format!("{}: {e}", dir.display()))?; + Ok(c) +} + +/// The version of `project` to install and its check. +pub fn check_project( + home: &Path, + source: &dyn Source, + project: &Project, + everything: bool, + progress: &dyn Fn(f32), +) -> Result<(Version, Check), String> { + let versions = source.versions(project)?; + let version = pick(Kind::Mod, &versions, everything) + .cloned() + .ok_or_else(|| match versions.iter().find_map(|v| v.blocked.clone()) { + Some(why) => format!("{} can't be downloaded from here: {why}", project.title), + None => format!( + "{} has no Fabric, NeoForge or Forge version Horizon can port.", + project.title + ), + })?; + let file = version.file().expect("pick keeps versions with a file"); + let check = check_file(home, source, file, progress)?; + Ok((version, check)) +} + +/// Turns mod `id` on (or off) in `horizon-mods.txt`, keeping the other lines. +pub fn set_enabled(home: &Path, id: &str, on: bool) -> Result<(), String> { + let path = home.join(MODS_LIST); + let text = fs::read_to_string(&path).unwrap_or_default(); + let key = format!("mod.{id}"); + let mut lines: Vec<String> = text + .lines() + .filter(|l| l.split_once(':').is_none_or(|(k, _)| k.trim() != key)) + .map(str::to_owned) + .collect(); + if on { + lines.push(format!("{key}:true")); + } + let mut out = lines.join("\n"); + if !out.is_empty() { + out.push('\n'); + } + fs::write(&path, out).map_err(|e| format!("{}: {e}", path.display())) +} + +fn copy_dir(from: &Path, to: &Path) -> Result<(), String> { + fs::create_dir_all(to).map_err(|e| format!("{}: {e}", to.display()))?; + for entry in fs::read_dir(from).map_err(|e| format!("{}: {e}", from.display()))? { + let entry = entry.map_err(|e| e.to_string())?; + let (src, dst) = (entry.path(), to.join(entry.file_name())); + if entry.file_type().map_err(|e| e.to_string())?.is_dir() { + copy_dir(&src, &dst)?; + } else { + fs::copy(&src, &dst).map_err(|e| format!("{}: {e}", dst.display()))?; + } + } + Ok(()) +} + +/// Installs the Java mod `project`: checked, carried over into `horizon-mods/<id>/` and turned +/// on, with the mods it requires that port too. A required mod with nothing to port (a library) +/// is listed in what was skipped. Returns the entries installed, the asked-for one last. +pub fn install( + source: &dyn Source, + project: &Project, + everything: bool, + home: &Path, + progress: &dyn Fn(&str, f32), +) -> Result<Vec<Entry>, String> { + let job = Job { + source, + everything, + home, + progress, + }; + let mut done = Vec::new(); + job.add(project, false, 0, &mut done)?; + Ok(done) +} + +/// One install: where from, where to, and how it reports. +struct Job<'a> { + source: &'a dyn Source, + everything: bool, + home: &'a Path, + progress: &'a dyn Fn(&str, f32), +} + +impl Job<'_> { + fn add( + &self, + project: &Project, + dependency: bool, + depth: usize, + done: &mut Vec<Entry>, + ) -> Result<(), String> { + let Job { + source, + everything, + home, + progress, + } = *self; + if done.iter().any(|e| e.project == project.id) { + return Ok(()); + } + let (version, check) = check_project(home, source, project, everything, &|f| { + progress(&format!("Checking {}", project.title), f) + })?; + if check.verdict == Verdict::No { + return Err(format!( + "{} doesn't run in Horizon: {}", + project.title, check.summary + )); + } + let mut skipped = check.skipped.clone(); + for id in &version.required { + let Ok(needed) = source.project(id) else { + continue; + }; + if needed.kind != Kind::Mod || depth >= MAX_DEPTH { + continue; + } + match self.add(&needed, true, depth + 1, done) { + Ok(()) => {} + Err(_) if dependency => {} + Err(why) => skipped.push(format!("needs {}: {why}", needed.title)), + } + } + let file = version.file().expect("pick keeps versions with a file"); + let carry = checked_dir(home, file) + .expect("checked above") + .join("carry"); + let relative = format!("{MODS_DIR}/{}", check.mod_id); + let mut installed = super::installed::Installed::load(home); + let ours = |e: &Entry| e.source == project.source && e.project == project.id; + if let Some(other) = installed.entries.iter().find(|e| { + e.kind == Kind::Mod + && !ours(e) + && (e.file == relative || e.namespaces.iter().any(|n| check.namespaces.contains(n))) + }) { + return Err(format!( + "{} shares its id or namespace with {}, installed already: remove one first.", + project.title, other.title + )); + } + let target = home.join(&relative); + let old = installed.entries.iter().find(|e| ours(e)).cloned(); + if target.exists() && old.as_ref().is_none_or(|o| o.file != relative) { + return Err(format!( + "{relative} is already there and wasn't installed by the browser: move it away first." + )); + } + progress(&format!("Installing {}", project.title), 1.); + let part = home.join(MODS_DIR).join(format!(".{}.part", check.mod_id)); + let _ = fs::remove_dir_all(&part); + copy_dir(&carry, &part).inspect_err(|_| { + let _ = fs::remove_dir_all(&part); + })?; + if let Some(old) = &old { + let _ = fs::remove_dir_all(home.join(&old.file)); + if old.file != relative { + let _ = set_enabled(home, old.file.trim_start_matches("horizon-mods/"), false); + } + } + fs::rename(&part, &target).map_err(|e| format!("{}: {e}", target.display()))?; + set_enabled(home, &check.mod_id, true)?; + let (algo, hash) = file.checksum().expect("checked files have one"); + let entry = Entry { + source: project.source, + project: project.id.clone(), + slug: project.slug.clone(), + title: project.title.clone(), + kind: Kind::Mod, + version: version.id.clone(), + number: version.number.clone(), + file: relative, + checksum: format!("{algo}:{hash}"), + page: project.page.clone(), + dependency: dependency && old.as_ref().is_none_or(|o| o.dependency), + verdict: Some(check.verdict.label().to_owned()), + skipped, + namespaces: check.namespaces.clone(), + }; + installed.entries.retain(|e| !ours(e)); + installed.entries.push(entry.clone()); + installed.save(home)?; + done.push(entry); + Ok(()) + } +} + +/// Removes an installed mod's folder and turns it off. +pub fn remove(home: &Path, entry: &Entry) -> Result<(), String> { + let Some(id) = entry.file.strip_prefix("horizon-mods/") else { + return Err(format!("{} isn't in {MODS_DIR}/.", entry.file)); + }; + match fs::remove_dir_all(home.join(&entry.file)) { + Ok(()) => {} + Err(e) if e.kind() == std::io::ErrorKind::NotFound => {} + Err(e) => return Err(format!("{}: {e}", entry.file)), + } + set_enabled(home, id, false) +} + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn the_on_list_keeps_other_lines() { + let home = std::env::temp_dir().join(format!("horizon-java-mods-{}", std::process::id())); + let _ = fs::remove_dir_all(&home); + fs::create_dir_all(&home).unwrap(); + fs::write( + home.join(MODS_LIST), + "mod.coords_hud:true\nmod.ruby:false\n", + ) + .unwrap(); + set_enabled(&home, "ruby", true).unwrap(); + set_enabled(&home, "gem", true).unwrap(); + assert_eq!( + fs::read_to_string(home.join(MODS_LIST)).unwrap(), + "mod.coords_hud:true\nmod.ruby:true\nmod.gem:true\n" + ); + set_enabled(&home, "ruby", false).unwrap(); + set_enabled(&home, "gem", false).unwrap(); + assert_eq!( + fs::read_to_string(home.join(MODS_LIST)).unwrap(), + "mod.coords_hud:true\n" + ); + fs::remove_dir_all(&home).unwrap(); + } + + #[test] + fn checks_are_kept_by_checksum() { + let home = Path::new("/h"); + let file = |sha512: Option<&str>, sha1: Option<&str>| FileRef { + url: String::new(), + name: "a.jar".into(), + size: 1, + sha512: sha512.map(str::to_owned), + sha1: sha1.map(str::to_owned), + primary: true, + }; + let long = "ab".repeat(64); + assert_eq!( + checked_dir(home, &file(Some(&long), None)).unwrap(), + home.join(CHECKS).join("ab".repeat(20)) + ); + assert!(checked_dir(home, &file(None, Some("../../etc"))).is_none()); + assert!(checked_dir(home, &file(None, None)).is_none()); + } +} diff --git a/launcher/src/browser/modrinth.rs b/launcher/src/browser/modrinth.rs index e7e39628a..77b5475bb 100644 --- a/launcher/src/browser/modrinth.rs +++ b/launcher/src/browser/modrinth.rs @@ -13,6 +13,7 @@ fn project_type(kind: Kind) -> &'static str { Kind::ResourcePack => "resourcepack", Kind::ShaderPack => "shader", Kind::Modpack => "modpack", + Kind::Mod => "mod", } } @@ -32,8 +33,17 @@ pub(super) fn facets(query: &Query) -> String { all.push(vec!["categories:iris".into(), "categories:optifine".into()]) } Kind::Modpack => {} + Kind::Mod => all.push(vec![format!("versions:{GAME}")]), } } + if query.kind == Kind::Mod { + all.push( + super::java::LOADERS + .iter() + .map(|l| format!("categories:{l}")) + .collect(), + ); + } serde_json::to_string(&all).unwrap_or_default() } diff --git a/launcher/src/browser/tests.rs b/launcher/src/browser/tests.rs index ced342d13..9e75c55a1 100644 --- a/launcher/src/browser/tests.rs +++ b/launcher/src/browser/tests.rs @@ -140,6 +140,42 @@ fn modrinth_search_asks_for_what_runs() { modrinth::facets(&Query::new("", Kind::Modpack)), r#"[["project_type:modpack"]]"# ); + assert_eq!( + modrinth::facets(&Query::new("", Kind::Mod)), + r#"[["project_type:mod"],["versions:26.3"],["categories:neoforge","categories:fabric","categories:forge","categories:quilt"]]"# + ); +} + +#[test] +fn java_mods_are_checked_for_1_21_and_later() { + assert_eq!( + support(Kind::Mod, &v(&["1.20.1"]), &v(&["forge"])), + Support::No("Made for 1.20.1: Horizon ports mods made for 1.21 and later.".into()) + ); + assert!(!support(Kind::Mod, &v(&[GAME]), &v(&["rift"])).installable()); + assert!(matches!( + support(Kind::Mod, &v(&["1.21.1"]), &v(&["neoforge"])), + Support::Partial(_) + )); + for (version, ok) in [ + ("1.21", true), + ("1.21.11", true), + ("26.3", true), + ("1.20.6", false), + ("26.1-snapshot-2", false), + ("", false), + ] { + assert_eq!(portable_version(version), ok, "{version}"); + } + let versions = [ + version("snapshot", &["26.4-snapshot-1"], &["fabric"]), + version("shaders", &[GAME], &["iris"]), + version("now", &[GAME], &["neoforge"]), + version("older", &["1.21.1"], &["neoforge"]), + ]; + assert_eq!(pick(Kind::Mod, &versions, false).unwrap().id, "now"); + assert_eq!(pick(Kind::Mod, &versions[3..], false), None); + assert_eq!(pick(Kind::Mod, &versions[3..], true).unwrap().id, "older"); } #[test] @@ -157,9 +193,16 @@ fn modrinth_answers() { assert_eq!(p.page, "https://modrinth.com/resourcepack/fresh-animations"); assert_eq!(p.support(), Support::Works); assert_eq!(p.downloads, 51404735); - // A Java mod is never a result. - let jar = json!({"project_id": "AANobbMI", "project_type": "mod", "slug": "sodium"}); - assert!(modrinth::parse_hit(&jar).is_none()); + // A Java mod is a result, checked before it is offered. + let jar = json!({"project_id": "AANobbMI", "project_type": "mod", "slug": "sodium", + "versions": ["26.3"], "categories": ["fabric", "optimization"]}); + let sodium = modrinth::parse_hit(&jar).unwrap(); + assert_eq!(sodium.kind, Kind::Mod); + assert_eq!(sodium.page, "https://modrinth.com/mod/sodium"); + assert!(matches!(sodium.support(), Support::Partial(_))); + // Data packs and plugins are not. + let plugin = json!({"project_id": "x", "project_type": "plugin", "slug": "p"}); + assert!(modrinth::parse_hit(&plugin).is_none()); let project = json!({ "id": "HVnmMxH1", "project_type": "shader", "slug": "complementary-reimagined", @@ -243,7 +286,11 @@ fn curseforge_answers() { assert_eq!(p.loaders, ["iris", "optifine"]); assert_eq!(p.author, "CaptTatsu"); assert!(p.support().installable()); - assert!(curseforge::parse_mod(&json!({"id": 1, "classId": 6})).is_none()); + assert_eq!( + curseforge::parse_mod(&json!({"id": 1, "classId": 6})).map(|p| p.kind), + Some(Kind::Mod) + ); + assert!(curseforge::parse_mod(&json!({"id": 1, "classId": 17})).is_none()); let file = json!({ "id": 5000, "displayName": "BSL v10", "fileName": "BSL_v10.zip", "fileLength": 300, diff --git a/launcher/src/cli.rs b/launcher/src/cli.rs index e498fed2b..530d220dd 100644 --- a/launcher/src/cli.rs +++ b/launcher/src/cli.rs @@ -170,8 +170,18 @@ enum ModsCmd { #[arg(long, value_enum, default_value_t = SourceArg::Modrinth)] source: SourceArg, }, - /// Install a pack and what it needs, by its id or slug (checksums checked); a modpack is - /// imported on the Modpacks page + /// Say how well a Java mod runs in Horizon: its jar is downloaded (checksum checked), + /// carried over and read; the answer is kept + Check { + project: String, + /// Allow a version made for another Minecraft version (1.21 and later) + #[arg(long)] + everything: bool, + #[arg(long, value_enum, default_value_t = SourceArg::Modrinth)] + source: SourceArg, + }, + /// Install a pack and what it needs, by its id or slug (checksums checked); a Java mod is + /// ported into horizon-mods and turned on; a modpack is imported Install { project: String, /// Allow a version made for another Minecraft version @@ -193,6 +203,7 @@ enum ModsCmd { #[derive(Clone, Copy, clap::ValueEnum)] enum KindArg { + Mod, Resource, Shader, Modpack, @@ -950,6 +961,7 @@ fn mods(action: ModsCmd, as_json: bool) -> Result<(), String> { KindArg::Resource => Kind::ResourcePack, KindArg::Shader => Kind::ShaderPack, KindArg::Modpack => Kind::Modpack, + KindArg::Mod => Kind::Mod, }; let query = Query { everything, @@ -968,20 +980,67 @@ fn mods(action: ModsCmd, as_json: bool) -> Result<(), String> { } else { for p in &found { let support = p.support(); + let unchecked = p.kind == Kind::Mod && support.installable(); println!( "{} ({}) {} · {} downloads\n {}", p.title, p.slug, - support.label(), + if unchecked { + "Not checked" + } else { + support.label() + }, p.downloads, p.summary ); - if let Some(why) = support.reason() { + if unchecked { + println!(" horizon-launcher mods check {}", p.slug); + } else if let Some(why) = support.reason() { println!(" {why}"); } } } } + ModsCmd::Check { + project, + everything, + source, + } => { + let source = source.get()?; + let p = source.project(&project)?; + if p.kind != Kind::Mod { + return Err(format!("{} isn't a Java mod.", p.title)); + } + let (version, c) = horizon_launcher::browser::java::check_project( + &home, + &*source, + &p, + everything, + &progress(p.title.clone()), + )?; + if as_json { + let mut v = serde_json::to_value(&c).unwrap_or_default(); + v["version"] = version.number.clone().into(); + v["label"] = c.verdict.label().into(); + println!("{v}"); + return Ok(()); + } + println!( + "{} {} ({} {}): {}. {}", + p.title, + version.number, + c.loader, + c.mod_id, + c.verdict.label(), + c.summary + ); + for line in &c.ports { + println!(" ports: {line}"); + } + for line in &c.skipped { + println!(" doesn't: {line}"); + } + } ModsCmd::Install { project, everything, @@ -1009,6 +1068,9 @@ fn mods(action: ModsCmd, as_json: bool) -> Result<(), String> { } for e in done.iter().filter(|_| !as_json) { println!("{} {}: {} ({})", e.title, e.number, e.file, e.checksum); + for s in &e.skipped { + println!(" not ported: {s}"); + } } } ModsCmd::Update { project, check } => { diff --git a/launcher/src/main.rs b/launcher/src/main.rs index c1184fe10..bb1e8dceb 100644 --- a/launcher/src/main.rs +++ b/launcher/src/main.rs @@ -37,18 +37,16 @@ enum Page { Play, Versions, Mods, - Modpacks, Servers, Notes, Settings, } impl Page { - const ALL: [(Page, &'static str); 7] = [ + const ALL: [(Page, &'static str); 6] = [ (Page::Play, "Play"), (Page::Versions, "Versions"), (Page::Mods, "Mods"), - (Page::Modpacks, "Modpacks"), (Page::Servers, "Servers"), (Page::Notes, "Patch notes"), (Page::Settings, "Settings"), @@ -2788,7 +2786,6 @@ impl Render for Launcher { Page::Play => self.play_page(cx), Page::Versions => self.versions_page(cx), Page::Mods => self.mods_page(cx), - Page::Modpacks => self.modpacks_page(cx), Page::Servers => self.servers_page(cx), Page::Notes => self.notes_page(cx), Page::Settings => self.settings_page(cx), diff --git a/launcher/src/modpacks_page.rs b/launcher/src/modpacks_page.rs index 2398421c6..b776321b3 100644 --- a/launcher/src/modpacks_page.rs +++ b/launcher/src/modpacks_page.rs @@ -1,5 +1,5 @@ -//! The Modpacks page: import a pack, read its coverage report, port what this computer can and -//! play it as its own profile (`horizon_launcher::modpacks`). +//! Imported modpacks, on the Mods page's Modpacks tab: import a pack, read its coverage report, +//! port what this computer can and play it as its own profile (`horizon_launcher::modpacks`). use super::*; use horizon_launcher::modpacks::{self, Imported}; use horizon_port_pack::report::Status; @@ -124,7 +124,8 @@ impl Launcher { self.start_client(tag); } - pub(super) fn modpacks_page(&mut self, cx: &mut Context<Self>) -> Div { + /// The imported packs, above the Modpacks tab's search. + pub(super) fn imported_packs(&mut self, cx: &mut Context<Self>) -> Div { let t = self.theme; if self.packs_loaded.is_none() { self.packs = modpacks::list(); @@ -133,12 +134,6 @@ impl Launcher { } self.packs_loaded = Some(Instant::now()); } - let header = page_header( - "Modpacks", - "Bring a Java modpack: see what Horizon runs of it, port that on this computer from \ - your own downloads, and play it as its own profile. Nothing is uploaded or shared.", - &t, - ); let busy = self.pack_busy; let pick = |id: &'static str, label: &'static str, folder: bool| { let b = button(id, label, Kind::Secondary, &t); @@ -159,14 +154,11 @@ impl Launcher { .child(pick("import-file", "Import a pack file…", false)) .child(pick("import-folder", "Import an instance folder…", true)) .child(text(theme::CAPTION).text_color(t.muted).child( - ".mrpack (Modrinth), .zip (CurseForge), or a Prism, MultiMC or CurseForge instance", + ".mrpack (Modrinth), .zip (CurseForge), or a Prism, MultiMC or CurseForge instance. \ + Horizon ports what it can on this computer, from your own downloads, and plays \ + the pack as its own profile. Nothing is uploaded or shared.", )); - let mut page = div() - .flex() - .flex_col() - .gap(px(32.)) - .child(header) - .child(actions); + let mut page = div().flex().flex_col().gap(px(32.)).child(actions); if busy || !self.pack_log.is_empty() { page = page.child(self.pack_log_plate(&t)); } @@ -174,10 +166,11 @@ impl Launcher { page = page.child(notice(e.clone(), &t)); } if self.packs.is_empty() { - return page.child(centered( - "No modpack yet. Import one to see what Horizon can run of it.", - &t, - )); + return page.child( + text(theme::CAPTION) + .text_color(t.muted) + .child("No modpack imported yet: import one, or find one below."), + ); } if self.packs.len() > 1 { let mut list = div().flex().flex_col().border_t_1().border_color(t.rule); diff --git a/launcher/src/mods_page.rs b/launcher/src/mods_page.rs index 25a825c93..136ca7953 100644 --- a/launcher/src/mods_page.rs +++ b/launcher/src/mods_page.rs @@ -1,19 +1,25 @@ -//! The Mods page: search Modrinth (and CurseForge with a key) for resource packs, shader packs -//! and modpacks Horizon loads, see where each comes from and how well it runs, install it with -//! its checksum checked, and update or remove what was installed (`horizon_launcher::browser`). +//! The Mods page: search Modrinth (and CurseForge with a key) for Java mods, modpacks, resource +//! packs and shader packs, see where each comes from and how well it runs (a Java mod's jar is +//! checked first), install it with its checksum checked, and update or remove what was installed +//! (`horizon_launcher::browser`). Imported modpacks are listed on its Modpacks tab. use super::servers_page::{type_key, Key}; use super::*; use horizon_launcher::browser::{ - self, curseforge::CurseForge, installed, Kind as PackKind, Project, Query, SourceId, Support, + self, curseforge::CurseForge, installed, java, Kind as PackKind, Project, Query, SourceId, + Support, }; use horizon_launcher::modpacks; +use horizon_port_pack::check::Check; use std::collections::HashMap; -const KINDS: [(PackKind, &str); 3] = [ +const KINDS: [(PackKind, &str); 4] = [ + (PackKind::Mod, "Mods"), + (PackKind::Modpack, "Modpacks"), (PackKind::ResourcePack, "Resource packs"), (PackKind::ShaderPack, "Shader packs"), - (PackKind::Modpack, "Modpacks"), ]; +/// Java mods checked at once. +const CHECKING: usize = 2; const SOURCES: [(SourceId, &str); 2] = [ (SourceId::Modrinth, "Modrinth"), (SourceId::CurseForge, "CurseForge"), @@ -26,6 +32,15 @@ pub(super) enum Event { Progress(String, f32), Done(Result<String, String>, bool), Updates(HashMap<(SourceId, String), String>), + /// A Java mod's check: its jar read, or why it couldn't be. + Checked((SourceId, String), Result<Box<Check>, String>), +} + +/// Where a Java mod's check is. +pub(super) enum Checking { + Running, + Done(Box<Check>), + Failed(String), } pub(super) struct Mods { @@ -50,6 +65,8 @@ pub(super) struct Mods { message: Option<Result<String, String>>, updates: HashMap<(SourceId, String), String>, confirm_remove: Option<String>, + /// Java mods' checks, by source and project. + checks: HashMap<(SourceId, String), Checking>, tx: Sender<Event>, rx: Receiver<Event>, } @@ -58,7 +75,7 @@ impl Mods { pub(super) fn new(cx: &mut App) -> Self { let (tx, rx) = channel(); Self { - kind: PackKind::ResourcePack, + kind: PackKind::Mod, source: SourceId::Modrinth, curseforge: CurseForge::from_env().is_some(), text: String::new(), @@ -77,6 +94,7 @@ impl Mods { message: None, updates: HashMap::new(), confirm_remove: None, + checks: HashMap::new(), tx, rx, } @@ -91,6 +109,19 @@ impl Mods { .iter() .find(|e| e.source == p.source && e.project == p.id) } + + /// How well a result runs: a Java mod's from its check once it has one. + fn support(&self, p: &Project) -> Support { + let metadata = p.support(); + if p.kind != PackKind::Mod || !metadata.installable() { + return metadata; + } + match self.checks.get(&(p.source, p.id.clone())) { + Some(Checking::Done(c)) => java::support_of(c), + Some(Checking::Failed(e)) => Support::Partial(format!("Not checked: {e}")), + _ => Support::Partial("Checking its jar…".into()), + } + } } /// `51404735` → `51.4M`. @@ -115,6 +146,7 @@ impl Launcher { /// Called with the launcher's other work: what the background sent. pub(super) fn mods_tick(&mut self) -> bool { let mut changed = false; + let mut to_check = Vec::new(); while let Ok(event) = self.mods.rx.try_recv() { changed = true; let m = &mut self.mods; @@ -126,8 +158,9 @@ impl Launcher { Ok(found) => { m.more = found.len() == PAGE; m.results.truncate(offset); - m.results.extend(found); + m.results.extend(found.iter().cloned()); m.error = None; + to_check.extend(found); } Err(e) => m.error = Some(e), } @@ -149,8 +182,16 @@ impl Launcher { } } Event::Updates(found) => m.updates = found, + Event::Checked(key, result) => { + let state = match result { + Ok(c) => Checking::Done(c), + Err(e) => Checking::Failed(e), + }; + m.checks.insert(key, state); + } } } + self.mods_check(to_check); changed } @@ -177,6 +218,43 @@ impl Launcher { }); } + /// Checks the Java mods among `found` that aren't checked yet, a few at a time, on threads: + /// a cached check answers at once, else the jar is downloaded and read. + fn mods_check(&mut self, found: Vec<Project>) { + let m = &mut self.mods; + let todo: Vec<Project> = found + .into_iter() + .filter(|p| p.kind == PackKind::Mod && p.support().installable()) + .filter(|p| !m.checks.contains_key(&(p.source, p.id.clone()))) + .collect(); + if todo.is_empty() { + return; + } + for p in &todo { + m.checks.insert((p.source, p.id.clone()), Checking::Running); + } + let (tx, everything) = (m.tx.clone(), m.everything); + let queue = std::sync::Mutex::new(todo.into_iter()); + std::thread::spawn(move || { + let home = backend::game_home(); + std::thread::scope(|s| { + for _ in 0..CHECKING { + s.spawn(|| { + while let Some(p) = queue.lock().ok().and_then(|mut q| q.next()) { + let result = browser::source(p.source) + .ok_or_else(|| format!("{} isn't set up.", p.source.label())) + .and_then(|source| { + java::check_project(&home, &*source, &p, everything, &|_| {}) + }) + .map(|(_, c)| Box::new(c)); + let _ = tx.send(Event::Checked((p.source, p.id), result)); + } + }); + } + }); + }); + } + /// Looks for newer versions of what the browser installed. fn mods_check_updates(&mut self) { let entries = self.mods.installed.clone(); @@ -233,7 +311,7 @@ impl Launcher { let log = |line: String| progress(&line, 1.); let pack = modpacks::import(&file, &log)?; return Ok(format!( - "{} is imported: open it on the Modpacks page to port it.", + "{} is imported: it is listed above, ready to port.", pack.title() )); } @@ -243,6 +321,19 @@ impl Launcher { .iter() .map(|e| format!("{} {}", e.title, e.number)) .collect(); + if p.kind == PackKind::Mod { + let skipped = done.last().map_or(0, |e| e.skipped.len()); + return Ok(format!( + "Ported {} into horizon-mods and turned on (Options > Mods in the \ + game).{}", + names.join(", "), + if skipped > 0 { + " What didn't port is listed under Installed." + } else { + "" + } + )); + } let turn_on = match p.kind { PackKind::ShaderPack => "Video Settings > Shader Packs", _ => "Options > Resource Packs", @@ -330,8 +421,10 @@ impl Launcher { } let header = page_header( "Mods", - "Resource packs, shader packs and modpacks that Horizon loads. Each file is checked \ - against its source's checksum before it reaches your game folder.", + "Java mods, modpacks, resource packs and shader packs. Horizon ports what a Java mod \ + carries (blocks, items, recipes, worldgen) and says before you install what runs. \ + Each file is checked against its source's checksum before it reaches your game \ + folder.", &t, ); let this = cx.entity().downgrade(); @@ -436,6 +529,9 @@ impl Launcher { Some(Err(e)) => page = page.child(notice(e.clone(), &t)), None => {} } + if self.mods.kind == PackKind::Modpack { + page = page.child(self.imported_packs(cx)); + } if let Some(list) = self.mods_installed_list(cx) { page = page.child(list); } @@ -512,7 +608,11 @@ impl Launcher { .flex() .flex_col() .child(format!( - "{} · from {}{} · {}", + "{}{} · from {}{} · {}", + e.verdict + .as_ref() + .map(|v| format!("{v} · ")) + .unwrap_or_default(), e.number, e.source.label(), if e.dependency { @@ -522,6 +622,11 @@ impl Launcher { }, e.file )) + .children(e.skipped.iter().map(|s| { + div() + .text_color(t.ink_soft) + .child(format!("Not ported: {s}")) + })) .child( div() .font_family(theme::MONO) @@ -564,7 +669,13 @@ impl Launcher { let busy = m.busy.as_ref().map(|b| b.0.as_str()); let mut list = div().flex().flex_col().border_t_1().border_color(t.rule); for (i, p) in m.results.iter().enumerate() { - let support = p.support(); + let support = m.support(p); + let checking = p.kind == PackKind::Mod + && matches!( + m.checks.get(&(p.source, p.id.clone())), + None | Some(Checking::Running) + ) + && p.support().installable(); let color = match support { Support::Works => t.success, Support::Partial(_) => t.accent, @@ -591,6 +702,8 @@ impl Launcher { right = right.child(caps("Installing").text_color(t.accent)); } else if m.entry(p).is_some() { right = right.child(caps("Installed").text_color(t.muted)); + } else if checking { + right = right.child(caps("Checking").text_color(t.muted)); } else if support.installable() { let label = if p.kind == PackKind::Modpack { "Import" diff --git a/website/docs/modpacks.md b/website/docs/modpacks.md index a4396392b..b78c59851 100644 --- a/website/docs/modpacks.md +++ b/website/docs/modpacks.md @@ -6,7 +6,7 @@ Java mod jars do not run in Horizon. Instead, the launcher reads a modpack, tell ## What the Modpacks page does -Open **Modpacks** in the launcher. +Open **Modpacks** in the launcher. (From the next launcher release, it is the **Modpacks** tab of the **Mods** page.) 1. **Import a pack.** Choose **Import a pack file…** for a Modrinth `.mrpack` or a CurseForge zip, or **Import an instance folder…** for a Prism, MultiMC or CurseForge instance. The **Mods** page can also find a Modrinth modpack and import it for you (see [Mods and data packs](/docs/mods#finding-resource-packs-shader-packs-and-modpacks)). 2. **Read the coverage report.** For every mod in the pack it says **Ported**, **Partial**, **Not yet** or **Not needed**, with the reason. You can filter the list by status. diff --git a/website/docs/mods.md b/website/docs/mods.md index 05dcaee2d..d3305fa69 100644 --- a/website/docs/mods.md +++ b/website/docs/mods.md @@ -36,7 +36,17 @@ cargo horizon-mod run The launcher's **Mods** page (launcher 0.17 and newer) searches [Modrinth](https://modrinth.com) for what Horizon can load: resource packs, Java shader packs and modpacks. Each result says how well it runs in Horizon (**Works**, **Partly**, or **Doesn't run**), and by default the page shows only what runs. **Install** downloads the file, checks it against the checksum Modrinth lists and refuses anything that does not match, then puts it in the right folder, with the packs it needs. **Update** and **Remove** are there too. A resource pack still has to be turned on in the game's Resource Packs screen, and a shader pack in Video, Shader Packs. A modpack is imported on the [Modpacks page](/docs/modpacks). -The page cannot search CurseForge yet. Java mod jars are never offered, because they do not run. The same things work from a terminal: `horizon-launcher mods search`, `install`, `update` and `remove`. +The page cannot search CurseForge yet. The same things work from a terminal: `horizon-launcher mods search`, `install`, `update` and `remove`. + +## Java mods from the Mods page (next launcher release) + +Java code does not run in Horizon, but much of what a mod adds is data: blocks, items, recipes, loot tables, tags, worldgen, textures. From the next launcher release, the Mods page also lists Fabric, NeoForge and Forge mods made for 26.3 and, before offering one, downloads its jar, checks it against Modrinth's checksum and reads it (without running it) to say what of it Horizon runs: + +- **Works**: the mod is only content, and all of it carries over. +- **Partly**: its content carries over; the row lists what does not, such as machines and containers, mobs, blocks or items with behaviour of their own, recipe types of its own, or Mixins. +- **Doesn't run**: there is nothing to carry over (performance mods, libraries, mods that are all code). It is not offered. + +**Install** brings the mod over into `horizon-mods` and turns it on; start the game again to load it. Blocks take the closest vanilla block's shape, hardness and sounds, so a carried-over block can break faster or slower than in Java. Most popular mods today are **Partly** or **Doesn't run**: the verdict is the honest answer for each one. ## Data packs From 240e76160bfcb0bcb1f2bfc537f6317aed14d7f0 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 17:56:19 +0200 Subject: [PATCH 029/126] Mod content: give mod items and blocks network ids, so they don't travel as air The game and its integrated server map items and blocks to network ids through the registries report (registries.json), which the content root left vanilla: a mod's item in a slot, given or picked up, reached the client as air. The content root now rewrites registries.json too, appending the new items and blocks after vanilla's ids in plan order. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/mod_content.rs | 34 ++++++++++++++++++- .../horizon-client/src/mod_content_tests.rs | 29 ++++++++++++++++ 2 files changed, 62 insertions(+), 1 deletion(-) diff --git a/crates/horizon-client/src/mod_content.rs b/crates/horizon-client/src/mod_content.rs index 0497f06b4..b3a836b3a 100644 --- a/crates/horizon-client/src/mod_content.rs +++ b/crates/horizon-client/src/mod_content.rs @@ -538,6 +538,37 @@ impl<'a> Plan<'a> { } } "items.json" => self.items(doc, true), + "registries.json" => { + // Network ids: the game and its server map items and blocks through + // this report, so new ones get the ids after vanilla's, in plan order. + let new_items = self.items.iter().map(|i| i.rename.to.clone()); + let new_blocks = self.blocks.iter().map(|b| b.decl.id.clone()); + for (registry, names) in [ + ("minecraft:item", new_items.collect::<Vec<_>>()), + ("minecraft:block", new_blocks.collect()), + ] { + let Some(J::Obj(entries)) = + doc.get_mut(registry).and_then(|r| r.get_mut("entries")) + else { + return Err(format!("no {registry} entries").into()); + }; + let next = entries + .iter() + .filter_map(|(_, e)| match e { + J::Obj(o) => o.iter().find(|(k, _)| k == "protocol_id")?.1.as_u32(), + _ => None, + }) + .max() + .map_or(0, |m| m + 1); + for (i, name) in names.into_iter().enumerate() { + if entries.iter().any(|(k, _)| *k == name) { + continue; + } + let id = J::Num((next + i as u32).into()); + entries.push((name, J::Obj(vec![("protocol_id".into(), id)]))); + } + } + } "command-registries.json" => { self.names(doc.at("blocks").ok_or("no blocks")?, false); let new_items = || self.items.iter().map(|i| J::Str(i.rename.to.clone())); @@ -618,8 +649,9 @@ impl<'a> Plan<'a> { } /// The JSON and NBT tables rewritten for new blocks and items. -const JSON_TABLES: [&str; 13] = [ +const JSON_TABLES: [&str; 14] = [ "facts.json", + "registries.json", "gameplay-facts.json", "block-behaviours.json", "model-states.json", diff --git a/crates/horizon-client/src/mod_content_tests.rs b/crates/horizon-client/src/mod_content_tests.rs index 1c0907bde..3d38fae4d 100644 --- a/crates/horizon-client/src/mod_content_tests.rs +++ b/crates/horizon-client/src/mod_content_tests.rs @@ -148,6 +148,35 @@ fn content_root_loads_with_every_table() { new.default_state("ruby:ruby_glass"), Some(BlockStateId(n + 65)) ); + // Network ids: the new items and blocks follow vanilla's in the registries report, which + // the game and its server both read (a missing one travels as air). + let report = |root: &Path| { + horizon_protocol::registry::Builtin::load(&root.join("registries.json")).unwrap() + }; + let (vanilla_ids, ids) = (report(&base), report(&root)); + let item = |b: &horizon_protocol::registry::Builtin, name: &str| { + b.get("minecraft:item").and_then(|r| r.id(name)) + }; + let vanilla_items = (0..) + .take_while(|&i| vanilla_ids.get("minecraft:item").unwrap().name(i).is_some()) + .count() as i32; + assert_eq!( + item(&ids, "minecraft:stone"), + item(&vanilla_ids, "minecraft:stone") + ); + let ruby_item = item(&ids, "ruby:ruby_block").unwrap(); + assert!(ruby_item >= vanilla_items, "{ruby_item} < {vanilla_items}"); + assert_eq!( + ids.get("minecraft:item").unwrap().name(ruby_item), + Some("ruby:ruby_block") + ); + assert!(item(&ids, "ruby:ruby_glass").is_none(), "no item declared"); + assert!( + ids.get("minecraft:block") + .unwrap() + .id("ruby:ruby_glass") + .is_some() + ); let old_facts = BlockFacts::load(&base, old).unwrap(); let facts = BlockFacts::load(&root, new).unwrap(); From a3f81f3a30ec54d2cb84e806334db2db8a14684b Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 18:10:20 +0200 Subject: [PATCH 030/126] Launcher: test a Java mod's install, dependencies, id clash and removal offline Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- launcher/src/browser/installed/tests.rs | 82 +++++++++++++++++++++++++ 1 file changed, 82 insertions(+) diff --git a/launcher/src/browser/installed/tests.rs b/launcher/src/browser/installed/tests.rs index af55ec78d..e3fe7899c 100644 --- a/launcher/src/browser/installed/tests.rs +++ b/launcher/src/browser/installed/tests.rs @@ -250,3 +250,85 @@ fn shader_packs_go_to_their_folder_and_modpacks_download_checked() { assert!(!downloads.join("atm-2.zip").exists()); fs::remove_dir_all(&home).unwrap(); } + +/// A NeoForge jar with `files` beside its `neoforge.mods.toml` for mod `id`. +fn mod_jar(id: &str, files: &[(&str, &str)]) -> Vec<u8> { + use std::io::Write; + let mut zip = zip::ZipWriter::new(std::io::Cursor::new(Vec::new())); + let toml = format!( + "modLoader = \"javafml\"\nlicense = \"MIT\"\n[[mods]]\nmodId = \"{id}\"\nversion = \"1.0\"\ndisplayName = \"{id}\"\n" + ); + for (name, text) in [("META-INF/neoforge.mods.toml", toml.as_str())] + .into_iter() + .chain(files.iter().copied()) + { + zip.start_file(name, zip::write::SimpleFileOptions::default()) + .unwrap(); + zip.write_all(text.as_bytes()).unwrap(); + } + zip.finish().unwrap().into_inner() +} + +#[test] +fn java_mods_are_ported_turned_on_refused_on_clashes_and_removed() { + let home = home("java"); + let mut fake = Fake::default(); + for id in ["ruby", "lib", "gem"] { + let mut p = project(id, Kind::Mod); + p.loaders = vec!["neoforge".into()]; + fake.add(p); + } + let block = r#"{"variants": {"": {"model": "ruby:block/ruby_block"}}}"#; + let recipe = r#"{"type": "minecraft:crafting_shapeless", "ingredients": ["minecraft:red_dye"], "result": {"id": "ruby:ruby_block"}}"#; + let ruby = mod_jar( + "ruby", + &[ + ("assets/ruby/blockstates/ruby_block.json", block), + ("data/ruby/recipe/ruby_block.json", recipe), + ], + ); + // A library: nothing to port. + let lib = mod_jar("lib", &[]); + // Another project with the same mod id. + let gem = mod_jar("ruby", &[("assets/ruby/blockstates/gem.json", block)]); + fake.release("ruby", "1", &["lib"], &ruby, false); + fake.release("lib", "1", &[], &lib, false); + fake.release("gem", "1", &[], &gem, false); + + let done = install(&fake, &fake.project("ruby").unwrap(), false, &home, NONE).unwrap(); + assert_eq!(done.len(), 1, "the library isn't installed"); + let entry = &done[0]; + assert_eq!(entry.file, "horizon-mods/ruby"); + assert_eq!(entry.verdict.as_deref(), Some("Works")); + assert!( + entry + .skipped + .iter() + .any(|s| s.starts_with("needs Pack lib")), + "{:?}", + entry.skipped + ); + assert!(entry.namespaces.contains(&"ruby".to_owned())); + assert!(home.join("horizon-mods/ruby/horizon-mod.toml").is_file()); + assert_eq!( + fs::read_to_string(home.join("horizon-mods.txt")).unwrap(), + "mod.ruby:true\n" + ); + // The jar isn't kept, its check is. + assert!(!home + .join("mod-browser/checks-1/.downloads/ruby-1.zip") + .exists()); + + let clash = install(&fake, &fake.project("gem").unwrap(), false, &home, NONE).unwrap_err(); + assert!(clash.contains("shares its id or namespace"), "{clash}"); + assert!(!home.join("horizon-mods/gem").exists()); + + let removed = remove(&home, "ruby").unwrap(); + assert_eq!(removed.kind, Kind::Mod); + assert!(!home.join("horizon-mods/ruby").exists()); + assert_eq!( + fs::read_to_string(home.join("horizon-mods.txt")).unwrap(), + "" + ); + fs::remove_dir_all(&home).unwrap(); +} From ca2d5e04dc35394c859146a64d35f47e1e2c1059 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Thu, 22 Oct 2026 17:15:46 +0100 Subject: [PATCH 031/126] Remove benchmark report from pull request --- docs/saved-light-loading-benchmark.md | 44 --------------------------- 1 file changed, 44 deletions(-) delete mode 100644 docs/saved-light-loading-benchmark.md diff --git a/docs/saved-light-loading-benchmark.md b/docs/saved-light-loading-benchmark.md deleted file mode 100644 index f11d72443..000000000 --- a/docs/saved-light-loading-benchmark.md +++ /dev/null @@ -1,44 +0,0 @@ -# Saved-light loading benchmark - -Saved-light reconstruction reduces complete saved-chunk loading by a median **6.179% on the normal world** and **10.981% on the flat world**, incremental to the accepted palette-loading optimization. Every measured process pair improves. The implementation changes only `save.rs::load_light` and its tests. - -## Implementation and scope - -Detect uniform stored nibble layers before allocating expanded resident light. Both nibbles must match: repeated bytes such as `0xF0` and `0x0F` remain nonuniform. Decode two resident light values per stored byte for remaining layers. Preserve section compaction, low-nibble-first indexing, missing-block darkness, missing-sky bottom-row inheritance, skyless behavior, section bounds, last duplicate section, invalid array handling, and loaded flags. Pinned Minecraft 26.3 `DataLayer` and `SkyLightSectionStorage.repeatFirstLayer` bytecode was inspected first. No saved-light optimization overlap was found among the 34 open PRs checked on 2026-10-22. - -## Measurements - -Baseline `411c5574` includes accepted palette loading and aquifer changes; the candidate differs only in saved-light reconstruction. Both loader executables were rebuilt from those sources using identical benchmark source (SHA256 `b6f5042731d7c9d5622758043f7c1e125a3f7d098c57ee0501012474c2df7325`), dependencies, resources and flags. Machine: AMD Ryzen 5 5600X, 6 cores/12 logical CPUs, 32 GiB RAM; Linux 7.2.11-zen1-1-zen; Rust 1.99.0. Release optimization, thin LTO, one codegen unit, client default features disabled; CPU boost enabled, powersave governor, ordinary desktop activity. No builds, tests or profiles overlapped timing. - -Each corpus uses one discarded process pair followed by five measured pairs in alternating baseline/candidate order. Each observation is a process's median of five rounds loading the same sorted 256 full chunks. Checksumming and setup are outside timing; allocation/destruction and region reads/decompression/NBT/native decode/saved light are inside complete loading. Storage is warm. Reductions are medians/ranges of paired reductions; independently reported medians need not give the same ratio. Separate stage loops do not sum to a timing breakdown. - -| Corpus | Complete load, baseline → candidate | Paired reduction (range) | Inflate/NBT, baseline → candidate | Native decode, baseline → candidate | -| --- | ---: | ---: | ---: | ---: | -| Normal vanilla 26.3, seed 12345 | 50.036 → 47.005 ms | 6.179% (5.217–6.836%) | 22.187 → 22.087 ms | 20.464 → 21.621 ms | -| Flat vanilla 26.3 | 12.030 → 10.688 ms | 10.981% (10.423–11.751%) | 4.562 → 4.549 ms | 4.076 → 4.183 ms | - -Values are milliseconds per complete 256-chunk batch. The separate native-decode loop slows by a paired median 4.644% on normal and 3.185% on flat; the flat observations are variable. Its source is unchanged, and the cause of this separate-loop change was not isolated. Complete `SaveDir::load`, which includes native decode and saved light, improves in all ten measured pairs. The earlier two-pair normal pilot improved 5.894% and 6.553%; final-source qualification was repeated after the iterator syntax change. All timed compressed-record and block/biome/light hashes agree. Normal compressed records: `ff9bf9e822e334e117e3d6ba5c26a88b7698456ec6d83bdbe4355ad0af1d6f55`; block/biome/light: `661dd26eed78b051afeca11d8ba69222162b5da72e5d1572a12ce2a3b3a4f764`. - -## Correctness - -All 20 save unit tests pass. The new differential test compares the original loader with the candidate for every repeated packed byte, all 256 pairs of uniform sky/block nibble values, nonuniform inherited rows, missing/wrong layer types and lengths, skyless dimensions, out-of-range/invalid section Y values and duplicate sections. It compares every resident light value, uniform/full representation, block/biome storage and loaded flags. - -A fresh pinned Java 26.3 oracle uses `DataLayer.get` and `SkyLightSectionStorage.repeatFirstLayer` over all 256 repeated byte patterns in both sky modes. Baseline and candidate exactly match all **50,331,648 light values** plus flags (SHA256 `608bab077edc713110f827740cb5d9baf2af9c1a251ea2458441e2d981f25920`). - -The same comprehensive snapshot harness runs on the actual accepted-source baseline and final candidate: **400 normal chunks, 289 flat chunks, and two synthetic unknown-NBT/nonempty-tick cases**. All 691 outputs match byte-for-byte. It covers resident blocks/biomes/light, complete reencoded NBT, heightmaps, block entities and their saved sources/order, structures, unknown NBT, ticks, postprocessing, entities, names and loaded/arrival flags. Light representation is additionally covered by the unit test. Temporary diagnostic sources were removed. - -The final source uses the fixed-size chunk iterator syntax required by Clippy. Its rebuilt executable (SHA256 `40d7031e7d3efe785815b1286af05553807bbc59f66a9275a5f89191f0ecda7e`) is the one used for final qualification; snapshot/oracle harnesses use the same production source. Earlier pilot artifacts are retained separately: section extraction normalized ELF metadata (original timed SHA256 `eb28209fd54b6deedab1ff701c291ae36b8116b2ba52a02d1ec82600b57e427f`; normalized SHA256 `78f2092b2661655fdea8d0fa2247389ccc8f48f37dd9abfbb8d8864867187297`). Those earlier artifacts are superseded by the final-source qualification. - -The required repository quick self-check passes: public-tree validation, formatting, Clippy with warnings denied, **1,443 client/core/world tests**, and the doc-test step. Command: `RUST_TEST_THREADS=1 CARGO_BUILD_JOBS=6 CARGO_TARGET_DIR=/srv/bob-data/horizon-chunk-campaign-check-target python3 tools/pr_ready.py --quick --base origin/main` (11 min 15 s). Tests were serialized after an initial client-test process SIGSEGV; the failed log is retained as `pr-ready-attempt1.txt`. Relevant oracle checks were run separately; `--quick` lists other affected parity harnesses for CI. - -## Reproduction and evidence - -Private/generated evidence: `/srv/bob-data/horizon-chunk-campaign-41055168/saved-light/`. Preserved baseline/candidate sources and executables, source/binary hashes, open-PR catalog, pinned bytecode, build logs, `final-pairs.py`, `final-raw.json`, final qualification logs and `final-summary.json`; earlier pilot/qualification artifacts are retained there. Resources: `/srv/bob-data/horizon/.local/horizon-client/26.3`. Normal corpus: `/srv/bob-data/horizon-chunk-campaign-41055168/vanilla-normal/world/dimensions/minecraft/overworld`; flat: `/srv/bob-data/horizon/.local/locator-bar-parity/generate/world/dimensions/minecraft/overworld`. - -```sh -CARGO_BUILD_JOBS=6 CARGO_TARGET_DIR=/srv/bob-data/horizon-chunk-campaign-target cargo build --locked --release -p horizon-client --no-default-features --example load_bench -load_bench RESOURCES DIMENSION_DIR --rounds 5 --limit 256 --checksum -python3 /srv/bob-data/horizon-chunk-campaign-41055168/saved-light/final-pairs.py final 5 -``` - -These results cover the declared warm saved-load workloads. Cold physical I/O, remote chunk streams and complete gameplay parity are outside this comparison. From d86a1b2882b81d403bde2f02076143ab50814dad Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Thu, 22 Oct 2026 17:26:39 +0100 Subject: [PATCH 032/126] Fix cooldown after instant survival breaks in multiplayer --- crates/horizon-client/src/game/remote.rs | 4 +- tests/test_remote_mining.py | 149 +++++++++++++++++++++++ tools/test_first_person_parity.py | 6 + 3 files changed, 156 insertions(+), 3 deletions(-) create mode 100644 tests/test_remote_mining.py diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 7c96e7bad..ea12eb4d2 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -3309,10 +3309,8 @@ impl Game<'_> { sequence: seq, })); if progress >= 1.0 { + // startDestroyBlock: instant survival breaks have no destroy delay. self.predict_break(hit.pos, state, seq); - if let Some(r) = self.remote.as_mut() { - r.destroy_delay = 5; - } return; } if let Some(r) = self.remote.as_mut() { diff --git a/tests/test_remote_mining.py b/tests/test_remote_mining.py new file mode 100644 index 000000000..236b85c28 --- /dev/null +++ b/tests/test_remote_mining.py @@ -0,0 +1,149 @@ +"""Exercise the live remote_mining method with scripted world and packet sinks. + +Vanilla reference: MultiPlayerGameMode.startDestroyBlock/continueDestroyBlock. +The first_person parity harness separately checks consecutive instant breaks +against the pinned client; this fixture catches drift in the multiplayer path. +""" +from pathlib import Path +import shutil +import subprocess +import tempfile +import unittest + + +ROOT = Path(__file__).resolve().parents[1] + + +@unittest.skipUnless(shutil.which("rustc"), "requires Rust") +class RemoteMiningTests(unittest.TestCase): + def test_break_timing_and_packets(self): + source = (ROOT / "crates/horizon-client/src/game/remote.rs").read_text() + start = source.index(" fn remote_mining(") + end = source.index(" /// MultiPlayerGameMode.destroyBlock", start) + fixture = r''' +#![allow(dead_code)] +#[derive(Clone, Copy)] +struct Hit { pos: [i32; 3], face: u8 } +struct Mining { pos: [i32; 3], progress: f32, ticks: u32 } +#[derive(Default)] +struct Remote { destroy_delay: u32, destroying: Option<([i32; 3], u8, f32)> } +struct Ground { on_ground: bool } +struct Player { ground: Ground } +#[derive(Clone)] +struct Sounds { hit: String, volume: f32, pitch: f32 } +#[derive(Clone)] +struct Facts { hardness: f32, name: String, requires_tool: bool, sounds: Sounds } +struct Resources { facts: Facts, speed: f32 } +impl Resources { + fn facts(&self) -> &Self { self } + fn items(&self) -> &Self { self } + fn get(&self, _: u32) -> &Facts { &self.facts } + fn is_air(&self, state: u32) -> bool { state == 0 } + fn mining_speed(&self, _: Option<&()>, _: &str) -> f32 { self.speed } + fn correct_for_drops(&self, _: Option<&()>, _: &str) -> bool { true } +} +#[derive(Default)] +struct World { broken: Vec<[i32; 3]> } +impl World { + fn block(&self, x: i32, y: i32, z: i32) -> u32 { + u32::from(!self.broken.contains(&[x, y, z])) + } +} +struct Audio; +impl Audio { + fn play(&self, _: &str, _: Option<[f64; 3]>, _: f32, _: f32) {} +} +mod play { + #[derive(Debug, PartialEq)] + pub struct PlayerAction { + pub action: u8, pub pos: [i32; 3], pub direction: u8, pub sequence: i32, + } +} +enum S { PlayerAction(play::PlayerAction) } +fn face_direction(face: u8) -> u8 { face } +struct Game { + remote: Option<Remote>, mining: Option<Mining>, creative: bool, + world: World, res: Resources, player: Option<Player>, audio: Audio, + hit: Hit, sequence: i32, packets: Vec<play::PlayerAction>, +} +impl Game { + fn new(hardness: f32, speed: f32, creative: bool) -> Self { + Self { + remote: Some(Remote::default()), mining: None, creative, + world: World::default(), + res: Resources { facts: Facts { hardness, name: "block".into(), + requires_tool: false, sounds: Sounds { hit: "hit".into(), volume: 1.0, pitch: 1.0 } }, speed }, + player: Some(Player { ground: Ground { on_ground: true } }), audio: Audio, + hit: Hit { pos: [0, 64, 0], face: 1 }, sequence: 0, packets: vec![], + } + } + fn pick(&self) -> Option<Hit> { Some(self.hit) } + fn held(&self) -> Option<&()> { None } + fn next_sequence(&mut self) -> i32 { self.sequence += 1; self.sequence } + fn predict_break(&mut self, pos: [i32; 3], _: u32, _: i32) { self.world.broken.push(pos); } + fn send(&mut self, S::PlayerAction(packet): S) { self.packets.push(packet); } + fn crack_particle(&mut self, _: [i32; 3], _: u8, _: u32) {} +METHOD +} +fn main() { + // Zero-hardness blocks and a tool fast enough to break in one tick. + for (hardness, speed) in [(0.0, 1.0), (0.5, 15.0), (0.5, 30.0)] { + let mut game = Game::new(hardness, speed, false); + for tick in 0..8 { + game.hit.pos[0] = tick; + game.remote_mining(tick == 0); + assert_eq!(game.world.broken.len(), tick as usize + 1, + "instant break must happen every held tick"); + let remote = game.remote.as_ref().unwrap(); + assert_eq!(remote.destroy_delay, 0); + assert!(remote.destroying.is_none()); + assert!(game.mining.is_none()); + assert_eq!(game.packets[tick as usize], play::PlayerAction { + action: 0, pos: [tick, 64, 0], direction: 1, sequence: tick + 1, + }); + } + assert_eq!(game.packets.len(), 8, "instant breaks only send START"); + } + // Gradual breaking still sends STOP and waits five continuation ticks. + let mut game = Game::new(1.0, 15.0, false); + game.remote_mining(true); + assert!(game.world.broken.is_empty()); + game.remote_mining(false); + assert!(game.world.broken.is_empty()); + game.remote_mining(false); + assert_eq!(game.world.broken.len(), 1); + assert_eq!(game.packets.iter().map(|p| p.action).collect::<Vec<_>>(), [0, 3]); + assert_eq!(game.remote.as_ref().unwrap().destroy_delay, 5); + game.hit.pos[0] = 1; + for _ in 0..5 { + game.remote_mining(false); + assert_eq!(game.packets.len(), 2); + } + game.remote_mining(false); + assert_eq!(game.packets.len(), 3); + assert_eq!(game.packets[2].action, 0); + // Creative also keeps its five-tick delay, even for zero-hardness blocks. + let mut game = Game::new(0.0, 1.0, true); + game.remote_mining(true); + game.hit.pos[0] = 1; + assert_eq!(game.remote.as_ref().unwrap().destroy_delay, 5); + for _ in 0..5 { + game.remote_mining(false); + assert_eq!(game.world.broken.len(), 1); + } + game.remote_mining(false); + assert_eq!(game.world.broken.len(), 2); + assert_eq!(game.remote.as_ref().unwrap().destroy_delay, 5); +} +'''.replace("METHOD", source[start:end]) + with tempfile.TemporaryDirectory(prefix="remote-mining-") as directory: + path = Path(directory) + (path / "main.rs").write_text(fixture) + subprocess.run(["rustc", "--edition=2024", str(path / "main.rs"), "-o", str(path / "probe")], + check=True, capture_output=True, text=True) + result = subprocess.run([str(path / "probe")], capture_output=True, text=True) + self.assertEqual(result.returncode, 0, result.stdout + result.stderr) + + +if __name__ == "__main__": + unittest.main() diff --git a/tools/test_first_person_parity.py b/tools/test_first_person_parity.py index d73262595..476d2cc52 100644 --- a/tools/test_first_person_parity.py +++ b/tools/test_first_person_parity.py @@ -69,6 +69,12 @@ def block_hit(pos, face=1): def scenarios(): stone = {TARGETS[0]: 'minecraft:stone', TARGETS[1]: 'minecraft:dirt', TARGETS[2]: 'minecraft:glass'} + # Consecutive instant survival breaks have no destroy delay. Cover both + # zero hardness and a shovel with haste reaching one-tick destroy progress. + for block, main, haste in [('minecraft:short_grass', None, None), + ('minecraft:dirt', ['minecraft:diamond_shovel', 1], 9)]: + steps = [step(block_hit(p), ac=int(i == 0), ad=True) for i, p in enumerate(TARGETS)] + yield case(steps + [step()] * 6, main=main, blocks={p: block for p in TARGETS}, haste=haste) for creative in (False, True): for main in ITEMS: # Hold attack on blocks until they break, then on the air behind. From 6d36d468e70d0aea524e61f32081879ea064fa3b Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Thu, 22 Oct 2026 17:29:55 +0100 Subject: [PATCH 033/126] Fix empty-hand drop animations --- .../examples/held_drop_fixture.rs | 11 +++++- crates/horizon-client/src/game/remote.rs | 23 ++++++----- .../parity/VanillaHeldDropOracle.java | 39 +++++++++++++++++-- tools/test_held_drop_parity.py | 10 +++-- 4 files changed, 65 insertions(+), 18 deletions(-) diff --git a/crates/horizon-client/examples/held_drop_fixture.rs b/crates/horizon-client/examples/held_drop_fixture.rs index 87ca9870c..a0c5d92ba 100644 --- a/crates/horizon-client/examples/held_drop_fixture.rs +++ b/crates/horizon-client/examples/held_drop_fixture.rs @@ -14,13 +14,22 @@ fn main() { for count in [0, 1, 4, 64] { let mut slot = Some(ItemStack::new("minecraft:stone", count)); let mut dropped = 0; + let mut swings = 0; + let mut packets = 0; for _ in 0..2 { if let Some(stack) = take_held_drop(&mut slot, all, mode == GameMode::Spectator) { dropped += stack.count; + swings += 1; } - println!("{} {}", slot.as_ref().map_or(0, |s| s.count), dropped); + if mode != GameMode::Spectator { + packets += 1; + } + println!( + "{} {dropped} {swings} {packets}", + slot.as_ref().map_or(0, |s| s.count), + ); } } } diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 7c96e7bad..6614c68a3 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -7,7 +7,7 @@ //! client predicts its own movement; the server stays authoritative for //! everything else. use super::{Dim, Game, Mining, Screen}; -use horizon_client::first_person::Hand; +use horizon_client::first_person::{Hand, SwingAnimation}; use horizon_client::{ Result, chunk::{BIOME_STRATEGY, Chunk, Light, MIN_Y, SECTIONS, Section, block_strategy}, @@ -3836,23 +3836,26 @@ impl Game<'_> { Ok(true) } KeyCode::KeyQ => { + if self.spectator() { + return Ok(true); + } let all = self.keys.contains(&KeyCode::ControlLeft); + // MultiPlayerGameMode.dropItem: predict removal before sending + // the action, then swing only if a nonempty stack was removed. + let dropped = horizon_client::items::take_held_drop( + &mut self.inventory[self.selected], + all, + false, + ); self.send(S::PlayerAction(play::PlayerAction { action: if all { 4 } else { 5 }, pos: [0; 3], direction: 0, sequence: 0, })); - // Inventory.removeFromSelected (prediction). - let slot = &mut self.inventory[self.selected]; - if let Some(s) = slot { - if all || s.count <= 1 { - *slot = None; - } else { - s.count -= 1; - } + if dropped.is_some() { + self.swing_hand(Hand::Main, SwingAnimation::DEFAULT); } - self.swing_arm(); Ok(true) } KeyCode::KeyE => { diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaHeldDropOracle.java b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaHeldDropOracle.java index 8034968a5..b2cdb3383 100644 --- a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaHeldDropOracle.java +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaHeldDropOracle.java @@ -6,9 +6,14 @@ import java.io.PrintWriter; import net.minecraft.client.*; import net.minecraft.client.gui.Gui; import net.minecraft.client.multiplayer.MultiPlayerGameMode; +import net.minecraft.client.multiplayer.ClientPacketListener; import net.minecraft.client.player.LocalPlayer; +import net.minecraft.network.protocol.Packet; +import net.minecraft.network.protocol.game.ServerboundPlayerActionPacket; +import net.minecraft.world.InteractionHand; import net.minecraft.world.entity.player.*; import net.minecraft.world.item.*; +import net.minecraft.world.item.component.SwingAnimation; import net.minecraft.world.level.GameType; /** Runs the real key handler through its drop loop; stops before item-use handling. */ @@ -41,16 +46,36 @@ public final class VanillaHeldDropOracle { } static final class Actor extends LocalPlayer { GameType mode; + int swings; Actor() { super(null, null, null, null, null, null, false, null, null); } @Override public GameType gameMode() { return mode; } @Override public boolean isUsingItem() { throw new Done(); } + @Override public boolean swing(InteractionHand hand, SwingAnimation animation, boolean sendPacket) { + if (hand != InteractionHand.MAIN_HAND || !animation.equals(SwingAnimation.DEFAULT) || sendPacket) + throw new AssertionError("unexpected drop swing"); + swings++; + return true; + } + } + static final class Connection extends ClientPacketListener { + int drops; + ServerboundPlayerActionPacket.Action expected; + Connection() { super(null, null, null); } + @Override public void send(Packet<?> packet) { + if (packet instanceof ServerboundPlayerActionPacket action) { + if (action.getAction() != expected) throw new AssertionError("unexpected drop action"); + drops++; + } + } } static final class Controller extends MultiPlayerGameMode { int dropped; Controller() { super(null, null); } - // Controlled dispatch boundary: no networking, swings, statistics or item entities. + // Run vanilla's actual prediction, packet dispatch and conditional swing. @Override public void dropItem(LocalPlayer player, boolean all) { - dropped += player.getInventory().removeFromSelected(all).getCount(); + int before = player.getInventory().getSelectedItem().getCount(); + super.dropItem(player, all); + dropped += before - player.getInventory().getSelectedItem().getCount(); } } public static void main(String[] args) throws Exception { @@ -81,6 +106,9 @@ public final class VanillaHeldDropOracle { field(Player.class, "inventory").set(actor, inventory); field(Minecraft.class, "player").set(client, actor); var controller = make(Controller.class); + var connection = make(Connection.class); + field(MultiPlayerGameMode.class, "minecraft").set(controller, client); + field(MultiPlayerGameMode.class, "connection").set(controller, connection); field(Minecraft.class, "gameMode").set(client, controller); try (var out = new PrintWriter(Files.newBufferedWriter(Path.of(args[0])))) { for (var mode : GameType.values()) for (boolean all : new boolean[]{false, true}) { @@ -91,6 +119,10 @@ public final class VanillaHeldDropOracle { inventory.setSelectedSlot(selected); inventory.setItem(selected, new ItemStack(Items.STONE, count)); controller.dropped = 0; + actor.swings = 0; + connection.drops = 0; + connection.expected = all ? ServerboundPlayerActionPacket.Action.DROP_ALL_ITEMS + : ServerboundPlayerActionPacket.Action.DROP_ITEM; // Two consecutive key presses also cover an emptied stack and repeated spectator drops. for (int press = 0; press < 2; press++) { ((Key) options.keyDrop).clicks = 1; @@ -100,7 +132,8 @@ public final class VanillaHeldDropOracle { } catch (InvocationTargetException e) { if (!(e.getCause() instanceof Done)) throw e; } - out.println(inventory.getSelectedItem().getCount() + " " + controller.dropped); + out.println(inventory.getSelectedItem().getCount() + " " + controller.dropped + + " " + actor.swings + " " + connection.drops); } } } diff --git a/tools/test_held_drop_parity.py b/tools/test_held_drop_parity.py index c546c5987..842ad3d8a 100644 --- a/tools/test_held_drop_parity.py +++ b/tools/test_held_drop_parity.py @@ -2,10 +2,12 @@ """Compare selected-slot drops with Minecraft.handleKeybinds in all four game modes. The oracle invokes the unmodified native key handler, consuming real drop-key -clicks. Its controlled dropItem callback removes from the real player Inventory; -other keys are idle and execution stops at the following item-use boundary. +clicks, and MultiPlayerGameMode.dropItem's real prediction and swing dispatch. +Other keys are idle and execution stops at the following item-use boundary. Checks Q/Ctrl+Q, slots 0/8, empty/single/partial/full stacks and repeated drops. -Packet delivery, item entities, swing animation and statistics are outside scope. +Checks swing attempts and drop packet counts, including packets without swings +for empty slots. Packet delivery, animation ticks, item entities and statistics +are outside scope. """ import os import subprocess @@ -35,7 +37,7 @@ def main(): subprocess.run(['cargo', 'run', '--quiet', '-p', 'horizon-client', '--example', 'held_drop_fixture'], cwd=lab.ROOT, stdout=out, check=True) matched = base.compare(build / 'vanilla.txt', build / 'rust.txt') - print(f'Held drop parity passed: {matched} selected-stack/drop-count snapshots match vanilla') + print(f'Held drop parity passed: {matched} inventory/drop/swing/packet snapshots match vanilla') if __name__ == '__main__': From 6e83037fca77eeb7884ceec25292c806efc48937 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 18:32:54 +0200 Subject: [PATCH 034/126] end sky test: as_chunks instead of chunks_exact (clippy 1.99) Rust 1.99's clippy denies chunks_exact with a constant size (chunks_exact_to_as_chunks), so `cargo clippy --all-targets -D warnings` failed on this test. Same check, written as as_chunks::<4>(). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/gfx/end_sky/tests.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/crates/horizon-client/src/gfx/end_sky/tests.rs b/crates/horizon-client/src/gfx/end_sky/tests.rs index d01fca18c..61266003d 100644 --- a/crates/horizon-client/src/gfx/end_sky/tests.rs +++ b/crates/horizon-client/src/gfx/end_sky/tests.rs @@ -314,7 +314,7 @@ fn separate_draws_match_combined_celestial_pixels() { visible_flash_cases += usize::from(expected != no_flash); assert_eq!(actual, expected, "yaw={yaw} pitch={pitch} flash={level}"); assert!( - actual.chunks_exact(4).any(|p| p[..3] != [0; 3]), + actual.as_chunks::<4>().0.iter().any(|p| p[..3] != [0; 3]), "empty frame" ); assert_eq!(resident.mesh.as_ref().unwrap().1, first); From 15b85145845f2c500dcee979d1401217093426b6 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Thu, 22 Oct 2026 17:37:23 +0100 Subject: [PATCH 035/126] Fix registry-backed slash command suggestions on connected clients --- crates/horizon-client/src/game/remote.rs | 5 +++ tools/agent_control_e2e.py | 45 ++++++++++++++++++++++-- tools/test_chat_screen_parity.py | 10 ++++++ 3 files changed, 58 insertions(+), 2 deletions(-) diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 7c96e7bad..020746d68 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -306,6 +306,11 @@ impl Game<'_> { progress: 0.0, total: 0, }; + // The connected client never opens a server world (single player also + // joins here), so load the registries its argument parsers and local + // suggestions need before receiving the server's command tree. + self.ui.registries = Default::default(); + self.build_registries(); self.ui.registries.permission = 0; self.ui.chat.clear(); self.screen = Screen::Playing; diff --git a/tools/agent_control_e2e.py b/tools/agent_control_e2e.py index 977d2e292..962d04575 100644 --- a/tools/agent_control_e2e.py +++ b/tools/agent_control_e2e.py @@ -10,7 +10,8 @@ the options scenario reads and sets options.txt values by key; the events scenar states (wait-for) and reads the event log; the consume scenario eats and drinks consumables (a golden apple, milk, honey, chorus fruit) and checks their effects, remainders and teleport; the pick scenario middle-clicks slots (AbstractContainerScreen's cloning): a full stack in creative, from -the hotbar and from an item tab, and nothing in survival. +the hotbar and from an item tab, and nothing in survival; the suggestions scenario checks +slash-command Tab completion on single player's connected client after a fresh launch. python3 tools/agent_control_e2e.py # both modes python3 tools/agent_control_e2e.py --mode mcp # one of them @@ -45,6 +46,7 @@ LOG_KINDS = ['oak_log', 'birch_log', 'spruce_log', 'jungle_log', 'acacia_log', ' 'mangrove_log', 'cherry_log'] # Positional arguments of the commands the scenario uses, for the CLI. POSITIONAL = { + 'key': ['key', 'action'], 'goto': ['x', 'y', 'z'], 'break': ['x', 'y', 'z'], 'place': ['x', 'y', 'z'], 'block': ['x', 'y', 'z'], 'find_block': ['block', 'radius'], 'entities': ['radius', 'type'], 'click_slot': ['slot'], 'click_button': ['label'], 'type': ['text'], 'wait': ['ticks'], 'wait_ready': ['seconds'], @@ -522,8 +524,47 @@ def pick_scenario(d, out): return {'cloned': shown['item']} +def suggestions_scenario(d, out): + # Start from the title screen: single player's client joins through memory, + # without opening a server world and building its command registries. + d('click', id='singleplayer') + if 'game' not in widgets(d): + d('click', id='create-new-world') + d('type', field='name', replace=True, text='Suggestions') + d('click', id='game-mode') # survival -> hardcore -> creative (commands on) + d('click', id='game-mode') + d('click', id='create-new-world') + d('wait_for', condition='loaded', timeout=400) + d('wait_ready', seconds=400) + + cases = [ + ('/giv', '/give'), + ('/fill ^', '/fill ^ ^'), + ('/give @s diamond_sw', '/give @s minecraft:diamond_sword'), + ('/setblock ~ ~ ~ sto', '/setblock ~ ~ ~ minecraft:stone'), + ('/fill ~ ~ ~ ~1 ~1 ~1 sto', '/fill ~ ~ ~ ~1 ~1 ~1 minecraft:stone'), + ('/setblock ~ ~ ~ oak_stairs[fa', '/setblock ~ ~ ~ oak_stairs[facing='), + ('/clear @s diamond_sw', '/clear @s minecraft:diamond_sword'), + ('/execute run give @s diamond_sw', '/execute run give @s minecraft:diamond_sword'), + ] + for text, expected in cases: + d('key', key='t', action='tap') + d('type', text=text) + if text == '/give @s diamond_sw': + shot = d('screenshot', path=str((out / f'{d.name}-suggestions.png').resolve())) + if '_image' in shot: + (out / f'{d.name}-suggestions.png').write_bytes(shot['_image']) + d('key', key='tab', action='tap') + actual = d('screen')['chat_input'] + assert actual == expected, (text, expected, actual) + d('key', key='esc', action='tap') + if d('screen')['screen'] == 'chat': # Escape first dismisses suggestions + d('key', key='esc', action='tap') + return {'completions': len(cases)} + + SCENARIOS = {'survival': scenario, 'ui': ui_scenario, 'options': options_scenario, 'events': events_scenario, - 'consume': consume_scenario, 'pick': pick_scenario} + 'consume': consume_scenario, 'pick': pick_scenario, 'suggestions': suggestions_scenario} def run(mode, ctl, out, resources, which='survival'): diff --git a/tools/test_chat_screen_parity.py b/tools/test_chat_screen_parity.py index 52febd9f6..1447ebaa6 100644 --- a/tools/test_chat_screen_parity.py +++ b/tools/test_chat_screen_parity.py @@ -69,6 +69,16 @@ def cases(count): 'history': rng.sample(HISTORY, rng.randint(0, len(HISTORY))), 'autoSuggest': rng.random() < 0.85, 'chatOnly': rng.random() < 0.7, 'opacity': rng.choice([0.0, 0.5, 1.0]), 'actions': actions, 'mouse': list(mouse), 'blink': rng.choice([0, 100, 400, 650])}) + # Always exercise registry-backed suggestions and their replacement ranges, + # before and after Tab, including the redirect through execute's root. + for text in ['/give @s diamond_sw', '/setblock ~ ~ ~ sto', '/fill ~ ~ ~ ~1 ~1 ~1 sto', + '/setblock ~ ~ ~ oak_stairs[fa', '/clear @s diamond_sw', + '/execute run give @s diamond_sw', '/fill ']: + for keys in [[], ['tab'], ['tab', 'tab', 'shift+tab']]: + out.append({'width': 640, 'height': 360, 'initial': '', 'history': [], 'autoSuggest': True, + 'chatOnly': True, 'opacity': 0.5, 'mouse': [0, 0], 'blink': 0, + 'actions': [{'type': 'type', 'text': text}] + + [{'type': 'key', 'key': key} for key in keys]}) return out From ecbb0368c551b060fb6c13766552062c9508d487 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Thu, 22 Oct 2026 17:37:42 +0100 Subject: [PATCH 036/126] Fix hand swing prediction for rejected block placements --- crates/horizon-client/src/game/remote.rs | 220 ++++++++++++++++-- .../examples/level_place_fixture.rs | 5 + .../parity/VanillaBlockPlacementOracle.java | 6 +- tools/test_level_place_parity.py | 18 +- 4 files changed, 222 insertions(+), 27 deletions(-) diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 7c96e7bad..f6404223e 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -3489,7 +3489,15 @@ impl Game<'_> { self.predict_use(&changes, seq); } if held_block { - self.with_hand(hand, Game::swing_arm); + if reacts + || held + .as_ref() + .is_some_and(|stack| self.remote_can_place(&hit, stack)) + { + self.with_hand(hand, Game::swing_arm); + } + // BlockItem.place returns FAIL when placement is rejected: + // stop this click without trying the item or the other hand. return true; } return reacts; @@ -3547,7 +3555,11 @@ impl Game<'_> { /// container, and the blocks it changed. Vanilla's client runs it on its /// own level first; this runs it on a copy, and `predict_use` keeps the /// changes it predicts. - fn remote_block_reacts(&self, hit: &super::Hit, held: Option<&ItemStack>) -> (bool, DryUse) { + fn remote_block_reacts( + &mut self, + hit: &super::Hit, + held: Option<&ItemStack>, + ) -> (bool, DryUse) { // Player.isSecondaryUseActive with something in either hand. let hands_full = self.stack_in(self.selected).is_some() || self.offhand.is_some(); if self.keys.contains(&KeyCode::ShiftLeft) && hands_full { @@ -3562,26 +3574,53 @@ impl Game<'_> { [-1, 0, 0] => Direction::West, _ => Direction::East, }; - let mut level = DryLevel { - world: &self.world, - changed: HashMap::new(), - random: horizon_core::random::LegacyRandom::new(0), - sounds: Vec::new(), + let player = self.use_context(); + self.with_level(|b, level, _| { + let mut level = DryLevel::new(level); + let reacts = b + .use_item_on( + &mut level, + &mut horizon_world::level::Ticks::default(), + horizon_core::position::BlockPos::new(hit.pos[0], hit.pos[1], hit.pos[2]), + face, + horizon_core::geometry::Vec3::new(hit.point[0], hit.point[1], hit.point[2]), + player, + held.map(|s| &*s.item), + ) + .consumes_action(); + (reacts, (level.changed.into_iter().collect(), level.sounds)) + }) + } + + /// Run BlockItem.place on a disposable level before predicting its swing. + /// The real level supplies collision shapes and building-blocking entities; + /// block writes, random draws, scheduled ticks and events stay in the preview. + fn remote_can_place(&mut self, hit: &super::Hit, stack: &ItemStack) -> bool { + if !self.may_build() { + return false; + } + let ctx = horizon_world::level::PlaceContext { + clicked_pos: horizon_core::position::BlockPos::new(hit.pos[0], hit.pos[1], hit.pos[2]), + face: horizon_core::geometry::Direction::ALL[face_direction(hit.face) as usize], + hit: Vec3::new(hit.point[0], hit.point[1], hit.point[2]), + inside: hit.face == [0; 3], + yaw: self.yaw, + pitch: self.pitch, + sneaking: self.keys.contains(&KeyCode::ShiftLeft), + item: stack.item.to_string(), + can_use_game_master_blocks: self.can_use_game_master_blocks(), }; - let reacts = self - .res - .behaviours() - .use_item_on( - &mut level, - &mut horizon_world::level::Ticks::default(), - horizon_core::position::BlockPos::new(hit.pos[0], hit.pos[1], hit.pos[2]), - face, - horizon_core::geometry::Vec3::new(hit.point[0], hit.point[1], hit.point[2]), - self.use_context(), - held.map(|s| &*s.item), + self.with_level(|b, level, _| { + let mut level = DryLevel::new(level); + matches!( + b.place_block( + &mut level, + &mut horizon_world::level::Ticks::default(), + &ctx + ), + horizon_world::level::PlaceOutcome::Placed { .. } ) - .consumes_action(); - (reacts, (level.changed.into_iter().collect(), level.sounds)) + }) } /// MultiPlayerGameMode.useItem for `hand`, if it holds something: whether @@ -4529,7 +4568,7 @@ pub(super) fn input_ordinal(input: Input) -> i32 { /// The client's world for a guess at what a click does: reads go to the /// world, writes stay here and are dropped. struct DryLevel<'w> { - world: &'w horizon_client::world::World, + base: &'w dyn horizon_world::level::LevelAccess, changed: HashMap<horizon_core::position::BlockPos, BlockStateId>, random: horizon_core::random::LegacyRandom, /// The sounds the use plays (a door's creak). @@ -4559,6 +4598,17 @@ pub(super) fn hand_operated(name: &str) -> bool { || name == "lever" } +impl<'w> DryLevel<'w> { + fn new(base: &'w dyn horizon_world::level::LevelAccess) -> Self { + Self { + base, + changed: HashMap::new(), + random: horizon_core::random::LegacyRandom::new(0), + sounds: Vec::new(), + } + } +} + impl horizon_world::level::LevelAccess for DryLevel<'_> { fn emit(&mut self, event: horizon_world::level::LevelEvent) { if let horizon_world::level::LevelEvent::Sound { @@ -4575,7 +4625,7 @@ impl horizon_world::level::LevelAccess for DryLevel<'_> { self.changed .get(&pos) .copied() - .unwrap_or_else(|| self.world.block(pos.x, pos.y, pos.z)) + .unwrap_or_else(|| self.base.block_state(pos)) } fn set_raw( &mut self, @@ -4587,13 +4637,31 @@ impl horizon_world::level::LevelAccess for DryLevel<'_> { Some(previous) } fn is_loaded(&self, pos: horizon_core::position::BlockPos) -> bool { - self.world.loaded(pos.x, pos.z) + self.base.is_loaded(pos) + } + fn min_y(&self) -> i32 { + self.base.min_y() + } + fn max_y(&self) -> i32 { + self.base.max_y() + } + fn block_light(&self, pos: horizon_core::position::BlockPos) -> i32 { + self.base.block_light(pos) + } + fn sky_light(&self, pos: horizon_core::position::BlockPos) -> i32 { + self.base.sky_light(pos) + } + fn sky_darken(&self) -> i32 { + self.base.sky_darken() + } + fn is_unobstructed(&self, pos: horizon_core::position::BlockPos, state: BlockStateId) -> bool { + self.base.is_unobstructed(pos, state) } fn random(&mut self) -> &mut horizon_core::random::LegacyRandom { &mut self.random } fn game_time(&self) -> i64 { - self.world.game_time + self.base.game_time() } } @@ -4709,6 +4777,110 @@ impl horizon_client::interaction_input::InteractionWorld for RemoteInputWorld<'_ mod tests { use super::Game; + #[test] + fn placement_preview_checks_obstruction_without_changing_the_level() { + use super::DryLevel; + use horizon_core::{position::BlockPos, random::LegacyRandom}; + use horizon_world::{ + level::{ + Behaviours, LevelAccess, PlaceContext, PlaceOutcome, Ticks, data::load_registry, + }, + registry::BlockStateId, + }; + + struct Level { + air: BlockStateId, + stone: BlockStateId, + obstructed: bool, + loaded: bool, + ceiling: i32, + } + impl LevelAccess for Level { + fn block_state(&self, pos: BlockPos) -> BlockStateId { + if pos == BlockPos::new(0, 0, 0) { + self.stone + } else { + self.air + } + } + fn set_raw(&mut self, _: BlockPos, _: BlockStateId) -> Option<BlockStateId> { + panic!("preview must not write to the live level"); + } + fn is_loaded(&self, _: BlockPos) -> bool { + self.loaded + } + fn max_y(&self) -> i32 { + self.ceiling + } + fn is_unobstructed(&self, pos: BlockPos, _: BlockStateId) -> bool { + assert_eq!(pos, BlockPos::new(0, 1, 0)); + !self.obstructed + } + fn random(&mut self) -> &mut LegacyRandom { + panic!("preview must not advance the live level's random source"); + } + fn game_time(&self) -> i64 { + 0 + } + } + + // As with the LAN tests, prepared game resources are optional locally. + let resources = std::path::Path::new(env!("CARGO_MANIFEST_DIR")) + .join("../../.local/horizon-client") + .join(horizon_core::VANILLA_VERSION); + if !resources.join("block-behaviours.json").exists() { + return; + } + let registry = load_registry(&resources).unwrap(); + let behaviours = Behaviours::load(®istry, &resources).unwrap(); + let mut base = Level { + air: registry.default_state("minecraft:air").unwrap(), + stone: registry.default_state("minecraft:stone").unwrap(), + obstructed: false, + loaded: true, + ceiling: 320, + }; + for item in [ + "minecraft:stone", + "minecraft:oak_slab", + "minecraft:oak_door", + // GrowingPlantHeadBlock.getStateForPlacement draws a random age. + "minecraft:twisting_vines", + ] { + let ctx = PlaceContext { + clicked_pos: BlockPos::new(0, 0, 0), + face: horizon_core::geometry::Direction::Up, + hit: horizon_core::geometry::Vec3::new(0.5, 1.0, 0.5), + inside: false, + yaw: 0.0, + pitch: 45.0, + sneaking: false, + item: item.into(), + can_use_game_master_blocks: false, + }; + for (obstructed, loaded, ceiling) in [ + (false, true, 320), + (true, true, 320), + (false, false, 320), + (false, true, 1), + ] { + base.obstructed = obstructed; + base.loaded = loaded; + base.ceiling = ceiling; + let valid = !obstructed && loaded && ceiling > 1; + let mut preview = DryLevel::new(&base); + let outcome = behaviours.place_block(&mut preview, &mut Ticks::default(), &ctx); + assert_eq!( + matches!(outcome, PlaceOutcome::Placed { .. }), + valid, + "{item}, obstructed={obstructed}, loaded={loaded}, ceiling={ceiling}" + ); + assert_eq!(preview.changed.is_empty(), !valid); + assert_eq!(base.block_state(BlockPos::new(0, 1, 0)), base.air); + } + } + } + #[test] fn every_inventory_menu_slot_is_a_game_slot_and_45_is_the_off_hand() { // InventoryMenu: result, 2x2 grid, armour, 27 + 9 inventory slots, then the off hand. diff --git a/crates/horizon-world/examples/level_place_fixture.rs b/crates/horizon-world/examples/level_place_fixture.rs index a8f00edd1..13595726d 100644 --- a/crates/horizon-world/examples/level_place_fixture.rs +++ b/crates/horizon-world/examples/level_place_fixture.rs @@ -20,6 +20,7 @@ struct Cells { cells: HashMap<BlockPos, BlockStateId>, air: BlockStateId, random: LegacyRandom, + obstructed: bool, } impl LevelAccess for Cells { fn block_state(&self, pos: BlockPos) -> BlockStateId { @@ -37,6 +38,9 @@ impl LevelAccess for Cells { fn game_time(&self) -> i64 { 0 } + fn is_unobstructed(&self, _pos: BlockPos, _state: BlockStateId) -> bool { + !self.obstructed + } } fn main() -> Result<(), Box<dyn std::error::Error>> { @@ -68,6 +72,7 @@ fn main() -> Result<(), Box<dyn std::error::Error>> { cells, air, random: LegacyRandom::new(case["seed"].as_i64().unwrap()), + obstructed: case["obstructed"].as_bool().unwrap_or(false), }; let mut ticks = Ticks::new(0); for x in -2..=2 { diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaBlockPlacementOracle.java b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaBlockPlacementOracle.java index 0757bc2ef..e204d3cc0 100644 --- a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaBlockPlacementOracle.java +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaBlockPlacementOracle.java @@ -27,7 +27,7 @@ import net.minecraft.world.phys.shapes.CollisionContext; /** * Native BlockItem placement-state selection (BlockPlaceContext resolution, * updatePlacementContext and getPlacementState) over generated neighbourhoods. - * Entities never obstruct; nothing is written to the world. + * Entity obstruction can be scripted; nothing is written to the world. */ public final class VanillaBlockPlacementOracle { static Object unsafe; @@ -67,6 +67,7 @@ public final class VanillaBlockPlacementOracle { static final class World extends net.minecraft.server.level.ServerLevel { Map<BlockPos, BlockState> cells; RandomSource random; + boolean obstructed; World() { super(null, null, null, null, null, null, false, 0L, List.of(), false); } @@ -77,7 +78,7 @@ public final class VanillaBlockPlacementOracle { @Override public RandomSource getRandom() { return random; } @Override public int getMinY() { return -64; } @Override public int getHeight() { return 384; } - @Override public boolean isUnobstructed(BlockState state, BlockPos pos, CollisionContext context) { return true; } + @Override public boolean isUnobstructed(BlockState state, BlockPos pos, CollisionContext context) { return !obstructed; } @Override public boolean isUnobstructed(Entity entity) { return true; } @Override public void scheduleTick(BlockPos pos, Block block, int delay) { } @Override public net.minecraft.core.RegistryAccess registryAccess() { return RegistryAccess.fromRegistryOfRegistries(BuiltInRegistries.REGISTRY); } @@ -116,6 +117,7 @@ public final class VanillaBlockPlacementOracle { world.cells.put(new BlockPos(c.get(0).getAsInt(), c.get(1).getAsInt(), c.get(2).getAsInt()), Block.stateById(c.get(3).getAsInt())); } world.random = new LegacyRandomSource(f.get("seed").getAsLong()); + world.obstructed = f.has("obstructed") && f.get("obstructed").getAsBoolean(); var player = make(FakePlayer.class); player.world = world; player.yaw = f.get("yaw").getAsFloat(); diff --git a/tools/test_level_place_parity.py b/tools/test_level_place_parity.py index 423951942..23a68800c 100644 --- a/tools/test_level_place_parity.py +++ b/tools/test_level_place_parity.py @@ -68,6 +68,22 @@ def generate(resources, count, seed): return cases +def obstruction_cases(resources): + """Placement failures must not predict a hand swing. + + Exercise BlockItem.canPlace's entity-obstruction gate with the same + otherwise valid placements, including partial shapes and two-block items. + """ + facts = json.loads((resources / 'facts.json').read_text()) + states = {s[0]: i for i, s in reversed(list(enumerate(facts['states'])))} + stone = states['minecraft:stone'] + for item in ['minecraft:stone', 'minecraft:oak_slab', 'minecraft:oak_stairs', + 'minecraft:oak_door', 'minecraft:torch']: + for obstructed in [False, True]: + yield dict(seed=0, item=item, pos=[0, 0, 0], face=1, hit=[0.5, 1.0, 0.5], + yaw=0, pitch=45, sneak=False, cells=[[0, 0, 0, stone]], obstructed=obstructed) + + def main(): parser = argparse.ArgumentParser(description=__doc__) parser.add_argument('--count', type=int, default=20000) @@ -77,7 +93,7 @@ def main(): resources = lab.LOCAL / 'horizon-client' / lock['minecraft']['version'] work = lab.LOCAL / 'level-place-parity' work.mkdir(parents=True, exist_ok=True) - cases = generate(resources, args.count, args.seed) + cases = list(obstruction_cases(resources)) + generate(resources, args.count, args.seed) (work / 'cases.jsonl').write_text(''.join(json.dumps(case) + '\n' for case in cases)) classes = work / 'classes' classes.mkdir(exist_ok=True) From e7d42dc9d077e93f1546732c803a427ab0ea3043 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Thu, 22 Oct 2026 17:41:17 +0100 Subject: [PATCH 037/126] Fix in-world menu background blur --- crates/horizon-client/src/game.rs | 13 +++-- crates/horizon-client/src/game/screens.rs | 47 ++++++++++++++++- crates/horizon-client/src/gfx.rs | 19 +++++-- crates/horizon-client/src/hud.rs | 62 ++++++++++++++++++++++- 4 files changed, 130 insertions(+), 11 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index f706e9348..be7010c61 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -4838,6 +4838,9 @@ impl Game<'_> { self.draw_chat(&mut batch); self.draw_tab_list(&mut batch); } + // Screen.extractBlurredBackground blurs the world and HUD, while the + // screen's background, widgets, toasts and debug overlay stay sharp. + batch.blur_at = batch.vertices.len() as u32; match self.screen { Screen::Paused if self.pause_menu => self.draw_pause_menu(&mut batch), // PauseScreen(false): only its title, at the top. @@ -10007,9 +10010,8 @@ impl Game<'_> { }; level_loading::draw(batch, atlas, Some(&status), Some(self.loading_progress)); } - /// `Screen.extractBlurredBackground` over the panorama: every classic - /// screen of the title menus but the title itself (`TitleScreen` - /// doesn't blur), when `menuBackgroundBlurriness` is at least 1. + /// `Screen.extractBlurredBackground` over the panorama or the world and + /// HUD, when `menuBackgroundBlurriness` is at least 1. fn menu_blur(&self) -> Option<f32> { let loading = self.loading_reason() == Some(horizon_client::level_loading::Reason::Other); let blurred = !horizon_client::ui_theme::horizon() @@ -10017,7 +10019,10 @@ impl Game<'_> { || self.title.as_ref().is_some_and(|t| { self.screen == Screen::Options || !matches!(t.mode, horizon_client::title::Mode::Main) - })); + }) + || (self.title.is_none() + && self.player.is_some() + && self.screen.blurs_background(self.pause_menu))); let radius = self.settings.menu_blur as f32; (blurred && radius >= 1.0).then_some(radius) } diff --git a/crates/horizon-client/src/game/screens.rs b/crates/horizon-client/src/game/screens.rs index cecd8d46f..07eacfb49 100644 --- a/crates/horizon-client/src/game/screens.rs +++ b/crates/horizon-client/src/game/screens.rs @@ -7,6 +7,24 @@ use horizon_client::{ ui, }; +impl Screen { + /// Screen.extractBackground for non-isInGameUi screens, and + /// PauseScreen.extractBackground only when showPauseMenu is true. + pub(super) fn blurs_background(self, pause_menu: bool) -> bool { + match self { + Self::Paused => pause_menu, + Self::Options | Self::Stats | Self::Advancements | Self::WorldOptions => true, + Self::Playing + | Self::GameModeSwitcher + | Self::Chat + | Self::Creative + | Self::Inventory + | Self::Dead + | Self::CommandBlock => false, + } + } +} + /// PauseScreen buttons: (x, y, width, label key, action id, active). /// https://mcsrc.dev/2/26.3/net/minecraft/client/gui/screens/PauseScreen fn pause_buttons(w: f32, h: f32, remote: bool) -> Vec<(f32, f32, f32, &'static str, u8, bool)> { @@ -334,7 +352,34 @@ impl Game<'_> { #[cfg(test)] mod tests { - use super::pause_buttons; + use super::{Screen, pause_buttons}; + + #[test] + fn menu_blur_matches_vanilla_screen_backgrounds() { + for screen in [ + Screen::Options, + Screen::Stats, + Screen::Advancements, + Screen::WorldOptions, + ] { + assert!(screen.blurs_background(false)); + assert!(screen.blurs_background(true)); + } + assert!(Screen::Paused.blurs_background(true)); + assert!(!Screen::Paused.blurs_background(false)); + for screen in [ + Screen::Playing, + Screen::GameModeSwitcher, + Screen::Chat, + Screen::Creative, + Screen::Inventory, + Screen::Dead, + Screen::CommandBlock, + ] { + assert!(!screen.blurs_background(true)); + assert!(!screen.blurs_background(false)); + } + } #[test] fn pause_menu_uses_disconnect_for_servers_and_keeps_world_options() { diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 14c040c5c..3de07b17b 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -3841,9 +3841,19 @@ impl Renderer { let first = debug_depth + debug_top; pass.draw(0..4, first..first + crosshair); } - if let Some(radius) = frame.menu_blur - && self.config.usage.contains(wgpu::TextureUsages::COPY_SRC) - { + let menu_blur = frame + .menu_blur + .filter(|_| self.config.usage.contains(wgpu::TextureUsages::COPY_SRC)); + let blur_at = menu_blur.map_or(0, |_| frame.hud.blur_at); + self.hud.draw_range( + &mut encoder, + &view_target, + &self.depth, + frame.hud, + [self.config.width, self.config.height], + 0..blur_at, + ); + if let Some(radius) = menu_blur { let format = self.config.format; let device = &self.device; self.menu_blur @@ -3875,12 +3885,13 @@ impl Renderer { grade, ); } - self.hud.draw( + self.hud.draw_range( &mut encoder, &view_target, &self.depth, frame.hud, [self.config.width, self.config.height], + blur_at..frame.hud.vertices.len() as u32, ); if culling && let Some(cull) = &mut self.cull { cull.end(&self.device, &mut encoder); diff --git a/crates/horizon-client/src/hud.rs b/crates/horizon-client/src/hud.rs index 0cc99b07b..0c3bde1d1 100644 --- a/crates/horizon-client/src/hud.rs +++ b/crates/horizon-client/src/hud.rs @@ -363,6 +363,8 @@ pub struct HudBatch { pub patches: Vec<crate::font::Patch>, /// Vertex ranges with another blend or depth/scissor state, in order. pub blends: Vec<(std::ops::Range<u32>, Blend)>, + /// Screen's first vertex: the preceding HUD is part of its blurred background. + pub blur_at: u32, } /// How a run of HUD vertices blends and tests depth. #[derive(Clone, Copy, PartialEq, Eq, Debug)] @@ -398,6 +400,7 @@ impl HudBatch { height: (window[1] as f32 / scale as f32).ceil(), patches: Vec::new(), blends: Vec::new(), + blur_at: 0, } } /// Draw the vertices added since `start` with the inverting blend. @@ -450,6 +453,14 @@ impl HudBatch { } out } + fn runs_in(&self, vertices: std::ops::Range<u32>) -> Vec<(std::ops::Range<u32>, Blend)> { + let mut runs = self.runs(); + for (range, _) in &mut runs { + *range = range.start.max(vertices.start)..range.end.min(vertices.end); + } + runs.retain(|(range, _)| !range.is_empty()); + runs + } /// `AbstractContainerScreen.init`: center in integer GUI coordinates. pub fn centered_origin(&self, width: f32, height: f32) -> (f32, f32) { ( @@ -1078,7 +1089,26 @@ impl HudRenderer { batch: &HudBatch, size: [u32; 2], ) { - if batch.vertices.is_empty() || size.contains(&0) { + self.draw_range( + encoder, + target, + depth, + batch, + size, + 0..batch.vertices.len() as u32, + ); + } + /// Draw part of the prepared batch, preserving its blend/depth runs. + pub fn draw_range( + &self, + encoder: &mut wgpu::CommandEncoder, + target: &wgpu::TextureView, + depth: &wgpu::TextureView, + batch: &HudBatch, + size: [u32; 2], + vertices: std::ops::Range<u32>, + ) { + if vertices.is_empty() || size.contains(&0) { return; } let attachments = [Some(wgpu::RenderPassColorAttachment { @@ -1090,7 +1120,7 @@ impl HudRenderer { store: wgpu::StoreOp::Store, }, })]; - let runs = batch.runs(); + let runs = batch.runs_in(vertices); let mut at = 0; while at < runs.len() { let clip = match runs[at].1 { @@ -1329,6 +1359,33 @@ mod tests { ] ); } + + #[test] + fn blur_boundary_splits_blend_runs_without_losing_or_repeating_vertices() { + let mut batch = HudBatch::new([854, 480]); + for _ in 0..5 { + batch.quad([[0.0; 2]; 4], [[0.0; 2]; 4], 0); + } + batch.blends = vec![ + (6..18, Blend::Invert), + (18..24, Blend::Depth([0, 0, 10, 10])), + ]; + for split in [0, 6, 12, 18, 24, 30] { + let before = batch.runs_in(0..split); + let after = batch.runs_in(split..30); + let actual: Vec<_> = before + .into_iter() + .chain(after) + .flat_map(|(range, blend)| range.map(move |v| (v, blend))) + .collect(); + let expected: Vec<_> = batch + .runs() + .into_iter() + .flat_map(|(range, blend)| range.map(move |v| (v, blend))) + .collect(); + assert_eq!(actual, expected, "blur at {split}"); + } + } #[test] fn container_origins_use_java_integer_division() { // Odd scaled dimensions, odd image sizes and an oversized panel. @@ -1340,6 +1397,7 @@ mod tests { height: height as f32, patches: Vec::new(), blends: Vec::new(), + blur_at: 0, }; for (image_width, image_height) in [(195, 136), (176, 166), (176, 222)] { assert_eq!( From d67779d5a17432e553a36013e5ba3970cb6f9a20 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Thu, 22 Oct 2026 17:42:56 +0100 Subject: [PATCH 038/126] Make completion regression deterministic and include screenshots --- docs/media/command-suggestions/after.png | Bin 0 -> 282564 bytes docs/media/command-suggestions/before.png | Bin 0 -> 151763 bytes tools/agent_control_e2e.py | 7 +++++-- 3 files changed, 5 insertions(+), 2 deletions(-) create mode 100644 docs/media/command-suggestions/after.png create mode 100644 docs/media/command-suggestions/before.png diff --git a/docs/media/command-suggestions/after.png b/docs/media/command-suggestions/after.png new file mode 100644 index 0000000000000000000000000000000000000000..9c1a9cd4c0526ca9b93024d403f80a75f3610f24 GIT binary patch literal 282564 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 y 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 literal 0 HcmV?d00001 diff --git a/docs/media/command-suggestions/before.png b/docs/media/command-suggestions/before.png new file mode 100644 index 0000000000000000000000000000000000000000..66c3925c42b10c77e63cb0756a21e2e289829c2f GIT binary patch literal 151763 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%0D*vBLw^4u954PwTPT`!E*Ga8^G;P&~#`_sv=60 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 T>`Y<v00000NkvXXu0mjfB(`kv literal 0 HcmV?d00001 diff --git a/tools/agent_control_e2e.py b/tools/agent_control_e2e.py index 962d04575..6f75b8a14 100644 --- a/tools/agent_control_e2e.py +++ b/tools/agent_control_e2e.py @@ -533,6 +533,9 @@ def suggestions_scenario(d, out): d('type', field='name', replace=True, text='Suggestions') d('click', id='game-mode') # survival -> hardcore -> creative (commands on) d('click', id='game-mode') + d('type', field='seed', text='5') + d('click', id='world') + d('click', id='world-type') # superflat: this checks chat, without a spawn search d('click', id='create-new-world') d('wait_for', condition='loaded', timeout=400) d('wait_ready', seconds=400) @@ -541,8 +544,8 @@ def suggestions_scenario(d, out): ('/giv', '/give'), ('/fill ^', '/fill ^ ^'), ('/give @s diamond_sw', '/give @s minecraft:diamond_sword'), - ('/setblock ~ ~ ~ sto', '/setblock ~ ~ ~ minecraft:stone'), - ('/fill ~ ~ ~ ~1 ~1 ~1 sto', '/fill ~ ~ ~ ~1 ~1 ~1 minecraft:stone'), + ('/setblock ~ ~ ~ diamond_blo', '/setblock ~ ~ ~ minecraft:diamond_block'), + ('/fill ~ ~ ~ ~1 ~1 ~1 diamond_blo', '/fill ~ ~ ~ ~1 ~1 ~1 minecraft:diamond_block'), ('/setblock ~ ~ ~ oak_stairs[fa', '/setblock ~ ~ ~ oak_stairs[facing='), ('/clear @s diamond_sw', '/clear @s minecraft:diamond_sword'), ('/execute run give @s diamond_sw', '/execute run give @s minecraft:diamond_sword'), From a97d8098c7a5ac9ba9c1043035b26a3ad1134606 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Thu, 22 Oct 2026 17:47:29 +0100 Subject: [PATCH 039/126] Fix firework tooltip translations --- .../examples/firework_tooltip_fixture.rs | 7 ++- crates/horizon-client/src/enchant.rs | 2 + crates/horizon-client/src/item_tooltip.rs | 59 +++++++++++++++++++ tools/test_firework_tooltip_parity.py | 3 +- 4 files changed, 67 insertions(+), 4 deletions(-) diff --git a/crates/horizon-client/examples/firework_tooltip_fixture.rs b/crates/horizon-client/examples/firework_tooltip_fixture.rs index 196fa9955..7f10278b7 100644 --- a/crates/horizon-client/examples/firework_tooltip_fixture.rs +++ b/crates/horizon-client/examples/firework_tooltip_fixture.rs @@ -1,7 +1,7 @@ //! Firework tooltip companion for tools/test_firework_tooltip_parity.py: the //! lines `item_tooltip::firework_lines` gives each stack (SNBT, one per line; //! the `#resources` line names the prepared resources for en_us). -use horizon_client::{item_data::parse_stack, item_tooltip::firework_lines, lang::Language}; +use horizon_client::{enchant::Enchantments, item_data::parse_stack, item_tooltip::firework_lines}; use std::{error::Error, fmt::Write, path::PathBuf}; fn main() -> Result<(), Box<dyn Error>> { @@ -12,8 +12,9 @@ fn main() -> Result<(), Box<dyn Error>> { .find_map(|l| l.strip_prefix("#resources ")) .map(PathBuf::from) .ok_or("no #resources line")?; - let language = Language::load(&[&root], "en_us"); - let translate = |key: &str| language.get(key).map(str::to_owned); + // Use the inventory's filtered translations so missing tooltip keys are caught. + let enchantments = Enchantments::load(&root); + let translate = |key: &str| enchantments.translate(key).map(str::to_owned); let mut output = String::new(); for line in input.lines().filter(|l| !l.starts_with('#')) { let stack = parse_stack(line)?.ok_or("empty stack")?; diff --git a/crates/horizon-client/src/enchant.rs b/crates/horizon-client/src/enchant.rs index 039ea658f..ca2ea6f5c 100644 --- a/crates/horizon-client/src/enchant.rs +++ b/crates/horizon-client/src/enchant.rs @@ -193,6 +193,8 @@ impl Enchantments { || k.starts_with("item.minecraft.splash_potion") || k.starts_with("item.minecraft.lingering_potion") || k.starts_with("item.minecraft.tipped_arrow") + || k.starts_with("item.minecraft.firework_rocket.") + || k.starts_with("item.minecraft.firework_star.") || k.starts_with("trim_") || k.starts_with("potion.") || k.starts_with("container.") diff --git a/crates/horizon-client/src/item_tooltip.rs b/crates/horizon-client/src/item_tooltip.rs index 0fc9910d1..1dbbbf38b 100644 --- a/crates/horizon-client/src/item_tooltip.rs +++ b/crates/horizon-client/src/item_tooltip.rs @@ -591,6 +591,65 @@ mod tests { assert!(container_lines(&ItemStack::new("minecraft:chest", 1), &name, &lang).is_empty()); } + #[test] + fn fireworks_use_loaded_tooltip_translations() { + let root = std::env::temp_dir().join(format!( + "horizon-firework-tooltip-language-{}-{}", + std::process::id(), + std::time::SystemTime::now() + .duration_since(std::time::UNIX_EPOCH) + .unwrap() + .as_nanos(), + )); + let dir = root.join("assets/minecraft/lang"); + std::fs::create_dir_all(&dir).unwrap(); + std::fs::write( + dir.join("en_us.json"), + serde_json::to_vec(&serde_json::json!({ + "item.minecraft.firework_rocket.flight_duration": "Flight Duration: %s", + "item.minecraft.firework_rocket.multiple_stars": "%s x %s", + "item.minecraft.firework_star.shape.small_ball": "Small Ball", + "item.minecraft.firework_star.red": "Red", + "item.minecraft.firework_star.custom_color": "Custom", + "item.minecraft.firework_star.fade_to": "Fade to", + "item.minecraft.firework_star.trail": "Trail", + "item.minecraft.firework_star.flicker": "Twinkle", + })) + .unwrap(), + ) + .unwrap(); + let enchantments = crate::enchant::Enchantments::load(&root); + std::fs::remove_dir_all(&root).unwrap(); + let translate = |key: &str| enchantments.translate(key).map(str::to_owned); + let mut rocket = ItemStack::new("minecraft:firework_rocket", 1); + assert_eq!(firework_lines(&rocket, &translate), ["Flight Duration: 1"]); + let explosion = crate::particles::FireworkExplosion { + colors: vec![0xB3312C], + fade: vec![0x123456], + trail: true, + twinkle: true, + ..Default::default() + }; + rocket.data_mut().fireworks = Some((3, vec![explosion.clone(), explosion.clone()])); + assert_eq!( + firework_lines(&rocket, &translate), + [ + "Flight Duration: 3", + "2 x Small Ball", + " Red", + " Fade to Custom", + " Trail", + " Twinkle", + ] + ); + let mut star = ItemStack::new("minecraft:firework_star", 1); + star.data_mut().firework_explosion = Some(explosion); + assert_eq!( + firework_lines(&star, &translate), + ["Small Ball", "Red", "Fade to Custom", "Trail", "Twinkle"] + ); + } + #[test] fn amounts_use_two_decimals_at_most() { assert_eq!(format_amount(8.0), "8"); diff --git a/tools/test_firework_tooltip_parity.py b/tools/test_firework_tooltip_parity.py index e6cea9925..b3114c01a 100644 --- a/tools/test_firework_tooltip_parity.py +++ b/tools/test_firework_tooltip_parity.py @@ -67,6 +67,7 @@ if __name__ == '__main__': 'firework-tooltip-parity', 'VanillaFireworkTooltipOracle', 'firework_tooltip_fixture', cases, 'Firework rocket and star tooltip lines: flight duration, explosions (counted runs), colours, fade, trail, ' 'twinkle, defaults and tooltip_display', - sources=[lab.ROOT / 'crates/horizon-client/src/item_tooltip.rs', lab.ROOT / 'crates/horizon-client/src/item_data.rs', + sources=[lab.ROOT / 'crates/horizon-client/src/enchant.rs', + lab.ROOT / 'crates/horizon-client/src/item_tooltip.rs', lab.ROOT / 'crates/horizon-client/src/item_data.rs', lab.ROOT / 'crates/horizon-client/src/particles.rs'], expected_lines=COUNT) From b8f79247b865c2a4bba9d5e65803e280f581ceca Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 18:50:25 +0200 Subject: [PATCH 040/126] Mod browser: CurseForge is coming soon Ludovic dropped CurseForge for now (its API needs a paid key). The Mods page shows "CurseForge (coming soon)" beside the Modrinth switch, disabled and inert; browser::sources() is Modrinth only, so no search or install goes to CurseForge, and `--source curseforge` says it is coming soon. Text that asked for a key or an environment variable now says CurseForge support is coming soon. Importing a CurseForge zip or instance still works; jars only CurseForge serves are listed as "CurseForge downloads coming soon". Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- docs/mod-browser.md | 30 ++++++++++----------------- launcher/README.md | 10 ++++----- launcher/src/browser.rs | 14 ++++++------- launcher/src/browser/tests.rs | 7 +++++++ launcher/src/cli.rs | 10 ++++----- launcher/src/modpacks.rs | 3 ++- launcher/src/mods_page.rs | 38 +++++++++++++++++------------------ website/docs/modpacks.md | 2 +- website/docs/mods.md | 2 +- 9 files changed, 58 insertions(+), 58 deletions(-) diff --git a/docs/mod-browser.md b/docs/mod-browser.md index bc7a80b16..6601fea70 100644 --- a/docs/mod-browser.md +++ b/docs/mod-browser.md @@ -1,6 +1,6 @@ # The launcher's mod browser -Search Modrinth (and CurseForge, once the launcher has a key) for Java mods, modpacks, resource packs and shader +Search Modrinth (CurseForge support is coming soon) for Java mods, modpacks, resource packs and shader packs, see how well each one runs before installing it, and install it with its checksum checked. This is item 16 of the roadmap and issue #577. The code is in `launcher/src/browser.rs` and `launcher/src/browser/`. @@ -63,8 +63,8 @@ off. ## The Mods page -The launcher's **Mods** page has the four kinds as tabs (Mods, Modpacks, Resource packs, Shader packs), a search field (Enter searches), **Show everything** and, -once CurseForge is set up, a Modrinth / CurseForge switch. Each result is an index row: its summary, author, +The launcher's **Mods** page has the four kinds as tabs (Mods, Modpacks, Resource packs, Shader packs), a search field (Enter searches), **Show everything** and +the source: Modrinth, with **CurseForge (coming soon)** beside it, disabled. Each result is an index row: its summary, author, downloads, source and licence, how well it runs (and why), **Page** (the project's page on its source) and **Install** (**Import** for a modpack). The Modpacks tab lists the imported packs first, with their coverage report, **Port** and **Play** ([modpacks.md](modpacks.md)). Installed packs are listed above the results with their version, source, @@ -102,21 +102,13 @@ horizon-launcher mods remove faithful-32x **Modrinth.** The public API (`api.modrinth.com/v2`) needs no key. The launcher names itself in its user agent, as Modrinth asks. -### CurseForge +### CurseForge (coming soon) -CurseForge's API (`api.curseforge.com/v1`) needs an API key from its developer console. Ludovic approved CurseForge -for the browser on 2026-10-21; the key is his (agents never sign up for him). Until a key exists the CurseForge source -is off and the browser searches Modrinth only. +CurseForge support is coming soon. Its API (`api.curseforge.com/v1`) needs a paid key, so for now the launcher +doesn't use it: the Mods page shows **CurseForge (coming soon)** beside the Modrinth switch, disabled, and no search +or install goes to CurseForge (`browser::sources()` is Modrinth only; `horizon-launcher mods ... --source curseforge` +says it is coming soon). The CurseForge source (`browser/curseforge.rs`) is kept for when it comes. -To turn it on: - -1. Ludovic gets a key at <https://console.curseforge.com/> (sign in, API keys). CurseForge's terms for a launcher - that ships the key apply: the key is built into the binary, so anyone with the binary can read it. -2. He stores it in the 1Password **Agents** vault as an item `CurseForge API`, field `credential`. -3. It goes into the repository secret `HORIZON_CURSEFORGE_API_KEY` - (`~/fleet/op read "op://Agents/CurseForge API/credential" | gh secret set HORIZON_CURSEFORGE_API_KEY`). - The launcher workflow passes it to the build, which builds it in (`option_env!`). - -At run time `HORIZON_CURSEFORGE_API_KEY` in the environment overrides the built-in key; empty means none. A file -whose author allows downloads from CurseForge's own site only (no `downloadUrl` in the API) is shown but can't be -installed. +A CurseForge modpack zip or instance the player already has still imports, since that needs no key: its jars come +from the player's installed instance or, when Modrinth has the same file, from Modrinth. A jar only CurseForge serves +is listed under the pack as "CurseForge downloads coming soon". diff --git a/launcher/README.md b/launcher/README.md index 08ec11f98..85b74e6aa 100644 --- a/launcher/README.md +++ b/launcher/README.md @@ -24,10 +24,10 @@ The opening, then Play ([clip](docs/opening.webm)): preparation reuses checksum-verified game jars and libraries from the current or another installed Horizon version, so the original Minecraft install is only required when no valid imported copy exists. -- **Mods**: search Modrinth (and CurseForge once the launcher has its API key) for resource +- **Mods**: search Modrinth (CurseForge support is coming soon) for resource packs, Iris/OptiFine shader packs and modpacks, each marked Works, Partly or Doesn't run in Horizon; Java mod jars are never offered. Install puts a pack and what it needs in - `resourcepacks/` or `shaderpacks/` only after its SHA-512 (SHA-1 on CurseForge) matches, and a + `resourcepacks/` or `shaderpacks/` only after its SHA-512 matches, and a modpack goes to the Modpacks page; installed packs show their source and checksum, with Update and Remove ([docs/mod-browser.md](../docs/mod-browser.md)). - **Modpacks**: import a Java modpack (a Modrinth `.mrpack`, a CurseForge zip, or a Prism, @@ -35,8 +35,8 @@ The opening, then Play ([clip](docs/opening.webm)): not yet or not needed, with the reason ([docs/modpacks.md](../docs/modpacks.md)). **Port** gets the jars of what this computer can port today (content mods with data and assets only) the player's own way: copied from a folder they have, or downloaded from the pack's own links - or the same file on Modrinth's CDN, hash checked; files only CurseForge has need its API key, so - they come from your installed instance. It carries them over for the selected version, and + or the same file on Modrinth's CDN, hash checked; files only CurseForge has come from your + installed instance (CurseForge downloads are coming soon). It carries them over for the selected version, and **Play** starts the game as the pack's own profile (`ports/<pack>/home/` in the game's home: its own saves and options) with those mods. Nothing is uploaded or shared: mod jars and ports stay on this computer. @@ -155,7 +155,7 @@ The same binary is a command-line tool; without a subcommand it opens the window horizon-launcher modpack play <pack> [--version <tag>] play it as its own profile horizon-launcher modpack remove <pack> horizon-launcher mods [list] what the mod browser installed (docs/mod-browser.md) - horizon-launcher mods search <text> [--kind resource|shader|modpack] [--everything] [--source modrinth|curseforge] + horizon-launcher mods search <text> [--kind resource|shader|modpack] [--everything] [--source modrinth] horizon-launcher mods install <id or slug> checksum checked, with what it needs; a modpack is imported horizon-launcher mods update [<pack>] [--check] horizon-launcher mods remove <pack> diff --git a/launcher/src/browser.rs b/launcher/src/browser.rs index b8248fd7c..c4a6ff726 100644 --- a/launcher/src/browser.rs +++ b/launcher/src/browser.rs @@ -1,4 +1,4 @@ -//! The mod browser's sources: search Modrinth (and CurseForge, once a key exists) for what +//! The mod browser's sources: search Modrinth (CurseForge support is coming soon) for what //! Horizon loads, say how well each result runs, and download a file only after its checksum //! matches (docs/mod-browser.md). //! @@ -221,13 +221,13 @@ pub trait Source: Send + Sync { } } -/// The sources this launcher can use: Modrinth always, CurseForge when it has an API key. +/// What the launcher says wherever CurseForge would be. +pub const CURSEFORGE_SOON: &str = "CurseForge support is coming soon."; + +/// The sources this launcher uses: Modrinth. CurseForge support is coming soon: its API needs a +/// paid key, so no search or install goes to it; `curseforge` is kept for then. pub fn sources() -> Vec<Box<dyn Source>> { - let mut all: Vec<Box<dyn Source>> = vec![Box::new(modrinth::Modrinth)]; - if let Some(cf) = curseforge::CurseForge::from_env() { - all.push(Box::new(cf)); - } - all + vec![Box::new(modrinth::Modrinth)] } /// The source of that id, when this launcher can use it. diff --git a/launcher/src/browser/tests.rs b/launcher/src/browser/tests.rs index 9e75c55a1..2137ecc94 100644 --- a/launcher/src/browser/tests.rs +++ b/launcher/src/browser/tests.rs @@ -400,3 +400,10 @@ fn live_modrinth_search_pick_and_download() { std::fs::remove_dir_all(&dir).unwrap(); assert_eq!(source.project(&p.id).unwrap().slug, p.slug); } + +#[test] +fn curseforge_is_coming_soon_and_never_searched() { + let ids: Vec<SourceId> = sources().iter().map(|s| s.id()).collect(); + assert_eq!(ids, [SourceId::Modrinth]); + assert!(source(SourceId::CurseForge).is_none()); +} diff --git a/launcher/src/cli.rs b/launcher/src/cli.rs index 530d220dd..ebcc95cd6 100644 --- a/launcher/src/cli.rs +++ b/launcher/src/cli.rs @@ -212,6 +212,7 @@ enum KindArg { #[derive(Clone, Copy, clap::ValueEnum)] enum SourceArg { Modrinth, + /// CurseForge support is coming soon Curseforge, } @@ -222,9 +223,7 @@ impl SourceArg { SourceArg::Modrinth => SourceId::Modrinth, SourceArg::Curseforge => SourceId::CurseForge, }; - browser::source(id).ok_or_else(|| { - "CurseForge needs an API key: HORIZON_CURSEFORGE_API_KEY (docs/mod-browser.md).".into() - }) + browser::source(id).ok_or_else(|| browser::CURSEFORGE_SOON.into()) } } @@ -337,8 +336,9 @@ enum Cmd { #[command(subcommand)] action: Option<ModpackCmd>, }, - /// The mod browser: resource packs, shader packs and modpacks from Modrinth (and CurseForge - /// with a key), each file checked against its checksum (docs/mod-browser.md) + /// The mod browser: Java mods, resource packs, shader packs and modpacks from Modrinth + /// (CurseForge support is coming soon), each file checked against its checksum + /// (docs/mod-browser.md) Mods { #[command(subcommand)] action: Option<ModsCmd>, diff --git a/launcher/src/modpacks.rs b/launcher/src/modpacks.rs index b69ff0976..2495e1ad6 100644 --- a/launcher/src/modpacks.rs +++ b/launcher/src/modpacks.rs @@ -84,7 +84,8 @@ impl Imported { (How::Present, "already here"), ( How::NeedsKey, - "only on CurseForge (needs its API key: choose your installed instance instead)", + "only on CurseForge (CurseForge downloads coming soon: choose your installed \ + instance instead)", ), (How::NotFound, "not found"), (How::Failed, "failed"), diff --git a/launcher/src/mods_page.rs b/launcher/src/mods_page.rs index 136ca7953..fd6a24b76 100644 --- a/launcher/src/mods_page.rs +++ b/launcher/src/mods_page.rs @@ -1,12 +1,11 @@ -//! The Mods page: search Modrinth (and CurseForge with a key) for Java mods, modpacks, resource +//! The Mods page: search Modrinth (CurseForge: coming soon) for Java mods, modpacks, resource //! packs and shader packs, see where each comes from and how well it runs (a Java mod's jar is //! checked first), install it with its checksum checked, and update or remove what was installed //! (`horizon_launcher::browser`). Imported modpacks are listed on its Modpacks tab. use super::servers_page::{type_key, Key}; use super::*; use horizon_launcher::browser::{ - self, curseforge::CurseForge, installed, java, Kind as PackKind, Project, Query, SourceId, - Support, + self, installed, java, Kind as PackKind, Project, Query, SourceId, Support, }; use horizon_launcher::modpacks; use horizon_port_pack::check::Check; @@ -20,10 +19,8 @@ const KINDS: [(PackKind, &str); 4] = [ ]; /// Java mods checked at once. const CHECKING: usize = 2; -const SOURCES: [(SourceId, &str); 2] = [ - (SourceId::Modrinth, "Modrinth"), - (SourceId::CurseForge, "CurseForge"), -]; +/// The sources to pick from; CurseForge is shown beside them as coming soon. +const SOURCES: [(SourceId, &str); 1] = [(SourceId::Modrinth, "Modrinth")]; const PAGE: usize = 20; pub(super) enum Event { @@ -46,7 +43,6 @@ pub(super) enum Checking { pub(super) struct Mods { kind: PackKind, source: SourceId, - curseforge: bool, text: String, focus: FocusHandle, pub(super) focused: bool, @@ -77,7 +73,6 @@ impl Mods { Self { kind: PackKind::Mod, source: SourceId::Modrinth, - curseforge: CurseForge::from_env().is_some(), text: String::new(), focus: cx.focus_handle().tab_index(0).tab_stop(true), focused: false, @@ -458,8 +453,14 @@ impl Launcher { this.mods_search(0); cx.notify(); })); - let source_note = if self.mods.curseforge { - segments("mods-source", &SOURCES, self.mods.source, &t, { + // CurseForge support is coming soon: shown, inert, never searched (like the Microsoft + // account's "Coming soon"). + let source_note = div() + .flex() + .flex_wrap() + .items_center() + .gap(px(8.)) + .child(segments("mods-source", &SOURCES, self.mods.source, &t, { let this = this.clone(); move |source, _, cx| { let _ = this.update(cx, |this, cx| { @@ -470,14 +471,13 @@ impl Launcher { cx.notify(); }); } - }) - .into_any_element() - } else { - text(theme::CAPTION) - .text_color(t.muted) - .child("From Modrinth. CurseForge comes once the launcher has its API key.") - .into_any_element() - }; + })) + .child(disabled(button( + "mods-source-curseforge", + "CurseForge (coming soon)", + Kind::Ghost, + &t, + ))); let controls = div() .flex() .flex_col() diff --git a/website/docs/modpacks.md b/website/docs/modpacks.md index b78c59851..e3ed053d9 100644 --- a/website/docs/modpacks.md +++ b/website/docs/modpacks.md @@ -10,7 +10,7 @@ Open **Modpacks** in the launcher. (From the next launcher release, it is the ** 1. **Import a pack.** Choose **Import a pack file…** for a Modrinth `.mrpack` or a CurseForge zip, or **Import an instance folder…** for a Prism, MultiMC or CurseForge instance. The **Mods** page can also find a Modrinth modpack and import it for you (see [Mods and data packs](/docs/mods#finding-resource-packs-shader-packs-and-modpacks)). 2. **Read the coverage report.** For every mod in the pack it says **Ported**, **Partial**, **Not yet** or **Not needed**, with the reason. You can filter the list by status. -3. **Port.** **Port N mods** gets the jars of the mods this computer can carry over today, and carries them over for the version you picked. It copies the jars from a folder you have, or downloads them from the pack's own links (or the same file from Modrinth's download network), and checks their hashes. Files that only CurseForge has need CurseForge's API key, so for those choose **Use jars from my instance…** and point it at your installed instance. +3. **Port.** **Port N mods** gets the jars of the mods this computer can carry over today, and carries them over for the version you picked. It copies the jars from a folder you have, or downloads them from the pack's own links (or the same file from Modrinth's download network), and checks their hashes. CurseForge downloads are coming soon, so for files that only CurseForge has, choose **Use jars from my instance…** and point it at your installed instance. 4. **Play.** **Play with N mods** starts the game as the pack's own profile, with its own saves and options, and those mods on. Nothing is uploaded or shared. The mod jars and what is made from them stay on your computer. diff --git a/website/docs/mods.md b/website/docs/mods.md index d3305fa69..b0bd8c31f 100644 --- a/website/docs/mods.md +++ b/website/docs/mods.md @@ -36,7 +36,7 @@ cargo horizon-mod run The launcher's **Mods** page (launcher 0.17 and newer) searches [Modrinth](https://modrinth.com) for what Horizon can load: resource packs, Java shader packs and modpacks. Each result says how well it runs in Horizon (**Works**, **Partly**, or **Doesn't run**), and by default the page shows only what runs. **Install** downloads the file, checks it against the checksum Modrinth lists and refuses anything that does not match, then puts it in the right folder, with the packs it needs. **Update** and **Remove** are there too. A resource pack still has to be turned on in the game's Resource Packs screen, and a shader pack in Video, Shader Packs. A modpack is imported on the [Modpacks page](/docs/modpacks). -The page cannot search CurseForge yet. The same things work from a terminal: `horizon-launcher mods search`, `install`, `update` and `remove`. +CurseForge support is coming soon: the page shows it, but doesn't search it yet. The same things work from a terminal: `horizon-launcher mods search`, `install`, `update` and `remove`. ## Java mods from the Mods page (next launcher release) From f53998674de95895558b99e00f572175293db3e0 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 17:37:12 +0200 Subject: [PATCH 041/126] Launcher mod browser: project pages, search filters, project icons and gallery A result's title opens its page in the launcher: icon, authors, downloads, followers, licence, verdict (for a Java mod, what ports and what doesn't) and Install, links, then Description (Markdown), Gallery and Versions tabs (browser::details, Source::details on Modrinth's project and members). Filters: sort (relevance, downloads, follows, newest, updated), loader, game version, environment and categories, from the source's tag lists. Icons and gallery images are fetched at run time over HTTPS from the sources' image CDNs only, size-capped, decoded and scaled to PNGs in a 128 MB disk cache (browser::images); a placeholder shows until they arrive. Vanilla's mark is a grass block drawn from the player's prepared game files. Modrinth's logo isn't shown: its branding is all rights reserved without written permission. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- docs/mod-browser.md | 35 ++ launcher/Cargo.toml | 2 +- launcher/src/browser.rs | 15 + launcher/src/browser/curseforge.rs | 7 +- launcher/src/browser/details.rs | 368 +++++++++++++++++ launcher/src/browser/images.rs | 265 +++++++++++++ launcher/src/browser/modrinth.rs | 69 +++- launcher/src/main.rs | 1 + launcher/src/mods_page.rs | 113 ++++-- launcher/src/mods_project.rs | 617 +++++++++++++++++++++++++++++ 10 files changed, 1435 insertions(+), 57 deletions(-) create mode 100644 launcher/src/browser/details.rs create mode 100644 launcher/src/browser/images.rs create mode 100644 launcher/src/mods_project.rs diff --git a/docs/mod-browser.md b/docs/mod-browser.md index 6601fea70..74959ab4c 100644 --- a/docs/mod-browser.md +++ b/docs/mod-browser.md @@ -71,6 +71,41 @@ report, **Port** and **Play** ([modpacks.md](modpacks.md)). Installed packs are file and the checksum they were checked against, with **Update to …** when a newer version runs and **Remove** (asked twice). +### Project pages, filters and icons + +A result's title opens its page inside the launcher, not in a web browser: its icon, authors, downloads, followers, +last update, licence and source, how well it runs (for a Java mod, what ports and what doesn't, from its check) with +**Install** or **Import**, the project's links (its page on the source, source code, issues, wiki, Discord, +donations; `https://` only, opened in the system browser), then three tabs: **Description** (the project's Markdown, +drawn by the launcher's renderer), **Gallery** and **Versions** (each version's date, loaders, game versions, file +and size, and the verdict of any version already checked). The data is `browser::details` (`Source::details`; on +Modrinth `GET /project/{id}` and `/project/{id}/members`, then `/project/{id}/version`). + +**Filters** sit above the results: the order (best match, relevance, downloads, follows, newest, updated) and, under +**Filters**, the loader, game version, environment (client, server) and categories, with the values the source lists +for the kind (Modrinth's `/tag/category`, `/tag/loader`, `/tag/game_version`, asked once per run). A loader or version +picked replaces the default (Java mod loaders and 26.3 for mods); a version other than 26.3 checks and installs the +newest file for 1.21 or later, as **Show everything** does. Changing tabs clears the filters. CurseForge support +is coming soon; its source already maps the order and the game version. + +**Icons and gallery images** are the projects' own, fetched at run time from the source's image server +(`browser::images`): HTTPS from `cdn.modrinth.com` (or CurseForge's `media.forgecdn.net` / `edge.forgecdn.net`) only, +at most 8 MB each, decoded (PNG, JPEG, WebP, GIF, at most 8192 pixels a side), scaled (icons 128 px, gallery 960 px) +and kept as PNGs in `mod-browser/images/` under the game folder, which is kept under 128 MB by dropping the oldest +files. A plate with the project's initial stands in until the icon arrives. Nothing of a project's art is in the +launcher or the repository. + +**Vanilla Minecraft** is marked with a grass block drawn at run time from the player's own prepared game files +(`assets/minecraft/textures/block/grass_block_*.png`, tinted with the plains grass colour): the game-version filter +shows it. No Mojang file or logo is in the launcher or the repository. + +**Source logos.** Modrinth's logo is not shown: Modrinth's own repository says its branding is all rights reserved and +"the use of Modrinth branding elements, including but not limited to the wrench-in-labyrinth logo, ... is strictly +prohibited without explicit written permission from Rinth, Inc." (`packages/assets/COPYING.md` in +[modrinth/code](https://github.com/modrinth/code/blob/main/packages/assets/COPYING.md)), and its +[terms](https://modrinth.com/legal/terms) ask for prior written permission to use its marks. Results name their source +in text ("from Modrinth") until Rinth, Inc. agrees. CurseForge support, and so its logo, is coming soon. + ## Installing, updating, removing `mod-browser.json` beside `options.txt` lists every file the browser installed: its source, project, version, file diff --git a/launcher/Cargo.toml b/launcher/Cargo.toml index 1097d5675..006e35c5e 100644 --- a/launcher/Cargo.toml +++ b/launcher/Cargo.toml @@ -39,7 +39,7 @@ horizon-telemetry = { path = "../crates/horizon-telemetry" } getrandom = "0.3" # Players' heads on the Servers page, from the default skins in the player's own game files (already # in the lockfile through gpui). -image = { version = "0.25", default-features = false, features = ["png"] } +image = { version = "0.25", default-features = false, features = ["png", "jpeg", "webp", "gif"] } # Microsoft account secrets in the OS keychain: the Secret Service on Linux through oo7 (the same # build gpui uses), Keychain and Credential Manager through keyring. diff --git a/launcher/src/browser.rs b/launcher/src/browser.rs index c4a6ff726..091560638 100644 --- a/launcher/src/browser.rs +++ b/launcher/src/browser.rs @@ -7,7 +7,9 @@ //! (`resourcepacks/`) and Java shader packs (`shaderpacks/`, Iris and OptiFine). Java code itself //! doesn't run in Horizon (docs/mods.md). pub mod curseforge; +pub mod details; pub mod download; +pub mod images; pub mod installed; pub mod java; pub mod modrinth; @@ -189,6 +191,7 @@ pub struct Query { pub everything: bool, pub offset: usize, pub limit: usize, + pub filters: details::Filters, } impl Query { @@ -199,6 +202,7 @@ impl Query { everything: false, offset: 0, limit: 20, + filters: details::Filters::default(), } } } @@ -210,6 +214,17 @@ pub trait Source: Send + Sync { fn project(&self, id: &str) -> Result<Project, String>; /// Versions, newest first. fn versions(&self, project: &Project) -> Result<Vec<Version>, String>; + /// The project's page: description, gallery, links, authors. + fn details(&self, project: &Project) -> Result<details::Details, String> { + Ok(details::Details { + body: project.summary.clone(), + ..details::Details::default() + }) + } + /// The values the search's filters can take for `kind`. + fn tags(&self, _kind: Kind) -> Result<details::Tags, String> { + Ok(details::Tags::default()) + } /// Downloads one of its files into `folder`, checked ([`download::fetch`]). fn fetch( &self, diff --git a/launcher/src/browser/curseforge.rs b/launcher/src/browser/curseforge.rs index 04e722bba..0a7a04a5e 100644 --- a/launcher/src/browser/curseforge.rs +++ b/launcher/src/browser/curseforge.rs @@ -69,12 +69,15 @@ impl CurseForge { pub(super) fn search_url(query: &Query) -> String { let mut url = format!( - "{API}/mods/search?gameId={MINECRAFT}&classId={}&sortField=2&sortOrder=desc&index={}&pageSize={}", + "{API}/mods/search?gameId={MINECRAFT}&classId={}&sortField={}&sortOrder=desc&index={}&pageSize={}", class(query.kind), + query.filters.sort(&query.text).curseforge(), query.offset, query.limit.clamp(1, 50), ); - if !query.everything && matches!(query.kind, Kind::ResourcePack | Kind::Mod) { + if let Some(v) = &query.filters.game_version { + url.push_str(&format!("&gameVersion={}", encode(v))); + } else if !query.everything && matches!(query.kind, Kind::ResourcePack | Kind::Mod) { url.push_str(&format!("&gameVersion={GAME}")); } if !query.text.is_empty() { diff --git a/launcher/src/browser/details.rs b/launcher/src/browser/details.rs new file mode 100644 index 000000000..004db12b4 --- /dev/null +++ b/launcher/src/browser/details.rs @@ -0,0 +1,368 @@ +//! What the browser shows beyond a search hit: a project's page (description, gallery, links, +//! authors) and the search's filters (categories, loader, game version, environment, sort), with +//! the lists of values each source offers for them. Data only: `mods_page` draws it. +use super::{Kind, GAME}; +use serde_json::Value; + +/// How results are ordered. +#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, Hash)] +pub enum Sort { + #[default] + Relevance, + Downloads, + Follows, + Newest, + Updated, +} + +impl Sort { + pub const ALL: [Sort; 5] = [ + Sort::Relevance, + Sort::Downloads, + Sort::Follows, + Sort::Newest, + Sort::Updated, + ]; + pub fn label(self) -> &'static str { + match self { + Sort::Relevance => "Relevance", + Sort::Downloads => "Downloads", + Sort::Follows => "Follows", + Sort::Newest => "Newest", + Sort::Updated => "Updated", + } + } + /// Modrinth's `index`. + pub fn modrinth(self) -> &'static str { + match self { + Sort::Relevance => "relevance", + Sort::Downloads => "downloads", + Sort::Follows => "follows", + Sort::Newest => "newest", + Sort::Updated => "updated", + } + } + /// CurseForge's `sortField` (`ModsSearchSortField`). + pub fn curseforge(self) -> u8 { + match self { + Sort::Relevance | Sort::Follows => 2, + Sort::Downloads => 6, + Sort::Newest => 11, + Sort::Updated => 3, + } + } +} + +/// Where a project runs. +#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)] +pub enum Environment { + Client, + Server, +} + +impl Environment { + pub const ALL: [Environment; 2] = [Environment::Client, Environment::Server]; + pub fn label(self) -> &'static str { + match self { + Environment::Client => "Client", + Environment::Server => "Server", + } + } +} + +/// A search's filters. Empty: the browser's defaults (what runs in Horizon). +#[derive(Clone, Debug, Default, PartialEq, Eq, Hash)] +pub struct Filters { + /// Every one of these categories (`decoration`, `worldgen`...). + pub categories: Vec<String>, + /// One loader (`neoforge`, `fabric`, `iris`...), in place of the kind's defaults. + pub loader: Option<String>, + /// One Minecraft version, in place of the one Horizon plays. + pub game_version: Option<String>, + pub environment: Option<Environment>, + /// None: by relevance with search text, else by downloads. + pub sort: Option<Sort>, +} + +impl Filters { + /// The sort a search uses. + pub fn sort(&self, text: &str) -> Sort { + self.sort.unwrap_or(if text.is_empty() { + Sort::Downloads + } else { + Sort::Relevance + }) + } + /// A game version other than the one Horizon plays was asked for. + pub fn other_version(&self) -> bool { + self.game_version.as_deref().is_some_and(|v| v != GAME) + } +} + +/// One value a filter can take. +#[derive(Clone, Debug, PartialEq, Eq)] +pub struct Tag { + pub name: String, + /// The group a category is in on its source (`categories`, `features`, `resolutions`). + pub header: String, +} + +/// The values each filter can take for a kind. +#[derive(Clone, Debug, Default, PartialEq, Eq)] +pub struct Tags { + pub categories: Vec<Tag>, + pub loaders: Vec<String>, + /// Release versions, newest first. + pub game_versions: Vec<String>, +} + +/// A gallery image. +#[derive(Clone, Debug, PartialEq, Eq)] +pub struct Image { + pub url: String, + pub title: String, + pub description: String, + pub featured: bool, +} + +/// A link a project gives: its source, issues, wiki, Discord, donations. +#[derive(Clone, Debug, PartialEq, Eq)] +pub struct Link { + pub label: String, + pub url: String, +} + +/// A project's page. +#[derive(Clone, Debug, Default, PartialEq, Eq)] +pub struct Details { + /// Markdown (Modrinth's body; HTML blocks in it are left as text the renderer skips). + pub body: String, + pub gallery: Vec<Image>, + pub links: Vec<Link>, + pub authors: Vec<String>, + pub followers: u64, + pub published: String, + pub updated: String, + pub categories: Vec<String>, + /// `required`, `optional`, `unsupported` or `unknown`. + pub client_side: String, + pub server_side: String, +} + +fn strings(v: &Value) -> Vec<String> { + v.as_array() + .into_iter() + .flatten() + .filter_map(|s| s.as_str().map(str::to_owned)) + .collect() +} + +fn text(v: &Value) -> String { + v.as_str().unwrap_or_default().to_owned() +} + +/// Only `https://` links are kept: a page never opens another scheme. +fn https(url: &str) -> Option<String> { + url.starts_with("https://").then(|| url.to_owned()) +} + +/// Modrinth's `GET /project/{id}` and `GET /project/{id}/members`. +pub fn modrinth_details(project: &Value, members: &Value) -> Details { + let mut gallery: Vec<(i64, Image)> = project["gallery"] + .as_array() + .into_iter() + .flatten() + .filter_map(|g| { + Some(( + g["ordering"].as_i64().unwrap_or(0), + Image { + url: https(g["url"].as_str()?)?, + title: text(&g["title"]), + description: text(&g["description"]), + featured: g["featured"].as_bool().unwrap_or(false), + }, + )) + }) + .collect(); + gallery.sort_by_key(|(order, i)| (!i.featured, *order)); + let mut links = Vec::new(); + for (key, label) in [ + ("source_url", "Source"), + ("issues_url", "Issues"), + ("wiki_url", "Wiki"), + ("discord_url", "Discord"), + ] { + if let Some(url) = project[key].as_str().and_then(https) { + links.push(Link { + label: label.into(), + url, + }); + } + } + for d in project["donation_urls"].as_array().into_iter().flatten() { + if let Some(url) = d["url"].as_str().and_then(https) { + links.push(Link { + label: format!("Donate ({})", text(&d["platform"])), + url, + }); + } + } + let mut owners: Vec<(bool, String)> = members + .as_array() + .into_iter() + .flatten() + .filter_map(|m| { + let name = m["user"]["username"].as_str()?.to_owned(); + Some((m["role"].as_str() != Some("Owner"), name)) + }) + .collect(); + owners.sort(); + let mut categories = strings(&project["categories"]); + categories.extend(strings(&project["additional_categories"])); + Details { + body: text(&project["body"]), + gallery: gallery.into_iter().map(|(_, i)| i).collect(), + links, + authors: owners.into_iter().map(|(_, n)| n).collect(), + followers: project["followers"].as_u64().unwrap_or(0), + published: text(&project["published"]), + updated: text(&project["updated"]), + categories, + client_side: text(&project["client_side"]), + server_side: text(&project["server_side"]), + } +} + +/// Modrinth's `/tag/category`, `/tag/loader` and `/tag/game_version` for one project type. +pub fn modrinth_tags( + project_type: &str, + categories: &Value, + loaders: &Value, + versions: &Value, +) -> Tags { + let loader_names: Vec<String> = loaders + .as_array() + .into_iter() + .flatten() + .filter(|l| { + l["supported_project_types"] + .as_array() + .is_some_and(|t| t.iter().any(|x| x == project_type)) + }) + .filter_map(|l| l["name"].as_str().map(str::to_owned)) + .collect(); + let mut categories: Vec<Tag> = categories + .as_array() + .into_iter() + .flatten() + .filter(|c| c["project_type"] == project_type) + .filter_map(|c| { + let name = c["name"].as_str()?.to_owned(); + // Loaders are listed as categories too; the loader filter has them. + (!loader_names.contains(&name)).then(|| Tag { + name, + header: text(&c["header"]), + }) + }) + .collect(); + categories.sort_by(|a, b| (&a.header, &a.name).cmp(&(&b.header, &b.name))); + Tags { + categories, + loaders: loader_names, + game_versions: versions + .as_array() + .into_iter() + .flatten() + .filter(|v| v["version_type"] == "release") + .filter_map(|v| v["version"].as_str().map(str::to_owned)) + .collect(), + } +} + +/// The loaders a kind lists by default, when no loader is picked: Java mod loaders for mods, +/// Iris and OptiFine for shader packs (unless `everything`). +pub fn default_loaders(kind: Kind, everything: bool) -> Vec<&'static str> { + match kind { + Kind::Mod => super::java::LOADERS.to_vec(), + Kind::ShaderPack if !everything => vec!["iris", "optifine"], + _ => Vec::new(), + } +} + +#[cfg(test)] +mod tests { + use super::*; + use serde_json::json; + + #[test] + fn a_modrinth_page() { + let project = json!({ + "body": "# Fences\nMore fences.", + "gallery": [ + {"url": "https://cdn.modrinth.com/data/x/images/b.png", "featured": false, "ordering": 0, "title": "B"}, + {"url": "https://cdn.modrinth.com/data/x/images/a.png", "featured": true, "ordering": 5, "title": "A"}, + {"url": "http://example.com/c.png", "featured": false, "ordering": 1} + ], + "source_url": "https://github.com/x/y", "issues_url": "javascript:alert(1)", + "wiki_url": null, "discord_url": "https://discord.gg/x", + "donation_urls": [{"platform": "Ko-fi", "url": "https://ko-fi.com/x"}], + "followers": 12, "categories": ["decoration"], "additional_categories": ["utility"], + "client_side": "required", "server_side": "required" + }); + let members = json!([ + {"user": {"username": "helper"}, "role": "Member"}, + {"user": {"username": "Macaw"}, "role": "Owner"} + ]); + let d = modrinth_details(&project, &members); + assert_eq!( + d.gallery + .iter() + .map(|i| i.title.as_str()) + .collect::<Vec<_>>(), + ["A", "B"] + ); + assert_eq!( + d.links.iter().map(|l| l.label.as_str()).collect::<Vec<_>>(), + ["Source", "Discord", "Donate (Ko-fi)"] + ); + assert_eq!(d.authors, ["Macaw", "helper"]); + assert_eq!(d.categories, ["decoration", "utility"]); + assert_eq!(d.followers, 12); + } + + #[test] + fn modrinth_tags_by_project_type() { + let categories = json!([ + {"name": "decoration", "project_type": "mod", "header": "categories"}, + {"name": "fabric", "project_type": "mod", "header": "loaders"}, + {"name": "16x", "project_type": "resourcepack", "header": "resolutions"} + ]); + let loaders = json!([ + {"name": "fabric", "supported_project_types": ["mod", "modpack"]}, + {"name": "iris", "supported_project_types": ["shader"]} + ]); + let versions = json!([ + {"version": "26.3", "version_type": "release"}, + {"version": "26.4-snapshot-1", "version_type": "snapshot"} + ]); + let t = modrinth_tags("mod", &categories, &loaders, &versions); + assert_eq!(t.categories.len(), 1); + assert_eq!(t.categories[0].name, "decoration"); + assert_eq!(t.loaders, ["fabric"]); + assert_eq!(t.game_versions, ["26.3"]); + } + + #[test] + fn sorts_default_to_relevance_with_text() { + let f = Filters::default(); + assert_eq!(f.sort(""), Sort::Downloads); + assert_eq!(f.sort("fences"), Sort::Relevance); + let f = Filters { + sort: Some(Sort::Updated), + game_version: Some("1.21.1".into()), + ..Filters::default() + }; + assert_eq!(f.sort("x"), Sort::Updated); + assert!(f.other_version()); + } +} diff --git a/launcher/src/browser/images.rs b/launcher/src/browser/images.rs new file mode 100644 index 000000000..fee2f219e --- /dev/null +++ b/launcher/src/browser/images.rs @@ -0,0 +1,265 @@ +//! Project icons and gallery images, fetched at run time from the sources' image servers and +//! kept on disk: nothing of a project's art is in the launcher. A URL is fetched only over HTTPS +//! from Modrinth's or CurseForge's CDN, at most [`MAX_DOWNLOAD`] bytes, decoded (PNG, JPEG, WebP, +//! GIF), scaled down and stored as a PNG the UI draws; the cache is kept under [`MAX_CACHE`] by +//! dropping the oldest files. +use sha1::{Digest, Sha1}; +use std::fs; +use std::io::Read; +use std::path::{Path, PathBuf}; + +/// Hosts images may come from. +const HOSTS: [&str; 3] = [ + "https://cdn.modrinth.com/", + "https://media.forgecdn.net/", + "https://edge.forgecdn.net/", +]; +/// The most an image may weigh before decoding. +pub const MAX_DOWNLOAD: u64 = 8 << 20; +/// The most the cache keeps on disk. +pub const MAX_CACHE: u64 = 128 << 20; +/// Pixels: an icon's side, a gallery image's longest side. +pub const ICON: u32 = 128; +pub const GALLERY: u32 = 960; + +fn dir(home: &Path) -> PathBuf { + home.join("mod-browser/images") +} + +/// Why `url` is never fetched. +pub fn refuse(url: &str) -> Option<&'static str> { + if !HOSTS.iter().any(|h| url.starts_with(h)) { + return Some("not on Modrinth's or CurseForge's image servers over HTTPS"); + } + if url.len() > 2048 || url.contains(char::is_whitespace) { + return Some("not a plain URL"); + } + None +} + +/// Where the image of `url` scaled to `size` is kept. +pub fn path(home: &Path, url: &str, size: u32) -> PathBuf { + let hash: String = Sha1::digest(url.as_bytes()) + .iter() + .map(|b| format!("{b:02x}")) + .collect(); + dir(home).join(format!("{hash}-{size}.png")) +} + +/// The image if it is cached already. +pub fn cached(home: &Path, url: &str, size: u32) -> Option<PathBuf> { + let p = path(home, url, size); + p.is_file().then_some(p) +} + +/// The image of `url`, no larger than `size` pixels a side: the cached one, else fetched, +/// decoded, scaled and stored. +pub fn fetch(home: &Path, url: &str, size: u32) -> Result<PathBuf, String> { + if let Some(p) = cached(home, url, size) { + return Ok(p); + } + if let Some(why) = refuse(url) { + return Err(format!("{url}: {why}")); + } + let response = super::download::agent() + .get(url) + .call() + .map_err(|e| format!("{url}: {e}"))?; + let mut bytes = Vec::new(); + response + .into_reader() + .take(MAX_DOWNLOAD + 1) + .read_to_end(&mut bytes) + .map_err(|e| format!("{url}: {e}"))?; + if bytes.len() as u64 > MAX_DOWNLOAD { + return Err(format!("{url}: larger than {} MB", MAX_DOWNLOAD >> 20)); + } + store(home, url, size, &bytes) +} + +/// Decodes `bytes`, scales them to fit `size` and writes the PNG. +pub fn store(home: &Path, url: &str, size: u32, bytes: &[u8]) -> Result<PathBuf, String> { + let mut reader = image::ImageReader::new(std::io::Cursor::new(bytes)) + .with_guessed_format() + .map_err(|e| e.to_string())?; + let mut limits = image::Limits::default(); + limits.max_image_width = Some(8192); + limits.max_image_height = Some(8192); + limits.max_alloc = Some(256 << 20); + reader.limits(limits); + let decoded = reader.decode().map_err(|e| format!("{url}: {e}"))?; + let scaled = if decoded.width() > size || decoded.height() > size { + decoded.resize(size, size, image::imageops::FilterType::Triangle) + } else { + decoded + }; + let target = path(home, url, size); + let folder = dir(home); + fs::create_dir_all(&folder).map_err(|e| format!("{}: {e}", folder.display()))?; + let part = target.with_extension("part"); + scaled + .save_with_format(&part, image::ImageFormat::Png) + .map_err(|e| format!("{}: {e}", part.display()))?; + fs::rename(&part, &target).map_err(|e| format!("{}: {e}", target.display()))?; + prune(&folder, MAX_CACHE); + Ok(target) +} + +/// Drops the oldest files until the folder holds at most `max` bytes. +fn prune(folder: &Path, max: u64) { + let mut files: Vec<(std::time::SystemTime, u64, PathBuf)> = fs::read_dir(folder) + .into_iter() + .flatten() + .flatten() + .filter_map(|e| { + let m = e.metadata().ok()?; + Some((m.modified().ok()?, m.len(), e.path())) + }) + .collect(); + let mut total: u64 = files.iter().map(|f| f.1).sum(); + files.sort(); + for (_, len, path) in files { + if total <= max { + break; + } + if fs::remove_file(&path).is_ok() { + total -= len; + } + } +} + +/// Vanilla Minecraft's mark: a grass block drawn from the player's own prepared game files +/// (`<resources>/assets/minecraft/textures/block/`), never shipped. Kept beside the cache. +pub fn grass_block(home: &Path, resources: &Path) -> Option<PathBuf> { + let target = dir(home).join("grass-block.png"); + if target.is_file() { + return Some(target); + } + let textures = resources.join("assets/minecraft/textures/block"); + let load = |name: &str| image::open(textures.join(name)).ok().map(|i| i.to_rgba8()); + let (top, side, overlay) = ( + load("grass_block_top.png")?, + load("grass_block_side.png")?, + load("grass_block_side_overlay.png")?, + ); + let icon = draw_block(&top, &side, &overlay); + fs::create_dir_all(dir(home)).ok()?; + icon.save(&target).ok()?; + Some(target) +} + +/// The plains grass colour vanilla's grass block item shows (`GrassColor.getDefaultColor` +/// is the colormap at 0.5, 1.0: `#91BD59`). +const GRASS: [u8; 3] = [0x91, 0xBD, 0x59]; + +/// An isometric block, 64 pixels a side, from 16x16 faces: the top tinted, the sides with their +/// tinted overlay, the left side shaded as the game shades a side facing away from the light. +fn draw_block( + top: &image::RgbaImage, + side: &image::RgbaImage, + overlay: &image::RgbaImage, +) -> image::RgbaImage { + let size = 64u32; + let mut out = image::RgbaImage::new(size, size); + let at = |img: &image::RgbaImage, u: f32, v: f32| { + let (w, h) = (img.width().min(16), img.height().min(16)); + let x = ((u * w as f32) as u32).min(w - 1); + let y = ((v * h as f32) as u32).min(h - 1); + *img.get_pixel(x, y) + }; + let tint = |p: image::Rgba<u8>, shade: f32| { + let mut q = p; + for c in 0..3 { + q[c] = (p[c] as f32 * GRASS[c] as f32 / 255. * shade) as u8; + } + q + }; + let shade = |p: image::Rgba<u8>, s: f32| { + let mut q = p; + for c in 0..3 { + q[c] = (p[c] as f32 * s) as u8; + } + q + }; + let side_px = |u: f32, v: f32, s: f32| { + let o = at(overlay, u, v); + if o[3] > 0 { + tint(o, s) + } else { + shade(at(side, u, v), s) + } + }; + // The cube: the top face a diamond, two sides below it. + let (cx, h) = (size as f32 / 2., size as f32 / 4.); + for y in 0..size { + for x in 0..size { + let (px, py) = (x as f32 + 0.5, y as f32 + 0.5); + let dx = (px - cx) / cx; + let dy = (py - h) / h; + let u = (dy + dx) / 2. + 0.5; + let v = (dy - dx) / 2. + 0.5; + let pixel = if (0. ..1.).contains(&u) && (0. ..1.).contains(&v) { + Some(tint(at(top, u, v), 1.0)) + } else if px < cx { + let u = px / cx; + let v = (py - h - u * h) / (2. * h); + (0. ..1.).contains(&v).then(|| side_px(u, v, 0.8)) + } else { + let u = (px - cx) / cx; + let v = (py - 2. * h + u * h) / (2. * h); + (0. ..1.).contains(&v).then(|| side_px(u, v, 0.6)) + }; + if let Some(p) = pixel { + out.put_pixel(x, y, p); + } + } + } + out +} + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn only_the_sources_image_servers() { + assert!(refuse("https://cdn.modrinth.com/data/AANobbMI/icon.png").is_none()); + assert!(refuse("https://media.forgecdn.net/avatars/1/2.png").is_none()); + assert!(refuse("http://cdn.modrinth.com/data/x/icon.png").is_some()); + assert!(refuse("https://cdn.modrinth.com.evil.example/x.png").is_some()); + assert!(refuse("https://example.com/x.png").is_some()); + } + + #[test] + fn images_are_scaled_stored_and_pruned() { + let home = std::env::temp_dir().join(format!("horizon-images-{}", std::process::id())); + let _ = fs::remove_dir_all(&home); + let big = image::RgbaImage::from_pixel(300, 150, image::Rgba([1, 2, 3, 255])); + let mut png = Vec::new(); + big.write_to(&mut std::io::Cursor::new(&mut png), image::ImageFormat::Png) + .unwrap(); + let url = "https://cdn.modrinth.com/data/x/icon.png"; + let p = store(&home, url, ICON, &png).unwrap(); + assert_eq!(cached(&home, url, ICON), Some(p.clone())); + assert_eq!(image::open(&p).unwrap().width(), ICON); + assert!(store(&home, url, ICON, b"not an image").is_err()); + prune(&dir(&home), 0); + assert!(cached(&home, url, ICON).is_none()); + fs::remove_dir_all(&home).unwrap(); + } + + #[test] + fn a_grass_block_from_faces() { + let face = |c: [u8; 4]| image::RgbaImage::from_pixel(16, 16, image::Rgba(c)); + let icon = draw_block( + &face([200, 200, 200, 255]), + &face([120, 80, 50, 255]), + &face([0, 0, 0, 0]), + ); + // The top is tinted grass, the sides dirt shaded, the corners empty. + assert_eq!(icon.get_pixel(32, 16)[1], (200. * 0xBD as f32 / 255.) as u8); + assert_eq!(icon.get_pixel(4, 40).0, [96, 64, 40, 255]); + assert_eq!(icon.get_pixel(60, 40).0, [72, 48, 30, 255]); + assert_eq!(icon.get_pixel(1, 1)[3], 0); + } +} diff --git a/launcher/src/browser/modrinth.rs b/launcher/src/browser/modrinth.rs index 77b5475bb..3fde04493 100644 --- a/launcher/src/browser/modrinth.rs +++ b/launcher/src/browser/modrinth.rs @@ -1,5 +1,5 @@ //! Modrinth's public API (api.modrinth.com/v2): no key, files with SHA-512 and SHA-1. -use super::{FileRef, Kind, Project, Query, Source, SourceId, Version, GAME}; +use super::{details, FileRef, Kind, Project, Query, Source, SourceId, Version, GAME}; use serde_json::Value; const API: &str = "https://api.modrinth.com/v2"; @@ -23,26 +23,34 @@ fn kind_of(project_type: &str) -> Option<Kind> { .find(|k| self::project_type(*k) == project_type) } -/// The search's facets (AND of ORs): the kind, and unless `everything` what runs. +/// The search's facets (AND of ORs): the kind, the filters, and unless `everything` what runs. pub(super) fn facets(query: &Query) -> String { + let f = &query.filters; let mut all = vec![vec![format!("project_type:{}", project_type(query.kind))]]; - if !query.everything { - match query.kind { - Kind::ResourcePack => all.push(vec![format!("versions:{GAME}")]), - Kind::ShaderPack => { - all.push(vec!["categories:iris".into(), "categories:optifine".into()]) - } - Kind::Modpack => {} - Kind::Mod => all.push(vec![format!("versions:{GAME}")]), + match &f.game_version { + Some(v) => all.push(vec![format!("versions:{v}")]), + None if !query.everything && matches!(query.kind, Kind::ResourcePack | Kind::Mod) => { + all.push(vec![format!("versions:{GAME}")]) } + None => {} } - if query.kind == Kind::Mod { - all.push( - super::java::LOADERS - .iter() - .map(|l| format!("categories:{l}")) - .collect(), - ); + let loaders: Vec<String> = match &f.loader { + Some(l) => vec![format!("categories:{l}")], + None => details::default_loaders(query.kind, query.everything) + .iter() + .map(|l| format!("categories:{l}")) + .collect(), + }; + if !loaders.is_empty() { + all.push(loaders); + } + for c in &f.categories { + all.push(vec![format!("categories:{c}")]); + } + match f.environment { + Some(details::Environment::Client) => all.push(vec!["client_side!=unsupported".into()]), + Some(details::Environment::Server) => all.push(vec!["server_side!=unsupported".into()]), + None => {} } serde_json::to_string(&all).unwrap_or_default() } @@ -51,11 +59,7 @@ pub(super) fn search_url(query: &Query) -> String { let mut url = format!( "{API}/search?facets={}&index={}&offset={}&limit={}", encode(&facets(query)), - if query.text.is_empty() { - "downloads" - } else { - "relevance" - }, + query.filters.sort(&query.text).modrinth(), query.offset, query.limit.clamp(1, 100), ); @@ -193,6 +197,27 @@ impl Source for Modrinth { all.sort_by(|a, b| b.published.cmp(&a.published)); Ok(all) } + + fn details(&self, project: &Project) -> Result<details::Details, String> { + let id = encode(&project.id); + let p = get(&format!("{API}/project/{id}"))?; + let members = get(&format!("{API}/project/{id}/members")).unwrap_or_default(); + Ok(details::modrinth_details(&p, &members)) + } + + fn tags(&self, kind: Kind) -> Result<details::Tags, String> { + static TAGS: std::sync::Mutex<Option<(Value, Value, Value)>> = std::sync::Mutex::new(None); + let mut cached = TAGS.lock().map_err(|_| "tags".to_string())?; + if cached.is_none() { + *cached = Some(( + get(&format!("{API}/tag/category"))?, + get(&format!("{API}/tag/loader"))?, + get(&format!("{API}/tag/game_version"))?, + )); + } + let (c, l, v) = cached.as_ref().expect("filled above"); + Ok(details::modrinth_tags(project_type(kind), c, l, v)) + } } fn get(url: &str) -> Result<Value, String> { diff --git a/launcher/src/main.rs b/launcher/src/main.rs index bb1e8dceb..5456c235a 100644 --- a/launcher/src/main.rs +++ b/launcher/src/main.rs @@ -9,6 +9,7 @@ mod markdown; mod mcp; mod modpacks_page; mod mods_page; +mod mods_project; mod perf; mod scrollbar; mod servers_page; diff --git a/launcher/src/mods_page.rs b/launcher/src/mods_page.rs index fd6a24b76..e66c02490 100644 --- a/launcher/src/mods_page.rs +++ b/launcher/src/mods_page.rs @@ -31,6 +31,8 @@ pub(super) enum Event { Updates(HashMap<(SourceId, String), String>), /// A Java mod's check: its jar read, or why it couldn't be. Checked((SourceId, String), Result<Box<Check>, String>), + /// A project page's part, an image or a filter's values (`mods_project`). + Loaded(super::mods_project::Loaded), } /// Where a Java mod's check is. @@ -41,8 +43,8 @@ pub(super) enum Checking { } pub(super) struct Mods { - kind: PackKind, - source: SourceId, + pub(super) kind: PackKind, + pub(super) source: SourceId, text: String, focus: FocusHandle, pub(super) focused: bool, @@ -57,13 +59,15 @@ pub(super) struct Mods { installed: Vec<installed::Entry>, loaded: bool, /// The project being installed, and the line and fraction of its download. - busy: Option<(String, String, f32)>, + pub(super) busy: Option<(String, String, f32)>, message: Option<Result<String, String>>, updates: HashMap<(SourceId, String), String>, confirm_remove: Option<String>, /// Java mods' checks, by source and project. - checks: HashMap<(SourceId, String), Checking>, - tx: Sender<Event>, + pub(super) checks: HashMap<(SourceId, String), Checking>, + /// The project page, filters and images. + pub(super) browse: super::mods_project::Browse, + pub(super) tx: Sender<Event>, rx: Receiver<Event>, } @@ -90,6 +94,7 @@ impl Mods { updates: HashMap::new(), confirm_remove: None, checks: HashMap::new(), + browse: Default::default(), tx, rx, } @@ -99,14 +104,14 @@ impl Mods { self.focused = self.focus.is_focused(window); } - fn entry(&self, p: &Project) -> Option<&installed::Entry> { + pub(super) fn entry(&self, p: &Project) -> Option<&installed::Entry> { self.installed .iter() .find(|e| e.source == p.source && e.project == p.id) } /// How well a result runs: a Java mod's from its check once it has one. - fn support(&self, p: &Project) -> Support { + pub(super) fn support(&self, p: &Project) -> Support { let metadata = p.support(); if p.kind != PackKind::Mod || !metadata.installable() { return metadata; @@ -142,6 +147,7 @@ impl Launcher { pub(super) fn mods_tick(&mut self) -> bool { let mut changed = false; let mut to_check = Vec::new(); + let mut loaded = Vec::new(); while let Ok(event) = self.mods.rx.try_recv() { changed = true; let m = &mut self.mods; @@ -184,13 +190,17 @@ impl Launcher { }; m.checks.insert(key, state); } + Event::Loaded(l) => loaded.push(l), } } self.mods_check(to_check); + for l in loaded { + self.mods_loaded(l); + } changed } - fn mods_search(&mut self, offset: usize) { + pub(super) fn mods_search(&mut self, offset: usize) { let m = &mut self.mods; m.search += 1; m.searching = true; @@ -202,6 +212,7 @@ impl Launcher { everything: m.everything, offset, limit: PAGE, + filters: m.browse.filters.clone(), ..Query::new(&m.text, m.kind) }; let (tx, search, source) = (m.tx.clone(), m.search, m.source); @@ -228,7 +239,9 @@ impl Launcher { for p in &todo { m.checks.insert((p.source, p.id.clone()), Checking::Running); } - let (tx, everything) = (m.tx.clone(), m.everything); + // A version other than 26.3 asked for: check the newest file for 1.21 and later. + let everything = m.everything || m.browse.filters.other_version(); + let tx = m.tx.clone(); let queue = std::sync::Mutex::new(todo.into_iter()); std::thread::spawn(move || { let home = backend::game_home(); @@ -273,14 +286,15 @@ impl Launcher { /// Installs (or updates) a project on a thread: a pack into its folder, a modpack into /// Modpacks. `known` is the project when the page has it; else it is asked for first. - fn mods_install(&mut self, source: SourceId, id: String, known: Option<Project>) { + pub(super) fn mods_install(&mut self, source: SourceId, id: String, known: Option<Project>) { if self.mods.busy.is_some() { return; } self.mods.message = None; self.mods.busy = Some((id.clone(), format!("Asking {}…", source.label()), 0.)); self.mods.updates.remove(&(source, id.clone())); - let (tx, everything) = (self.mods.tx.clone(), self.mods.everything); + let everything = self.mods.everything || self.mods.browse.filters.other_version(); + let tx = self.mods.tx.clone(); std::thread::spawn(move || { let last = std::cell::Cell::new(-1); let progress = |line: &str, f: f32| { @@ -429,6 +443,9 @@ impl Launcher { let _ = this.update(cx, |this, cx| { if this.mods.kind != kind { this.mods.kind = kind; + // Categories and loaders differ by kind. + this.mods.browse.filters = Default::default(); + this.mods.browse.open = None; this.mods_search(0); } cx.notify(); @@ -492,15 +509,39 @@ impl Launcher { .child(self.mods_field(cx)) .child(toggle), ) - .child(source_note); + .child(source_note) + .child(self.mods_filters(cx)); + if let Some(project) = self.mods_project_page(cx) { + return div() + .flex() + .flex_col() + .gap(px(32.)) + .child(header) + .children(self.mods_busy_plate()) + .child(project); + } let mut page = div() .flex() .flex_col() .gap(px(32.)) .child(header) .child(controls); + page = page.children(self.mods_busy_plate()); + if self.mods.kind == PackKind::Modpack { + page = page.child(self.imported_packs(cx)); + } + if let Some(list) = self.mods_installed_list(cx) { + page = page.child(list); + } + page.child(self.mods_results(cx)) + } + + /// The install under way and the last install's answer. + pub(super) fn mods_busy_plate(&self) -> Vec<Div> { + let t = self.theme; + let mut out = Vec::new(); if let Some((_, line, f)) = &self.mods.busy { - page = page.child( + out.push( plate(&t) .flex() .flex_col() @@ -517,25 +558,17 @@ impl Launcher { ); } match &self.mods.message { - Some(Ok(done)) => { - page = page.child( - plate(&t) - .p(px(16.)) - .text_size(px(theme::UI.px)) - .text_color(t.ink) - .child(done.clone()), - ) - } - Some(Err(e)) => page = page.child(notice(e.clone(), &t)), + Some(Ok(done)) => out.push( + plate(&t) + .p(px(16.)) + .text_size(px(theme::UI.px)) + .text_color(t.ink) + .child(done.clone()), + ), + Some(Err(e)) => out.push(notice(e.clone(), &t)), None => {} } - if self.mods.kind == PackKind::Modpack { - page = page.child(self.imported_packs(cx)); - } - if let Some(list) = self.mods_installed_list(cx) { - page = page.child(list); - } - page.child(self.mods_results(cx)) + out } fn mods_installed_list(&self, cx: &mut Context<Self>) -> Option<Div> { @@ -650,8 +683,10 @@ impl Launcher { ) } - fn mods_results(&self, cx: &mut Context<Self>) -> Div { + fn mods_results(&mut self, cx: &mut Context<Self>) -> Div { let t = self.theme; + let found = self.mods.results.clone(); + let icons: Vec<AnyElement> = found.iter().map(|p| self.mods_icon(p, 40.)).collect(); let m = &self.mods; if let Some(e) = &m.error { return div().child(notice(e.clone(), &t)); @@ -667,6 +702,7 @@ impl Launcher { return centered(line, &t); } let busy = m.busy.as_ref().map(|b| b.0.as_str()); + let mut icons = icons.into_iter(); let mut list = div().flex().flex_col().border_t_1().border_color(t.rule); for (i, p) in m.results.iter().enumerate() { let support = m.support(p); @@ -746,9 +782,22 @@ impl Launcher { .reason() .map(|r| div().text_color(t.ink_soft).child(r.to_string())), ); + let open = p.clone(); + let name = div() + .id(SharedString::from(format!("mods-open-{}", p.id))) + .flex() + .items_center() + .gap(px(12.)) + .cursor_pointer() + .child(icons.next().expect("one icon per result")) + .child(div().hover(|s| s.underline()).child(p.title.clone())) + .on_click(cx.listener(move |this, _: &ClickEvent, _, cx| { + this.mods_open(open.clone()); + cx.notify(); + })); list = list.child(index_row( i + 1, - p.title.clone(), + name, Some(detail.into_any_element()), Some(right.into_any_element()), &t, diff --git a/launcher/src/mods_project.rs b/launcher/src/mods_project.rs new file mode 100644 index 000000000..ef1d97975 --- /dev/null +++ b/launcher/src/mods_project.rs @@ -0,0 +1,617 @@ +//! The Mods page's project page, search filters and project icons (`horizon_launcher::browser`: +//! `details` for the data, `images` for the icons and gallery). Drawn only with the launcher's +//! shared components, so a restyle of those restyles this. +//! +//! - A result's title opens its page inside the launcher: icon, author, downloads, followers, +//! licence, how well it runs and Install, then Description (Markdown), Gallery, Versions and +//! the project's links. +//! - Filters: sort, loader, game version, environment and categories, with the values the +//! source lists for the kind. +//! - Icons and gallery images come from the source's image servers at run time, cached on disk; +//! a placeholder stands in until one arrives. +use super::mods_page::{Checking, Event}; +use super::*; +use gpui::img; +use horizon_launcher::browser::{ + self, + details::{Details, Environment, Filters, Sort, Tags}, + images, java, Kind as PackKind, Project, SourceId, Support, Version, +}; +use std::collections::{HashMap, HashSet}; +use std::path::PathBuf; + +/// A project page's tabs. +#[derive(Clone, Copy, PartialEq, Eq)] +pub(super) enum Tab { + Description, + Gallery, + Versions, +} + +const TABS: [(Tab, &str); 3] = [ + (Tab::Description, "Description"), + (Tab::Gallery, "Gallery"), + (Tab::Versions, "Versions"), +]; + +/// The open project page. +pub(super) struct Opened { + pub(super) project: Project, + tab: Tab, + details: Option<Result<Details, String>>, + versions: Option<Result<Vec<Version>, String>>, +} + +/// The project page, filters and images' share of the Mods page's state. +#[derive(Default)] +pub(super) struct Browse { + pub(super) open: Option<Opened>, + pub(super) filters: Filters, + pub(super) show_filters: bool, + tags: HashMap<(SourceId, PackKind), Tags>, + tags_asked: HashSet<(SourceId, PackKind)>, + /// Images on disk, by URL and size; `None` while they load or when they failed. + images: HashMap<(String, u32), Option<PathBuf>>, + image_queue: Option<std::sync::mpsc::Sender<(String, u32)>>, +} + +/// What the background sends this module. +pub(super) enum Loaded { + Details((SourceId, String), Result<Details, String>), + Versions((SourceId, String), Result<Vec<Version>, String>), + Image((String, u32), Option<PathBuf>), + Tags((SourceId, PackKind), Result<Tags, String>), +} + +/// Images fetched at once. +const IMAGE_WORKERS: usize = 4; + +impl Launcher { + pub(super) fn mods_loaded(&mut self, loaded: Loaded) { + let b = &mut self.mods.browse; + fn open<'a>(b: &'a mut Browse, key: &(SourceId, String)) -> Option<&'a mut Opened> { + b.open + .as_mut() + .filter(|o| (o.project.source, &o.project.id) == (key.0, &key.1)) + } + match loaded { + Loaded::Details(key, d) => { + if let Some(o) = open(b, &key) { + o.details = Some(d); + } + } + Loaded::Versions(key, v) => { + if let Some(o) = open(b, &key) { + o.versions = Some(v); + } + } + Loaded::Image(key, path) => { + b.images.insert(key, path); + } + Loaded::Tags(key, Ok(tags)) => { + b.tags.insert(key, tags); + } + Loaded::Tags(_, Err(_)) => {} + } + } + + /// Opens a project's page and asks its source for the rest of it. + pub(super) fn mods_open(&mut self, project: Project) { + let key = (project.source, project.id.clone()); + let tx = self.mods.tx.clone(); + let p = project.clone(); + std::thread::spawn(move || { + let Some(source) = browser::source(p.source) else { + return; + }; + let d = source.details(&p); + let _ = tx.send(Event::Loaded(Loaded::Details(key.clone(), d))); + let v = source.versions(&p); + let _ = tx.send(Event::Loaded(Loaded::Versions(key, v))); + }); + self.mods.browse.open = Some(Opened { + project, + tab: Tab::Description, + details: None, + versions: None, + }); + } + + /// The image of `url` at `size` when it is on disk; else asks for it once. + fn mods_image(&mut self, url: &str, size: u32) -> Option<PathBuf> { + let key = (url.to_owned(), size); + if let Some(state) = self.mods.browse.images.get(&key) { + return state.clone(); + } + let home = backend::game_home(); + if let Some(p) = images::cached(&home, url, size) { + self.mods.browse.images.insert(key, Some(p.clone())); + return Some(p); + } + self.mods.browse.images.insert(key.clone(), None); + if images::refuse(url).is_some() { + return None; + } + let b = &mut self.mods.browse; + let queue = b.image_queue.get_or_insert_with(|| { + let (send, receive) = std::sync::mpsc::channel::<(String, u32)>(); + let receive = std::sync::Arc::new(std::sync::Mutex::new(receive)); + for _ in 0..IMAGE_WORKERS { + let (receive, tx, home) = (receive.clone(), self.mods.tx.clone(), home.clone()); + std::thread::spawn(move || loop { + let Ok(next) = receive.lock().map(|r| r.recv()) else { + break; + }; + let Ok((url, size)) = next else { + break; + }; + let path = images::fetch(&home, &url, size).ok(); + if tx + .send(Event::Loaded(Loaded::Image((url, size), path))) + .is_err() + { + break; + } + }); + } + send + }); + let _ = queue.send(key); + None + } + + /// A project's icon, `side` pixels: its image, or its first letter on a plate until then. + pub(super) fn mods_icon(&mut self, p: &Project, side: f32) -> AnyElement { + let t = self.theme; + let path = p + .icon + .clone() + .and_then(|url| self.mods_image(&url, images::ICON)); + let frame = plate(&t) + .flex() + .flex_none() + .items_center() + .justify_center() + .size(px(side)) + .overflow_hidden(); + match path { + Some(path) => frame.child(img(path).size(px(side))).into_any_element(), + None => frame + .text_color(t.muted) + .child( + text(theme::UI).child( + p.title + .chars() + .next() + .map(|c| c.to_uppercase().to_string()) + .unwrap_or_default(), + ), + ) + .into_any_element(), + } + } + + /// The values the filters can take for the current kind and source, asked for once. + fn mods_tags(&mut self) -> Option<&Tags> { + let key = (self.mods.source, self.mods.kind); + if self.mods.browse.tags_asked.insert(key) { + let tx = self.mods.tx.clone(); + std::thread::spawn(move || { + let tags = browser::source(key.0) + .ok_or_else(|| "not set up".to_string()) + .and_then(|s| s.tags(key.1)); + let _ = tx.send(Event::Loaded(Loaded::Tags(key, tags))); + }); + } + self.mods.browse.tags.get(&key) + } + + /// Sets the filters and searches again. + fn mods_filter(&mut self, change: impl FnOnce(&mut Filters)) { + change(&mut self.mods.browse.filters); + self.mods_search(0); + } + + /// The filter bar: sort always; loader, version, environment and categories when shown. + pub(super) fn mods_filters(&mut self, cx: &mut Context<Self>) -> Div { + let t = self.theme; + let this = cx.entity().downgrade(); + let f = self.mods.browse.filters.clone(); + let sorts: Vec<(Option<Sort>, &'static str)> = std::iter::once((None, "Best match")) + .chain(Sort::ALL.iter().map(|s| (Some(*s), s.label()))) + .collect(); + let sort = segments("mods-sort", &sorts, f.sort, &t, { + let this = this.clone(); + move |value, _, cx| { + let _ = this.update(cx, |this, cx| { + this.mods_filter(|f| f.sort = value); + cx.notify(); + }); + } + }); + let shown = self.mods.browse.show_filters; + let active = f.categories.len() + + f.loader.is_some() as usize + + f.game_version.is_some() as usize + + f.environment.is_some() as usize; + let toggle = button( + "mods-filters", + if active > 0 { + format!("Filters ({active})") + } else { + "Filters".to_string() + }, + if shown { Kind::Secondary } else { Kind::Ghost }, + &t, + ) + .on_click(cx.listener(|this, _: &ClickEvent, _, cx| { + this.mods.browse.show_filters = !this.mods.browse.show_filters; + cx.notify(); + })); + let mut bar = div().flex().flex_col().gap(px(12.)).child( + div() + .flex() + .flex_wrap() + .items_center() + .gap(px(12.)) + .child(sort) + .child(toggle), + ); + if !shown { + return bar; + } + let Some(tags) = self.mods_tags().cloned() else { + return bar.child(caps("Loading filters").text_color(t.muted)); + }; + // A chip: on or off, one value of a filter. + let chip = |id: String, label: String, on: bool| { + button( + id, + label, + if on { Kind::Secondary } else { Kind::Ghost }, + &t, + ) + }; + let row = |title: &'static str| { + div() + .flex() + .flex_wrap() + .items_center() + .gap(px(4.)) + .child(caps(title).text_color(t.muted).w(px(120.))) + }; + let mut loaders = row("Loader"); + for l in &tags.loaders { + let on = f.loader.as_deref() == Some(l.as_str()); + let value = l.clone(); + loaders = loaders.child(chip(format!("mods-loader-{l}"), l.clone(), on).on_click( + cx.listener(move |this, _: &ClickEvent, _, cx| { + let v = value.clone(); + this.mods_filter(|f| f.loader = if on { None } else { Some(v) }); + cx.notify(); + }), + )); + } + let mut versions = row("Game version"); + if let Some(path) = self.vanilla_icon() { + versions = versions.child(img(path).size(px(20.)).flex_none()); + } + for v in tags.game_versions.iter().take(12) { + let on = f.game_version.as_deref() == Some(v.as_str()); + let value = v.clone(); + versions = versions.child(chip(format!("mods-version-{v}"), v.clone(), on).on_click( + cx.listener(move |this, _: &ClickEvent, _, cx| { + let v = value.clone(); + this.mods_filter(|f| f.game_version = if on { None } else { Some(v) }); + cx.notify(); + }), + )); + } + let mut environment = row("Environment"); + for e in Environment::ALL { + let on = f.environment == Some(e); + environment = environment.child( + chip(format!("mods-env-{}", e.label()), e.label().into(), on).on_click( + cx.listener(move |this, _: &ClickEvent, _, cx| { + this.mods_filter(|f| f.environment = if on { None } else { Some(e) }); + cx.notify(); + }), + ), + ); + } + let mut categories = row("Categories"); + for c in &tags.categories { + let on = f.categories.contains(&c.name); + let value = c.name.clone(); + categories = categories.child( + chip(format!("mods-cat-{}", c.name), c.name.replace('-', " "), on).on_click( + cx.listener(move |this, _: &ClickEvent, _, cx| { + let v = value.clone(); + this.mods_filter(|f| { + if !f.categories.contains(&v) { + f.categories.push(v); + } else { + f.categories.retain(|x| *x != v); + } + }); + cx.notify(); + }), + ), + ); + } + let clear = button("mods-clear", "Clear filters", Kind::Ghost, &t).on_click(cx.listener( + |this, _: &ClickEvent, _, cx| { + this.mods_filter(|f| *f = Filters::default()); + cx.notify(); + }, + )); + bar = bar + .child(loaders) + .child(versions) + .child(environment) + .child(categories); + if active > 0 { + bar = bar.child(div().flex().child(clear)); + } + bar + } + + /// Vanilla's mark, drawn from the player's prepared game files when there are some. + fn vanilla_icon(&self) -> Option<PathBuf> { + let tag = self.selected().filter(|tag| backend::is_prepared(tag))?; + images::grass_block(&backend::game_home(), &backend::resources(tag)) + } + + /// The open project's page. + pub(super) fn mods_project_page(&mut self, cx: &mut Context<Self>) -> Option<Div> { + let t = self.theme; + let o = self.mods.browse.open.as_ref()?; + let p = o.project.clone(); + let tab = o.tab; + let support = self.mods.support(&p); + let color = match support { + Support::Works => t.success, + Support::Partial(_) => t.accent, + Support::No(_) => t.muted, + }; + let back = button("mods-back", "Back to results", Kind::Ghost, &t).on_click(cx.listener( + |this, _: &ClickEvent, _, cx| { + this.mods.browse.open = None; + cx.notify(); + }, + )); + let details = o.details.clone(); + let versions = o.versions.clone(); + let mut meta = vec![format!("{} downloads", thousands(p.downloads))]; + if let Some(Ok(d)) = &details { + meta.push(format!("{} followers", thousands(d.followers))); + if let Some(day) = d.updated.get(..10) { + meta.push(format!("updated {day}")); + } + } + if !p.license.is_empty() { + meta.push(p.license.clone()); + } + meta.push(format!("from {}", p.source.label())); + let authors = match &details { + Some(Ok(d)) if !d.authors.is_empty() => d.authors.join(", "), + _ => p.author.clone(), + }; + let icon = self.mods_icon(&p, 72.); + let busy = self.mods.busy.as_ref().map(|b| b.0.clone()); + let installed = self.mods.entry(&p).is_some(); + let checking = matches!( + self.mods.checks.get(&(p.source, p.id.clone())), + None | Some(Checking::Running) + ) && p.kind == PackKind::Mod + && p.support().installable(); + let mut action = div().flex().items_center().gap(px(8.)).child( + caps(if checking { + "Checking" + } else { + support.label() + }) + .flex_none() + .text_color(color), + ); + if busy.as_deref() == Some(p.id.as_str()) { + action = action.child(caps("Installing").text_color(t.accent)); + } else if installed { + action = action.child(caps("Installed").text_color(t.muted)); + } else if support.installable() && !checking { + let label = if p.kind == PackKind::Modpack { + "Import" + } else { + "Install" + }; + let mut install = button("mods-page-install", label, Kind::Primary, &t); + if busy.is_some() { + install = disabled(install); + } else { + let p = p.clone(); + install = install.on_click(cx.listener(move |this, _: &ClickEvent, _, cx| { + this.mods_install(p.source, p.id.clone(), Some(p.clone())); + cx.notify(); + })); + } + action = action.child(install); + } + let head = div() + .flex() + .items_center() + .gap(px(20.)) + .child(icon) + .child( + div() + .flex() + .flex_col() + .flex_1() + .min_w_0() + .gap(px(4.)) + .child(text(theme::TITLE).text_color(t.ink).child(p.title.clone())) + .child( + text(theme::UI) + .text_color(t.muted) + .child(if authors.is_empty() { + p.summary.clone() + } else { + format!("by {authors} · {}", p.summary) + }), + ) + .child( + text(theme::CAPTION) + .text_color(t.muted) + .child(meta.join(" · ")), + ), + ) + .child(action); + let mut page = div() + .flex() + .flex_col() + .gap(px(24.)) + .child(div().flex().child(back)) + .child(head); + if let Some(why) = support.reason() { + page = page.child( + text(theme::UI) + .text_color(t.ink_soft) + .child(why.to_string()), + ); + } + if let Some(Checking::Done(c)) = self.mods.checks.get(&(p.source, p.id.clone())) { + let lines = |title: &str, list: &[String]| { + div() + .flex() + .flex_col() + .gap(px(2.)) + .child(caps(title).text_color(t.muted)) + .children( + list.iter() + .map(|l| text(theme::CAPTION).text_color(t.ink_soft).child(l.clone())), + ) + }; + let mut what = div().flex().gap(px(32.)); + if !c.ports.is_empty() { + what = what.child(lines("Ports", &c.ports)); + } + if !c.skipped.is_empty() { + what = what.child(lines("Doesn't port", &c.skipped)); + } + page = page.child(what); + } + if let Some(Ok(d)) = &details { + let mut links = div().flex().flex_wrap().gap(px(8.)); + let page_url = p.page.clone(); + if !page_url.is_empty() { + links = links.child( + button( + "mods-link-page", + format!("{} page", p.source.label()), + Kind::Ghost, + &t, + ) + .on_click(move |_, _, cx| cx.open_url(&page_url)), + ); + } + for (i, l) in d.links.iter().enumerate() { + let url = l.url.clone(); + links = links.child( + button(format!("mods-link-{i}"), l.label.clone(), Kind::Ghost, &t) + .on_click(move |_, _, cx| cx.open_url(&url)), + ); + } + page = page.child(links); + } + let this = cx.entity().downgrade(); + page = page.child(div().flex().child(segments("mods-tab", &TABS, tab, &t, { + move |value, _, cx| { + let _ = this.update(cx, |this, cx| { + if let Some(o) = &mut this.mods.browse.open { + o.tab = value; + } + cx.notify(); + }); + } + }))); + let body = match tab { + Tab::Description => match &details { + None => centered("Loading…", &t), + Some(Err(e)) => notice(e.clone(), &t), + Some(Ok(d)) => div().max_w(px(760.)).child(markdown::render(&d.body, &t)), + }, + Tab::Gallery => match &details { + None => centered("Loading…", &t), + Some(Err(e)) => notice(e.clone(), &t), + Some(Ok(d)) if d.gallery.is_empty() => centered("No gallery images.", &t), + Some(Ok(d)) => { + let mut grid = div().flex().flex_wrap().gap(px(16.)); + for g in &d.gallery { + let shot = match self.mods_image(&g.url, images::GALLERY) { + Some(path) => img(path).w(px(360.)).h(px(203.)).into_any_element(), + None => plate(&t).w(px(360.)).h(px(203.)).into_any_element(), + }; + grid = grid.child( + div() + .flex() + .flex_col() + .gap(px(6.)) + .w(px(360.)) + .child(plate(&t).overflow_hidden().child(shot)) + .when(!g.title.is_empty(), |d| { + d.child( + text(theme::CAPTION) + .text_color(t.ink_soft) + .child(g.title.clone()), + ) + }), + ); + } + grid + } + }, + Tab::Versions => match &versions { + None => centered("Loading…", &t), + Some(Err(e)) => notice(e.clone(), &t), + Some(Ok(list)) => { + let mut rows = div().flex().flex_col().border_t_1().border_color(t.rule); + for (i, v) in list.iter().take(50).enumerate() { + let file = v.file(); + let mut detail = vec![ + v.published.get(..10).unwrap_or_default().to_string(), + v.loaders.join(", "), + ]; + let games: Vec<&str> = v + .game_versions + .iter() + .rev() + .take(4) + .map(String::as_str) + .collect(); + detail.push(games.join(", ")); + if let Some(f) = file { + detail.push(format!("{} · {:.1} MB", f.name, f.size as f64 / 1e6)); + } + let checked = file.and_then(|f| { + (p.kind == PackKind::Mod) + .then(|| java::cached(&backend::game_home(), f)) + .flatten() + }); + rows = rows.child(index_row( + i + 1, + v.number.clone(), + Some(detail.join(" · ").into_any_element()), + checked.map(|c| { + caps(c.verdict.label()) + .text_color(t.muted) + .into_any_element() + }), + &t, + )); + } + rows + } + }, + }; + Some(page.child(body)) + } +} From b1dc23551b93ed2e307c42073b560c0cb7ae6734 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 18:02:25 +0200 Subject: [PATCH 042/126] tools: end-to-end check of a Java mod from the mod browser mod_browser_harness.py searches, checks and installs a mod through the launcher's mods CLI in a scratch game folder, opens a world with it offscreen, places one of its blocks and crafts one of its recipes on a crafting table, and times the world load with and without it. Macaw's Fences: check 4.0 s, install 3.1 s, world load 5.4 s -> 7.3 s, hedge placed, 4 crafted. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- docs/mod-browser.md | 13 ++ tools/mod_browser_harness.py | 270 +++++++++++++++++++++++++++++++++++ 2 files changed, 283 insertions(+) create mode 100755 tools/mod_browser_harness.py diff --git a/docs/mod-browser.md b/docs/mod-browser.md index 6601fea70..fe86328db 100644 --- a/docs/mod-browser.md +++ b/docs/mod-browser.md @@ -51,6 +51,19 @@ or GeckoLib) is listed as not ported. A mod that shares its id or a namespace wi game reads mod content when it starts: start it again after installing. **Remove** deletes the folder and turns it off. +### End-to-end check + +`tools/mod_browser_harness.py [--mod SLUG] [--query TEXT] [--keep]` runs the whole path a player takes, in a scratch +game folder: the launcher's `mods search --kind mod`, `mods check` and `mods install` (Modrinth), then the game +opens a survival world with the mod offscreen (horizon-ctl), places one of its blocks, and crafts one of its recipes +from vanilla ingredients on a crafting table and takes the result. It times the world's load with and without the +mod and prints a JSON summary; it exits 1 when a step fails. It needs the launcher, the game and horizon-ctl built +and the prepared 26.3 resources in `.local`. + +On the Mac mini (M4 Pro, offscreen) with Macaw's Fences and Walls (the default): check 4.0 s, install 3.1 s, world +load 5.4 s without mods and 7.3 s with it (resources 1.1 s and 2.6 s: the mod content folder is built on the first +start); the hedge places and its recipe crafts 4. + ## Checks on every download - The file must come from Modrinth's or CurseForge's file servers (`cdn.modrinth.com`, `edge.forgecdn.net`, diff --git a/tools/mod_browser_harness.py b/tools/mod_browser_harness.py new file mode 100755 index 000000000..4531570bc --- /dev/null +++ b/tools/mod_browser_harness.py @@ -0,0 +1,270 @@ +#!/usr/bin/env python3 +"""End-to-end harness for Java mods from the launcher's mod browser (docs/mod-browser.md). + + mod_browser_harness.py [--mod SLUG] [--query TEXT] [--keep] + +In a scratch game folder, as a player would through the Mods page (its CLI): + +1. `horizon-launcher mods search --kind mod TEXT` finds the mod on Modrinth; +2. `horizon-launcher mods check SLUG` downloads its jar (checksum checked) and says Works or Partly; +3. `horizon-launcher mods install SLUG` ports it into horizon-mods/ and turns it on; +4. the game opens a survival world with it (horizon-ctl, offscreen), and +5. a ported block item is given, held, and placed: the world then holds the mod's block; +6. a ported recipe with vanilla ingredients is crafted on a crafting table: the result slot shows + the mod's item and taking it puts it in the inventory. + +It also times the install and the world's load with the mod against the same world with none +(a ported mod must not slow a game that doesn't use it; this measures what one that does costs). +Prints one JSON line per step and a summary; exits 1 when a step fails. + +Needs the launcher (launcher/target/debug/horizon-launcher, built with +`--features gpui/runtime_shaders` on macOS), the game and horizon-ctl +(target/fast/horizon-client, target/fast/horizon-ctl, or --bin DIR) and the prepared resources in +.local/horizon-client/26.3. Downloads from Modrinth. +""" +import argparse +import json +import os +import re +import shutil +import subprocess +import sys +import tempfile +import time +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] + + +class Failed(Exception): + pass + + +def run(cmd, env, cwd=None, timeout=600): + p = subprocess.run(cmd, env=env, cwd=cwd, capture_output=True, text=True, timeout=timeout) + if p.returncode != 0: + raise Failed(f"{' '.join(map(str, cmd))}: exit {p.returncode}: {p.stderr.strip()[-800:] or p.stdout.strip()[-800:]}") + return p.stdout + + +def report(step, **fields): + print(json.dumps({"step": step, **fields}), flush=True) + + +class Game: + def __init__(self, ctl, client, resources, home, env): + self.ctl, self.client, self.resources, self.home, self.env = ctl, client, resources, home, env + self.socket = str(home / "ctl.sock") + self.pid = None + + def __call__(self, *args, timeout=120): + out = run([self.ctl, "--socket", self.socket, "--timeout", str(timeout), *map(str, args)], self.env, + timeout=timeout + 30) + return json.loads(out.strip().splitlines()[-1]) + + def launch(self, world): + start = time.monotonic() + state = self("launch", "--game", self.client, "--world", world, "--seed", "1234", "--wait", "--offscreen", + "--resources", self.resources, timeout=300) + self.pid = state.get("launch", {}).get("pid") + return time.monotonic() - start, state + + def quit(self): + try: + self("quit", timeout=30) + except Exception: + pass + if self.pid: + for _ in range(50): + try: + os.kill(self.pid, 0) + except OSError: + break + time.sleep(0.2) + else: + os.kill(self.pid, 9) + self.pid = None + + +def resources_loaded(log): + """Seconds the game's log says its resources took.""" + m = re.findall(r"resources loaded in ([0-9.]+)s", Path(log).read_text(errors="replace")) + return float(m[-1]) if m else None + + +def pick_block(mod): + """A block the carry declares with its item.""" + for f in sorted((mod / "data").glob("*/horizon/block/*.json")): + decl = json.loads(f.read_text()) + if decl.get("item", True): + return f"{f.parts[-4]}:{f.stem}" + raise Failed("the carry declares no block with an item") + + +def pick_recipe(mod, ns): + """A crafting recipe of the mod's whose result is its own and whose ingredients are plain vanilla + item ids, shaped first.""" + found = [] + for f in sorted((mod / "data").glob("*/recipe/**/*.json")): + try: + r = json.loads(f.read_text()) + except ValueError: + continue + result = (r.get("result") or {}).get("id", "") + if not result.startswith(ns + ":"): + continue + if r.get("type") == "minecraft:crafting_shaped": + keys = r.get("key", {}) + if all(isinstance(v, str) and v.startswith("minecraft:") for v in keys.values()) and \ + len(r["pattern"]) <= 3 and all(len(row) <= 3 for row in r["pattern"]): + found.append((0, f.name, r)) + elif r.get("type") == "minecraft:crafting_shapeless": + ing = r.get("ingredients", []) + if ing and len(ing) <= 9 and all(isinstance(v, str) and v.startswith("minecraft:") for v in ing): + found.append((1, f.name, r)) + if not found: + raise Failed("no crafting recipe of the mod's with vanilla ingredients") + return sorted(found, key=lambda x: (x[0], x[1]))[0][2] + + +def grid_cells(recipe): + """(slot, item) for each grid cell of a 3x3 crafting table (slots 100-108).""" + if recipe["type"] == "minecraft:crafting_shaped": + return [(100 + 3 * y + x, recipe["key"][c]) for y, row in enumerate(recipe["pattern"]) + for x, c in enumerate(row) if c != " "] + return [(100 + i, item) for i, item in enumerate(recipe["ingredients"])] + + +def inventory_slot(game, item): + inv = game("inventory") + for s in inv["hotbar"] + inv["main"]: + if s.get("item") == item: + return s["slot"] + raise Failed(f"{item} is not in the inventory: {inv.get('counts')}") + + +def main(): + ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) + ap.add_argument("--mod", default="macaws-fences-and-walls", help="Modrinth slug of a Works or Partly mod") + ap.add_argument("--query", default="macaw", help="the search text that finds it") + ap.add_argument("--launcher", default=str(ROOT / "launcher/target/debug/horizon-launcher")) + ap.add_argument("--bin", default=str(ROOT / "target/fast"), help="folder with horizon-client and horizon-ctl") + ap.add_argument("--resources", default=str(ROOT / ".local/horizon-client/26.3")) + ap.add_argument("--keep", action="store_true", help="keep the scratch game folder") + args = ap.parse_args() + + home = Path(tempfile.mkdtemp(prefix="horizon-mod-browser-")) + env = dict(os.environ, HORIZON_HOME=str(home), HORIZON_NO_AUDIO="1", HORIZON_NO_HEARTBEAT="1", + HORIZON_CONTROL=str(home / "ctl.sock")) + launcher = [args.launcher] + game = Game(str(Path(args.bin) / "horizon-ctl"), str(Path(args.bin) / "horizon-client"), + args.resources, home, env) + summary = {"mod": args.mod} + ok = False + try: + # A baseline world first, with no mod: the same world's load time with the mod is compared. + base_home = home / "vanilla" + base_home.mkdir() + base = Game(game.ctl, game.client, args.resources, base_home, + dict(env, HORIZON_HOME=str(base_home), HORIZON_CONTROL=str(base_home / "ctl.sock"))) + base.socket = str(base_home / "ctl.sock") + os.chdir(base_home) + took, _ = base.launch("browser") + summary["world_load_without_mods_s"] = round(took, 2) + summary["resources_without_mods_s"] = resources_loaded(base_home / "ctl.log") + base.quit() + + found = json.loads(run(launcher + ["--json", "mods", "search", "--kind", "mod", *args.query.split()], env)) + slugs = [p["slug"] for p in found] + report("search", query=args.query, results=len(found), found=args.mod in slugs) + if args.mod not in slugs: + raise Failed(f"{args.mod} not in the results: {slugs[:10]}") + + start = time.monotonic() + check = json.loads(run(launcher + ["--json", "mods", "check", args.mod], env).strip().splitlines()[-1]) + summary["check_s"] = round(time.monotonic() - start, 2) + report("check", verdict=check["label"], summary=check["summary"], seconds=summary["check_s"]) + if check["verdict"] not in ("works", "partly"): + raise Failed(f"{args.mod} doesn't run: {check['summary']}") + + start = time.monotonic() + run(launcher + ["mods", "install", args.mod], env) + summary["install_s"] = round(time.monotonic() - start, 2) + mod_id = check["mod_id"] + mod = home / "horizon-mods" / mod_id + on = (home / "horizon-mods.txt").read_text() + report("install", folder=str(mod.relative_to(home)), turned_on=f"mod.{mod_id}:true" in on, + seconds=summary["install_s"]) + if not (mod / "horizon-mod.toml").is_file() or f"mod.{mod_id}:true" not in on: + raise Failed("not installed or not turned on") + + os.chdir(home) + took, state = game.launch("browser") + summary["world_load_with_mod_s"] = round(took, 2) + summary["resources_with_mod_s"] = resources_loaded(home / "ctl.log") + log = (home / "ctl.log").read_text(errors="replace") + loaded = "content from 1 mod(s)" in log + report("world", seconds=round(took, 2), content_loaded=loaded, screen=state.get("screen")) + if not loaded: + raise Failed("the game didn't load the mod's content") + + x, y, z = (int(v // 1) for v in state["player"]["position"]) + block = pick_block(mod) + game("command", "gamemode survival") + game("command", f"fill {x + 1} {y - 1} {z - 2} {x + 4} {y - 1} {z + 2} minecraft:stone") + game("command", f"fill {x + 1} {y} {z - 2} {x + 4} {y + 2} {z + 2} minecraft:air") + game("give", block, 1) + game("select", block) + held = game("state")["held"] + placed = game("place", x + 2, y, z, "--item", block) + at = game("block", x + 2, y, z) + report("place", block=block, held=held, placed=at.get("block")) + if at.get("block") != block: + raise Failed(f"placing {block} left {at.get('block')}") + + recipe = pick_recipe(mod, mod_id) + result = recipe["result"]["id"] + # A server command: horizon-ctl's own setblock changes the client's world only. + game("command", f"setblock {x + 2} {y} {z + 2} minecraft:crafting_table") + cells = grid_cells(recipe) + game("select", 9) + game("interact", x + 2, y, z + 2) + if game("screen").get("craft_size") != 3: + raise Failed("the crafting table didn't open") + # One item at a time, picked up and put down with left clicks: quick right clicks can + # cross the server's answers and be dropped. + for slot, item in cells: + game("give", item, 1) + time.sleep(0.2) + game("click-slot", inventory_slot(game, item)) + time.sleep(0.2) + game("click-slot", slot) + time.sleep(0.2) + screen = game("screen") + out = next((s for s in screen.get("slots", []) if s.get("slot") == 200), {}) + report("craft", recipe=result, result_slot=out.get("item"), count=out.get("count")) + if out.get("item") != result: + raise Failed(f"the table shows {out.get('item')}, not {result}") + game("click-slot", 200, "shift") + time.sleep(0.3) + counts = game("inventory")["counts"] + report("crafted", inventory=counts.get(result, 0)) + if counts.get(result, 0) < 1: + raise Failed(f"{result} didn't reach the inventory") + game("close") + ok = True + except Failed as e: + report("failed", why=str(e)) + finally: + game.quit() + summary["ok"] = ok + print(json.dumps({"summary": summary}), flush=True) + if args.keep: + print(f"kept {home}", file=sys.stderr) + else: + shutil.rmtree(home, ignore_errors=True) + return 0 if ok else 1 + + +if __name__ == "__main__": + sys.exit(main()) From f926d1d2b13fafc6d82c8abc7e893b650e631a03 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 18:28:58 +0200 Subject: [PATCH 043/126] Modpacks from the mod browser: ported in the same step, mods loaded together Importing a modpack from the Mods page (or `mods install`) now ports it right away for the selected version, so Play works straight after. port-pack leaves a namespace two carried mods both claim to none of them (YUNG's mods all ship `yungsapi`, which made the game drop three of them), and the launcher applies the game's first-wins rule before it starts a pack, listing what it left off. Measured on Vanilla Perfected, Slimes Adventure and All the Mods 10 (docs/modpacks.md): 2, 20 and 42 mods ported, every world loads, no crash. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/carry.rs | 12 +++ crates/horizon-port-pack/src/pipeline.rs | 114 ++++++++++++++++++++++- docs/mod-browser.md | 11 ++- docs/modpacks.md | 29 ++++++ launcher/src/cli.rs | 14 +-- launcher/src/modpacks.rs | 63 ++++++++++++- launcher/src/modpacks_page.rs | 3 + launcher/src/mods_page.rs | 11 ++- website/docs/modpacks.md | 6 +- 9 files changed, 243 insertions(+), 20 deletions(-) diff --git a/crates/horizon-port-pack/src/carry.rs b/crates/horizon-port-pack/src/carry.rs index c1fe2b32a..03b5d7dc9 100644 --- a/crates/horizon-port-pack/src/carry.rs +++ b/crates/horizon-port-pack/src/carry.rs @@ -582,6 +582,18 @@ fn extra_namespaces( claimed } +/// The namespaces besides `id` the mod in `jar` would own ([`extra_namespaces`]), for the +/// pack to find the ones several mods claim. +pub fn namespaces_claimed( + jar: &Path, + id: &str, + pack_mod: &dyn Fn(&str) -> bool, +) -> Result<Vec<String>, String> { + let file = fs::File::open(jar).map_err(|e| format!("{}: {e}", jar.display()))?; + let mut zip = zip::ZipArchive::new(file).map_err(|e| format!("{}: {e}", jar.display()))?; + Ok(extra_namespaces(&mut zip, id, pack_mod)) +} + fn contains(haystack: &[u8], needle: &[u8]) -> bool { haystack.windows(needle.len()).any(|w| w == needle) } diff --git a/crates/horizon-port-pack/src/pipeline.rs b/crates/horizon-port-pack/src/pipeline.rs index 26744d7bd..c34f58411 100644 --- a/crates/horizon-port-pack/src/pipeline.rs +++ b/crates/horizon-port-pack/src/pipeline.rs @@ -150,7 +150,16 @@ pub fn carry( }) .flatten() .collect(); - let in_pack = |m: &str| in_pack.contains(m); + // A namespace two carried mods both claim (a library's they both use, such as YUNG's API's + // `yungsapi`, whose own jar isn't read) is neither's: either would refuse the other in the + // game. Its files stay outside both. + let claims = records.iter().filter(|r| chosen(r)).filter_map(|r| { + let (jar, info) = (r.jar.as_ref()?, r.info.as_ref()?); + let owned = carry::namespaces_claimed(jar, &info.mod_id, &|m| in_pack.contains(m)).ok()?; + Some((r.key.as_str(), owned)) + }); + let shared = shared_namespaces(claims, log); + let in_pack = |m: &str| in_pack.contains(m) || shared.contains(m); let pack = carry::Pack { loaded: &loaded, mods: &in_pack, @@ -219,6 +228,61 @@ pub fn carry( Ok(done) } +/// Which carried-over mods (`mods/<key>/carry` folders) the game loads together, in the order +/// given: as the game does, the first of two owning one namespace stays on. Returns the ones on, +/// and a line for each one left off. +pub fn loadable(mods: &[std::path::PathBuf]) -> (Vec<std::path::PathBuf>, Vec<String>) { + let mut on: Vec<(std::path::PathBuf, String, Vec<String>)> = Vec::new(); + let mut off = Vec::new(); + for path in mods { + let manifest = fs::read_to_string(path.join(horizon_mods::manifest::MANIFEST)) + .map_err(|e| e.to_string()) + .and_then(|t| horizon_mods::Manifest::parse(&t)); + let m = match manifest { + Ok(m) => m, + Err(e) => { + off.push(format!("{}: {e}", path.display())); + continue; + } + }; + let owned: Vec<String> = std::iter::once(m.id.clone()) + .chain(m.namespaces.iter().cloned()) + .collect(); + let clash = on + .iter() + .find_map(|(_, id, ns)| horizon_mods::content::clash((id, ns), (&m.id, &owned))); + match clash { + Some(why) => off.push(format!("{} not loaded: {why}", m.id)), + None => on.push((path.clone(), m.id, owned)), + } + } + (on.into_iter().map(|(p, _, _)| p).collect(), off) +} + +/// The namespaces more than one mod claims, from each mod's (key, claimed namespaces). +fn shared_namespaces<'a>( + claims: impl Iterator<Item = (&'a str, Vec<String>)>, + log: Log, +) -> BTreeSet<String> { + let mut by_namespace: BTreeMap<String, Vec<&str>> = BTreeMap::new(); + for (key, owned) in claims { + for ns in owned { + by_namespace.entry(ns).or_default().push(key); + } + } + by_namespace + .into_iter() + .filter(|(_, mods)| mods.len() > 1) + .map(|(ns, mods)| { + log(format!( + "namespace {ns} is claimed by {}: left to none of them", + mods.join(", ") + )); + ns + }) + .collect() +} + /// The pack's title as the report heads it. pub fn title(pack: &import::Pack) -> String { format!( @@ -279,3 +343,51 @@ pub fn port( } Ok((fetched, report(work, log)?)) } + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn a_namespace_two_mods_claim_is_neither_s() { + let claims = [ + ("betterdungeons", vec!["yungsapi".to_owned()]), + ("betterfortresses", vec!["yungsapi".to_owned()]), + ( + "towns_and_towers", + vec!["kaisyn".to_owned(), "towns_and_towers".to_owned()], + ), + ]; + let shared = shared_namespaces(claims.into_iter(), &|_| {}); + assert_eq!(shared.into_iter().collect::<Vec<_>>(), ["yungsapi"]); + } + + #[test] + fn the_first_of_two_mods_owning_a_namespace_loads() { + let root = std::env::temp_dir().join(format!("port-pack-loadable-{}", std::process::id())); + let _ = fs::remove_dir_all(&root); + let carry = |key: &str, namespaces: &str| { + let dir = root.join(key).join("carry"); + fs::create_dir_all(&dir).unwrap(); + fs::write( + dir.join("horizon-mod.toml"), + format!( + "id = \"{key}\"\nname = \"{key}\"\nversion = \"1\"\napi = \"0.2\"\n\ + capabilities = [\"registries\"]\nnamespaces = [{namespaces}]\n" + ), + ) + .unwrap(); + dir + }; + let mods = [ + carry("betterdungeons", "\"yungsapi\""), + carry("betterfortresses", "\"yungsapi\""), + carry("ruby", ""), + ]; + let (on, off) = loadable(&mods); + assert_eq!(on, [mods[0].clone(), mods[2].clone()]); + assert_eq!(off.len(), 1); + assert!(off[0].starts_with("betterfortresses not loaded"), "{off:?}"); + fs::remove_dir_all(&root).unwrap(); + } +} diff --git a/docs/mod-browser.md b/docs/mod-browser.md index 74959ab4c..8c29e0dd6 100644 --- a/docs/mod-browser.md +++ b/docs/mod-browser.md @@ -118,15 +118,20 @@ same name the player put there is never overwritten. Packs, as in vanilla and Iris. - **Update** installs the newer version and removes the old file. - **Remove** deletes the file and its entry. Packs installed as dependencies stay. -- **A modpack** is downloaded (checked the same way) into `ports/downloads/` and imported; the Modpacks tab says - what of it Horizon runs and ports it. +- **A modpack** is downloaded (checked the same way) into `ports/downloads/`, imported, and ported straight away + for the selected version when it is prepared (`modpacks::import_and_port`): the jars of the mods Horizon can carry + over come from the pack's links or Modrinth, and the message says how many of its files play. **Play** on the + Modpacks tab starts it with every ported mod on together. A ported mod that owns a namespace an earlier one owns + (the game would refuse it) is left off before the game starts and listed under the pack ("Left off: ..."); the + coverage list says why each mod that didn't port didn't. A port that fails leaves the pack imported, with **Port** + to try again. Measured on three packs in [modpacks.md](modpacks.md#three-packs-through-the-mod-browser-measured). From a terminal (or an agent): ```sh horizon-launcher mods search faithful # --kind mod|modpack|resource|shader, --everything, --source horizon-launcher mods check macaws-fences-and-walls # a Java mod's verdict, what ports and what doesn't (--json) -horizon-launcher mods install faithful-32x # id or slug; a Java mod is ported, a modpack imported +horizon-launcher mods install faithful-32x # id or slug; a Java mod is ported, a modpack imported and ported horizon-launcher mods list # --json horizon-launcher mods update [faithful-32x] [--check] horizon-launcher mods remove faithful-32x diff --git a/docs/modpacks.md b/docs/modpacks.md index d062eb941..e233f176c 100644 --- a/docs/modpacks.md +++ b/docs/modpacks.md @@ -240,6 +240,10 @@ How the game loads them, without touching vanilla's path: when its Java original ships them so (`namespaces = ["kaisyn", "towns_and_towers"]` for Towns and Towers, mod id `t_and_t`; docs/mods.md). No namespace has two owners: a mod whose id or listed namespace another mod that is on already owns is left out, with both named in the log. + `horizon-port-pack` avoids that inside a pack: a namespace two carried mods both claim (YUNG's + structure mods all ship files under `yungsapi`, the namespace of YUNG's API, whose own jar isn't + carried) is left to none of them, and its files stay outside. The launcher applies the game's + rule before it starts a pack (`pipeline::loadable`) and lists what it left off. - The overlay is built on the first start with a set of mods and kept for later starts. A stamp (`horizon-mod-content.stamp`) hashes the game executable, the base tables and every mod file's size and mtime. Adding, removing or editing a mod, or a new build of Horizon, rebuilds it. For @@ -1047,6 +1051,31 @@ What is missing, ranked by how much a player notices: 6. **Smaller gaps:** Mo' Structures' mixin that keeps lakes out of its structures and its two block-ageing processors, and the 5 missing block models. +### Three packs through the mod browser, measured + +2026-10-22, Mac mini M4 Pro (offscreen, a debug launcher, release-profile `horizon-port-pack` and game), while +other sessions kept the CPU at 85 to 93 %, so times are upper bounds. The two Modrinth packs were imported with +`horizon-launcher mods install <slug>` (the browser's Import), ATM10 from its CurseForge zip with `modpack import` +(CurseForge isn't searchable without a key), then each ported with `--resources` for 26.3 and opened as a survival +world with every ported mod on (horizon-ctl `launch --dev-mod ...`, from a scratch script). + +| Pack | Files | Import | Port | Ported mods | Coverage | Declared | World load (resources) | Crashes | +|---|---|---|---|---|---|---|---|---| +| Vanilla Perfected 26.3 (Fabric, small) | 108 | 30.4 s | 1.0 s | 2 | 2 partial, 79 not yet, 27 not needed | 0 blocks (a trail effect, a torch-flower texture) | 5.2 s (2.1 s) | none | +| Slimes Adventure 1.13.4 (Fabric 1.21.1, medium) | 105 | 18.8 s | 22.8 s | 20 | 20 partial, 46 not yet, 39 not needed | 8,208 blocks, 41 items, 1,376 recipes | 23.0 s (15.0 s) | none | +| All the Mods 10 8.3 (NeoForge 1.21.1, CurseForge zip) | 496 | 3.1 s | 29.4 s | 42 | 42 partial, 333 not yet, 121 not needed | 10,000 blocks, 1,273 items, 4,178 recipes | 38.3 s (28.7 s) | none | + +The same world with no mods loads in 5.4 s (resources 1.1 s). Import is the pack download and Modrinth's answers by +file hash; Vanilla Perfected's 30 s is mostly its 108 lookups and its download. Port is the jars (downloaded for the +two Modrinth packs; ATM10's 42 copied from a folder, 12 more are on CurseForge only and need its key) and the carry, +which writes tens of thousands of small files. World load grows with the blocks the pack declares: ATM10 adds +about 155,000 block states, and loading their models and textures is most of its 28.7 s. + +Every world loaded and stayed up, with no panic and no error in the log. Before the namespace fix above, Slimes +Adventure lost three of YUNG's mods at start ("both use the namespace yungsapi"); after it all 20 load. As a share of +the mods that need porting (not counting performance mods and libraries), 2 of 81 ported partly, 20 of 66 and 42 of +375. Every ported mod is Partial: their Java code (block entities, entities, Mixins) doesn't come along. + ## Open questions for Ludovic - Contacting authors of permissively licensed mods to publish ports (none contacted). diff --git a/launcher/src/cli.rs b/launcher/src/cli.rs index ebcc95cd6..089cf8284 100644 --- a/launcher/src/cli.rs +++ b/launcher/src/cli.rs @@ -1053,13 +1053,13 @@ fn mods(action: ModsCmd, as_json: bool) -> Result<(), String> { let file = installed::fetch_modpack(&*source, &p, &folder, &progress(p.title.clone()))?; let log = &|line: String| eprintln!("{line}"); - let pack = modpacks::import(&file, log)?; - println!( - "Imported {} ({}): horizon-launcher modpack port {}", - pack.title(), - pack.summary(), - pack.slug - ); + let resources = backend::resolve_version(None) + .ok() + .filter(|t| backend::is_prepared(t)) + .map(|t| backend::resources(&t)); + let pack = modpacks::import_and_port(&file, resources.as_deref(), log)?; + println!("{} ({})", modpacks::outcome(&pack), pack.summary()); + println!("Play it: horizon-launcher modpack play {}", pack.slug); return Ok(()); } let done = installed::install(&*source, &p, everything, &home, &line)?; diff --git a/launcher/src/modpacks.rs b/launcher/src/modpacks.rs index 2495e1ad6..67325e624 100644 --- a/launcher/src/modpacks.rs +++ b/launcher/src/modpacks.rs @@ -45,6 +45,8 @@ pub struct Imported { pub fetched: Fetched, /// The carried-over mods the profile loads. pub mods: Vec<PathBuf>, + /// Carried-over mods left off because an earlier one owns a namespace of theirs, with why. + pub left_off: Vec<String>, /// The mods the port step gets and carries over (content, data tier). pub portable: usize, } @@ -105,6 +107,7 @@ pub fn load(work: &Path) -> Result<Imported, String> { let rows: Vec<Row> = pipeline::read_json(&work.join("coverage.json")).unwrap_or_default(); let records: Vec<horizon_port_pack::inventory::Record> = pipeline::read_json(&work.join("inventory.json")).unwrap_or_default(); + let (mods, left_off) = pipeline::loadable(&carried(work)); Ok(Imported { slug: work .file_name() @@ -114,7 +117,8 @@ pub fn load(work: &Path) -> Result<Imported, String> { pack, rows, fetched: Fetched::load(work), - mods: carried(work), + mods, + left_off, portable: records.iter().filter(|r| pipeline::portable(r)).count(), }) } @@ -176,6 +180,47 @@ pub fn port( load(work) } +/// What the mod browser does with a modpack: imports it, then ports what this computer can +/// (from the pack's links and Modrinth), so it plays straight away. A port that fails leaves the +/// pack imported; the error says so. +pub fn import_and_port( + path: &Path, + resources: Option<&Path>, + log: Log, +) -> Result<Imported, String> { + let pack = import(path, log)?; + if pack.portable == 0 { + return Ok(pack); + } + port(&pack.work, resources, None, log) + .map_err(|e| format!("{} is imported, but porting it failed: {e}", pack.title())) +} + +/// One line on what an import and port gave: the mods carried over and the ones that weren't. +pub fn outcome(pack: &Imported) -> String { + let not = pack.count(Status::NotYet); + format!( + "{} is imported{}: {} of its {} files play in Horizon ({} ported, {} partly), {} don't \ + yet, {} aren't needed{}. Its list says why.", + pack.title(), + if pack.mods.is_empty() { + "" + } else { + " and ported" + }, + pack.count(Status::Ported) + pack.count(Status::Partial), + pack.rows.len(), + pack.count(Status::Ported), + pack.count(Status::Partial), + not, + pack.count(Status::NotNeeded), + match pack.left_off.len() { + 0 => String::new(), + n => format!("; {n} ported mods are left off, sharing a namespace with another"), + }, + ) +} + /// Removes an imported pack: its jars, ports and the profile's saves. pub fn remove(work: &Path) -> Result<(), String> { if work.parent() != Some(ports_dir().as_path()) { @@ -192,7 +237,8 @@ pub fn profile_home(work: &Path) -> PathBuf { /// Turns the game's command into this pack's profile: its own home (the player's options.txt /// copied in the first time, so keys and video settings carry over) and its carried-over mods. pub fn apply_profile(cmd: &mut Command, work: &Path) -> Result<(), String> { - let mods = carried(work); + // Only mods that load together: the game would refuse the later of two sharing a namespace. + let (mods, _) = pipeline::loadable(&carried(work)); if mods.is_empty() { return Err("Nothing is ported yet: port the pack first.".into()); } @@ -229,12 +275,19 @@ mod tests { let work = root.join("ports/small"); let mut cmd = Command::new("true"); assert!(apply_profile(&mut cmd, &work).is_err()); - for id in ["a", "b"] { + for (id, namespaces) in [("a", ""), ("b", ""), ("d", "\"a\"")] { let carry = work.join("mods").join(id).join("carry"); fs::create_dir_all(&carry).unwrap(); - fs::write(carry.join("horizon-mod.toml"), "").unwrap(); + fs::write( + carry.join("horizon-mod.toml"), + format!( + "id = \"{id}\"\nname = \"{id}\"\nversion = \"1\"\napi = \"0.2\"\n\ + capabilities = [\"registries\"]\nnamespaces = [{namespaces}]\n" + ), + ) + .unwrap(); } - // Left out: no manifest. + // Left out: no manifest (c), and one owning a namespace of an earlier mod (d). fs::create_dir_all(work.join("mods/c/carry")).unwrap(); apply_profile(&mut cmd, &work).unwrap(); let args: Vec<String> = cmd diff --git a/launcher/src/modpacks_page.rs b/launcher/src/modpacks_page.rs index b776321b3..f3e2f1d7b 100644 --- a/launcher/src/modpacks_page.rs +++ b/launcher/src/modpacks_page.rs @@ -327,6 +327,9 @@ impl Launcher { if let Some(jars) = p.jars() { notes.push(jars); } + for line in &p.left_off { + notes.push(format!("Left off: {line}.")); + } if !can_play { notes.push("Playing needs a prepared Horizon version (Play page).".into()); } diff --git a/launcher/src/mods_page.rs b/launcher/src/mods_page.rs index e66c02490..214048519 100644 --- a/launcher/src/mods_page.rs +++ b/launcher/src/mods_page.rs @@ -294,6 +294,11 @@ impl Launcher { self.mods.busy = Some((id.clone(), format!("Asking {}…", source.label()), 0.)); self.mods.updates.remove(&(source, id.clone())); let everything = self.mods.everything || self.mods.browse.filters.other_version(); + // A modpack is ported for the selected version as soon as it is imported. + let resources = self + .selected() + .filter(|tag| backend::is_prepared(tag)) + .map(|tag| backend::resources(tag)); let tx = self.mods.tx.clone(); std::thread::spawn(move || { let last = std::cell::Cell::new(-1); @@ -318,10 +323,10 @@ impl Launcher { progress(&p.title, f) })?; let log = |line: String| progress(&line, 1.); - let pack = modpacks::import(&file, &log)?; + let pack = modpacks::import_and_port(&file, resources.as_deref(), &log)?; return Ok(format!( - "{} is imported: it is listed above, ready to port.", - pack.title() + "{} Play it from the list above.", + modpacks::outcome(&pack) )); } let home = backend::game_home(); diff --git a/website/docs/modpacks.md b/website/docs/modpacks.md index e3ed053d9..a1aa1e2ea 100644 --- a/website/docs/modpacks.md +++ b/website/docs/modpacks.md @@ -8,7 +8,7 @@ Java mod jars do not run in Horizon. Instead, the launcher reads a modpack, tell Open **Modpacks** in the launcher. (From the next launcher release, it is the **Modpacks** tab of the **Mods** page.) -1. **Import a pack.** Choose **Import a pack file…** for a Modrinth `.mrpack` or a CurseForge zip, or **Import an instance folder…** for a Prism, MultiMC or CurseForge instance. The **Mods** page can also find a Modrinth modpack and import it for you (see [Mods and data packs](/docs/mods#finding-resource-packs-shader-packs-and-modpacks)). +1. **Import a pack.** Choose **Import a pack file…** for a Modrinth `.mrpack` or a CurseForge zip, or **Import an instance folder…** for a Prism, MultiMC or CurseForge instance. The **Mods** page can also find a Modrinth modpack and import it for you (see [Mods and data packs](/docs/mods#finding-resource-packs-shader-packs-and-modpacks)). From the next launcher release it also ports it in the same step, so you can press **Play** right away. 2. **Read the coverage report.** For every mod in the pack it says **Ported**, **Partial**, **Not yet** or **Not needed**, with the reason. You can filter the list by status. 3. **Port.** **Port N mods** gets the jars of the mods this computer can carry over today, and carries them over for the version you picked. It copies the jars from a folder you have, or downloads them from the pack's own links (or the same file from Modrinth's download network), and checks their hashes. CurseForge downloads are coming soon, so for files that only CurseForge has, choose **Use jars from my instance…** and point it at your installed instance. 4. **Play.** **Play with N mods** starts the game as the pack's own profile, with its own saves and options, and those mods on. @@ -29,6 +29,10 @@ Nothing is uploaded or shared. The mod jars and what is made from them stay on y So a pack is a list of mods, and today Horizon can bring over a part of that list. The coverage report is the honest answer for your pack. +If two ported mods use the same namespace, the game can only load one of them. The launcher keeps the first, leaves the other off, and lists it under the pack. + +Measured on three packs: Vanilla Perfected (108 files) ports 2 mods, Slimes Adventure (105) ports 20, and All the Mods 10 (496) ports 42. Each opens a world, with no crash. Every ported mod is partial: its blocks, items, recipes and structures come over, its Java code doesn't. A world with All the Mods 10's 42 ported mods takes about 40 seconds to load, against about 5 without mods. + ## Example: All the Mods 10 All the Mods 10 has 495 jars. Horizon's report sorts them: about 290 add content, 80 are libraries, and the rest are integrations, interface mods, tools and performance mods. A few dozen of the content mods carry over today. The measured numbers are in [docs/modpacks.md](https://github.com/ludovic111/horizon/blob/main/docs/modpacks.md). From da991045f9e30c210cf8168b213849b76d18b3a9 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 18:54:33 +0200 Subject: [PATCH 044/126] Modpacks: jars only CurseForge serves are left off, "CurseForge downloads coming soon" The pack lists them with the mods left off, the port's log and fetch label say the same, and docs/modpacks.md no longer asks for a key. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/fetch.rs | 6 ++-- docs/modpacks.md | 12 +++---- launcher/src/modpacks.rs | 45 ++++++++++++++++++++++++--- 3 files changed, 50 insertions(+), 13 deletions(-) diff --git a/crates/horizon-port-pack/src/fetch.rs b/crates/horizon-port-pack/src/fetch.rs index f8f7b2dc7..f2803baa2 100644 --- a/crates/horizon-port-pack/src/fetch.rs +++ b/crates/horizon-port-pack/src/fetch.rs @@ -40,7 +40,7 @@ pub enum How { Downloaded, /// Copied from the player's folder. Local, - /// Only on CurseForge, whose downloads need an API key. + /// Only on CurseForge, whose downloads are coming soon (its API needs a paid key). NeedsKey, NotFound, Failed, @@ -52,7 +52,7 @@ impl How { How::Present => "already here", How::Downloaded => "downloaded", How::Local => "copied from your folder", - How::NeedsKey => "needs a CurseForge key", + How::NeedsKey => "CurseForge downloads coming soon", How::NotFound => "not found", How::Failed => "failed", } @@ -163,7 +163,7 @@ pub fn fetch( } write_json(&work.join("fetch.json"), &fetched)?; log(format!( - "jars: {} downloaded, {} copied, {} already here, {} need a CurseForge key, {} not found, {} failed", + "jars: {} downloaded, {} copied, {} already here, {} on CurseForge only (CurseForge downloads coming soon), {} not found, {} failed", fetched.count(How::Downloaded), fetched.count(How::Local), fetched.count(How::Present), diff --git a/docs/modpacks.md b/docs/modpacks.md index e233f176c..c15d0767e 100644 --- a/docs/modpacks.md +++ b/docs/modpacks.md @@ -326,8 +326,8 @@ Fabric API doesn't run (its id has a dash, which content mods can't use). A chec by SHA-1, or through a CurseForge app instance's `minecraftinstance.json`), else downloaded from the link the pack itself gives (a `.mrpack`'s, on the format's hosts only) or, for a CurseForge pack, the same file on Modrinth's public CDN, found by its SHA-1. A jar is kept only when its -hash matches. A file only CurseForge has is listed as needing a CurseForge API key (Ludovic's -decision; open question below), with the player's installed instance as the way round it. +hash matches. A file only CurseForge has is listed as "CurseForge downloads coming soon" (its API +needs a paid key; Ludovic, 2026-10-22), with the player's installed instance as the way round it. `<work>/fetch.json` says what happened to each file. On All the Mods 10 8.3's CurseForge zip (2026-10-17): of the 54 data-tier content mods, 42 come from Modrinth's CDN (84 MB) and 12 need the key or the instance; `port` then carries the 42 over (0 ported, 42 partial: the harness is a @@ -1056,7 +1056,7 @@ What is missing, ranked by how much a player notices: 2026-10-22, Mac mini M4 Pro (offscreen, a debug launcher, release-profile `horizon-port-pack` and game), while other sessions kept the CPU at 85 to 93 %, so times are upper bounds. The two Modrinth packs were imported with `horizon-launcher mods install <slug>` (the browser's Import), ATM10 from its CurseForge zip with `modpack import` -(CurseForge isn't searchable without a key), then each ported with `--resources` for 26.3 and opened as a survival +(CurseForge support is coming soon), then each ported with `--resources` for 26.3 and opened as a survival world with every ported mod on (horizon-ctl `launch --dev-mod ...`, from a scratch script). | Pack | Files | Import | Port | Ported mods | Coverage | Declared | World load (resources) | Crashes | @@ -1067,7 +1067,7 @@ world with every ported mod on (horizon-ctl `launch --dev-mod ...`, from a scrat The same world with no mods loads in 5.4 s (resources 1.1 s). Import is the pack download and Modrinth's answers by file hash; Vanilla Perfected's 30 s is mostly its 108 lookups and its download. Port is the jars (downloaded for the -two Modrinth packs; ATM10's 42 copied from a folder, 12 more are on CurseForge only and need its key) and the carry, +two Modrinth packs; ATM10's 42 copied from a folder, 12 more are on CurseForge only: CurseForge downloads coming soon) and the carry, which writes tens of thousands of small files. World load grows with the blocks the pack declares: ATM10 adds about 155,000 block states, and loading their models and textures is most of its 28.7 s. @@ -1081,5 +1081,5 @@ the mods that need porting (not counting performance mods and libraries), 2 of 8 - Contacting authors of permissively licensed mods to publish ports (none contacted). - Whether players should run code-port agents themselves (their own Claude Code or Codex login, as Zenith does) or only download published ports. -- A CurseForge API key for the launcher (CurseForge grants them to launchers on request). Until - then, CurseForge packs import from an installed instance. +- CurseForge: dropped for now (its API needs a paid key; Ludovic, 2026-10-22), shown as coming + soon. CurseForge packs import from their zip or an installed instance. diff --git a/launcher/src/modpacks.rs b/launcher/src/modpacks.rs index 67325e624..909c6cfae 100644 --- a/launcher/src/modpacks.rs +++ b/launcher/src/modpacks.rs @@ -45,7 +45,8 @@ pub struct Imported { pub fetched: Fetched, /// The carried-over mods the profile loads. pub mods: Vec<PathBuf>, - /// Carried-over mods left off because an earlier one owns a namespace of theirs, with why. + /// Mods left off, with why: a ported one an earlier one owns a namespace of, or one whose + /// jar only CurseForge serves (CurseForge downloads coming soon). pub left_off: Vec<String>, /// The mods the port step gets and carries over (content, data tier). pub portable: usize, @@ -107,7 +108,15 @@ pub fn load(work: &Path) -> Result<Imported, String> { let rows: Vec<Row> = pipeline::read_json(&work.join("coverage.json")).unwrap_or_default(); let records: Vec<horizon_port_pack::inventory::Record> = pipeline::read_json(&work.join("inventory.json")).unwrap_or_default(); - let (mods, left_off) = pipeline::loadable(&carried(work)); + let (mods, mut left_off) = pipeline::loadable(&carried(work)); + let fetched = Fetched::load(work); + left_off.extend( + fetched + .files + .iter() + .filter(|o| o.how == How::NeedsKey) + .map(|o| format!("{}: CurseForge downloads coming soon", o.key)), + ); Ok(Imported { slug: work .file_name() @@ -116,7 +125,7 @@ pub fn load(work: &Path) -> Result<Imported, String> { work: work.to_path_buf(), pack, rows, - fetched: Fetched::load(work), + fetched, mods, left_off, portable: records.iter().filter(|r| pipeline::portable(r)).count(), @@ -216,7 +225,7 @@ pub fn outcome(pack: &Imported) -> String { pack.count(Status::NotNeeded), match pack.left_off.len() { 0 => String::new(), - n => format!("; {n} ported mods are left off, sharing a namespace with another"), + n => format!("; {n} are left off (listed under the pack)"), }, ) } @@ -267,6 +276,34 @@ mod tests { assert_eq!(slug(" "), "pack"); } + #[test] + fn jars_only_curseforge_serves_are_left_off_as_coming_soon() { + use horizon_port_pack::fetch::Outcome; + let work = std::env::temp_dir().join(format!("horizon-launcher-cf-{}", std::process::id())); + let _ = fs::remove_dir_all(&work); + fs::create_dir_all(&work).unwrap(); + pipeline::write_json(&work.join("pack.json"), &Pack::default()).unwrap(); + let fetched = Fetched { + files: vec![Outcome { + key: "allthemodium".into(), + file: "mods/allthemodium.jar".into(), + how: How::NeedsKey, + detail: String::new(), + }], + }; + pipeline::write_json(&work.join("fetch.json"), &fetched).unwrap(); + let pack = load(&work).unwrap(); + assert_eq!( + pack.left_off, + ["allthemodium: CurseForge downloads coming soon"] + ); + assert!(pack + .jars() + .unwrap() + .contains("CurseForge downloads coming soon")); + fs::remove_dir_all(&work).unwrap(); + } + #[test] fn a_profile_has_its_own_home_and_mods() { let root = From 70c06224fee8b7115bb0f086e681fcd9e3b636d8 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 19:29:41 +0200 Subject: [PATCH 045/126] Website: the Blocks look, a blocky Minecraft-like design in Horizon's purple horizon-theme gains the Blocks palettes (light and dark, WCAG AA on every panel and on the stone), Pixelify Sans (OFL) and Pixelarticons (MIT); tokens.css now carries the Blocks colours, the pixel font and the block edges. The site sets headings, navigation and buttons in Pixelify Sans, turns the index lists into stacks of panels with an outline, a bevel and a lip, puts a stone texture behind the page and Horizon's pixel landscape (a dawn or a sunset) behind the hero, both drawn in code by scripts/art.mjs. Light and dark still follow the system, with the toggle. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- THIRD_PARTY_NOTICES.md | 12 + crates/horizon-theme/Cargo.toml | 2 +- .../horizon-theme/fonts/OFL-PixelifySans.txt | 93 ++++++ .../horizon-theme/fonts/PixelifySans-Bold.ttf | Bin 0 -> 95056 bytes .../fonts/PixelifySans-Medium.ttf | Bin 0 -> 94248 bytes .../fonts/PixelifySans-SemiBold.ttf | Bin 0 -> 97492 bytes .../icons/pixel/LICENSE-pixelarticons.txt | 21 ++ crates/horizon-theme/icons/pixel/archive.svg | 3 + .../horizon-theme/icons/pixel/arrow-left.svg | 4 + .../horizon-theme/icons/pixel/book-open.svg | 3 + crates/horizon-theme/icons/pixel/box.svg | 4 + crates/horizon-theme/icons/pixel/bug.svg | 5 + crates/horizon-theme/icons/pixel/check.svg | 3 + .../icons/pixel/chevron-down.svg | 3 + .../icons/pixel/chevron-right.svg | 3 + crates/horizon-theme/icons/pixel/clock.svg | 3 + crates/horizon-theme/icons/pixel/close.svg | 3 + crates/horizon-theme/icons/pixel/download.svg | 5 + .../icons/pixel/external-link.svg | 4 + crates/horizon-theme/icons/pixel/folder.svg | 3 + crates/horizon-theme/icons/pixel/gamepad.svg | 4 + crates/horizon-theme/icons/pixel/globe.svg | 4 + crates/horizon-theme/icons/pixel/heart.svg | 3 + crates/horizon-theme/icons/pixel/home.svg | 3 + crates/horizon-theme/icons/pixel/image.svg | 4 + crates/horizon-theme/icons/pixel/info-box.svg | 3 + crates/horizon-theme/icons/pixel/message.svg | 3 + crates/horizon-theme/icons/pixel/monitor.svg | 3 + crates/horizon-theme/icons/pixel/notes.svg | 4 + crates/horizon-theme/icons/pixel/package.svg | 4 + crates/horizon-theme/icons/pixel/play.svg | 3 + crates/horizon-theme/icons/pixel/plus.svg | 3 + crates/horizon-theme/icons/pixel/reload.svg | 5 + crates/horizon-theme/icons/pixel/search.svg | 3 + crates/horizon-theme/icons/pixel/server.svg | 3 + crates/horizon-theme/icons/pixel/sliders.svg | 1 + crates/horizon-theme/icons/pixel/terminal.svg | 3 + crates/horizon-theme/icons/pixel/trash.svg | 3 + crates/horizon-theme/icons/pixel/user.svg | 3 + crates/horizon-theme/icons/pixel/zap.svg | 3 + crates/horizon-theme/src/lib.rs | 275 +++++++++++++++++- docs/design-system.md | 33 ++- website/LEGAL.md | 14 +- website/README.md | 9 +- website/public/fonts/OFL-PixelifySans.txt | 93 ++++++ website/public/fonts/PixelifySans-Bold.woff2 | Bin 0 -> 27276 bytes .../public/fonts/PixelifySans-Medium.woff2 | Bin 0 -> 27308 bytes .../public/fonts/PixelifySans-SemiBold.woff2 | Bin 0 -> 27796 bytes website/public/media/scene-dark.png | Bin 0 -> 757 bytes website/public/media/scene-light.png | Bin 0 -> 758 bytes website/public/media/stone-dark.png | Bin 0 -> 1400 bytes website/public/media/stone-light.png | Bin 0 -> 1413 bytes website/scripts/art.mjs | 151 ++++++++++ website/scripts/assets.mjs | 11 +- website/src/404.html | 4 +- website/src/docs.html | 4 +- website/src/index.html | 11 +- website/src/privacy.html | 4 +- website/src/style.css | 134 ++++++++- website/src/tokens.css | 96 ++++-- 60 files changed, 1019 insertions(+), 59 deletions(-) create mode 100644 crates/horizon-theme/fonts/OFL-PixelifySans.txt create mode 100644 crates/horizon-theme/fonts/PixelifySans-Bold.ttf create mode 100644 crates/horizon-theme/fonts/PixelifySans-Medium.ttf create mode 100644 crates/horizon-theme/fonts/PixelifySans-SemiBold.ttf create mode 100644 crates/horizon-theme/icons/pixel/LICENSE-pixelarticons.txt create mode 100644 crates/horizon-theme/icons/pixel/archive.svg create mode 100644 crates/horizon-theme/icons/pixel/arrow-left.svg create mode 100644 crates/horizon-theme/icons/pixel/book-open.svg create mode 100644 crates/horizon-theme/icons/pixel/box.svg create mode 100644 crates/horizon-theme/icons/pixel/bug.svg create mode 100644 crates/horizon-theme/icons/pixel/check.svg create mode 100644 crates/horizon-theme/icons/pixel/chevron-down.svg create mode 100644 crates/horizon-theme/icons/pixel/chevron-right.svg create mode 100644 crates/horizon-theme/icons/pixel/clock.svg create mode 100644 crates/horizon-theme/icons/pixel/close.svg create mode 100644 crates/horizon-theme/icons/pixel/download.svg create mode 100644 crates/horizon-theme/icons/pixel/external-link.svg create mode 100644 crates/horizon-theme/icons/pixel/folder.svg create mode 100644 crates/horizon-theme/icons/pixel/gamepad.svg create mode 100644 crates/horizon-theme/icons/pixel/globe.svg create mode 100644 crates/horizon-theme/icons/pixel/heart.svg create mode 100644 crates/horizon-theme/icons/pixel/home.svg create mode 100644 crates/horizon-theme/icons/pixel/image.svg create mode 100644 crates/horizon-theme/icons/pixel/info-box.svg create mode 100644 crates/horizon-theme/icons/pixel/message.svg create mode 100644 crates/horizon-theme/icons/pixel/monitor.svg create mode 100644 crates/horizon-theme/icons/pixel/notes.svg create mode 100644 crates/horizon-theme/icons/pixel/package.svg create mode 100644 crates/horizon-theme/icons/pixel/play.svg create mode 100644 crates/horizon-theme/icons/pixel/plus.svg create mode 100644 crates/horizon-theme/icons/pixel/reload.svg create mode 100644 crates/horizon-theme/icons/pixel/search.svg create mode 100644 crates/horizon-theme/icons/pixel/server.svg create mode 100644 crates/horizon-theme/icons/pixel/sliders.svg create mode 100644 crates/horizon-theme/icons/pixel/terminal.svg create mode 100644 crates/horizon-theme/icons/pixel/trash.svg create mode 100644 crates/horizon-theme/icons/pixel/user.svg create mode 100644 crates/horizon-theme/icons/pixel/zap.svg create mode 100644 website/public/fonts/OFL-PixelifySans.txt create mode 100644 website/public/fonts/PixelifySans-Bold.woff2 create mode 100644 website/public/fonts/PixelifySans-Medium.woff2 create mode 100644 website/public/fonts/PixelifySans-SemiBold.woff2 create mode 100644 website/public/media/scene-dark.png create mode 100644 website/public/media/scene-light.png create mode 100644 website/public/media/stone-dark.png create mode 100644 website/public/media/stone-light.png create mode 100644 website/scripts/art.mjs diff --git a/THIRD_PARTY_NOTICES.md b/THIRD_PARTY_NOTICES.md index 368813ecf..88d3197af 100644 --- a/THIRD_PARTY_NOTICES.md +++ b/THIRD_PARTY_NOTICES.md @@ -36,3 +36,15 @@ SOFTWARE. developers, with one upstream fix applied ([gfx-rs/wgpu#10124](https://github.com/gfx-rs/wgpu/pull/10124)). It is licensed under MIT or Apache-2.0; both licenses are in that folder (`LICENSE.MIT`, `LICENSE.APACHE`). + +## Pixelify Sans + +`crates/horizon-theme/fonts/PixelifySans-*.ttf` is [Pixelify Sans](https://github.com/eifetx/Pixelify-Sans) +by The Pixelify Sans Project Authors, licensed under the SIL Open Font License 1.1 +(`crates/horizon-theme/fonts/OFL-PixelifySans.txt`). + +## Pixelarticons + +`crates/horizon-theme/icons/pixel/*.svg` are icons from +[Pixelarticons](https://github.com/halfmage/pixelarticons) by Gerrit Halfmann, under the MIT +license (`crates/horizon-theme/icons/pixel/LICENSE-pixelarticons.txt`). diff --git a/crates/horizon-theme/Cargo.toml b/crates/horizon-theme/Cargo.toml index a2fc2eead..3cc6d2324 100644 --- a/crates/horizon-theme/Cargo.toml +++ b/crates/horizon-theme/Cargo.toml @@ -3,6 +3,6 @@ name = "horizon-theme" version = "0.1.0" edition = "2021" license = "MIT" -description = "Horizon's design tokens and fonts, shared by the launcher and the game's menus" +description = "Horizon's design tokens, fonts and icons, shared by the launcher, the website and the game's menus" [dependencies] diff --git a/crates/horizon-theme/fonts/OFL-PixelifySans.txt b/crates/horizon-theme/fonts/OFL-PixelifySans.txt new file mode 100644 index 000000000..6aa5bfbae --- /dev/null +++ b/crates/horizon-theme/fonts/OFL-PixelifySans.txt @@ -0,0 +1,93 @@ +Copyright 2021 The Pixelify Sans Project Authors (https://github.com/eifetx/Pixelify-Sans) + +This Font Software is licensed under the SIL Open Font License, Version 1.1. +This license is copied below, and is also available with a FAQ at: +https://scripts.sil.org/OFL + + +----------------------------------------------------------- +SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007 +----------------------------------------------------------- + +PREAMBLE +The goals of the Open Font License (OFL) are to stimulate worldwide +development of collaborative font projects, to support the font creation +efforts of academic and linguistic communities, and to provide a free and +open framework in which fonts may be shared and improved in partnership +with others. + +The OFL allows the licensed fonts to be used, studied, modified and +redistributed freely as long as they are not sold by themselves. The +fonts, including any derivative works, can be bundled, embedded, +redistributed and/or sold with any software provided that any reserved +names are not used by derivative works. The fonts and derivatives, +however, cannot be released under any other type of license. The +requirement for fonts to remain under this license does not apply +to any document created using the fonts or their derivatives. + +DEFINITIONS +"Font Software" refers to the set of files released by the Copyright +Holder(s) under this license and clearly marked as such. This may +include source files, build scripts and documentation. + +"Reserved Font Name" refers to any names specified as such after the +copyright statement(s). + +"Original Version" refers to the collection of Font Software components as +distributed by the Copyright Holder(s). + +"Modified Version" refers to any derivative made by adding to, deleting, +or substituting -- in part or in whole -- any of the components of the +Original Version, by changing formats or by porting the Font Software to a +new environment. + +"Author" refers to any designer, engineer, programmer, technical +writer or other person who contributed to the Font Software. + +PERMISSION & CONDITIONS +Permission is hereby granted, free of charge, to any person obtaining +a copy of the Font Software, to use, study, copy, merge, embed, modify, +redistribute, and sell modified and unmodified copies of the Font +Software, subject to the following conditions: + +1) Neither the Font Software nor any of its individual components, +in Original or Modified Versions, may be sold by itself. + +2) Original or Modified Versions of the Font Software may be bundled, +redistributed and/or sold with any software, provided that each copy +contains the above copyright notice and this license. These can be +included either as stand-alone text files, human-readable headers or +in the appropriate machine-readable metadata fields within text or +binary files as long as those fields can be easily viewed by the user. + +3) No Modified Version of the Font Software may use the Reserved Font +Name(s) unless explicit written permission is granted by the corresponding +Copyright Holder. This restriction only applies to the primary font name as +presented to the users. + +4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font +Software shall not be used to promote, endorse or advertise any +Modified Version, except to acknowledge the contribution(s) of the +Copyright Holder(s) and the Author(s) or with their explicit written +permission. + +5) The Font Software, modified or unmodified, in part or in whole, +must be distributed entirely under this license, and must not be +distributed under any other license. The requirement for fonts to +remain under this license does not apply to any document created +using the Font Software. + +TERMINATION +This license becomes null and void if any of the above conditions are +not met. + +DISCLAIMER +THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT +OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE +COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL +DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM +OTHER DEALINGS IN THE FONT SOFTWARE. diff --git a/crates/horizon-theme/fonts/PixelifySans-Bold.ttf b/crates/horizon-theme/fonts/PixelifySans-Bold.ttf new file mode 100644 index 0000000000000000000000000000000000000000..5f8040b71be14d283010c4a646eac856a03988bf GIT binary patch literal 95056 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 literal 0 HcmV?d00001 diff --git a/crates/horizon-theme/fonts/PixelifySans-Medium.ttf b/crates/horizon-theme/fonts/PixelifySans-Medium.ttf new file mode 100644 index 0000000000000000000000000000000000000000..5bf69961d9a3e4f83a3440319ec37cf7c49e30a7 GIT binary patch literal 94248 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 Z`2WC{N$&2(yP4gQ7HfZs+DLrz{a@To+r<C? literal 0 HcmV?d00001 diff --git a/crates/horizon-theme/fonts/PixelifySans-SemiBold.ttf b/crates/horizon-theme/fonts/PixelifySans-SemiBold.ttf new file mode 100644 index 0000000000000000000000000000000000000000..45cd4e2afa3edc6fe1c2500f4e763bdbb0ec65a1 GIT binary patch literal 97492 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 VKfA;69%gu?o!TF!xw<_0{vX*^WWN9a literal 0 HcmV?d00001 diff --git a/crates/horizon-theme/icons/pixel/LICENSE-pixelarticons.txt b/crates/horizon-theme/icons/pixel/LICENSE-pixelarticons.txt new file mode 100644 index 000000000..4be35e8f2 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/LICENSE-pixelarticons.txt @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2019 Gerrit Halfmann + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/crates/horizon-theme/icons/pixel/archive.svg b/crates/horizon-theme/icons/pixel/archive.svg new file mode 100644 index 000000000..03033f96d --- /dev/null +++ b/crates/horizon-theme/icons/pixel/archive.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M3 2h18v2H3zm0 5h18v2H3zM1 4h2v3H1zm20 0h2v3h-2zm-2 5h2v11h-2zM3 9h2v11H3zm2 11h14v2H5zm4-9h6v2H9z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/arrow-left.svg b/crates/horizon-theme/icons/pixel/arrow-left.svg new file mode 100644 index 000000000..96905e6c1 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/arrow-left.svg @@ -0,0 +1,4 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M20 11v2H4v-2zM8 13v2H6v-2zm2 2v2H8v-2zm2 2v2h-2v-2zm-4-6V9H6v2z"/> + <path d="M10 15V7H8v8zm2 2V5h-2v12z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/book-open.svg b/crates/horizon-theme/icons/pixel/book-open.svg new file mode 100644 index 000000000..b9b134ccc --- /dev/null +++ b/crates/horizon-theme/icons/pixel/book-open.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M2 3h9v2H2zM0 19h11v2H0zM13 3h9v2h-9zm0 16h11v2H13zM11 5h2v18h-2zM0 5h2v14H0zm22 0h2v14h-2zm-7 2h5v2h-5zm0 4h5v2h-5zm0 4h2v2h-2z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/box.svg b/crates/horizon-theme/icons/pixel/box.svg new file mode 100644 index 000000000..68f58c8ed --- /dev/null +++ b/crates/horizon-theme/icons/pixel/box.svg @@ -0,0 +1,4 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M14 4h4v2h-4zm-4-2h4v2h-4zM6 8h4v2H6zm0 10h4v2H6zm4-8h4v2h-4zm0 10h4v2h-4zm4-12h4v2h-4zm0 10h4v2h-4zM6 4h4v2H6zM2 6h4v2H2zm0 10h4v2H2zM18 6h4v2h-4zm0 10h4v2h-4z"/> + <path d="M2 6h2v12H2zm18 0h2v12h-2zm-8 6h2v8h-2z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/bug.svg b/crates/horizon-theme/icons/pixel/bug.svg new file mode 100644 index 000000000..cdc707a44 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/bug.svg @@ -0,0 +1,5 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M2 5h2v4H2zm20 0h-2v4h2zM4 9h2v2H4zm16 0h-2v2h2zM2 13h4v2H2zm20 0h-4v2h4zM4 17h2v2H4zm16 0h-2v2h2zM2 19h2v2H2zm20 0h-2v2h2zM6 11h12v2H6z"/> + <path d="M6 7h2v12H6zm10 0h2v12h-2zM8 19h8v2H8zM8 5h8v2H8z"/> + <path d="M11 15h2v6h-2zM8 1h2v6H8zm6 0h2v6h-2z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/check.svg b/crates/horizon-theme/icons/pixel/check.svg new file mode 100644 index 000000000..e8dec6fe8 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/check.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M10 18H8v-2h2v2Zm-2-2H6v-2h2v2Zm4-2v2h-2v-2h2Zm-6 0H4v-2h2v2Zm8 0h-2v-2h2v2Zm2-2h-2v-2h2v2Zm2-2h-2V8h2v2Zm2-2h-2V6h2v2Z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/chevron-down.svg b/crates/horizon-theme/icons/pixel/chevron-down.svg new file mode 100644 index 000000000..472e5e0d0 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/chevron-down.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M13 16h-2v-2h2v2Zm-2-2H9v-2h2v2Zm4 0h-2v-2h2v2Zm-6-2H7v-2h2v2Zm8 0h-2v-2h2v2ZM7 10H5V8h2v2Zm12 0h-2V8h2v2Z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/chevron-right.svg b/crates/horizon-theme/icons/pixel/chevron-right.svg new file mode 100644 index 000000000..ad8a9142c --- /dev/null +++ b/crates/horizon-theme/icons/pixel/chevron-right.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M16 13v-2h-2v2h2Zm-2-2V9h-2v2h2Zm0 4v-2h-2v2h2Zm-2-6V7h-2v2h2Zm0 8v-2h-2v2h2ZM10 7V5H8v2h2Zm0 12v-2H8v2h2Z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/clock.svg b/crates/horizon-theme/icons/pixel/clock.svg new file mode 100644 index 000000000..e17594f98 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/clock.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M6 2h12v2H6zM2 6h2v12H2zm18 0h2v12h-2zm-2-2h2v2h-2zM4 4h2v2H4zm2 18h12v-2H6zm12-2h2v-2h-2zM4 20h2v-2H4zm7-14h2v7h-2zm2 7h2v2h-2zm2 2h2v2h-2z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/close.svg b/crates/horizon-theme/icons/pixel/close.svg new file mode 100644 index 000000000..6e6d81257 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/close.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> +<path d="M7 19H5V17H7V19ZM19 19H17V17H19V19ZM9 15V17H7V15H9ZM17 17H15V15H17V17ZM11 15H9V13H11V15ZM15 15H13V13H15V15ZM13 13H11V11H13V13ZM11 11H9V9H11V11ZM15 11H13V9H15V11ZM9 9H7V7H9V9ZM17 9H15V7H17V9ZM7 7H5V5H7V7ZM19 7H17V5H19V7Z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/download.svg b/crates/horizon-theme/icons/pixel/download.svg new file mode 100644 index 000000000..122cfbd80 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/download.svg @@ -0,0 +1,5 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M21 15v4h-2v-4zm-2 4v2H5v-2zM5 15v4H3v-4zm8-12v14h-2V3z"/> + <path d="M7 11v2h10v-2zm2 2v2h2v-2zm4 0v2h2v-2z"/> + <path d="M15 11v2h2v-2z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/external-link.svg b/crates/horizon-theme/icons/pixel/external-link.svg new file mode 100644 index 000000000..7058bc5b7 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/external-link.svg @@ -0,0 +1,4 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M11 5H5v2h6V5ZM5 7H3v12h2V7Zm12 12H5v2h12v-2Zm2-6h-2v6h2v-6Zm-8 0H9v2h2v-2Zm2-2h-2v2h2v-2Zm2-2h-2v2h2V9Zm2-2h-2v2h2V7Zm2-2h-2v2h2V5Zm2-2h-2v8h2V3Z"/> + <path d="M21 3h-8v2h8V3Z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/folder.svg b/crates/horizon-theme/icons/pixel/folder.svg new file mode 100644 index 000000000..40533e4bb --- /dev/null +++ b/crates/horizon-theme/icons/pixel/folder.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M4 4h6v2H4zm0 14h16v2H4zM20 8h2v10h-2zM2 6h2v12H2zm8 0h10v2H10z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/gamepad.svg b/crates/horizon-theme/icons/pixel/gamepad.svg new file mode 100644 index 000000000..9936d5e66 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/gamepad.svg @@ -0,0 +1,4 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M4 4h16v2H4zm0 14h16v2H4zM2 6h2v12H2zm18 0h2v12h-2zM8 9h2v6H8z"/> + <path d="M6 11h6v2H6zm8-2h2v2h-2zm2 4h2v2h-2z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/globe.svg b/crates/horizon-theme/icons/pixel/globe.svg new file mode 100644 index 000000000..3b984aa0c --- /dev/null +++ b/crates/horizon-theme/icons/pixel/globe.svg @@ -0,0 +1,4 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M6 2h12v2H6zm0 18h12v2H6zM4 4h2v2H4zm5 0h2v2H9zm0 14h2v2H9zm4 0h2v2h-2zM7 6h2v12H7zm8 0h2v12h-2zm-2-2h2v2h-2zm7 0h-2v2h2zM2 6h2v12H2zm20 0h-2v12h2zM4 18h2v2H4zm16 0h-2v2h2z"/> + <path d="M3 11h18v2H3z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/heart.svg b/crates/horizon-theme/icons/pixel/heart.svg new file mode 100644 index 000000000..7c0ccb9eb --- /dev/null +++ b/crates/horizon-theme/icons/pixel/heart.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M13 22h-2v-2h2v2Zm-2-2H9v-2h2v2Zm4 0h-2v-2h2v2Zm-6-2H7v-2h2v2Zm8 0h-2v-2h2v2ZM7 16H5v-2h2v2Zm12 0h-2v-2h2v2ZM5 14H3v-2h2v2Zm16 0h-2v-2h2v2ZM3 12H1V6h2v6Zm20 0h-2V6h2v6ZM13 8h-2V6h2v2ZM5 6H3V4h2v2Zm6 0H9V4h2v2Zm4 0h-2V4h2v2Zm6 0h-2V4h2v2ZM9 4H5V2h4v2Zm10 0h-4V2h4v2Z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/home.svg b/crates/horizon-theme/icons/pixel/home.svg new file mode 100644 index 000000000..f71cb8c00 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/home.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M4 20h16v2H4zm16-10h2v10h-2zM2 10h2v10H2zm2-2h2v2H4zm2-2h2v2H6zm2-2h2v2H8zm2-2h4v2h-4zm4 2h2v2h-2zm2 2h2v2h-2zm2 2h2v2h-2zM8 14h2v6H8zm2-2h4v2h-4zm4 2h2v6h-2z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/image.svg b/crates/horizon-theme/icons/pixel/image.svg new file mode 100644 index 000000000..cf2892770 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/image.svg @@ -0,0 +1,4 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M4 2h16v2H4zm0 18h16v2H4zM2 4h2v16H2zm18 0h2v16h-2zm-4 8h2v2h-2zm-2 2h2v2h-2zm4 0h2v2h-2zm-8 0h2v2h-2zm2 2h2v2h-2zm2 2h2v2h-2z"/> + <path d="M20 16h2v2h-2zM8 16h2v2H8zm-2 2h2v2H6zM8 6h2v2H8zM6 8h2v2H6zm2 2h2v2H8zm2-2h2v2h-2z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/info-box.svg b/crates/horizon-theme/icons/pixel/info-box.svg new file mode 100644 index 000000000..04128032b --- /dev/null +++ b/crates/horizon-theme/icons/pixel/info-box.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M4 2h16v2H4zm0 18h16v2H4zM2 4h2v16H2zm18 0h2v16h-2zm-9 5h2V7h-2zm0 8h2v-6h-2z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/message.svg b/crates/horizon-theme/icons/pixel/message.svg new file mode 100644 index 000000000..c5dc11a7e --- /dev/null +++ b/crates/horizon-theme/icons/pixel/message.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M20 2H4v2h16zm0 14H6v2h14zm2-12h-2v12h2zM4 4H2v18h2zm2 14H4v2h2z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/monitor.svg b/crates/horizon-theme/icons/pixel/monitor.svg new file mode 100644 index 000000000..52edf4d4f --- /dev/null +++ b/crates/horizon-theme/icons/pixel/monitor.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M4 2h16v2H4zm0 14h16v2H4zM2 4h2v12H2zm18 0h2v12h-2zm-9 14h2v2h-2zm-3 2h8v2H8z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/notes.svg b/crates/horizon-theme/icons/pixel/notes.svg new file mode 100644 index 000000000..beb8d97e5 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/notes.svg @@ -0,0 +1,4 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M6 8h2v12H6zM2 4h2v12H2zm18 4h2v8h-2zM8 6h12v2H8zM4 2h12v2H4zm14 14h2v2h-2zm-2 2h2v2h-2zm-8 2h8v2H8zm6-6h6v2h-6z"/> + <path d="M14 14h2v6h-2zm2-10h2v2h-2zM4 16h2v2H4z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/package.svg b/crates/horizon-theme/icons/pixel/package.svg new file mode 100644 index 000000000..cc6ce0788 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/package.svg @@ -0,0 +1,4 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M10 20h4v2h-4zm0-16h4V2h-4zm0 6h4v2h-4zm4 8h4v2h-4zm0-12h4V4h-4zm0 2h4v2h-4zm4 8h4v2h-4zm0-8h4V6h-4zM6 18h4v2H6zM6 6h4V4H6zm0 2h4v2H6zm-4 8h4v2H2zm0-8h4V6H2z"/> + <path d="M2 6h2v12H2zm18 0h2v12h-2zm-8 6h2v8h-2zm-2-6h4v2h-4z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/play.svg b/crates/horizon-theme/icons/pixel/play.svg new file mode 100644 index 000000000..02e3c17aa --- /dev/null +++ b/crates/horizon-theme/icons/pixel/play.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M15 11h-2V9h2zm0 4h-2v-2h2zm-2 2h-2v-2h2zm0-8h-2V7h2zm-2-2H9V5h2zM9 21H7V3h2zm6-8h2v-2h-2zm-6 4h2v2H9z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/plus.svg b/crates/horizon-theme/icons/pixel/plus.svg new file mode 100644 index 000000000..cd35642b9 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/plus.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M13 11h7v2h-7v7h-2v-7H4v-2h7V4h2v7Z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/reload.svg b/crates/horizon-theme/icons/pixel/reload.svg new file mode 100644 index 000000000..3458d03f0 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/reload.svg @@ -0,0 +1,5 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M16 4h2v6h-2zm-2-2h2v2h-2zm0 2h2v8h-2zM4 8H2v5h2z"/> + <path d="M4 6h16v2H4zm4 14H6v-6h2zm2 2H8v-2h2zm0-2H8v-8h2zm10-4h2v-5h-2z"/> + <path d="M20 18H4v-2h16z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/search.svg b/crates/horizon-theme/icons/pixel/search.svg new file mode 100644 index 000000000..7dce1b5ea --- /dev/null +++ b/crates/horizon-theme/icons/pixel/search.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M22 22h-2v-2h2v2Zm-2-2h-2v-2h2v2Zm-6-2H6v-2h8v2Zm4 0h-2v-2h2v2ZM6 16H4v-2h2v2Zm10 0h-2v-2h2v2ZM4 14H2V6h2v8Zm14 0h-2V6h2v8ZM6 6H4V4h2v2Zm10 0h-2V4h2v2Zm-2-2H6V2h8v2Z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/server.svg b/crates/horizon-theme/icons/pixel/server.svg new file mode 100644 index 000000000..7979820e7 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/server.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M6 7h4v2H6zm0 8h4v2H6zM2 5h2v14H2zm18 0h2v14h-2zM4 19h16v2H4zM4 3h16v2H4zm0 8h16v2H4z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/sliders.svg b/crates/horizon-theme/icons/pixel/sliders.svg new file mode 100644 index 000000000..c2b4912d0 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/sliders.svg @@ -0,0 +1 @@ +<svg xmlns="http://www.w3.org/2000/svg" fill="currentColor" viewBox="0 0 24 24"><path d="M8 14H7v6H5v-6H2v-2h6v2Zm5 6h-2V10h2v10Zm9-2h-3v2h-2v-2h-1v-2h6v2Zm-3-4h-2V4h2v10ZM7 10H5V4h2v6Zm6-4h2v2H9V6h2V4h2v2Z"/></svg> \ No newline at end of file diff --git a/crates/horizon-theme/icons/pixel/terminal.svg b/crates/horizon-theme/icons/pixel/terminal.svg new file mode 100644 index 000000000..e000cd104 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/terminal.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M4 2h16v2H4zm0 18h16v2H4zM2 4h2v16H2zm18 0h2v16h-2zM6 16h2v2H6zm2-2h2v2H8zm-2-2h2v2H6z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/trash.svg b/crates/horizon-theme/icons/pixel/trash.svg new file mode 100644 index 000000000..f67fe4eca --- /dev/null +++ b/crates/horizon-theme/icons/pixel/trash.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> +<path d="M18 22H6V20H18V22ZM9 6H15V4H17V6H22V8H20V20H18V8H6V20H4V8H2V6H7V4H9V6ZM15 4H9V2H15V4Z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/user.svg b/crates/horizon-theme/icons/pixel/user.svg new file mode 100644 index 000000000..13773d116 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/user.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M9 2h6v2H9zm0 8h6v2H9zm6-6h2v6h-2zM7 4h2v6H7zM4 18h2v4H4zm14 0h2v4h-2zM8 14h8v2H8zm-2 2h2v2H6zm10 0h2v2h-2z"/> +</svg> diff --git a/crates/horizon-theme/icons/pixel/zap.svg b/crates/horizon-theme/icons/pixel/zap.svg new file mode 100644 index 000000000..93ab75cbf --- /dev/null +++ b/crates/horizon-theme/icons/pixel/zap.svg @@ -0,0 +1,3 @@ +<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" viewBox="0 0 24 24"> + <path d="M4 13h8v6h2v2h-2v2h-2v-8H2v-4h2v2Zm12 6h-2v-2h2v2Zm2-2h-2v-2h2v2Zm2-2h-2v-2h2v2Zm-6-6h8v4h-2v-2h-8V5h-2V3h2V1h2v8Zm-8 2H4V9h2v2Zm2-2H6V7h2v2Zm2-2H8V5h2v2Z"/> +</svg> diff --git a/crates/horizon-theme/src/lib.rs b/crates/horizon-theme/src/lib.rs index ced8731c1..cf4b296da 100644 --- a/crates/horizon-theme/src/lib.rs +++ b/crates/horizon-theme/src/lib.rs @@ -11,6 +11,9 @@ use std::time::Duration; pub const FONT: &str = "Geist"; pub const MONO: &str = "Geist Mono"; +/// The launcher's and the website's display face (headings, navigation, buttons, badges only): +/// Pixelify Sans, bundled under the SIL Open Font License (`fonts/OFL-PixelifySans.txt`). +pub const PIXEL: &str = "Pixelify Sans"; /// The bundled font files. pub mod fonts { @@ -18,6 +21,62 @@ pub mod fonts { pub const GEIST_MEDIUM: &[u8] = include_bytes!("../fonts/Geist-Medium.ttf"); pub const GEIST_SEMIBOLD: &[u8] = include_bytes!("../fonts/Geist-SemiBold.ttf"); pub const GEIST_MONO: &[u8] = include_bytes!("../fonts/GeistMono-Regular.ttf"); + pub const PIXEL_MEDIUM: &[u8] = include_bytes!("../fonts/PixelifySans-Medium.ttf"); + pub const PIXEL_SEMIBOLD: &[u8] = include_bytes!("../fonts/PixelifySans-SemiBold.ttf"); + pub const PIXEL_BOLD: &[u8] = include_bytes!("../fonts/PixelifySans-Bold.ttf"); +} + +/// The launcher's pixel icons: Pixelarticons (MIT, `icons/pixel/LICENSE-pixelarticons.txt`), 24 +/// unit SVGs filled with `currentColor`, by name (`"home"`, `"play"`…). +pub mod icons { + macro_rules! icons { + ($($name:literal),* $(,)?) => { + /// Every icon, `(name, svg)`. + pub const ALL: &[(&str, &[u8])] = &[ + $(($name, include_bytes!(concat!("../icons/pixel/", $name, ".svg")))),* + ]; + }; + } + icons!( + "archive", + "arrow-left", + "book-open", + "box", + "bug", + "check", + "chevron-down", + "chevron-right", + "clock", + "close", + "download", + "external-link", + "folder", + "gamepad", + "globe", + "heart", + "home", + "image", + "info-box", + "message", + "monitor", + "notes", + "package", + "play", + "plus", + "reload", + "search", + "server", + "sliders", + "terminal", + "trash", + "user", + "zap", + ); + + /// An icon's SVG by name. + pub fn get(name: &str) -> Option<&'static [u8]> { + ALL.iter().find(|(n, _)| *n == name).map(|(_, svg)| *svg) + } } /// Horizon's icon at 64 px (PNG), for window title bars and task bars at run time. Rendered from @@ -275,6 +334,113 @@ pub const DARK: Palette = Palette { dark: true, }; +/// The launcher's and the website's blocky look ("Blocks" in `docs/design-system.md`): stone-dark +/// (or lavender-light) neutrals with a violet cast, panels with a dark outline, a light bevel on top +/// and a darker lip below, and the violet `face` of the one big action. The game's menus keep +/// [`LIGHT`] and [`DARK`]. +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub struct Blocks { + /// The window behind everything, tiled with a faint stone texture. + pub page: u32, + /// The top bar and the sidebar. + pub side: u32, + /// Panels: rows, cards, dialogs. + pub panel: u32, + /// A selected or hovered panel or row, the open tab. + pub raised: u32, + /// Buttons and the chosen segment. + pub button: u32, + /// A button's top bevel. + pub button_bevel: u32, + /// Sunk wells: fields, tracks, switch and checkbox boxes, segmented tracks. + pub well: u32, + /// The light top (and left) edge of a panel. + pub bevel: u32, + /// The darker bottom edge of a panel or button. + pub lip: u32, + /// The 2 px outline around panels, buttons and wells. + pub outline: u32, + /// Rules between rows inside a panel. + pub rule: u32, + pub ink: u32, + pub ink_soft: u32, + pub muted: u32, + /// Links, focus, progress, the selection marker; text-safe on every background. + pub accent: u32, + /// The main action's face (Play, Install, Download), its top bevel and bottom lip. + pub face: u32, + pub face_bevel: u32, + pub face_lip: u32, + pub on_face: u32, + pub danger: u32, + pub success: u32, + /// "Partly": a mod or pack that runs in part. + pub warn: u32, + pub dark: bool, +} + +pub const BLOCKS_DARK: Blocks = Blocks { + page: 0x0f0d17, + side: 0x0b0a11, + panel: 0x1a1727, + raised: 0x221e34, + button: 0x2b2641, + button_bevel: 0x3d3560, + well: 0x0c0b12, + bevel: 0x342d52, + lip: 0x07060b, + outline: 0x05040a, + rule: 0x120f1c, + ink: 0xecedf3, + ink_soft: 0xc5c7d1, + muted: 0xa29cb8, + accent: 0x9a86ff, + face: 0x5b3fd6, + face_bevel: 0x8a74ff, + face_lip: 0x3a2694, + on_face: 0xffffff, + danger: 0xf07a68, + success: 0x45c27a, + warn: 0xf0b84f, + dark: true, +}; + +pub const BLOCKS_LIGHT: Blocks = Blocks { + page: 0xece7f7, + side: 0xe2dbf2, + panel: 0xf8f6fd, + raised: 0xe9e3f8, + button: 0xddd4f3, + button_bevel: 0xf4f0fe, + well: 0xf3f0fb, + bevel: 0xffffff, + lip: 0xc3b8e2, + outline: 0x2b2244, + rule: 0xe4ddf4, + ink: 0x1b1530, + ink_soft: 0x3b3354, + muted: 0x585071, + accent: 0x5333c9, + face: 0x5b3fd6, + face_bevel: 0x8069ef, + face_lip: 0x3a2694, + on_face: 0xffffff, + danger: 0xa3301d, + success: 0x136336, + warn: 0x7a4f00, + dark: false, +}; + +/// Pixel sizes of the blocky look: outlines, bevels and lips, the cut corner, and the stone tile. +pub const BLOCK_OUTLINE: f32 = 2.; +pub const BLOCK_BEVEL: f32 = 2.; +pub const BLOCK_LIP: f32 = 4.; +/// The stone texture: a 16 by 16 tile, each texel this many logical pixels. +pub const TILE_TEXELS: usize = 16; +pub const TILE_TEXEL: f32 = 4.; +/// The texture's shades: the page colour moved this many levels (of 255) lighter or darker. +pub const TILE_SHADES: [i16; 5] = [0, 2, -2, 5, -4]; + /// How strongly the game's menus veil the live backdrop (the title panorama, or the world behind /// the pause and options screens) with the page colour. Every text colour the menus use keeps /// WCAG AA over it, even on a selected row's plate, with a backdrop as bright as @@ -308,6 +474,41 @@ impl Palette { } } +impl Blocks { + /// Every colour by its CSS name. The website reads the Blocks palettes; the first twelve keep + /// the names of [`Palette::named`] (`plate-soft` is `raised`, `plate` is `button`, `surface` + /// is `panel`, `on-accent` is `on_face`), so styles written for those still apply. + pub fn named(&self) -> [(&'static str, u32); 25] { + [ + ("page", self.page), + ("plate-soft", self.raised), + ("plate", self.button), + ("surface", self.panel), + ("rule", self.rule), + ("ink", self.ink), + ("ink-soft", self.ink_soft), + ("muted", self.muted), + ("accent", self.accent), + ("on-accent", self.on_face), + ("danger", self.danger), + ("success", self.success), + ("warn", self.warn), + ("side", self.side), + ("panel", self.panel), + ("raised", self.raised), + ("button", self.button), + ("button-bevel", self.button_bevel), + ("well", self.well), + ("bevel", self.bevel), + ("lip", self.lip), + ("outline", self.outline), + ("face", self.face), + ("face-bevel", self.face_bevel), + ("face-lip", self.face_lip), + ] + } +} + /// The WCAG 2 contrast ratio of two colours. pub fn contrast(a: u32, b: u32) -> f32 { fn luminance(c: u32) -> f32 { @@ -333,10 +534,12 @@ pub fn css() -> String { let t = format!("{v:.3}"); t.trim_end_matches('0').trim_end_matches('.').to_string() }; - let colors = |s: &mut String, p: &Palette| { + // The website wears the launcher's Blocks look; the game's menus keep LIGHT and DARK. + let colors = |s: &mut String, p: &Blocks| { for (name, c) in p.named() { let _ = writeln!(s, " --{name}: #{c:06x};"); } + let _ = writeln!(s, " --on-face: #{:06x};", p.on_face); let _ = writeln!( s, " color-scheme: {};", @@ -347,11 +550,18 @@ pub fn css() -> String { "/* Generated from crates/horizon-theme by `cargo run -p xtask -- tokens`; do not edit.\n \ docs/design-system.md describes the tokens. */\n\n:root {\n", ); - colors(&mut s, &LIGHT); + colors(&mut s, &BLOCKS_LIGHT); let _ = writeln!( s, - " --font: \"{FONT}\", ui-sans-serif, system-ui, sans-serif;\n --mono: \"{MONO}\", ui-monospace, monospace;" + " --font: \"{FONT}\", ui-sans-serif, system-ui, sans-serif;\n --mono: \"{MONO}\", ui-monospace, monospace;\n --pixel: \"{PIXEL}\", \"{FONT}\", ui-sans-serif, sans-serif;" ); + for (name, v) in [ + ("block-outline", BLOCK_OUTLINE), + ("block-bevel", BLOCK_BEVEL), + ("block-lip", BLOCK_LIP), + ] { + let _ = writeln!(s, " --{name}: {}px;", num(v)); + } for step in TYPE { let size = match step.web { Web::Fixed => format!("{}px", num(step.px)), @@ -410,7 +620,7 @@ pub fn css() -> String { "}\n\n@media (prefers-color-scheme: dark) {\n :root:not([data-theme=\"light\"]) {\n", ); let mut dark = String::new(); - colors(&mut dark, &DARK); + colors(&mut dark, &BLOCKS_DARK); for line in dark.lines() { let _ = writeln!(s, " {line}"); } @@ -458,6 +668,63 @@ mod tests { } } + /// The blocky look: every text colour on every background it is drawn on reaches AA, the + /// main action's label too, and the focus ring (the accent) reaches 3:1 (WCAG 1.4.11). + #[test] + fn blocks_text_meets_wcag_aa_in_both_appearances() { + for p in [BLOCKS_DARK, BLOCKS_LIGHT] { + let theme = if p.dark { "dark" } else { "light" }; + let backgrounds = [ + ("page", p.page), + ("side", p.side), + ("panel", p.panel), + ("raised", p.raised), + ("button", p.button), + ("well", p.well), + ]; + let texts = [ + ("ink", p.ink), + ("ink_soft", p.ink_soft), + ("muted", p.muted), + ("accent", p.accent), + ("danger", p.danger), + ("success", p.success), + ("warn", p.warn), + ]; + for (bn, bg) in backgrounds { + for (tn, fg) in texts { + let ratio = contrast(fg, bg); + assert!(ratio >= 4.5, "{theme} {tn} on {bn}: {ratio:.2}"); + } + // The texture's lightest shade under the page's text. + let lifted = TILE_SHADES.iter().max().copied().unwrap_or(0) as i32; + let shade = [16, 8, 0].iter().fold(0, |out, s| { + let c = (((p.page >> s) & 255) as i32 + lifted).clamp(0, 255) as u32; + out | c << s + }); + for (tn, fg) in texts { + let ratio = contrast(fg, shade); + assert!( + ratio >= 4.5, + "{theme} {tn} on the stone texture: {ratio:.2}" + ); + } + } + let label = contrast(p.on_face, p.face); + assert!(label >= 4.5, "{theme} the main action's label: {label:.2}"); + } + } + + #[test] + fn every_icon_is_a_pixel_svg() { + for (name, svg) in icons::ALL { + let svg = std::str::from_utf8(svg).unwrap(); + assert!(svg.contains("viewBox=\"0 0 24 24\""), "{name}"); + assert!(svg.contains("currentColor"), "{name}"); + } + assert!(icons::get("play").is_some()); + } + /// The game's menus over the brightest backdrop: the page colour veiled over it, and a /// selected row's plate (ink at 8 %) on top. #[test] diff --git a/docs/design-system.md b/docs/design-system.md index 40b5c1b84..c79305dc9 100644 --- a/docs/design-system.md +++ b/docs/design-system.md @@ -139,17 +139,38 @@ 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. +- **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 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. +## 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 **Horizon line.** A sun half set below a horizon, drawn as three horizontal bars of 4, 8 and diff --git a/website/LEGAL.md b/website/LEGAL.md index a68797346..0282b6167 100644 --- a/website/LEGAL.md +++ b/website/LEGAL.md @@ -21,6 +21,7 @@ cookies. The only requests to other hosts are the browser's calls to `api.github | File | Source | Licence | | --- | --- | --- | | `public/fonts/Geist-Regular.woff2`, `Geist-Medium.woff2`, `Geist-SemiBold.woff2`, `GeistMono-Regular.woff2` | Geist and Geist Mono, from `crates/horizon-theme/fonts` (converted from TTF to WOFF2) | SIL Open Font License 1.1, shipped as `public/fonts/OFL-Geist.txt` | +| `public/fonts/PixelifySans-Medium.woff2`, `PixelifySans-SemiBold.woff2`, `PixelifySans-Bold.woff2` | Pixelify Sans by The Pixelify Sans Project Authors (github.com/eifetx/Pixelify-Sans), from `crates/horizon-theme/fonts` (converted from TTF to WOFF2) | SIL Open Font License 1.1, shipped as `public/fonts/OFL-PixelifySans.txt` | The fonts are self-hosted; nothing is fetched from a font service. @@ -34,11 +35,16 @@ The fonts are self-hosted; nothing is fetched from a font service. No Minecraft logo or wordmark appears anywhere on the site, in images or as text styling. GitHub and Discord appear only as plain text links, without their logos. -## No hero image +## The pixel art -The page opens on type, not a photograph. The launcher's old background -(`launcher/assets/background.jpg`, from backgrounds.supply, licence never confirmed) is gone from -the repository, so the launcher's screenshots no longer show it. +| Files in `public/media/` | Source | Licence | +| --- | --- | --- | +| `stone-light.png`, `stone-dark.png` | The page's stone texture, drawn in code by `scripts/art.mjs` from the page colours of `crates/horizon-theme` | MIT, Horizon's original work | +| `scene-light.png`, `scene-dark.png` | The hero's landscape (a dawn and a sunset with Horizon's sliced sun), drawn in code by `scripts/art.mjs`, the same drawing as the launcher's Home banner (`launcher/src/art.rs`) | MIT, Horizon's original work | + +No Minecraft texture is used: the stone is not Minecraft's stone, only shades of the page colour. +The launcher's old background (`launcher/assets/background.jpg`, from backgrounds.supply, licence +never confirmed) is gone from the repository, so the launcher's screenshots no longer show it. ## Screenshots diff --git a/website/README.md b/website/README.md index b5a3ac51d..36c76c331 100644 --- a/website/README.md +++ b/website/README.md @@ -4,9 +4,9 @@ Live at **https://playhorizon.dev**. A landing page and a documentation section in Horizon's design language (`docs/design-system.md`), with the tokens of `crates/horizon-theme` (generated into `src/tokens.css` by `cargo run -p xtask -- tokens`): -Geist and Geist Mono, cool neutrals in a light and a dark appearance (the system's, or the -toggle's) and one violet accent, numbered index lists with one-pixel rules, and short, eased -motion. A headline and the download, then a scroll through what it is, the screenshots, the parity grid, the launcher, the patch +the Blocks look: Pixelify Sans headings over Geist text, Horizon's purple in a light and a dark +appearance (the system's, or the toggle's), square panels with an outline, a bevel and a lip, a +stone texture and a pixel landscape drawn in code (`scripts/art.mjs`), and short, eased motion. A headline and the download, then a scroll through what it is, the screenshots, the parity grid, the launcher, the patch notes, the community links and the contributors. Plain HTML, CSS and JavaScript; no framework and no runtime dependencies. @@ -28,7 +28,8 @@ src/markdown.js a small Markdown renderer (escapes everything), shared by bui src/releases.js the patch notes' markup, shared by build and page src/contributors.js the contributors' filtering and markup, shared by build and page public/ fonts, screenshots, icons, og.png, robots.txt: copied as is (sitemap.xml is written by the build) -scripts/assets.mjs rebuilds public/ from the repo (fonts to WOFF2, images to WebP) +scripts/assets.mjs rebuilds public/ from the repo (fonts to WOFF2, images to WebP, the pixel art) +scripts/art.mjs draws the stone tile and the hero's landscape (PNG, one pixel per texel) scripts/shots.mjs Playwright screenshots at every width, and og.png Dockerfile, Caddyfile, railway.json the Railway service LEGAL.md every asset, its source and licence diff --git a/website/public/fonts/OFL-PixelifySans.txt b/website/public/fonts/OFL-PixelifySans.txt new file mode 100644 index 000000000..6aa5bfbae --- /dev/null +++ b/website/public/fonts/OFL-PixelifySans.txt @@ -0,0 +1,93 @@ +Copyright 2021 The Pixelify Sans Project Authors (https://github.com/eifetx/Pixelify-Sans) + +This Font Software is licensed under the SIL Open Font License, Version 1.1. +This license is copied below, and is also available with a FAQ at: +https://scripts.sil.org/OFL + + +----------------------------------------------------------- +SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007 +----------------------------------------------------------- + +PREAMBLE +The goals of the Open Font License (OFL) are to stimulate worldwide +development of collaborative font projects, to support the font creation +efforts of academic and linguistic communities, and to provide a free and +open framework in which fonts may be shared and improved in partnership +with others. + +The OFL allows the licensed fonts to be used, studied, modified and +redistributed freely as long as they are not sold by themselves. The +fonts, including any derivative works, can be bundled, embedded, +redistributed and/or sold with any software provided that any reserved +names are not used by derivative works. The fonts and derivatives, +however, cannot be released under any other type of license. The +requirement for fonts to remain under this license does not apply +to any document created using the fonts or their derivatives. + +DEFINITIONS +"Font Software" refers to the set of files released by the Copyright +Holder(s) under this license and clearly marked as such. This may +include source files, build scripts and documentation. + +"Reserved Font Name" refers to any names specified as such after the +copyright statement(s). + +"Original Version" refers to the collection of Font Software components as +distributed by the Copyright Holder(s). + +"Modified Version" refers to any derivative made by adding to, deleting, +or substituting -- in part or in whole -- any of the components of the +Original Version, by changing formats or by porting the Font Software to a +new environment. + +"Author" refers to any designer, engineer, programmer, technical +writer or other person who contributed to the Font Software. + +PERMISSION & CONDITIONS +Permission is hereby granted, free of charge, to any person obtaining +a copy of the Font Software, to use, study, copy, merge, embed, modify, +redistribute, and sell modified and unmodified copies of the Font +Software, subject to the following conditions: + +1) Neither the Font Software nor any of its individual components, +in Original or Modified Versions, may be sold by itself. + +2) Original or Modified Versions of the Font Software may be bundled, +redistributed and/or sold with any software, provided that each copy +contains the above copyright notice and this license. These can be +included either as stand-alone text files, human-readable headers or +in the appropriate machine-readable metadata fields within text or +binary files as long as those fields can be easily viewed by the user. + +3) No Modified Version of the Font Software may use the Reserved Font +Name(s) unless explicit written permission is granted by the corresponding +Copyright Holder. This restriction only applies to the primary font name as +presented to the users. + +4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font +Software shall not be used to promote, endorse or advertise any +Modified Version, except to acknowledge the contribution(s) of the +Copyright Holder(s) and the Author(s) or with their explicit written +permission. + +5) The Font Software, modified or unmodified, in part or in whole, +must be distributed entirely under this license, and must not be +distributed under any other license. The requirement for fonts to +remain under this license does not apply to any document created +using the Font Software. + +TERMINATION +This license becomes null and void if any of the above conditions are +not met. + +DISCLAIMER +THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT +OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE +COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL +DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM +OTHER DEALINGS IN THE FONT SOFTWARE. diff --git a/website/public/fonts/PixelifySans-Bold.woff2 b/website/public/fonts/PixelifySans-Bold.woff2 new file mode 100644 index 0000000000000000000000000000000000000000..822b98905016320043e3a9669f8b723656d1757a GIT binary patch literal 27276 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 literal 0 HcmV?d00001 diff --git a/website/public/fonts/PixelifySans-Medium.woff2 b/website/public/fonts/PixelifySans-Medium.woff2 new file mode 100644 index 0000000000000000000000000000000000000000..cd473f4b619e16ef7b05f3b50c2358076355909f GIT binary patch literal 27308 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 X<63`&{ygzL)9&~7Y40~$$_(-?=C{a| literal 0 HcmV?d00001 diff --git a/website/public/fonts/PixelifySans-SemiBold.woff2 b/website/public/fonts/PixelifySans-SemiBold.woff2 new file mode 100644 index 0000000000000000000000000000000000000000..d7fd643cabd568dae8e8114e3e8097d6fcd1476f GIT binary patch literal 27796 zcmV)4K+3;&Pew8T0RR910Bn>15dZ)H0esW|0BkM*0RR9100000000000000000000 z0000Qfl?dGa2$&O24Db-cnE<|37iZO2nvL(c!T>G3yA^%0X7081CeqBAO(v&2c9(y zfmT~cUU3KAwjGrKDbk%FF72ytow|g1)^E^rTV<DB0j;6~t=mC<<iCq$|NsC03z9_~ zYiEwxbq5GudR5<Zxl>s*78Y4v+AjK1EQUNb&`h0MKy*zrXO~=(jbb<PE>sruxUCo# z8(GYqxH+2^s$rM65VtwAA3p*D?i)Kx`lHQkU}MTQ93sE9+pqq}8#M3~$siO;&?_v! zj}f}Wk!D;|ONz5s<tts^HZvuRwRzu_IIE6NHj@vCxrt@b-IO8|QB?EEp1z43=8g^K zM`m*-{hzI(Ut!q!5OyY}q0MJ?Pjoy`a2@FIAJ|8qpvpJ6lG+-6?X<$4ZfDAif77RG z3ST-^5p^nXrA^6ub*sSGWiw(`Rh)Q_XwLuHy-RWtLjwd$LI@rxng$4M3KgaDDHVfM zoM*I6i`1wgRxzwfkk%hwF=|S|%jZEwfeO%AsH>{(mJh0=1A+$(5_FJ(yrU&ALKHmz z&$Hjd+ULHHX(-SjL}+;Fnna{j7K!Ss%SiGz)6A3F0|n+x2Lx_MqpHx@+OTbyC0fLj zd83g#C4P;6Ob25(<=|yog@zgbohZ-KHGR2%x0=vE??kA`$o=b7BGTOjr%bUE7C4!h zzT~tG@n*X~K~~)rVJlC4*^9i|?r;F``2hf5Yw}wAb(N~F5!KPr3vmZ^(dz=I2kHjC zdwQU5ZTSZ{nh&EWilQirq8slWMgts;M$vAHM!Ed?C*AtD5tEr%U~8~7!psDc&@+La zn9x<`mI<wC$7Lp(xhg0dVtwy_!)iwlyKEz26Sm-MJ=?`S!dBeUnY>nY=v*Vb9gr>} zz9_1Mk{(}INz~TVStue3{C8Y~^GeP$?<OA2OLeL0UL%@r7KEspXNm;?DM~ICKYrS> z)zz5;7zb0a*{9l<{XhfI!O?;sIUKvj&7GIa&bVKz47Jh7<5F$qs*U77=F~I;01ck< z2V@VZ;E~FtKa?6b=N@}F`*wPA2JWZ;2vB8ftmnfLbh}@pgNj081X#8A*DN8$sT%f) zoi>8{O-SLz@*otFtTf!6_vinAo&E2+1*gEIp$HXKpwmjapP26VA+0$znF`~#Wankx zO1!`l>NISq2quVPj5ypwlu$gBz2h(In>fuMvkSp$oR*>GB!m}``kAGDy@<$+BQvXt z)cr4#GkcjUF4tREgyv{`{XI)<l>n)cGSz}F(COaGbH*HkHN|`d71QLp%-sffp5^ss z7U|NZ3&CtK>zBd&+th0RpRohzF}x_p3tH;1Kc=F&cTF?%|CdJdzhr4<tVGhtBn1Qk zO;E5Pn0N(FmIx|C$PU|~br!KY=m4?13b5#|+oIgAJ}kK?>+8>tboH5bk5&uEdw|i| z963lwyK7(>C<<u0OZ{%7(dr06rE1OZ)@at>fDpuX3>-O&D9tbYL1=hBmnQW)d0p7; zB^hqSDg|q;yt?miUFk~en{<{rbV_weLlvM54<bC!f4|r1pG|dt-35$#LSkJj2iG4= z#^X|i%V47nMq<)h+Dww8-O^sw8Cl_L#R2{2xx|iG2wQmK*IHefhk3}9yn7+h;>q8C zI;RpbO%Q2BLKZ7o-G`>yN9Re_TKT=hJ@x^VZLNK^6L=_|8EIn4i4&!6ventrij^5D zPU4ih+5M&G|Es;gW2F>&ogQJkEFZ9g`GDQQ1AyKBepwAkK&nh1#bZ2BB8T(8dkvfa zZ;3|_?bqq}GJZ=V5`u(mU<t(Q-B()3wn8RL^<y8B77-Cyj>DbbTUItr`gn&jA7Kct zF+QQwszTLiJznoz`uy&)pZ@=)t!J#Sw^o;{x<Ls^2x9G9KmMi-_7dp)b0=ObQn3UI zo<M~A7z7040hkXU55|R<Lqrr1S0NCM1&~E@AbXvJoK^xUa}jb`9ptJ`NLK`)NW=s@ z$$St5=&VUdC@BTPvRws0NT_BQ9SbT1nqJ^`o9P>dEf;_TKnxqqlmmR{JkjFUARgiQ z%m)VoV8Q_l!G|j~{J=xk&q2tO3!Dn3A)a{LsKD1pU4iPU<vto{kXZK9!Kgzf7miLa z(fs`u0syk&Q97p2k4J?)Kr*47902DDdpQ%1wjn&)CVQ3$&z^oiA-b+n1(Jbn)*yOJ zV;T^BePc49{4;4F-YO)4_uz@QX{U6PJb&i+bDIdG1g&1diYApN2DL*~pm{JM9TTMN zvs2fi^W8@ueMK|c+ge{ec!W%Difz!Z!&oet#WNM}ZFM0nO@q1cn>hK1+bN14+}QQ@ zQL>IiTB)>C6P1@s5p`vI))Z?Zu=yV(!1QH{V#m_x{V8$s0@J?CeMiwwY70jnX23A_ zoEvb~8SAI3ZRy8CKozgpdWhypWI&BPt!_Pdw}b)C{nb0VzsBi-u6{PYO^UK`^*46i zX)M)XHn;EZ))kfvi>t4zCAI=1jDfcYH$eeMApgB*z<K(r8?{`I=ElW+iC;g(SI(=5 zWL98ch(Tkz=G$lRr{#C;cWz)?0rQ&kpRByD<eAwypP27*iMkX7fNi@W|C<EYjFgSS zpkbUpTYf^PzmYJ1aC=1D6Y$FKr}zf~gk`{h=I$7njaI6`-Jjjfl~>+)&#rv%$1VGp zyOg~Y7%=8WZibsVCfyX6<EGSHdi^yam@UPGA)}{bNIZXZz?2ztv&gY{`*a5(zVtpt z5MO=&`WpsKnb7|a5DQYcMFM!LQ<DaA64sUt6ZF@E#goE>lg0CupkZ~9-bH%Ku}4$U z^I!-<dZc(VzmMhDP^uEvva=ktFrC>z>jr@WY8NW$E0$aFBBbgl+p~QMTiFlJU8+wj z1T0R!NzMd+tCy32bT>>14g#2>qkJkFRiz@!y-C-qw_F;8lYAN#rL@0Uz%!0wLB+*z za#%SF{0ks#D`1M_`PE=SoZdou4VN0Ox4xzlPub?bgPRwUk_WcBtTww1T$%Q)<x0P( z)OrNwJm8^tIyKXY%^ZwE6{bP@vLX)dMv?NHiWhVnJt;bVsE}59JDduj`Q16mqZvsR z|9MT5X=Ux@Zk%7`C4_<y+1QF;0j6)kLVBIlq?lcfeVhy=JIG<L?As+@iT;&NQlH85 z;Fa~uRV&Er){LoBWkI5`!t+Ry6op;(NXC$TCSMDY01D`&i*D&@^DhSMS44EQplWOk zB9cN<%q~*NU?2HCLvfXB+|oM)7^~euv$TnhUgujE-BZH1gwQkSg_CIJ=sbxWi-)R& zgvcbs<f);lV#Y8GL&&Hgq*B^h3YN{mk<ci|1)d0-h>Rmr<U|m;JAH(#+f2=P`%~6B z?s^MDhG7;*v&~f4=~QRrkKoM8>-a7hlY~*J8G!W;_(0oXYgt*nJhSKqg;0iVU0X*t zb6{TOwZvz;d)QzAz{VK9w8DQWQ?K3H@!Txe{O=){0|5nG;DL}C3zj4lT)6S&FHjJb zU>aex!bO;Bx@dFEvp_7JRo060k9Zp;NwG(&4A}}4I_Z?tiW!tBRpyckm8w*$Rp+W} zZn@)?22Gl^>CmZ5w;o^g>hsG$fC^c}<2=DrJk4Sn*uqw}v6n+oLPn#E#x@$)2%gb| zK@=Q=G{{3lhz!$1beI$7#XvD@X_{u!H2pcmpQcy0_Nm^be`gGw{Z5T-gF7RCr~n_A zES;AT3UUuxB|oDZQn1i)Dx7u^l~hqpjntxbV$d~t>HT8x=3V2{`9BrrBXC@A48D~r z`QbhVG7JDaPt3@vA*b!;N}NilqM90NsjH@gzMMC1)l0^Xym2bnh2Did6=`OC^`HE+ zP`a<vLC_Dz{dP7|jDb?h^z1an42M021m=LJt&($fbQ8oOBMvikrXX%LmMlCVv=YFf zqYW+<#lg-rF;OHJ%ST9m2BE0FSKi$>k7%cx9;?dhQy`;Iz;>38Mik(NZ!a(e^;AXh zqQ?C?btvUAgPF-HAUbrFsu_Qdjf2YEl078H?7c9wSWo3rpKF|4U2-kB#hqk$)y-ep zpd(oiq$igzatkF*Z>XBehZz*(;mMy`Xw^3Lcz8CSk#CG)#1iOoA7$7{a4^GS(NfJ- z5=C(lH}I|fTLOb1uk1vGiI!F2Dl^R~jh8%|9lXoKPHl<`6;O(zD2lpP3PKvrfs2C; z;8mPdQYF=<hT8RY#!v<NGPLeAkQk(IR!cUU=4P=LmoW?%S7F-erl+`xZs=L(&&E){ zjAqWCh9GJ!`1R%RC2_03&E=RJIJV~c*r$V+^*uhyY0p0xMnPRMN-?f{;Aums4YTlM z$OE@-%@?it2Mg*}R45Xxh(<0%h+(=IqNT$e=`c?^EYMP{mUMDpl^lqZ14&v)(L$=` zGBlU1tsKo1XsWP9aMEeU!&WSfp*2yW49%sGYDIYMgc`+6wGh`wR4+p0j>s#K1_hcF zXqM6@r9(=m3|%sG%g`g~i=;kD1EWcW1y@wK9WVS&6?&%&x8lOjP;mDOvqzWz&6e7* zYNs&kZJ5I5Lz<#A#g3`JLYe~!(Fr0+a+D;IAeAH!>BJBQVi61LpkTx9l(3MXl@Kl= zLQ<rpsZyp%m@a9Cl$lbZ!?hYNTud;54IB0@O|tD6hF>ms*!j3Cq}d~ux=WKL9dg2@ z%#?K%k}kA26x!F)?3V}056vOL-T=dqrL=RL)gy=RI@k%YV0D&ywKR7<hCCB_F3n4^ zSNk-tH8OVyeE6O34Z%Kv2M^w^nYTWpyXA8E)we6pgq0v;;**fx7`W%}&jjo4dK~hJ z8_HFDAu^U2SwN0fK#cJ(P<~u(0mN!jlq4_hduZ|J3-Dvk>nO$DDF851nPKpVoo-K0 zQR=IGwW<oYRYtOzUJ?vx_<FpF@)tAM06Fm7FW@K<colP*|Asr(SdYaO)-$Ci1`uHX zWdLp?G*Fi&f9oku&41oUK>9HU2jB}hTSWY&?tsggx!HSa!w7(vIS=6D001n`rUFqe zWE^9383>jN+phV1zHTzAPetbH$yE2q?(B>43(<%sU2+Ls;F+hrpr8*N1%NWSBOIn3 z98{Fjnd*KVExXwj0GBthjU~e;=6sY7`vaoRPGM1B7G^Gd!3@I81m|sjNg0s|)a?NG z>j0Su?_H*?F<J&wI=Y$9x^14H6^SdLiRT4T^)_V$YUi8O*e%rGzY~yjxSaVU^Uevp zWECu22G#P=A<nvbnW-_RG#_(Pl%D@Z6}g#vFsTE!@)dkWdxCLQ6nW`h7Tm2xHNWZ# z&pi3#k|;QW|Ehp)0g}4%$$z`gAq?cOkG&iqmrM@24^TAOd6L^U*m{Pv`C+l6%lYHf z&*@iZ-#BzcpQV_7h>uJ)9tAzlH&JMK?B;$w2HCZC9w`m}SJsAOmb5W0g}6xcUX|WJ z8K6z4vpW;BOa$G|R`uAmFnG*m=c9#bPo0r&+QNKMQ#a8O<K`0Ma>&5clMXk3H`URW z6(nG9U7L>bGBNkEN#RE(bb!R~ZTQTWXhumM4;qcBsdgd$ztumfUS+^$Z+LbwYb<Ln zaPv`Guz4_ZbD#m+<X%|NMq8+7VWK_vbMPqnCdh$o$)i@D0?#;eGuIUU0<dU_KF5pG zv)hL-gt=`}{f<H=iRC)txKbD2VjAg950ZPKMVF8I@g9CyxbV-<pUVjYA6+EdP`|qA z-H$P<!;n8NR1LLTE`(#B)Lev<fuFIl+0U3#g<D?eRaLm~1>gC?B>>v?RcVkV(L{*3 z;0m>%!f!F3j;_(X`T{;E=RJ{{0_bpEC76L)N+8e)UUmaOQ-}m7X7HTSxnF6Dtmw1Z z9Qz$>9Qz&n9bY@X&e&f~jbSqZF%_Pe30){*2uIl98eZ3veT)|Pghud2`<%Fl6A~tL zeUOcV3#EHOt-zRo3MouOGTZBk(CSOGq2&RMPq#B|bh^t~OKgM!v<YUYv2dwK^Tg`V z?ZECxEX2OY#uG#%8g0z9ZnQS-u4!&&lM!A)T801wg^7NTUmwJ+sT}*gs*ow0T~xE- zTCidvHp~+n3(my0`a`Z6>O6Mii!7?S#k8z7{hhw#Qpk8M1QznD$GxSduP<{vBY_~r ztI0LFpHrBV8ZNT}b)(oNmBXKh8RiYM!qdWNX=xgrXTGUms+wU1idX2g#sZD}y+di> zVp;(qgv3A;03f6}Vzl`WLP8=WsYf=p$f8>a13)c<`V)d7Nf0bTJ%mu~yi0HwtAo4L z6}Zb?h5NT_a1~vLtLz3`RX5?Py9HO%ZMfR*z%|wU`KCPL5PrMcAe?uXU2;8);kgg} z&_}VLDT~0bBvsOSC!#gQd>i_aLy+c-LVfojNLVCb1u+0CjsmPI8W2>?i4Me6g|fM2 zh+cQR^LcY|7c>YQGXa3vqJkCzusWy8pJ_kQS-!s9Q)-eg$vg(3Rn#%J{K-xOK+CfO zklfA?$c<VQ8o*y{CxG4gO`{+4@yp`qdGH_Z31&fmzulu2)N%NahS>N2&j7^xIo=K& z1pw&#s{-JF0Du7;V1|GM@`}!X<Z>mVv*0DjCdU{GXj7RPXS0CaT5}O1oo<`LHaqQ> zCQH7P%2cXy#T^eq%bhQ(j6CV=^Jdi6I#S=z;VNzb=->{XU>F5<z&fy_^Sh`|wBfg~ z9ec;Fp>rW!@=A8+Lgz+j3eJbI#Q`@q-~c65$m_S8pqV)bS+oMy&Gia&rOPI_O^V%8 zWyn$Jv@@zyyQV%UN1k+sM|;Y-(<`x#)K|2)jBA+qA>mJu`09mCt0+eB9DhsmXP^_k zfC;dW{r7vt?T}G?GKc<A#Z^>=)pO|i&@+I^bpbnvo&uXObUmo;-wf<~>;8YzexBK% z_Dk03hIm%{d@bq^V7PDE8ru5WW)1AoHXcCh-&zM-AGDSS0Q3WpTmWZNrETKo1N^&v z1OWJt`*mP~4p%MspRjafEW+&Y0mNg+`Xl|wJhB1t0lOfMJZv`c=DP9aBmN@@eW%BL ztziUqsK0M@^rn|%qx-dVuh%{3;Y`NI!k*R#;o>nPA|a*V#$O;6jj)fJ2WN=ZqLwF{ zsH?{Qn^o=elk}1EmTdc2@r+fyC(o$&;(g+xK5M6*kBt9k_g4+||5<joCj)#n#+ZqI zY*;^Ip^p>wYrzf9ysKTC|LptT^M!OJHu_X~C7tORI*i0Z!^9?J&x)8WA0E6YSsG=$ z(Z-r$+_*5wa*Hjs%sSJ&u}!iqcG_x(T{0ZC-yw&cRiaF}y>5HxuKS*OFdjVd(Od6* zFzBV<7`7v9MoGb!#zZDlSp?FV%V8mxgFMy_uycf?d^Qepa*Rw7XD7%V=jt>Ur}(*G zm~%Xp@^zj!19uk%_*alh!&M7bORYwTI-#x@;X18bM!M;SaCc1f*ckUr@JOWR{^zxs znnY<dON+VM&CzDIRx$pwNSB5FZ;fwO`fQ1JR{Ls&PgeQjPv5OKWP?p1NQ{7lFmUWP z*;Dg$h}AvSd^dcdQ!ik$IZZM5dCYavN#-{BTpE7M*1Y_J#LeiA96o9mAW(Yw4D-0; z{*O0ni3>-y8nqfs%`GfNRyJZ=J9`I5sZ8$VtZ;X8_4e}*3{njb2@NYQDJ`qrwqtvp zfDvqLYcK5J=hinhw}_rrM-50MKiJ=X`a{3J{Gew<@B2`9Z+lnI?8d=nGmS(HL?IfY z!{VFwx4%;uOHZGhvD2SX_s{4Yw=OByr=M2zZLH2K#(_H4zv?7cQ?eo<tf^->l|_w_ zBBfet%WUJiguDL9nC{0Fm~Fs2o~3m9(X%(t@^$E;x_?C$<DMctQgvm^SWC<#M#@+X zBn&Pi2kz#*j0|GMX5@jg&re)vxlwvV2rjXSQI`tsB;(pHXc!qsV@cs?w`Of^432xv zH7hXJnaP3HHEbqvwHL<a!GxIXx3vyKTWvrv@y>vr#Ci}qcHUcq5`64X$UfHPFv#)l zIHh%O$wyuJ<O|KFS}SiIofYae4%Z8Y*NOz)v1Az?oS5Shnka$CDd?g4y4ZlGgbUpj zQ*F(qARSpyRYMkOuuDXGVjMLH7&O3bFS)%N8(X^4J{wU=)iNqM9~|g`K8g$}PBV(Y zI4Hzef-;vpWph-_8EchXo>B6(NWc?GE**BDwz^Hz(JGT-KHjC6ECz_mkNMBwDd~(9 zvSlBZOk7bfY89kYPtFY`j%Ey+Q3h2$tbv7aproqi1jKN-NLKd9RRPM$hExElIm2!v zNO>>05akMb7|S-Kp;m{4<L-ft8lV?Ok=rm3<XogK3Nb_rtAhfir#09FV=;H<N!|*O zk6HKF{(ECqRhfSPQE~(_s5RT)HwUDBeaTxRRv*}m77}Y)=L<F68Ese>AY^f-vh<rU zr?fd3$?UEIj<{lvJmzQwsj7p54g;!Zl#V&c=wf!wC!rqGTQnQl&FEov+0U+SQH`~{ zcSs)zCR}&9Qx>_x(Q$20f<>3C8)&DIn-Y+Z15Lj3Q8<UHueHu@J6UOQZrnx&m=y3V zRcUdOHb_E|Kv@ajCKKRnW8_GL{NX~leZ&H^5_o;h(=~^2X3Wtvin&Ah70(RFsGJk$ zob$l%n_Q9n9_Kec-%(5tkzno_qlM!@%rTJVc#z`+u)&F7las&}CxdNH0Xv-9QG-xF zAf<eE%?omJ_XmpDjdZcTqa8M%`Wx+H^ZB3cqQ%x-yicz9acv=SjXfOLM>#;rqZCkz zC?%9KN(H5gLKbZTMYMvJIWW#KDn~XNP8a8BGhNdXu;pwey<Z!^Wa*BKNF0=-x^*cv zj)M-lilj`}da@11c1mKH9QRMuK~L8=mgUhN@Dg=<A1$b{ZqFd+I7*6!g~dMr@b|3@ zre2tI^EOF=0+ZMS#7OfwlyQLkQju|3&PPs^O4CP3Or|1o9U`O$N^H9NdeeL&!f%-q zZo0X87{cWF2WTFHu=t67R3UzGnLsk+*r(2i+f~zmq8h?$nY1A{<)d_QDu%#kPA9|C zvF{6dKuurB4$P@L$tE?TI#Bk>#QPK__Ej2AbmW56hrmz@MaI%d2Q?a^;Urg7Js1U* zDVa>fL1RN2CoWdHMhmAJFrosAh%^KuD8?9ymIzVE8o)(`pByLAJUjC=<CF#kf?v!a zAjM#M{7k1Nb4>uM5p`heT#Q>nNER=Lo91&AVvX~f0+UDBsY)@bn0~#51h8bHJ35M5 zyq7Ofv@%pQymC{tz0UCZ2rJDA6vM_N`X#fX9);#92@?-9uX*^MD`u(ok)CDc>wFB3 zy|&a7aN^Z&kJ9TjR>N{8O3ay5v(xrc;WYw6dLYthBke}fxxAo2E`z4cOC+r$y7C^6 z=NH6e0wZ_ODeS6+3>up%eybRlmR7e=IU$p?sO(Ryj5|k$_TzkJ-sd+p4({=sl&0x0 zS01k-0Ug#H(8D!wG}HC}V6iU9F;N{9L~U*$n%BI(eYuI+(x?p$j1lf25RAxx+62Xj zb`Ti$l|>&VWN?Cb4?z$l=BNNkknABSVyfE1I%_o}-9a!InE|y0i;?XhILus3SQD?# z$oCKeVIkCjNKot{B;q4QLN9ohacd4b%`u!79&Z>%W0{<ToT><<j)0mobOzDtq0_S- znmZiyaMYWf{>O;UXJ~i0=y28Hro&x_hYn92UdhK>KR){L)sJ7dlm4|%K@tBt<?i?f zfArUC|9MLDwb0hS?!_9b>K;;Q$geEzo~i%!tP%j>><s|E2LSo*fS=`fXo1u8QP+Pr z{q_NQ2bkx=6u*y{Fkl(k!bT}5&=mJ52zp$3kwv#`nGm!+vo8W0f+e~Bo;mFTJ;A7% z_i(@e^u*&u$WoV>P+G+1Tmjh1@!HfTtwxi3%1re#%W+}eF=skmSdvSlJShe-cM|g` z6cR~V5}Kvn^dtqjc+LR8G^W*IQ}A9wv6XX@La|xtY|CrSx}0|h9z=|wT;T3CFd(Vp z&yf>xN@Sb}K9Ozg=bakNq1+vg$j9S=P~E<=r6oq4_!iN%?}f-GxCnqyT9FObu4-gC zB3&|7Bl+#hNq{yd6yj^eMr$AaXN5Skp_@=1G6W3MAB)QRu(?|{HYzM?B1YQnq{gtD znq3*!Q?lL9DzqC5Kx;3-lY!z{O;W?iI-m<I2+*{4N^MwQicp4HuUru6dsD&HyYj9_ zyCb=%|J+rY)|J?*Y&wL^I8p?XQT!EIG7}gQU=j5#cOZ*ZD9%ev?jcx>aD!(VGgT_i z1AYM0>W34NH$pMDT@@d31KBXH1f(7**^~54!yv%!nUWFaUrVZvjyhO0n~^-cg+(*^ z{nsy5wo|&?hs;C7okkqdOD{z}D+U6s8X+ssDsx9;$nk{kh~7dLHo8u@?}`loFaZHW zWotw>8!}s9TQ(sVtGX5Pp?;#mWHm#f#GuCzc*9~VvTak)q(@UQYLN{w*Y%i1w44m` znnc5vjZR5|b#uQ>HH112IGy@++7C+Xg3bUX$q>x3*{|0d4O3yi-~vi-xj{HtI>mPc z|E~P?ziODiB>%MKZ7pU6pH3q!gNRI&xf2b)32lqTF<3JC@qx}E-M6|9vC4tjG&wqI z0ozrP{??qvj!^qdT*ibK&B{@`+bI#A%86VA0#I*7q%z^fAbLY8p!?8uR(CjLME~Vh zph)U6&)U=*T}tzIaZHfS)C!8hL*1zs#jiCbxkY0!Lyz!1Ft8Fks()jEz^~VIdzOdH z=;{Mx7dwM!qV5Qy$2JqzL%B2Mn+0DjCMi7g3pG8mjj<tw#EPy;V?R=VewX)AY?^y2 zgx*_bZo<LTN6s>ir>K5X_*X+6Z6K|FaF{1mqO5%sx}~>5>8jih&Z0^2DkHT<2{AyD zmMBJi)J~)n+hs3-RIz_AKpHs1he^j2>vH5fEa}5j=t_2Zr?@JeBhBkn<QdnX0+cwF zoFs$QQQNdWLPqA3o3GJf+opJXh3v|QjEA261O*EmXI@8~fopR5^>Wkozb+Id(K4zc zhV@odMjX|kdqc}8Fun&71(MqsmDkhOfoNqDMC2ir!&9ntj}F7N`}*ysu9&(`IvN8% zws{EUw-&;2BD}6Ukz>|h^CLP!K~MA1y~A_d60s?lz!ZnpIy$2Cxx2?~>FA^m=>R#a zlb3+{LK)4FElh924@2y>pzl^`RFQ}HagNCO`zu_{0pSf5v0^jC&47Z9^+&ZEn?P?t z7D=6zD{1s-*^5W>vZAcxc;E7Exb890O?KQbJm@EoeevO%@IgSsn<uAoYfxY))Q!XN zUfH(FuI5Vk)Ky={$c`e+K&Hr3=QnWLgs%JVM~@*-k&Tr;x1hFEKDK$w5-;vUn!ML! z3-<BIC1HX~an{hD>y%i7)!RUb0F%0|@J$&JYuTl~PI7CWbB~_8*0|0<f3Oe~HZ8F! zKivPWMCw{Lzqv$AYyY|IDN%ld-~En}dz8jegw%W1an`dd&85C8e5hH$-mQ~Q(+~CT z*tDGd7`ux*kaS-E?xYkWqE~vZ$89NVWk~PSO7Y87VK}mrDr44dD^DZcWl_21&9)`g z>ApiF`zT2)cwA$8Z)cRm@Mt4?uMX{#K;;1*adXk{?kcQw`!7j2!`X3DcsI(In|<ld zK;4&XO!4(Qb2YYfz&4pHs7<+REf{uE3~I=r;V{w${V@Ber#dvLnVobD$GGfE`SesD zW_rY)OEhWqQP<FhD@^k7HMRN}sG<n$LS=1i@#?>r8IO|F=)^il$H2G1IMMj^TA}KN z%U0>2G1zmr{FH$l>3%*Hyk-^hPWJs&iBk6O)9C6oFt%atH;-9xdUMd%MeQn|v|hEe zk3GPb`j??w2ZrtY^2(@}jl;c^RevmhN#{JZC;3M`dDM;oy0m*nk3RCYwp;h%M^V{V zydZM%mjG-gWvEG;ZU?OgZTq#irXHknF244TsmXk|JK9r6u`3K_3+Iw9Ive=u8uDSX z4b;yfE1=>;wlyK#xS4Q;TT{*QUS#6blEUPeHoIy*{ZvQGiH>WxR4X?vnxcFH8DP^1 zi-2NF+ihp;9-T*Nt30DPL72T}_4~R)D>KtFT<+7kK9scmD9kYCuywkHt)$QCXCc0| zVBK6t{L$u$Em$|#*Ij7d%F$PY#mhT6tn1l&Q%O0NvR0r#S+I$xm7O`bNXn|!Z`=gU zi*oVQ=?=RKo&m&XHuT?2gBC?b!cNvgy?q&bc(O0^z124881{*N6OSwXgfn!xPL=Dx zmpibenA9K3H+<B)8`aWz`yC(iZc^hKbsH5!+nh|a)4~=MMn(F|CuWQh^*QQ_bVl@Q z>^!IGV|#7a$$tHW`WBC$68WBG$8go9+p0bQK_#R?HJ`c~)lg1q?G9G17usfOcbfj> zU!*(-{7vA%&#NGWZ)LSy*4@P+o{&}ScLW;j_S6(KufkSXvamc~JcM&0JI!CQqc3p+ z?{VUG=YlYg9I(gF;fi&*fA5_AKRer9?0E(Wyxo)7YU>6?*)u&}g6ejxZ#}lH8rtYm zTM5{P5A9vcO$A$N{-g$LV-xFE{p8{B@%0LOj9EXzP8*ZJcpu<Y;xx9<WuG!79-ZC) zU6#!n^SR#SvgFj*Gy)KMAq03@4yhqV9YlZ!s7#A`(V^37rQh5jG(x1vKn+BEk&`Nr z2@;Mg|8RF{gOq?~5KMu13Y+nJSfG6B$*3<HP|LTwWY>LG4a;}bZaft88*ARqR1BdI z@dW{zMIh+X-ujCZ+4NYNM-Y8dLjcY~Fm$Pvw4#0C#xzBJ(YaV~X%`pK#r%DeQ`A^% z_gN6+_`E{oJuK8B7)sLEfEU;_vR~GynzU1Rqq^|{>l1FhL$zyT3Ob93k>ImfF<QYc zKSJ+GVf8FcQXrneLXI|;hM+`Hzy>ftP$n2afX&#+R7DmL#8A<0ov>M=QO8YMo$ktM zqYb&vEU~vxdfHOxv>v`bm4RNCzqb^KL$(ms{Xv-4OW8wMBWW%PYHQ3dc`2D-n~?p6 z#g#@qd(1f%B3a%R{K?}osmw(l!f=N_*i4v2=gDkO_d&-IPBc;L<dQ>H+xIePu$Z3V z9A|P~%sy@8O113q5H<?-JyEf_AZ3h34CxS~exl~Z{89@IaViFM#qZTwb*J++A>?@o zOwbB_l(F&E0=bL@D!qaTyY}E7s5^y7Ks`w>Wm6HL(L%g26iDyy;%_%n6#C?-Z#0lW zIp!$J1|&uK0otgvIK2cP#Q)DjZx2Qc5_`Om|9^B4Eh*4;O9L&N^TNEV+Br&q<ET&a zpfDds9=Q*XLm^vnM{QxeNLqx$cDmOL1zEu3ws9<MeT0%`@GvyP5F!#pAwColO6bDE z(Xgp;ejEwn9OZ!k-I2n*DI+Z3!2o)4ACmaWMgkpBfpn+OF-@So?Vq}~!^|L%0&v0~ z5$ex6tLAPC+7s~7AM!~;+#DrQOZ-1m5~VV^EZ1o>OJTZ=!H>&$?VwK<1{|dxyI`R{ zEStqrZrym@JM_uF@BRG-c|)={c}Q%yhp3>8jy{-PDi>lukQEI7*DCLRs$vG698N(+ zHZVG-_85;V2INC{yK{n*04WlP2lNn4Az%b(1_8P+Zi~AP-%-B<aG&f63P_W6>$_FT zs<qPER;6_(zm@miJBOCPPbAW-o0g{8*t9%tpcfMtyPtKDTS>=+MR$M(@s$zu$o&W` znpbnO+~DIXCT_`?U-H<5XuG09#2PugT~V!uDwB_@-=Ni%QD+;f+4jrT(&?X9aNT1y zn`6^PU<2<0*w^cM$|HG#p0wC>U$ggA^=yg%3E>_u8oK*OLH^wU615`QPmdfLQ|6k| zmU9j^|IM?^yX(p}X~PeC=itx!f4cLNw@$ygO_|z#gh_3Rkcc0FJ_=@M^Ar0F(a&%0 z$XLuT`RLQ3SX@VEgcs)yPdras*4sA8y?tFZQjaO7v{`6~d<gU_?PeNcf`yW!uk!#5 zzoSIY0tjpZ)S#TO6xJ*H*?2n9e8J*!L{Pp^$&cKdB&;U3Qu`&3>XG}8f>HPRh{o}4 zX$*z!VL0Z!jmMFY9h;_53?q5U)7uY)cLke}7E=&_Rw%?v015np!y{cB&bGlm9tstr zJ{>YuN{A;&>CB$a1hJV`J}8&gh()g`x>(HSg*7szmsPi(Slr&{)yzG=dO1z|i-K%* zB_5mwIUG;kA6wJTmsxw*`)bEA32fVu=2DN}+m`OL3^&BF=UMJJmv3X%Favh^fIL8- zFE}rE-%1<IdFJ~imW=I}_b)xxyM6eN?LkE!w35l%TPMn|92@8(w06x8-!17f>6f(D z8Dk;(a6kr50H@Rp)r#JqEh8t1iyS6fi6MA8vL{B+XizhvVrwb_LTy#UFAVCo2-(Pt zAQljjQCEe0W`Yf#1%WfJgZXT!S7`&<iCt8huq8O`fM1TTh<6zF(Tld>(zcRaBd5M* zZ!El6%d#x9wKkRE*kvPbfAxpB!RJzpK<$SEvR2h@as7UcN?NLKL0k*8tAr!8;COJe z;o(#J^~kABUHq1+s{<$%!8+tcBCdb#i*@05a%OYFpXATxyIh{_2A!b)8Nf)IxJL3b zZ#JhbOBo)Jw5nEaVry7716f^1YulHn1b<gmx{9`B{z`eiZ-L`aN;*|1KRE#_QI7l( zE(TMvp=oLQ(bUXA)%E{3J<&pJq}6g|MbV&;ey8Ee2a#}mr){Tem)b*u;FV^^;`h-8 zy&6a>zY-7qkI1BnNaUXOu6#F}Z|cu$D_P-pe>A^p$<rYWjpujGDB$tangzc2*?378 zr63Cnkr7~)40S^!Fsby)N{hesK^kJUb46#*3FOhC12W8q^!|8jyl5U5T8T0jVkHT- zU`6d`jw(@W)^wjjd)CY>o;W(|`u?O}B)ODcAY)uE#=;jroCXm%XpK0eo_L6O2_pMx z$y$B7k5^(1xw*VGw={1WGB*bbR$Hzu&-RS`44;=LO#o23h#9m~8(=;w*UCRFKW(!r z<5Z9Wp7p4fD2bX?LGoef60X>^lwf-g0eRZ$ARBQ=+xU0H&2;3DU4L(oG&Xc9Fe5Ks zky1XWuQ^5_s=0c{$|VDOV+7(4@5-VoZgI>&LO>zbV16Mf0v#?7e8y&^Np(`5kw?^# zEsP=(oBm*$fmB&X3M_KL=p0pVYdAS}9&Gh#XzCwbY)4LQ<u6VR*$}1nIV!64)m4rj zxu>#f{Ti&O+;@G}_)FvUU!?ys{RocZy%*#dnql5hN4!2QiK-|^nS6erP8&7jfJ2F| zWyYg43Kv}Qq3=pq#qwQ%W?-}2GB-O1!;lgDlD}zIb&C4UBVkyu5qt>f0h&U>aq*Nm zUjTz>7{F;A>21zu`1r`_kp;f^VBBjtESk7Q6U^thUk+W3A}dXbq}&r3naL)vH*;%X zhP3+mG3D#^s#DDv7#RZ^wyIMj^Xq1zl^rf4-Y18<5i~Gr`p;qdB#e8!c<7(G5YdPJ zV%xK7-Jx}@J*{3Fx{YuO#vYzwnNC3eX{6TB1&hL{xTG)P@!o98fACf8`0N2>&hA5D z2)qD>ftL7!YdG6S@0Y(%QplD?N{X^&(OSzc$c@;*2acx3I$XEW04d+EM9dL@2m%?( zW7a6p`}8nsevH)Pd*WMNc^xpTL|v=5RUGT@`9Lg3Z}1krE<5L5PIxx|UOvj=&HOc2 z{?q4M>UN!g>ZR<QTyJiEwp@<|@wRp0MQ2k}fwQqmGcx?%_S2_jY-E)0(XNDx#6=QE zMpScz{_3Q+M#hijUv-MFjdUb)AFJ6!WQN@~|Dv<GsleIPRP;2lMUmcrGoyLrC0eC- zm_~?1F!7SSa0wG!BZQ~c{6%i_>xavWB$M#VwjW<wE<c&&6U8RopHsJ6M6F8}f96;g zFTi1RJA1x^x&V}jP$q&&F9Wt<D96h_oK6FD2MP2^TFGj6@Vpp6kdMIONm}(tBJ)(z zQ(*rlQ*WY+$YC)odbK%I2ttq70~sZ@yr&_Q?UOC@{j0vHMNfJ@Fl1AH0#5B%yZdRM zqeL{3WorsAN+K^T=WG)TFsVNGB0o}cHR&roU!S}uZQ-1&sj<M>*gW=6PjasFTMDq( z7T^W%2Ew;j+2wS7O9^%G73-Jkb6)nooL?{ZV;~Bd-l&%FUxO@PT)L<5k3~DcS5Yrr z@>bHdI6Ln;#oDcU<*mu3v`)C&(s*AP`&#)RBZCEy{AnheT1Z6Kgg{l78m2;RQ%H6# z^^U(SRs94;TLbT!CA#G2o$^Vd0VG6RTyI4p**Q#6w;(l>iL~r6T*t~)^=x5{>IFj2 z%&ERzs_MY=n!P3p(z;G$t4lIK+McyB@b|~c5+t4|y%+%xDBV;jBVUTBe!<`n##3^0 z<tT!6!m;NytAUBBQ$$I(CJLd#ti(o<pUn~h`r8bphQfXnN(m1!>r_@y)<PCqA5tvf z0-{NyP-Pi{3OI;lYE!VX6u~|7T6MbCB~e~ANq3W#*K+NUOT^sXT`bM|MQ5S$Z#?c> z%MvfF=!Cupf*>u6ytJ&Qdiz5~6^A@xwo6*=%^Bnn5XPF8%|e?WCi+HLh?wNAz_<D} zG1ZHxga@WElo(nW@FhftM3*U$28qzS{>~sFa71G@w|4Y;e<UCaVeS;L8o{#|)YcJR zAsVD0I!kE$ENkTta)WF;@QM^<M(XvBHed5bTA-lKKotuE3+p%hVp{f{wJ}R9yA^7w z68nde)(Qd;ODaJLYD9$YK9fpxmLFCciEAJ#A$%H$umC|Y2&iJ#U?;EN_)D+Vf7iF^ zE%_jNTabi)LANZt^ht^j1L{MYb3PSd{JsBY25<y4{`av?2n@$8pWS77%y!&(0_Vhm z3g85iQl-=Kmpr}wv7(x8iU-WbUN0RXI#_l}C9RHqUf3nr91MoMhPBbD){A!;f7!J+ zW;h_fxzXm8t75A!#Lk4-p1hh3^N?2KE;I2Bik3iuE~=ho(Z?D}dD2Xf+d#$=rA?Xt z+r1f74yalV);>A@*5}9g`<od5^I9j^x>oTfv)W8gv1mf$FNi4fJyGqJ&R7Z6?2b3e zP?2KR>v2oTPPrV_Y0m3TpPey8cm8@^tM}swM_c%|=*wOk9eja}i^1W-c%vO`*O1bq zvn=XZLkW)}qP*_XSgL50*}p!j6fbHY#K0Wf3%B$cUze*2`@(mHt%En2Reb8nv+~rv zIc6sk$?Ou+=L|L?LAILZ2>&ldQhHxVvb0|!uKDKg&M+WB;xv&-*`RC*8Qb}rGtx}& zSV4&8A7r4Ei$2cW&8cWW4M}#eOMp<$$Gytn+=EGfo8kcx2)wtiK)fVa%g<{}S<S20 zFJ7M>$f)D<<@eky=jK@VXG_1xbg|1>tM=xMJX3O`q@c)3u{~`=fz`fyHZvHO!&t!q ztoxRQpfD8-1YMWy{ky(lgG}exO?)?q;YY+sR`Xwxlrae0YdfhXo98aR1Vd;Fjl(hT z6b_>R8pn4Wt1sR`<GUCKr=&3>ief(VCC57*5NVJvptomJ6-nR|kU66KYefOrB4vhx zq!-#X&<qpoLazcV9IB%71#@>T9lfr#k<X*V@(qc69#P&Fa5`Vb(k0}45r!ccA>$hZ zPrNX-I+a_BPN8ulbu=G!x%FSkHj)dOYKC)Lze(mv2{UT>Hd+0!HL2{<%&(GB*n9^& z0jpryVy<g6ZBA?wZgoHeyg2bb05q9&8bfbp;CF8NNC*n$O&CbdcWokwgo`?es^oZc zw}6TK0AK|e4CjtuSS}!l@d^PQ#?yoW#1;q?+M4jhY92LVGZqk$@S8@|w?gbHPcWnA z?+D3vdhx-o(T!hoH;dP_5Rod)^B>ZNoZwayw`T3%*RtH&2M)2UiOuLSackF986G#B zGpzEjGF&mN*ta&rRJbMkD)w_W`Q5claB`rzuK9oDFwo^7G(&)7j}L<gHGr&)sV^Nv zYFYiI;&<O-9wOiHWFrkw3W8Q*o^(v^n#^JrG7Wj?NxP+8x!SYG!2Osr{L*0hvB~h7 zWjru$mT0<y*4OH(4eN9p3>)<8Hc|Bb)SmVt@OyUW`{(7A!b{#uo7*gUgEL9LYMuU( zln0-WuS(}k<t7d!0?t%vV$xmuB*^*8{Ty7b&(<een|)ww-CUx6cjKWA8_sUn5ZJKs z?8XhdoYke(h0&$2;CbpCB+w`O5JBg*2u%Hv7wD~;3MUQd1^hA7w4|EI-!;~G7tzL} zjXSy~qJE+Z<ThtV<Ad45C4-4XEOv0v;Y|$s;A2EBy2N(I6+l)FrN+2?(EJl!&WYm6 zGl_X;l3uk9Im?|oXN7aaEXNIV&<=;cg=M?<?!GwdD0k=_6^@txz7RGOv#U1)FQ_Ja zVpQdqOV-D9PLPR*CzOf2rEBwp=svQE>aT}hB%iWaVv8v#3LA(5OK}uYA}fP?U4*1+ zoowFw86CqOWoy|wcir*Y<G6!y)v%1S2CZ{F{<lJoeWP~0Tld4?6tc_%$0Bi@n-urF zxZ<=M1I%HBc?|LE-Uvc=gd^V9MTmHW5QhMA*T;TRd7-MJ>S9ghuAf$Mgy9|W?IRH- z@|yfwREdtToqw{2eU5htJILV^$Ar3pzQ9G?Q<THKJzz)3(8Mn*vU2}aK4YFrWK!6< zaZ?8;$1$aK?j%pFe3CrBdXIO_o-T4)f0g`VMWdYDIAZUk<1xfghDZ>7B8S{J`#X=u zBZvfOh8!|`+dE2%iVDJhD~bwBiUaLUg;ps7aTNuvxDYa$uAy$^Khl1bj5x9Ool@j# zazbHov9jU<3IZh^9f4(_>(Ny&9XPr7<blHnPVGH)VBw8@=l10!KKqlSqwFKB`{=XW zBV5LzH$f5!+;Q;tYg`kpaZ44MQB53jmm`^K+b82GRqKU&MNYtJPMe};y?nOD{2%xw zDo$-aPc5KyHt-WNtzY_iZWpD9076l4M39Rb0O^v1P^c7hVUoSkt3?P>WjKvdIMr3b zaS0qd%9;{PT%dN(tvww(oeQ0>rLf!;YG^WDF|oVYZ-%s_BZIwMvuE3$<+Z=|A1=B7 zIqaYXEtosJ`TT-Zj%90IEXQy)d8G?#SjNP<YR^Dwo|+3R%PlrBY|UJYxJI*0`A6_y z*YHGwTn)!Il`N>?em6O{wtqppG?#bRvTVj93;v?ZS1U5sUb20y)n>IMEjaodo5)ri zeV$9?GUhLkQl!oM7l03x?zaCinJ0P2=Qn2f;QLU`ad{;_XW1Gz<9_7c3Kn+Ouv@-o zSXL<v#IByL?rP^A`QowiPq-o26AAZ;Oc)}Ojru=Mhy_clHniEc_=WM@MVY+C3tx1( z`XaS$NuO7?IQqaX{|B`n@87u~ml(-r*Uwq5#?6!`eZGQ&oi*G?k(9p0V_#HvwzGfA z9f@E$1khF3Nt)7K-c?p!AvZ6vKQ9xP_mJ~O?`E9gSG&nB-{39-686PTO|iG;@z8r5 zoa-W6!6QoBL7q}5R7;^Y>(Mbc(802`7NP3hF6Uik<XvQC6?uu=SX$1@tUlXACW$}U zfmo{Ol$4SJ?X?A|G*C1t6Ss@_S6I7=N&Hf`P_@e|sPht`u{7spMCW-J{>YWs`=Q>; zS?&U2fA-nHM&+gE)$X;<3D5HGrZ+>)&b2ED^B_{~f}RbF!`u@`^u!S=XCvYW?@mP^ z<>V6J<a$!x&G9LY$ngx~cn0I_j5xX}8y!dcI*oQ^h7d34$u5W&G{riqSf@!=m(^u; zS>2Ql=?&fve;)##)osKbuX~qQ_>`CUdX~)HCZ0b4jI;6C_;_Pauu(7MR9Yp$u9Hj$ zc~`l4h5hGA9QrQ$WG@wWJ?wLk_pUteX75?<vXfnBIdxyB5?_D?0$2=)73EqAb#~N} zmT(^)C9<CY=zwVj=?XBJfJ9H8Pxt8@2WNT9ZwiSBfDOob$^pbD4XzACw>bR>?x!n$ znVZjVLTTw8WM4bY;}@m8Zid-4fBIMDB=?^zE;BpXySO4k8&%t9Q?YySO6>gVnTvvR zy?zE~)+D&5_+{X%Dye+(haVsz84>`+MMGR~+g3d#C}{yk5s)?b?qvBp+@=*zkU^Sl zh#S~u8|vn!@Y*itq8@%tn_Zb9)SW50QFr#}8n>&xpy^?S1U<4n*`Dd1>7K0~0vcsE z75reCfPkr^`zT>&0AK+?pg|36003;W15*Rn1Ra!M1z<z^m|0pJ{l8soR|XPA;-cLD zoY3F*Cp=6WYEb|GqSe-T<c)_t|G)oRn+8GJQ5U?a{p&UT^an5i@>_z>zKM>gZ7<Iu z*P3?zdBe7J`j(0E2OS%aFf0|yTD!K1B@%l2a9QoiNv8Os{(qnP%A+#fmF|ezwmh|W zwT_DRyoJ(dK<^l3+DJADB`(#c=g5?na1EZWIPcBt*bn{`{uZHy*MwgGykAttmvhwh zw56V@D=@q${JGo|x6^sA#36mHS|{=AUF&|!B>B{fvJvGfu{9NG5rc2=WO|Sx(C>K) z*I}pOEQc>LNmY(Jt}Ewl_1owB%Omql`hps`)Oohg&Yd{-G0(dqGySFdF7f)_o+PrE zum~R2ift5_U4=BJ@SHR)Z1(SqUTD%JxAc&{_vr^5&dT}heK0`bZwYUy{)H;kdQ-C7 zG2k{M8cxAE>Uv6PVxuov%aGE<MxVU6kY@j<EUl~}>JiY2^rdLkjQ^GhOh2lT)spwG zPg4R&7}8-Po?)gXBc=zyH75vUo$2)}I^t2KaEeYsvumddFEHP|1;CGQV{y*M(%=_l zT!0DFdhwYu<Cj-|G5w{KFQJ}aE1lb4jp5FL=@oG>og1c3ip3VyW2866vXY%a8*1w( znemdLqZmB^bQzXQ%foP78$7!e@(25SyV&A)dc=)xbrwdTZtLUrrl0W$DO2h|PxN9o zC0GV~suw;Rk#5Uic5D-!#{1#S98L%Wx8~|!lxr*|;;0SK0t=@Df~A)7eWfJ`ZseUn z%9c76SOC6zL!<`o9%e_V5I*OCX3j-Lt)=WIntucjASfiI4>S;h&?%^ew)z;B(}Je^ z_K%y`qa}R6S^SdI%{VO7I#mcYd?AwwtF6{!m$(YT(`(Zoa=tn&bHv!LQ38PzaYvCg z<&Fq#OUP7@wf=B}!R|gO@$)OX0WFkf3U1+@hH0^WpqvvLb?On?vTE%(PSGLNV8+^v z)`?nDGwEyA7~F+krN8BSmQ#0T3?Yo73q=x5uc^v}u-i^c7CA0qucxaPLn1o7=VnVa zl1oGRge6_Jmfa@{@(lGWNV-T$Nicz#mlAE2b)Wc`M1T-@N3g17715YlnL2}UsAF%K zX{m_r-l#~}6}An_sXs1+aK^~O74&qfoiYcRGk_L|8fTfB)>p39Ekb`q|3CiPnN+oe zW}%!!Soo7kax~C`0J7;+7X>l*Pu`O5w3L>uPYM=*FY{rKor;GeoE02HJx?oW7VSAw z97hXXt0?QSlTkL^Mj{u_{<n!1*&%9#fzaWR1|FU}GuxmkCRUKc%W5On*9nOdArpGT z+;=CkaZ(t|P_=r_vCilG|8`h7efp7!_m7$gle`&I*w>6QK?$#&JBDQp5xTS>=&l!Q z@@;hb?E9#%pv}><ZJ_P_1luio-UL$d>Eg$&t6=g;&e#}3ML%BjG+P(E@h8g{I}+Dm z0F#RUK=p?u;bmq30beYj(=Tu9>Ys0Jt*HpXl&n`Sa@ld*bh`7UZk8d5rL=Q)?m?~< zD2ML=5rp?bl$eCiM$ThJb{AS2qT{U=i>H_Pqqe(S;fiv^X&ep;FXV-h4^7gD!4fQM zviAhE#X9Z8uuPqLELhfM6ek94m%l=?>1k}S0mVJPRu4xHkR|)vWTcwkBZ4|l!Pg{* z>0x+@49lb+)~252X-<!wCMSnVn7UmQDGTu+6STb_PR@oN1w&(Csz=0`$e4QV5wK9v z0t;|I98D8SMnXxtBGv#XCYUo%u-pTTp^b_#3l@@`zz*(paINSs6V!`IxE~PKoUC4b zzP*~n7I->rh0G`_r`pGHsXgCNb{ZC+WVNPNtqo(QwJaB6%G_~G(5ZK{qH&<HD^%7* zas?Uy<g7^B%9L^T72Ny#cCTuE$y6L}N)ndzPJ2XoXO<id!tlc0A?QgvB8P>js86~Q zcF)sld`hl3FL6r99PK%hdQ3_~A|>ScC`07pl=5Qit{8ph^s&DnrwG9Z@=l|sQai_) z&IqOf{i=erD%oSd;*_T4Hah$?9k&LrURKKZ2Or473yiLTMu-s-r{jG??yY+|um3$M z6%ZsD2zo>j&k-)#Xay0F4+&M!EFKJ+Q@mi$kU%{+T6uZE^gt$wK9T0%n53D6RbF8X zjfW2WEQKappf!uO)n!5u>RJOgc*V-?PD7_3R3ER?-_U!+oo$jKOBmF$)*>IbE$(z$ z;shr$LICGt@>K4gbkFPg$7Q={BAxBMT<y;sk0>p&IHhAQ+kH&wI9<@5%bfTtZu+?= z%h{K4v-?rN98>~C0NF><MZV4;Ie^rXX<pKpm<J0N1t@d((L;m3<dR4W(vfZzuW5oN zx2$U^vH?-OtprSR%}V^hW%E;r4VG0%!<Z7)<?@^|zCb<s+2f$EP&*mbQh7L(#-bj+ za@Z?iWaZo;6r*Bf-!&viI4yItPb;jKd5>lKE{u0r{<`R(2)86mPM}X|uBuQk1FCoG zK3Eb!Q`YHLNdg1q^by$<^OBri=mA5_65V`E9~TvfO;Y^$>gxZT{*hA&73d5Z!3iA> za`tD-P3~D4ySS?)8SP=6u71W#2RT)ecqY-IvGJzBh#(YF@0DMKUtm-_CENGL$nghQ z%NT90K6(b3|2SPrslGfFMgdcaM9vl=Fag>IbyciEp$mcfz1sZPogiQnu0zP9<+Ce1 z%qv1$Qw7lKv|z!(1c5nb7R)P)h{h~3V(xSuL#Pj576(yb>ciRjGG{|&pD{3gj-p|j zZ1<jDU0X?Sm*ieR!HWFh#MCD)fh4<FSZcQKpWhgTkYXXFWVCLMGt^Dm1kOYkZ=g(~ zJCcFkU^2mesgcJ4N_+9t6W#9CwX0d_#P@{BJ`ygDWdh-i!3=rstdaSyGparg5vB?3 zXc37sGM>hP!Yz8=M=aZ01S=+8(T|#4q>5zB$oxP?_4m?%+dMVXY*Wn_^Y9WrlwL^U zuRy5m-Fw;=AU>>3P>GongpvAQaVc}@DwCNzBwl4$E<ICMOgk`DRhfUcNGm8SYsy}L z_rgy}c@=c|V(l(nxZj}E@_aoth#KPP1F5`BloRPK;>e-78?&biD*VdyFET{ovVaPq zR6Sq4YwIAtYGqMc<DV(h*45XI^i5*7wIvqNiObOPVuljAc#h3bXE2MK3RArFwt7g5 z2<d=nSmYRvWn*g#Yu|)n))#N)F>krY1sU=!671&G8@c*tduvS*1dGtfR}}=e(>D3l z9f}jvx5L&T;{xF{MPoXBg>aS**B;m#U`q?W-MXgLLWxYpBCokvHa51zJ~Vob!8%zb zq@dnpc*zn}AG$_Lx|BjpWb-H4HZ3Pj(^mZ|J0(DD#nf<P5wmLvl3v%!-+-?hvK6JU z)VuhRZYXY|EB=YD!Pn6f{Y+OqcNHx;>oO1D><jKl#FxQ+_v8!cAKQ19zwCE{8vy=< zfBEBRI7s`wZl|5JnvJ>~j_^{qBfqBy@MJnGL#bARYtWR`YIy=xZIsQeZ?5J+1WKZt z;h8)LpWG6=3|r3>{EdbIfe3HK(RbOEK*?6-3~64o87tD}Nzh%fd$OJ&wy5I`(#<Ts z9eRTDVra6T#27l7s@WI(0<HtQ^RF8dxfbeBK4XlbW2bOs)T@Xam(~tm#tRp%<G*a0 zkDE77xF&1(E_P3NtoL+wW#{dVC#a_WkM$7pItij;=H&R+i;^4bZV9)LNq&IL&t!4u zCM4B}PMVF)Eev^*dQwm3(<3F@j}T8IrWES8ZZd3#VPPH1Cd0NC3-s!nv|D1K#X{@G zvcpzsLZtMdezy>TIRu8Knr6jhw>f=SwmC}I3HW4)EkjHb;T<eRGEgm2`%wB0h0d;u zX4bo=Osm|2!mWc93-i@CF&Zl=Zv-*{P~pKk-j}qYZyhSNmz(y4AcH+$N%b91lWb`~ z)fcf-HrT2f`R*6G5RTOi%|F-^(@IVq7+PWVPbrw$mK8YIRKk-}pD7*De7KyyAD&Gp z1KHQ5Qtt@Nc*=kSes#ykC&}LrrwGb)kR*tj+~_;ynO0sxqMx20Bb=jWZ*grk)60Do zd1f%^(6A8HX+~+zc0_DHWYZ||IeRhLf-@`*2zvvEh#;FYDy=cwpdNIY=l(9V7d&;g zj;)lcMHS<gU52fL)27RsLa@?z9}3VMF{L}y*09`I?V{~YUjlG+FBKIcEWJfr$hE>{ zOcPXRM<~>`O&A*`yZUk`xQfq7Bb|<=@Y<`3)d0!6)+3gpmt}0UxVUX9mSv>tTa6)I zF0Qim)BPMu{ys*B&_;wp%56hCpc2~~914%)dNoC?pJ#+O52|YU&8ZPIp~I}_zUnlh zyoWjYUDu-3rJ7yzq0*Pp<xN(1nfKBIGS`Nh#BHal#!?%rD_aMl#@npgV<lV0(<Z&H z`4}?&;_78mC>uNV$V=@zB}^EjKlg%+A*C^yB&M|M6Q%A>?VbuMc}@yxZ`GitS7rI~ zHEHlQ3A^}Lr_aZ#rOGTJuLG#gq*$xAizZ5&hCUPxoWVoBR1^;iZiv48+0Rj%)^|RB zlv7oTr}{>$15@#(n%&7Lq?gf;G0O-A+f<AHv}v-|)qCv6#uirf;gly<(?4~hHm{w) zs<BnXVjA1jtw66XN?YI5F^tQ(XXCh)@6-C5TBK>dARVKz^PY0Fv$IQLKGB(6({@;g z>>Y!7sQBnR&XU|&w<G&|uPpmJTRZjOxMf$v?{DKjGIK2!YgjI}mo-X5_E`A_EOb_9 z?qQMNM}Ofnair=#7L5Q_T$&eOAR_`(D)++MIw<Fp<$jmF-4g89R#A<-6iW7+@{=sh z3i}r<2$UMd{r}F2`V4bgWOB2N0o+bci&A7Dk;T;kcPH%bn?6A{EcDR(vZU2rQ&J{> zt+%Vw1<&PS5Lmn!lWlD#-_fj`iaQOg8iK{#r2y^++IOprmO2irc2DxZy1cGi+_eiU zdd9|g>FxhCC=hAKo`k(xI0V~7!tBvDeV1Vi3kx=Ff5h@4*}!4!6sGda7-5-hrbg|q zX#zpATsJ47(SfEe(sI8WWP6vL-KTV+vO?NS`>G=4nmW9qiKl0Y{Z~z-Eo|F8!SePA zL|7)^gkQnk4W=V2$Eoz>q@Tk(ua%*d!;`-gXhewU$SZ;0XiO0WX(sG;ieK@t6 zBHq{Ed(rNRL)tz3fMaB(P-h7%OWeZ9euupSbnC~v4icD#SMII1Y4#)OYX`|&>tPA^ zP<H8sL{5F+Hbqp6iJ1(0;;K|Q&8^LSP5yvL@{WUI1vZaiqkDcjD}5I5Xmbyjv1`k1 zhJA`B?kRh?O4LKYRnNEU681JDQ{F>}8u!(;aV<7ABwFX%DuOl6PzTdNxr^o8Tfa@a zAH<^~)?3RV!(MZIRv6a3*NKKEL!X)xqQM?-x_xp|&biwrkL@0~wYr=No8?Z^(R1{& zn_Mx<Bb@5agZ9z#aLwSw!kqQn7^l$S$#x_X`Hx~hZK3A`ymj#k!ne6H(Km@e{gx}- zinniTYar>WHml~-x;lZ1oGe}Dz6$Y88Tm{b_|UJEz!t6t^iVb7BqwgMkv%PEMgB|v zs;1t+F;EgQs29G)P5f1Rm{lt3mF5g*+<BVaoswGJFmXgAQnj?3t%-@u6HY0kR+3e+ zY*pfou4QywV^uGJe#i>ZYI0Mr!&<RM!z@9`!3{f-J*!V}ohoUoG&$h*Ff6jgk|*)g z0B`2lr#{3gL#x$=rCwR3Ea^37a0nEWR39z?PT^bx>*^Zc^OC_NV=fi(Nb7ClfSv4l zj-fYs&YCe(-XhbSu~X*!yx}r=nEW%q;frgfE4h5X_c3vAKxf>;<=X|LLK);6>L4kz zyf^g1$-bjjVrnsFm!|RMbyLhyl6*>(xakPE4>RloA#0)g^_xo6a`K}zIYtpRMTbBi zgN7Q~3!20qUL#CpPmdSVBHv;G$&@5L160MiTr8o%l{r*44k7uZ-StC;JzV(?_2k`p zu(9tCs?<-q_s;1#XpxfS1Ve3gXaj~Kwn7Q@G8By%UsQ7LHr36OP-G-%$qwEW+xD); z6io4Tmmjdmy3IYjm{O!;6F6n$=cII4jGTO*espxG=NvR5iJbY^JPbIo(nN^Rp{nFR zx3eb&%@eM3SVpO~4a0h?A8hWk<Rg8cELEMQNMW2*DU+7)UDPRGq~F8G%(8jfS06^l z^Qv<<US);2h@QQ}n5CYXmdiPs10B8oG|tTDRhhzN>d3XmzaIYiG0at}WXYau#c+rz zW}MU8vp4@)MrPEMQZ@5+$yv&Q*L1R<(hpHQ+jmdMc5Ajix5Cb2uCSgH3@Iau*#Cw+ z3qqNhOFV8cRl%b~yFY+(PV?F%$k|W<PT_Wu$BTthRxzts{@$|S1~(=TrFR5xNxb7g zrg$AGawi_X^tD#gJxwu3PH{^3PW~@ze1&MO(4gEjcLs@S>MVqt^c9VSiO|=~S=-9f zvg?6O_0Sd6sH{wVV7PaS9Amu@s;@1hf8LFum7&+8&YsE^LLxX(6$y%nIup^jQ{RIx z!e9RK_v)YZZ~y5{w4^dm4K=sgR|%O@?#BRqo9Va%)*hJZn2P8ubwPw1;sM5K6Trg3 zx@cJ#LCho~W?js|1{Tr<bcA^>9(&u8VlLkM>#X<>K^9xWHa2h;-v4jFfL0A{<kbgK zT}>L}ywX3sfB;`0Fc5%;w0=6-7~1Md-)*ViJkFlS;evllKg^t|8R4*Y9kBmtS4EiJ z9l9ud`RGSLmR4Ul%fWK~wQ1GV9~gguCKWMsGz6=O(M%k~qX(f8=voq{6A^|@nBB@U zeKg|GnPp$wt!2Ko_+F6!y0nI*5;3aYfSD3)#!R`L(PmQ*{~Q7j?csbtLLay6Br)2H zLKj*AoTuAP7-C`?Ne(UJQfIV}Wt`*a0v`Pj7qY1SyltcPn(1LJ-Klrgst#39vq$+Y zaZs)|)@)@Hu`Ox~jtf&K>ZR(VlpH1*uy`8WGDL6}nnpK`_<OcLp4saX-<mk1u;j<L zIM3rlaXw4N@q5c_d+_a?sIhRUK!yHP_3^bCCz?m62eg*`b0P{BVw|5DoaJ<egH08M zeSoz@IqKvvA&2v&lrV=et4A1Pi$WLt0G#1}zriUEv8KygPX&n2|J)p?3W41yJPx>> zYTl6LoQme`Y0k1bb9j@}1J=V*M+f^@4yQO8fM+5{8N<F8>}9iu=lcO+apuSC&_pWl zWdZKL@~&gYjE)E&rFHLe`_T6<e=bLFYI(P4DazXt179>NH!KG`@^HgPFdTRJ5z4C0 zW8{QrU59vWd>x~uF+l4k_9AW2skV0|5eGn{&inoI%@luI%A6D^{@SSY){xVOhsO<S zggjQS0^8KWp{-G25L8<*5E%+U#slx+wY3kJ(eh6L)|9w~&yD-^h+B64NYfQM^Z0aQ ztR3jgI*L0rH+(W53fcYNtq48=7nY)`q2bmqZiW5TzG+<R%N2t0owW`eKf--9kwPV@ zib!;x1ZZh=Fl9Q*n8{*~<s}P{4ds>0BdUQ)UzPE&vvH;|fZvHb&m(3WF(0G2X9O{k zh#O!kF#T>PCYN2>3EJCC+`5IxqJIPES=k3*4S(8<CYR0OL=}yNJYcI}qy-z1tpJ2a z=+<dW30Ry6p2-<R_dlU!(DkO{1*^8>0ngp>6T&Umsn3yx#wD;c^#RS<rJe};aaTMp zJ&Sr%tc6kAUm%a&`JI)T0WOpmjaA-m<u&{Mr~Bq{b?-X4kQ&!|KtE8|!9jN+I&bpM z?b`fx>qkZdS&)q|uOyaP#BpGlNEc|+)GbR@?b6{i#Bxf{j9Ni~UZ90swG$^kRHC7q zF05i;Z8j|TaAYQA)G*nK7dO7u_b>JUb?twanP1>VbsktbR%Lu<Jkc0z=Q^QnW*o#L zPFE6_lZc1Pu#=?RJ%Uo{!}9++xOpxgkn%@uUM`nB-)>G_qvrMU(!J9Ak^IeqrUB^8 z8&v7KCzaE0rkQdzqct*wxX1aF>H-eZxXH4NkMjWuQy6oR%lRRp3s>>xJT4H33vq^< z?L%BX;{4wX3(n(m<_~YOcsPJMawNGtm_H0oWRCFGz4DvO{2b>EVA00n)sp+RQu!&v z_^YSV3&}_RLH{l+-71z1I*Vh+YKs`^w&BCwt`jTWR>l|Hg<P<2bwc}6@|c%r=Ivr0 z=L=3WliBRLgt<V<zOL`h+wJm~`*X-rJW<+-Gb%K16ayL>nz&7@qCKyw2WacMs8s1G z$HJ*M(?Ypg(5BmE-F6;T6O~u}qQZu&+pa96`hW*p{(L~f4#u3Nb52O;!ZY#a+})cH zH{uE2PDbWBfI52oY8OYH0p4f_n@Oqpt{!GE%h)?{ImB7_!MeF@UE+KJETr2-Gkl-& z`+pP0OSqfz{e6d#mUmxt&AaGf^3_Jui!ik0Yk$nSz?~+M{O11vSN!nouWZoD29&xi zvV^l^gW+%tj>I&GSbI`$$nt&w9&}FAcjDTvDUKkEjljqkgraBg-gDF7sE)}WVH#Vo zrrPdgzdwnFdq(s%=4Uk00Ek@w!t$8mbB1DlO!L_*2Jle~=UD5a>al0s@>un#ixGTY z&nrsra3~i^CBNvo%oE9vrg9CV&oOd8u5^#HN7tbVrF2T7nsSORDEzXBqBp~?MXuAu zSQB3-VZJODOJwz|kYDs%=85Dd_ewnWe~{ym2O@h6T2M2{976s%_h577caqHCpip{4 z5GtYB<UfY^T>lJ<)}K>jKOwBC>5R|^n#6-t_sl3h&{X0=4U3hYm^v36Tnzs?q@kwH zAsA*BLQOjASfs4`Q$qFeReiqMJ<ANOu3p8ktlxCdwoaGQh{rNfjMhoe>$*~tA=TjV zS$)3Q-Q3<+Ck!us3hlZq@2+$?T|Le(*PO&d>5~Gtd^g-qPmSw?sXh$OP@Qlsg^;zy zGxpqV@2gApB{GL{MLzYi&zF7b^vfP!CRHDX=uUupz|(uAp$yLz)#7DFs~(s98?KuA z)y$M%e^i+Wg?+J0zfP*22dO-wk_g_MoV*NQIC6Y~x!y8OC~SNQmoC+km$$<gq+G6C zLME@LN!80@Zb|6}3WcgD7CgI`+h5+M<GeY;X=;C6Qz4(VtW4rRO~*1sOS0_JjiSVP zbH(JsFgPsL){sS#bTt)`M2++I!ZJi#PxTmfq-gPs{TGe@N?vPi>9$HT*4(XvR2(sh zL@F?V$4tG!LxGwMlccM)hkPhtFXIAe@xySe+W|zFfAc&+4?&t&ha>)HVgY>;uw!yD zB|-XX#@}6_-tj$s4PN%2lcw)5#@l~Bj%Nr+$WYq;EDv!(=4tahFAiI%4$`HHOJQkX zTLuM^I`nu4izIVq`UE(UWVnxjv-ouM#gk*-^B5R5i{Sj1-H7>E>?LWU`5<}O-_Y0a zU--eQDK~=|(U(V(hfkK+yqCE47<MViEewfels^Q(9o8XIP;V$|lTwZb&h|4ACzMwQ zWCs_py=$M$!y0C6{-`&gP)qtMB#4V}?|WccUWu@rA}rZJ48CzWia6Royd*c~as+9o z1e*D#^lbRODbJN5fgdQauV3WiwmYZ~E&9xjy=X^%UU|^>+12WIw9FJ!D~w9$)uHRQ zHlOD1mh7~m-LB2Tv+`7a7pv8At)lkZ_;2U<Q^=2b|Nnz&Q$_kG!PsM{yujW$405JU zB77!r4`D{5h~2cugNqK@)X=oUuuzNGR_j2F!fVkA6kr2*nwW3&QALBQ%~iCSE+YTR z#0cmDzK3(C*3Lqh($n3*{Th`@trLk>BvX78Upqw#f5eGOE%{tl<h0iv$ZFK21}O*O zg&tmOPc>{unlUf#Z3Pmi#hHBHcpmCIFeTcXcgrXe-JxN(M=`G8z}rbeUzMK5xbRQL z%I1nPML~nw1sZh2)TPUuX52vjs2Cxh8Y$oA<cycw@m=cl6;|<ZJ|f2cm5NEL!X1Qm zP5#eF95+<8#yt>l8Oap;KnLIrQk0W_0YIE3ao#0=mYmfszX~)9KRfvwGs#z~(!7d; zw5LR-NjzveVya<rCtD&dDW2%-`H~oI{wY?^^_|EZVyCXN$Ebo@<wz-)IK5~-58(2n zOkcG6j@4&x7H+^;{lYrprQmT<j+E797B}^Q8df*4m+T}dk+H*$q`(I8eFOx7h|NCu zAR_c(Ax*2ts;XY8rik=I5?(y|dqEIg3nIrHR|6e3kg$OZ8+dSp;8w-?^VQHB1vCH# zPCKACZo~)2z=91N*g(Jr3`c-TF$JK220#G~fB~!`y+1y&F|jZr0QD~@d^=S78H3`i z2)mRN<nR|bwY%aOhYW#!q&<hnD{K26J_X&3?*Vk<@Ln;_C7(z9TluG8G5DH$-!%@E z<61_4X<Zj4tm&2S!u>F1U%+qgsAz7ei_W!Y>!pv>`!W@Bvz9Ej5sY#am20EDR@F~L zQkXKon9t`6?{zL0k!aI(a?E>)(8B)7Dkp?B)5{BuaPtY_mh#F%E!T8Hc%FRgB|6qs ziFcCCR4GdpZ&Kb~(Cea}f@%39YOgR7E?K&a?}f|Ef%Q`aG&t3@#`ohtL%;pj#YdS^ zP(j>EIKW(U-In@Eej>|GX_ckUjVoFWFKhUkE^EGwdf$>Zv_E#q?mJM4tRJ4%W_8_{ zJ*?8h`Cy+k)q0-1?EBGOK$(zFO;Og~;&YX`VYsw^B*DwtS8#$WlfSzK_>sF(c~k_{ zG`G8B>bec+fEvv>*Xn#ic~wJfl|{@bL0?!@zOfj+y>CX3(PbRskI@guxv_cI@Qx$v z+%L^~qsgg5^YUNsN*<UtaE)amT1?;{2<0_|4lj>gVVLx*cGh`SUXicyi>J?NotJff zaQd|c5N$dk_>}7nVMp-;zd_%{5iN#xf`)Sb!G+GR+Rd5pY>QZ*c63Z%t(aGV{=H2K z@~GkOLmh^CeY^^&i3W{<ZqqzO*gZ;*X0i>9VlM(G>*3r-s~-q&yyf-y+7{)VY~gPO z;d48yxr;h{pm9Dc<OH=3#80@sKP7LUXv6-J{(Lo>Lo->i??RF3LN@V<yq`4*rWuJM z^Qn^(XIOY7{dZZ)LQ8r0xPax==3=&UVkw~hen92y>oOkjX{d?=R#o{tnDGe}3ljbZ zbCTZs%w5_lm^af%MW~pXJcO6QGJ+}03R?EAYd&`KZS>W&IpFj0ec<xU2gSnvsw(M} zBE_ryyCjkHW(jXOT}{(^H5G-Rw1Nt8LnE}NfTpWMdX&{~qa+FD#^KE%Nzh)ETaxr{ zmR1k8&mV6J!}nC%ix6{Kw}<PN1RfL-w1EFI%@Rsd(kvL!I9}O-2#xx!XH%X2<2tfZ z22kr&i$B0tJnan+!3=(s_1Sr<=`0j5K(H;S3WP+xyU4E>tkwOo<zA=M(4XLpVkpt4 zcA?Ibp$*R-KgRudaPEOD$sSCV%z!zc<!x9tM?3_j*Jd2|L^m%7f5rAzyb<KG9IDw2 zEcK%V|EgDzX8v~48ZiIG3|eQS$fM@YnP{9jka$QPo`}HI+19&=ogH-l%nLp(=7g>P z58NPVR9C5}G3?EWX0uB#Z|=Mi1~+cgD@&=N8Fp{%b~{TW#|Vm<ZwA5uCu1ON`>Ey< zPRrO1X9`=7B2apcBtm0p=oxjq!ozJKbI%(nEOm<O-(e`7>S#tIYkM(kfab~267)N< z{x8^+4s@>mnZ|QX*4cmV`lpRQbWMK-XmYDg{h!+<>6`#bf%I#|<*EruQ%RjS&gDh> za-``-GtZN+Oymkz<G9zyzTxCVn@z*GpPzQU?W6oU<T`A?rl9$gzjrrZzVRJtzpX@Z z)H)otWG1_X0|jxIp-iWGTI<1<OOuSF(l2{ME5e#!4%B+5-M`w`4_9k*>hy|*Cs`77 zYZ-WY1nO6&Rzi&kXL5c}o+4158X~&k9|iqWp3Iu^ao~2NNeg5)S)q&K7;LQL$Xwnm zts)ivo7^mZHBLx?*LQD*xdQlN#Rhw*5%?8X{?WJYa5>pD{5uR4Zocn#I$(Mx4h$Qg zQb8fwsQb!QS|Dos{6P{{hFe9TqqW64;%Pniq377HK<CqnoB5}{sLsN<p~QAO<eSMz z7}O5K4i{h)P`h(!59r@cMfc?(CIqK+Y%7e|_7~_ci`VCXF>CVwSyZ4TG$%kRNF5@1 zs>wp~n}AlD!$Q9PC?p2hR|p_~6iW~u+~FTjk-tM{knXww1g09Q21Kr6_Omo8S<Vge zKz8ImuZe?+D^opD$|zP~Cz80&3$WBBVPzf@JGa#=wqg&8IL<?uU}e%iB%qr11Dc&N zXF#^Ro&)j&0FBU*;C9tuS%5F^eL+G0^^PkOo7+pgmDKP88lr<}KZxKc`VL@>*%a?A z@Pm<hXz5X<?3$c^Aritarsso2qtP`$PhWxwD^=4(sbp)Cbyv7LAO5j>mf??Y`AcJQ zK9lT{y{`)Eu$veaT#eK1dDF2rP&0q;?-kIjjghUg$pm^o_8gCb@81^c?B`#U2OMW_ zmNuiCgP#ypecw(k|47-Jn{*-&?N4)3`+=?p<2uH=T7yk~x>C<;ym_NuZ%VCYxpW!P zM4^j3X27<sUC4|ao7*b8l2I~={6y%5D<cVkDiwAaN7i=W3HWq7k~2XMu`S_D>jW$l z^&s0Mg4UH{Y!<22kld_9DGCfKuXmG3*^{GFSjG4+l(C~Uh97Z?KMX|UFGpw!T06-C z#1rrOm0}-%y&^Q1mO%!~-H{i+KK~eY-A}^JEsj;ViK`*L(mK}bELLq05yY$&B7%+T zPq}G&aX?ocC>8Gm<GFBX>$<V^xzXf!yA3BB9LQrE*^q~#Hwhr<ZvVfooZ~~Pu%yiI zd~3A7!Sh_L1ZA~lf3mw||IJ<7@}3H(6Y2?a$aCN=FJ76Ey{e>iHq=4E@3byg&ivAW z-&D3e*U?t{)L@O0M{?9Ju2B^~^WDz=Y3!lGt#Ts%WV}XqP*|coTN6nYe`u>bluwFx zg#aL+{2#bD&sY67EuZKH0PVNMDYp;(j%9YG;r}1VRmXk+bQk~t0{@F8E#yZJ<mSnc zpMHk%-FqNr(*@toIV$34ZL|aq{S9V?!SQ1Y1HAisj05kvHT(P@3_d*zDYBzW{QZrG z;7JxsJ>kK~aitL`gL5t`qvygjFemrZVSjnB&&09i>>Y5%djyk#ma}t#x&N2F65L=C zIHH#W0-ruOZ2Xy4kNJXd_?P&>p>_u!#BW2K@T3~YN5nhC-@L?{<vf&@bTn|wW0WdO zAIVZ4U<^Xvmlt_{F#5#5BKi5A*UV$4d%yjvskw?A1_N>tFpCEE<Df6j7fu6wBcHpx zLS9_kLM(qSS07R3A(J?Z6dG@W-$Paqop*RlzMzo+eaOp8{4U`fs#9rU+iRL;r#iRj zV|(ttb_7u$N6b<AW9L3OG{|RqZv?jihf8~?MNdqnro8*~0WCh=bsOBQ<WAyh`);Wt zDYbKMT05>LzE|z2ZdKd8Vpv-x1l-oG`Lcb@esB91TT@ef?pVeCh{p2kgdO|xxlKQR z+hPn|<-faC2+#XxyXIr5E$#Q09h&}XMLo7>mcH*^ibLsK!Y)P$F-w@*za$IE;)%^p z=@PE<3U6JseM8+nmcF{1JurTaE<~f2Q9Iw5610E?voQ_$k*FYoJpU?s?&r6|iOGgK z_uyLWP_!**YNnnqf-Nfu;CoEQ5Qv1$u-_hluH<omfB*>GL_ilN0GtPRJL2xV9ph=U z6Er^BN$z>tX~K)P)47&sXE;#3o#MV2JCkJTcD5}$Yv%|#{O#N%$Dei{|4Xi2!1{9U zLqkY#>AIa#w+lmc<MOqYwblH&!Tg@)D5zTGPoQi$*XVcToxuY?l8rVs_6srS+AVi) zdAX+QrhKu)wOmHrIJ&utl8yi0``=8Irwqz{In<(j#M%omt4k|C$M<jV>N%e5W677- z`oHH$;VTj!B(2JvmgQ;~73iesdH^ZMrcKI@Ukn?+c`^E)0i|LJEBlZd@ky@VqD$Oi zRUjrWy)}#(UJ6gv{F04_{{6gY4Gzo%E90ly*JNoH>3k|=P@J62evU86#SPOMmRTNn zYZt<s#0bS^wH%}O`M)X-h4h6|y%v)#d5+0oAhl&SC{UP+$S0O7PZL&bW(Y)5MHvZ3 zd>3GuGr+!Lx#|o%gBRC>-H}!*)XM8__^*^J@r^{iBxRm^lxZ*ul2M4FXJ$UCAWGxl z;VzzVuc%6f<u-a+gP28POM^nGpKgr1)9Vgv?k^q_omMgZ7az=cfsc<{d=CJbJ7KtG zp^^wh!Xl;8qk$8-Ax7AXju_w^g_zJoAvP9b!)^6(;BH*R0~fA-#7BaJ+%n0OduHxs z?!E_pd6-3(iFjniGizQ0o3o4#O5Vep^Qh1z;p0(Kk1h5zSxz#ND^qTm4}AFzeNKZ5 z|0h_df!uP>LqMK+rOaEPXZd(;i5CsaH^2M~5JWXZI{y_hoZ7q8Dhn1|h^|6uElp#& z6_yp&2&=4=*GQv;`yIgQw2cx`cnBWvX>|L|E$Zo@We2RRbLH+|hOJ%Y_OL3t>rZ%6 zGNN823XQ1}i>nG>HGxPX_nFDnQm8a~UPjwG#LSn{VHUd^bwql}_EgiV<MQ|kg1#^~ zhzbB=iBuNsh`eL^991Y)YE3At)#)7)^YnebZlzT3+*ciOb*s<MU8&zyUVH?@36i22 zmg5Cck`-0c4b!q6x6y31JHy_C2LX<Cr{2NznVrt&i{)y)+3xm-<LP|4-tG?o5hj#z zA=Qwi*{pj2A*Nhv({}wZPQwg`hk$6Xd0Dsp7`~qW)4iYf`#nDhqc};kyeO+W;~NJ! zj4^>pOv7}{z!YX;791QKb1)b4FdqvhoXJdQHuG7`aw4Y8n6qF>#ELZ=V!gAPwLbl` znRvFdoBbT-ILV}w&1v#EPcfId&Ta1VnCHBvocDYX8%BuFmYrgxLJ|e8*^WD3bS6UQ zH-7?WoihR($6WJ;(75h~^DemPl2cBrQHzG<I4PzS+w8K_Zkx@MyZ~Dks2XEIzE8E` zw#uCv&nKT<<{*tDdpWXYIbne!VKNuI5C`mED9X)g7Pb)^IqgO*d=VSHF&n#a8@~yg zxJjEVRg;nSX!T0FM$H<$)}rl;%x7V6ikU2d8?7=~*IMBulTUzqhkf;VFmpcN__3Z^ zYA2w7cWO7&I8;irNG^yN=!=NA%<e%Me+CBY;3R!&Xam`$Xhl>%C^RIjI7y$$7exG$ zacuRxj;Ap0NR(7n>@A9T7^uY=BXJ0h(TP!N$E@wIZsnL?LDkHzW3xlM@u~*nr2y|T zyT(A@w#PQx=y|-C`PJumJba?6`ArF_RGzxJ@9s%Z^e1IO6@REaJXvV@HA7F>-nvjr z!{J@kS=j0}7T5M_@zuL=N%(|fiZ`~}!1UEpjiryp7Ct*kFY82iPVL1^u6fr_<QOai zrBnqBx?li7Fm|&9AC1=r+8XPwy4`MR@VK_0AFr}5qw~9d)V<SpHuAHNgN1yIp>b{{ zqd#Z*b8=8v<C$A+gKUn8*|?%C;e{o*$R64k@^QpIy5n}nLg)kw&93mp#pPde$rF5r zA9;eGeDV+f>v8>7rJ?pl(@hZ{Z>~uL6P_ce;1J`3qHi4x6klvtW8y`wMrZ=X(5cFz zS+X^h0YPnZbm!F=P7;(39S#<4F<BMM<JN|3E~gl^r<2t4#ppm(h|o5`If4q#a(pzN z1po&C0DuGFA_eSnOd2DoZC<20X@--87So}_!J;ijt73WF+RzO&GLq_c@_Bst>$%>C z!9SM_@BfP_1t}qe){@XF$<CD+Qk9@tI|<jkSBJI*X4Je|ln|LdvV4?KW=rae|A`!m zy+)@#)e_<Wd=~C!U+gp#t0ChY^F3P`ml$X}u#$R^>3|XBx;I7^nKTbhh9xsSv5xiJ z8`!?B;}VvyrFqM|!fW#BKVY|!Vf(z_MgR0Ve~{6cGjAtLCEk^PxF?spx}~#L(*;w0 zAheiG#R!I%Q@xym5Q53zEU$?pFWWnj$A46Atr`3?aLs1X_G_Bv2mb_JGd8*dF3u4Y zU^qciG71^@1MXd5Eiy&AnF4~OBHjDv${XigfGi8~;UAf+eE51(m%0la9Xx;CmVEwl zjc3**zDo^x^{i%WI53OkX*f8VjAVeVXwRuKaW;4+MB}W1+w`FUxbj-Q&j-h!9Nm2P zI=PO-_3qEM*V3PGMO9!C)!Drm9n&lrQ&CQ$NHMZeKk&cbe=tVRrgBSfaQomB7rym} z8!n+&b`lt^pMdw!?E{h?eDMDGGY9V-q@(qtb4NP+9^dg&`?7uIV0zFFym*<@`X8@e zcz^o+F*^A8q@NvO19eLSukL{m`J3|Lb@__)y5^nQEB6~k#s}oDnpB$Z`K`RPP)AMk r`LnIb#kb!df1$l@pBzjME*<C`N)7jafE{0{?e1V-tPf&s3;+NCL)9GB literal 0 HcmV?d00001 diff --git a/website/public/media/scene-dark.png b/website/public/media/scene-dark.png new file mode 100644 index 0000000000000000000000000000000000000000..1636c04062fc306ad14f8698fc55a539480aba9a GIT binary patch literal 757 zcmV<R0t)?!P)<h;3K|Lk000e1NJLTq008g+002k`0{{R3{}PC}0000sP)t-s3J)yA zQhM%gS`HF6ODcYRI*2PDUKJWeCLn4`FMj{BUOg{>|I%`dQkMVr&;Oc4VML9~XNv#R z7is_i010qNS#tmY1Lyz%1Ly&@ds1rv00L!6L_t(|+U=GNbEF^)K(o5VrCax||NqaP z9qI`fLV$?6@|bbD5=kCkQ-DUJ(P$i*$JJUb{(3z2p$XTq-OsrRzdP`_U#r2L$!NHr zoeIL^!fAxZv7qW}36DOf+0vO@PWX72*2l$oGvRNGCj557-z%E%;e}uS5xcZ*AIEJk z2bnS9c3563Bu0f3`HC15!aAF+e0}4b+CW}cM)(V5Ghwaege9jzK)AcDn=S?)&Hjbu zUD{WW(mJ6-&;rE9>PQIT!YX$Yrj@G->q-#5e+Z<7bw#=Ya&sP2n6bjy!dicJOVd@c zGdqnGE~^xNQ%~p}_zXbxmDLI<!72d%8=i1%Iw}b(l`b5M%@Z!!Q#%V|QdqAWxw-I9 znTjN3ic*Bvk)^i=l&mbR%!`%Wt|G!pr3<G;pH$eE$lDQhfYeJTuD}fM`+f>G&)ULa zWu;P;*};?Q^u?yam>cBWvl8?_n5Uo)UOih_sXc|$WjO!i9aK0_)o(C%l-A?mcMOE@ zO&KeOFqzpG4&5ETaOhG6IiucGPY6FJFyXXak=kYQ&TJ~|zIZ-|2}{{}N((<71`7~4 zh_<g&ko|i}J1ft^rl|1Rqzk)>E}+PSa>8~}lW`Vyr@__r_5@RSAb@!`X6+<(wlFs5 zCewQ5*XxufOs(%E>=&`9%L#`{@Xwc>+3s215+|OeyAt-3N7N(2rixezcxLQvOc?u) zE$nYSdS2(hd!&01V?OtICA^6RUZQ;A)b-7+gqsHn6Gen&b;FhL^FZ3kN@du9vOF+c nj3(TKn{X3u!cDjd?<f2ZU_YCZC(;>P00000NkvXXu0mjf(ko$2 literal 0 HcmV?d00001 diff --git a/website/public/media/scene-light.png b/website/public/media/scene-light.png new file mode 100644 index 0000000000000000000000000000000000000000..f57b4eee9026a3728f2d8a58bf5915533071834f GIT binary patch literal 758 zcmV<S0tx+zP)<h;3K|Lk000e1NJLTq008g+002k`0{{R3{}PC}0000sP)t-s(!}uR z((d-$<V-%4jeppsmf~t!w1#%bysqk~nB4#7)|!go*UR$%@zDSO|Nq&j#JKJ1*YFqD zi_`!B010qNS#tmY1Lyz%1Ly&@ds1rv00L%7L_t(|+U?eXa-$#+2H=f05*nMkd;ga` zJJbreEDNltk>8n26Vcrdktuv!EYQFW+`tWdF7W+Y2i$Arub2BiY2Z5A{mc#g?t%N` zS_eFs8BHE%PX+L}<TT)MEa>`L;L*=%mULz=2R`1W)pF|mv(mtCt-XZ#9l)>Oh~4sb z;N#^)=ALjnY+kEK+!apb6%i9)ot>?`zBs2hkmt&PztC(3)>;lMISm5f?zTR3aqzp@ z->|yN@fA#IpU@%E0*T$LBSU}-yW9;-ldFPtr4ZgfM5MvGV!DFl);uPd@r1L%T7P!S zp{vHO>>MPxtW)?YJw@-3&p@biWxYbmU=;}e8Xh<{9hJaJrGsN*^S~u*YG*Kp!p^!Q zHwS;WsmP>EQ3`lHvUJygk|#@(d1ED)s|Z-Bba2|}lY(tT-ioLbNZoYe1m^I*@2A1$ zvo<(PRw|Xu9z0Q}D>emVHptm$CDMP#d<t^#?%80a_5`P6IRE1v6ddU4XE63Et?z^H zF%aH2WmF6>S=k4N_6{E$+EhVK)SK=J@N)_VPFoeJr%c^Bn}XdRp3h;5MYcYr!A~cH z6%cq4ZLiai{e3ArlV`ALD*SBH!7kAaD6*g&*e+@+&R};MT&}k!nBaj3%(F4Gljv+P zHs_|&`pK`KQyQ3hz7yDQVxh}{LoN94mtEODv;0cD@ht8N>=%#FBVf}-tOdL>_G=7` zUB?FdOOKw{`R^V%J&0v~@9|D}6AQdT`QX&&o7)Mu4ipxOfMvPiPWW{o?afNfutCb| oz;LlNa054R12=F3H}HPo|I5>wsC7nlM*si-07*qoM6N<$f((LrbN~PV literal 0 HcmV?d00001 diff --git a/website/public/media/stone-dark.png b/website/public/media/stone-dark.png new file mode 100644 index 0000000000000000000000000000000000000000..0bc940aa79b6ede119cbdc145000e43df3016579 GIT binary patch literal 1400 zcmV-;1&8{HP)<h;3K|Lk000e1NJLTq002M$002M;0{{R3owtGP0000FP)t-s4-FR) z4;c#y6AcR$6cQY&iK<Be000SaNLh0L00Za%00Za&wR=))000FKNkl<Zc-mc8(YC`d z2$JCcfAfui>CWB5mZhyxM6^}s6dMgxmp`*E6szwFyxZqsE`awBXQ`V}(4Ck?&z4qm zc}(fz{pf)?rJDCk&)v<rmAW|3;>?}ZYhZ4~VgBZ<*+uDDd5Jlv?KkcbN8adHuHN-M zlVcdP9a**;6P50+qyOFGC2WDZF#8vqIn)k~O+rt%qbknV;D>}3M@o+PfB<uyn)NsY zN8(=wG9ft+`D|W~CKnE<CyJYq>wF6gZ!0F7a(Howle+7c0KTSB!G7?VuWRU9Xa-fv zTi>L>5yx@_ZL;u4(z-cxm^%{pY#zZ3J33i?<f4~JYy0A^sqB_eI4xgw)ggV9@{&r) z&`yZd@M}O;s`@0EK2E7s7Lq?aD<`gmvWX`sRhz2o`*LT=pS|k~m7h|wH^Sjj9Pw#^ z3W?K2pg0`QEDvH6m%FN);bYMm(uZ5D0}wuwyCds_D}<(BnAtAA`D&UcU5`iH)G!pF z6XP_Oo)}2x5O$K2EOmkt6)g;9tnG>YazWOU3Rbkhk8o?>GIC9MYgI+3xA7EleewVe zkz58@59#E}M1)EF66ctdx?xzaW3@DAfBG`#wW&$qg?m>VKf?sO&yFIMsjn)at@Ky9 zZ9;VbP@Xq-#DZja76&g6pv$^b1PE&o4cvofLq1*I84K%X*N15`HC5lQM4khHMeOP! zK9`84vl0TUsbz8@pZ}u)u4kOY+bRelBkc*1=SW!~jE5{*S`U5_vbl^6!J3+WMJjA^ z>~TrCnh+(o^P^a-kY-q*T9@X&*7h3K=ETKvB8fQ@QD5bqmFlEr9#7#+z}Dum6b%|5 z7mfG}1Zh&2U--b4VD!U(=wz13<r6vP+8Ybp-b51z_O#qT3oc0-W-*B2ZY^Y%=iZI> zbKfD$I?Kj!+p357D+~)=*o-u&xpFpv@Y5p|uVqV#LS~n@tebt7ICTNFOeQ}a2wk~( z3c-oJGE^&=<x#=ZNG878m#m`~T6|64pjX6Bkm8$M9z}Mn2^CGynK}YCGZ{EwwXqeg z3}6-=^PfvvXYm^7Z96IQS}qP8b3*e~kfUu8DI8rra<;xc>p8{q1-8Jp8g;SpwdOq< zd-)9w-F&2Ulfv@7zxk!HgU6tR_?s3rWHDFacFTI{;A3lsOE<QiVtNxP5on7@*9+>< zEaEFylc0t2c5Y?Fy@qdS@!XqfV-sdD`l;b-!P{#-!bDg5^tRv~K{8`|l#Sc&VII<% z>C3X9*48F5SLH&N?Xm6(BXlZ-*h-3D(j~#okFObd5|-46C*8`E8lG}}o!1y0&k^b3 z?KEm2wLX+fS<U+xm89S}$M9{d7k2TDl&d<&A)KGl^2Yen(d*4Qt#Zn{$8vrYSrQ^? zdo$aK<iGhQTA>s&Z!I3m=D;+0kJD~nr+cTwR~}o3qm=xaIZSeoHSGZ%Zf_pG>s2bO zgY+v9wx4=L)R>hT5?#0KD>L#d;k@Q}_Nbqim#VMgXQ#`OwRtSOZlx!GB3rn(NSN6; zn#t5^IzvZusghnU;in(=lLf0^FT)~7p5{Uk*jcku91IZrr^N?5;iQOMXD&@H1?V9w zgBpHjj22%U`_8>Rg?g66^K@H@Dr0&pW5qoqcy|y9U~uuQ6cA4l^&Uj){3pO}2R|=Z zg`cjaN(z1QdilBR_j2-0?&%r$-eF`M9xF8iObXM$s{Q~XKM^3m@9U5N0000<MNUMn GLSTYBIhbew literal 0 HcmV?d00001 diff --git a/website/public/media/stone-light.png b/website/public/media/stone-light.png new file mode 100644 index 0000000000000000000000000000000000000000..ec5f609596f203afc9eda3b25a82ebad6a89b301 GIT binary patch literal 1413 zcmV;01$z34P)<h;3K|Lk000e1NJLTq002M$002M;0{{R3owtGP0000FP)t-s?&<mH z<MZm}_3Y>O@$CHBX~Ap&000SaNLh0L00Za%00Za&wR=))000FXNkl<Zc-l=@i?+is z2qNhJfAb<>x_i#uy0$Ss01fJ#VxxiT^50w+iq-cDytmK6JOJ+x&ZS;P-N*X4|2?;K zHIK&>bXi_7yHxXjXx+UzuhQRlEzZ1Iy$0q*9OmcSi}yln<RxaG)@Jwqk(YqJ<?6k@ zdvXkewj;}SW1{lgN58wrOV|SEV;0Ij<lJ>=Y!X`Cj;g5b8u1$yM@pt)J5J1XYOcp2 zI1+!4Zxe+wIg7kEuSZi02h<bAt;lu0l?>mmWSR~Ta%eW0(p|S?`<g-}_mhwLxQ4EU zrn3slTfd~h;UZMFpiLGYNLnuk4r{@Q;!&DmN2jU}T=Zqi+J2}V+KHH&D|anl_0%DK zkn$x}l7XEwGWeP#t5khbOmC;s8mz7#o|O|<Do{=qouz6+bbVj!<mJ70eG!(sRP2p# za1=+po3p8vT;@=5C?17$5SzHz6>kQQMOR3FT(VAr@R@XZW1TQVX!r%0ZSu`W(>UpR zIAXjk1_E@ET;|e>Nr@2CDNd@?8zVzoZK7BZp%BGsRN>nw?0{j0csxbCrohn36q()I z`805~^CTJqxgux1Os7_nDuehH&M{5tMCA^dvUpy)49snDrwvUa0;nCD<7bdyI<uol zW#|W;veF-O+komMKy^+n?S$@J($B@gs{?3ScSwMs2GKyTwzKl->dshLH@m)^?q($> zg(7Q0VmMlJ^$?#+;^-=MVBlCI&RQob!hFU_ye&c~Gt!;_dAyeeCGYKY#N_{iY%OEM zq&KG@Nl`0S7-uIrW)q_1c77C#)*lMRZ3=g?fMBt($wFjeSYFOjef2P2WWMdI<Q=PU zw!_xVV=0<!d{|8BHV{k50DC<*M`*9Z5iH77pcBQ8O4$OpH<8P5b{N&NxQ$v!5@4cQ zo3fHT_u{6#Zk?{PifY+7Zd+EGh$h1I!EDfsG^lxUwt(>Jk&1fLg0gKeo8Gc+^jYH6 z1=KQ``gE-h45qRQ$rF2Js8%q`qk^H4O01IGS^wUyxJ}<luZW#eif?jR>~P1LK+#B^ zsUyi|CId@|+SrN~GErDc+$<KfuHrS&>ug9~i^UtZCW_``kfUt@DHvTna<#rbyK@Sc zgnZpQ<5(mF^&(7D=k^*UtG9IuZ?Ds4J_v&vJ9tc%qUT7_1}w%Zq}j$FcRqPcRYP%O z+bO2gGu)ig>$_f1hei<}T@8X(mR~z7DbIS5K($S#jT9{Xv{wzcY)<Yu^#_>fY9E&` zLKcd8K!`9$7e$$dN362bZr%!s3*_wt?)Fg@*kg(cu~otT3tT4xet3OiVwBL@>2Bpo z4Ntkg&g&c<&k^b3?J{a0l|I-)c|twTN=k5CWB9ezix6Qu$Ewb82<LCKyfOCrZJGp$ zI?pi059UXaB_WcwH?y5c{{MV4Ia3LlQ;UbP*)UBW#WcA&GxSc0FQLoBQA$1!BM2F5 z+5<Y=-oTyndWX5%k+U>W2yGq_HD-lFg6q=WBOL0fQ;s>FJ?ii9QemX)<Cza0t+v+7 zUaef>|D}6LLJwGhM)MQbiVT~0^VVVsfBmqZELi>e4buq$&siUzs)I^lFp1cy{S6yC z=OH9A&rD4&1n40vgBt#3jGl?cSzE&1SXxagUP0<AxMWOkA9y2MjpVzLktCyWhUiEE z@f1<#AX?`?)pI-eJ75()W|&EVPmY(L%WkP$@#M}g_|7mM2R&A52AC42fmQtgBxWB( T4LSF<00000NkvXXu0mjfX78j2 literal 0 HcmV?d00001 diff --git a/website/scripts/art.mjs b/website/scripts/art.mjs new file mode 100644 index 000000000..160d64914 --- /dev/null +++ b/website/scripts/art.mjs @@ -0,0 +1,151 @@ +// Horizon's pixel art for the website, drawn in code like the launcher's (launcher/src/art.rs): +// the stone tile behind the pages and the landscape behind the hero, in both appearances. +// Each texel is one pixel of the PNG; the CSS scales them up with `image-rendering: pixelated`. +// Written by `npm run assets` (or `node scripts/art.mjs`) into public/media/. +import { readFile } from "node:fs/promises"; +import { join, dirname } from "node:path"; +import { fileURLToPath } from "node:url"; +import sharp from "sharp"; + +const site = join(dirname(fileURLToPath(import.meta.url)), ".."); +const repo = join(site, ".."); + +// The same small fixed random sequence as art.rs (xorshift), so the art is the same every time. +function rng(seed) { + let x = seed >>> 0; + return () => { + x = (x ^ (x << 13)) >>> 0; + x = (x ^ (x >>> 17)) >>> 0; + x = (x ^ (x << 5)) >>> 0; + return Math.fround((x >>> 8) / (1 << 24)); + }; +} + +const channels = (c) => [(c >> 16) & 255, (c >> 8) & 255, c & 255]; +const shade = (c, by) => channels(c).reduce((out, v) => (out << 8) | Math.min(255, Math.max(0, v + by)), 0); +const mix = (a, b, t) => { + const [x, y] = [channels(a), channels(b)]; + return x.reduce((out, v, i) => (out << 8) | Math.round(v + (y[i] - v) * t), 0); +}; + +// `n` by `n` texels of stone: the page colour in a few close shades, with darker flecks. +export function stone(page, shades, n) { + const s = shades.map((by) => shade(page, by)); + const next = rng(0x9e3779b9); + const out = Array.from({ length: n * n }, () => { + const v = next(); + return s[v < 0.5 ? 0 : v < 0.78 ? 1 : v < 0.93 ? 2 : 3]; + }); + for (let k = 0; k < Math.floor((n * n) / 50); k++) { + const x = Math.floor(next() * n); + const y = Math.floor(next() * n); + const len = 1 + Math.floor(next() * 3); + for (let i = 0; i < len; i++) { + out[y * n + ((x + i) % n)] = s[4]; + out[((y + 1) % n) * n + ((x + i + 1) % n)] = s[4]; + } + } + return out; +} + +export const SUNSET = { + sky: [0x0a0f2c, 0x26206a, 0x4b2a7e, 0x7c3a88, 0xc4527a, 0xee6e5a, 0xffb25e], + sun: [0xfff6cf, 0xffd272, 0xff9a44], + far: 0x4a2f7e, mid: 0x2b1f5e, near: 0x151a45, top: 0x3d2f80, trees: 0x0e1236, +}; +export const DAWN = { + sky: [0x8d7fd8, 0xa596e2, 0xbcaeea, 0xd2c4f0, 0xe7d2ee, 0xf6dce4, 0xffe6d6], + sun: [0xffffff, 0xfff1d0, 0xffd9a8], + far: 0xa898dc, mid: 0x8676c8, near: 0x6a5ab4, top: 0x9a8ae0, trees: 0x4c3e94, +}; + +// A blocky landscape, `w` by `h` texels: banded sky, a sun half set behind the far hills and cut +// into slices like Horizon's mark, flat clouds, three ridges of hills and a few square trees. +export function scene(p, seed, w, h) { + const next = rng((Math.imul(seed, 0x2545f491) | 1) >>> 0); + const out = new Array(w * h).fill(0); + const horizon = Math.floor((h * 62) / 100); + const band = horizon / p.sky.length; + for (let y = 0; y < h; y++) { + const f = y / band; + const i = Math.min(Math.floor(f), p.sky.length - 1); + const dither = f - i > 0.88 && i + 1 < p.sky.length; + for (let x = 0; x < w; x++) out[y * w + x] = dither && (x + y) % 2 === 1 ? p.sky[i + 1] : p.sky[i]; + } + const rect = (x, y, rw, rh, c) => { + for (let yy = Math.max(y, 0); yy < Math.min(y + rh, h); yy++) + for (let xx = Math.max(x, 0); xx < Math.min(x + rw, w); xx++) out[yy * w + xx] = c; + }; + for (let k = 0; k < 4; k++) { + const cx = Math.floor(next() * w); + const cy = Math.floor(horizon * (0.12 + next() * 0.4)); + const cw = 10 + Math.floor(next() * 14); + const under = p.sky[Math.min(Math.floor(cy / band) + 1, p.sky.length - 1)]; + const c = mix(under, 0xffffff, 0.12); + rect(cx, cy, cw, 2, c); + rect(cx + 3, cy - 2, Math.max(cw - 6, 0), 2, c); + } + const r = Math.floor(h * 0.2); + const [cx, cy] = [Math.floor(w * 0.68), horizon - Math.floor(h * 0.11)]; + for (let dy = -r; dy <= 0; dy++) { + const half = Math.round(Math.sqrt(r * r - dy * dy)); + const t = (dy + r) / r; + const c = p.sun[t < 0.4 ? 0 : t < 0.75 ? 1 : 2]; + if ((cy + dy) % 5 !== 0 || dy < -r * 0.6) rect(cx - half, cy + dy, half * 2, 1, c); + } + const ridge = (base, amp, rough) => { + let [y, v] = [base, 0]; + return Array.from({ length: w }, (_, x) => { + if (x % 2 === 0) { + v = (v + (next() - 0.5) * rough) * 0.86; + y += v + (base - y) * 0.06; + } + return Math.max(Math.round(Math.min(Math.max(y, base - amp), base + amp)), 0); + }); + }; + const layers = [ + [p.far, horizon - h * 0.1, h * 0.12, 3.2, null], + [p.mid, horizon + h * 0.02, h * 0.09, 2.6, null], + [p.near, horizon + h * 0.18, h * 0.07, 2.2, p.top], + ]; + let near = []; + for (const [c, base, amp, rough, top] of layers) { + const hs = ridge(base, amp, rough); + hs.forEach((y, x) => { + for (let yy = Math.min(y, h); yy < h; yy++) out[yy * w + x] = c; + if (top !== null && y < h) out[y * w + x] = top; + }); + near = hs; + } + for (let k = 0; k < Math.floor(w / 26); k++) { + const tx = 4 + Math.floor(next() * (w - 10)); + const ty = near[tx]; + rect(tx - 2, ty - 8, 5, 5, p.trees); + rect(tx - 1, ty - 10, 3, 2, p.trees); + rect(tx, ty - 3, 1, 3, p.trees); + } + return out; +} + +const png = (texels, w, h, file) => + sharp(Buffer.from(texels.flatMap(channels)), { raw: { width: w, height: h, channels: 3 } }) + .png({ compressionLevel: 9, palette: true }) + .toFile(file); + +// The page colours and the stone's shades come from crates/horizon-theme, like tokens.css. +export async function writeArt(media) { + const theme = await readFile(join(repo, "crates/horizon-theme/src/lib.rs"), "utf8"); + const page = (name) => parseInt(theme.match(new RegExp(`pub const ${name}: Blocks = Blocks \\{\\s*page: 0x([0-9a-f]{6})`))[1], 16); + const shades = JSON.parse(`[${theme.match(/TILE_SHADES: \[i16; 5\] = \[([^\]]*)\]/)[1]}]`); + const texels = Number(theme.match(/TILE_TEXELS: usize = (\d+)/)[1]) * 4; + await png(stone(page("BLOCKS_DARK"), shades, texels), texels, texels, join(media, "stone-dark.png")); + await png(stone(page("BLOCKS_LIGHT"), shades, texels), texels, texels, join(media, "stone-light.png")); + const [w, h] = [240, 72]; + await png(scene(SUNSET, 3, w, h), w, h, join(media, "scene-dark.png")); + await png(scene(DAWN, 3, w, h), w, h, join(media, "scene-light.png")); +} + +if (process.argv[1] === fileURLToPath(import.meta.url)) { + await writeArt(join(site, "public", "media")); + console.log("pixel art written to public/media/"); +} diff --git a/website/scripts/assets.mjs b/website/scripts/assets.mjs index e014dafc2..cea841789 100644 --- a/website/scripts/assets.mjs +++ b/website/scripts/assets.mjs @@ -1,4 +1,4 @@ -// Copies the launcher's fonts and the repo's screenshots into public/, +// Copies the launcher's fonts and the repo's screenshots into public/, draws the pixel art, // converted for the web (woff2, webp in two widths). Run it after any of them change: // `npm run assets`. Its output is committed, because Railway builds only website/. import { mkdir, readFile, writeFile, copyFile } from "node:fs/promises"; @@ -6,6 +6,7 @@ import { join, dirname } from "node:path"; import { fileURLToPath } from "node:url"; import sharp from "sharp"; import wawoff2 from "wawoff2"; +import { writeArt } from "./art.mjs"; const site = join(dirname(fileURLToPath(import.meta.url)), ".."); const repo = join(site, ".."); @@ -16,6 +17,9 @@ const fonts = [ "Geist-Medium.ttf", "Geist-SemiBold.ttf", "GeistMono-Regular.ttf", + "PixelifySans-Medium.ttf", + "PixelifySans-SemiBold.ttf", + "PixelifySans-Bold.ttf", ]; // [source, name]; every image becomes media/<name>.webp and media/<name>-800.webp. @@ -41,7 +45,7 @@ for (const font of fonts) { const ttf = await readFile(join(repo, "crates/horizon-theme/fonts", font)); await writeFile(join(pub, "fonts", font.replace(".ttf", ".woff2")), await wawoff2.compress(ttf)); } -for (const licence of ["OFL-Geist.txt"]) { +for (const licence of ["OFL-Geist.txt", "OFL-PixelifySans.txt"]) { await copyFile(join(repo, "crates/horizon-theme/fonts", licence), join(pub, "fonts", licence)); } @@ -51,6 +55,9 @@ for (const [source, name] of images) { await sharp(input).resize({ width: 800 }).webp({ quality: 78 }).toFile(join(pub, "media", `${name}-800.webp`)); } +// The stone tile and the hero's landscape, drawn in code (scripts/art.mjs). +await writeArt(join(pub, "media")); + // The icons (favicon.svg, favicon-32.png, apple-touch-icon.png) come from Horizon's mark: // `cargo run -p xtask -- icons` writes them with the rest of the brand (docs/media/brand). diff --git a/website/src/404.html b/website/src/404.html index d12c91653..3ac1e017a 100644 --- a/website/src/404.html +++ b/website/src/404.html @@ -5,8 +5,8 @@ <meta name="viewport" content="width=device-width, initial-scale=1"> <title>Not found · Horizon - - + + diff --git a/website/src/docs.html b/website/src/docs.html index 746e84fad..67b282f82 100644 --- a/website/src/docs.html +++ b/website/src/docs.html @@ -5,8 +5,8 @@ {{DOC_TITLE}} · Horizon docs - - + + diff --git a/website/src/index.html b/website/src/index.html index 270128d91..b632a8d79 100644 --- a/website/src/index.html +++ b/website/src/index.html @@ -5,8 +5,8 @@ Horizon: a Rust rewrite for Minecraft: Java Edition 26.3 - - + + @@ -27,6 +27,7 @@ + @@ -84,6 +85,9 @@ View on GitHub

For Linux x86-64, macOS on Apple Silicon and Windows x64.

+ +
+
  1. 01Matches vanilla{{PERCENT}}
  2. 02Differential harnesses{{HARNESSES}}
  3. @@ -91,8 +95,7 @@
  4. 04What changedNotes

Unofficial. Not an official Minecraft product. Not approved by or associated with Mojang or Microsoft.

-
- +
diff --git a/website/src/privacy.html b/website/src/privacy.html index def61dcc9..6190b03c5 100644 --- a/website/src/privacy.html +++ b/website/src/privacy.html @@ -5,8 +5,8 @@ Privacy · Horizon - - + + diff --git a/website/src/style.css b/website/src/style.css index 03004464b..d4e92d125 100644 --- a/website/src/style.css +++ b/website/src/style.css @@ -1,8 +1,7 @@ /* Horizon's design language (docs/design-system.md), set as a page. The tokens come from crates/horizon-theme through src/tokens.css, which build.mjs puts before this file: the - same palette, type, spacing and motion as the launcher and the game's menus. Type is the - interface; content is numbered index lists with one-pixel rules; one violet accent for the - main action, links and focus; space instead of borders; quiet motion. */ + launcher's Blocks palettes, type, spacing and motion. The base below lays out the page; the + "Blocks" section at the end gives it the launcher's blocky, Minecraft-like look. */ @font-face { font-family: "Geist"; src: url("/fonts/Geist-Regular.woff2") format("woff2"); font-weight: 400; font-display: swap; } @font-face { font-family: "Geist"; src: url("/fonts/Geist-Medium.woff2") format("woff2"); font-weight: 500; font-display: swap; } @@ -499,3 +498,132 @@ figcaption span { font-family: var(--mono); font-size: var(--text-micro); letter @media (pointer: coarse) { .docs-nav li a, .docs-toc a, .docs-bar-title, .docs-bar-link { display: flex; align-items: center; min-height: 44px; } } + +/* --- Blocks: the launcher's look on the page (docs/design-system.md, "Blocks") ------------- + Pixel type for headings and controls, square panels with a dark outline, a light bevel on top + and a darker lip below, the violet face for the main action, sunk wells, a stone texture + behind the page and Horizon's pixel landscape behind the hero. The art is drawn in code + (scripts/art.mjs, like launcher/src/art.rs); nothing in it comes from Minecraft. */ + +@font-face { font-family: "Pixelify Sans"; src: url("/fonts/PixelifySans-Medium.woff2") format("woff2"); font-weight: 500; font-display: swap; } +@font-face { font-family: "Pixelify Sans"; src: url("/fonts/PixelifySans-SemiBold.woff2") format("woff2"); font-weight: 600; font-display: swap; } +@font-face { font-family: "Pixelify Sans"; src: url("/fonts/PixelifySans-Bold.woff2") format("woff2"); font-weight: 700; font-display: swap; } + +:root { + --stone: url("/media/stone-light.png"); + --scene: url("/media/scene-light.png"); + --sky: #8d7fd8; + --panel-edges: inset 0 var(--block-bevel) 0 var(--bevel), inset 0 calc(-1 * var(--block-bevel)) 0 var(--lip); + --radius: 0px; --radius-plate: 0px; --radius-pill: 0px; +} +:root[data-theme="dark"] { --stone: url("/media/stone-dark.png"); --scene: url("/media/scene-dark.png"); --sky: #0a0f2c; } +@media (prefers-color-scheme: dark) { + :root:not([data-theme="light"]) { --stone: url("/media/stone-dark.png"); --scene: url("/media/scene-dark.png"); --sky: #0a0f2c; } +} + +/* The stone: 64 texels of the page colour in close shades, each texel 4 px. */ +body { position: relative; isolation: isolate; } +body::before { + content: ""; position: fixed; inset: 0; z-index: -1; pointer-events: none; + background: var(--stone) 0 0 / 256px 256px repeat; image-rendering: pixelated; +} + +/* Pixel type for what names and what you act on; paragraphs stay in Geist. */ +.display, .title, .statement, .row-name, .card-title, .release-version, .release-tag, .count, +.fact h3, .features h3, .system h3, .contributors-title, .footer-disclaimer, .footer-word, +.nav-mark, .docs-prose h2, .docs-prose h3, .prose h2, .prose h3, .prose h4, .menu nav a { + font-family: var(--pixel); font-weight: 600; letter-spacing: 0; +} +.display, .count, .footer-word { font-weight: 700; } +.nav-mark { font-size: 18px; font-weight: 700; text-transform: uppercase; letter-spacing: 0.04em; } +code { border-radius: 0; background: var(--well); box-shadow: 0 0 0 1px var(--outline); } + +/* Buttons: blocks with an outline, a bevel and a lip; they sink a pixel when pressed. */ +.button { + border: var(--block-outline) solid var(--outline); border-radius: 0; + font: 500 var(--text-ui) / 1 var(--pixel); + box-shadow: inset 0 var(--block-bevel) 0 var(--button-bevel), inset 0 calc(-1 * var(--block-lip)) 0 var(--lip); + padding-bottom: 2px; +} +.button.large { font-size: 18px; } +.button.primary { background: var(--face); color: var(--on-face); box-shadow: inset 0 var(--block-bevel) 0 var(--face-bevel), inset 0 calc(-1 * var(--block-lip)) 0 var(--face-lip); } +.button.primary:hover { opacity: 1; filter: brightness(1.08); } +.button.secondary { background: var(--button); } +.button.secondary:hover { background: var(--button); filter: brightness(1.06); } +.button.ghost { border-color: transparent; box-shadow: none; } +.button:active { opacity: 1; transform: translateY(1px); box-shadow: inset 0 var(--block-bevel) 0 var(--lip); } +:focus-visible { border-radius: 0; } + +/* The top bar: the sidebar colour with an outline under it, tabs with an accent underline. */ +.nav.is-scrolled, .nav.is-menu { background: var(--side); -webkit-backdrop-filter: none; backdrop-filter: none; box-shadow: 0 var(--block-outline) 0 var(--outline); } +.nav-links a, .nav-github, .theme-toggle { border-radius: 0; font-family: var(--pixel); font-weight: 500; font-size: 15px; } +.nav-links a:hover, .nav-github:hover, .theme-toggle:hover { background: var(--raised); } +.nav-links a[aria-current] { background: var(--raised); box-shadow: inset 0 -3px 0 var(--accent); } +.theme-toggle { text-transform: none; letter-spacing: 0; } +.menu { background: var(--side); } +.menu nav a { border-bottom: 0; } + +/* Lists become stacks of panels. */ +.index, .systems, .contributors-list { border-top: 0; display: grid; gap: 8px; } +.row, .system, .release, .release:last-of-type, .contributor { border-bottom: 0; border-top: 0; } +.row > a, .row.card, .fact.row, .features li, .system, .release, .contributor, .docs-pager a { + background: var(--panel); border: var(--block-outline) solid var(--outline); box-shadow: var(--panel-edges); + border-radius: 0; +} +.row > a, .row.card, .fact.row, .features li, .system { padding-left: 20px; padding-right: 20px; } +.row > a::before, .row.card::before { display: none; } +.row > a:hover, .row.card:hover, .contributor:hover, .docs-pager a:hover { background: var(--raised); } +.row > a:hover .row-index { color: var(--accent); } +.row-name { font-size: clamp(20px, 2.2vw, 28px); } +.release { padding: 0 20px; } +.release + .release { margin-top: 8px; } +.release .prose { padding-left: 12rem; } +.contributor { padding: 12px 14px; } +.contributors-list { grid-template-columns: repeat(auto-fill, minmax(220px, 1fr)); gap: 8px; } +.contributor-avatar { border-radius: 0; box-shadow: 0 0 0 2px var(--outline); image-rendering: pixelated; } +.release-latest { border-top: 0; padding: 28px; background: var(--panel); border: var(--block-outline) solid var(--outline); box-shadow: var(--panel-edges); } +.system.is-full .system-state { color: var(--success); } + +/* Screenshots and the launcher's screens: square, outlined. */ +.zoom, .screen, .lightbox, .prose pre, .docs-prose figure img { border-radius: 0; box-shadow: 0 0 0 var(--block-outline) var(--outline); } +.tabs { border-radius: 0; background: var(--well); box-shadow: 0 0 0 var(--block-outline) var(--outline); } +.tabs button { border-radius: 0; font-family: var(--pixel); font-weight: 500; font-size: 15px; } +.tabs button[aria-selected="true"] { color: var(--on-face); } +.tab-pill { border-radius: 0; background: var(--face); box-shadow: inset 0 var(--block-bevel) 0 var(--face-bevel), inset 0 calc(-1 * var(--block-bevel)) 0 var(--face-lip); } + +/* The hero: Horizon's landscape under a veil of the page colour, the words on the left. */ +.hero { + position: relative; isolation: isolate; overflow: hidden; + background: var(--scene) 70% 100% / clamp(1200px, 135vw, 2400px) auto no-repeat, var(--sky); image-rendering: pixelated; + border-bottom: var(--block-outline) solid var(--outline); +} +.hero::before { + content: ""; position: absolute; inset: 0; z-index: -1; + background: + linear-gradient(90deg, color-mix(in srgb, var(--page) 92%, transparent) 0%, color-mix(in srgb, var(--page) 78%, transparent) 45%, color-mix(in srgb, var(--page) 0%, transparent) 78%), + linear-gradient(180deg, color-mix(in srgb, var(--page) 0%, transparent) 55%, color-mix(in srgb, var(--page) 70%, transparent) 100%); +} +.hero .kicker span, .hero .kicker { color: var(--ink-soft); } +.hero .lede { color: var(--ink-soft); } +.hero { padding-bottom: clamp(160px, 18vw, 280px); } +.hero-after { padding-top: 40px; } +.hero-after .hero-index { margin-top: 0; max-width: 860px; } +.hero-after .disclaimer { margin-top: 24px; } +@media (max-width: 900px) { + .hero::before { background: color-mix(in srgb, var(--page) 84%, transparent); } +} + +/* Documentation. */ +.docs-bar { background: var(--side); -webkit-backdrop-filter: none; backdrop-filter: none; box-shadow: 0 var(--block-outline) 0 var(--outline); } +.docs-nav li a { border-radius: 0; } +.docs-nav li a[aria-current] { background: var(--raised); box-shadow: inset 4px 0 0 var(--accent); } +.docs-toc a { border-radius: 0; background: var(--button); box-shadow: 0 0 0 var(--block-outline) var(--outline); } +.docs-pager a { box-shadow: var(--panel-edges); } +.docs-prose h2 { border-top: var(--block-outline) solid var(--outline); } +.docs-prose blockquote { border-left: 4px solid var(--accent); background: var(--panel); padding: 10px 16px; box-shadow: 0 0 0 var(--block-outline) var(--outline); } + +/* The footer: the giant wordmark in pixels. */ +.footer { background: var(--side); border-top: var(--block-outline) solid var(--outline); margin-top: 48px; } +.footer-word { color: var(--raised); letter-spacing: 0.02em; } +:root[data-theme="dark"] .footer-word { color: var(--panel); } +@media (prefers-color-scheme: dark) { :root:not([data-theme="light"]) .footer-word { color: var(--panel); } } diff --git a/website/src/tokens.css b/website/src/tokens.css index d272865cc..816ad5b8e 100644 --- a/website/src/tokens.css +++ b/website/src/tokens.css @@ -2,21 +2,39 @@ docs/design-system.md describes the tokens. */ :root { - --page: #fafafc; - --plate-soft: #f3f3f8; - --plate: #ebecf4; - --surface: #ffffff; - --rule: #e2e3ea; - --ink: #16181f; - --ink-soft: #3b3e49; - --muted: #646875; - --accent: #5b3fd6; + --page: #ece7f7; + --plate-soft: #e9e3f8; + --plate: #ddd4f3; + --surface: #f8f6fd; + --rule: #e4ddf4; + --ink: #1b1530; + --ink-soft: #3b3354; + --muted: #585071; + --accent: #5333c9; --on-accent: #ffffff; - --danger: #b4372a; - --success: #1d7a48; + --danger: #a3301d; + --success: #136336; + --warn: #7a4f00; + --side: #e2dbf2; + --panel: #f8f6fd; + --raised: #e9e3f8; + --button: #ddd4f3; + --button-bevel: #f4f0fe; + --well: #f3f0fb; + --bevel: #ffffff; + --lip: #c3b8e2; + --outline: #2b2244; + --face: #5b3fd6; + --face-bevel: #8069ef; + --face-lip: #3a2694; + --on-face: #ffffff; color-scheme: light; --font: "Geist", ui-sans-serif, system-ui, sans-serif; --mono: "Geist Mono", ui-monospace, monospace; + --pixel: "Pixelify Sans", "Geist", ui-sans-serif, sans-serif; + --block-outline: 2px; + --block-bevel: 2px; + --block-lip: 4px; --text-micro: 11px; --text-micro-line: 1.5; --text-micro-tracking: 0.04em; @@ -88,34 +106,62 @@ @media (prefers-color-scheme: dark) { :root:not([data-theme="light"]) { - --page: #0d0e13; - --plate-soft: #181a22; - --plate: #20222c; - --surface: #16181f; - --rule: #24262f; + --page: #0f0d17; + --plate-soft: #221e34; + --plate: #2b2641; + --surface: #1a1727; + --rule: #120f1c; --ink: #ecedf3; --ink-soft: #c5c7d1; - --muted: #8b8f9c; + --muted: #a29cb8; --accent: #9a86ff; - --on-accent: #0d0e13; + --on-accent: #ffffff; --danger: #f07a68; --success: #45c27a; + --warn: #f0b84f; + --side: #0b0a11; + --panel: #1a1727; + --raised: #221e34; + --button: #2b2641; + --button-bevel: #3d3560; + --well: #0c0b12; + --bevel: #342d52; + --lip: #07060b; + --outline: #05040a; + --face: #5b3fd6; + --face-bevel: #8a74ff; + --face-lip: #3a2694; + --on-face: #ffffff; color-scheme: dark; } } :root[data-theme="dark"] { - --page: #0d0e13; - --plate-soft: #181a22; - --plate: #20222c; - --surface: #16181f; - --rule: #24262f; + --page: #0f0d17; + --plate-soft: #221e34; + --plate: #2b2641; + --surface: #1a1727; + --rule: #120f1c; --ink: #ecedf3; --ink-soft: #c5c7d1; - --muted: #8b8f9c; + --muted: #a29cb8; --accent: #9a86ff; - --on-accent: #0d0e13; + --on-accent: #ffffff; --danger: #f07a68; --success: #45c27a; + --warn: #f0b84f; + --side: #0b0a11; + --panel: #1a1727; + --raised: #221e34; + --button: #2b2641; + --button-bevel: #3d3560; + --well: #0c0b12; + --bevel: #342d52; + --lip: #07060b; + --outline: #05040a; + --face: #5b3fd6; + --face-bevel: #8a74ff; + --face-lip: #3a2694; + --on-face: #ffffff; color-scheme: dark; } From 8b16f76b3c1f17d12c1b2bd5e1ed85c44a10e361 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 15:39:28 +0200 Subject: [PATCH 046/126] Section walk: no per-section frustum test in columns entirely inside A column whose box lies entirely inside the frustum holds no section the frustum would reject (plane distances only grow from its nearest corner to a section's farthest, and rounding keeps the order), so its sections skip the test. At render distance 32 most columns are past the distance where the vertical field of view takes in their whole height. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/gfx.rs | 14 +++++ crates/horizon-client/src/gfx/resident.rs | 70 ++++++++++++++++++++--- 2 files changed, 75 insertions(+), 9 deletions(-) diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 14c040c5c..d75a1144f 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -4059,6 +4059,20 @@ impl Frustum { p.truncate().dot(v) + p.w < 0.0 }) } + /// Whether the camera-relative box `min..max` is entirely inside. Then + /// `intersects` accepts every box within it: each plane's distance only + /// grows from this box's nearest corner to the inner box's farthest, and + /// rounding keeps that order. + pub fn contains(&self, min: Vec3, max: Vec3) -> bool { + self.planes.iter().all(|p| { + let v = Vec3::new( + if p.x >= 0.0 { min.x } else { max.x }, + if p.y >= 0.0 { min.y } else { max.y }, + if p.z >= 0.0 { min.z } else { max.z }, + ); + p.truncate().dot(v) + p.w >= 0.0 + }) + } } /// Vanilla's `Projection`: reversed depth (near maps to 1, far to 0, tests /// are GREATER_THAN_OR_EQUAL), which keeps far faces a hair apart, like diff --git a/crates/horizon-client/src/gfx/resident.rs b/crates/horizon-client/src/gfx/resident.rs index 49407e77a..51e5d8176 100644 --- a/crates/horizon-client/src/gfx/resident.rs +++ b/crates/horizon-client/src/gfx/resident.rs @@ -169,14 +169,20 @@ fn in_view(key: SectionKey, camera: DVec3, radius: i32, frustum: &Frustum) -> Op if !in_view_distance(camera_column(camera), radius, key.0, key.2) { return None; } - in_frustum(key, camera, frustum) + in_frustum(key, camera, frustum, false) } -/// `in_view` without the distance test. -fn in_frustum(key: SectionKey, camera: DVec3, frustum: &Frustum) -> Option<(f64, Vec3)> { +/// `in_view` without the distance test; `inside`: the section's column is +/// entirely inside the frustum, so the section is too. +fn in_frustum( + key: SectionKey, + camera: DVec3, + frustum: &Frustum, + inside: bool, +) -> Option<(f64, Vec3)> { let origin = origin(key, camera); let min = origin.as_vec3(); - if !frustum.intersects(min, min + Vec3::splat(16.0)) { + if !inside && !frustum.intersects(min, min + Vec3::splat(16.0)) { return None; } Some(((origin + DVec3::splat(8.0)).length_squared(), min)) @@ -192,8 +198,9 @@ impl Resident { /// Columns are tested first, with the same distance test (it depends /// only on x and z) and a box spanning their sections: every section box /// lies inside it and the frustum test rounds monotonically, so a column - /// the frustum rejects holds no section it would accept. `radius` is the - /// render distance in chunks. + /// the frustum rejects holds no section it would accept, and one + /// entirely inside holds none it would reject (its sections skip the + /// test). `radius` is the render distance in chunks. pub fn visible( &self, camera: DVec3, @@ -211,7 +218,9 @@ impl Resident { } let min = origin((column.x, column.low, column.z), camera).as_vec3(); let top = origin((column.x, column.high, column.z), camera).as_vec3(); - if !frustum.intersects(min, top + Vec3::splat(16.0)) { + let max = top + Vec3::splat(16.0); + let inside = frustum.contains(min, max); + if !inside && !frustum.intersects(min, max) { continue; } for &(y, slot) in &column.sections { @@ -219,7 +228,7 @@ impl Resident { if near && !reachable(key) { continue; } - if let Some((d, o)) = in_frustum(key, camera, frustum) { + if let Some((d, o)) = in_frustum(key, camera, frustum, inside) { out.push(Visible { distance: d.to_bits(), key, @@ -277,7 +286,7 @@ mod tests { if near { in_view(k, camera, radius, &frustum).filter(|_| reachable(k)) } else if beyond(k.0, k.2) { - in_frustum(k, camera, &frustum) + in_frustum(k, camera, &frustum, false) } else { None } @@ -298,6 +307,49 @@ mod tests { } } + #[test] + fn columns_entirely_inside_skip_no_section() { + // Short columns ahead of the camera: most lie entirely inside. + let mut r = Resident::default(); + for x in -12i32..=12 { + for z in 1..=12 { + for y in 3..6 { + if (x + y + z).rem_euclid(3) != 0 { + r.insert((x, y, z), ()); + } + } + } + } + let camera = DVec3::new(0.5, -8.0, 0.5); + let projection = super::super::world_projection(70.0, 16.0 / 9.0, 512.0); + let frustum = Frustum { + planes: super::super::frustum(projection * crate::camera::view_matrix(0.0, 5.0)), + }; + let inside = r + .columns + .iter() + .filter(|c| { + let min = origin((c.x, c.low, c.z), camera).as_vec3(); + let top = origin((c.x, c.high, c.z), camera).as_vec3(); + frustum.contains(min, top + Vec3::splat(16.0)) + }) + .count(); + assert!(inside > 50 && inside < r.columns.len(), "{inside}"); + let mut fast = Vec::new(); + r.visible(camera, 12, &frustum, |_| true, |_, _| false, &mut fast); + let mut slow: Vec<_> = r + .items + .iter() + .filter_map(|&(k, _)| in_view(k, camera, 12, &frustum).map(|(d, _)| (d, k))) + .collect(); + slow.sort_unstable_by(|a, b| a.0.total_cmp(&b.0).then(a.1.cmp(&b.1))); + let fast: Vec<_> = fast + .iter() + .map(|v| (f64::from_bits(v.distance), v.key)) + .collect(); + assert_eq!(fast, slow); + } + /// Every key reaches its value through its slot and column, and every /// column's bounds and sections match the keys. fn check(r: &Resident, model: &HashMap) { From 724f42355f8884824f46189c64525e24ba02a0a4 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 19:37:21 +0200 Subject: [PATCH 047/126] Fix #1255: server players climbing down a ladder take no fall damage Player's MoveSimulationType is AUTHORITATIVE_SIDE_AND_SERVER, so a ServerPlayer travels on the server too, and every tick on a ladder or vine LivingEntity.handleOnClimbable resets its fall distance. Horizon's server only replayed the client's moves (ServerPlayer.doCheckFallDamage), so the fall distance grew all the way down a ladder and hurt the player where it landed: LAN guests, dedicated-server players and, while single player ran on the server thread (#1114), the single player. lan_e2e ladder: the guest slides down ten blocks of ladder and lands with full health (before: 20 -> 13). Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game/lan_actions.rs | 7 ++++ crates/horizon-client/src/motion.rs | 3 +- tools/lan_e2e.py | 34 +++++++++++++++++-- 3 files changed, 41 insertions(+), 3 deletions(-) diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index bc224da9e..7028c2eca 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -1730,6 +1730,13 @@ impl Game<'_> { break; } } + // A ServerPlayer travels on the server too + // (MoveSimulationType.AUTHORITATIVE_SIDE_AND_SERVER), so every tick + // on a ladder or vine LivingEntity.handleOnClimbable resets its fall + // distance: climbing down doesn't hurt where it lands (#1255). + if w.climbable().unwrap_or(false) { + w.player.fall_distance = 0.0; + } let _ = w.tick_environment_damage(); let _ = w.apply_fire_contact(); let _ = w.server_hazards_tick(in_wall); diff --git a/crates/horizon-client/src/motion.rs b/crates/horizon-client/src/motion.rs index b1088188c..1920026b9 100644 --- a/crates/horizon-client/src/motion.rs +++ b/crates/horizon-client/src/motion.rs @@ -716,7 +716,8 @@ impl MotionWorld<'_, '_, '_> { supporting_block: self.player.ground.supporting_block, } } - fn climbable(&mut self) -> Result { + /// `LivingEntity.onClimbable` at the player's feet (it remembers the block). + pub fn climbable(&mut self) -> Result { if self.player.spectator { return Ok(false); } diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 9b883b163..15129e6b6 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -114,6 +114,8 @@ address. The script then checks, from both sides, what a guest's game used to ge server's game time after the guest's game stalls for a few seconds (#848). - growth: far from the host, the chunks around the guest tick (#890): water placed there flows and wheat on farmland grows (random ticks), however the host runs its world. +- ladder: the guest climbs down ten blocks of ladder and lands unhurt: the server resets its fall + distance on a ladder every tick, as LivingEntity.handleOnClimbable does (#1255). - flight: a player in creative double-taps jump and flies, stays up, and stops flying in survival: the guest, and on the server thread the host's window too, take what may fly from the server's abilities (ClientPacketListener.handlePlayerAbilities). @@ -155,7 +157,7 @@ ROOT = Path(__file__).resolve().parents[1] GUEST_NAME = 'Guest' # The host plays single player on its server thread (--server-thread). SERVER_THREAD = False -CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder'] class Game: @@ -2279,6 +2281,34 @@ def check_flight(host, guest, out): return seen + +def check_ladder(host, guest, out): + """#1255: climbing down a ladder doesn't hurt where the guest lands.""" + x, y, z = (int(v // 1) for v in pos_of(guest)) + lx, lz = x + 6, z + guest('command', command='gamemode survival') + guest('command', command=f'fill {lx - 2} {y} {lz - 2} {lx + 2} {y + 12} {lz + 2} minecraft:air') + guest('command', command=f'fill {lx - 2} {y - 1} {lz - 2} {lx + 2} {y - 1} {lz + 2} minecraft:stone') + guest('command', command=f'fill {lx} {y} {lz + 1} {lx} {y + 10} {lz + 1} minecraft:stone') + guest('command', command=f'fill {lx} {y} {lz} {lx} {y + 10} {lz} minecraft:ladder[facing=north]') + guest.wait(10) + try: + before = remote(guest)['health'] + # No input on a ladder: the guest slides down at 0.15 a tick (LivingEntity.handleOnClimbable). + guest('command', command=f'tp @s {lx + 0.5} {y + 10} {lz + 0.4} 0 0') + for _ in range(40): + guest.wait(5) + if pos_of(guest)[1] < y + 0.01: + break + guest.wait(20) + landed, after = pos_of(guest), remote(guest)['health'] + assert landed[1] < y + 0.01, f'the guest stayed on the ladder at {landed}' + assert after >= before, f'climbing down ten blocks of ladder took the guest from {before} to {after} health' + return {'landed': landed, 'health': after} + finally: + guest('command', command=f'fill {lx} {y} {lz} {lx} {y + 10} {lz + 1} minecraft:air') + guest('command', command=f'tp @s {x + 0.5} {y} {z + 0.5}') + def check_growth(host, guest, out): """Block ticks near a guest 1000 blocks from the host: only the guest's tickets tick them.""" x0, y0, z0 = pos_of(guest) @@ -2591,7 +2621,7 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles, 'blast': check_blast, 'light': check_light, 'plates': check_plates, 'swings': check_swings, 'cracks': check_cracks, - 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict} + 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder} def run(ctl, out, resources, checks): From 0928c83d4c28fb285c07e5c2404c5a7016cb5d7d Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Thu, 22 Oct 2026 18:39:53 +0100 Subject: [PATCH 048/126] Skip provably unchanged native End surface traversal --- .../examples/streaming_bench.rs | 66 ++++++- .../horizon-world/examples/chunkgen_bench.rs | 118 ++++++++++- .../horizon-world/src/worldgen/generator.rs | 184 ++++++++++++++++-- 3 files changed, 341 insertions(+), 27 deletions(-) diff --git a/crates/horizon-client/examples/streaming_bench.rs b/crates/horizon-client/examples/streaming_bench.rs index 9f8e99899..b8c56b28c 100644 --- a/crates/horizon-client/examples/streaming_bench.rs +++ b/crates/horizon-client/examples/streaming_bench.rs @@ -3,6 +3,7 @@ //! what the render thread pays for it in `Streaming::update`. //! //! streaming_bench RESOURCES [--threads N] [--radius R] [--seed S] [--fly CHUNKS_PER_S] [--seconds T] [--hz F] +//! [--dimension overworld|the_nether|the_end] [--center-x X] [--center-z Z] //! //! First the area around (0, 0) fills; then, with `--fly`, the centre moves along +x //! at that speed for T seconds while frames run at F per second. Each phase reports @@ -72,14 +73,33 @@ static ALLOCATOR: CountingAllocator = CountingAllocator; type Result = std::result::Result>; +fn cpu_seconds() -> f64 { + std::fs::read_to_string("/proc/self/stat") + .ok() + .and_then(|stat| { + let fields = stat + .rsplit_once(')')? + .1 + .split_whitespace() + .collect::>(); + Some((fields[11].parse::().ok()? + fields[12].parse::().ok()?) / 100.0) + }) + .unwrap_or(0.0) +} + #[derive(Default)] struct Phase { updates: Vec, local: (u64, u64), uploads: usize, + stage_samples: [u64; 7], + cpu_start: f64, } impl Phase { fn update(&mut self, streaming: &mut Streaming, world: &mut World) { + if self.updates.is_empty() { + self.cpu_start = cpu_seconds(); + } let before = LOCAL.with(Cell::get); let started = Instant::now(); let (uploads, _) = streaming.update(world); @@ -89,6 +109,9 @@ impl Phase { self.local.1 += after.1 - before.1; self.uploads += uploads.len(); drop(uploads); + for (sum, (_, count)) in self.stage_samples.iter_mut().zip(streaming.stages()) { + *sum += count as u64; + } } fn report(&self, name: &str, wall: Duration, streaming: &Streaming, generated: u64) { let mut sorted = self.updates.clone(); @@ -106,6 +129,16 @@ impl Phase { at(0.99), sorted.last().copied().unwrap_or(0.0), ); + println!( + "BENCH {}", + serde_json::json!({ + "phase": name, "wall_s": wall.as_secs_f64(), + "cpu_s": cpu_seconds() - self.cpu_start, + "chunks": streaming.generated_total - generated, "sections": self.uploads, + "updates": self.updates.len(), "update_ms": total, + "mean_stages": self.stage_samples.map(|n| n as f64 / self.updates.len() as f64), + }) + ); if TRACK { println!( " update allocations: {} ({:.1} MiB)", @@ -142,6 +175,22 @@ fn main() -> Result<()> { let fly = flag("--fly", 0.0); let seconds = flag("--seconds", 10.0); let hz = flag("--hz", 240.0); + let dimension = args + .iter() + .position(|a| a == "--dimension") + .and_then(|i| args.get(i + 1)) + .map(|d| { + if d.contains(':') { + d.clone() + } else { + format!("minecraft:{d}") + } + }) + .unwrap_or_else(|| "minecraft:overworld".into()); + let center = ( + flag("--center-x", 0.0) as i32, + flag("--center-z", 0.0) as i32, + ); let assets = Arc::new(Assets::load(&root)?); let render = Arc::new(assets.reload(&root)?); @@ -154,11 +203,12 @@ fn main() -> Result<()> { models::load_visibility(&root, assets.registry)?, )?); let light = Arc::new(LightTables::load(&root, assets.registry, &facts)?); - let terrain = Arc::new(VanillaTerrain::new( + let terrain = Arc::new(VanillaTerrain::for_dimension( &root.join("worldgen"), assets.registry, &biomes, seed, + &dimension, )?); let context = Arc::new(WorkerContext { assets, @@ -170,8 +220,12 @@ fn main() -> Result<()> { let mut world = World::new(facts.air, seed); let mut streaming = Streaming::new(terrain, context, threads); streaming.radius = radius; - streaming.center = (0, 0); - println!("{threads} workers, radius {radius}, seed {seed}"); + streaming.center = center; + streaming.nether_shading = dimension == "minecraft:the_nether"; + streaming.sky_light = dimension != "minecraft:the_nether"; + println!( + "{threads} workers, radius {radius}, seed {seed}, dimension {dimension}, center {center:?}" + ); let (allocations, bytes) = (ALLOCATIONS.load(Relaxed), BYTES.load(Relaxed)); // Fill: update as often as the game would uncapped, until settled. @@ -198,12 +252,12 @@ fn main() -> Result<()> { let mut behind = Vec::new(); while started.elapsed().as_secs_f64() < seconds { let next = Instant::now() + frame; - let x = (started.elapsed().as_secs_f64() * fly) as i32; - streaming.center = (x, 0); + let x = center.0 + (started.elapsed().as_secs_f64() * fly) as i32; + streaming.center = (x, center.1); phase.update(&mut streaming, &mut world); // Columns within 2 chunks of the player still missing their meshes. let near = (-2..=2) - .flat_map(|dz| (-2..=2).map(move |dx| (x + dx, dz))) + .flat_map(|dz| (-2..=2).map(move |dx| (x + dx, center.1 + dz))) .filter(|&(cx, cz)| !streaming.is_lit(cx, cz)) .count(); behind.push(near); diff --git a/crates/horizon-world/examples/chunkgen_bench.rs b/crates/horizon-world/examples/chunkgen_bench.rs index 4992515c5..2eb433600 100644 --- a/crates/horizon-world/examples/chunkgen_bench.rs +++ b/crates/horizon-world/examples/chunkgen_bench.rs @@ -3,6 +3,7 @@ //! chunkgen_bench [--seed S] [--size N] [--threads T] //! [--center CX CZ] [--verify ] [--no-decorate] //! [--dimension overworld|the_nether|the_end] +//! [--warmup] [--json] [--no-map] [--snapshot PATH] use horizon_core::position::ChunkPos; use horizon_world::{ DATA_VERSION, @@ -274,7 +275,9 @@ fn main() -> Result<(), Error> { let resources = PathBuf::from(args.next().expect("client resource directory")); let (mut seed, mut size, mut threads, mut center) = (0i64, 16i32, 2usize, (0, 0)); let mut parity = None; + let mut snapshot_path = None; let mut decorate = true; + let (mut warmup, mut json, mut map) = (false, false, true); let mut dimension = String::from("minecraft:overworld"); let mut starts: Option<(i32, i32, i32, i32, PathBuf)> = None; while let Some(arg) = args.next() { @@ -285,7 +288,11 @@ fn main() -> Result<(), Error> { "--threads" => threads = next().parse()?, "--center" => center = (next().parse()?, next().parse()?), "--verify" => parity = Some(PathBuf::from(next())), + "--snapshot" => snapshot_path = Some(PathBuf::from(next())), "--no-decorate" => decorate = false, + "--warmup" => warmup = true, + "--json" => json = true, + "--no-map" => map = false, "--dimension" => { let d = next(); dimension = if d.contains(':') { @@ -326,6 +333,16 @@ fn main() -> Result<(), Error> { dump_starts(&generator, seed, [x0, z0, x1, z1], &out)?; return Ok(()); } + if warmup { + let mut worker = generator.worker(); + for z in -4..=4 { + for x in -4..=4 { + std::hint::black_box( + worker.generate_proto(ChunkPos::new(center.0 + 64 + x, center.1 + 64 + z))?, + ); + } + } + } let (x0, z0) = (center.0 - size / 2, center.1 - size / 2); let count = (size * size) as usize; let next = AtomicUsize::new(0); @@ -353,6 +370,7 @@ fn main() -> Result<(), Error> { handles.into_iter().try_for_each(|h| h.join().unwrap()) })?; let elapsed = start.elapsed(); + let cpu_elapsed = cpu_seconds() - cpu; println!( "generated {count} proto chunks with {threads} threads in {elapsed:.2?}: {:.1} chunks/s ({:.1} ms/chunk/thread)", count as f64 / elapsed.as_secs_f64(), @@ -360,7 +378,7 @@ fn main() -> Result<(), Error> { ); println!( " cpu time {:.1} ms/chunk", - (cpu_seconds() - cpu) * 1000. / count as f64 + cpu_elapsed * 1000. / count as f64 ); let timings = timings.into_inner().unwrap(); let per_chunk = |f: fn(&StageTimings) -> std::time::Duration| { @@ -379,10 +397,23 @@ fn main() -> Result<(), Error> { per_chunk(|t| t.surface), per_chunk(|t| t.carvers) ); + if json { + println!( + "BENCH {}", + serde_json::json!({"phase": "proto", "chunks": count, + "threads": threads, "wall_s": elapsed.as_secs_f64(), "cpu_s": cpu_elapsed, + "biomes_ms_chunk": per_chunk(|t| t.biomes), "noise_ms_chunk": per_chunk(|t| t.noise), + "structures_ms_chunk": per_chunk(|t| t.structures), + "surface_ms_chunk": per_chunk(|t| t.surface), "carvers_ms_chunk": per_chunk(|t| t.carvers)}) + ); + } let mut chunks: Vec> = slots .into_iter() .map(|slot| slot.into_inner().unwrap()) .collect(); + if let Some(path) = &snapshot_path { + snapshot(&chunks, path, "terrain")?; + } if decorate && size >= 3 { let totals = Mutex::new(DecorateStats::default()); let start = Instant::now(); @@ -441,6 +472,13 @@ fn main() -> Result<(), Error> { } } let elapsed = start.elapsed(); + if json { + println!( + "BENCH {}", + serde_json::json!({"phase": "decorate", "chunks": decorated, + "wall_s": elapsed.as_secs_f64()}) + ); + } let totals = totals.into_inner().unwrap(); println!( "decorated {decorated} chunks in {elapsed:.2?}: {:.1} chunks/s; feature roots placed {}, unsupported {}, failed {}", @@ -461,6 +499,9 @@ fn main() -> Result<(), Error> { ); } } + if let Some(path) = &snapshot_path { + snapshot(&chunks, path, "decorated")?; + } let mut structures = BTreeMap::<(String, i32, i32), [[i32; 3]; 2]>::new(); for chunk in chunks.iter().flatten() { for (name, start, min, max) in chunk.structures() { @@ -492,6 +533,9 @@ fn main() -> Result<(), Error> { } } } + if !map { + return Ok(()); + } let mut legend = BTreeMap::>::new(); let step = (size * 16 / 96).max(1); for bz in (0..size * 16).step_by(step as usize) { @@ -534,3 +578,75 @@ fn main() -> Result<(), Error> { ); Ok(()) } + +// Diagnostic only: full ordered chunk state, outside performance measurements. +fn snapshot(chunks: &[Option], path: &Path, phase: &str) -> Result<(), Error> { + use std::io::Write; + let mut out = + std::io::BufWriter::new(fs::File::create(format!("{}-{phase}.bin", path.display()))?); + for chunk in chunks.iter().flatten() { + let terrain = &chunk.terrain; + writeln!( + out, + "chunk {:?} {:?} {} {:?} {:?}", + chunk.position(), + terrain.generation_stage(), + chunk.is_decorated(), + chunk.structures(), + terrain.below_zero_retrogen().map(|v| v.to_nbt()) + )?; + for section in 0..terrain.height() as usize / 16 { + let data = terrain.section(section).unwrap(); + writeln!(out, "section {section} {:?}", data.to_nbt()?)?; + for index in 0..4096 { + out.write_all(&data.get(index)?.0.to_le_bytes())?; + } + } + // Compare public reads too, including all-air section behavior. + for y in terrain.min_y()..terrain.min_y() + terrain.height() { + for z in 0..16 { + for x in 0..16 { + out.write_all(&terrain.block(x, y, z).0.to_le_bytes())?; + } + } + } + for y in (terrain.min_y() >> 2)..((terrain.min_y() + terrain.height()) >> 2) { + for z in 0..4 { + for x in 0..4 { + writeln!( + out, + "biome {}", + chunk.biome_at( + chunk.position().x * 16 + x * 4, + y * 4, + chunk.position().z * 16 + z * 4 + ) + )?; + } + } + } + for kind in HeightmapType::ALL { + writeln!( + out, + "heightmap {kind:?} {:?}", + terrain.heightmap(kind).map(|m| m.raw_data()) + )?; + } + writeln!(out, "post {:?}", terrain.postprocessing())?; + writeln!(out, "blockticks {:?}", terrain.block_ticks().pack(0))?; + writeln!(out, "fluidticks {:?}", terrain.fluid_ticks().pack(0))?; + for (position, tag) in &chunk.block_entities { + writeln!(out, "blockentity {position:?}")?; + let bytes = + horizon_world::nbt::write_network(&Tag::Compound(tag.clone()), Default::default())?; + out.write_all(&(bytes.len() as u64).to_le_bytes())?; + out.write_all(&bytes)?; + } + let entities = Tag::List(chunk.entities.iter().cloned().map(Tag::Compound).collect()); + let bytes = horizon_world::nbt::write_network(&entities, Default::default())?; + out.write_all(&(bytes.len() as u64).to_le_bytes())?; + out.write_all(&bytes)?; + } + out.flush()?; + Ok(()) +} diff --git a/crates/horizon-world/src/worldgen/generator.rs b/crates/horizon-world/src/worldgen/generator.rs index 2d7dd251c..fdba843b0 100644 --- a/crates/horizon-world/src/worldgen/generator.rs +++ b/crates/horizon-world/src/worldgen/generator.rs @@ -995,6 +995,46 @@ where worker.terrain_context = context; result } + /// With the native End source there are no badlands/iceberg extensions. + /// Disabled aquifers with air as their default fluid can only add lava or + /// air to the default solid, so this constant rule would rewrite each solid + /// with the state it already has. Check their imported material flags too. + /// Noise filling already built the WG maps; these writes add no fluid marks. + fn identity_end_surface(&self, pos: ChunkPos) -> bool { + if !matches!(self.source, ResolvedBiomeSource::End(_)) + // At wrapped block coordinates the ordinary biome-region lookup + // can fail; retain that lookup and its error outside this range. + || ![pos.x, pos.z].into_iter().all(|c| { + c.checked_mul(16).is_some_and(|b| { + b.checked_sub(16).is_some() && b.checked_add(31).is_some() + }) + }) + || self.aquifer.is_some() + || Some(self.settings.default_block) + != self.data.registry.default_state("minecraft:end_stone") + || Some(self.settings.default_fluid) + != self.data.registry.default_state("minecraft:air") + || !self.data.states.get(self.settings.default_fluid).air + || !self + .data + .registry + .default_state("minecraft:lava") + .is_some_and(|lava| self.data.states.get(lava).fluid) + { + return false; + } + let mut rule = &self.rule; + // Restrict the shortcut to shallow block references; other rules still + // run their normal compilation, queries and error handling. + for _ in 0..32 { + match rule { + MaterialRule::Reference(next) => rule = next, + MaterialRule::Block(state) => return *state == self.settings.default_block, + _ => return false, + } + } + false + } fn generate_with_context( &self, worker: &mut WorkerState, @@ -1103,27 +1143,29 @@ where .map_err(stage("noise"))?; let generation = self.generation(); worker.timings.noise += lap(&mut clock); - build_surface( - &mut chunk, - self.rule.clone(), - SurfaceInputs:: { - generation, - noise_volume: volume, - root: self.root.clone(), - surface: SurfaceQueries { - pipeline: self, - temperatures: &mut worker.temperatures, - biome: Biomes::Region(&biomes), - possible: Some(possible), + if !self.identity_end_surface(pos) { + build_surface( + &mut chunk, + self.rule.clone(), + SurfaceInputs:: { + generation, + noise_volume: volume, + root: self.root.clone(), + surface: SurfaceQueries { + pipeline: self, + temperatures: &mut worker.temperatures, + biome: Biomes::Region(&biomes), + possible: Some(possible), + }, + preliminary_surface: self.preliminary.clone(), + density_context: context, + write_min_y: min, + write_max_y: min + height - 1, }, - preliminary_surface: self.preliminary.clone(), - density_context: context, - write_min_y: min, - write_max_y: min + height - 1, - }, - &self.extensions, - ) - .map_err(stage("surface"))?; + &self.extensions, + ) + .map_err(stage("surface"))?; + } worker.timings.surface += lap(&mut clock); let carvers = &data.biome_carvers; let mask = generate_carving_mask(self.seed, pos, generation, false, |origin| { @@ -2407,6 +2449,108 @@ impl GeneratorWorker { #[cfg(test)] mod tests { use super::*; + #[test] + fn end_identity_surface_matches_normal_surface_and_rejects_custom_rules() { + let root = std::env::var_os("HORIZON_TEST_RESOURCES") + .map(std::path::PathBuf::from) + .unwrap_or_else(|| { + Path::new(env!("CARGO_MANIFEST_DIR")).join("../../.local/horizon-client/26.3") + }); + if !root.join("worldgen/world_presets.json").exists() { + eprintln!("skipping: no worldgen bundle at {}", root.display()); + return; + } + let registry = Box::leak(Box::new(crate::level::data::load_registry(&root).unwrap())); + let data = GeneratorData::load(&root.join("worldgen"), registry).unwrap(); + let preset: Value = serde_json::from_str(&data.world_presets["minecraft:normal"]).unwrap(); + let settings: Value = serde_json::from_str(&data.settings["minecraft:end"]).unwrap(); + let mut pipeline = Pipeline::new( + data.clone(), + 12345, + LegacyRandom::new(12345), + &preset["dimensions"]["minecraft:the_end"]["generator"], + &settings, + false, + None, + ) + .unwrap(); + let mut worker = OverworldGenerator::for_world( + data.clone(), + 12345, + "minecraft:normal", + "minecraft:the_end", + false, + ) + .unwrap() + .worker(); + assert!(pipeline.identity_end_surface(ChunkPos::new(0, 0))); + for pos in [ + ChunkPos::new(0, 0), + ChunkPos::new(128, 128), + ChunkPos::new(-128, 192), + ChunkPos::new(1_875_000, -1_875_000), + ] { + let actual = pipeline.generate(&mut worker.state, pos).unwrap(); + let rule = pipeline.rule.clone(); + // A singleton sequence evaluates the same block rule through the full surface path. + pipeline.rule = MaterialRule::Sequence(vec![rule.clone()]); + assert!(!pipeline.identity_end_surface(ChunkPos::new(0, 0))); + let expected = pipeline.generate(&mut worker.state, pos).unwrap(); + pipeline.rule = rule; + assert_eq!( + actual.terrain.generation_stage(), + expected.terrain.generation_stage() + ); + for section in 0..actual.terrain.height() as usize / 16 { + assert_eq!( + actual.terrain.section(section).unwrap().to_nbt().unwrap(), + expected.terrain.section(section).unwrap().to_nbt().unwrap() + ); + } + for kind in HeightmapType::ALL { + assert_eq!( + actual.terrain.heightmap(kind).map(|m| m.raw_data()), + expected.terrain.heightmap(kind).map(|m| m.raw_data()) + ); + } + assert_eq!( + actual.terrain.postprocessing(), + expected.terrain.postprocessing() + ); + assert_eq!( + actual.terrain.block_ticks().pack(0), + expected.terrain.block_ticks().pack(0) + ); + assert_eq!( + actual.terrain.fluid_ticks().pack(0), + expected.terrain.fluid_ticks().pack(0) + ); + assert_eq!(actual.block_entities, expected.block_entities); + assert_eq!(actual.entities, expected.entities); + assert_eq!(actual.structures(), expected.structures()); + } + assert!(!pipeline.identity_end_surface(ChunkPos::new(i32::MAX, 0))); + let old_rule = pipeline.rule.clone(); + pipeline.rule = MaterialRule::Block(registry.default_state("minecraft:stone").unwrap()); + assert!(!pipeline.identity_end_surface(ChunkPos::new(0, 0))); + pipeline.rule = old_rule; + let old_fluid = pipeline.settings.default_fluid; + pipeline.settings.default_fluid = registry.default_state("minecraft:stone").unwrap(); + assert!(!pipeline.identity_end_surface(ChunkPos::new(0, 0))); + pipeline.settings.default_fluid = old_fluid; + let old_source = std::mem::replace( + &mut pipeline.source, + ResolvedBiomeSource::Fixed(super::super::biome_source::FixedBiomeSource { + biome: "minecraft:the_end".into(), + }), + ); + assert!(!pipeline.identity_end_surface(ChunkPos::new(0, 0))); + pipeline.source = old_source; + pipeline.aquifer = Some(std::array::from_fn(|_| { + pipeline.router.get(RouterField::Erosion).clone() + })); + assert!(!pipeline.identity_end_surface(ChunkPos::new(0, 0))); + } #[test] fn far_surface_matches_undecorated_land_and_keeps_end_void() { From 270ba3fea97b77803cc29d1f4b95461c3a6f18a5 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 18:00:36 +0200 Subject: [PATCH 049/126] Launcher: a blocky, Minecraft-like look in dark and light Blocks palettes (dark default, light, or the system's, chosen in Settings), Pixelify Sans for headings and controls, Pixelarticons icons, square panels with an outline, a bevel and a lip, inventory tabs, and pixel art drawn in code: a stone texture behind the pages and a landscape behind Home. A top bar with the pages and the account chip, and a sidebar with the instances (Horizon shows the grass block the mod browser draws from the player's prepared textures), the hosted servers, and the launcher's version and channel. The mod browser's pages (kinds as tabs, project icons in slots, verdicts as badges, the project page) are restyled, not rebuilt. The benchmark also measures scrolling the Versions list. Co-Authored-By: Claude Opus 5.5 --- THIRD_PARTY_NOTICES.md | 12 + crates/horizon-theme/Cargo.toml | 2 +- .../horizon-theme/fonts/OFL-PixelifySans.txt | 93 ++ .../horizon-theme/fonts/PixelifySans-Bold.ttf | Bin 0 -> 95056 bytes .../fonts/PixelifySans-Medium.ttf | Bin 0 -> 94248 bytes .../fonts/PixelifySans-SemiBold.ttf | Bin 0 -> 97492 bytes .../icons/pixel/LICENSE-pixelarticons.txt | 21 + crates/horizon-theme/icons/pixel/archive.svg | 3 + .../horizon-theme/icons/pixel/arrow-left.svg | 4 + .../horizon-theme/icons/pixel/book-open.svg | 3 + crates/horizon-theme/icons/pixel/box.svg | 4 + crates/horizon-theme/icons/pixel/bug.svg | 5 + crates/horizon-theme/icons/pixel/check.svg | 3 + .../icons/pixel/chevron-down.svg | 3 + .../icons/pixel/chevron-right.svg | 3 + crates/horizon-theme/icons/pixel/clock.svg | 3 + crates/horizon-theme/icons/pixel/close.svg | 3 + crates/horizon-theme/icons/pixel/download.svg | 5 + .../icons/pixel/external-link.svg | 4 + crates/horizon-theme/icons/pixel/folder.svg | 3 + crates/horizon-theme/icons/pixel/gamepad.svg | 4 + crates/horizon-theme/icons/pixel/globe.svg | 4 + crates/horizon-theme/icons/pixel/heart.svg | 3 + crates/horizon-theme/icons/pixel/home.svg | 3 + crates/horizon-theme/icons/pixel/image.svg | 4 + crates/horizon-theme/icons/pixel/info-box.svg | 3 + crates/horizon-theme/icons/pixel/message.svg | 3 + crates/horizon-theme/icons/pixel/monitor.svg | 3 + crates/horizon-theme/icons/pixel/notes.svg | 4 + crates/horizon-theme/icons/pixel/package.svg | 4 + crates/horizon-theme/icons/pixel/play.svg | 3 + crates/horizon-theme/icons/pixel/plus.svg | 3 + crates/horizon-theme/icons/pixel/reload.svg | 5 + crates/horizon-theme/icons/pixel/search.svg | 3 + crates/horizon-theme/icons/pixel/server.svg | 3 + crates/horizon-theme/icons/pixel/sliders.svg | 1 + crates/horizon-theme/icons/pixel/terminal.svg | 3 + crates/horizon-theme/icons/pixel/trash.svg | 3 + crates/horizon-theme/icons/pixel/user.svg | 3 + crates/horizon-theme/icons/pixel/zap.svg | 3 + crates/horizon-theme/src/lib.rs | 223 +++ docs/design-system.md | 39 +- launcher/src/art.rs | 323 +++++ launcher/src/backend.rs | 39 + launcher/src/blocks.rs | 232 +++ launcher/src/main.rs | 1238 ++++++++++++----- launcher/src/modpacks_page.rs | 24 +- launcher/src/mods_page.rs | 150 +- launcher/src/mods_project.rs | 29 +- launcher/src/perf.rs | 73 +- launcher/src/scrollbar.rs | 21 +- launcher/src/servers_page.rs | 12 + launcher/src/theme.rs | 95 +- 53 files changed, 2250 insertions(+), 487 deletions(-) create mode 100644 crates/horizon-theme/fonts/OFL-PixelifySans.txt create mode 100644 crates/horizon-theme/fonts/PixelifySans-Bold.ttf create mode 100644 crates/horizon-theme/fonts/PixelifySans-Medium.ttf create mode 100644 crates/horizon-theme/fonts/PixelifySans-SemiBold.ttf create mode 100644 crates/horizon-theme/icons/pixel/LICENSE-pixelarticons.txt create mode 100644 crates/horizon-theme/icons/pixel/archive.svg create mode 100644 crates/horizon-theme/icons/pixel/arrow-left.svg create mode 100644 crates/horizon-theme/icons/pixel/book-open.svg create mode 100644 crates/horizon-theme/icons/pixel/box.svg create mode 100644 crates/horizon-theme/icons/pixel/bug.svg create mode 100644 crates/horizon-theme/icons/pixel/check.svg create mode 100644 crates/horizon-theme/icons/pixel/chevron-down.svg create mode 100644 crates/horizon-theme/icons/pixel/chevron-right.svg create mode 100644 crates/horizon-theme/icons/pixel/clock.svg create mode 100644 crates/horizon-theme/icons/pixel/close.svg create mode 100644 crates/horizon-theme/icons/pixel/download.svg create mode 100644 crates/horizon-theme/icons/pixel/external-link.svg create mode 100644 crates/horizon-theme/icons/pixel/folder.svg create mode 100644 crates/horizon-theme/icons/pixel/gamepad.svg create mode 100644 crates/horizon-theme/icons/pixel/globe.svg create mode 100644 crates/horizon-theme/icons/pixel/heart.svg create mode 100644 crates/horizon-theme/icons/pixel/home.svg create mode 100644 crates/horizon-theme/icons/pixel/image.svg create mode 100644 crates/horizon-theme/icons/pixel/info-box.svg create mode 100644 crates/horizon-theme/icons/pixel/message.svg create mode 100644 crates/horizon-theme/icons/pixel/monitor.svg create mode 100644 crates/horizon-theme/icons/pixel/notes.svg create mode 100644 crates/horizon-theme/icons/pixel/package.svg create mode 100644 crates/horizon-theme/icons/pixel/play.svg create mode 100644 crates/horizon-theme/icons/pixel/plus.svg create mode 100644 crates/horizon-theme/icons/pixel/reload.svg create mode 100644 crates/horizon-theme/icons/pixel/search.svg create mode 100644 crates/horizon-theme/icons/pixel/server.svg create mode 100644 crates/horizon-theme/icons/pixel/sliders.svg create mode 100644 crates/horizon-theme/icons/pixel/terminal.svg create mode 100644 crates/horizon-theme/icons/pixel/trash.svg create mode 100644 crates/horizon-theme/icons/pixel/user.svg create mode 100644 crates/horizon-theme/icons/pixel/zap.svg create mode 100644 launcher/src/art.rs create mode 100644 launcher/src/blocks.rs diff --git a/THIRD_PARTY_NOTICES.md b/THIRD_PARTY_NOTICES.md index 368813ecf..88d3197af 100644 --- a/THIRD_PARTY_NOTICES.md +++ b/THIRD_PARTY_NOTICES.md @@ -36,3 +36,15 @@ SOFTWARE. developers, with one upstream fix applied ([gfx-rs/wgpu#10124](https://github.com/gfx-rs/wgpu/pull/10124)). It is licensed under MIT or Apache-2.0; both licenses are in that folder (`LICENSE.MIT`, `LICENSE.APACHE`). + +## Pixelify Sans + +`crates/horizon-theme/fonts/PixelifySans-*.ttf` is [Pixelify Sans](https://github.com/eifetx/Pixelify-Sans) +by The Pixelify Sans Project Authors, licensed under the SIL Open Font License 1.1 +(`crates/horizon-theme/fonts/OFL-PixelifySans.txt`). + +## Pixelarticons + +`crates/horizon-theme/icons/pixel/*.svg` are icons from +[Pixelarticons](https://github.com/halfmage/pixelarticons) by Gerrit Halfmann, under the MIT +license (`crates/horizon-theme/icons/pixel/LICENSE-pixelarticons.txt`). diff --git a/crates/horizon-theme/Cargo.toml b/crates/horizon-theme/Cargo.toml index a2fc2eead..3cc6d2324 100644 --- a/crates/horizon-theme/Cargo.toml +++ b/crates/horizon-theme/Cargo.toml @@ -3,6 +3,6 @@ name = "horizon-theme" version = "0.1.0" edition = "2021" license = "MIT" -description = "Horizon's design tokens and fonts, shared by the launcher and the game's menus" +description = "Horizon's design tokens, fonts and icons, shared by the launcher, the website and the game's menus" [dependencies] diff --git a/crates/horizon-theme/fonts/OFL-PixelifySans.txt b/crates/horizon-theme/fonts/OFL-PixelifySans.txt new file mode 100644 index 000000000..6aa5bfbae --- /dev/null +++ b/crates/horizon-theme/fonts/OFL-PixelifySans.txt @@ -0,0 +1,93 @@ +Copyright 2021 The Pixelify Sans Project Authors (https://github.com/eifetx/Pixelify-Sans) + +This Font Software is licensed under the SIL Open Font License, Version 1.1. +This license is copied below, and is also available with a FAQ at: +https://scripts.sil.org/OFL + + +----------------------------------------------------------- +SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007 +----------------------------------------------------------- + +PREAMBLE +The goals of the Open Font License (OFL) are to stimulate worldwide +development of collaborative font projects, to support the font creation +efforts of academic and linguistic communities, and to provide a free and +open framework in which fonts may be shared and improved in partnership +with others. + +The OFL allows the licensed fonts to be used, studied, modified and +redistributed freely as long as they are not sold by themselves. The +fonts, including any derivative works, can be bundled, embedded, +redistributed and/or sold with any software provided that any reserved +names are not used by derivative works. The fonts and derivatives, +however, cannot be released under any other type of license. The +requirement for fonts to remain under this license does not apply +to any document created using the fonts or their derivatives. + +DEFINITIONS +"Font Software" refers to the set of files released by the Copyright +Holder(s) under this license and clearly marked as such. This may +include source files, build scripts and documentation. + +"Reserved Font Name" refers to any names specified as such after the +copyright statement(s). + +"Original Version" refers to the collection of Font Software components as +distributed by the Copyright Holder(s). + +"Modified Version" refers to any derivative made by adding to, deleting, +or substituting -- in part or in whole -- any of the components of the +Original Version, by changing formats or by porting the Font Software to a +new environment. + +"Author" refers to any designer, engineer, programmer, technical +writer or other person who contributed to the Font Software. + +PERMISSION & CONDITIONS +Permission is hereby granted, free of charge, to any person obtaining +a copy of the Font Software, to use, study, copy, merge, embed, modify, +redistribute, and sell modified and unmodified copies of the Font +Software, subject to the following conditions: + +1) Neither the Font Software nor any of its individual components, +in Original or Modified Versions, may be sold by itself. + +2) Original or Modified Versions of the Font Software may be bundled, +redistributed and/or sold with any software, provided that each copy +contains the above copyright notice and this license. These can be +included either as stand-alone text files, human-readable headers or +in the appropriate machine-readable metadata fields within text or +binary files as long as those fields can be easily viewed by the user. + +3) No Modified Version of the Font Software may use the Reserved Font +Name(s) unless explicit written permission is granted by the corresponding +Copyright Holder. This restriction only applies to the primary font name as +presented to the users. + +4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font +Software shall not be used to promote, endorse or advertise any +Modified Version, except to acknowledge the contribution(s) of the +Copyright Holder(s) and the Author(s) or with their explicit written +permission. + +5) The Font Software, modified or unmodified, in part or in whole, +must be distributed entirely under this license, and must not be +distributed under any other license. The requirement for fonts to +remain under this license does not apply to any document created +using the Font Software. + +TERMINATION +This license becomes null and void if any of the above conditions are +not met. + +DISCLAIMER +THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT +OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE +COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL +DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM +OTHER DEALINGS IN THE FONT SOFTWARE. diff --git a/crates/horizon-theme/fonts/PixelifySans-Bold.ttf b/crates/horizon-theme/fonts/PixelifySans-Bold.ttf new file mode 100644 index 0000000000000000000000000000000000000000..5f8040b71be14d283010c4a646eac856a03988bf GIT binary patch literal 95056 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


|G2G{{AWR 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 literal 0 HcmV?d00001 diff --git a/crates/horizon-theme/fonts/PixelifySans-Medium.ttf b/crates/horizon-theme/fonts/PixelifySans-Medium.ttf new file mode 100644 index 0000000000000000000000000000000000000000..5bf69961d9a3e4f83a3440319ec37cf7c49e30a7 GIT binary patch literal 94248 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 + + diff --git a/crates/horizon-theme/icons/pixel/arrow-left.svg b/crates/horizon-theme/icons/pixel/arrow-left.svg new file mode 100644 index 000000000..96905e6c1 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/arrow-left.svg @@ -0,0 +1,4 @@ + + + + diff --git a/crates/horizon-theme/icons/pixel/book-open.svg b/crates/horizon-theme/icons/pixel/book-open.svg new file mode 100644 index 000000000..b9b134ccc --- /dev/null +++ b/crates/horizon-theme/icons/pixel/book-open.svg @@ -0,0 +1,3 @@ + + + diff --git a/crates/horizon-theme/icons/pixel/box.svg b/crates/horizon-theme/icons/pixel/box.svg new file mode 100644 index 000000000..68f58c8ed --- /dev/null +++ b/crates/horizon-theme/icons/pixel/box.svg @@ -0,0 +1,4 @@ + + + + diff --git a/crates/horizon-theme/icons/pixel/bug.svg b/crates/horizon-theme/icons/pixel/bug.svg new file mode 100644 index 000000000..cdc707a44 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/bug.svg @@ -0,0 +1,5 @@ + + + + + diff --git a/crates/horizon-theme/icons/pixel/check.svg b/crates/horizon-theme/icons/pixel/check.svg new file mode 100644 index 000000000..e8dec6fe8 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/check.svg @@ -0,0 +1,3 @@ + + + diff --git a/crates/horizon-theme/icons/pixel/chevron-down.svg b/crates/horizon-theme/icons/pixel/chevron-down.svg new file mode 100644 index 000000000..472e5e0d0 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/chevron-down.svg @@ -0,0 +1,3 @@ + + + diff --git a/crates/horizon-theme/icons/pixel/chevron-right.svg b/crates/horizon-theme/icons/pixel/chevron-right.svg new file mode 100644 index 000000000..ad8a9142c --- /dev/null +++ b/crates/horizon-theme/icons/pixel/chevron-right.svg @@ -0,0 +1,3 @@ + + + diff --git a/crates/horizon-theme/icons/pixel/clock.svg b/crates/horizon-theme/icons/pixel/clock.svg new file mode 100644 index 000000000..e17594f98 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/clock.svg @@ -0,0 +1,3 @@ + + + diff --git a/crates/horizon-theme/icons/pixel/close.svg b/crates/horizon-theme/icons/pixel/close.svg new file mode 100644 index 000000000..6e6d81257 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/close.svg @@ -0,0 +1,3 @@ + + + diff --git a/crates/horizon-theme/icons/pixel/download.svg b/crates/horizon-theme/icons/pixel/download.svg new file mode 100644 index 000000000..122cfbd80 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/download.svg @@ -0,0 +1,5 @@ + + + + + diff --git a/crates/horizon-theme/icons/pixel/external-link.svg b/crates/horizon-theme/icons/pixel/external-link.svg new file mode 100644 index 000000000..7058bc5b7 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/external-link.svg @@ -0,0 +1,4 @@ + + + + diff --git a/crates/horizon-theme/icons/pixel/folder.svg b/crates/horizon-theme/icons/pixel/folder.svg new file mode 100644 index 000000000..40533e4bb --- /dev/null +++ b/crates/horizon-theme/icons/pixel/folder.svg @@ -0,0 +1,3 @@ + + + diff --git a/crates/horizon-theme/icons/pixel/gamepad.svg b/crates/horizon-theme/icons/pixel/gamepad.svg new file mode 100644 index 000000000..9936d5e66 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/gamepad.svg @@ -0,0 +1,4 @@ + + + + diff --git a/crates/horizon-theme/icons/pixel/globe.svg b/crates/horizon-theme/icons/pixel/globe.svg new file mode 100644 index 000000000..3b984aa0c --- /dev/null +++ b/crates/horizon-theme/icons/pixel/globe.svg @@ -0,0 +1,4 @@ + + + + diff --git a/crates/horizon-theme/icons/pixel/heart.svg b/crates/horizon-theme/icons/pixel/heart.svg new file mode 100644 index 000000000..7c0ccb9eb --- /dev/null +++ b/crates/horizon-theme/icons/pixel/heart.svg @@ -0,0 +1,3 @@ + + + diff --git a/crates/horizon-theme/icons/pixel/home.svg b/crates/horizon-theme/icons/pixel/home.svg new file mode 100644 index 000000000..f71cb8c00 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/home.svg @@ -0,0 +1,3 @@ + + + diff --git a/crates/horizon-theme/icons/pixel/image.svg b/crates/horizon-theme/icons/pixel/image.svg new file mode 100644 index 000000000..cf2892770 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/image.svg @@ -0,0 +1,4 @@ + + + + diff --git a/crates/horizon-theme/icons/pixel/info-box.svg b/crates/horizon-theme/icons/pixel/info-box.svg new file mode 100644 index 000000000..04128032b --- /dev/null +++ b/crates/horizon-theme/icons/pixel/info-box.svg @@ -0,0 +1,3 @@ + + + diff --git a/crates/horizon-theme/icons/pixel/message.svg b/crates/horizon-theme/icons/pixel/message.svg new file mode 100644 index 000000000..c5dc11a7e --- /dev/null +++ b/crates/horizon-theme/icons/pixel/message.svg @@ -0,0 +1,3 @@ + + + diff --git a/crates/horizon-theme/icons/pixel/monitor.svg b/crates/horizon-theme/icons/pixel/monitor.svg new file mode 100644 index 000000000..52edf4d4f --- /dev/null +++ b/crates/horizon-theme/icons/pixel/monitor.svg @@ -0,0 +1,3 @@ + + + diff --git a/crates/horizon-theme/icons/pixel/notes.svg b/crates/horizon-theme/icons/pixel/notes.svg new file mode 100644 index 000000000..beb8d97e5 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/notes.svg @@ -0,0 +1,4 @@ + + + + diff --git a/crates/horizon-theme/icons/pixel/package.svg b/crates/horizon-theme/icons/pixel/package.svg new file mode 100644 index 000000000..cc6ce0788 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/package.svg @@ -0,0 +1,4 @@ + + + + diff --git a/crates/horizon-theme/icons/pixel/play.svg b/crates/horizon-theme/icons/pixel/play.svg new file mode 100644 index 000000000..02e3c17aa --- /dev/null +++ b/crates/horizon-theme/icons/pixel/play.svg @@ -0,0 +1,3 @@ + + + diff --git a/crates/horizon-theme/icons/pixel/plus.svg b/crates/horizon-theme/icons/pixel/plus.svg new file mode 100644 index 000000000..cd35642b9 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/plus.svg @@ -0,0 +1,3 @@ + + + diff --git a/crates/horizon-theme/icons/pixel/reload.svg b/crates/horizon-theme/icons/pixel/reload.svg new file mode 100644 index 000000000..3458d03f0 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/reload.svg @@ -0,0 +1,5 @@ + + + + + diff --git a/crates/horizon-theme/icons/pixel/search.svg b/crates/horizon-theme/icons/pixel/search.svg new file mode 100644 index 000000000..7dce1b5ea --- /dev/null +++ b/crates/horizon-theme/icons/pixel/search.svg @@ -0,0 +1,3 @@ + + + diff --git a/crates/horizon-theme/icons/pixel/server.svg b/crates/horizon-theme/icons/pixel/server.svg new file mode 100644 index 000000000..7979820e7 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/server.svg @@ -0,0 +1,3 @@ + + + diff --git a/crates/horizon-theme/icons/pixel/sliders.svg b/crates/horizon-theme/icons/pixel/sliders.svg new file mode 100644 index 000000000..c2b4912d0 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/sliders.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/crates/horizon-theme/icons/pixel/terminal.svg b/crates/horizon-theme/icons/pixel/terminal.svg new file mode 100644 index 000000000..e000cd104 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/terminal.svg @@ -0,0 +1,3 @@ + + + diff --git a/crates/horizon-theme/icons/pixel/trash.svg b/crates/horizon-theme/icons/pixel/trash.svg new file mode 100644 index 000000000..f67fe4eca --- /dev/null +++ b/crates/horizon-theme/icons/pixel/trash.svg @@ -0,0 +1,3 @@ + + + diff --git a/crates/horizon-theme/icons/pixel/user.svg b/crates/horizon-theme/icons/pixel/user.svg new file mode 100644 index 000000000..13773d116 --- /dev/null +++ b/crates/horizon-theme/icons/pixel/user.svg @@ -0,0 +1,3 @@ + + + diff --git a/crates/horizon-theme/icons/pixel/zap.svg b/crates/horizon-theme/icons/pixel/zap.svg new file mode 100644 index 000000000..93ab75cbf --- /dev/null +++ b/crates/horizon-theme/icons/pixel/zap.svg @@ -0,0 +1,3 @@ + + + diff --git a/crates/horizon-theme/src/lib.rs b/crates/horizon-theme/src/lib.rs index ced8731c1..035651275 100644 --- a/crates/horizon-theme/src/lib.rs +++ b/crates/horizon-theme/src/lib.rs @@ -11,6 +11,9 @@ use std::time::Duration; pub const FONT: &str = "Geist"; pub const MONO: &str = "Geist Mono"; +/// The launcher's and the website's display face (headings, navigation, buttons, badges only): +/// Pixelify Sans, bundled under the SIL Open Font License (`fonts/OFL-PixelifySans.txt`). +pub const PIXEL: &str = "Pixelify Sans"; /// The bundled font files. pub mod fonts { @@ -18,6 +21,62 @@ pub mod fonts { pub const GEIST_MEDIUM: &[u8] = include_bytes!("../fonts/Geist-Medium.ttf"); pub const GEIST_SEMIBOLD: &[u8] = include_bytes!("../fonts/Geist-SemiBold.ttf"); pub const GEIST_MONO: &[u8] = include_bytes!("../fonts/GeistMono-Regular.ttf"); + pub const PIXEL_MEDIUM: &[u8] = include_bytes!("../fonts/PixelifySans-Medium.ttf"); + pub const PIXEL_SEMIBOLD: &[u8] = include_bytes!("../fonts/PixelifySans-SemiBold.ttf"); + pub const PIXEL_BOLD: &[u8] = include_bytes!("../fonts/PixelifySans-Bold.ttf"); +} + +/// The launcher's pixel icons: Pixelarticons (MIT, `icons/pixel/LICENSE-pixelarticons.txt`), 24 +/// unit SVGs filled with `currentColor`, by name (`"home"`, `"play"`…). +pub mod icons { + macro_rules! icons { + ($($name:literal),* $(,)?) => { + /// Every icon, `(name, svg)`. + pub const ALL: &[(&str, &[u8])] = &[ + $(($name, include_bytes!(concat!("../icons/pixel/", $name, ".svg")))),* + ]; + }; + } + icons!( + "archive", + "arrow-left", + "book-open", + "box", + "bug", + "check", + "chevron-down", + "chevron-right", + "clock", + "close", + "download", + "external-link", + "folder", + "gamepad", + "globe", + "heart", + "home", + "image", + "info-box", + "message", + "monitor", + "notes", + "package", + "play", + "plus", + "reload", + "search", + "server", + "sliders", + "terminal", + "trash", + "user", + "zap", + ); + + /// An icon's SVG by name. + pub fn get(name: &str) -> Option<&'static [u8]> { + ALL.iter().find(|(n, _)| *n == name).map(|(_, svg)| *svg) + } } /// Horizon's icon at 64 px (PNG), for window title bars and task bars at run time. Rendered from @@ -275,6 +334,113 @@ pub const DARK: Palette = Palette { dark: true, }; +/// The launcher's and the website's blocky look ("Blocks" in `docs/design-system.md`): stone-dark +/// (or lavender-light) neutrals with a violet cast, panels with a dark outline, a light bevel on top +/// and a darker lip below, and the violet `face` of the one big action. The game's menus keep +/// [`LIGHT`] and [`DARK`]. +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub struct Blocks { + /// The window behind everything, tiled with a faint stone texture. + pub page: u32, + /// The top bar and the sidebar. + pub side: u32, + /// Panels: rows, cards, dialogs. + pub panel: u32, + /// A selected or hovered panel or row, the open tab. + pub raised: u32, + /// Buttons and the chosen segment. + pub button: u32, + /// A button's top bevel. + pub button_bevel: u32, + /// Sunk wells: fields, tracks, switch and checkbox boxes, segmented tracks. + pub well: u32, + /// The light top (and left) edge of a panel. + pub bevel: u32, + /// The darker bottom edge of a panel or button. + pub lip: u32, + /// The 2 px outline around panels, buttons and wells. + pub outline: u32, + /// Rules between rows inside a panel. + pub rule: u32, + pub ink: u32, + pub ink_soft: u32, + pub muted: u32, + /// Links, focus, progress, the selection marker; text-safe on every background. + pub accent: u32, + /// The main action's face (Play, Install, Download), its top bevel and bottom lip. + pub face: u32, + pub face_bevel: u32, + pub face_lip: u32, + pub on_face: u32, + pub danger: u32, + pub success: u32, + /// "Partly": a mod or pack that runs in part. + pub warn: u32, + pub dark: bool, +} + +pub const BLOCKS_DARK: Blocks = Blocks { + page: 0x0f0d17, + side: 0x0b0a11, + panel: 0x1a1727, + raised: 0x221e34, + button: 0x2b2641, + button_bevel: 0x3d3560, + well: 0x0c0b12, + bevel: 0x342d52, + lip: 0x07060b, + outline: 0x05040a, + rule: 0x120f1c, + ink: 0xecedf3, + ink_soft: 0xc5c7d1, + muted: 0xa29cb8, + accent: 0x9a86ff, + face: 0x5b3fd6, + face_bevel: 0x8a74ff, + face_lip: 0x3a2694, + on_face: 0xffffff, + danger: 0xf07a68, + success: 0x45c27a, + warn: 0xf0b84f, + dark: true, +}; + +pub const BLOCKS_LIGHT: Blocks = Blocks { + page: 0xece7f7, + side: 0xe2dbf2, + panel: 0xf8f6fd, + raised: 0xe9e3f8, + button: 0xddd4f3, + button_bevel: 0xf4f0fe, + well: 0xf3f0fb, + bevel: 0xffffff, + lip: 0xc3b8e2, + outline: 0x2b2244, + rule: 0xe4ddf4, + ink: 0x1b1530, + ink_soft: 0x3b3354, + muted: 0x585071, + accent: 0x5333c9, + face: 0x5b3fd6, + face_bevel: 0x8069ef, + face_lip: 0x3a2694, + on_face: 0xffffff, + danger: 0xa3301d, + success: 0x136336, + warn: 0x7a4f00, + dark: false, +}; + +/// Pixel sizes of the blocky look: outlines, bevels and lips, the cut corner, and the stone tile. +pub const BLOCK_OUTLINE: f32 = 2.; +pub const BLOCK_BEVEL: f32 = 2.; +pub const BLOCK_LIP: f32 = 4.; +/// The stone texture: a 16 by 16 tile, each texel this many logical pixels. +pub const TILE_TEXELS: usize = 16; +pub const TILE_TEXEL: f32 = 4.; +/// The texture's shades: the page colour moved this many levels (of 255) lighter or darker. +pub const TILE_SHADES: [i16; 5] = [0, 2, -2, 5, -4]; + /// How strongly the game's menus veil the live backdrop (the title panorama, or the world behind /// the pause and options screens) with the page colour. Every text colour the menus use keeps /// WCAG AA over it, even on a selected row's plate, with a backdrop as bright as @@ -458,6 +624,63 @@ mod tests { } } + /// The blocky look: every text colour on every background it is drawn on reaches AA, the + /// main action's label too, and the focus ring (the accent) reaches 3:1 (WCAG 1.4.11). + #[test] + fn blocks_text_meets_wcag_aa_in_both_appearances() { + for p in [BLOCKS_DARK, BLOCKS_LIGHT] { + let theme = if p.dark { "dark" } else { "light" }; + let backgrounds = [ + ("page", p.page), + ("side", p.side), + ("panel", p.panel), + ("raised", p.raised), + ("button", p.button), + ("well", p.well), + ]; + let texts = [ + ("ink", p.ink), + ("ink_soft", p.ink_soft), + ("muted", p.muted), + ("accent", p.accent), + ("danger", p.danger), + ("success", p.success), + ("warn", p.warn), + ]; + for (bn, bg) in backgrounds { + for (tn, fg) in texts { + let ratio = contrast(fg, bg); + assert!(ratio >= 4.5, "{theme} {tn} on {bn}: {ratio:.2}"); + } + // The texture's lightest shade under the page's text. + let lifted = TILE_SHADES.iter().max().copied().unwrap_or(0) as i32; + let shade = [16, 8, 0].iter().fold(0, |out, s| { + let c = (((p.page >> s) & 255) as i32 + lifted).clamp(0, 255) as u32; + out | c << s + }); + for (tn, fg) in texts { + let ratio = contrast(fg, shade); + assert!( + ratio >= 4.5, + "{theme} {tn} on the stone texture: {ratio:.2}" + ); + } + } + let label = contrast(p.on_face, p.face); + assert!(label >= 4.5, "{theme} the main action's label: {label:.2}"); + } + } + + #[test] + fn every_icon_is_a_pixel_svg() { + for (name, svg) in icons::ALL { + let svg = std::str::from_utf8(svg).unwrap(); + assert!(svg.contains("viewBox=\"0 0 24 24\""), "{name}"); + assert!(svg.contains("currentColor"), "{name}"); + } + assert!(icons::get("play").is_some()); + } + /// The game's menus over the brightest backdrop: the page colour veiled over it, and a /// selected row's plate (ink at 8 %) on top. #[test] diff --git a/docs/design-system.md b/docs/design-system.md index 40b5c1b84..2746de371 100644 --- a/docs/design-system.md +++ b/docs/design-system.md @@ -133,12 +133,12 @@ Geist (400, 500, 600) and Geist Mono (400), bundled under the SIL Open Font Lice ## Surfaces -- **Launcher** (`launcher/`): top bar; Play is a page header (version as the title, its notes' - first line under it), the client/server segmented control, the version picker and Play, then - an index list of Resources, Minecraft folder (and the server rows). Versions and Patch notes - 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. +- **Launcher** (`launcher/`): drawn in the Blocks look below. A top bar (wordmark, the pages as + tabs, the account chip, Settings), a sidebar (the instances, the hosted servers, the launcher's + own version and channel at its foot), and the page over a stone texture. Home opens on a pixel + landscape banner with the hero, the version picker and Play; Mods holds the resource pack, + shader pack and modpack tabs; Versions and Patch notes are lists of panels; Settings is + grouped panels of rows. Dark by default, Light or System in Settings (Appearance). - **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 @@ -150,6 +150,33 @@ Geist (400, 500, 600) and Geist Mono (400), bundled under the SIL Open Font Lice in mono, the control right). The pause menu is a centred column of plain rows over a darker veil. +## Blocks (the launcher) + +The launcher's look since the gaming redesign: Minecraft's inventory rather than a document. +Its tokens are `horizon_theme::Blocks` (`BLOCKS_DARK`, `BLOCKS_LIGHT`); the palettes above stay +what the game's menus read. + +- **Pixel type for what you act on.** Headings, tabs, buttons, badges and the wordmark use Pixelify + Sans (Medium, SemiBold, Bold); paragraphs, details and numbers stay in Geist and Geist Mono so long + text reads easily. +- **Blocks, not rounded cards.** Every surface is a square panel: a 2 px dark outline, a 2 px light + bevel along the top and a darker lip along the bottom. The main action (Play, Install) is the + violet `face` with its own bevel and a 4 px lip; secondary buttons are raised `button` blocks; + fields and tracks are sunk `well`s. +- **Inventory tabs** switch the kinds in Mods: the open tab joins the panel under it. +- **Slots** hold pictures: a mod's or pack's own icon and gallery images from its source, + downloaded when first shown and kept on disk (`launcher/src/browser/images.rs`); the launcher + ships no third-party pictures. The Horizon instance shows a grass block drawn from the player's + own prepared Minecraft textures. Sources are named in text ("from Modrinth"): Modrinth's logo is + all rights reserved, so it is not shown. +- **Pixel art made in code** (`launcher/src/art.rs`): the stone behind the pages (16 texel tiles in + five shades of the page colour) and the landscape behind Home (a sunset in dark, a dawn in light), + baked at the window's scale so each texel covers whole device pixels. +- **Icons**: Pixelarticons (MIT), 24 unit pixel SVGs in `crates/horizon-theme/icons/pixel/`, tinted + with the text colour. +- **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 **Horizon line.** A sun half set below a horizon, drawn as three horizontal bars of 4, 8 and diff --git a/launcher/src/art.rs b/launcher/src/art.rs new file mode 100644 index 000000000..ecae80714 --- /dev/null +++ b/launcher/src/art.rs @@ -0,0 +1,323 @@ +//! The launcher's pixel art, drawn here rather than shipped: the stone texture behind the pages +//! and the landscape behind Home (the vanilla grass block is `browser::images::grass_block`). +//! GPUI samples images smoothly, so every image is baked at the window's scale with each texel a +//! whole block of device pixels, and drawn at exactly its size: the edges stay sharp. Each image +//! is made once per appearance and scale, then reused. +use gpui::RenderImage; +use horizon_theme as tokens; +use std::collections::HashMap; +use std::sync::Arc; + +/// What an image is, to find it again. +#[derive(Clone, PartialEq, Eq, Hash)] +enum Key { + Stone { dark: bool, scale: u32 }, + Scene { dark: bool, scale: u32 }, +} + +#[derive(Default)] +pub struct Art { + made: HashMap>, +} + +/// The stone texture comes in squares of this many logical pixels (4 by 4 tiles). +pub const STONE: f32 = tokens::TILE_TEXEL * (tokens::TILE_TEXELS * 4) as f32; +/// Home's landscape: texels of this many logical pixels, and its size in texels. +pub const SCENE_TEXEL: f32 = 6.; +pub const SCENE_SIZE: (usize, usize) = (220, 56); + +impl Art { + /// The page's stone texture, for a window at `scale`. + pub fn stone(&mut self, page: u32, dark: bool, scale: f32) -> Arc { + let key = Key::Stone { + dark, + scale: scale_key(scale), + }; + self.made + .entry(key) + .or_insert_with(|| { + let n = tokens::TILE_TEXELS * 4; + bake(&opaque(&stone(page, n)), n, n, tokens::TILE_TEXEL, scale) + }) + .clone() + } + + /// Home's landscape: a sunset in the dark appearance, a dawn in the light one. + pub fn scene(&mut self, dark: bool, scale: f32) -> Arc { + let key = Key::Scene { + dark, + scale: scale_key(scale), + }; + self.made + .entry(key) + .or_insert_with(|| { + let (w, h) = SCENE_SIZE; + let palette = if dark { &SUNSET } else { &DAWN }; + bake(&opaque(&scene(palette, 3, w, h)), w, h, SCENE_TEXEL, scale) + }) + .clone() + } +} + +/// `0xRRGGBB` texels, opaque. +fn opaque(texels: &[u32]) -> Vec<[u8; 4]> { + texels + .iter() + .map(|c| [(c >> 16) as u8, (c >> 8) as u8, *c as u8, 255]) + .collect() +} + +/// The colour at the top of Home's sky, for the banner above the landscape when it is taller. +pub fn sky_top(dark: bool) -> u32 { + if dark { + SUNSET.sky[0] + } else { + DAWN.sky[0] + } +} + +fn scale_key(scale: f32) -> u32 { + (scale * 100.).round() as u32 +} + +/// `texels` (RGBA, row by row) as an image whose texels are `texel` logical pixels square at +/// `scale`. Texel edges fall on whole device pixels where the scale allows (1×, 2×, 3×). +pub fn bake(texels: &[[u8; 4]], w: usize, h: usize, texel: f32, scale: f32) -> Arc { + let size = |n: usize| ((n as f32 * texel * scale).round() as u32).max(1); + let (dw, dh) = (size(w), size(h)); + let mut buf = image::RgbaImage::new(dw, dh); + for (y, row) in buf.rows_mut().enumerate() { + let ty = (y * h / dh as usize).min(h - 1); + for (x, px) in row.enumerate() { + let tx = (x * w / dw as usize).min(w - 1); + let [r, g, b, a] = texels[ty * w + tx]; + // GPUI wants BGRA, its alpha premultiplied. + let pre = |c: u8| (c as u32 * a as u32 / 255) as u8; + *px = image::Rgba([pre(b), pre(g), pre(r), a]); + } + } + Arc::new(RenderImage::new([image::Frame::new(buf)])) +} + +/// A small, fixed random sequence (xorshift), so the art is the same on every start. +struct Rng(u32); + +impl Rng { + fn next(&mut self) -> f32 { + let mut x = self.0; + x ^= x << 13; + x ^= x >> 17; + x ^= x << 5; + self.0 = x; + (x >> 8) as f32 / (1 << 24) as f32 + } +} + +fn shade(c: u32, by: i16) -> u32 { + [16, 8, 0].iter().fold(0, |out, s| { + let v = (((c >> s) & 255) as i16 + by).clamp(0, 255) as u32; + out | v << s + }) +} + +fn mix(a: u32, b: u32, t: f32) -> u32 { + [16, 8, 0].iter().fold(0, |out, s| { + let (x, y) = (((a >> s) & 255) as f32, ((b >> s) & 255) as f32); + out | ((x + (y - x) * t).round() as u32) << s + }) +} + +/// `n` by `n` texels of stone: the page colour in a few close shades, with darker flecks. +fn stone(page: u32, n: usize) -> Vec { + let shades = tokens::TILE_SHADES.map(|by| shade(page, by)); + let mut rng = Rng(0x9e37_79b9); + let mut out: Vec = (0..n * n) + .map(|_| { + let v = rng.next(); + shades[if v < 0.5 { + 0 + } else if v < 0.78 { + 1 + } else if v < 0.93 { + 2 + } else { + 3 + }] + }) + .collect(); + for _ in 0..n * n / 50 { + let (x, y) = ( + (rng.next() * n as f32) as usize, + (rng.next() * n as f32) as usize, + ); + let len = 1 + (rng.next() * 3.) as usize; + for i in 0..len { + out[y * n + (x + i) % n] = shades[4]; + out[((y + 1) % n) * n + (x + i + 1) % n] = shades[4]; + } + } + out +} + +/// A landscape's colours: the sky from the top down, the sun's bands, then the hills from far +/// to near, the near hill's top edge, and the trees. +pub struct Palette { + sky: &'static [u32], + sun: [u32; 3], + far: u32, + mid: u32, + near: u32, + top: u32, + trees: u32, +} + +/// The sunset of Horizon's first icon: night blue to violet to coral, and a sun in three bands. +pub const SUNSET: Palette = Palette { + sky: &[ + 0x0a0f2c, 0x26206a, 0x4b2a7e, 0x7c3a88, 0xc4527a, 0xee6e5a, 0xffb25e, + ], + sun: [0xfff6cf, 0xffd272, 0xff9a44], + far: 0x4a2f7e, + mid: 0x2b1f5e, + near: 0x151a45, + top: 0x3d2f80, + trees: 0x0e1236, +}; + +/// The light appearance's morning: lavender to peach, soft violet hills. +pub const DAWN: Palette = Palette { + sky: &[ + 0x8d7fd8, 0xa596e2, 0xbcaeea, 0xd2c4f0, 0xe7d2ee, 0xf6dce4, 0xffe6d6, + ], + sun: [0xffffff, 0xfff1d0, 0xffd9a8], + far: 0xa898dc, + mid: 0x8676c8, + near: 0x6a5ab4, + top: 0x9a8ae0, + trees: 0x4c3e94, +}; + +/// A blocky landscape, `w` by `h` texels: banded sky, a sun half set behind the far hills and cut +/// into slices like Horizon's mark, flat clouds, three ridges of hills and a few square trees. +pub fn scene(p: &Palette, seed: u32, w: usize, h: usize) -> Vec { + let mut rng = Rng(seed.wrapping_mul(0x2545_f491) | 1); + let mut out = vec![0; w * h]; + let horizon = h * 62 / 100; + let band = horizon as f32 / p.sky.len() as f32; + for y in 0..h { + let f = y as f32 / band; + let i = (f as usize).min(p.sky.len() - 1); + let dither = f - i as f32 > 0.88 && i + 1 < p.sky.len(); + for x in 0..w { + out[y * w + x] = if dither && (x + y) % 2 == 1 { + p.sky[i + 1] + } else { + p.sky[i] + }; + } + } + let rect = |out: &mut Vec, x: isize, y: isize, rw: usize, rh: usize, c: u32| { + for yy in y.max(0) as usize..((y + rh as isize).max(0) as usize).min(h) { + for xx in x.max(0) as usize..((x + rw as isize).max(0) as usize).min(w) { + out[yy * w + xx] = c; + } + } + }; + for _ in 0..4 { + let cx = (rng.next() * w as f32) as isize; + let cy = (horizon as f32 * (0.12 + rng.next() * 0.4)) as isize; + let cw = 10 + (rng.next() * 14.) as usize; + let under = p.sky[((cy as f32 / band) as usize + 1).min(p.sky.len() - 1)]; + let c = mix(under, 0xffffff, 0.12); + rect(&mut out, cx, cy, cw, 2, c); + rect(&mut out, cx + 3, cy - 2, cw.saturating_sub(6), 2, c); + } + let r = (h as f32 * 0.2) as isize; + let (cx, cy) = ( + (w as f32 * 0.68) as isize, + horizon as isize - (h as f32 * 0.11) as isize, + ); + for dy in -r..=0 { + let half = ((r * r - dy * dy) as f32).sqrt().round() as isize; + let t = (dy + r) as f32 / r as f32; + let c = p.sun[if t < 0.4 { + 0 + } else if t < 0.75 { + 1 + } else { + 2 + }]; + if (cy + dy) % 5 != 0 || (dy as f32) < -r as f32 * 0.6 { + rect(&mut out, cx - half, cy + dy, (half * 2) as usize, 1, c); + } + } + let ridge = |rng: &mut Rng, base: f32, amp: f32, rough: f32| -> Vec { + let (mut y, mut v) = (base, 0.); + (0..w) + .map(|x| { + if x % 2 == 0 { + v = (v + (rng.next() - 0.5) * rough) * 0.86; + y += v + (base - y) * 0.06; + } + y.clamp(base - amp, base + amp).round().max(0.) as usize + }) + .collect() + }; + let hf = h as f32; + let layers = [ + (p.far, horizon as f32 - hf * 0.1, hf * 0.12, 3.2, None), + (p.mid, horizon as f32 + hf * 0.02, hf * 0.09, 2.6, None), + ( + p.near, + horizon as f32 + hf * 0.18, + hf * 0.07, + 2.2, + Some(p.top), + ), + ]; + let mut near = Vec::new(); + for (c, base, amp, rough, top) in layers { + let hs = ridge(&mut rng, base, amp, rough); + for (x, &y) in hs.iter().enumerate() { + for yy in y.min(h)..h { + out[yy * w + x] = c; + } + if let (Some(top), true) = (top, y < h) { + out[y * w + x] = top; + } + } + near = hs; + } + for _ in 0..w / 26 { + let tx = 4 + (rng.next() * (w - 10) as f32) as isize; + let ty = near[tx as usize] as isize; + rect(&mut out, tx - 2, ty - 8, 5, 5, p.trees); + rect(&mut out, tx - 1, ty - 10, 3, 2, p.trees); + rect(&mut out, tx, ty - 3, 1, 3, p.trees); + } + out +} + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn art_is_the_same_on_every_start() { + assert_eq!(scene(&SUNSET, 3, 40, 20), scene(&SUNSET, 3, 40, 20)); + assert_eq!(stone(0x0f0d17, 16), stone(0x0f0d17, 16)); + } + + #[test] + fn the_stone_stays_within_its_shades() { + let shades = tokens::TILE_SHADES.map(|by| shade(0x0f0d17, by)); + assert!(stone(0x0f0d17, 64).iter().all(|c| shades.contains(c))); + } + + #[test] + fn texels_cover_whole_device_pixels() { + let image = bake(&opaque(&[0x112233; 4]), 2, 2, 4., 2.); + let size = image.size(0); + assert_eq!((size.width.0, size.height.0), (16, 16)); + } +} diff --git a/launcher/src/backend.rs b/launcher/src/backend.rs index 8cbc6be2f..28634ba2c 100644 --- a/launcher/src/backend.rs +++ b/launcher/src/backend.rs @@ -2195,6 +2195,17 @@ pub fn spawn(job: Job, mut cmd: Command, tx: Sender) -> Result, @@ -2219,6 +2230,9 @@ pub struct Settings { /// builds" switch instead; [`Settings::parse`] reads its `beta_builds: true` as Alpha. #[serde(default)] pub update_channel: UpdateChannel, + /// Dark, Light, or the system's: the launcher's look. Dark by default. + #[serde(default)] + pub appearance: Appearance, /// The player has read what the "I'm playing" ping holds (`telemetry::PING`): on the /// first-run question, or on the Play page once if they answered that before it existed. #[serde(default)] @@ -2247,6 +2261,13 @@ impl Settings { { fields.remove("update_channel"); } + // The same for an appearance from a newer launcher. + if fields + .get("appearance") + .is_some_and(|a| serde_json::from_value::(a.clone()).is_err()) + { + fields.remove("appearance"); + } } serde_json::from_value(value).unwrap_or_default() } @@ -2497,6 +2518,24 @@ mod tests { ); } + #[test] + fn the_appearance_is_dark_unless_picked_and_an_unknown_one_keeps_the_rest() { + assert_eq!(Settings::parse("{}").appearance, Appearance::Dark); + let light = Settings::parse(r#"{"appearance": "light", "game_args": "--x"}"#); + assert_eq!(light.appearance, Appearance::Light); + let future = Settings::parse(r#"{"appearance": "sepia", "game_args": "--x"}"#); + assert_eq!( + (future.appearance, future.game_args.as_str()), + (Appearance::Dark, "--x") + ); + let settings = Settings { + appearance: Appearance::System, + ..Settings::default() + }; + let text = serde_json::to_string(&settings).unwrap(); + assert!(text.contains(r#""appearance":"system""#), "{text}"); + } + #[test] fn the_update_channel_is_stored_by_name_and_the_old_beta_switch_reads_as_alpha() { let read = |text: &str| Settings::parse(text).update_channel; diff --git a/launcher/src/blocks.rs b/launcher/src/blocks.rs new file mode 100644 index 000000000..1f3a36523 --- /dev/null +++ b/launcher/src/blocks.rs @@ -0,0 +1,232 @@ +//! The blocky look's parts (`docs/design-system.md`, "Blocks"): pixel type, pixel icons, panels +//! with a dark outline, a light bevel on top and a darker lip below, sunk wells, badges, the +//! inventory tabs, and the slots that hold icons downloaded at run time. +use crate::theme::{self, Theme}; +use gpui::{ + div, img, prelude::*, px, svg, AnyElement, App, ClickEvent, Div, FontWeight, Hsla, ImageSource, + ObjectFit, SharedString, Stateful, Svg, Window, +}; +use std::borrow::Cow; + +/// The icons, served to `svg()` as `icons/.svg`. +pub struct Assets; + +impl gpui::AssetSource for Assets { + fn load(&self, path: &str) -> gpui::Result>> { + let name = path + .strip_prefix("icons/") + .and_then(|p| p.strip_suffix(".svg")); + Ok(name.and_then(horizon_theme::icons::get).map(Cow::Borrowed)) + } + + fn list(&self, _path: &str) -> gpui::Result> { + Ok(horizon_theme::icons::ALL + .iter() + .map(|(name, _)| format!("icons/{name}.svg").into()) + .collect()) + } +} + +/// A pixel icon (`horizon_theme::icons`) in `color`. +pub fn icon(name: &'static str, size: f32, color: Hsla) -> Svg { + svg() + .path(format!("icons/{name}.svg")) + .flex_none() + .size(px(size)) + .text_color(color) +} + +/// Text in the pixel face: headings, navigation, buttons, badges. +pub fn pixel(size: f32, weight: FontWeight) -> Div { + div() + .font_family(theme::PIXEL) + .font_weight(weight) + .text_size(px(size)) + .line_height(px((size * 1.2).round())) +} + +/// The light edge along the top of a raised block and the darker lip along its bottom; the +/// block must be `relative`. +pub fn edges(top: Hsla, bottom: Hsla, lip: f32) -> [AnyElement; 2] { + [ + div() + .absolute() + .top_0() + .left_0() + .right_0() + .h(px(theme::BEVEL)) + .bg(top) + .into_any_element(), + div() + .absolute() + .bottom_0() + .left_0() + .right_0() + .h(px(lip)) + .bg(bottom) + .into_any_element(), + ] +} + +/// A panel: rows, cards, notices, dialogs. +pub fn panel(t: &Theme) -> Div { + div() + .relative() + .bg(t.panel) + .border_2() + .border_color(t.outline) + .children(edges(t.bevel, t.lip, theme::BEVEL)) +} + +/// A small label in a block of its colour: "Runs", "Partly", a version. +pub fn badge(label: impl Into, color: Hsla, t: &Theme) -> Div { + let tint = if t.dark { 0.14 } else { 0.12 }; + div() + .flex() + .flex_none() + .items_center() + .gap(px(6.)) + .h(px(22.)) + .px(px(8.)) + .bg(color.opacity(tint)) + .border_2() + .border_color(t.outline) + .child(div().size(px(6.)).bg(color)) + .child( + pixel(12., FontWeight::MEDIUM) + .text_color(color) + .child(label.into()), + ) +} + +/// Inventory tabs: a row of tabs on top of a panel, the open one joined to it. +pub fn tabs( + id: &'static str, + options: &[(T, &'static str, &'static str)], + current: T, + t: &Theme, + on_pick: impl Fn(T, &mut Window, &mut App) + Clone + 'static, +) -> Div { + let t = *t; + div() + .flex() + .items_end() + .gap(px(4.)) + .children(options.iter().map(|&(value, label, icon_name)| { + let open = current == value; + let pick = on_pick.clone(); + let tab = div() + .id(SharedString::from(format!("{id}-{label}"))) + .relative() + .flex() + .items_center() + .gap(px(8.)) + .h(px(if open { 42. } else { 38. })) + .px(px(14.)) + .border_2() + .border_b_0() + .border_color(t.outline) + .cursor_pointer() + .bg(if open { t.panel } else { t.side }) + .child( + div() + .absolute() + .top_0() + .left_0() + .right_0() + .h(px(theme::BEVEL)) + .bg(if open { t.bevel } else { t.raised }), + ) + .child(icon(icon_name, 18., if open { t.accent } else { t.muted })) + .child( + pixel(15., FontWeight::MEDIUM) + .text_color(if open { t.ink } else { t.muted }) + .child(label), + ) + .when(!open, |d| d.hover(move |s| s.bg(t.raised))) + // The open tab covers the panel's outline under it. + .when(open, |d| d.mb(px(-2.))) + .on_click(move |_: &ClickEvent, window, cx| pick(value, window, cx)); + crate::keyboard(tab, &t) + })) +} + +/// A square slot for an icon: the picture at `source` when there is one, else the first letter of +/// `name` on a raised block. +pub fn slot(source: Option, name: &str, size: f32, t: &Theme) -> Div { + let frame = div() + .flex() + .flex_none() + .items_center() + .justify_center() + .size(px(size)) + .overflow_hidden() + .border_2() + .border_color(t.outline) + .bg(t.well); + match source { + Some(source) => frame.child(img(source).size(px(size - 4.)).object_fit(ObjectFit::Cover)), + None => frame.bg(t.raised).child( + pixel((size * 0.42).round(), FontWeight::BOLD) + .text_color(t.muted) + .child( + name.chars() + .find(|c| c.is_alphanumeric()) + .unwrap_or('?') + .to_uppercase() + .to_string(), + ), + ), + } +} + +/// Lays the stone texture over an area of `w` by `h` logical pixels. +pub fn stone(image: std::sync::Arc, w: f32, h: f32) -> Div { + let step = crate::art::STONE; + let (cols, rows) = ((w / step).ceil() as usize, (h / step).ceil() as usize); + let mut layer = div() + .absolute() + .top_0() + .left_0() + .size_full() + .overflow_hidden(); + for y in 0..rows { + for x in 0..cols { + layer = layer.child( + img(image.clone()) + .absolute() + .left(px(x as f32 * step)) + .top(px(y as f32 * step)) + .size(px(step)), + ); + } + } + layer +} + +/// A clickable block in the sidebar: an instance or a server. +pub fn side_item(id: SharedString, selected: bool, t: &Theme) -> Stateful
{ + let t = *t; + div() + .id(id) + .relative() + .flex() + .items_center() + .gap(px(10.)) + .p(px(6.)) + .cursor_pointer() + .when(selected, |d| { + d.bg(t.raised) + .children(edges(t.bevel, t.lip, theme::BEVEL)) + .child( + div() + .absolute() + .left(px(-10.)) + .top(px(8.)) + .bottom(px(8.)) + .w(px(4.)) + .bg(t.accent), + ) + }) + .when(!selected, |d| d.hover(move |s| s.bg(t.raised.opacity(0.6)))) +} diff --git a/launcher/src/main.rs b/launcher/src/main.rs index 5456c235a..365c952f4 100644 --- a/launcher/src/main.rs +++ b/launcher/src/main.rs @@ -1,6 +1,8 @@ //! Horizon launcher: installs Horizon builds, prepares them from the player's own Minecraft, //! and starts the client or a dedicated server. +mod art; +mod blocks; mod cli; mod collection; mod game_tools; @@ -37,6 +39,7 @@ use theme::Theme; enum Page { Play, Versions, + /// Mods, resource and shader packs, and modpacks (imported ones and the browser's). Mods, Servers, Notes, @@ -44,13 +47,28 @@ enum Page { } impl Page { - const ALL: [(Page, &'static str); 6] = [ - (Page::Play, "Play"), - (Page::Versions, "Versions"), - (Page::Mods, "Mods"), - (Page::Servers, "Servers"), - (Page::Notes, "Patch notes"), - (Page::Settings, "Settings"), + /// `HORIZON_LAUNCHER_PAGE=mods` (or `modpacks`, `servers`, `versions`, `notes`, `settings`) + /// opens on that page, for screenshots; Home otherwise. + fn from_env() -> Page { + match std::env::var("HORIZON_LAUNCHER_PAGE").as_deref() { + Ok("mods" | "modpacks") => Page::Mods, + Ok("servers") => Page::Servers, + Ok("versions") => Page::Versions, + Ok("notes") => Page::Notes, + Ok("settings") => Page::Settings, + _ => Page::Play, + } + } + + /// Every page, with its name and icon: the top bar shows all but Settings, which has its + /// own button. + const ALL: [(Page, &'static str, &'static str); 6] = [ + (Page::Play, "Home", "home"), + (Page::Mods, "Mods", "package"), + (Page::Servers, "Servers", "server"), + (Page::Versions, "Versions", "archive"), + (Page::Notes, "Patch notes", "notes"), + (Page::Settings, "Settings", "sliders"), ]; } @@ -184,13 +202,21 @@ struct Launcher { starting_pack: Option, /// The Mods page: the browser's search, installs and updates (`mods_page.rs`). mods: mods_page::Mods, + /// The name the game made up for an offline player (`horizon-player.txt`), for the top bar. + offline_name: Option, + /// The player's servers, for the sidebar until the Servers page has read them. + side_servers: Vec, + /// The pixel art made for this window (`art.rs`), and pictures downloaded by URL. + art: art::Art, + /// The window's scale, as of its last frame, for art drawn outside `render`'s reach. + scale: f32, } impl Launcher { fn new(window: &mut Window, cx: &mut Context) -> Self { let (tx, rx) = channel(); let appearance = cx.observe_window_appearance(window, |this, window, cx| { - this.theme = Theme::for_appearance(window.appearance()); + this.theme = Theme::for_appearance(this.settings.appearance, window.appearance()); cx.notify(); }); cx.spawn(async move |this, cx| loop { @@ -226,8 +252,8 @@ impl Launcher { settings.selected = installed.first().cloned(); } let mut this = Self { - theme: Theme::for_appearance(window.appearance()), - page: Page::Play, + theme: Theme::for_appearance(settings.appearance, window.appearance()), + page: Page::from_env(), switches: 0, content_scroll: Scrollbar::default(), opening: (!settings.skip_opening).then(|| { @@ -296,6 +322,10 @@ impl Launcher { pack_error: None, starting_pack: None, mods: mods_page::Mods::new(cx), + offline_name: offline_name(), + side_servers: horizon_launcher::servers::list(), + art: art::Art::default(), + scale: window.scale_factor(), }; if this.bench.is_some() { this.perf.keep_local_log(false); @@ -321,6 +351,8 @@ impl Launcher { } fn go(&mut self, page: Page) { + // The game may have made up a name since: read it again (a small file, once a switch). + self.offline_name = offline_name(); if page != self.page { self.page = page; self.switches += 1; @@ -410,6 +442,10 @@ impl Launcher { self.go(Page::ALL[page % Page::ALL.len()].0); changed = true; } + Some(perf::Step::Scroll) => { + self.go(Page::Versions); + changed = true; + } Some(perf::Step::Quit) => cx.quit(), Some(perf::Step::Wait) | None => {} } @@ -865,11 +901,13 @@ fn hover_layer(id: &SharedString, color: Hsla, radius: f32, bleed: f32) -> AnyEl layer.into_any_element() } -/// Text set in one step of the type scale. +/// Text set in one step of the type scale: headings (heading, title, display) in the pixel face. fn text(step: theme::Step) -> Div { let d = div().text_size(px(step.px)).line_height(px(step.line_px())); let d = if step.mono { d.font_family(theme::MONO) + } else if step.px >= theme::HEADING.px { + d.font_family(theme::PIXEL) } else { d }; @@ -880,13 +918,14 @@ fn text(step: theme::Step) -> Div { } } -/// A list index: `01`, `02`… in mono, in the column on the left of an index row. -fn index(n: usize, t: &Theme) -> Div { - text(theme::MICRO) - .w(px(theme::INDEX)) - .flex_none() - .text_color(t.muted) - .child(format!("{n:02}")) +/// A release's tag as a title: mono, so its digits read at a glance. +fn version_tag(tag: &str) -> Div { + div() + .font_family(theme::MONO) + .text_size(px(22.)) + .line_height(px(28.)) + .font_weight(FontWeight::MEDIUM) + .child(tag.trim_start_matches('v').to_string()) } /// Horizon's mark: two stems, their reflection below, and the horizon across in the accent. @@ -945,6 +984,9 @@ fn keyboard(el: Stateful
, t: &Theme) -> Stateful
{ }) } +/// A button: a block with a light bevel on top and a darker lip below, its label in the pixel +/// face. Primary (the one main action) is the violet face; Secondary a raised block; Ghost only +/// its label until the pointer is over it. fn button( id: impl Into, label: impl Into, @@ -954,9 +996,9 @@ fn button( let id: SharedString = id.into(); let t = *t; let hover = match kind { - Kind::Primary => t.on_accent.opacity(0.12), - Kind::Secondary => t.plate, - Kind::Ghost => t.plate_soft, + Kind::Primary => t.on_face.opacity(0.10), + Kind::Secondary => t.bevel.opacity(if t.dark { 0.10 } else { 0.35 }), + Kind::Ghost => t.raised, }; let base = div() .id(id.clone()) @@ -966,56 +1008,91 @@ fn button( .items_center() .justify_center() .h(px(theme::CONTROL)) - .px(px(16.)) - .rounded(px(theme::RADIUS_PILL)) - .text_size(px(theme::LABEL.px)) + .px(px(14.)) + .font_family(theme::PIXEL) + .text_size(px(15.)) .font_weight(FontWeight::MEDIUM) .cursor_pointer() - .child(hover_layer(&id, hover, theme::RADIUS_PILL, 0.)) - .child(div().relative().child(label.into())); - let base = keyboard(track_hover(base, id), &t); - match kind { + .child(hover_layer(&id, hover, 0., 0.)); + let base = match kind { Kind::Primary => base - .bg(t.accent) - .text_color(t.on_accent) - .active(|s| s.opacity(theme::PRESSED)), + .border_2() + .border_color(t.outline) + .children(blocks::edges(t.face_bevel, t.face_lip, theme::LIP)) + .bg(t.face) + .text_color(t.on_face), Kind::Secondary => base - .bg(t.plate_soft) - .text_color(t.ink) - .active(|s| s.opacity(theme::PRESSED)), - Kind::Ghost => base - .text_color(t.muted) - .hover(move |s| s.text_color(t.ink)) - .active(|s| s.opacity(theme::PRESSED)), - } + .border_2() + .border_color(t.outline) + .children(blocks::edges(t.button_bevel, t.lip, theme::LIP)) + .bg(t.button) + .text_color(t.ink), + Kind::Ghost => base.text_color(t.muted).hover(move |s| s.text_color(t.ink)), + }; + // The label sits on the block's face, above its lip; pressing pushes it down. + let base = base.child( + div() + .relative() + .flex() + .items_center() + .gap(px(8.)) + .pb(px(if kind == Kind::Ghost { 0. } else { 2. })) + .child(label.into()), + ); + keyboard(track_hover(base, id), &t).active(|s| s.opacity(theme::PRESSED).top(px(1.))) } -/// An on/off switch whose knob slides. +/// An on/off switch: a square knob sliding in a sunk track that turns violet when on. fn switch(id: &'static str, on: bool, t: &Theme) -> Stateful
{ - keyboard(div().id(id), t) + let t = *t; + let knob = if on { t.on_face } else { t.muted }; + keyboard(div().id(id), &t) .relative() .flex_none() - .w(px(36.)) - .h(px(20.)) - .rounded_full() + .w(px(44.)) + .h(px(24.)) + .border_2() + .border_color(t.outline) .cursor_pointer() - .bg(if on { t.accent } else { t.plate }) + .bg(if on { t.face } else { t.well }) .child( div() .absolute() .top(px(2.)) .size(px(16.)) - .rounded_full() - .bg(gpui::white()) + .bg(knob) + .child( + div() + .absolute() + .bottom_0() + .left_0() + .right_0() + .h(px(2.)) + .bg(if on { t.face_lip } else { t.lip }), + ) .with_animation( ElementId::named_usize(id, on as usize), Animation::new(theme::MOVE).with_easing(ease_out_quint()), - move |d, p| d.left(px(if on { 2. + 16. * p } else { 18. - 16. * p })), + move |d, p| d.left(px(if on { 2. + 20. * p } else { 22. - 20. * p })), ), ) } -/// A segmented control: a soft pill track, the chosen segment an ink pill. +/// A section's title inside a page: a pixel icon in the accent and the name in the pixel face. +fn section_title(label: &'static str, icon: &'static str, t: &Theme) -> Div { + div() + .flex() + .items_center() + .gap(px(10.)) + .child(blocks::icon(icon, 20., t.accent)) + .child( + blocks::pixel(18., FontWeight::SEMIBOLD) + .text_color(t.ink) + .child(label), + ) +} + +/// A segmented control: a sunk track, the chosen segment a raised block. fn segments( id: &'static str, options: &[(T, &'static str)], @@ -1030,25 +1107,34 @@ fn segments( .flex_none() .p(px(2.)) .gap(px(2.)) - .rounded(px(theme::RADIUS_PILL)) - .bg(t.plate_soft) + .border_2() + .border_color(t.outline) + .bg(t.well) .children(options.iter().map(|&(value, label)| { let active = current == value; let pick = on_pick.clone(); keyboard(div().id(SharedString::from(format!("{id}-{label}"))), &t) + .relative() .flex() .items_center() .h(px(theme::SEGMENT)) .px(px(14.)) - .rounded(px(theme::RADIUS_PILL)) - .text_size(px(theme::LABEL.px)) + .pb(px(2.)) + .font_family(theme::PIXEL) + .text_size(px(14.)) .font_weight(FontWeight::MEDIUM) .cursor_pointer() - .when(active, |d| d.bg(t.ink).text_color(t.page)) + .when(active, |d| { + d.bg(t.button).text_color(t.ink).children(blocks::edges( + t.button_bevel, + t.lip, + 3., + )) + }) .when(!active, |d| { d.text_color(t.muted).hover(move |s| s.text_color(t.ink)) }) - .child(label) + .child(div().relative().child(label)) .on_click(move |_: &ClickEvent, window, cx| pick(value, window, cx)) })) } @@ -1057,14 +1143,14 @@ fn disabled(b: Stateful
) -> Stateful
{ b.opacity(theme::DISABLED).cursor_default().tab_stop(false) } -/// A page's title in display type and one line on what it is for. +/// A page's title in the pixel face and one line on what it is for. fn page_header(title: &str, description: &str, t: &Theme) -> Div { div() .flex() .flex_col() - .gap(px(12.)) + .gap(px(10.)) .child( - text(theme::DISPLAY) + blocks::pixel(36., FontWeight::SEMIBOLD) .text_color(t.ink) .child(title.to_string()), ) @@ -1076,24 +1162,36 @@ fn page_header(title: &str, description: &str, t: &Theme) -> Div { ) } -/// One row of an index list: its number, a name with an optional detail under it, then a -/// value or a control on the right, and a rule below. +/// One row of a list, as its own panel: a name in the pixel face with an optional detail under +/// it, then a value or a control on the right. Rows were numbered in the quiet look; `_n` keeps +/// the call sites as they are. fn index_row( - n: usize, + _n: usize, name: impl IntoElement, detail: Option, right: Option, t: &Theme, ) -> Div { - div() + slot_row(None, name, detail, right, t) +} + +/// A row with an icon slot (`blocks::slot`) on its left: a project in the Mods page's lists. +fn slot_row( + slot: Option
, + name: impl IntoElement, + detail: Option, + right: Option, + t: &Theme, +) -> Div { + blocks::panel(t) .flex() .items_center() .gap(px(16.)) .min_h(px(theme::ROW)) + .mb(px(8.)) + .px(px(16.)) .py(px(12.)) - .border_b_1() - .border_color(t.rule) - .child(index(n, t)) + .children(slot) .child( div() .flex() @@ -1101,7 +1199,11 @@ fn index_row( .flex_1() .min_w_0() .gap(px(2.)) - .child(text(theme::UI).text_color(t.ink).child(name)) + .child( + blocks::pixel(16., FontWeight::MEDIUM) + .text_color(t.ink) + .child(name), + ) .children(detail.map(|d| { text(theme::CAPTION) .text_color(t.muted) @@ -1114,7 +1216,7 @@ fn index_row( /// A plate that stands apart from the page: notices, the console, the agents note. fn plate(t: &Theme) -> Div { - div().rounded(px(theme::RADIUS_PLATE)).bg(t.plate_soft) + blocks::panel(t) } /// Something went wrong: a dot in the danger colour, then what happened. @@ -1126,14 +1228,17 @@ fn notice(text_: String, t: &Theme) -> Div { .text_size(px(theme::UI.px)) .line_height(px(21.)) .text_color(t.ink) + .border_l(px(6.)) .child( div() - .flex_none() - .mt(px(7.)) - .size(px(6.)) - .rounded_full() + .absolute() + .top(px(-2.)) + .bottom(px(-2.)) + .left(px(-6.)) + .w(px(6.)) .bg(t.danger), ) + .child(blocks::icon("info-box", 20., t.danger)) .child(div().flex_1().min_w_0().child(text_)) } @@ -1148,6 +1253,14 @@ fn centered(text_: &str, t: &Theme) -> Div { .child(text(theme::UI).text_color(t.muted).child(text_.to_string())) } +/// The name the game made up for a player without an account, once it has run. +fn offline_name() -> Option { + std::fs::read_to_string(backend::game_home().join("horizon-player.txt")) + .ok() + .map(|n| n.trim().to_string()) + .filter(|n| !n.is_empty()) +} + /// `1234` as `1,234`. fn thousands(n: u64) -> String { let digits = n.to_string(); @@ -1181,11 +1294,15 @@ fn megabytes(bytes: u64) -> String { // ----- Pages ------------------------------------------------------------------------------------- impl Launcher { - /// The top bar: the mark and the name on the left, the pages on the right. - fn topbar(&self, cx: &mut Context) -> Div { + /// The top bar: the mark and the name over the sidebar, the pages with their icons, then + /// the account playing and the Settings button. + fn topbar(&mut self, cx: &mut Context) -> Div { let t = self.theme; - let mut nav = div().flex().items_center().gap(px(2.)); - for (page, label) in Page::ALL { + let mut nav = div().flex().h_full().gap(px(2.)); + for (page, label, icon) in Page::ALL { + if page == Page::Settings { + continue; + } let active = self.page == page; let id = SharedString::from(format!("nav-{label}")); let item = div() @@ -1193,98 +1310,401 @@ impl Launcher { .relative() .flex() .items_center() - .h(px(theme::CONTROL)) - .px(px(12.)) - .rounded(px(theme::RADIUS_PILL)) - .text_size(px(theme::LABEL.px)) + .gap(px(8.)) + .px(px(14.)) .cursor_pointer() - .when(active, |d| d.bg(t.plate_soft)) - .when(!active, |d| { - d.child(hover_layer(&id, t.plate_soft, theme::RADIUS_PILL, 0.)) + .when(active, |d| { + d.bg(t.raised).child( + div() + .absolute() + .left(px(8.)) + .right(px(8.)) + .bottom_0() + .h(px(4.)) + .bg(t.accent), + ) }) + .when(!active, |d| d.child(hover_layer(&id, t.raised, 0., 0.))) + .child(div().relative().child(blocks::icon( + icon, + 18., + if active { t.accent } else { t.muted }, + ))) .child( - div() + blocks::pixel(16., FontWeight::MEDIUM) .relative() - .when(active, |d| { - d.text_color(t.ink).font_weight(FontWeight::MEDIUM) - }) - .when(!active, |d| d.text_color(t.muted)) + .text_color(if active { t.ink } else { t.muted }) .child(label), ) .on_click(cx.listener(move |this, _: &ClickEvent, _, cx| { this.go(page); cx.notify(); })); - nav = nav.child(track_hover(item, id)); + nav = nav.child(keyboard(track_hover(item, id), &t)); } - div() + // Only a signed-in account says "Microsoft account"; otherwise the name the game made up. + let (name, how) = match self.accounts.selected() { + Some(a) => (a.name.clone(), "Microsoft account"), + None => ( + self.offline_name.clone().unwrap_or_else(|| "Player".into()), + "Offline", + ), + }; + let account = keyboard(div().id("account"), &t) + .relative() .flex() - .flex_none() .items_center() - .justify_between() - .h(px(72.)) - .px(px(theme::GUTTER)) + .gap(px(10.)) + .h(px(40.)) + .pl(px(4.)) + .pr(px(12.)) + .bg(t.panel) + .border_2() + .border_color(t.outline) + .cursor_pointer() + .hover(move |s| s.bg(t.raised)) .child( div() .flex() .items_center() - .gap(px(10.)) - .child(mark(18., &t)) - .child( - text(theme::LABEL) - .font_weight(FontWeight::MEDIUM) - .text_color(t.ink) - .child("Horizon"), - ), + .justify_center() + .size(px(30.)) + .bg(t.well) + .child(blocks::icon("user", 18., t.muted)), ) - .child(nav) - } - - /// The footer: the launcher's version (or its update), and the community links. - fn footer(&self, cx: &mut Context) -> Div { - let t = self.theme; - let link = |id: &'static str, label: &'static str, url: String| { - caps(label) - .id(id) - .text_color(t.muted) - .cursor_pointer() - .hover(move |s| s.text_color(t.ink)) - .on_click(move |_, _, cx| cx.open_url(&url)) - }; - let version = match &self.self_update { - SelfUpdate::Ready(version) => div() - .flex() - .gap(px(12.)) - .child(caps(format!("Launcher updated to {version}")).text_color(t.muted)) - .child( - caps("Restart") - .id("restart") - .text_color(t.accent) - .cursor_pointer() - .hover(|s| s.opacity(0.8)) - .on_click(cx.listener(|this, _: &ClickEvent, _, cx| { - this.self_update = SelfUpdate::Failed(backend::restart()); - cx.notify(); - })), - ), - _ => caps(format!("Launcher {}", backend::VERSION)).text_color(t.muted), - }; - let mut links = div().flex().gap(px(20.)); - if !self.links.discord.is_empty() { - links = links.child(link("discord", "Discord", self.links.discord.clone())); - } - if !self.links.website.is_empty() { - links = links.child(link("website", "Website", self.links.website.clone())); - } + .child( + div() + .flex() + .flex_col() + .child( + blocks::pixel(14., FontWeight::MEDIUM) + .text_color(t.ink) + .child(name), + ) + .child(text(theme::CAPTION).text_color(t.muted).child(how)), + ) + .on_click(cx.listener(|this, _: &ClickEvent, _, cx| { + this.go(Page::Settings); + cx.notify(); + })); + let settings_open = self.page == Page::Settings; + let settings = keyboard(div().id("nav-Settings"), &t) + .relative() + .flex() + .items_center() + .justify_center() + .size(px(40.)) + .bg(if settings_open { t.raised } else { t.panel }) + .border_2() + .border_color(t.outline) + .cursor_pointer() + .hover(move |s| s.bg(t.raised)) + .when(settings_open, |d| { + d.child( + div() + .absolute() + .left_0() + .right_0() + .bottom_0() + .h(px(4.)) + .bg(t.accent), + ) + }) + .child(blocks::icon( + "sliders", + 20., + if settings_open { t.accent } else { t.ink_soft }, + )) + .on_click(cx.listener(|this, _: &ClickEvent, _, cx| { + this.go(Page::Settings); + cx.notify(); + })); div() .flex() .flex_none() .items_center() - .justify_between() - .h(px(48.)) - .px(px(theme::GUTTER)) - .child(version) - .child(links) + .h(px(theme::TOPBAR)) + .pl(px(18.)) + .pr(px(12.)) + .bg(t.side) + .border_b_2() + .border_color(t.outline) + .child( + div() + .flex() + .flex_none() + .items_center() + .gap(px(10.)) + .w(px(theme::SIDEBAR - 18.)) + .child(mark(24., &t)) + .child( + blocks::pixel(20., FontWeight::SEMIBOLD) + .text_color(t.ink) + .child("HORIZON"), + ), + ) + .child(nav) + .child( + div() + .ml_auto() + .flex() + .items_center() + .gap(px(8.)) + .child(account) + .child(settings), + ) + } + + /// The sidebar: Horizon and the imported modpacks, the player's servers, then the + /// launcher's own update, the community links and its version. + fn sidebar(&mut self, cx: &mut Context) -> Stateful
{ + let t = self.theme; + self.load_packs(); + let heading = |label: &'static str| { + div() + .flex() + .items_center() + .justify_between() + .px(px(6.)) + .pt(px(10.)) + .pb(px(6.)) + .child( + blocks::pixel(13., FontWeight::MEDIUM) + .text_color(t.muted) + .child(label), + ) + }; + let sub = |s: String| text(theme::CAPTION).text_color(t.muted).truncate().child(s); + let title = |s: String| { + blocks::pixel(15., FontWeight::MEDIUM) + .text_color(t.ink) + .truncate() + .child(s) + }; + let dot = |c: Hsla| { + div() + .absolute() + .left(px(42.)) + .top(px(42.)) + .size(px(10.)) + .bg(c) + .border_2() + .border_color(t.side) + }; + let add = keyboard(div().id("add-pack"), &t) + .flex() + .items_center() + .justify_center() + .size(px(24.)) + .bg(t.panel) + .border_2() + .border_color(t.outline) + .cursor_pointer() + .hover(move |s| s.bg(t.raised)) + .child(blocks::icon("plus", 14., t.ink_soft)) + .on_click(cx.listener(|this, _: &ClickEvent, _, cx| { + this.show_modpack(None); + cx.notify(); + })); + let mut list = div() + .flex() + .flex_col() + .gap(px(4.)) + .child(heading("INSTANCES").child(add)); + // Horizon itself, with a grass block from the player's own prepared files. + let tag = self.selected().cloned(); + let prepared = tag.as_deref().is_some_and(backend::is_prepared); + let grass = self.vanilla_icon(); + let on_play = self.page == Page::Play; + list = list.child( + blocks::side_item("side-horizon".into(), on_play, &t) + .child(match grass { + Some(g) => div() + .flex() + .items_center() + .justify_center() + .size(px(44.)) + .child(gpui::img(g).size(px(40.))), + None => blocks::slot(None, "Horizon", 44., &t), + }) + .child(dot(if prepared { t.success } else { t.warn })) + .child( + div() + .flex() + .flex_col() + .min_w_0() + .child(title("Horizon".into())) + .child(sub(if prepared { + "Vanilla · ready" + } else { + "Needs preparing" + } + .into())), + ) + .on_click(cx.listener(|this, _: &ClickEvent, _, cx| { + this.go(Page::Play); + cx.notify(); + })), + ); + let on_packs = self.page == Page::Mods && self.mods.on_modpacks(); + for p in &self.packs { + let slug = p.slug.clone(); + let open = on_packs && self.pack_open.as_ref() == Some(&p.slug); + list = list.child( + blocks::side_item(format!("side-pack-{slug}").into(), open, &t) + .child(blocks::slot(None, p.title(), 44., &t)) + .child( + div() + .flex() + .flex_col() + .min_w_0() + .child(title(p.title().to_string())) + .child(sub(p.summary())), + ) + .on_click(cx.listener(move |this, _: &ClickEvent, _, cx| { + this.show_modpack(Some(slug.clone())); + cx.notify(); + })), + ); + } + let servers: Vec<_> = self + .servers + .sidebar_list() + .map(<[_]>::to_vec) + .unwrap_or_else(|| self.side_servers.clone()); + if !servers.is_empty() { + list = list.child(heading("SERVERS")); + } + for e in servers { + let up = self.servers.is_up(&e.dir); + let open = self.page == Page::Servers && self.servers.open.as_ref() == Some(&e.dir); + let dir = e.dir.clone(); + list = list.child( + blocks::side_item(format!("side-server-{}", e.dir.display()).into(), open, &t) + .child( + div() + .flex() + .items_center() + .justify_center() + .size(px(44.)) + .bg(t.well) + .border_2() + .border_color(t.outline) + .child(blocks::icon("server", 22., t.ink_soft)), + ) + .child(dot(if up { t.success } else { t.muted })) + .child( + div() + .flex() + .flex_col() + .min_w_0() + .child(title(e.name.clone())) + .child(sub(if up { "Running" } else { "Stopped" }.into())), + ) + .on_click(cx.listener(move |this, _: &ClickEvent, _, cx| { + this.servers.open = Some(dir.clone()); + this.go(Page::Servers); + cx.notify(); + })), + ); + } + let link = |id: &'static str, label: &'static str, icon: &'static str, url: String| { + div() + .id(id) + .flex() + .items_center() + .gap(px(10.)) + .px(px(8.)) + .py(px(6.)) + .text_color(t.muted) + .cursor_pointer() + .hover(move |s| s.text_color(t.ink).bg(t.raised.opacity(0.6))) + .child(blocks::icon(icon, 18., t.muted)) + .child(blocks::pixel(14., FontWeight::MEDIUM).child(label)) + .on_click(move |_, _, cx| cx.open_url(&url)) + }; + let mut foot = div().mt_auto().flex().flex_col().gap(px(2.)).pt(px(12.)); + match &self.self_update { + SelfUpdate::Downloading(version, f) => { + foot = foot.child( + blocks::panel(&t) + .flex() + .flex_col() + .gap(px(8.)) + .p(px(10.)) + .mb(px(6.)) + .child( + blocks::pixel(13., FontWeight::MEDIUM) + .text_color(t.ink) + .child(format!("Launcher {version} {:.0}%", f * 100.)), + ) + .child(div().flex().child(progress_bar(Some((*f, *f)), &t))), + ) + } + SelfUpdate::Ready(version) => { + foot = foot.child( + blocks::panel(&t) + .flex() + .flex_col() + .gap(px(8.)) + .p(px(10.)) + .mb(px(6.)) + .child( + blocks::pixel(13., FontWeight::MEDIUM) + .text_color(t.ink) + .child(format!("Launcher updated to {version}")), + ) + .child(button("restart", "Restart", Kind::Primary, &t).on_click( + cx.listener(|this, _: &ClickEvent, _, cx| { + this.self_update = SelfUpdate::Failed(backend::restart()); + cx.notify(); + }), + )), + ) + } + _ => {} + } + if !self.links.discord.is_empty() { + foot = foot.child(link( + "discord", + "Discord", + "message", + self.links.discord.clone(), + )); + } + if !self.links.website.is_empty() { + foot = foot.child(link( + "website", + "Website", + "globe", + self.links.website.clone(), + )); + } + foot = foot.child( + caps(format!( + "Launcher {} · {}", + backend::VERSION, + self.settings.update_channel.label() + )) + .px(px(8.)) + .pt(px(6.)) + .text_color(t.muted), + ); + div() + .id("sidebar") + .flex() + .flex_col() + .flex_none() + .w(px(theme::SIDEBAR)) + .h_full() + .px(px(10.)) + .pb(px(12.)) + .bg(t.side) + .border_r_2() + .border_color(t.outline) + .overflow_y_scroll() + .child(list) + .child(foot) } fn picker(&self, cx: &mut Context) -> Div { @@ -1293,23 +1713,41 @@ impl Launcher { .selected() .cloned() .unwrap_or_else(|| "No version".into()); + // A block as tall as Play: "VERSION" over the tag, and a chevron. let mut wrap = div().relative().child( - div() - .id("picker") + keyboard(div().id("picker"), &t) + .relative() .flex() .items_center() - .gap(px(8.)) - .h(px(theme::CONTROL_LARGE)) - .px(px(16.)) - .rounded(px(theme::RADIUS_PILL)) - .bg(t.plate_soft) - .font_family(theme::MONO) - .text_size(px(theme::CAPTION.px)) - .text_color(t.ink) + .gap(px(16.)) + .h(px(60.)) + .pl(px(14.)) + .pr(px(12.)) + .bg(t.panel) + .border_2() + .border_color(t.outline) + .children(blocks::edges(t.bevel, t.lip, theme::BEVEL)) .cursor_pointer() - .hover(move |s| s.bg(t.plate)) - .child(label) - .child(div().text_color(t.muted).text_size(px(10.)).child("▾")) + .hover(move |s| s.bg(t.raised)) + .child( + div() + .flex() + .flex_col() + .gap(px(4.)) + .child( + blocks::pixel(11., FontWeight::MEDIUM) + .text_color(t.muted) + .child("VERSION"), + ) + .child( + div() + .font_family(theme::MONO) + .text_size(px(15.)) + .text_color(t.ink) + .child(label), + ), + ) + .child(blocks::icon("chevron-down", 20., t.muted)) .on_click(cx.listener(|this, _: &ClickEvent, _, cx| { this.picker_open = !this.picker_open; cx.notify(); @@ -1318,13 +1756,12 @@ impl Launcher { if self.picker_open { let mut menu = div() .absolute() - .top(px(theme::CONTROL_LARGE + 6.)) + .top(px(66.)) .right_0() .w(px(240.)) .p(px(6.)) - .rounded(px(theme::RADIUS_PLATE)) - .border_1() - .border_color(t.rule) + .border_2() + .border_color(t.outline) .bg(t.surface) .flex() .flex_col(); @@ -1410,10 +1847,18 @@ impl Launcher { let running = self.client.is_some() || self.starting_client.is_some(); let play_label = if running { "Running" } else { "Play" }; let mut play = button("play", play_label, Kind::Primary, &t) - .min_w(px(132.)) - .h(px(theme::CONTROL_LARGE)) + .min_w(px(200.)) + .h(px(60.)) .px(px(28.)) - .text_size(px(theme::UI.px)); + .text_size(px(28.)) + .font_weight(FontWeight::SEMIBOLD) + .child( + div() + .absolute() + .left(px(26.)) + .top(px(17.)) + .child(blocks::icon("play", 22., t.on_face)), + ); if !prepared || self.preparing || running { play = disabled(play); } else { @@ -1483,8 +1928,7 @@ impl Launcher { let mut rows = div() .flex() .flex_col() - .border_t_1() - .border_color(t.rule) + .child(section_title("Ready to play", "check", &t).mb(px(12.))) .child(index_row( 1, "Resources", @@ -1504,33 +1948,74 @@ impl Launcher { &t, )); { - let who = match self.accounts.selected() { - Some(a) => format!("{} (Microsoft account)", a.name), - None => "Offline: online servers need a Microsoft account.".to_string(), - }; rows = rows.child(self.join_friend_row(prepared && !running, cx)); - rows = rows.child(index_row( - 4, - "Playing as", - Some(div().child(who).into_any_element()), - Some( - button("accounts", "Accounts…", Kind::Ghost, &t) - .on_click(cx.listener(|this, _: &ClickEvent, _, cx| { - this.go(Page::Settings); - cx.notify(); - })) - .into_any_element(), - ), - &t, - )); + // The top bar shows who plays; a row only when there is something to do about it: + // offline, in a build that can sign in. + if self.accounts.selected().is_none() && account::client_id().is_some() { + rows = rows.child(index_row( + 4, + "Playing offline", + Some( + div() + .child("Online servers need a Microsoft account.") + .into_any_element(), + ), + Some( + button("accounts", "Accounts…", Kind::Ghost, &t) + .on_click(cx.listener(|this, _: &ClickEvent, _, cx| { + this.go(Page::Settings); + cx.notify(); + })) + .into_any_element(), + ), + &t, + )); + } } - let mut page = div() + // The banner: Horizon's landscape (`art.rs`) under a veil of the page colour, the hero and + // the Play row over it. It reaches the content's edges and the top bar. + let scene = self.art.scene(t.dark, self.scale); + let veil = |angle: f32, from: f32, to: f32, at: f32| { + div() + .absolute() + .top_0() + .left_0() + .size_full() + .bg(gpui::linear_gradient( + angle, + gpui::linear_color_stop(t.page.opacity(from), 0.), + gpui::linear_color_stop(t.page.opacity(to), at), + )) + }; + let (w, h) = art::SCENE_SIZE; + let banner = div() + .relative() .flex() .flex_col() - .gap(px(32.)) - .child(hero) - .child(actions); + .justify_end() + .min_h(px(340.)) + .mx(px(-32.)) + .px(px(32.)) + .pb(px(28.)) + .gap(px(24.)) + .overflow_hidden() + .bg(gpui::rgb(art::sky_top(t.dark))) + .border_b_2() + .border_color(t.outline) + .child( + gpui::img(scene) + .absolute() + .bottom_0() + .left_0() + .w(px(w as f32 * art::SCENE_TEXEL)) + .h(px(h as f32 * art::SCENE_TEXEL)), + ) + .child(veil(90., 0.82, 0., 0.62)) + .child(veil(180., 0., 0.75, 1.)) + .child(div().relative().child(hero)) + .child(div().relative().child(actions)); + let mut page = div().flex().flex_col().gap(px(28.)).child(banner); // The preparation's progress and error right under the buttons, where the player // looks after pressing Prepare, not below the fold (#666). if self.preparing { @@ -1564,19 +2049,7 @@ impl Launcher { if let Some(crash) = self.crash.clone() { page = page.child(self.crash_notice(crash, cx)); } - // The signature: the name, huge and faint, at the foot of the page. - page.child( - div() - .mt(px(32.)) - .ml(px(-14.)) - .h(px(theme::WORDMARK.px * 0.74)) - .overflow_hidden() - .text_size(px(theme::WORDMARK.px)) - .line_height(px(theme::WORDMARK.px)) - .font_weight(FontWeight::MEDIUM) - .text_color(if t.dark { t.plate_soft } else { t.plate }) - .child("horizon"), - ) + page } /// "Horizon crashed": the report and the logs, and where to report it. @@ -1704,43 +2177,61 @@ impl Launcher { }; let title = "Horizon"; // Never squeezed by the rows below: the ping notice can make it tall. - let mut hero = - div() - .flex() - .flex_none() - .flex_col() - .gap(px(14.)) - .pt(px(24.)) - .child( - div() - .flex() - .items_center() - .gap(px(10.)) - .child(caps(format!("Minecraft {version}")).text_color(t.muted)) - .child(div().size(px(4.)).rounded_full().bg(t.rule)) - .child( - caps(if prepared { "Ready" } else { "Needs preparing" }) - .text_color(if prepared { t.success } else { t.muted }), - ) - .children(self.playing.map(|n| { - div() - .flex() - .items_center() - .gap(px(10.)) - .child(div().size(px(4.)).rounded_full().bg(t.rule)) - .child( - caps(format!("{} playing now", thousands(n))) - .text_color(t.muted), - ) - })), - ) - .child(text(theme::DISPLAY).text_color(t.ink).child(title)) - .child(text(theme::BODY).max_w(px(560.)).text_color(t.muted).child( - match summary { - Some(line) => format!("{}. {line}", tag.trim_start_matches('v')), - None => tag.trim_start_matches('v').to_string(), - }, - )); + let mut hero = div() + .flex() + .flex_none() + .flex_col() + .gap(px(12.)) + .child( + div() + .flex() + .child( + div() + .flex() + .flex_none() + .items_center() + .gap(px(10.)) + .px(px(10.)) + .py(px(5.)) + .bg(t.side.opacity(0.85)) + .border_2() + .border_color(t.outline) + .child( + div() + .size(px(8.)) + .bg(if prepared { t.success } else { t.warn }), + ) + .child(caps(format!("Minecraft {version}")).text_color(t.ink_soft)) + .child(div().size(px(4.)).bg(t.muted)) + .child( + caps(if prepared { "Ready" } else { "Needs preparing" }) + .text_color(if prepared { t.success } else { t.warn }), + ), + ) + .children(self.playing.map(|n| { + div() + .flex() + .items_center() + .gap(px(10.)) + .child(div().size(px(4.)).rounded_full().bg(t.rule)) + .child( + caps(format!("{} playing now", thousands(n))).text_color(t.muted), + ) + })), + ) + .child( + blocks::pixel(60., FontWeight::BOLD) + .line_height(px(62.)) + .text_color(t.ink) + .child(title), + ) + // The version is in the picker beside Play: here only what it brings. + .children(summary.map(|line| { + text(theme::BODY) + .max_w(px(560.)) + .text_color(t.ink_soft) + .child(line) + })); if let Some(release) = &self.updates.horizon { let installing = self.installing.as_ref().filter(|(t, _)| *t == release.tag); let line = div() @@ -1976,6 +2467,30 @@ impl Launcher { .on_click(|_, _, cx| cx.open_url(backend::README_URL)), ); let (accounts, n) = self.account_rows(cx); + let appearance = segments( + "appearance", + &[ + (backend::Appearance::Dark, "Dark"), + (backend::Appearance::Light, "Light"), + (backend::Appearance::System, "System"), + ], + self.settings.appearance, + &t, + { + let this = cx.entity().downgrade(); + move |choice, window, cx| { + let _ = this.update(cx, |this, cx| { + this.settings.appearance = choice; + this.settings.save(); + this.theme = Theme::for_appearance(choice, window.appearance()); + cx.notify(); + }); + } + }, + ); + let group = |label: &'static str, icon: &'static str| { + section_title(label, icon, &t).mt(px(20.)).mb(px(12.)) + }; div() .flex() .flex_col() @@ -1989,9 +2504,9 @@ impl Launcher { div() .flex() .flex_col() - .border_t_1() - .border_color(t.rule) + .child(group("Account", "user").mt_0()) .child(accounts) + .child(group("Updates", "reload")) .child(index_row( n + 1, "Install new versions automatically", @@ -2017,6 +2532,14 @@ impl Launcher { Some(update_channel.into_any_element()), &t, )) + .child(group("Launcher", "monitor")) + .child(index_row( + n + 3, + "Appearance", + Some(plain("Dark by default. System follows your computer's light or dark.")), + Some(appearance.into_any_element()), + &t, + )) .child(index_row( n + 3, "Show the opening", @@ -2024,6 +2547,7 @@ impl Launcher { Some(opening.into_any_element()), &t, )) + .child(group("Game", "gamepad")) .child(index_row( n + 4, "Game menus", @@ -2034,6 +2558,7 @@ impl Launcher { &t, )) .child(self.game_args_row(n + 5, cx)) + .child(group("About", "info-box")) .child(index_row(n + 6, "Horizon", Some(plain(&horizon)), horizon_action, &t)) .child(index_row( n + 7, @@ -2099,10 +2624,9 @@ impl Launcher { .h(px(30.)) .px(px(12.)) .overflow_hidden() - .rounded(px(6.)) - .border_1() - .border_color(if focused { t.accent } else { t.rule }) - .bg(t.surface) + .border_2() + .border_color(if focused { t.accent } else { t.outline }) + .bg(t.well) .font_family(theme::MONO) .text_size(px(12.)) .cursor_text() @@ -2340,10 +2864,9 @@ impl Launcher { .h(px(30.)) .px(px(12.)) .overflow_hidden() - .rounded(px(6.)) - .border_1() - .border_color(if focused { t.accent } else { t.rule }) - .bg(t.surface) + .border_2() + .border_color(if focused { t.accent } else { t.outline }) + .bg(t.well) .font_family(theme::MONO) .text_size(px(12.)) .cursor_text() @@ -2451,8 +2974,8 @@ impl Launcher { Load::Ready(r) if r.is_empty() => return page.child(centered("No releases yet.", &t)), Load::Ready(r) => r.clone(), }; - let mut list = div().flex().flex_col().border_t_1().border_color(t.rule); - for (i, release) in releases.into_iter().enumerate() { + let mut list = div().flex().flex_col(); + for release in releases.into_iter() { let tag = release.tag.clone(); let installed = self.installed.contains(&tag); let selected = self.selected() == Some(&tag); @@ -2563,22 +3086,20 @@ impl Launcher { .flex() .flex_col() .gap(px(10.)) - .py(px(16.)) - .border_b_1() - .border_color(t.rule) - .child(hover_layer( - &id, - t.plate_soft, - theme::RADIUS_PLATE, - theme::PLATE_BLEED, - )) + .py(px(14.)) + .px(px(16.)) + .mb(px(8.)) + .bg(t.panel) + .border_2() + .border_color(t.outline) + .children(blocks::edges(t.bevel, t.lip, theme::BEVEL)) + .child(hover_layer(&id, t.raised, 0., 0.)) .child( div() .relative() .flex() .items_center() .gap(px(16.)) - .child(index(i + 1, &t)) .child( div() .flex() @@ -2586,11 +3107,7 @@ impl Launcher { .flex_1() .min_w_0() .gap(px(4.)) - .child( - text(theme::TITLE) - .text_color(t.ink) - .child(tag.trim_start_matches('v').to_string()), - ) + .child(version_tag(&tag).text_color(t.ink)) .child( text(theme::UI) .text_color(t.muted) @@ -2681,8 +3198,8 @@ impl Launcher { } Load::Ready(r) => r.clone(), }; - let mut list = div().flex().flex_col().border_t_1().border_color(t.rule); - for (i, release) in releases.iter().enumerate() { + let mut list = div().flex().flex_col(); + for release in releases.iter() { let summary = release .name .split_once(": ") @@ -2692,16 +3209,19 @@ impl Launcher { div() .flex() .flex_col() - .gap(px(20.)) - .py(px(28.)) - .border_b_1() - .border_color(t.rule) + .relative() + .gap(px(16.)) + .p(px(20.)) + .mb(px(10.)) + .bg(t.panel) + .border_2() + .border_color(t.outline) + .children(blocks::edges(t.bevel, t.lip, theme::BEVEL)) .child( div() .flex() .items_center() .gap(px(16.)) - .child(index(i + 1, &t)) .child( div() .flex() @@ -2709,11 +3229,7 @@ impl Launcher { .flex_1() .min_w_0() .gap(px(4.)) - .child( - text(theme::TITLE) - .text_color(t.ink) - .child(release.tag.trim_start_matches('v').to_string()), - ) + .child(version_tag(&release.tag).text_color(t.ink)) .when(!summary.is_empty(), |d| { d.child(text(theme::UI).text_color(t.muted).child(summary)) }), @@ -2722,8 +3238,7 @@ impl Launcher { ) .child( div() - .pl(px(theme::INDEX + 16.)) - .max_w(px(theme::INDEX + 16. + 640.)) + .max_w(px(640.)) .child(if release.body.trim().is_empty() { text(theme::UI) .text_color(t.muted) @@ -2740,19 +3255,22 @@ impl Launcher { } /// A thin bar. A known fraction eases from its previous value; an unknown one shuttles slowly. +/// Progress: a sunk track filling with the accent; work of unknown length shuttles a block. fn progress_bar(fraction: Option<(f32, f32)>, t: &Theme) -> Div { let bar = div() .absolute() .top_0() - .h(px(2.)) - .rounded_full() - .bg(t.accent); + .bottom_0() + .bg(t.accent) + .border_b_2() + .border_color(t.face_lip); let track = div() .relative() .flex_1() - .h(px(2.)) - .rounded_full() - .bg(t.rule) + .h(px(12.)) + .border_2() + .border_color(t.outline) + .bg(t.well) .overflow_hidden(); match fraction { Some((from, to)) => { @@ -2778,7 +3296,11 @@ fn progress_bar(fraction: Option<(f32, f32)>, t: &Theme) -> Div { impl Render for Launcher { fn render(&mut self, window: &mut Window, cx: &mut Context) -> impl IntoElement { let t = self.theme; + self.scale = window.scale_factor(); self.perf.frame(); + if self.bench.as_ref().is_some_and(perf::Bench::scrolling) { + self.bench_scroll(window); + } self.servers.note_focus(window); self.friend_focused = self.friend_focus.is_focused(window); self.mods.note_focus(window); @@ -2809,6 +3331,10 @@ impl Render for Launcher { if self.opening.is_none() && window.focused(cx).is_none() { window.focus(&self.root_focus); } + let size = window.viewport_size(); + let stone = self.art.stone(t.page_rgb, t.dark, window.scale_factor()); + let topbar = self.topbar(cx); + let sidebar = self.sidebar(cx); let mut root = div() .id("root") .track_focus(&self.root_focus) @@ -2838,6 +3364,7 @@ impl Render for Launcher { .font_family(theme::FONT) .text_color(t.ink) .overflow_hidden() + .child(blocks::stone(stone, size.width.into(), size.height.into())) .child( div() .relative() @@ -2846,29 +3373,35 @@ impl Render for Launcher { .size_full() .opacity(ui) .top(px(theme::RISE * (1. - ui))) - .child(self.topbar(cx)) + .child(topbar) .child( - self.content_scroll - .wrap( - div() - .id("content") - .relative() - .flex_1() - .min_h_0() - .overflow_y_scroll() - .child( - div() - .flex() - .px(px(theme::GUTTER)) - .pt(px(24.)) - .pb(px(48.)) - .child(content), - ), - &t, - ) - .flex_1(), - ) - .child(self.footer(cx)), + div().flex().flex_1().min_h_0().child(sidebar).child( + self.content_scroll + .wrap( + div() + .id("content") + .relative() + .flex_1() + .min_h_0() + .overflow_y_scroll() + .child( + div() + .flex() + .px(px(32.)) + .pt(px(if self.page == Page::Play { + 0. + } else { + 28. + })) + .pb(px(48.)) + .child(content), + ), + &t, + ) + .flex_1() + .min_w_0(), + ), + ), ); if self.page == Page::Servers { if let Some(dialog) = self.create_dialog(cx) { @@ -2884,11 +3417,12 @@ impl Render for Launcher { let gone = 1. - ease_out_cubic(reveal / 0.6); let word = div() .flex() - .text_size(px(theme::WORDMARK.px * 0.6)) - .line_height(px(theme::WORDMARK.px * 0.6)) - .font_weight(FontWeight::MEDIUM) + .font_family(theme::PIXEL) + .text_size(px(theme::WORDMARK.px * 0.5)) + .line_height(px(theme::WORDMARK.px * 0.5)) + .font_weight(FontWeight::BOLD) .text_color(t.ink) - .children("horizon".chars().enumerate().map(|(i, c)| { + .children("HORIZON".chars().enumerate().map(|(i, c)| { let at = held - i as f32 * theme::STAGGER.as_secs_f32() * 1.5; let p = ease_out_cubic(at / theme::ENTER.as_secs_f32()); div() @@ -2958,6 +3492,19 @@ impl Launcher { (reveal, held.as_secs_f32()) } + /// `horizon-launcher benchmark`: scroll the page a little on every frame, back to the top at + /// the bottom, so the frame times measure scrolling. + fn bench_scroll(&mut self, window: &mut Window) { + let handle = &self.content_scroll.handle; + let mut offset = handle.offset(); + offset.y -= px(24.); + if -offset.y > handle.max_offset().height { + offset.y = px(0.); + } + handle.set_offset(offset); + window.request_animation_frame(); + } + fn skip_opening(&mut self) { if let Some(opening) = &mut self.opening { opening.reveal.get_or_insert_with(Instant::now); @@ -2971,38 +3518,43 @@ fn main() { if let Some(code) = cli::run() { std::process::exit(code); } - Application::new().run(|cx: &mut App| { - cx.text_system() - .add_fonts(vec![ - Cow::Borrowed(horizon_theme::fonts::GEIST_REGULAR), - Cow::Borrowed(horizon_theme::fonts::GEIST_MEDIUM), - Cow::Borrowed(horizon_theme::fonts::GEIST_SEMIBOLD), - Cow::Borrowed(horizon_theme::fonts::GEIST_MONO), - ]) - .expect("bundled fonts"); - let bounds = Bounds::centered(None, size(px(1040.), px(700.)), cx); - cx.open_window( - WindowOptions { - window_bounds: Some(WindowBounds::Windowed(bounds)), - window_min_size: Some(size(px(820.), px(560.))), - titlebar: Some(TitlebarOptions { - title: Some("Horizon".into()), + Application::new() + .with_assets(blocks::Assets) + .run(|cx: &mut App| { + cx.text_system() + .add_fonts(vec![ + Cow::Borrowed(horizon_theme::fonts::GEIST_REGULAR), + Cow::Borrowed(horizon_theme::fonts::GEIST_MEDIUM), + Cow::Borrowed(horizon_theme::fonts::GEIST_SEMIBOLD), + Cow::Borrowed(horizon_theme::fonts::GEIST_MONO), + Cow::Borrowed(horizon_theme::fonts::PIXEL_MEDIUM), + Cow::Borrowed(horizon_theme::fonts::PIXEL_SEMIBOLD), + Cow::Borrowed(horizon_theme::fonts::PIXEL_BOLD), + ]) + .expect("bundled fonts"); + let bounds = Bounds::centered(None, size(px(1180.), px(760.)), cx); + cx.open_window( + WindowOptions { + window_bounds: Some(WindowBounds::Windowed(bounds)), + window_min_size: Some(size(px(960.), px(600.))), + titlebar: Some(TitlebarOptions { + title: Some("Horizon".into()), + ..Default::default() + }), + app_id: Some("horizon-launcher".into()), ..Default::default() - }), - app_id: Some("horizon-launcher".into()), - ..Default::default() - }, - |window, cx| cx.new(|cx| Launcher::new(window, cx)), - ) - .expect("window"); - cx.on_window_closed(|cx| { - servers_page::stop_on_quit(); - telemetry::send_before_exit(); - cx.quit() - }) - .detach(); - cx.activate(true); - }); + }, + |window, cx| cx.new(|cx| Launcher::new(window, cx)), + ) + .expect("window"); + cx.on_window_closed(|cx| { + servers_page::stop_on_quit(); + telemetry::send_before_exit(); + cx.quit() + }) + .detach(); + cx.activate(true); + }); } #[cfg(test)] diff --git a/launcher/src/modpacks_page.rs b/launcher/src/modpacks_page.rs index f3e2f1d7b..ccd0b3a4e 100644 --- a/launcher/src/modpacks_page.rs +++ b/launcher/src/modpacks_page.rs @@ -124,9 +124,8 @@ impl Launcher { self.start_client(tag); } - /// The imported packs, above the Modpacks tab's search. - pub(super) fn imported_packs(&mut self, cx: &mut Context) -> Div { - let t = self.theme; + /// Reads the imported packs, once (the sidebar and the Modpacks tab both show them). + pub(super) fn load_packs(&mut self) { if self.packs_loaded.is_none() { self.packs = modpacks::list(); if self.pack_open.is_none() { @@ -134,6 +133,12 @@ impl Launcher { } self.packs_loaded = Some(Instant::now()); } + } + + /// The imported packs, above the Modpacks tab's search. + pub(super) fn imported_packs(&mut self, cx: &mut Context) -> Div { + let t = self.theme; + self.load_packs(); let busy = self.pack_busy; let pick = |id: &'static str, label: &'static str, folder: bool| { let b = button(id, label, Kind::Secondary, &t); @@ -153,12 +158,17 @@ impl Launcher { .gap(px(8.)) .child(pick("import-file", "Import a pack file…", false)) .child(pick("import-folder", "Import an instance folder…", true)) - .child(text(theme::CAPTION).text_color(t.muted).child( + .child(text(theme::CAPTION).w_full().text_color(t.muted).child( ".mrpack (Modrinth), .zip (CurseForge), or a Prism, MultiMC or CurseForge instance. \ Horizon ports what it can on this computer, from your own downloads, and plays \ the pack as its own profile. Nothing is uploaded or shared.", )); - let mut page = div().flex().flex_col().gap(px(32.)).child(actions); + let mut page = div() + .flex() + .flex_col() + .gap(px(16.)) + .child(section_title("Your modpacks", "archive", &t)) + .child(actions); if busy || !self.pack_log.is_empty() { page = page.child(self.pack_log_plate(&t)); } @@ -173,7 +183,7 @@ impl Launcher { ); } if self.packs.len() > 1 { - let mut list = div().flex().flex_col().border_t_1().border_color(t.rule); + let mut list = div().flex().flex_col(); for (i, p) in self.packs.iter().enumerate() { let open = self.pack_open.as_ref() == Some(&p.slug); let slug = p.slug.clone(); @@ -348,7 +358,7 @@ impl Launcher { }); } }); - let mut list = div().flex().flex_col().border_t_1().border_color(t.rule); + let mut list = div().flex().flex_col(); for (i, r) in rows.iter().enumerate() { let color = match r.status { Status::Ported => t.success, diff --git a/launcher/src/mods_page.rs b/launcher/src/mods_page.rs index 214048519..f2dde2447 100644 --- a/launcher/src/mods_page.rs +++ b/launcher/src/mods_page.rs @@ -11,11 +11,12 @@ use horizon_launcher::modpacks; use horizon_port_pack::check::Check; use std::collections::HashMap; -const KINDS: [(PackKind, &str); 4] = [ - (PackKind::Mod, "Mods"), - (PackKind::Modpack, "Modpacks"), - (PackKind::ResourcePack, "Resource packs"), - (PackKind::ShaderPack, "Shader packs"), +/// The kinds, as the Mods page's tabs: name and icon. +const KINDS: [(PackKind, &str, &str); 4] = [ + (PackKind::Mod, "Mods", "box"), + (PackKind::Modpack, "Modpacks", "archive"), + (PackKind::ResourcePack, "Resource packs", "image"), + (PackKind::ShaderPack, "Shader packs", "zap"), ]; /// Java mods checked at once. const CHECKING: usize = 2; @@ -72,10 +73,19 @@ pub(super) struct Mods { } impl Mods { + /// Whether the Modpacks tab is open (the sidebar marks the pack shown there). + pub(super) fn on_modpacks(&self) -> bool { + self.kind == PackKind::Modpack + } + pub(super) fn new(cx: &mut App) -> Self { let (tx, rx) = channel(); Self { - kind: PackKind::Mod, + kind: if std::env::var("HORIZON_LAUNCHER_PAGE").as_deref() == Ok("modpacks") { + PackKind::Modpack + } else { + PackKind::Mod + }, source: SourceId::Modrinth, text: String::new(), focus: cx.focus_handle().tab_index(0).tab_stop(true), @@ -143,6 +153,23 @@ fn short_sum(checksum: &str) -> String { } impl Launcher { + /// Opens the Mods page on its Modpacks tab, with the pack `slug` open when given (the + /// sidebar's packs and its + button). + pub(super) fn show_modpack(&mut self, slug: Option) { + self.go(Page::Mods); + if slug.is_some() { + self.pack_open = slug; + } + if self.mods.kind != PackKind::Modpack { + self.mods.kind = PackKind::Modpack; + self.mods.browse.filters = Default::default(); + self.mods.browse.open = None; + if self.mods.loaded { + self.mods_search(0); + } + } + } + /// Called with the launcher's other work: what the background sent. pub(super) fn mods_tick(&mut self) -> bool { let mut changed = false; @@ -374,16 +401,17 @@ impl Launcher { .track_focus(&m.focus) .flex() .items_center() + .gap(px(10.)) .w(px(320.)) - .h(px(theme::FIELD)) + .h(px(theme::FIELD + 4.)) .px(px(12.)) .overflow_hidden() - .rounded(px(theme::RADIUS)) - .border_1() - .border_color(if focused { t.accent } else { t.rule }) - .bg(t.surface) + .border_2() + .border_color(if focused { t.accent } else { t.outline }) + .bg(t.well) .text_size(px(theme::UI.px)) .cursor_text() + .child(blocks::icon("search", 18., t.muted)) .child(if m.text.is_empty() && !focused { div().text_color(t.muted).child("Search, then Enter") } else { @@ -442,7 +470,7 @@ impl Launcher { &t, ); let this = cx.entity().downgrade(); - let kinds = segments("mods-kind", &KINDS, self.mods.kind, &t, { + let kinds = blocks::tabs("mods-kind", &KINDS, self.mods.kind, &t, { let this = this.clone(); move |kind, _, cx| { let _ = this.update(cx, |this, cx| { @@ -477,29 +505,7 @@ impl Launcher { })); // CurseForge support is coming soon: shown, inert, never searched (like the Microsoft // account's "Coming soon"). - let source_note = div() - .flex() - .flex_wrap() - .items_center() - .gap(px(8.)) - .child(segments("mods-source", &SOURCES, self.mods.source, &t, { - let this = this.clone(); - move |source, _, cx| { - let _ = this.update(cx, |this, cx| { - if this.mods.source != source { - this.mods.source = source; - this.mods_search(0); - } - cx.notify(); - }); - } - })) - .child(disabled(button( - "mods-source-curseforge", - "CurseForge (coming soon)", - Kind::Ghost, - &t, - ))); + let source_note = div().flex().child(source_switch(&t)); let controls = div() .flex() .flex_col() @@ -510,35 +516,36 @@ impl Launcher { .flex_wrap() .items_center() .gap(px(12.)) - .child(kinds) .child(self.mods_field(cx)) .child(toggle), ) .child(source_note) .child(self.mods_filters(cx)); - if let Some(project) = self.mods_project_page(cx) { - return div() + // The kinds are inventory tabs on the panel that holds the open one. + let body = blocks::panel(&t).flex().flex_col().gap(px(24.)).p(px(20.)); + let page = |body: Div| { + div() .flex() .flex_col() .gap(px(32.)) .child(header) - .children(self.mods_busy_plate()) - .child(project); + .child(div().flex().flex_col().child(kinds).child(body)) + }; + if let Some(project) = self.mods_project_page(cx) { + return page(body.children(self.mods_busy_plate()).child(project)); } - let mut page = div() - .flex() - .flex_col() - .gap(px(32.)) - .child(header) - .child(controls); - page = page.children(self.mods_busy_plate()); + let mut body = body.children(self.mods_busy_plate()); if self.mods.kind == PackKind::Modpack { - page = page.child(self.imported_packs(cx)); + body = body + .child(self.imported_packs(cx)) + .child(div().h(px(2.)).bg(t.rule)) + .child(section_title("Browse modpacks", "search", &t)); } + body = body.child(controls); if let Some(list) = self.mods_installed_list(cx) { - page = page.child(list); + body = body.child(list); } - page.child(self.mods_results(cx)) + page(body.child(self.mods_results(cx))) } /// The install under way and the last install's answer. @@ -589,7 +596,7 @@ impl Launcher { return None; } let busy = self.mods.busy.is_some(); - let mut list = div().flex().flex_col().border_t_1().border_color(t.rule); + let mut list = div().flex().flex_col(); for (i, e) in entries.into_iter().enumerate() { let key = (e.source, e.project.clone()); let mut right = div().flex().items_center().gap(px(8.)); @@ -691,7 +698,7 @@ impl Launcher { fn mods_results(&mut self, cx: &mut Context) -> Div { let t = self.theme; let found = self.mods.results.clone(); - let icons: Vec = found.iter().map(|p| self.mods_icon(p, 40.)).collect(); + let icons: Vec = found.iter().map(|p| self.mods_icon(p, 56.)).collect(); let m = &self.mods; if let Some(e) = &m.error { return div().child(notice(e.clone(), &t)); @@ -708,7 +715,7 @@ impl Launcher { } let busy = m.busy.as_ref().map(|b| b.0.as_str()); let mut icons = icons.into_iter(); - let mut list = div().flex().flex_col().border_t_1().border_color(t.rule); + let mut list = div().flex().flex_col(); for (i, p) in m.results.iter().enumerate() { let support = m.support(p); let checking = p.kind == PackKind::Mod @@ -719,14 +726,14 @@ impl Launcher { && p.support().installable(); let color = match support { Support::Works => t.success, - Support::Partial(_) => t.accent, + Support::Partial(_) => t.warn, Support::No(_) => t.muted, }; - let mut right = div() - .flex() - .items_center() - .gap(px(8.)) - .child(caps(support.label()).flex_none().text_color(color)); + let mut right = div().flex().items_center().gap(px(8.)).child(blocks::badge( + support.label(), + color, + &t, + )); let page_url = p.page.clone(); if !page_url.is_empty() { right = right.child( @@ -826,6 +833,31 @@ impl Launcher { } } +/// The source switch while Modrinth is the only source: Modrinth chosen, CurseForge shown as +/// coming soon and not clickable, like the Microsoft account's "Coming soon". +fn source_switch(t: &Theme) -> Stateful
{ + let soon = div() + .flex() + .items_center() + .h(px(theme::SEGMENT)) + .px(px(14.)) + .pb(px(2.)) + .opacity(theme::DISABLED) + .child( + blocks::pixel(14., FontWeight::MEDIUM) + .text_color(t.muted) + .child("CurseForge (coming soon)"), + ); + segments( + "mods-source", + &SOURCES, + SourceId::Modrinth, + t, + |_, _, _| {}, + ) + .child(soon) +} + #[cfg(test)] mod tests { use super::*; diff --git a/launcher/src/mods_project.rs b/launcher/src/mods_project.rs index ef1d97975..c66cf174a 100644 --- a/launcher/src/mods_project.rs +++ b/launcher/src/mods_project.rs @@ -167,28 +167,7 @@ impl Launcher { .icon .clone() .and_then(|url| self.mods_image(&url, images::ICON)); - let frame = plate(&t) - .flex() - .flex_none() - .items_center() - .justify_center() - .size(px(side)) - .overflow_hidden(); - match path { - Some(path) => frame.child(img(path).size(px(side))).into_any_element(), - None => frame - .text_color(t.muted) - .child( - text(theme::UI).child( - p.title - .chars() - .next() - .map(|c| c.to_uppercase().to_string()) - .unwrap_or_default(), - ), - ) - .into_any_element(), - } + blocks::slot(path.map(gpui::ImageSource::from), &p.title, side, &t).into_any_element() } /// The values the filters can take for the current kind and source, asked for once. @@ -357,7 +336,7 @@ impl Launcher { } /// Vanilla's mark, drawn from the player's prepared game files when there are some. - fn vanilla_icon(&self) -> Option { + pub(super) fn vanilla_icon(&self) -> Option { let tag = self.selected().filter(|tag| backend::is_prepared(tag))?; images::grass_block(&backend::game_home(), &backend::resources(tag)) } @@ -371,7 +350,7 @@ impl Launcher { let support = self.mods.support(&p); let color = match support { Support::Works => t.success, - Support::Partial(_) => t.accent, + Support::Partial(_) => t.warn, Support::No(_) => t.muted, }; let back = button("mods-back", "Back to results", Kind::Ghost, &t).on_click(cx.listener( @@ -573,7 +552,7 @@ impl Launcher { None => centered("Loading…", &t), Some(Err(e)) => notice(e.clone(), &t), Some(Ok(list)) => { - let mut rows = div().flex().flex_col().border_t_1().border_color(t.rule); + let mut rows = div().flex().flex_col(); for (i, v) in list.iter().take(50).enumerate() { let file = v.file(); let mut detail = vec![ diff --git a/launcher/src/perf.rs b/launcher/src/perf.rs index 7d652283f..f46393542 100644 --- a/launcher/src/perf.rs +++ b/launcher/src/perf.rs @@ -154,21 +154,27 @@ pub enum Step { Wait, /// Show this page (an index into `Page::ALL`, wrapping). Go(usize), + /// Show the longest list (Versions) and scroll it on every frame while [`Bench::scrolling`]. + Scroll, Quit, } const SWITCHING: Duration = Duration::from_secs(4); +const SCROLLING: Duration = Duration::from_secs(3); const IDLE: Duration = Duration::from_secs(3); /// The environment variable that makes a launcher window measure itself into the file it names. const BENCH_ENV: &str = "HORIZON_LAUNCHER_BENCH"; /// A launcher window measuring itself: after its first frame it switches pages every tick for -/// a few seconds (each switch animates, so the UI draws continuously), then rests, then writes -/// what it measured for `benchmark` and quits. +/// a few seconds (each switch animates, so the UI draws continuously), scrolls the longest list +/// on every frame for a few more, then rests, then writes what it measured for `benchmark` and +/// quits. pub struct Bench { out: PathBuf, began: Option, page: usize, + /// When scrolling began, and the UI frames drawn by then and by its end. + scroll: Option<(Instant, usize, Option)>, idle_cpu: Option<(Instant, f64)>, } @@ -179,10 +185,16 @@ impl Bench { out: out.into(), began: None, page: 0, + scroll: None, idle_cpu: None, }) } + /// The window scrolls its content on every frame now. + pub fn scrolling(&self) -> bool { + matches!(self.scroll, Some((_, _, None))) + } + pub fn tick(&mut self, perf: &Perf) -> Step { let Some(first) = perf.first_frame else { return Step::Wait; @@ -192,6 +204,20 @@ impl Bench { self.page += 1; return Step::Go(self.page); } + let frames = perf.ui_frame_times().len(); + match &mut self.scroll { + None => { + self.scroll = Some((Instant::now(), frames, None)); + return Step::Scroll; + } + Some((at, _, end @ None)) => { + if at.elapsed() < SCROLLING { + return Step::Wait; + } + *end = Some(frames); + } + Some(_) => {} + } let pid = std::process::id(); let Some((rested, cpu)) = self.idle_cpu else { self.idle_cpu = Some(( @@ -212,9 +238,15 @@ impl Bench { .unwrap_or_default(); (now.saturating_sub(ago)).as_secs_f64() * 1000.0 }; + let ui = perf.ui_frame_times(); + let scroll = match self.scroll { + Some((_, from, Some(to))) => &ui[from.min(to)..to.min(ui.len())], + _ => &[], + }; let result = serde_json::json!({ "first_frame_epoch_ms": epoch_ms(first), - "ui_ms": perf.ui_frame_times(), + "ui_ms": ui, + "scroll_ms": scroll, "rss_mb": horizon_bench::rss_bytes(pid).map(|b| b as f64 / f64::from(1 << 20)), "cpu_idle_pct": cpu_idle_pct, }); @@ -270,20 +302,36 @@ pub fn benchmark(repeats: usize) -> Result { } rss.extend(result["rss_mb"].as_f64()); cpu.extend(result["cpu_idle_pct"].as_f64()); - let ui: Vec = result["ui_ms"] - .as_array() - .into_iter() - .flatten() - .filter_map(|v| v.as_f64()) - .map(|v| v as f32) - .collect(); + let times = |key: &str| -> Vec { + result[key] + .as_array() + .into_iter() + .flatten() + .filter_map(|v| v.as_f64()) + .map(|v| v as f32) + .collect() + }; + let (ui, scroll) = (times("ui_ms"), times("scroll_ms")); report .frames .extend(Frames::of("pages", repeat as u32, &ui, &[], &[])); + report + .frames + .extend(Frames::of("scroll", repeat as u32, &scroll, &[], &[])); + let mut sorted = scroll.clone(); + sorted.sort_by(f32::total_cmp); + let at = |q: f32| { + sorted + .get(((sorted.len() as f32 - 1.) * q) as usize) + .copied() + }; eprintln!( - "start {}: {:.0} ms to the first frame", + "start {}: {:.0} ms to the first frame; scrolling {} frames, median {:.1} ms, p95 {:.1} ms", repeat + 1, - starts.last().unwrap_or(&0.0) + starts.last().unwrap_or(&0.0), + sorted.len(), + at(0.5).unwrap_or(0.), + at(0.95).unwrap_or(0.) ); } report.metric("launcher.cold_start_ms", &starts[..starts.len().min(1)]); @@ -364,6 +412,7 @@ mod tests { began: None, page: 0, idle_cpu: None, + scroll: None, }; assert!(matches!(bench.tick(&perf), Step::Wait)); perf.frame(); diff --git a/launcher/src/scrollbar.rs b/launcher/src/scrollbar.rs index 87cdbee77..757d3525e 100644 --- a/launcher/src/scrollbar.rs +++ b/launcher/src/scrollbar.rs @@ -49,7 +49,7 @@ impl Scrollbar { /// Wrap the scroll container, reserving a narrow gutter so the bar never covers controls. pub fn wrap(&self, content: Stateful
, theme: &Theme) -> Div { let state = self.clone(); - let track_color = theme.rule; + let track_color = theme.well; let thumb_color = theme.muted; div() .relative() @@ -83,17 +83,14 @@ impl Scrollbar { return; }; let hitbox = hitbox.unwrap(); - window.paint_quad(fill(bounds, track_color).corner_radii(px(3.))); - window.paint_quad( - fill( - Bounds::new( - point(bounds.left() + px(3.), bounds.top() + px(g.top)), - size(bounds.size.width - px(6.), px(g.thumb)), - ), - thumb_color, - ) - .corner_radii(px(3.)), - ); + window.paint_quad(fill(bounds, track_color)); + window.paint_quad(fill( + Bounds::new( + point(bounds.left() + px(3.), bounds.top() + px(g.top)), + size(bounds.size.width - px(6.), px(g.thumb)), + ), + thumb_color, + )); window.on_mouse_event({ let state = state.clone(); move |ev: &MouseDownEvent, phase, window, cx| { diff --git a/launcher/src/servers_page.rs b/launcher/src/servers_page.rs index b1338f1aa..67523464b 100644 --- a/launcher/src/servers_page.rs +++ b/launcher/src/servers_page.rs @@ -114,6 +114,18 @@ pub(super) struct Create { eula_missing: bool, } +/// What the sidebar shows of the Servers page: its list once the page has read it, and whether +/// a server answers. +impl Servers { + pub(super) fn sidebar_list(&self) -> Option<&[Entry]> { + self.loaded.then_some(&self.list[..]) + } + + pub(super) fn is_up(&self, dir: &std::path::Path) -> bool { + self.statuses.get(dir).is_some_and(|s| s.phase == "running") + } +} + pub(super) struct Servers { list: Vec, loaded: bool, diff --git a/launcher/src/theme.rs b/launcher/src/theme.rs index 579259661..6425232c5 100644 --- a/launcher/src/theme.rs +++ b/launcher/src/theme.rs @@ -1,19 +1,29 @@ //! The launcher's view of Horizon's design tokens (`crates/horizon-theme`, described in -//! `docs/design-system.md`), which the game's menus and the website share: cool neutrals in two -//! appearances and one violet accent, Geist and Geist Mono (bundled, SIL Open Font License). +//! `docs/design-system.md`): the blocky look it shares with the website ("Blocks"), stone-dark or +//! lavender-light with Horizon's violet, Pixelify Sans for headings and controls, Geist and Geist +//! Mono for text (all bundled, SIL Open Font License). use gpui::{rgb, Hsla, WindowAppearance}; +use horizon_launcher::backend::Appearance; use horizon_theme as tokens; use std::time::Duration; pub use tokens::{Step, BODY, CAPTION, DISPLAY, HEADING, LABEL, MICRO, TITLE, UI, WORDMARK}; pub const FONT: &str = tokens::FONT; pub const MONO: &str = tokens::MONO; +pub const PIXEL: &str = tokens::PIXEL; +pub use tokens::{BLOCK_BEVEL as BEVEL, BLOCK_LIP as LIP}; /// Shapes and controls, shared with the game's menus and the website. -pub use tokens::{ - CONTROL, CONTROL_LARGE, DISABLED, FIELD, GUTTER, INDEX, PLATE_BLEED, PRESSED, RADIUS, - RADIUS_PILL, RADIUS_PLATE, RISE, ROW, SEGMENT, -}; +pub use tokens::{CONTROL_LARGE, DISABLED, FIELD, PRESSED, RISE, ROW, SEGMENT}; + +/// Blocks have square corners: these stay for the places that ask for a radius. +pub const RADIUS: f32 = 0.; +pub const RADIUS_PLATE: f32 = 0.; +/// Buttons are a little taller than the quiet look's, for their lip. +pub const CONTROL: f32 = 34.; +/// The top bar, and the sidebar of instances and servers. +pub const TOPBAR: f32 = 56.; +pub const SIDEBAR: f32 = 248.; /// Motion: short and eased out, never bouncy. pub const QUICK: Duration = tokens::QUICK.duration(); @@ -23,9 +33,15 @@ pub const STAGGER: Duration = tokens::STAGGER; #[derive(Clone, Copy)] pub struct Theme { + /// The page behind everything (under its stone texture), and its colour as `0xRRGGBB` for + /// the texture. pub page: Hsla, + pub page_rgb: u32, + /// Hover plates, fields and the console: the raised panel colour. pub plate_soft: Hsla, + /// Pressed plates, a switch that is off: the button colour. pub plate: Hsla, + /// Dialogs and menus above the page: the panel colour. pub surface: Hsla, pub rule: Hsla, pub ink: Hsla, @@ -35,6 +51,21 @@ pub struct Theme { pub on_accent: Hsla, pub danger: Hsla, pub success: Hsla, + pub warn: Hsla, + /// The blocky parts (`horizon_theme::Blocks`). + pub side: Hsla, + pub panel: Hsla, + pub raised: Hsla, + pub button: Hsla, + pub button_bevel: Hsla, + pub well: Hsla, + pub bevel: Hsla, + pub lip: Hsla, + pub outline: Hsla, + pub face: Hsla, + pub face_bevel: Hsla, + pub face_lip: Hsla, + pub on_face: Hsla, pub dark: bool, } @@ -43,42 +74,61 @@ fn c(hex: u32) -> Hsla { } impl Theme { - /// The system's appearance; `HORIZON_LAUNCHER_APPEARANCE=light` or `dark` overrides it (for + /// The player's choice in Settings (dark unless they picked another), the system's when they + /// asked to follow it. `HORIZON_LAUNCHER_APPEARANCE=light` or `dark` overrides both (for /// screenshots and tests). - pub fn for_appearance(appearance: WindowAppearance) -> Self { + pub fn for_appearance(choice: Appearance, system: WindowAppearance) -> Self { match std::env::var("HORIZON_LAUNCHER_APPEARANCE").as_deref() { Ok("light") => return Self::light(), Ok("dark") => return Self::dark(), _ => {} } - match appearance { - WindowAppearance::Light | WindowAppearance::VibrantLight => Self::light(), + match (choice, system) { + (Appearance::Light, _) => Self::light(), + (Appearance::System, WindowAppearance::Light | WindowAppearance::VibrantLight) => { + Self::light() + } _ => Self::dark(), } } pub fn dark() -> Self { - Self::from(tokens::DARK) + Self::from(tokens::BLOCKS_DARK) } pub fn light() -> Self { - Self::from(tokens::LIGHT) + Self::from(tokens::BLOCKS_LIGHT) } - fn from(p: tokens::Palette) -> Self { + fn from(p: tokens::Blocks) -> Self { Self { page: c(p.page), - plate_soft: c(p.plate_soft), - plate: c(p.plate), - surface: c(p.surface), + page_rgb: p.page, + plate_soft: c(p.raised), + plate: c(p.button), + surface: c(p.panel), rule: c(p.rule), ink: c(p.ink), ink_soft: c(p.ink_soft), muted: c(p.muted), accent: c(p.accent), - on_accent: c(p.on_accent), + on_accent: c(p.on_face), danger: c(p.danger), success: c(p.success), + warn: c(p.warn), + side: c(p.side), + panel: c(p.panel), + raised: c(p.raised), + button: c(p.button), + button_bevel: c(p.button_bevel), + well: c(p.well), + bevel: c(p.bevel), + lip: c(p.lip), + outline: c(p.outline), + face: c(p.face), + face_bevel: c(p.face_bevel), + face_lip: c(p.face_lip), + on_face: c(p.on_face), dark: p.dark, } } @@ -105,13 +155,14 @@ mod tests { /// field (WCAG 1.4.11 asks 3:1 for those), and text over a selected suggestion. #[test] fn marks_and_selections_read_clearly() { - for p in [tokens::LIGHT, tokens::DARK] { + for p in [tokens::BLOCKS_LIGHT, tokens::BLOCKS_DARK] { let theme = if p.dark { "dark" } else { "light" }; for (name, bg) in [ ("page", p.page), - ("plate_soft", p.plate_soft), - ("plate", p.plate), - ("surface", p.surface), + ("raised", p.raised), + ("button", p.button), + ("panel", p.panel), + ("well", p.well), ] { let ring = tokens::contrast(p.accent, bg); assert!(ring >= 3.0, "{theme} focus ring on {name}: {ring:.2}"); @@ -121,7 +172,7 @@ mod tests { "{theme} refused field on {name}: {refused:.2}" ); } - let selection = blend(p.accent, p.surface, SELECTION); + let selection = blend(p.accent, p.panel, SELECTION); let ratio = tokens::contrast(p.ink, selection); assert!(ratio >= 4.5, "{theme} text on a selection: {ratio:.2}"); } From 2f8d913b851865ad31fb4981fd44f30e1304cede Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 20:14:29 +0200 Subject: [PATCH 050/126] Launcher: long lists draw only the rows near the screen Versions and Patch notes list a hundred releases, and every frame laid out and painted all of them. Rows more than a screen away from the viewport are now empty blocks as tall as when they were last drawn (cull.rs), so the page keeps its length; a row being installed or showing an error is always drawn. Scrolling Versions on the Mac mini: median frame 8.2 -> 7.0 ms. HORIZON_LAUNCHER_PROJECT= opens a project's page on the Mods page, for screenshots, as HORIZON_LAUNCHER_PAGE opens a page. Co-Authored-By: Claude Opus 5.5 --- launcher/src/cull.rs | 119 +++++++++++++++++++++ launcher/src/main.rs | 219 +++++++++++++++++++++----------------- launcher/src/mods_page.rs | 25 +++-- 3 files changed, 257 insertions(+), 106 deletions(-) create mode 100644 launcher/src/cull.rs diff --git a/launcher/src/cull.rs b/launcher/src/cull.rs new file mode 100644 index 000000000..41df05610 --- /dev/null +++ b/launcher/src/cull.rs @@ -0,0 +1,119 @@ +//! Long lists in the page's scroll area (the hundred releases on Versions and Patch notes) draw +//! only the rows near what is on screen. A row far off screen becomes an empty block as tall as +//! it was the last time it was drawn, so the page keeps its length and the scrollbar its place. +use gpui::{div, px, Bounds, Div, IntoElement, ParentElement, Pixels, ScrollHandle, Styled}; +use std::{cell::RefCell, rc::Rc}; + +#[derive(Clone, Default)] +pub struct Cull(Rc>); + +/// Where each row was in the last frame, and the scroll offset and the viewport's width then +/// (a narrower window wraps text, and the heights no longer hold). +#[derive(Default)] +struct Drawn { + rows: Vec>, + offset: Pixels, + width: Pixels, +} + +impl Cull { + /// A column for `rows` rows that remembers where they were drawn. Rows come from `row(i)`, or + /// an empty block when row `i` was more than a screen away from the viewport last frame and + /// `keep(i)` is false (a row being installed or showing an error is always drawn). + pub fn column( + &self, + handle: &ScrollHandle, + rows: usize, + gap: f32, + keep: impl Fn(usize) -> bool, + mut row: impl FnMut(usize) -> E, + ) -> Div { + let far = self.far(handle, rows); + let skipped: Vec> = (0..rows).map(|i| far(i).filter(|_| !keep(i))).collect(); + let gaps = skipped.iter().any(Option::is_some); + let state = self.0.clone(); + let scroll = handle.clone(); + div() + .flex() + .flex_col() + .children(skipped.iter().enumerate().map(|(i, skip)| match skip { + Some(height) => div().flex_none().h(*height).mb(px(gap)).into_any_element(), + None => row(i).into_any_element(), + })) + .on_children_prepainted(move |bounds, window, _| { + let view = scroll.bounds(); + // A jump of more than a screen (the scrollbar dragged) can bring an empty block + // into view: draw again, with the rows where they are now. + if gaps + && bounds + .iter() + .zip(&skipped) + .any(|(b, skip)| skip.is_some() && !away(*b, px(0.), view)) + { + window.refresh(); + } + let mut drawn = state.borrow_mut(); + drawn.rows = bounds; + drawn.offset = scroll.offset().y; + drawn.width = view.size.width; + }) + } + + /// For row `i`: its height when it was more than a screen away from the viewport. + fn far(&self, handle: &ScrollHandle, rows: usize) -> impl Fn(usize) -> Option { + let drawn = self.0.borrow(); + let view = handle.bounds(); + // The rows moved by however far the page scrolled since they were drawn. + let moved = handle.offset().y - drawn.offset; + let known = + drawn.rows.len() == rows && view.size.height > px(0.) && drawn.width == view.size.width; + let rows = if known { + drawn.rows.clone() + } else { + Vec::new() + }; + move |i| { + let b = *rows.get(i)?; + away(b, moved, view).then_some(b.size.height) + } + } +} + +/// Whether a row drawn at `row`, since moved down by `moved`, is more than a screen above or +/// below `view`. +fn away(row: Bounds, moved: Pixels, view: Bounds) -> bool { + row.bottom() + moved < view.top() - view.size.height + || row.top() + moved > view.bottom() + view.size.height +} + +#[cfg(test)] +mod tests { + use super::*; + use gpui::{point, size}; + + fn at(y: f32, h: f32) -> Bounds { + Bounds::new(point(px(0.), px(y)), size(px(10.), px(h))) + } + + #[test] + fn only_rows_more_than_a_screen_away_are_skipped() { + let view = at(100., 500.); + assert!(!away(at(100., 100.), px(0.), view)); + assert!(!away(at(1000., 100.), px(0.), view)); + assert!(away(at(1200., 100.), px(0.), view)); + assert!(away(at(-600., 100.), px(0.), view)); + // Scrolled 700 px down since: the row that was far below is now on screen. + assert!(!away(at(1200., 100.), px(-700.), view)); + } + + #[test] + fn nothing_is_skipped_before_the_rows_are_known() { + let cull = Cull::default(); + cull.0.borrow_mut().rows = (0..10).map(|i| at(i as f32 * 2000., 100.)).collect(); + // No viewport yet (the first frame), or another number of rows: every row is drawn. + let far = cull.far(&ScrollHandle::new(), 10); + assert!((0..10).all(|i| far(i).is_none())); + let far = cull.far(&ScrollHandle::new(), 11); + assert!((0..11).all(|i| far(i).is_none())); + } +} diff --git a/launcher/src/main.rs b/launcher/src/main.rs index 365c952f4..cfee78d63 100644 --- a/launcher/src/main.rs +++ b/launcher/src/main.rs @@ -5,6 +5,7 @@ mod art; mod blocks; mod cli; mod collection; +mod cull; mod game_tools; mod internet; mod markdown; @@ -123,6 +124,8 @@ struct Launcher { /// How many times the page changed, for the page transition. switches: usize, content_scroll: Scrollbar, + /// The rows of the page's long list (Versions, Patch notes) last drawn. + long_list: cull::Cull, opening: Option, updates: Updates, checked: Option, @@ -256,6 +259,7 @@ impl Launcher { page: Page::from_env(), switches: 0, content_scroll: Scrollbar::default(), + long_list: cull::Cull::default(), opening: (!settings.skip_opening).then(|| { let focus = cx.focus_handle(); window.focus(&focus); @@ -357,6 +361,7 @@ impl Launcher { self.page = page; self.switches += 1; self.content_scroll = Scrollbar::default(); + self.long_list = cull::Cull::default(); } self.picker_open = false; } @@ -2974,23 +2979,36 @@ impl Launcher { Load::Ready(r) if r.is_empty() => return page.child(centered("No releases yet.", &t)), Load::Ready(r) => r.clone(), }; - let mut list = div().flex().flex_col(); - for release in releases.into_iter() { - let tag = release.tag.clone(); - let installed = self.installed.contains(&tag); - let selected = self.selected() == Some(&tag); - let channel = backend::UpdateChannel::of(&release).label(); - let mut meta = vec![channel.to_string(), release.date.clone()]; - if let Some((_, size)) = release.asset { - meta.push(megabytes(size)); - } - let summary = release - .name - .split_once(": ") - .map(|(_, rest)| rest.to_string()) - .unwrap_or_else(|| release.name.clone()); - let right: gpui::AnyElement = - if let Some((_, p)) = self.installing.as_ref().filter(|(t, _)| *t == tag) { + // A hundred releases: only the rows near the screen are drawn. + let keep = |i: usize| { + let tag = &releases[i].tag; + self.installing.as_ref().is_some_and(|(t, _)| t == tag) + || self.install_error.as_ref().is_some_and(|(t, _)| t == tag) + || self.confirm_remove.as_ref() == Some(tag) + }; + let list = self.long_list.clone().column( + &self.content_scroll.handle, + releases.len(), + 8., + keep, + |i| { + let release = releases[i].clone(); + let tag = release.tag.clone(); + let installed = self.installed.contains(&tag); + let selected = self.selected() == Some(&tag); + let channel = backend::UpdateChannel::of(&release).label(); + let mut meta = vec![channel.to_string(), release.date.clone()]; + if let Some((_, size)) = release.asset { + meta.push(megabytes(size)); + } + let summary = release + .name + .split_once(": ") + .map(|(_, rest)| rest.to_string()) + .unwrap_or_else(|| release.name.clone()); + let right: gpui::AnyElement = if let Some((_, p)) = + self.installing.as_ref().filter(|(t, _)| *t == tag) + { div() .flex() .items_center() @@ -3067,76 +3085,77 @@ impl Launcher { } b.into_any_element() }; - let status = if selected { - Some(caps("In use").text_color(t.accent)) - } else if installed { - Some(caps("Installed").text_color(t.ink_soft)) - } else { - None - }; - let error = self - .install_error - .as_ref() - .filter(|(t, _)| *t == tag) - .map(|(_, e)| e.clone()); - let id = SharedString::from(format!("release-{tag}")); - let row = div() - .id(id.clone()) - .relative() - .flex() - .flex_col() - .gap(px(10.)) - .py(px(14.)) - .px(px(16.)) - .mb(px(8.)) - .bg(t.panel) - .border_2() - .border_color(t.outline) - .children(blocks::edges(t.bevel, t.lip, theme::BEVEL)) - .child(hover_layer(&id, t.raised, 0., 0.)) - .child( - div() - .relative() - .flex() - .items_center() - .gap(px(16.)) - .child( - div() - .flex() - .flex_col() - .flex_1() - .min_w_0() - .gap(px(4.)) - .child(version_tag(&tag).text_color(t.ink)) - .child( - text(theme::UI) - .text_color(t.muted) - .truncate() - .child(summary), - ), - ) - .child( - div() - .flex() - .flex_col() - .items_end() - .gap(px(2.)) - .flex_none() - .children(status) - .child(caps(meta.join(" · ")).text_color(t.muted)), - ) - .child( - div() - .flex() - .justify_end() - .w(px(190.)) - .flex_none() - .child(right), - ), - ) - .children(error.map(|e| notice(e, &t))); - list = list.child(track_hover(row, id)); - } + let status = if selected { + Some(caps("In use").text_color(t.accent)) + } else if installed { + Some(caps("Installed").text_color(t.ink_soft)) + } else { + None + }; + let error = self + .install_error + .as_ref() + .filter(|(t, _)| *t == tag) + .map(|(_, e)| e.clone()); + let id = SharedString::from(format!("release-{tag}")); + let row = div() + .id(id.clone()) + .relative() + .flex() + .flex_col() + .gap(px(10.)) + .py(px(14.)) + .px(px(16.)) + .mb(px(8.)) + .bg(t.panel) + .border_2() + .border_color(t.outline) + .children(blocks::edges(t.bevel, t.lip, theme::BEVEL)) + .child(hover_layer(&id, t.raised, 0., 0.)) + .child( + div() + .relative() + .flex() + .items_center() + .gap(px(16.)) + .child( + div() + .flex() + .flex_col() + .flex_1() + .min_w_0() + .gap(px(4.)) + .child(version_tag(&tag).text_color(t.ink)) + .child( + text(theme::UI) + .text_color(t.muted) + .truncate() + .child(summary), + ), + ) + .child( + div() + .flex() + .flex_col() + .items_end() + .gap(px(2.)) + .flex_none() + .children(status) + .child(caps(meta.join(" · ")).text_color(t.muted)), + ) + .child( + div() + .flex() + .justify_end() + .w(px(190.)) + .flex_none() + .child(right), + ), + ) + .children(error.map(|e| notice(e, &t))); + track_hover(row, id) + }, + ); page.child(list) } @@ -3198,14 +3217,18 @@ impl Launcher { } Load::Ready(r) => r.clone(), }; - let mut list = div().flex().flex_col(); - for release in releases.iter() { - let summary = release - .name - .split_once(": ") - .map(|(_, rest)| rest.to_string()) - .unwrap_or_default(); - list = list.child( + let list = self.long_list.clone().column( + &self.content_scroll.handle, + releases.len(), + 10., + |_| false, + |i| { + let release = &releases[i]; + let summary = release + .name + .split_once(": ") + .map(|(_, rest)| rest.to_string()) + .unwrap_or_default(); div() .flex() .flex_col() @@ -3247,9 +3270,9 @@ impl Launcher { } else { markdown::render(&release.body, &t) }), - ), - ); - } + ) + }, + ); page.child(list) } } diff --git a/launcher/src/mods_page.rs b/launcher/src/mods_page.rs index f2dde2447..9cb834797 100644 --- a/launcher/src/mods_page.rs +++ b/launcher/src/mods_page.rs @@ -220,6 +220,22 @@ impl Launcher { Event::Loaded(l) => loaded.push(l), } } + // `HORIZON_LAUNCHER_PROJECT=` (with `HORIZON_LAUNCHER_PAGE=mods`): opens that + // project's page once a search finds it, for screenshots. + if self.mods.browse.open.is_none() { + if let Ok(want) = std::env::var("HORIZON_LAUNCHER_PROJECT") { + if let Some(p) = self + .mods + .results + .iter() + .find(|p| p.id == want || p.slug == want) + .cloned() + { + std::env::remove_var("HORIZON_LAUNCHER_PROJECT"); + self.mods_open(p); + } + } + } self.mods_check(to_check); for l in loaded { self.mods_loaded(l); @@ -848,14 +864,7 @@ fn source_switch(t: &Theme) -> Stateful
{ .text_color(t.muted) .child("CurseForge (coming soon)"), ); - segments( - "mods-source", - &SOURCES, - SourceId::Modrinth, - t, - |_, _, _| {}, - ) - .child(soon) + segments("mods-source", &SOURCES, SourceId::Modrinth, t, |_, _, _| {}).child(soon) } #[cfg(test)] From 35ffbebcddf833c4a918d92db7a7ed772a1402a8 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Thu, 22 Oct 2026 19:18:03 +0100 Subject: [PATCH 051/126] Revert #1257: keep the integrated server thread enabled by default Revert commit cdaf1d79a040392a6a2b9ee77307f9349a4db6bf, preserving the ladder regression check added afterward. Server-player bugs also affect dedicated servers and Open to LAN. Running single player in the frame only hides those bugs there; keep the shared server-thread path as the default and fix the underlying issues. --- crates/horizon-client/src/game.rs | 11 ++-- crates/horizon-client/src/game/integrated.rs | 7 +-- tools/lan_e2e.py | 60 ++------------------ 3 files changed, 12 insertions(+), 66 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 1c9b21b49..652b30e32 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -273,10 +273,9 @@ struct Options { benchmark: Option, /// `--dev-mod PATH` (repeatable): mods always on and reloaded when rebuilt. dev_mods: Vec, - /// `--server-thread` or `HORIZON_SERVER_THREAD=1`: single player runs on an - /// integrated server thread (game/integrated.rs), as vanilla's does. Off by - /// default again until a server's players can board, ride and hit - /// vehicles (#1222); `--no-server-thread` keeps it off. + /// Single player runs on an integrated server thread (game/integrated.rs), + /// as vanilla's does: the default. `--no-server-thread` or + /// `HORIZON_SERVER_THREAD=0` runs the world in the frame instead. server_thread: bool, /// Set on the integrated server's own options: it draws nothing, so it skips meshing. integrated: bool, @@ -333,7 +332,7 @@ impl Options { dev_mods: Vec::new(), // The command harness (HORIZON_COMMAND_SCRIPT) drives the world // itself, without the event loop: it stays in the frame. - server_thread: std::env::var("HORIZON_SERVER_THREAD").is_ok_and(|v| v == "1") + server_thread: std::env::var("HORIZON_SERVER_THREAD").map_or(true, |v| v != "0") && std::env::var_os("HORIZON_COMMAND_SCRIPT").is_none(), integrated: false, }; @@ -343,7 +342,7 @@ impl Options { match arg.as_str() { "--help" | "-h" => { println!( - "Horizon — Minecraft Java Edition {} in Rust\n\n --resources PATH Prepared resources (horizon-prepare)\n --render-distance N Chunks, 2..64 (default 12)\n --world NAME World folder under saves/ (default \"New World\")\n --seed N World seed for new worlds (default 0)\n --creative Creative mode (default survival)\n --test-terrain Simple test terrain instead of vanilla generation\n --frames N Exit after N frames (testing)\n --world-frames N Exit after N frames drawn in the world (testing)\n --smoke-report PATH Write a JSON report on exit\n --benchmark SCENARIO Run a benchmark (standard, village, forest, ocean, mountain), write its report to benchmarks/ and quit\n --control Accept horizon-ctl commands on a local socket\n --control-socket PATH Control socket path (default $XDG_RUNTIME_DIR/horizon-control.sock)\n --server HOST[:PORT] Join a multiplayer server (offline mode) at start\n --name NAME Player name for multiplayer (default: generated once, kept in horizon-player.txt)\n --session-file PATH Signed-in account from the launcher (read once, then deleted)\n --dev-mod PATH A Horizon mod (.hmod or folder) to develop: always on, reloaded when rebuilt\n --server-thread Run single player's world on its server thread (no vehicles yet)\n\nControls: mouse look, WASD move, Space jump, Left Shift sneak, Left Ctrl sprint,\nleft click break, right click place/use, 1-9/scroll hotbar, E inventory,\nQ drop, F3 debug, Esc pause.", + "Horizon — Minecraft Java Edition {} in Rust\n\n --resources PATH Prepared resources (horizon-prepare)\n --render-distance N Chunks, 2..64 (default 12)\n --world NAME World folder under saves/ (default \"New World\")\n --seed N World seed for new worlds (default 0)\n --creative Creative mode (default survival)\n --test-terrain Simple test terrain instead of vanilla generation\n --frames N Exit after N frames (testing)\n --world-frames N Exit after N frames drawn in the world (testing)\n --smoke-report PATH Write a JSON report on exit\n --benchmark SCENARIO Run a benchmark (standard, village, forest, ocean, mountain), write its report to benchmarks/ and quit\n --control Accept horizon-ctl commands on a local socket\n --control-socket PATH Control socket path (default $XDG_RUNTIME_DIR/horizon-control.sock)\n --server HOST[:PORT] Join a multiplayer server (offline mode) at start\n --name NAME Player name for multiplayer (default: generated once, kept in horizon-player.txt)\n --session-file PATH Signed-in account from the launcher (read once, then deleted)\n --dev-mod PATH A Horizon mod (.hmod or folder) to develop: always on, reloaded when rebuilt\n --no-server-thread Run single player's world in the frame, not on its server thread\n\nControls: mouse look, WASD move, Space jump, Left Shift sneak, Left Ctrl sprint,\nleft click break, right click place/use, 1-9/scroll hotbar, E inventory,\nQ drop, F3 debug, Esc pause.", horizon_core::VANILLA_VERSION ); return Ok(None); diff --git a/crates/horizon-client/src/game/integrated.rs b/crates/horizon-client/src/game/integrated.rs index 1bd3c7696..ef5775174 100644 --- a/crates/horizon-client/src/game/integrated.rs +++ b/crates/horizon-client/src/game/integrated.rs @@ -6,10 +6,9 @@ //! the world's options) with [`Integrated::call`], as vanilla's client calls //! into its `IntegratedServer`. //! -//! Opt-in again (`--server-thread` or `HORIZON_SERVER_THREAD=1`): it was the -//! default for one day, but a server's players can't board, ride or hit -//! boats and minecarts yet (#1222), and single player's window is one of -//! them here. +//! On by default. `--no-server-thread` or `HORIZON_SERVER_THREAD=0` runs +//! the world in the frame instead (the escape hatch while the network +//! player's side catches up with the in-frame one). use super::{ Game, Options, PackResources, Resources, UiResources, lan::{LanSettings, Owner}, diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index cc1dc9fcf..082a517b1 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -116,8 +116,6 @@ address. The script then checks, from both sides, what a guest's game used to ge and wheat on farmland grows (random ticks), however the host runs its world. - ladder: the guest climbs down ten blocks of ladder and lands unhurt: the server resets its fall distance on a ladder every tick, as LivingEntity.handleOnClimbable does (#1255). -- boats: the host (single player, on its server thread with --server-thread) right-clicks a - boat on water and rides it, sneaks out, and breaks it with its fists (#1222). - flight: a player in creative double-taps jump and flies, stays up, and stops flying in survival: the guest, and on the server thread the host's window too, take what may fly from the server's abilities (ClientPacketListener.handlePlayerAbilities). @@ -159,7 +157,7 @@ ROOT = Path(__file__).resolve().parents[1] GUEST_NAME = 'Guest' # The host plays single player on its server thread (--server-thread). SERVER_THREAD = False -CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder', 'boats'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder'] class Game: @@ -2312,51 +2310,6 @@ def check_ladder(host, guest, out): guest('command', command=f'tp @s {x + 0.5} {y} {z + 0.5}') -def check_boats(host, guest, out): - """#1222: the single player boards a boat on water with a right click, sneaks out, and breaks it.""" - x, y, z = (int(v // 1) for v in pos_of(host)) - bx = x + 3 - host('command', command='gamemode survival') - host('command', command=f'fill {bx - 1} {y} {z - 1} {bx + 1} {y + 3} {z + 1} minecraft:air') - host('command', command=f'fill {bx - 1} {y - 1} {z - 1} {bx + 1} {y - 1} {z + 1} minecraft:water') - host('command', command=f'summon minecraft:oak_boat {bx + 0.5} {y - 0.1} {z + 0.5}') - host.wait(30) - boats = [o for o in host('status')['objects'] if o['kind'].endswith('oak_boat') - and abs(o['position'][0] - (bx + 0.5)) < 2 and abs(o['position'][2] - (z + 0.5)) < 2] - try: - assert boats, 'the host sees no boat on the water' - boat = boats[0] - bp = boat['position'] - host.raw('look-at', f'{bp[0]:.2f}', f'{bp[1] + 0.3:.2f}', f'{bp[2]:.2f}') - host.raw('mouse', 'right', 'click') - host.wait(10) - riding = host('status').get('riding') - assert riding == boat['id'], f'right-clicking the boat {boat["id"]}: riding {riding}' - host.raw('key', 'shift', 'down') - host.wait(10) - host.raw('key', 'shift', 'up') - host.wait(10) - riding = host('status').get('riding') - assert riding is None, f'sneaking out of the boat: riding {riding}' - host('command', command=f'tp @s {x + 0.5} {y} {z + 0.5}') - host.wait(5) - gone = False - for _ in range(10): - here = [o for o in host('status')['objects'] if o['id'] == boat['id']] - if not here: - gone = True - break - bp = here[0]['position'] - host.raw('look-at', f'{bp[0]:.2f}', f'{bp[1] + 0.3:.2f}', f'{bp[2]:.2f}') - host.raw('mouse', 'left', 'click') - # VehicleEntity.tick takes 1 off the damage every tick: hit fast. - host.wait(2) - assert gone, 'ten hits left the boat in place' - return {'boat': boat['id'], 'rode': True, 'broken': True} - finally: - host('command', command=f'kill @e[type=minecraft:oak_boat,x={bx},y={y},z={z},distance=..6]') - host('command', command=f'fill {bx - 1} {y - 1} {z - 1} {bx + 1} {y - 1} {z + 1} minecraft:stone') - def check_growth(host, guest, out): """Block ticks near a guest 1000 blocks from the host: only the guest's tickets tick them.""" x0, y0, z0 = pos_of(guest) @@ -2669,18 +2622,13 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles, 'blast': check_blast, 'light': check_light, 'plates': check_plates, 'swings': check_swings, 'cracks': check_cracks, - 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder, 'boats': check_boats} + 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder} def run(ctl, out, resources, checks): host, guest = Game('host', ctl, resources), Game('guest', ctl, resources) - # Without --server-thread the host runs the game's default, the world in the frame, as players - # get it (`boats` fails there if the default goes back to the server thread before it has - # vehicles, #1222). - if SERVER_THREAD: - host.d.env['HORIZON_SERVER_THREAD'] = '1' - else: - host.d.env.pop('HORIZON_SERVER_THREAD', None) + # Either way explicitly: the game's default is the server thread. + host.d.env['HORIZON_SERVER_THREAD'] = '1' if SERVER_THREAD else '0' results = {} try: host.pid = host('launch', wait=False, offscreen=sys.platform == 'darwin')['pid'] From f1f8170c586bc4eefb14f0b4f7968b69a6829bdb Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 20:33:35 +0200 Subject: [PATCH 052/126] Launcher: the offline name without its key, and Home before any version The game keeps the offline name as "name:Player12345" in horizon-player.txt; the top bar and the friends-only server list showed the whole line. Both now read the name after the key. With no version installed, Home has no landscape: its title starts below the top bar like the other pages, and the sidebar says "No version installed" instead of "Needs preparing". Co-Authored-By: Claude Opus 5.5 --- launcher/src/main.rs | 31 +++++++++++++++++++++++++++---- launcher/src/servers_page.rs | 10 ++++------ 2 files changed, 31 insertions(+), 10 deletions(-) diff --git a/launcher/src/main.rs b/launcher/src/main.rs index cfee78d63..78e6f6d50 100644 --- a/launcher/src/main.rs +++ b/launcher/src/main.rs @@ -1260,10 +1260,17 @@ fn centered(text_: &str, t: &Theme) -> Div { /// The name the game made up for a player without an account, once it has run. fn offline_name() -> Option { - std::fs::read_to_string(backend::game_home().join("horizon-player.txt")) - .ok() - .map(|n| n.trim().to_string()) + player_name(&std::fs::read_to_string(backend::game_home().join("horizon-player.txt")).ok()?) +} + +/// The name in `horizon-player.txt`: the game writes `name:Player12345` (horizon-client's +/// offline_name.rs). +fn player_name(text: &str) -> Option { + text.lines() + .find_map(|line| line.trim().strip_prefix("name:")) + .map(str::trim) .filter(|n| !n.is_empty()) + .map(str::to_owned) } /// `1234` as `1,234`. @@ -1539,7 +1546,9 @@ impl Launcher { .flex_col() .min_w_0() .child(title("Horizon".into())) - .child(sub(if prepared { + .child(sub(if tag.is_none() { + "No version installed" + } else if prepared { "Vanilla · ready" } else { "Needs preparing" @@ -1826,10 +1835,12 @@ impl Launcher { fn play_page(&mut self, cx: &mut Context) -> Div { let t = self.theme; let Some(tag) = self.selected().cloned() else { + // No hero without a version: the page starts below the top bar like the others. return div() .flex() .flex_col() .gap(px(24.)) + .pt(px(28.)) .child(page_header( "Play", "Start the game, or run a server for others to join.", @@ -3582,6 +3593,18 @@ fn main() { #[cfg(test)] mod tests { + #[test] + fn the_offline_name_is_read_from_its_key() { + use super::player_name; + assert_eq!( + player_name("name:Player63010\n").as_deref(), + Some("Player63010") + ); + assert_eq!(player_name("name:Steve\r\n").as_deref(), Some("Steve")); + assert_eq!(player_name("Player63010\n"), None); + assert_eq!(player_name(""), None); + } + #[test] fn counts_get_thousands_separators() { let shown: Vec = [0, 7, 999, 1000, 12_300, 1_234_500] diff --git a/launcher/src/servers_page.rs b/launcher/src/servers_page.rs index 67523464b..b1e7eb775 100644 --- a/launcher/src/servers_page.rs +++ b/launcher/src/servers_page.rs @@ -284,12 +284,10 @@ pub(super) fn stop_on_quit() { /// The player's own name, to let them in on a friends-only server: the Microsoft account that plays, /// else the name the game made up for them (`horizon-player.txt`). fn own_name(accounts: &Accounts) -> Option { - accounts.selected().map(|a| a.name.clone()).or_else(|| { - std::fs::read_to_string(backend::game_home().join("horizon-player.txt")) - .ok() - .map(|n| n.trim().to_string()) - .filter(|n| !n.is_empty()) - }) + accounts + .selected() + .map(|a| a.name.clone()) + .or_else(crate::offline_name) } fn bytes(n: u64) -> String { From cd494e74bad04d515d6fedc8b5f6db8f5bf5af1d Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Thu, 22 Oct 2026 19:27:45 +0100 Subject: [PATCH 053/126] Cache uniform resident biome cells during surface generation --- .../horizon-world/src/worldgen/generator.rs | 162 +++++++++++++++++- 1 file changed, 159 insertions(+), 3 deletions(-) diff --git a/crates/horizon-world/src/worldgen/generator.rs b/crates/horizon-world/src/worldgen/generator.rs index 2d7dd251c..28b45ea44 100644 --- a/crates/horizon-world/src/worldgen/generator.rs +++ b/crates/horizon-world/src/worldgen/generator.rs @@ -1114,6 +1114,11 @@ where pipeline: self, temperatures: &mut worker.temperatures, biome: Biomes::Region(&biomes), + uniform_biomes: Some(UniformSurfaceBiomes::new( + pos, + self.settings.level_min_y, + self.settings.level_height, + )), possible: Some(possible), }, preliminary_surface: self.preliminary.clone(), @@ -1149,6 +1154,7 @@ where pipeline: self, temperatures: &mut worker.temperatures, biome: Biomes::Resolver(&mut resolver, &mut biome_context), + uniform_biomes: None, possible: None, }, preliminary_surface: self.preliminary.clone(), @@ -1393,6 +1399,63 @@ enum Biomes<'a, 'b> { &'a mut SamplerContext, ), } +// Lazy equality proofs for the eight quart corners of a block-biome cell. +// Adjacent blocks share these candidates even though their zoom distances differ. +struct UniformSurfaceBiomes { + origin: [i32; 3], + height: i32, + cells: Vec>>, +} +impl UniformSurfaceBiomes { + fn new(pos: ChunkPos, min_y: i32, height: i32) -> Self { + let height = (height >> 2) + 1; + Self { + origin: [ + pos.x.wrapping_shl(4).wrapping_sub(2) >> 2, + min_y.wrapping_sub(2) >> 2, + pos.z.wrapping_shl(4).wrapping_sub(2) >> 2, + ], + height, + cells: vec![None; 25 * height as usize], + } + } + fn get(&mut self, region: &BiomeRegion, p: BlockPos) -> Option { + let base = [p.x, p.y, p.z].map(|v| v.wrapping_sub(2) >> 2); + let d: [i32; 3] = std::array::from_fn(|i| base[i].wrapping_sub(self.origin[i])); + if !(0..5).contains(&d[0]) || !(0..self.height).contains(&d[1]) || !(0..5).contains(&d[2]) { + return None; + } + let slot = &mut self.cells[((d[0] * 5 + d[2]) * self.height + d[1]) as usize]; + if let Some(value) = slot { + return *value; + } + let value = (|| { + // These are immutable stored lookups. A missing candidate prevents + // the shortcut; only the original selected lookup may report errors. + let first = *region.noise_biome(base).ok()?; + for x in 0..2 { + for y in 0..2 { + for z in 0..2 { + if *region + .noise_biome([ + base[0].wrapping_add(x), + base[1].wrapping_add(y), + base[2].wrapping_add(z), + ]) + .ok()? + != first + { + return None; + } + } + } + } + Some(first) + })(); + *slot = Some(value); + value + } +} /// Material-rule world queries for one chunk: shared seed-bound noises, the /// worker's temperature caches and either stored or raw-resolver biomes. struct SurfaceQueries<'a, 'b, R: RandomSource> { @@ -1400,6 +1463,7 @@ struct SurfaceQueries<'a, 'b, R: RandomSource> { temperatures: &'a mut [BiomeTemperature], biome: Biomes<'a, 'b>, possible: Option>, + uniform_biomes: Option, } impl SurfaceQueries<'_, '_, R> { fn temperature(&mut self, name: &str) -> Result<&mut BiomeTemperature, MaterialRuleError> { @@ -1437,9 +1501,16 @@ impl MaterialSurfaceQueries for SurfaceQueries<'_, '_, R> { fn biome(&mut self, p: BlockPos) -> Result>, MaterialRuleError> { let data = &self.pipeline.data; let id = match &mut self.biome { - Biomes::Region(region) => *region - .biome(p) - .map_err(|_| MaterialRuleError::MissingBiome)?, + Biomes::Region(region) => match self + .uniform_biomes + .as_mut() + .and_then(|cache| cache.get(region, p)) + { + Some(id) => id, + None => *region + .biome(p) + .map_err(|_| MaterialRuleError::MissingBiome)?, + }, Biomes::Resolver(resolver, context) => { let name = resolver .sample(context, self.pipeline.zoom.quart_at_block(p)) @@ -1778,6 +1849,7 @@ where pipeline: self, temperatures: &mut worker.temperatures, biome: Biomes::Resolver(&mut resolver, &mut biome_context), + uniform_biomes: None, possible: None, }; let sources = MaterialDensitySources::new( @@ -1944,6 +2016,7 @@ where pipeline: self, temperatures: &mut worker.temperatures, biome: Biomes::Resolver(&mut resolver, &mut biome_context), + uniform_biomes: None, possible: None, }; let sources = MaterialDensitySources::new( @@ -2408,6 +2481,89 @@ impl GeneratorWorker { mod tests { use super::*; + #[test] + fn uniform_surface_biomes_preserve_zoom_and_missing_corner_errors() { + use super::super::biome_chunk::BiomeChunk; + use std::convert::Infallible; + + for pos in [ + ChunkPos::new(0, 0), + ChunkPos::new(-17, 23), + ChunkPos::new(i32::MIN >> 4, i32::MAX >> 4), + ] { + for seed in [0, -1, i64::MIN] { + for mixed in [false, true] { + let mut chunks = Vec::new(); + for dz in -1..=1 { + for dx in -1..=1 { + let mut chunk = BiomeChunk::new( + ChunkPos::new(pos.x + dx, pos.z + dz), + -64, + 128, + BiomeId(7), + ) + .unwrap(); + chunk + .fill(-64, 63, |[x, y, z]| { + Ok::<_, Infallible>(if mixed { + BiomeId( + (x.div_euclid(3) + y.div_euclid(4) + z.div_euclid(2)) + .rem_euclid(5) + as u32, + ) + } else { + BiomeId(7) + }) + }) + .unwrap(); + chunks.push(chunk); + } + } + let region = BiomeRegion::new(chunks, seed).unwrap(); + let mut cache = UniformSurfaceBiomes::new(pos, -64, 128); + let mut hits = 0; + for x in 0..16 { + for z in 0..16 { + // Include clamped Y, out-of-cache Y, and revisit each + // cached proof in the ordinary descending traversal. + for y in (-70..70).rev() { + let p = BlockPos::new(pos.x * 16 + x, y, pos.z * 16 + z); + let shortcut = cache.get(®ion, p); + hits += usize::from(shortcut.is_some()); + let actual = shortcut.map_or_else(|| region.biome(p).copied(), Ok); + assert_eq!(actual, region.biome(p).copied()); + } + } + } + if !mixed && pos.x != i32::MIN >> 4 { + assert!(hits > 0); + } + } + } + } + + // Some unselected corners are missing. Probing them must neither invent + // an error nor hide the original selected-corner error. + let pos = ChunkPos::new(0, 0); + let region = + BiomeRegion::new(vec![BiomeChunk::new(pos, 0, 16, BiomeId(7)).unwrap()], -1).unwrap(); + let mut cache = UniformSurfaceBiomes::new(pos, 0, 16); + let mut successes = 0; + let mut failures = 0; + for x in -2..18 { + for z in -2..18 { + let p = BlockPos::new(x, 7, z); + let actual = cache + .get(®ion, p) + .map_or_else(|| region.biome(p).copied(), Ok); + assert_eq!(actual, region.biome(p).copied()); + successes += usize::from(actual.is_ok()); + failures += usize::from(actual.is_err()); + } + } + assert!(successes > 0 && failures > 0); + } + #[test] fn far_surface_matches_undecorated_land_and_keeps_end_void() { let root = std::env::var_os("HORIZON_TEST_RESOURCES") From 042adc674ae3d3389ac41e2dc72f7990261916c8 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 20:30:45 +0200 Subject: [PATCH 054/126] One menu style, vanilla's: Horizon's settings join vanilla's Options Drop the Horizon menu style (options_horizon.rs, front.rs, the live title backdrop and its post grade, the launcher's menu-style setting, CLI and MCP tool). Every screen is vanilla's. Horizon's own settings hang off vanilla's Options the way mods add theirs: Horizon Settings... and Mods... take the Telemetry/Credits slots, and Horizon Settings opens Graphics, Advanced Graphics, Shader Packs, Controller Settings, Extras and Mods, each a vanilla options list with tooltips. Play with friends moves behind vanilla's Friends buttons: the pause menu's opens Play with Friends (share, copy, stop), the title screen's opens Join a Friend, and Direct Connection takes a full code. Old files load as before: horizon.txt's menuStyle line and horizon-graphics.txt's level line are ignored. Co-Authored-By: Claude Opus 5.5 --- .github/workflows/launcher.yml | 3 - README.md | 4 +- crates/horizon-client/src/friends_screen.rs | 275 +++ crates/horizon-client/src/front.rs | 1572 ----------------- crates/horizon-client/src/game.rs | 156 +- crates/horizon-client/src/game/agent.rs | 1 + crates/horizon-client/src/game/backdrop.rs | 303 ---- crates/horizon-client/src/game/control.rs | 3 + crates/horizon-client/src/game/friends.rs | 41 +- crates/horizon-client/src/game/pad_menu.rs | 46 +- crates/horizon-client/src/game/screens.rs | 105 +- .../horizon-client/src/game/startup_menu.rs | 78 +- crates/horizon-client/src/gfx.rs | 22 - crates/horizon-client/src/graphics.rs | 10 +- crates/horizon-client/src/graphics_ui.rs | 2 +- crates/horizon-client/src/hud.rs | 4 +- crates/horizon-client/src/lib.rs | 4 +- crates/horizon-client/src/multiplayer.rs | 44 +- crates/horizon-client/src/options_horizon.rs | 1259 ------------- crates/horizon-client/src/options_ui.rs | 239 +-- crates/horizon-client/src/post.rs | 273 --- crates/horizon-client/src/post.wgsl | 51 - crates/horizon-client/src/telemetry.rs | 2 +- crates/horizon-client/src/title.rs | 36 +- .../src/title/world_management.rs | 2 +- crates/horizon-client/src/ui_theme.rs | 1031 +---------- crates/horizon-client/src/widgets.rs | 9 +- crates/horizon-theme/src/lib.rs | 2 +- docs/README.md | 2 +- docs/agent-control.md | 8 +- docs/controllers.md | 34 +- docs/design-system.md | 13 +- docs/extras.md | 9 +- docs/graphics.md | 10 +- docs/media/accessibility-settings-horizon.png | Bin 97641 -> 0 bytes docs/media/menu-options.png | Bin 582624 -> 0 bytes docs/media/menu-pause.png | Bin 199199 -> 0 bytes docs/media/menu-title.png | Bin 384583 -> 0 bytes docs/media/menu-title.webm | Bin 206441 -> 0 bytes docs/media/menu-title.webp | Bin 23462 -> 0 bytes docs/media/menu-worlds.png | Bin 195804 -> 0 bytes docs/media/menu-worlds.webp | Bin 16810 -> 0 bytes docs/mods.md | 2 +- docs/native-client.md | 4 +- docs/play-with-friends.md | 6 +- docs/shader-packs.md | 7 +- launcher/README.md | 18 +- launcher/src/backend.rs | 83 - launcher/src/cli.rs | 17 - launcher/src/main.rs | 43 +- launcher/src/mcp.rs | 10 - tools/test_lan_lifecycle.py | 2 +- website/LEGAL.md | 4 - website/docs/index.md | 2 +- website/docs/install.md | 2 +- website/docs/mods.md | 2 +- website/docs/multiplayer.md | 6 +- website/docs/settings.md | 22 +- website/public/media/menu-options-800.webp | Bin 16856 -> 0 bytes website/public/media/menu-options.webp | Bin 37908 -> 0 bytes website/public/media/menu-pause-800.webp | Bin 7632 -> 0 bytes website/public/media/menu-pause.webp | Bin 15762 -> 0 bytes website/public/media/menu-title-800.webp | Bin 11058 -> 0 bytes website/public/media/menu-title.webp | Bin 23462 -> 0 bytes website/public/media/menu-worlds-800.webp | Bin 8078 -> 0 bytes website/public/media/menu-worlds.webp | Bin 16810 -> 0 bytes website/scripts/assets.mjs | 4 - website/src/index.html | 12 +- 68 files changed, 732 insertions(+), 5167 deletions(-) create mode 100644 crates/horizon-client/src/friends_screen.rs delete mode 100644 crates/horizon-client/src/front.rs delete mode 100644 crates/horizon-client/src/game/backdrop.rs delete mode 100644 crates/horizon-client/src/options_horizon.rs delete mode 100644 crates/horizon-client/src/post.rs delete mode 100644 crates/horizon-client/src/post.wgsl delete mode 100644 docs/media/accessibility-settings-horizon.png delete mode 100644 docs/media/menu-options.png delete mode 100644 docs/media/menu-pause.png delete mode 100644 docs/media/menu-title.png delete mode 100644 docs/media/menu-title.webm delete mode 100644 docs/media/menu-title.webp delete mode 100644 docs/media/menu-worlds.png delete mode 100644 docs/media/menu-worlds.webp delete mode 100644 website/public/media/menu-options-800.webp delete mode 100644 website/public/media/menu-options.webp delete mode 100644 website/public/media/menu-pause-800.webp delete mode 100644 website/public/media/menu-pause.webp delete mode 100644 website/public/media/menu-title-800.webp delete mode 100644 website/public/media/menu-title.webp delete mode 100644 website/public/media/menu-worlds-800.webp delete mode 100644 website/public/media/menu-worlds.webp diff --git a/.github/workflows/launcher.yml b/.github/workflows/launcher.yml index 79ea852fb..3346e1986 100644 --- a/.github/workflows/launcher.yml +++ b/.github/workflows/launcher.yml @@ -188,9 +188,6 @@ jobs: retry "$launcher" install latest "$launcher" versions --installed "$launcher" links --json - "$launcher" menu-style classic - grep -qx 'menuStyle:classic' "$HORIZON_HOME/horizon.txt" - "$launcher" menu-style horizon clients=("$HORIZON_LAUNCHER_HOME"/versions/v*/horizon-client*) client="${clients[0]}" echo "installed client: $client" diff --git a/README.md b/README.md index 72b6a3496..ee71a0fae 100644 --- a/README.md +++ b/README.md @@ -46,7 +46,7 @@ The [documentation](https://playhorizon.dev/docs/) covers each of these. - **The game:** singleplayer with vanilla's world generation, mobs, villagers, raids, redstone, every command, the HUD and the recipe book, on saves in vanilla's format. Worlds from 1.8 to 26.2 are upgraded as vanilla does. [Status table](#project-status). - **Horizon's own extras:** new menus (vanilla's are one setting away), graphics presets, distant terrain up to 1024 chunks, controller support, optional zoom, minimap and more, all off by default where they would change the vanilla look. See [Settings](https://playhorizon.dev/docs/settings). - **Resource packs, shader packs and data packs:** resource packs work, Java shader packs run their full-screen effects (experimental), and data packs load functions, predicates and item modifiers. -- **Playing with others:** invite friends from the pause menu with a code, Open to LAN, and joining offline-mode servers. Horizon cannot sign in to a Microsoft account yet, so it cannot join servers that check accounts. See [Multiplayer](https://playhorizon.dev/docs/multiplayer). +- **Playing with others:** invite friends from the pause menu's Friends button with a code, Open to LAN, and joining offline-mode servers. Horizon cannot sign in to a Microsoft account yet, so it cannot join servers that check accounts. See [Multiplayer](https://playhorizon.dev/docs/multiplayer). - **Mods:** Horizon has its own mod system (Rust compiled to WebAssembly). Java mod jars do not run. See [Mods and data packs](https://playhorizon.dev/docs/mods). Screenshots, captured in the Rust client itself with vanilla assets and no mods or shaders: @@ -56,7 +56,7 @@ Screenshots, captured in the Rust client itself with vanilla assets and no mods Sunset over a savanna river valley and a plains village - Horizon's title screen over a veiled snowy landscape + Survival at dusk: a zombie walks up, with the hotbar, health, hunger and experience The Video settings in their Simple view: a preset, render distance, field of view, framerate, VSync and GUI scale, each with what it costs diff --git a/crates/horizon-client/src/friends_screen.rs b/crates/horizon-client/src/friends_screen.rs new file mode 100644 index 000000000..82dbbb995 --- /dev/null +++ b/crates/horizon-client/src/friends_screen.rs @@ -0,0 +1,275 @@ +//! Play with Friends: Horizon's own sharing of the open world behind an +//! invite code (`game/friends.rs`). The pause menu's Friends button, the icon +//! vanilla's PauseScreen already has, opens it. It is drawn the way a mod adds +//! a screen to vanilla: the menu background, a centred title and text, +//! vanilla's buttons and Done in the footer. +use crate::{ + hud::{HudAtlas, HudBatch, rgba}, + multiplayer::wrap, + text::Text, + ui, +}; + +pub const TITLE: &str = "Play with Friends"; +/// What the screen shows (game/friends.rs fills it). +#[derive(Clone, Debug, Default)] +pub struct FriendsView { + /// A singleplayer world (not a server): sharing is offered. + pub shown: bool, + pub sharing: bool, + pub code: Option, + /// Who can join and what to do when friends on the internet can't (or, + /// before the code, what the game is doing). + pub status: String, + /// Friends on the internet can reach the host. + pub reachable: bool, + /// Where the troubleshooting is, when they can't. + pub help: Option, + /// The players in the world besides the host. + pub guests: Vec, + pub notice: Option, + /// The code was just copied. + pub copied: bool, +} + +/// A button's action. +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub enum Action { + Share, + Copy, + Stop, + Done, +} + +fn grey() -> u32 { + rgba(160, 160, 160, 255) +} +const WHITE: u32 = u32::MAX; +const HINT: &str = "Friends paste the code after the title screen's Friends button, in Direct Connection, or on the launcher's Play page."; + +struct Button { + x: f32, + y: f32, + w: f32, + label: &'static str, + action: Action, + active: bool, +} + +/// The centred lines (text, colour, y) and the buttons. +fn layout( + atlas: &HudAtlas, + (w, h): (f32, f32), + view: &FriendsView, +) -> (Vec<(String, u32, f32)>, Vec - - -
The launcher's Play page: the version, Client and Server, the version picker and Play, the prepared resources and the Minecraft folder as a numbered list
-
Horizon's title screen: the mark and the pages on the left, the Horizon title, Singleplayer and Multiplayer, the last world played and the faint wordmark, over a veiled snowy landscape
-
The Singleplayer page: the worlds as a numbered list with their dates and game modes, and Create world and Play
The Video settings in their Simple view: a preset, render distance, field of view, framerate, VSync and GUI scale, each with what it costs
-
The pause screen of a world, with Back to game, Open to LAN and Save and quit
-

The launcher, and Horizon's own menus in the game. The launcher opens them, or vanilla's.

+

The launcher, and Horizon's graphics settings in the game: vanilla's menus, with Horizon's pages added the way mods add theirs.

From 954bb6a1fadca982bb3d9d636dfb5bc9a44a49a2 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 21:06:18 +0200 Subject: [PATCH 055/126] Play with Friends: the pause icon takes controller focus, help moves to a Troubleshooting button The pause menu's Friends icon is recorded as a widget, so a controller reaches it and the control socket names it. The sharing screen's long help URL ran off the screen: a Troubleshooting... button beside Done opens it, and the hint drops out when it would reach the footer. The graphics docs say what the two Horizon screens hold (vanilla's own settings stay on Video Settings). Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/friends_screen.rs | 60 +++++++++++++++------ crates/horizon-client/src/game/friends.rs | 6 +++ crates/horizon-client/src/game/screens.rs | 9 ++++ docs/graphics.md | 10 ++-- docs/play-with-friends.md | 3 +- website/docs/settings.md | 8 +-- 6 files changed, 72 insertions(+), 24 deletions(-) diff --git a/crates/horizon-client/src/friends_screen.rs b/crates/horizon-client/src/friends_screen.rs index 82dbbb995..7577e2add 100644 --- a/crates/horizon-client/src/friends_screen.rs +++ b/crates/horizon-client/src/friends_screen.rs @@ -38,6 +38,8 @@ pub enum Action { Share, Copy, Stop, + /// Open the troubleshooting page. + Help, Done, } @@ -108,9 +110,6 @@ fn layout( // for something) when only the LAN and VPNs can. let tint = if view.reachable { grey() } else { WHITE }; add(&mut lines, &view.status, tint, &mut y); - if let Some(help) = &view.help { - add(&mut lines, &format!("Help: {help}"), grey(), &mut y); - } y += 4.0; } let here = if view.guests.is_empty() { @@ -122,7 +121,10 @@ fn layout( if let Some(notice) = &view.notice { add(&mut lines, notice, WHITE, &mut y); } - add(&mut lines, HINT, grey(), &mut y); + // Where friends paste the code, while it fits above the footer. + if y + 10.0 * wrap(HINT, width, atlas).len() as f32 <= h - 33.0 { + add(&mut lines, HINT, grey(), &mut y); + } } else { add( &mut lines, @@ -141,15 +143,35 @@ fn layout( active: view.shown, }); } - // HeaderAndFooterLayout's footer: Done. - buttons.push(Button { - x: cx - 100.0, - y: h - 27.0, - w: 200.0, - label: "gui.done", - action: Action::Done, - active: true, - }); + // HeaderAndFooterLayout's footer: Done, beside Troubleshooting when + // friends on the internet can't reach the host. + if view.sharing && view.help.is_some() { + buttons.push(Button { + x: cx - 154.0, + y: h - 27.0, + w: 150.0, + label: "Troubleshooting...", + action: Action::Help, + active: true, + }); + buttons.push(Button { + x: cx + 4.0, + y: h - 27.0, + w: 150.0, + label: "gui.done", + action: Action::Done, + active: true, + }); + } else { + buttons.push(Button { + x: cx - 100.0, + y: h - 27.0, + w: 200.0, + label: "gui.done", + action: Action::Done, + active: true, + }); + } (lines, buttons) } /// The code's groups packed into lines of at most `width`. @@ -251,11 +273,17 @@ mod tests { let copy = buttons.iter().find(|b| b.action == Action::Copy).unwrap(); assert!(!copy.active, "nothing to copy before the code"); let with_code = FriendsView { - code: Some("ABCD-EFGH-IJKL".into()), + code: Some("0B33K-Q405Q-1Z5CV-X6NHY-R12N0-VK8T1-60N00-RA134-952PE-1HA08-910P0-K5M01-ST1NB-JDTB6-K4W1P-0".into()), + status: "Friends on your network or VPN can join. For friends on the internet: turn on UPnP on your router, or forward TCP port 25580 to 10.0.0.2, or use a relay, or a VPN such as Tailscale or ZeroTier (the code already holds your VPN address).".into(), + help: Some("https://example.invalid/help".into()), ..sharing }; - let (_, buttons) = layout(&atlas, size, &with_code); - for action in [Action::Copy, Action::Stop, Action::Done] { + let (lines, buttons) = layout(&atlas, size, &with_code); + assert!( + lines.iter().all(|(_, _, y)| y + 9.0 <= size.1 - 27.0), + "the text stays above the footer" + ); + for action in [Action::Copy, Action::Stop, Action::Help, Action::Done] { let b = buttons.iter().find(|b| b.action == action).unwrap(); assert_eq!( click(&atlas, size, (b.x + 1.0, b.y + 1.0), &with_code), diff --git a/crates/horizon-client/src/game/friends.rs b/crates/horizon-client/src/game/friends.rs index 35f7c6fea..5cffcadd3 100644 --- a/crates/horizon-client/src/game/friends.rs +++ b/crates/horizon-client/src/game/friends.rs @@ -198,6 +198,12 @@ impl Game<'_> { } Action::Copy => self.friends_copy(), Action::Stop => self.friends_stop(), + // The system browser, as the Shader Packs page opens its folder. + Action::Help => { + if let Some(url) = &view.help { + super::packs::open_folder(std::path::Path::new(url)); + } + } Action::Done => self.screen = super::Screen::Paused, } } diff --git a/crates/horizon-client/src/game/screens.rs b/crates/horizon-client/src/game/screens.rs index 17d3b119b..7f09251bf 100644 --- a/crates/horizon-client/src/game/screens.rs +++ b/crates/horizon-client/src/game/screens.rs @@ -105,6 +105,15 @@ impl Game<'_> { for (i, (x, y, sprite)) in pause_icons(w, h).into_iter().enumerate() { let active = i == FRIENDS_ICON && friends; let hover = ui::hovered(self.cursor, x, y, 20.0, 20.0); + // The icon has no label: name it for controller focus and the + // control socket's widget tree. + if i == FRIENDS_ICON { + horizon_client::widgets::record( + horizon_client::friends_screen::TITLE, + [x, y, 20.0, 20.0], + active, + ); + } ui::button( batch, atlas, diff --git a/docs/graphics.md b/docs/graphics.md index 6a7e671ad..7629ad47d 100644 --- a/docs/graphics.md +++ b/docs/graphics.md @@ -4,13 +4,15 @@ 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...**: -- **Graphics** (Simple): a preset (Performance, Balanced, Quality, Ultra or Custom), render distance, LOD distance, FOV, max framerate, VSync and GUI scale. -- **Advanced Graphics**: 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. + +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. -![Simple](media/settings-simple.png) -![Advanced](media/settings-advanced.png) +![Video Settings, with Horizon's buttons at the top](media/settings-simple.png) +![Advanced Graphics](media/settings-advanced.png) | Group | Setting | Stored in | | --- | --- | --- | diff --git a/docs/play-with-friends.md b/docs/play-with-friends.md index c788aa27c..2a318c972 100644 --- a/docs/play-with-friends.md +++ b/docs/play-with-friends.md @@ -61,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 | | --- | --- | diff --git a/website/docs/settings.md b/website/docs/settings.md index fae69e015..e1860cd4a 100644 --- a/website/docs/settings.md +++ b/website/docs/settings.md @@ -4,14 +4,16 @@ Horizon plays like vanilla out of the box. This page covers the settings that ar The game's menus are vanilla's. Horizon adds its own settings to vanilla's **Options** screen the way mods do: **Horizon Settings...** and **Mods...** take the last two buttons of the grid. **Horizon Settings** opens Graphics, Advanced Graphics, Shader Packs, Controller Settings, Extras and Mods, each a screen of vanilla's buttons and sliders. The graphics and shader pack buttons are also at the top of **Video Settings**, and Controller Settings at the bottom of **Controls**. -![Horizon's Graphics settings](/media/settings-800.webp) +![Video Settings, with Horizon's graphics buttons at the top](/media/settings-800.webp) ## Graphics: presets, Simple and Advanced **Options, Video Settings** starts with **Horizon Graphics...** and **Advanced Graphics...** (also in **Options, Horizon Settings**). -- **Horizon Graphics** has a preset (Performance, Balanced, Quality, Ultra or Custom), render distance, LOD distance, field of view, maximum frame rate, VSync and GUI scale. -- **Advanced Graphics** has every setting, in groups: Rendering, Quality, Display, Preferences, Performance and Overlay. +- **Horizon Graphics** has a preset (Performance, Balanced, Quality, Ultra or Custom) and LOD distance. +- **Advanced Graphics** has every Horizon setting, in groups: Rendering, Quality, Display, Preferences, Performance and Overlay. + +Vanilla's own settings (render distance, field of view, frame rate, VSync, GUI scale and the rest) stay on Video Settings, where vanilla has them. Every row has a one-line description and its cost in frame time: none, low, medium or high. Changes apply at once, except worker threads, which apply at the next start. A preset sets the quality settings together, and changing one of them turns the preset into **Custom**. From fc8643b3801ff540a1d25c9b1642566594f2be2e Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 21:06:50 +0200 Subject: [PATCH 056/126] Docs: settings screenshots show the vanilla Video Settings and Advanced Graphics screens Captured on the Mac mini with the game's offscreen capture (1280x720), replacing the Horizon menu style's Video page. Co-Authored-By: Claude Opus 5.5 --- README.md | 2 +- docs/media/settings-advanced.png | Bin 1049503 -> 295565 bytes docs/media/settings-simple.png | Bin 582624 -> 223295 bytes docs/media/settings.webp | Bin 37908 -> 78306 bytes website/LEGAL.md | 4 ++-- website/public/media/settings-800.webp | Bin 16856 -> 34446 bytes website/public/media/settings.webp | Bin 37908 -> 69066 bytes website/src/index.html | 2 +- 8 files changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index ee71a0fae..4abb52b86 100644 --- a/README.md +++ b/README.md @@ -57,7 +57,7 @@ Screenshots, captured in the Rust client itself with vanilla assets and no mods Survival at dusk: a zombie walks up, with the hotbar, health, hunger and experience - The Video settings in their Simple view: a preset, render distance, field of view, framerate, VSync and GUI scale, each with what it costs + Vanilla's Video Settings screen with Horizon's own buttons at the top: Horizon Graphics, Advanced Graphics and Shader Packs A plains village among savanna hills, with farms, villagers and an iron golem diff --git a/docs/media/settings-advanced.png b/docs/media/settings-advanced.png index cf34e61e0f3918f702f0d6d89c0700ac34278df9..c6d4f90e922c18bb5d95c175ce8682762f3c961b 100644 GIT binary patch literal 295565 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 z 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ðgF}&YaI=E`a#z;vL*`hTJEvny&`dHXi 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�Fl8@?@S7Z9ACrigoDR=@Th8SqB-c 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

xaDcPHowD0F1h(+d%s-&1 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 literal 1049503 zcmYhiWn5dq);&z2Xp38MclT0?ySsbw;;tdM7I$}Vao6JR65QS018;io`}}`*KIB7k zPG(MK&Dv|Py%VmaAc>5Gj|2q;g)A*4rUC^8CjkCWExz*Ol92Iu^ zYgkI-S4x>_;?wilTmspAG1jJRME|0siG;M+1u0`f<5X)A2a+?HQ3CPKyMqbOwI2zw z+)iUvlppN<8QK8|s`YvV;^9x86BYx6wFpdlLA<+Fu1geCp#L1l!9N41~o+()LEp47VeVg4&BCOe5H+=6u=`>*EW7#P@$UCKZ zh{BD*a$SW#uz^O!Yka9?7MNG2B_F)@vUS5V6^m1}i?))h9hP+20rj%5ASG)4Wp8P0 z1GTdiSw;9dMcOBAeye1>3(GtRy@9QAIx4M8ny2l>A}p3mqg2lS+#Pm7(W|!J8f#so z?2<)A1ISgBou(tgbP3 z(u<|r=89s;=gn;OK&`E11^i{Pu%-E+?!UoxW}x56%{Xq(pZF&$kc}Vp+|qMd$E`{= zhjs)k5mTuZMm}g(w~U8jDsh$?RUhagVUa>XZAu;K0_P=FZA`gj=`W?B!38C}W2(WI z?HYR@%XBzYGSwKEiYnDrClg_9(ZNT$!}Ohqk%^$ExMMn1-G)MUr1D(80RNX?c(2^0 zJ~k&Rb$Bbu5eS3A5o~`xEHmAs0%?WHKa`#eaTK<6@y-!;tEd%oZ?-SYhLJO%O!gSR z{CTM-3C_UEx_XP8?}E z{p#egwJvORrI^k)zjgTxS536?%UN67+x=CIxc&2)8A4MfE*uGO<6)(y+(*CyqN`l@ zj0RUU!1@|$Q{CDG+>LBpB979mg7_ABmM`NaO(h5enr)4iSB@xmM9W%r|%_ zD8J}a@CW@T$1yxM88Ks|C9TeetfE%)c*`cfgCR+VP@l9v0$Fadfj(j>TS)(@qO(Ce_X z_z{0^%!2*zTD6t1*A8o?BZEa^dV3wIdb#}e?m{w|?24L_96mpcP4F0q8`pj<3ZLBu zVS-QwoIfBS52*Dg%!$vRgYx@VQF1q@RjDQ?1>l9!O+Ar0D}5RZ)4{R#heEVM>1?l8 ze$HF9sH6rvnt>qk&A z(5(oE5K@4}0QkMee&oOKb@aW+$V&d!7bS9s@A)EBq=@vw+xrSyZ6L=%4 zulZ=N8{&E~y@#D7KzpUnjwtVz?F(0*VY=#_FSvZahk~B{(ImEdkliJy6PEly^DomC z!L(qm{eW`TU^9lDuc#g%1i{;UH^4Q!tp$^u=j3roEH1%8nS$^KsDzEXijF0)3a&PG z?wsl&-k|`rCKx(MZ{je5cJ0_AeZ0j{^0}EAu&>G)M-{c=f!az9cgwV+!wjm)or#rh zv=Rs<_#{EDTK#A8?g5n+5_L&qBwo;!*r4y!q}U$S^!*uvlGp99_1+_B(;3Asv#g<@ z5I%bcc3nxYer)oC@!l(H?jm13c~mpfO)8So&P)1v*(t)tg}86DXYyP&MYt(?mE{_&@>B51U^@0QGWmSu;}sI$aSP>-7eT6qWtnLi%_|9pLY8Orh-n;C-^`zMizSqI|g`ujdSlWr=(4e4Io5v1#hNUgeFIzd~xfknl= zZ~Zs--TI>*(;h0~5dut+hT&l;i!V#+x>Rm~g;J0h{ZhnHgi{H_A=6ypIe~ZJgawO@ z!?3B9yQ@xL80D=0Mw|wUtiC|02GcJ21dG`;8VB@4JMjiRu z`gF2KxemTjpdK^|^iEEbwgYw%Xz=1P_+oy2);xeB79pSEYjn6XHg6EWxL!SfTGW)3 z*iu+r{*JV(OFiFA@B90~(aGp9r`K^$IO}ALk^tB4v&r@RkL!X>Wz;PlRNWFj1zkx^ z!8Fe39m?^w4zWfuy|0F>FDtB34BhKOGSp6tRd+4RQwP+B$|7HX=ON3?K!C~>CFE3%Fz(y38M_%bqq4H}IqVeNuX#hUi z=)Mc8qw=VFr0tsxTgP)*z=@V#eFRZxblZ9(wf(tyXTF1Xf_#YVQoy|-1-Hyh`qtON z-uV1=^*Zxrl?4!CBv!!K<@kG-H zzX&?#WaJrIo}yk7p-8+as-F_J^`yDHF$Y)pj?2T2v9EwX7wQ8P)Rc{Vslq(HGl7~9 z?q(hXLey;r9aq_UdV|>^K~oW}611I^Kf9l69O`np-~Qvix3kaA;z2f3#GAZ66p{Q? zGd91OD0XGqs%ju|0usNc;es7T88faD6Ozb=duI9BEe3HJK^zib=t{|N^N8zrvV*FEFfzfv#*B43k|-s>+aVy}t^+guX|NITcZH@JRv_;~i#*m-Ox&EJF>L>x-iq^d z>ce`FluZ}um}UE2z)JjBgJj)kT5FZwsIhbwVLa|nD*`e(YnUBSsRLsuS5^C@yyxq* z^RJVX@R_qWCE1^D?Fb}-8h5;$K4TO2rL+}cHVt$Wm2>-i2cG?$=BtCcyOuk>788gD z${68aoZ}c)zHFH2>A2tjR%;9d!sCySla!#35WP!rTCy{Ght811W&XAgz znB0Znp))O5+6O&x{?LT-CBo6ZK#F!HKTxiR!P z7~%*}q@GtlujP*ujo9E&Smy=CapY2psmeO8d{l@yA3SF%?|QdYWp+;B8E`&_lG`B9 zsMupg%dm%+l|ew28)3=JgRpu?k9sS;r;^-hRfZ2E_fZ4WsGt~j`_;>7-NNvN4N40w zWReMG1IB9Hm25KmkbOF+xPabKuQjo(WpTO5{~*mP{j#O&_<8s?zC|)G9qdt|B(Csj zfrX1H>ULXg$eRu#kNwI&c$4SW{9R<8MMvKCgcnxjnT&3GDrZT-19w3i+Dmhj`(`ng$95uPF+~i2>Oc7LEA(k9MXLzsL1w_Fv+L7go&8)=vBjVL_#iNG%qGG zbt1Kco9O}cxp$efi7*bRBXj7T;zCJo@ICAEhA+;(!FW?R<6=lvumz{NVcGTZ4$iXv zKEGkjKs_y3@B4Ei)0Nr|E$^SHMTUdPz3r;gCArg1y60@pgkV{NWM2?9vv%7TUBM9E zMAK|TrTBK!>4A2plRPVfq-37FwVzHsGAnDQ6dOBBgF(XvUbHLc8iahDm~K^&RHM5Mm;RD$N88w9Qspdk=30IDLlX>$zAoNwkx>Iscdr7;JC6 z-OM!K*_uv->G?x{^h2WB$v-*~yv6IcbK3Dd{I5)0l+}+d%l@MXro_$xsP%MvpkB!jAu*(P91}MG+SN zs@T+9VYq9(wE1kF+d6)kuira1DaL(|AZ08P$E;A~0Dd84An<)#$PDVALe`EuhD*6M zMOINxK3Kykx3QLVlB8wg!k_IJW?c1I0--K1`ImyCeXudb8VPg3cZ4--nwRWGZ+?CQ+EMX54` z`z!V}Qo8mL;q2VP_*ZNqj()WnPEG*Y?;6HOE{E`p#3betQvC0-zjlXzbeew}8P!U$ z?mH5-ee)mGI1e=Gq?3D4DlZ(i?K2>VcMCo(Opp6ZwsE5Dzg7nD&LlwcKQB3me< z{#D|b4n3&uCqE;dU(abq04s_$d33om!ynCWd%ZgM%X@3-rN4F;ykHqjK1NtoGpA_( zI?As^!i0(6vXZzZA@`Ymf48Q?-5#?)dZ8fEVJeQd#DP?5RS zF|7GP66>;Mt)YGCC2D0MUe~kZxi>R|Eb-<0NzBs6WGdvA3>jypI%PK1g}d@AtB7kj zqBe<}kgWmcf1DHH-@&8%=g>Wb0cV4mRzb6po_ml??N5DT=jL2pe6i2`y{t2Vk`?X> zQfCY&pUB#miX^1+(6*n&*A7f3JN6gsWr^_oXdf?HFdp5Jn+V6vo4FoBcOtZ_ksO(D zd==T_koWR%k&7}d8LuP#b@lIH{vk`8oRP;0Em^|TSNaOW^urgJ`IwVPKQn51M+U2| zwtOI3W4&R8z@6=I*P+g_U5IQ4Lwi&J&ZKh!bKg^zlLEg7)gF^mWc0>^3AhhOqu}#uUDLg;Du&$n&P*(xjrK$5UifB`<6htN{ z(_#CkqjqeDIR_>+1v69uVZP|dWlU@lS()*uQ1)L*zK6hYNG6k@C==#J4YP!>8q$YR z$JdR7P@C@SH12LAtcYLJ$}4|#II2C@+0}ibyEWmI>Pz@oLS`062E>ANxspo5bTC7I-h+z4yF)h&NAKs?DW{ z6H*A0$o^rgW?}Ty&E{;8X! zNxDIr*8bT_?uuwdsfaCT=Ocn8vB&QfC{Au)!LIZWb3QZr`XBNtj613*T&-b0VVXWe zK|wKn0J(FNk1MKANs@GbmL==Edn%BA?mfsWO>1A!vziR_4<(q|YPPK3JTit8EEGzD zhG5tX>fsj>wZlQsP^HZdEKGxE?De?Z#iM+Jx)V!I4Kf#l zrPoW3=d^!Nr=M3@XFnEfm(pFA@zipkm)w$+fQ2r?vy>C-d7!MeOpHlDKk;yR5LIt9K=TWmr3-l~c`jpQMz!t&HzPY|=cjbyX>cB)( z12246ftw8aR>Z)K_(t?g)hAJes;W=?yEU=d}XpkIWLUo?gR@Vbae`=u>;57YsGNjA)W#XCEyf!9^4iah%ajp9i=jNo=-;MG{`9> zKRq60sbdjTQGm{1=gvXW#Zp{3@@%@jZVbpK(!(Y)cq1LrGB6P!R-h4+068bUue zAnXx{6(JsZ_tW+!rjQBXZA&&DNCM2UOQ4Q6x=1?S!9WF&zB_+|?MeumvH{$#e0k`W4i1S^r zJR0eYVZAZOBBXMf(>uUp584k$&!41D@ep-#(;DIijzS(RrGI00HtNvK?>u!@#RNoUb85L8Zfb41E@% z;&0L%zd(xfY0-X1!AN#^W&O?U^IY*6eB5@S#MC?4(86HurEb&h$7A(eKk~9{RjGcs zh(iqABlk!vFWM%vguAm=Sc_A1CbWa{8xeLnTb?&(j7pCn0Ut_oS}!oRg6~(X2BV3n zKt<5oTcIRHW~0e7Z5v=_q+xsCn+&a|>y6vT9mPbwwu5Z%L;ed-7XIs@-rJ-qAMqUF zzveOrFom!i#Ea?=)&=`33<20!@tuI@+2CbbZOWBwqum2t5ejt#K(l~>lW)Iqt4nb4 zr(kAnu;xDPoLkwH9UcbLkJK{C1KHRyRcX^JaTgUlUUcJmY<=ALlN~wO;H(y4J zBaAW(jh%q~DyGaT$QBnlh`a|Abj3&7AA}P!T`sWVV^R2N3^zV}Z>mJW4Fnq(v*s)K zjuP@)FG|=Gn`c{o^7YX_h~Vb>XU~v)2wh4n828Dek#!HdRns_;@Au&f%;pmfhwKAu+`jjPeaMM8^W+TGgTMZHT!1;B?mT z$#T8@>Gt(z(mIJGzQg-rMwW%C81_@8Dsb}q4QKFX1Vd%+a6-wKstw>f_!t!eIiwQg z42K7Dmal?u+8}zgs%@mfOX}j9P`R+5`v=pDy=@~Qg~^+)2${x9D~m-?(vG9;>(m(K zl}QGQxHF&s{?sM)8P#RFb73mUv7>gmFS8o){(18pz4jiX3~PO9BHwnxD8-WO*&{Cw*1JZ?n@N>a4&I z)PRKK6lwq0?S=+CCEF8dC@3|2Gr21!I8(iLAp8}e}FQ~Z}J_mgC(S?dRopVk0hDmQj zaTHXwe6Gi07899l$@0&vcQ8R~DKl6VR!vcR&Ax|~N78%NKSk(2C zq-dqKifFuBT4b@vdHJP(a1ED9T9(}a5ff^ZIIvQ)-@)TKf`S?<^{Nq}$OPP4J2LP` z4Gj%4{tkOdn$v-(0}_{FjoYipL@|=QT}mG6UwGlp&(BXw3S4h#X-L#eHCSst4+38$%gf60ye~SM3gr^0 z6^j+$drQhBW6sN8IV>jf_eN8uyL{emM*O|mOeA88t9;J{P4-5cj!=P*{2d2t7kLkz z4;^z=hCo++dRKwFGQ}BHMSk^ojb{qan~aNSY)(n5<2kyyKe`WE3rJp&0B4XZXT|mv zRr!G}iX=5D=F+Dj)cQfolI6-2KN9EAm9iUoK2g7#UDgXc>c&5H8n-02dcO~5+={{L z4(nbi<6P#mNE8>Rb0{Ltyp**jdTRW(n9pi#YTv$_zR*C5 z&XV4w5(CCzx2GL7UcsyXY#<5spyCh*8t~P8q|U%E0rGC1-+cm8fzI)=aW>MwQlIr4NEB3us^wkKX<4?W zwIy@6k*gAjL; zpiS>jmuh;pDP*puisdu3!mo&r7i$8Yw3w5qn%2EOt+}n7-73D{D%Lpdu!FBty3{-Y z;1k1=_vfnjd|U&q-*U!)`?{PwNfH1jjcoS*<1URLHiJ%O;Y1eSEJe(B6_sp6OzNqJ zt_Ofl{UM&$D8G9}^?i-gK5o||Hh={M__DH5p2!k^G+Qz&c>&haGti!BoNH3Fe|`q~ zW-Zs-${Id`fa)+12zt5e#iW)0j>KhQ{@UR5ux6jv^*Y*>FZfain$8mqwOp(=c6kR2 zmf&#|500c{>zI9lloQQGBKTuYdxeWS8gOi?XvA04zLDJ*5L9dg-@xv>D!G2t+~)l8 zZAvUi2Y$q1hknpQfq}+@1Ge>{^_XXL&ssE~>`% zki3bUMR8JNSq<~So8SfAdSFP)A5`b zj_0yy_V;0*PCZhK_cxf^m5n#*H}{-I!aurA8ZtP;f`IcJr>z4Py~J}n5qHHmeZIwmy%xC5 zL!G|f8%??vCC}>LaNlsBKWMaFL4%|*lI3;@vRXYi?<0OSmI1eohYX2o@^lz)5at3F z*GKuw+ofM82S+fVLFEQfXBLqEH8i2X->RDaghN{~hh_F<+p~z!#812kSx=F^*%I=5 z=zKNP^c$MRj(0xrK#KiT6F`D(c-Y3|jY+b*-*<>F7^) zhZAl~1i^6&e{@SaM-#|$Ugu~&%}AS#Lge23!S5$#=^Oz-qDmp~{SEdCc#~mRaUV-# z2w7iHkung--GjR5^d_N@sM#JaoFvQpKpbzHSZA|Z3u&A%nZ-JZLb$aU=M-A<8Py3- zr2SgTKB54c4ICxmY9|PZhJ{xw4VWl<#chFDHvNJGZkrZ(>j1t(2=n>49=hzd}X2 zk$%!6iNOQ*^ehE}hbFQKMw9cZh`ewO2?EeV6JppZrUE5A!qJHDuqr7;s$p@dwnl2| zTR_%PQ5-R+OP|bBnbVC5XOcv56Rh>R|AZo`Ix=57;n1Z=B`A2@`;)Z=Obx{@SSW-@ zodB$5f|^f)p; zEi$lR_juxP-dbS|WC-tG;a51gUTm^q{StusKG0-sm}b@-0}tBP(TDlE(7Tk~#l#}o z%(~Dvz{`@b5gQ9QKPKo4VIAS_cTd3>p$VM)&hv!qc!!+7n?SJN7{zF{I=UBeQhu^$ z(WfjWWk}ua6Id!1Vl-$+Ut%9CXYhOpA;)2Q&O*b_D7MR{F5J{58x0L94O=ImD$Vz3 z0-op@a>YMVImGe&-VZ-_P6Zu=zV9ZsPX43!x=Z!dL)DqqnV~4gvSG zNW)ihqVFED5ajq#2JKhrB^D6sXa`&kPW%pV{F6dv*PzbF#8g(9>!~b#0!Sc(ep82D zb<(ixpsyLuSV4oR11PANS_Yxo5?qLW8I0KI1iU=ESPTW53`Um&+gwj%tnj|Md}*-F zP+rXZ?kPe*V~t~dx!JvZl45N=3~MzYyHB@r1X%?J;M_UKgdytRLW=XJx#4W^G_NZ^ zI)e(gdDL~5Cln3z6UJ)8Y#j77FTb z-YHTn_~oGj$me$Y_uq;_pIy8mbHT}yC&8Vq+$1tl7b-?GYM1QyOXZNnD`b63Nza^5uM-t|IsJX7@P-(x08X!9_}e{91E!Q)X|(_2O+5W)WF z+*CzOb~Ad2{L2w|e`1*m6?_HF{id@LC9#f4KBXf}dhr%kQ`_>1?5P3Uzmg4onp^yY zl__O>RXv)6RmXYa;Ck7RV1TCIOszotDNQS%GrW2rf99iIkrZ~q+C$OdPkU61Vl6n% zGpreI{?RTZD$P+Rsvo~$7i#{NR!X&>*AhntRdq||1{y*mQ75!bTxX2uDJD=P$Mkhm z>gBgYDjpyN;KpPTS^O<(cCQT$G!l#VH_lNP?Y?WGfPTp7fM;s#&I-+)l65(Z?yE6x z$7^{JVEv;u(TN&Xx6gLNp3Fm!Gcqhsl>kSuRUPL5iF*;Aq{ zcdcJ{ttG2B_+xik-k`JDg`M$^HJtVZF;>&SGx+%UI8nMRjzUsrC;AJUO4fQTGWBfB zRE4Jf-9w4$z+~97e6&H}IJ~P_j}kol_h9((`FjcgOX7H4PHa zyJ`pGqE|F4b;<-#30Z{*N(?tTk2f?8e8XpEcqUF{4WF9=Sgq(!1>bK@j&EYgL=pZo z%cYWc7Gg%TUXg4IxBRDwB8G&~;;P2$aj2~ai=U!)IKtJ#IK#kY#tLC=biaKamjB$e zDY*pjlk$bAx@m}yVOO*ni_+^#T~K($;HjVerRDwYCCanGZmpb^)EAogs{^Tg2Ddz~ z$oo#tn-q6pzUl3ua$=t-D!*8r#dxuH-NDpD=X*!|2_(x7MJd#8*BPoiGtaCGsZ#{ws3w2FhwLX$jG=; z4I`B?MV~z+Ym#>UOH7#ANj6!}U`RPH$8{`Oe0)Ye?#Jt&agCKdPfqmVV+z=e>oH z`}Ik3QdCSePkk0;F7sfufqF1_+8AyHVu5Gi+p)t;x; zMnZblB|*vIR|jpsp;6J0-oF#O+0Be6uNb_L#!!BaBGfcOF7u`C*ANeNmR!LwAy3a{ zIMxHRk-=WO&bmoNU4sw@%?(lwJh(2h%1&XMFE{M{H15CTF-Ca8)SJl`r+K6#I!zFR zR3QmNCLmA@Ybqy}j-a?Mw$^8bAySm!SO^f|v|$)1{e29$M@vhbS_YkB`peE?fBi z13#N$3zOEu#vy%!kRgPKod*^7{bAMlHkif7|GedZ*y}`hL&M>0+`dznjt#={le3># z+Kt97wt9j&Z5FFnA2RGa)7Ed!AExYq4}8z(fDNYbF2D=--37ehBiZw@W>@*{``bg; zq&|s&Ptddb<)*LQvQ<7=hFW!~TL#K%gNO(4pC(opIB?J1{A5XJs$)-{B_l28a26*u1Qn;?cIWT>IY z*BcU}Z0O$(lowhCbs@pY{6`W%LE*zsL)hurnIh?G2mrq0nHm(hXS?%UY5Y^eZt``0 zZf;7m^BUVVzo!q9vQwlB0z1DkId1nMdc8dzB*hCq4?e!3b}DW_o+hz{R(xGL4UfZo z>iu={T_uK?KhZGipFWS=@inAVcssv%GsxN>Ck& zMkAbnoMxI7fvs8uaVdz5w(+H#0aF9G?Z1PrWQ;k_rJ17<8O;w4W4w#m{M8c`3e!Z} zulB8>WxZQ#s9S8u^HX=azrqFcXK|;!ry6HOZDm5wr==L}vqa4B4NFa|Pf7IfNJSp8 zx}GN(BTw-t2h0_-`|k<5M$Sa!1NCoYnwXQtZq6;E5P$z=Z`jY0%E;rN>i>xIU=X+6 zQpQQASuF7*vABI$WU(MIgWtQosO!L7&@*$@ekgF>u2tY37~)nfkoaXtU)9w%apI$f z<69iHZNy78cltZ|IGcYz507Rhv&>U_{1>C6gWc{b0FI0H=*@Bj|NJdXw4A@P$b?AO z*Z5Bcqhjg(!3;fWwckL`o~f=#T3t$>OE-=-n5qT>)YZRmp&Q%CR!hv}sjJ7XGK?65 zY#5wuD*S384Wkt{s$iSDu6=lWaMN_Lem(!KULQj&{q(#_gNQDGkJV&#MK3 z^a>y1%~qRhYOal0&z9;kxNR0wzX(=9J?-j^f)8a}t^SnQq2D^GvTm`RYx8 zsu5|q0JqV=gW1=Dn?$`I?KlWN6!Wkm04g}q5u>&y->Lg){hG55IK`6?XQ9xp{n3=+ zws)syegK*~uIR@4BA%J*$srTJ3R9U zu#-_mSD12@DuS21QXbnIb#;MMNObBgm8t!%R>`soSafbbKdESH;xg!PS9A@CWedgq z^O6725TnS;H2#035`=mJBd$LDhmQaI>AzPrq<@X4|2w8mE!XrWvfU4-^4>P0KbFT8 zM^L9IIr`$M=6HT>cg|kX~GZbPGv4}Sj`Qg z-_{wvE#s>`%zKf6DD#lc1q8=9)m>eZe)H2sJXqV-ewqK_09b( zG6bJpzAQjOR`&qU23&Iqk-ND;-cHSN|Gm92!tSH4(a8M1Jt9W3hn3#%LSp+5v&r|y zwOHp~dG`4Z;6cM23b*AS&fQ6Kn!oFRxkak{PJ+uzPlUr$-qL)39lz>Xgj1x?%J{77 znShBqP%)h>QGGn#a!~&IeIQT=6Xubl79^?^=AE%FnM_5Km%)R07AJecT0kNDp?A z@J;&8b11f((|X@Ur_P+;cDX%R50Bf0c07wOqq1ZFXZm+5=(DA^$^SHP{vSSauS>mP zhr-Y)=DQx&9@YXb*-QpRAdo6W^1V*TnT1I1Ln8Y&8jWKVb>n{}02be;ih4V+#Bz;^ zMfmYc=f!)Nfv*`|#|x2t(QpFIOp$EL;X&6U7kJAbe*P{`G-T@C_vU1-OjXkLjDqBa z@{d7Xa`P`dew8Bo`Ep3z^8XE`D76mg-J_Bm6<}1r;55zOq9f#wYQFAX>8G@qRFM}I^&XGYgEuqS)B@i3 zgdMNf3|A%Jo*!5M!gPY2;I)f`e0^SErHZfAa=n$Prao`X!Y+eQ#IcTE{dh*x%$a+q ze`WIz9KborJ6V-&{EK+%b{unA4jz%J-7p#RlOrXP#@oPEH$9R)VOquf<4K4VZJ4_t z!ui*2^rLO(u`>q{E%%#A>t=b)X`JY4ej>i=&+pEnzSR1^=vtPp@@tMKxhk+=^{g`o zH4LCTh64f@O@hnH-UhudQ%fz9dT7_NvHqg$^P@>ZRs>M|twSLPO7HA3{Za`K~7ovXoo?KB~ z+%5+=r0tUpq3axMHJTVjJDnyf{?>!|4MJH6ZEk1zYUC5|S8l*LDjd4b=U zu0sX+wGu(u0T=OR6=`u-NsEy``vKDJv9k@vi3UMk{nJMZAkgAZu`#{`TZ<7mN)tUCFK00 zzk=cDuBuHIkp129$B$P!RcdTn`Rk{xcd#0`h*jo)<`tTUhLxfquRa?pK~FFD(%Gmf z95;gW+F!ufTjwvw^kh>9e?`C*g5vpp#yhNdAw*0N6<*|+Mpi&lz)>pz2d1gdx zo~X^L+tvH>rJdc>mcjV~n<_5;pgnTj?%kV%r*8L&X(&}omC(CAr2OWb&Q0YRlk8o< zmCGpSP*zBjTh$ZOEX9C_1|4xDax@W~^8Op2cOB4ijuHL#k-TZJ?^(?FRc!Iv3D8;h z#8CYVKm7?bif}|jZfUTa8uO$>`%Wm(`5}`ZtOX!Egb%8)M1Vh=^C*5!$Lt} z_d)8niP8+xIqLw+!zr?X=GhYYBJMxBvomI+|FgAFN(c)7;1NtFuM*+JdEK1~!=n%vYbG=1 z-Jh+Xr$7vb*`AZC0`%U{=_TibMAUd(oGvk3W<4pnl}dfS)~gU$POmwsJI|Nsta{67 z=Xycr|7JP=g-+$>M@WXR_GJcDDj7nEUv`#Wfl|~8go^Jk<5jcX>vwLo%BrfO_AM__ zw*?n~jP=J5kgEQg*)lqVzPVhEh~d*UZmILZMBmoLiha=q@Im)>8MG=~qL5RpK*Tq* z0lY4_od>=^-yP4-rn{YE*B!OJ-ynOP@Y@%+(&qO{M$fo@sw}>Ez2G@K=jq7)A3Qr0 zd1gUfv4`LZkUYLs`xTcB){)WYf&)AprMMSP&2#jzd?;p{0vMQ|>MEU1MQN6}CtmAZ zmLlK;NinG{XQkgsb_SyJHo$NG0VmgegSzXl66rkl%ux_BUo!jd^BC5^Nb)jdIIZu# zF7fXecU~3&OCV2DcA2yKF8jQF@E&JAo@vKa^-7vVLINH#oVh1zJ6w+eMnHVYqDsPV zKB?^jV(<{}E zpbl60-oO{#ei5*tU2}Y4qOyX&y^zd#dr?$sYqUK&c?Wm7)EhjJ#mVGW0l;1A-t9MM z_IcJ-E%E<@;LU#xflz9s+Orxe;bdSxEDCJW75CFzlff9=AV`@h;{4?;W{&Rj)6zh$ zFwD_8PnR&D^ZlT!aMofXu}{0nE>I&{g6N5*eKKx-}JC=c-C}>zeYqjyFE4{elW*Fhv2{|Gv>R$@sF`XX_sRqfR>bf{6MyT29QYDj{j)OfqNvxCjm5|3 zrpsDd+p8{&A}fmSu->tV9B$Kg31X5{-qhl?RCL}unFL_EM{*}d3((c^n32wgY+uRF z7oDp!>rka^Sh!dK8($DV!pj@9`Vw6&=FF8f-h`Q>=idD*1rfva1jqvAVyV5TA+2 zbbDyp#O3ud+{+WwS>|6c{QriH(0^tcN#{D5@A{)NKQ)#%>$C-lq@J5!cNf7oxTWqF>yS2{jny1Z$GhdW^IW`H0@DV25c7lQ<7HmUB#pu{ zI7!NoG@e<%bt=~%=6|BGALS)J6Xb}}R#obWS9zZi9pB8+B^-v+f!8{J1imab7Lxh;cY^=C7s}$YB=@yAYy~{8G`$P?C)`%*x9%o&pI7br{5Be% zsk3ljZn38MpNzq%zzdty0B#>2MwwT<%o4vTsk{L7yNvc;pe$<@Qnb9ewSqr>gjJh1 zLGQ|{XU)4mTrzWtuh8)vVyragK*i|H`(Sg8$)O_ZcQIcR`h;TZY`Ss?QJ`%YxWHub zxhr>yQO=0XudM%nRK0anQ-AzFZX-yjlrTcN1f)9z=@=y)(j_3>peP{S-Q6JFLnHAjf?LG-VeSi2iMJZypYv$FVr?*2N+^8$LbzVK@4Z7JYl`Da=tVJzB*-JT|Ic}l`WHR@@r+VTY~`ZC zR?}v)+Q@BvKwYt?Pn1CllHfx6PYTtPb=w+SW+)Rz$9+hZN67+S(JD0HbsLb_eNOp* z&miFM|IQ!vE~uTw%`#0!wmWLQ%`IC&|KjdVSwMaoNYO0ezI5AJ4AY-(S<*NnCOdMA zh{E3oWtLD2yQTi;o#Y>=j%lu%=2r!ONw&?!%>PCVy=!TCA`)2b5k_`)d-Hq-yz$x- z1XW7rySU$anhZ+H{{yT~sZpZFzVQO6OG=yPZaG-vu7Vl74Rga7)-cE+E`^Jeo{BiC*#U^aHn{cy}B+K(3{N7O$ zp)p5mHeIlY+yH4*>^=`8vh^hTy6{tjvMZ=|Jlt)%aw39EZ%xy9K!Gmi4qQ4Ob= za&S0$ZW`@4Fboa-7Q^|FP}W2+x`x)kKjc-!?pDgLiS3o^$XFQ&4PLA1uB%Sq17o)K zac|jIK$L;k6f*`%2Vq{i*ppz?G<#_z>z{9{p#*{Jj5v5RV`L zMuz;CJFUUb3Dq>hG;~tD7v2kNr!Wb+8M;m<>0_Z>t>A^ss&~IvQ(P|>y?Wd&R@3dP z3-LhBW5LfzT}(MUF1WKq-4*?lRhLyFK?1Djmt`e64FCBg!T-5ZjFx}EE1{YJ^i`VK zdQX#sM&s z+L-WLSBMknTybw$olbhZG7*LW6dbuzZ(vk0^Y*ET)EUVsxix~AF?7~h2>oX}|CNWr z+;eWonTZ|dF^!N?)8y5xKMdpkForyD0OKj=$5?_P;d3L75DD^G!<{yb>hp49XKk1>)f40dvmcL0_ zkw9bA=9UKzxbB&%HOKO~h=VFAqAQTsUr7vo@$jhmzmqKg{6giw7Z$Yp4GXXE^4Mx} zu6}c?9eL;cTMgY1R(%Vt?;CB!YDo;*Kc*x8eJSkA@pOc*-|!DD@9$ZXPmQjbn$d4} z3LtM;lUC_sD-ds(n(x(G`cT&Y4{Q0(^_IOK?6YW^N?o7;G= z=n~-Q5Jb=sa}NnzJo()4&8fX`4opf`2H=o*rs@A8~dp_Wp|AjLE*1FvU*(Vaj)&#BvZVk`X&m?MiJ5NRl^adg-em0@czlGvY z&NwU_I~oU_?Mvj&G>}b}u*z*VFS^mGq;ZE8_Xh@E-rZ)ld2B0F->plOidv7R7Hb&! zo+j~H{C$n-jtP*;X#VuUbRw^9c(t!DLwYl69H<+$5&QotPY%i1$_}}J8P_n5DPm)4TKIk`@F`x~i zs7oQiT3-Y|Rr;_=W}ZEGJeP3kB!9&!*|Aah;r{O-c^S%boza5krDMkVR#yTCWGxTV+H_KdSuji}T`-`M+nLYi&pmPh4_pT% zBtiTJYywPp(c{sS?KUfTi2fsyGTs>RGoqU<=s9Tz_D_c^e0LvGVuHkQ+@QaPM(wkK)86P9$ny-nsyV47|j%0}jQx<{)BTrwC~vl2RqyE;e%fem#c@=Q(~*dVX4Y z2~!7_fu4N50z40#6W~@>{RAi0M;VJV;$JEW4`4qAVq|;e2iY=2EouC{PWI*!07r(5 z{Y*9I54sVPk#w%CvwfsVpvqm3Dh3@3O9yzWv2JNO+n)X?nBRx8-rp`3^*c-LI+gFq zs)juP6(GrDe|i6-Vjt&NL)m7#o*D-r@v*3l6bt!Aia4D;HQ-$x4tB$No{jxxS$_>l zHS+HM?`$WvFGPK-Bbs+^x99x(o%wOZuhsu}9M4I@Q-7^i<0+@na(xkFDq#L)$Sj`` zX5A?KE1T06Ml$v&xu7WHeH!kuC~z7Y66$8-Jnww`)Oab2=yjCs10^1hRyZ4e|N71l zkx-hQYJ{;T{IScALwc0$QOT>f;gr4VdKK_E87FrBrF7)|K$}gc$T+gKn3toV z#5Skw42ZfJE+F9`i<3wj}I$iGpd3pOKHrCiTid9wzv+&m*2cg zmv3u~ML=wm-YdMEa0ntKIP=MT^ZEm*s7;4RZXzkF^Wjirzqjn4>9Sg)*JtvW+#mJb zy9=C&Wjd?J(H^gbmf4O1aIg3+HSSOuFZqajQfCfWZ3u>eLJ|Loq`E@{ZwUSZ?tEn;K|- zLf4SxKiBhr*g}ixA9erVBX{oqAe#R^l}=ez76)jP($|PE{bomLKEAQ~dur@c)6?n> z`wVTLS17V10*wjj62%tYUj7~46`qe(Ro>R~DE7CnjtN&b6aXFP^A5x-|ExnbrR%g~ zb6>pSn{#by{BZUyP@?@Lidrh6>d=c2R{?*{_DK1Yz~mPtQ>LtV3vy}YGmGP)UA2%g ze|T-}sDnTg^$(%|a^39~bPMWFh^+CYfRI#S#?5WHzP2BTx5 zer%CkFQ<$LeNZvF~r^V$KJK+`6Y9|Bz{TI(?8_ zyN1amBx~CIK2r7F{5TzB=v5h3y|%D0ZCayPdRB{9l|{K-^OY#uxLV&|JW} z-v=tSUc;L{;-kIy3s1iP=Q$ zw)f`hci3H+CGM4StY;><>WrESr2w+eJ0SD(UzB;Tlre}!vJMt=ya_K$puYEIhsia3 zmm=}?f8P5`IbACD8{4z;rn3jr(?*QDCn`w;W&~JMX@x9}b0aXb*pV$Cj?P$knV;<#sN9eBxp9JbdO_|jGd;j0ox%O9uF)-(m|*st>WMlUeoGA9DfXj%a4XMpUv<;mw>rk4Rn)mmQi=ip&9SOk z+YeH9Qn7IzV~lTZtNqf#*qqZ3OT$)-#9NH`UwtKI`=U@JX$`SVM%-n*xs|av6UD-K z!+~rvq98cK9=m=iAcK=I!3i6I(Yw)4op`mHKoh_$A#IUHZPCAHz!>TDJSoXMu;m~8 z!d>YGcqao@|mq}^=E-2Hzq0{^Jt zJwo5t(9|S!ispxOa@>==jCC~}J?)pIpKWb^U-&ZO`~AIr#$peF7{lkWHYurbtb|0h z6UXGQjo6Z`N_Mdvdx(u^d_CVbhH`|){xB;cDB{u}8wGO(1P^s6#KxA-eb4?{&x z<2O0(JvpOUNzWLOh5RAsE;&JcR426SKr3!82-xm$w5%aw=XJ^hMSHyd{xpGy{M*hg zV#u&^NEwl5r&e4;jEYo(grcSESn4pR!&w|5; zF}3#9Iak*_mv~{!S`u;ft`8F6&tHr&J!{3_=03W^YU@zuV5&4a*f99bM{QvIk6`(H zdT3VBSnm{%a{`e2sTThiO#7=ojZqaCjgbTtfK?-ed4+@&qNo?J{5scR6VMdXN7ZNi zho<}YOQ^~I|BL{@Gm`amKd|52yZ4!49G3`rK;XR+urtO^H^P_q%=&}T&k_HpR-#Ne z;h?bwnYxxKZ}cN>6<&)6EM<4NVq5P`4R1YN#rYiSY%Q4^`yYbCh0vhp_hA@&3Tq6atdz|M2Zb5otzesG3<@!M2X zZSmx}N#V2gl^$V=0}%;zL=44e@8ceEKXrZ^w&6(pJ_0_^;c`dP zA0di?+mXv%d70`aglBUJp7U=`_$Oa~C-)vIx5((6)pw!l2R>H7aM#com-%U;A5yYc@85L=aI+MEm zWLAU{j>WZFKKj?3^xtD_?+Z{q_y0RaqU+Ls?H~j1xo=OTsb&hk!y=&K?FaFH0@4Kw z$@mn4@=W0DT=W`Lv&LA=cA?1uh~$WyxBU|}{;u?tH8pAX0SfAW4#}b1N}O20QW}5ep9C=g(?OVn$$x~ zy%aktQ64jDv_Yf;9tPb{YeU=nxq1n0CuA9%A2E@k|3uL}k@C9Qe5+^~jiu=w)EoDn z1-4-jnhVjx<<{$gG?<(oFblFJ-YF(n1;eW0VcI{l<~5qLHM6VsiEi>cH84L>Q;d9< zLa3|Qfya!=uepq~3XFVJtki#(J2Vke3pL8o>lO%eg|H{3gpxz8u`5PCOB)DZ;SDA$ zocrzBxr*l=;u4DUpR!M!a{Fb|h+Wg#09x92dj>r4_vEiA{>e9}Mj}3!PsV_*SN-t! z98-|8ruDFLPD)J86FCWDzzNK4JAiH7MY(=J2L!*dL{RY740MMH>{~<^JEePh~N}T6qzq~F{3{&MF*xGJ9Zm^>=9NQFb zu4c_+Hh)8IPXU!0d1dT#GA^gIs${945@pZ``1*->fg;5J9x$c3tX%7)SI z*R$iit{C2QUgrk@=_3uQQQ91xYW6&=OKR4HMo(2(6G-sfw=9%9cXV!T*91h#L1Mk> zY_T@rMaohJ8s8S{MMp{zEuBsg4;$)pPeeJWpwBHFn(^r_J$I)UKwI6r=M$UznsYZ0F(oql>keN#yki)D}oI@H#FE&i^!(KA7KcMk)d!!{{WU zh-bq_3Rqj;un3|BR)xzC0gP0@8F)FwTJ07Nu}5&E3%j%Wqa#eFU=(6Ly#9c*Tl-d~ zP_IhN_iO@)^=*$h1-MqeB2x-PlLo#6%v##8n5%;;4)@&|71Y&E1>0If!B(`0qfU65 zXXkF#KR*1yJzaSe?r)yEbtQb3M{LOuRa&k*j_Hn8ov})?$;86~KY$mJj1fm$EVr50 z^Rev7m?uW@8mn7DaniPHr8W$ZkQff*Hu)wko#AYm1faj^D&WFg*mVPU?u8?wAwW)X z!F*?3fmgy24lGtj&xz>u83&QAG8y>9B|uBI!qbGZ7^A7>Brec5ZX0`g+{y0~zZ3ac zUd=Iw^PA5TrN3meIk*}JZv(!vWDCZO(jcbN^}0L1Jz_S_+daPK3cS&z3dER_lJ;{b zRPoH9Lfc^re$W;*Q;n48?C7ZcqrXim76gi;!1MLjV z=%wXTG$TT8LzF3sT6zr{S(tOP@ve;+C#JRT{q!OPf^MGu_F)P1zg6v+FhfElYS|c94krkI!>vPi_to6 zhUOFj35w98c~q1Ag6!%3HqYij|HZhp?Zuzlld%NOvPQ^j|LcsElQ~!K%d4cQ1uBd# zc@B>EyShwZZG<1nkt$B&WSKk|4I1o}V5qDlF+hwKa5GiBwM@Lq5f>LgVmL2bH?YHg z=$PeQYDKmaq%bRB50zE$-X5A`Aq985^MV7^FV0#YbL|I`mPFB(@bQgX33_&t3LC7R z1vsCP<=62xv{%4m3+>yssLl=^hA}QUk=3;A<}d8^CV;F&?nuaf*LH||l0ZEKE^*Ol zAyd^qTS{MsZ{GnM)9mN-)0G26|6-)+wNWW=bb#S^&9ImMgG~ktu_q5YjN;75iZ2`; zG8D{Tnmy(3blTnmRW5230)SLLr+kk|a|A;HW-#burR)-n=v;sBG_ z_B}-_kE@0tPT`SygG&cK zHGkwi8^vN}3MJ2_I!RwUd&SE2mSe^nJ|W}tJqh`g-M5H}IBfIK$&qIp^x1!eoR4t# zCA<=Mc5ni{z^}w29osxq`*QA)OV~YK@;X({)cT)|{xt&-pOUBY*)lynJVgkkc9Zkj z(W|7s{i>QHUZonA8e6PuA?j_mCULuF4>L@D525kDyE#wkO~Hu*s#>H;IgJbNZV#O{ zeuHzwrMrN#nd!~l>UQJ443Tr3q{G15&A|1eBsAo->Taa(;k_?vxFBJzw01z56}Z_; z>B{G;)$jn&LW2Vo-v=|dxix4_!cwoH$pogSZn2V=N@MeOpSHuSeIuCk{>I%_JH+ES z{3_`zPB*O6@#cxJ*VbEyC}M5`(d$x;Vc?y=`?wuuM|8QI>ifLbjx}ug+}---x=oFB z;zY$fH7`yvMp_Pk5)+kCW}h<3`&qKCjDK9-*V~x$vB4Vp87yo;*C2JTR?d%n!9snj z$=z}-nXFO#{#QabfjK@< zs`Emd348s$hesv)V`Df?x~AhO+$EfYdZ!2(<+?d6w}^#DUYJ>`M5x#9dC1bzWZKgo ze<8hwC+n^Mo|QM?dhL#_Wv1GwKcH1~DK3iXIEk_DNUzbZNFx&9_P(`w?8^dR?)ANU z@6%X~5S2x2RwIRRbh2X+oSf>Wz-JZHpyw}#UE!0J+dQQ}!1-j0 z5IpwvAzA%bIyqb&XTZu<2B8)S$TSW|%(5FaZyqHTm&@W(s}hJGF)#i6Lr(tO$*j5D zmY59}fBYF|rxf72WM@%2*L8k-7(O@E6=*{2snek!(OYV*wU2Y+K{B6=TP7kINvI88sD24rcQ=8w!X!%qk zTf&+?ExZ^?Q!S9gFX#*r#`|%c!()zf8V$|=gnU>lwNq5YhO??nArZnDNlDqfKhffV zPhtoXcl&HO%5q{?Svp_mP=W&z_Ij<7!_9Rt`=tDaIfI{`5a2h6XR^Dkw)5JVp#RnL18k zOB9D;i~NGe0WGL5lc!iU5~_Kaxrdk0%yM~&OE#5Lto*8Cwc;#n^Ea#!w0fy89NOl- zFEz;o&b{^bsc6d)^UQ8KT$HYuabPWLf3rI^xK;|jrl1Gw?n!v18XGs2k7Xu?aG@_= z3HUs6KbTTy$&ZGbd(Xid(Yk^fT3sBx4igtG`#ybeFFy35uu?|T!H?Y*G1AR5P)!j& z<@|IYgp~>&bVeztJfvM!u;AFj=(*nn;zn4Iq4)rCqrgU2)Pu_3s+N0%zKdWB5o)a8 z#O?SEjefPCH~;bOE8U41g|=a!xBpHr7rJYy^lZXX*zH7jQ8mMMxw5Rm^*lho**2q* zQkH<4qPb5E74cqtmnsIjUt!Nb(cJ@eaemUjX1AKUQeMSSGMX6%o#CIazfR7deZlss`iAvWVkGsQrDe7tSxm4yXiX?!QFoNf`IasOKXSoA zj8c65Z>0z?mCl+hUO|@c8I;>&{Wr?>gwM4EYJSb!+16xA<+eTbl`)#~1^lZQdkl0a zuO)j($0;&t4bO@Q>tt7EO^%?TI*SK#p$a{ZchB&cSZ)Cy>v^4i+8Kj5+-#EJ-7QfbDHM~`;)N1X6x^}G9-m4MoS4?QAdCmd9;j;h zE&`sT3XFv6IW-v)ALiJEyw(M)mVb&R1bn`0al&Xq@x8YN9Ad7v>Hn7%#wi2hi!KF+ zVNBT?IZmCYB&UaX0v4(|q9?IS*GY@=uyu6<7nR#mcG=t4aRX6JzjW0}zT8KW5>g^UzO{h=*U6$xii# zM|Rf+tv;d@vpZuy>7>3%4Zs|mY(SKtbDh4Y`38=Lubf8DOD55bdP^wbr2SN`f-OGJ zMH1*XkrS+@N zU`VudToy*2O=DVkwGHJ1$qQt0OEQ4LNNprquVnc&&m{o^H@-^uqVr|mpYM#&?u9*Q ztrfEG$88hh2n;|flS^b*w{O^4X1IRnSYZc$c8eD1KZrbh@h}R1nb zhlS6=fL-sloZFD43*ZsnGF3>2;yd4+{221r?C4%h;&+%Mabi8x+V_W!2xuUe{c)fs zFDAM#>(2O_1PTI^W2IJqdX#z%(u2b;4_rHQkm6ASv7T{>h+<4dN-IXw-sZn<`7P$H6?vN!dyLhTC(7 zH=USGq^{@y(VoIukcp+S{nG(@;KkF(v()kj7XN}xVA|5hc4n}{<|$vaqn=lk#`1oA z#y+UI56fFz_3gg_X%%M|;so&hryxYF&D(zEIgDHbnoG$>D(2+U`E*f_p{T`YS-I$`At9Tu$No|c5xb5tSEohfI>PDXN1iiT z3G>1h$o%nM@_zd&U%vlhlWQq>Q5ElIEZ9;1tptbpq2S@e+6nW}@|;fy+u8|+wY7qf zXbKV4%~4BLdrEN^DgP8jc@`xj5tG1un-#uG1jMM*^#F6Xeoj@pSW%N&mVG$W7hXu& ze%7}?p0d$rIobt2Ihf0;?&8*Fh2s1)^2KLn__Em0Wp$vuL&C;ZxaI_+3&jiH<$gCf zN73Bfq&rBTur+lbcUt}W96>Xrr z;^PS1lzmN!H`B;3x~9|Y_$jc6>kFOX%+lc~huJnwma->jhbr|Y;DJ6e(Vqk(IedDj zJ<%;yW*s!is3uC)B-SVlWB=OeyPDvRAe|IWZ6xat>hXnrqYkkDl zeaWU$8iq2ka=CNey|2_6KBSSb3V(PWx4x{O*B`SFH+&~IM|IaK;Pb03W8R2A8bJB|RLPR}Q z@;15}G~as!dPenqhbiY2HcS0}Wgg*Nxo`j<=M$Tr1=oo%Z?2=nA6g#=H0g3KdXaWX z^zq_otEfl-CvW^z&9w14c9<$v-*Nllmq4OAcK;sD7Lil#zsk<&eer`#ZB}w%_mTpO z-{7LCBvu1AM$!n`Sa!CW1Fy{;9TGD}ojR{ZU}=}5MtDwX&34o20N{Dwb<;!bQbJuQ zwQ*Y08nFS-Qt7&z{Pvi;h^1`PSa&g2T$?f1Bynmrx`nFNxmr18=$zgH3$0um{whe*!l zQtB5@PYATVmHI+?0~toxT;f2^zUTV|IzVb@pOw<1>o{9rvVkRGYVdj4)Iif!br4Zll*q*jAoGD8nj`^;BwkT9z>i*^~25`M%;ajP` z9}p-ll9I`ej&soXb5B@ee~%3PrNqiLqyt##>xaTa?G%VpasF z0IYd`RtC-!$+Dwz3(X1O_Y{_1 z4lVlq&JkiAhx4lk?e9Jt`|jkol2Tdqt>wdQTwPYav%Q6yME3Y?O{Tszk$kxvuaIa& zOzUWtFiR0UQP-Ac%_#BnTBfktBTap=7UMT^?h-OAPPqB)Y z!|8f`glh@Mx>pN>wxlI;4^As!Nzm_|hT(}2RiU+%I9fkOhg2rAC+=lbx5oqQ6D1p| zM=vabhu3}e!fR3}A4=N!96qSI^G-LrqeV=6QNB;MiGvkhMwoQ8wY_N^xv9`I2r9dN z^}=a(DB;x=0e|MiEF~M``e4+e*N+94*+2K~CYRPzeJ*0Z?yz4o<@gJEYP@H)bc8rU zgvne=Z@m?>f5pOeV>o?SsGdPx9DIBDbjH4O(b*n18P#$hiFS5;;u}d5SI8pqw(LuP zAVI*%S<^Mc=gMBrBVsa4Yk45yma1LpDA>&aZXR$M;(Ki`Ydc@)yc7CsEy7qkV>1nd z7z?_rUp?E8WtPj%j@>=tiAX^u@&Z7=C>SxU&LoTv&DbP_M$_x9%W!gNmiW>it@o=S zMvKq|p_5;w4>@0XXoC(nIV|R79dCz(+N}du%A)+SqQ_wF z8Lkq!7VY>{V{+39tYns1h4H(WI>sNE$ktPn74w31;Q6(5p<`b=61ax6oeH-T`k7^h z!udcSgh`WY=H5>-MQh_^65E3&G6EJ=$VCjRBqCC()%UZFK-PV*7#e5Fbz6ct0>XZL z&9(JDOXm)ZCLcFkPqV)tr(oGRhaw!RV--n2K4x$VU1hL$g{5Zs;`b>6!=IUapfEX` zt#;+oOEv}B^2y+u>IDro_$Lf$O4U#ivhn=6k(l*MyqF{txtJW<|0Q-G{@e5FtVYP^ zJG|>P%&td}eulwfR8I3#4A(YGq)wkdEwz2P`F!&WOFZ^jijxoo9p&^Uj8jElLC+;& z&B4jnpt~{fs+n^#0WAKG8Z#E^g0_Gh2Hst{I$nn5W8cmF9eUYYle0wq}A1yQT`3E!4z^OpM|*1LO}A1h{c%>)}c-&;)~o^;E6v($x?-E z5kCQ_t?hHYaUQ6J78+=iFWHO{yVR=uHCvO2k1*!TS-zZU-yU6XRJY1*`LtXocCMGs zEc~*$O!R)exBa&=5SfSg^6Wkk{Z+u|=v1))!E3OEe6TX$&x+z+XmFI4eu9?^NC2CO z)GximO&uyPVl%4gLh$&CDaoDWhkOo)d9WB3v{-=fRWFMQ8!;h7FoIj1-SX4%xy^u<6dZQG&7OK4l;0NK?2>E@`~oM}+kuc2)C#lS+Yd z)AC!9RBKx0v!Rd?gWV+QZ>u9?GwAF6DrJ9EMrQn}afR(>=M_OePLj;YVuaG*_e6FT zItA2d9_<`xjjP-Odc)y;)~B=8t^1BHi5hR;mEW<3@G*=u$+{yf;LjhLB6^thbX%13 zjXj|Upl)FDNgX?2q4;#e z@3d5w-5r9fe8#gDAsQ72U%@nLX1|V?XNVImsuj?tq8tKwy72hy_dC2H+acm2ZrY49 zXWAOvOzHKu7=GK?;zle+#TE{vv%<89GJhbPY@=BsM8DFiV8aN>^wwt+_nEGw>Rl91upLKq*2Rx4#||{G7P?gC&s*2m01diUm3qvM{scPAT8cIoIJiIdlP9oN;=Fo$lMIp0ddyU z{=V}xb-GZtW0|h2wQr9zW*J8_*@4!=B(@1rg*ZJ=OEX2plTf~r$1#*5)%=%53Wb{K zge-u&N5f&J#);bfh=IE7I@S&7wsNzWq!Ka4ST!#`Pl;Y`x0%Q`%Z`j=VzO9JtOpm! z@iL39hZJee4{#;BGa_3xtv@X96FpI`{j$E(LPAy9&^-OpO>b)Z?+RI zz=&oulZ*H~Iz3o2NQ;i!s9(QsDRlP9q%6>@6Sto44Nn4ii87VpwRCU#9_>my!Tr|) z4wiK2-8EBxY!Hq&aD2Wfk>t64s1WO3LHRkD=twM^C8+V`Ji zoGj6dyjG~!nmC8%bu?dz0J%axoI%1T%}6g5^_%zpH}PP-3tEAt<2c4hdcEL!Lolj1 z5Um>zln^8fewu@XV)`?7nhhml&ZtGpmANSe{j{=X2V7{i{RSFM(yMpK*ecrH_X|}; zokQAzdfM~V0b9tR&_*xo_!9mkYVBQz|>HgyE; z{#XQ)e`y{jdROeXpR<@yy1S=L%XVrtordk!xg*4Ph}psl<1Hq;ml(X|kH21KRtW4* zl|#Tq`EuEHu>o8@ZV|f+MFre!jQ*#os&)d8CzMk&bxLq=I&V)@-8VGS=U}~TVmI`} zIvSTtWzyfs`uE!j)DBxZtGir${O*L_LBZM80&5=OmeRBd5H=%$K>bR$GBEWygKEJ4 zTnTea@`+v(i2h~597_atVQ3(xJx}zz#OJyz*1>@Qd+%}bV-mutZ8Myo#$(+N3wHpT zP;ZED_N)Qz!K7}T7_$Z3pF{kt)^~fSqGmL>3$vq$f$2cvAro#74=vkM|?~sg4Nt7XIZ9`-1Cmc~s9?mWa*lm?=8Md3!r_*q|t% z`Hj7Hk&5YhP}H5@P)?9rRop2eaS%+z$bOwWOI}k0j1f6DM}=Xq%}_Uf4go69e$Z-+ z7}~94rCgvsA!lSvckV@>`+O%;eHaI_<6k$U@KBlf7f~j!yn|>=^5~D~8_EX@t26^dak$}w zBzh*4-rra>!96zB&6lj;0C|Scy_ky4k#X51#TT}$%CI5F;USgD)jIx1d;_AS2+#B7 z8(2#CqE~W>9_D;s$zUxYq2z5HR}n${rK?r>S%M-?nN4g7cj2nCBRMI8E*^<@b*$GX zqva{&%z^l!eTwSH{qR=75>ac;w0b+#)M#aF85;Ba%)R7RpI=s`GiYV+@>r-(F`#P* z{aF-0g{Hvl@kC~trg^ZTebGQHPMp{k0khoh#8+P{`DbOsdV}_in%YRkU zM|@V(NNtBp^Uzj);6`r_Xe@7Eqt_rzH_wZvS#_Xknx$Y}0b4I7cO8B_KvmMT%$d2E z%318+Y3|tbGSwV@`|V`vSSeBSNW8O+?O3ah@(c>gO-Zg&SJW!|94juOKP}Rd5_r_+ zriK*L4zU>FGb--{O2(DdrW$qxU2=$ zkyZ~I8~O0t?SoI;(V|&Q{xR~w5pI5*lnz6!UVr~OlfPnnUr4}a>!DN~F=5-vJg9&P zDV>xbm}O2DS1QzF{eaZ1{k$`!S5z9uUBvyK2*r$}vGCj*{hg*m5YeH5h>`QA9!wjU zSi0LyTCTfMNK7tQ&GIW(_a3Mhtm6c3;~5?Tb(O^Iy_)JuX=BXFdVowS+>ODd z-sG6%k+!PTXLD|t)hnlY8ATf_?RT^;LAzM=68d#X-T8$SWPQ%GDKFw%H$lf{SY(c2 z*zlm_)8F4e?-dWs)I^`nFPT|C%T1wvoJc8Dql9^+eRWz5KMv{en}1s;?q(y!{*69g za^KN5df?>vwHnBZgB&xawmQ(09rdQgp` zTWPtLOT_XdjArjS2Pdy>8xY=hSSbZcZB zad!OFy-~=aKf;>?e2o*!w8yW2o_>;6`NP@P2-z4a8UL%3Fo9-*q~16X^Fu7$k0>T2 z5#(V0@lM11p_z=-ZCDh|w@{nO0ZrFFCXqrg!DaDv?HZIB52#7ja!CpB;kZeKDb%|D^gX@ zILww(gehSiseE<&Y2?=?l^q_(L>!$nmh(i=9g}Fs(>i`LmA@HLJ)c8SXB%;&EMMqd zcD64vcKa=K0L$A))=>-6=Hu{{jPXPH1&vep2Upwmzj>!P&%KXUBYi&Z%@j2p0%B!( z63vJ$9;K+-C0U$m5o$1q-N19bS}Az(TBv^OQ>CEa`k?i;+cGw#cO5iovOMyI`*=f& zTL*_qz~H3Z1XzZ@T8mY*-7Aa>envT8hSgLZBI+-gkl>%59cY_|Gb#45DOzA_b2znl zxg*eQ+^p#12&+ILXF`xD-0BEu_?&XfaNA+OddJG596&2LaGSssz23hUQClZX3oeg* z#h(i3Pb!*B(dy!27DASK>mhfm7_ZC31?(KrOIm-kll>(nmb0Ug2K-UsN6oqOd78zP z#>UxP20$Pv6d>APtB?x>6-QDl018SznPxwm1WN=7r;}jPOGIamtTX$F5?)vmGYl?w z{ZO72ufF769e0rviT94vV8yPME@1kx(XH&w6!h?V<4MnMWE-#|pY9dE1_8ql>^Ky2 z*eVcC>WFn&h-f3th}r4>lJx1qHcv;wTfKE339*B~xoUV9kZl$(ZkY^);fIOZa??{u07_9Y zc0nlf9W^7)M9o~h5+@Yd68Futu2zMDS&=QRiM>+ zl2rm{ZC{N^D)*m-mqaP0M$L&}vEi?uh{JP>|=% z)vmx!v2wa@JoJYbodE{dSq!Zf>DTUyyuIQ51l*}%u0Sr#ux!dkGZ6M(_y%$nRa3Cw z)G5@w!m|7KXu=YPtI^zI=rXCy`n>IxvZMmQF_q0bk5+CoAPQ+^n_|%P3Ln>PGtDk1 zz~BAMky8y5h#zj;9Bagg<8p7;t!x2^`0|%sd*$}KKkrZj5V<&^0ow$o(&iA4gJmUg zc~l5*-pNjRBMeLaHs=IcE3zD$WYu0bI)duoh%<*y4Mv(FdDi+Pr(m-X^Jd`}3<3j1 z4}G^^i6YCq5!GbJg6(TR{knw2eBE?5@(knl8NgGx(L>B5HYlEeJ?3;F_m_?30^jHb zY6z&r%ZKsZIgZZ%2?0Jm_KrmX{ytFiTUyGfq$e6QlLhkQJRVbj@Y2{ z`7XbM=0=fV^nzu;#NuLVoU{v)0c(|8@p0J6J6dA8%TZXX{Nq?)1ZcQCO|t6p@j$TQ z)ZZ)@H<}=2hfhd3r&&YSCoJ?*@-G>|+sd!Rv{=45pk?vk7u>L>sK~&j4qLarhLEc& zH|;LdU5@fjzgEe)c*-7!BUNmx32>g!WIt&kQa90dfIH$k; z8Fls6syb)8sIYKbO-5+OY=x_B2mwgZb2)&`VFB`OzS$l;S)!`VD4EQ$DMSfgEz(II zvp?+k_D}ko+PDPnhG6sO*KMuK#}1bkh_#7q_Zx7)r@6K)*%)$#=H-T1KoPH6ZlV(Q ziq){$Lk51q^n>;S&*nv@L2c(Zf1&!`O377f(FkjJW}d2#JlRA?q}Co_8PM+2YxTk7 zdptpbU>8`D6j^H<5LV9SHE!GwPr}>JIW^$2$7rE;rG)VUE$3X?j%PsIfL1A0fpGkB zbrR$8mcMv{Vqu=~4EBVz}O%AzIs9DiWh{}Nz_7I-S z_Lv{EdP$at?dT*#l#9!1{j+`>t)|2rQozvH(l8q|Rotv4sz9jo(A?7S*5E|1u(b}* zf+kA6H1*E>YwJ${M-N*&hHmvXDL`)hRSGPIg%DbyqE#lJ`qqQDYM~{q<&8;eh$Cc0 zzwNaDaf4%z)hVOz9i$ULcrRcq=U*R&;;b&a^h~=gs37{Co6DPbQG?+twRN(ra)sP7 zc4^vGOY+aE(+Q!SAv2D%`M_nOCXk}JWmy{Qw8VY`uFe#2`}c1`ze}}lW3*$NBLt=? z{1ZY1Kfb;3VUbDGilz{D`>x+;TQn~>N_MGzi%wu#8(BZ#wY|0}ij5an?C(2`kDmN+ zSE&bn22{)dnpw__({eRG3T0KjIF(W&fp2&Hu=TY73RU*V_G~BJyFQVOx%C~}f(|S5 z(Tz!Eg zNWX?0enFO%_!X{7vX%izfaW1jNz{4>rtZV8?aUPROoPkl-mYb6FG`qx@616##S!@pT{a%*lt!5b+u~YzW~GYoMSp7 zl8@rH-Vj$^*G<@Hcmjoiyqy5*zpW3JU0YixgTaXdVd%_T7d-fxKYfBJ?>@t`8M+|Znl|rYaMb5w&TK>Xd_=9`$o~$T7iRa?{0jcijmHWT(l}b6kPv5 z#@;e2u4hZ!h6n@;!2*rDySo$I39i9|yVC@BcMTpSxNC5CcXxMa?0<6S&O5)mWa7nus~;6Un4i+)2kOUl5lsu8ZAS_Fz<1?{)A7?$!noQ;x?r zuayj(XO2VcUgsuB!V-bz{J(<^^p^!;9Aq^uYVndc-R5oXSdgu!V@sm0J;0%%YzBA; zHf{ve;So%lC`m#J@f#z;D9k5kzN(HM^waE$h zVv8}&iuVy6P)vNS4n1B0{raaXY7z;dEP^9L{MVU%^=(LDR`%~D=ja(``?iH6$k_YD zB(Yt2h^g!OMBk?D>H{m-dRNxA(XPS#O4a=~pl7hcgndOhEc2_)Oe6sfUZUwB3CB{N z(tbYKkeT2sBtm@QwK0;OSIUl^{`HK&l`@e-o=O-nG{Siq^{O0{4i>1njED z{MasZo4!%LlqsC9pj~vrCFkS39)|j`zGd`OJ`xu1uLQg|mMtk@r-F}S&VBXW%z1uS zGG6tV!+X*f>aM3fYG$X$2ZPAL-=`YdIeHB}`pWnmfqDV+OaICmetBr(%NKdFEJ>?K zft%xRJ3d}Oan{X=*rCyow6q>wMLF#j|MRkRF@3eE(bg9`@M$)t@v=LZs_M6%=3=6W zOo|{&pXHM400|p=^!J zA$gY?u5Js|wG({b%t|?f6ZlZw+yxWO6Ihc}vkrcAiSIWiC6=(KF&S%@dGp*INA*oD z`tsIWu3^w{G?&CF_`zI%wY!~3b6%>-Jzu1EISJJ+N zZ!`yQ&r8-0&?i_vTmT7es)G^{NInuoUHpH+R3|DC1pQ;ztaI1QoT=C)7kI|Hu6%H7RcV93cwcyfBc07mHY8{<@O<}6F ze^#A&Q3C!kE)w*8@CA64v9?=@D~)#b4r4-2@Lv+E!OOiK$heB|Q3*$N-3~4Es()_i zrNGfZYFTG;Ilxf!Or+E7v4s*l?2D`QW~`_D=cj1WIFDiXCWv!Ii2kD*r6X#Rl!?eM zvRv#gcdC0-bf?car@gB?{=0lGT8A5pZ6Ud``)5RTyp8waG=?jD!_uiIb3s?I8=BPB zW-e<`Wx_c=R{ML%os}yYCd%|N{D8H9J&UN<*%5%T>69ZnA#dY|lG$A=Zy0XQI8oW% zE(x8!(0CdFy>~!A-USgrJ4ooACIEW801wJKzfZ8JixDC0-JN z3^qhN&Eo7a0j2v+IU60~1m#h9=AtI{r+}lU1+>VrWyZcLNYCa)7H1IDXuQb!fuHcX-8N3WMoH!1R^)yZ@XmmTDt z`vK*~rZD0ZF;v+FvOX3}u?TTDRH0k9TRQuyc#$}<4hr*+{lh5pMio8C6l=tE0uOr%ID^qh(|HVyMf5DP0#!Rc5`njYoj5K{ScPADq+Mm zma1ljW_GI?D(HoR9=8E5dU=n52Zl%ftZxLL8+ngLx+G1vFpuQP4p3%u4mTz8%*)Dj zm?K;AtJE@8SZ-Q*;l|m^vQ)4K;t-eZG*HFN21}w+upDoe4=#4yklha($%?f#dZR$u z?B|#a8W=X(XEZXjQq^$ARclAdI?ab5>`m2}%U zwArLP@m@G>)s=>O{Tq3lif9e)wYAo#Q_Df<9xltuW*u>XiR#rt3y z{0C8Vi8`@1i)UhF(C&UrR6HSb3+cP>B3Y=(X@gZD>(XXJH!Eh|$^EMfvo7v>$iuaA z#e@9m)(Vz@KG;8gqZrCOw(cgGp!bE)@XI!J7w76x=L&`PQn!US=V0C7FBpn_ASht& zPkYIB&3#d5Jpi2+NHASS9Ek+om`LVbiu6qw9^htD5ZS1TN0}JUTaYKfkYDjk3f-pO z-~{`zzSdlora7$k{&bDY3~LFJb}-|@h4Gj2SYG?#B(d$v>v}I?^0wPWVUH-mSA5HP z!s_rq#=Lnr(uzxLSm;jE{tyI!T-H?iRBVKBUCf66-h6@aQp~o+Y8ABNCP#l#0(k!{7 zROzi2q}?8wWhA;?P+m&^U)_Q~zx}HdQIqrXWD7u}1bDHO#>7yFECTk&rFgfpK{0Fp zqBxG3sTwFKgvsR@mNAChkgYGkan@@_>wfYq{5qq`daEwoK8Gs0(6!0=R1lMXX0q5x z%WNo;kF)~eV5}>OR+{6%c4ou?Pwys|5BxusecYm}JBEOKpvve5Js#0JNWCUj7dd>yRRKI zNbhyVKh|RhEjRu^4i_pj3>_B)I&EK)`Zc^lr%9Ki+%xZlXv;E)s2UnrX zy-`sN@D92K_eR~MI{vuLk<1eNJl(rE-L+mKx3Irxebb?00L|);NCE-jlO>lwlAoYb z;q2*$xablH04V?KKf%R6-9HpS#TX?JPHNZ#+0P=NcmHCK+%p0ODjJ*1bZ0riL49;5 zjv^b#CjQS*A?T3NH;$2t?g~Oy0Blg3?Q+v~zn4XkicJBxI|V9p zSa#pPFYN#I15`i&BSs_7(D5NDxO~CsQrtA5TI2Mrie~1%wmkh7qx7d#N4psnjdAq} zu8(M1uWweYD0*EoEdgT7J#E}v5yBW{c|91lqow#r;8a^WmI!w^Bn+Lsh^;YYk>=f&`!AFxiV)8MPXy%D#^ObX^dPy*)y_s*hE2}64Hrm4iOWeYeXtUBRXCi zfzuF5Sr`lH8;(TbS$RSL$yYpa&G)(Tqlmw;@T~BnG{-#sbCsFUst=PN+(#+FPP*Xf zIB(ZIB-wjaZ83u9$4n_DHE<%3Hk=1T@1~8iO2h9mEDGs%#%&gf=ashYD|%_<)(}>l zq_kI$vNT59t@)BgR`7(#epo$ArQMsByY?xj+4M?0X`nC=@P3sbsy*J+t#L+bJlrFq zl)d2P6qt!9hx&Mf_zpKTMXuBSZ{==ym*aK|z;D-{SBA_0ZtZI>BGGRzmNm)276EPXn$;b*2%Dr3ZiRK9Ap9Se2wq z_074KIGm~fTn+x3-C+L%@BlnQGv|LXY&QbGid!`iX+$DzHH^NWvDYYF^n;BI&+vP zJ_*z}3Z6XHU)-n*Xr3S6?Ulf7=1yCL-VLWAKB#i@c1_~2Vv}A>G_T-K$ikB2wtjg* z`ZQfGO3Epz@l1>T?EQv1r1SLSkwwn7+@N+=txG7RJK#21Wc30bS3-di)k_zJB5qjV z!Abrq9owzcW>|}{1efYL#7M+Sl$c9SL^Y@To{J)XA+W{3TNJ`sMpHIe{6#<@e7Z5p zTuqOhJ^iFR?XvO#%l0|Lpi1nFXk(r9RV&GM=75r%Q&yWd*k;66_GK6=Mi zk|g0@(BSDwNrFL&A~^xV-$6uK^aX>MVT7p<6rz)YA-&Hwn1hf2l!&xIF&VE$jE9oeI|-81J#O-8bb zdOd&2)T^z27#06I)Jz)=aaJnH_w_YCOwLg2Bx`*>X1uk-sdA7!uwK^40_TO9C9Ug= zq*w^Fum<`e>axOGvX2MQOL=|L`vn;D6n>y4A!?_c=Zk(uI9gON2pKrWda)9(*s}eO zf{vMX9#WZ%kT%=REgpD|wAp9aXU|a1I3MD2_4SXWwvirxMHZ5^cc;NJ=DPzDX1_P1 zrWoTVgoa6O&H2z{?e8uMte@Z*UdwQu3sW=uA10He^{P0hY^~t5#A18Pw*WYoH~f; z;%DH*7&hVp-S{oIkF&ue1pe9Gz@s$k4!XE8z)>qRoDLp2lm6Lga-(ZlEb*^r9{DU3 zNQ|Oklsx%PyIjVBI^HIFSPXMwm;Wx=?_VU~e>}+l^EG4r4Od#V?zCSC^1J<|^5j7t zF#=1C3@tl4AJ@1O(;FWU=Kn-XQUHg@0Vifa%R;*y5f;K!{#5JMnDVZ2*M`^nL=jfG z)h|{1iiIndnM1@V!{9@r6~dQb3;)S`GUE_Ll&ki9P*d5iJZ}|EL|5%rOmy0er|u=t zOnU$)sG9~UTRL{i&)G;zhr=w#Wp2E9GZHY(JQP+jVtjkz=k_|DB7k7zD{b`I?gT?O zdi0%=!GcU6&hgIVj?L&uqWBND(CD$WhXqY5S+mogKz0Tuo^GnL32pHSuencQii~kk z)dOe|xRw%?HR~j$Xe;EF%t52hwG?P3i^%2dZLA%xOyyrvemq zXgn?hCTk`F5qOckK<0>i`V{Ztltq6;*JM%z6KtBe6d^~fDfL^{ zg8OY+5_Huol>*iuGKLG=LBMAxu{uRkdI$5E;F#X=r1lQ>GtRVL^uhg=3jA~YpRd#Z ze&;6Mc>4I*e;N<9;uIB292Blim=hJ$`$Yb@n!~7iK%t|Xy)JEz1tYx|8om80)*%p}_D5*ZQbVfCtC@O7q z)o(WMI3`ve>yeJqLk`?sx$40H$z4*^)D^GH^*`N z6^g#nSA^ND9_}j&lZCj^_fwTSz;{b8h^PGqU)$2TZRL=NHDCfWVxlhQ@p+k+>-UK5 zs1G|f(j2Tf+#QL|>%sBEQq=`kpzlpM^`)q2j}TI&b{GvRMB8O$ALq~SOVunQr?RU* zW*V8=A-Gj3(2jm!@d~-0A24a+2amo4~I<$cNVz5i9iXG{OA6Li{7*Y5`qU#fZ>|*&%Y7C=B%gyM9Gxu-Ctm2d|pB2 zLK#3QasQSL17K0)1DzuZR#tRhF%aWwWMzBMiw-@#S;ajc1zpoxHuVNQ?yg_b8Uat`O|MC?AaeL<5pof<%K04kDCzrXvaSHvV^0Qrx;q^De!-MV?yNG z+LJl9{1SHTJh4L8@Ys#+`TCh`i%v(+?#WqH`xQ;-Li=2Y)OObJlo5FAWQo!TW8#B6 zc&$U+w&vP#n}&#v*3hjE(1I}KBan6pjmjgqLE*U77GhPBC!cPR_rZDkLU$gCgWe8x zdJKpbHSGQP4EEO)ofia(>CDx$SA$x5TnI2c7brFv1GR2#8Q{}#`%`l1-asbhO_3aa z-Pkj>lkb)_dh&AfkmW-HQSpp4y*E78&X296oZQ$Ivt9dZ9bW@s6#;>?3wZq$nOMbb z=m4iX9qs)U(zk&@AnK>-DmnhwmiR@FzyMfJC-=Mj9$<)u)E(o6Iz7D!L$8qtijlrz zi!`{ErECUW-592G)a8CIyTgrIDky3JE(MJa<3TkRb06Ig@_VKMM=4MXN*h3YApYtw zMwbKBR4+N+9)k?iQ?VOl{&N}?{|M!RCQiU>b-&5M)N{{NEmfDQU-QNsNd^LPn^pBs zHXEI3TjvYcH|5{}dfk?2ge(?QdOG!rXrR0MYzh#z+i&E4iOANnY4rmPio%%m>A843 zb$}xJ`Vkf2T&${Oov9&Qp3IfEOELVl!{Ffwc!wv_dj$X`tBS=X%`*Qv#eVTp?@DwH zr&K2h8$4X*J8o{n0WH@EvYD&_n)US46F_yQ7!_Hlyd%I)mkg*kpCZR(_q>+?bPW80 z06ZkS);ZtoMDgEuv=>}#QA`%d9vuW=X66Il&v99f6)78! zB_2Sl@XwJTDF&Pzq#`BJD5h@lmS*4(ihR{u-SfFIn2j%|)$J<7JsWlsm%gq78bTMt z_x*?N8dm#n3GSr<@TB}VcQ<%3YSldRQh+>C%xDgC^xMXZ0&tP~k;`ev4%H7_Ftfr@ zr;XQ@bdg%n`tPJ!Xoyt|GFgc;N7y*fa*7Xt=JYlfo#Y24NyYT1^gA5L5St&m`_}BMO}srIOBX`wyTA1zp6f~V zD!y6`WRdy|S&(J*3(+F0rFE~Kw6P~wZ(^^q zC1OM5@BYN`5x)q=)i7ccY~{R3hMp}t_{IIx&kG2>SdS0+th(D|%|zl}uGuPDX~|YT zXa{?F9&QP(ULD#DMlHbxug#nSm|J^wrTf19|f;{taU&yUvG$Ekb*1G3G%=Zi^2GL*2E=NX-5t z0zvKmFM`Iw%Vp8ASd{2)s<{0Fw%*^Y_e$oj#!I zb)SGV+U8T*eJCe1v)d&rAT($Bt=UM7d3#tgv=0DQSiK;$m)Sry)Zx4S+23gh@#uhY z+iW7I5N)d7YALce0!Ln}&T^1SfD|~^U7vR${~7}bffWCoHvsVwALxhxWcMjjQ(rwE zsxBX6zHa04xr{Ru39$6R!bvD5{SnH+Jm*tW~dz+^2^HVwl%G+s;(|o ze{14QNz?0vsjWzh2)294pQG?7~dg zji#C5an}?gV2skJ_hj?VJL+Q7sg9AH zJA2a3^>yFFh>wXP>&#k*3S zNLpD18?NmQU?y6aS3FXVPx}hka!#fgwf)Hm8sG4RiGbD7$N-r!O6kX^0=S=qM+8(+U zy97Drm@!eOjs~?Z!-yvX$c=Yr1AVznUGJd4VB&)(RWiOfQMn<@?b=z+c^C!|F|oX} z3T}M(#l_&3#)w$ia90S)t8ck&@iSM#2I(EID2-@$D>AD7BIO)1TH$(4W_?^;U+f;*{Na?X_{OWmNJ$jx_ zqdnL2sY}MeZkkOlu#1TV3@DQVLRy!7oild=vP$D26UanVo4Cu$O_R1emCecG*Xt6! zXJIcGD4$Q$nF5mk^RF36G1%HuFq~*qhCN)Z4TE?-bxU%4?czcc0;H4Kdzc1oD;?%d zAkqqiLBv9*Vf{$$@U?E4*$#Fxg{9E&{UD0H7_~WIDi#O)BubZZ8QfyVK{Ex~Je~O} zk;tF2CKDD1%2+!!=$%j%V5ATx3tjX=zb|U!!ii{_D6EPZM0V9=q#3bjsQ0Bwpo7e< z26$9dY;zK@nHgeGe(_<8-Y?dZ7i8G!yr5jbfX#Ew>2wj+S{$8FC8;7Vt|wTX^TUqK zt4<=(s&R8zot3h%Eex%Yvk`_7z9G4Ht&n8DknThhi!|38aZXUdC3n)GNMH%N)>0sLu3|rv zRcW0(xM9S!S^9GyJJXITCRZWcK^GDHY<<9nAMEwlM1Ru1HprF7kB7{L+wr(-n)Koz z^1rt0AA?4+A`xq<{D#w%UD0ZQu>78QL>~~ctq`4lycBa*XhZ&Yea62hO@fH(1CjYx zWz{j{pT2*9PPcy!!Roj0|M_t!RvzrJcdG7jNi)RgD(_~N@1TctXH9I;tvRl;(kWs4 z=xw;+^6gsS^`iaw=i8BfV>&s%a5-No>oUmxVHedq53#w4u>dbZ*odrr+kMEB{X5Mf zmgS=A*dRtC)!ZQ>TKsGJ;qq zGfr-&6Wpa`N|GejzswyreV#Y z4$)k6Zbx=fVvp%WgiQ2lZnMu>wr+EeMOd_b;1rNCoZiIgW?i-WU$DxLf6HwCIsQ+g zW$zXAo6b!G_Uay`Y%4O_wKpc(c&>}J9OMo)K-V`l7W+->$oP>ZQQ?tbE@F06&##PJ zUY)!z#mYH|nJbEIUT%RSXRK%n7O+cLOjNOC%U<5+7GzRe2y(~}tn$&9TpZ*Wt{>%u zCM|gzy6${EwA-U}xeHI**D)q7AwP|!>-kmQ_-eprwj*w22-uXNREB0F{Jtz3tT8nD zzyL?)of#67-1yix1$*#BsRAv0w;bEt5C6RZ6ZBh+LYrZP1{H-uQ_*MXxy$wI`J+OF zJwec?$QM+pK7PYi+Zz`m)Jz%2Igs-}qx=Vxw4I(8m;tF-)8H@ymfSU1AhG|r+&AXK z#b79Q&FuN)ko*+L`3O@fH4zjDeVmjzxi&*omi z>KBmI(Afh-+b)^){1!RT|NG$lf4o-z8wZ;UdVsp9d{8HQSEgyGC1%51+#T64?)g13 zkL7u&K1K^WYD?rtiWhwIdiSmJM#yY|t0*qc@ae2#N^mT)(MQSQZd(mA*jRnjzUn(X zN9VxPwE$6lhN(L^B==Ps-z_pZjFj%pKPWN8+<~8KyK$3mieW^B zUI9|Nr5EsOF4#KV%SOvyLK8ZB2=~9n)onG>4`0h{%jFtq1SZy zoW+I5&LckZH6-4oi+triWLFO>kKY8|EAkx@m5$w3aCN2e`ei(7OUS( z<~m+HfdDKzu}+(|G?dRJ2}U%~4)*PRKiT)0Vm2}H+uqRVTvp3vnKwVR|G@s^WcLdj zDD(ir384pQ!2sgDg7nJ+TQ?=CU7SPalngqkfhQN-61$!$)G!{B} z((+X*PaB0Q#EnU7nY86}^%#p42l9zVeo{+^S$!HEhZQXGEG8QG`Vk~m!w?cbu^bzC z*>1~V+hYM~1-Ahl1gcpKMGPm|kncbLjPVP%bDwXzbq|PM%j2->hI)j%w4m?UlnL0> zbP17uvAH4I z_l`)rWY`R9PrnLuAO}v_Ac^qt;yPkI2XaDSDu)=icMfs7sk;etUpmX^O6&)tKG*8K z6a0!=)VNqlGO^*cR5a#;lA<3+5DB1`tIV}$Jqgsllv!jgtuT31Ue0nkfYm1zlIyD2 zRE;kF-wov?4>-$te0&~>6R7^mp35b)ozzmvimxGjeK*MzM3tJjYRvQ9A28lqik{O^A;!|Lks8E`*j%U$@#OBUgTA*Xc!PV7! zze$!xBO{P%<22f}q4u*0CLQpEszh0364j(p7K>>xA@_XjA^Uzg&z3*^{vl!BmN(uo zHGuEkb04+*Pkpit4bd2A&s=}Wr0WUg@D6y!rGBEhy~Tp> z*p0QfPbgwpli?m^ja;V&E^8OPbZIut@6Rw#w5Ou#B{0n%4n?i`ehqV!gf01l$EYE? zrw}qetwtR7UBZoc8wth3=}KdKaDIF*AbBE|r z=T-n}2S#qZB(qm7Lzqj;z)In^Q>7{6u4d<|I{SCMkc`kLw^s&IDXDHGXTpV-ngxC` zo@lq31W4jFWf0eQcmbTm{>~K?n3NMkihKlF^92p10P2A^|iqGB^XFCVo=Z#4RwGB=r4FTjSR_y z8hQ|BFlIetXM;bzE%OYJCQ-2D?(k$D@?*WN{ zz&Md(otg`Erb4ow<_Wxjc9=SG!geG%Dfh&I2L|*77Oy~?SPkXxc@o%5MKP|9-vF6_ zVm3K&je=48(2I>sD0pfc9F}Zue<6F6)|VT8#BHLrqHPRR+9^tgTcP%HNO+k{&nKUX z{r|du`QO)^u%13DxY|nvxXs-L(kO|C6)PHc`LtR;8g8SxsJP69J-k0CYH~C;F8|`D z>6fd;9H=`LQ+j8?Nro-;dC}(!KFjeJ)D~9Fw7H1p(ZeOm>Gfg6rLA-R?1 zBlXGDQogmf$h%+CdZ=0I_ni-x`;$w z@Hq2-P}O~icSkeCfrB=#4Ql;Jz(9T9+;1&uFp$38Uv6}0Jhv!sjWiiem(_b1Ogfk@ zikqI+_PSxSbK9G0e>oDE0vu|;@(B}^+h3p0W|nr89%^hiBIMwI0@n`XXWn-_i_I=J z>CQy8teWo6LPJphab&r~;&Vq_aX-QXvbA>Zw+pcQ>mARB@jc<7YO~F5$>}C13&?@| zD+A{1pC4~)?6zQl<3HKBW6N!A`PV_@h10*OiITD=?$dHH;2uMRS`a$6cb?7+CBBQl z*@ZXUl>L2yU*l~ID8)^iKDgM$%m7hpZ7ZM4(QGX<5D7;(gWEX=0h3{Jwe|5}|H5#w zMw@0OUx@edS%=%D;MUG95|^*oE$j>WlQJs)8)Fwu%;9RQ)1#%Xc-DhZDjQS1kDd2D zl)aWotdi_=1OZ^pLN2oh6DkR%FA-l1)B{ zt{O=(mc$V+&TWPC!@DF3eUnd*Je!FkJaET~^n<(Ms~#IA_SVWU# zx0_tecExX{gwp0SXGAkSInu6n`Rf;&UFws{`iQ&6Bg_7-5}6d~&5UHq1v1LdS3oW# z{PuW3nV>1?Z$9U4`N|oa#~Bx35(Iq&V25Qb*OT9FOob^4*z%D8Lq!*VrT(B_SXk-z z4In+DXmtrN@sn3?%3P*0Tvk(lLB+J&G4!_Aiqr+LcFYvW;s9lBygahNWfZ&|O3FSk zmzd8IMECCR9)Z>&v@NzT&pJ$_S2b-ymvcO(dIV)hH9g>f0S*a}7YI(#u;sIuQy?q! z(%>iSYrD-2k|D?Z9629=;~vu+4iX27sDd$lSO%>(fc)vN#_?JUj#@K3&WiS)1;ckx z=gI6&%sOl~)=%rx6}&?@fZKTK008jzAS-)|r|>wM$)7CN%-OKkkUf26}*J*1{zShkra@hQy@BT)mK>J~S9|4$EwL&KUsJxwO_3e=q#pc?# zF@aZFAb(~512?5_zH;jzsr`v-#ja0BO1DJyxA|II>-BbA)Knzi657#3y^Vlo!#O#b z-peSj`!!|j<=~L2v1~1)&1y@7EX>qmt;IpxW1F~**OAsi)6r)v3_YF;a%U>xBKb3ZoG#Sf+2mr7Jm%~?SKOz3RptK&H&)O%Dh$m zirioH&e3!9^mvCK>?Z#!o!8@%J+Ag({_`X7Va{i#Yv4_N+xl`-UPx2k5(~LL$bGWz z=T$4y)*!T){x#tUFsUcMs_7IRlJsTMPH_OZAJ=k65Bk*xK!y#Vs40Q;q8b%Du_jd)02W#he`E`3#K5a2Qek;h=QY@ie;G zEnpXNWRq7?-j?{XLBKDGNq^4P3FVX6QIRcT)-j_t2|SsD1mhtfEIj9Xm1L!8tx&v%(mxh4NUd7|#zcY)1(gtIh zD*(M%wCVY_d0!q35oyU@Jr|x&q)R*ayClMIx*Se(sj^>>v_8E1PQbU(_7 z|GhCtIG}B0ARRFUE`4;UMCf&z^7y6S_f6!A!{aIr@j~v-2yFV>m0Md|zt2e3g7^(O zyIrea@c`GNcNDHZ?>l|ePqNzHhr&I%_2#KMgqRzEeI!m`;0ZdURgs1blnAkQGo0dkLE3>J@X zWXq!YA7Vpe07Adch0W8D+zsqcE+rKBXkad#sw=zY+pAtbU4_MOWdM_ilJ4&5L2aUW z?fFH$>*1>tiJ6Rb+k-RN+1bnKR>i^xC^P%sD7@TA1pcRaL&tS}RTPilI_o7NpxF^2 z0*gJ~{d&L5a{N%CFPrMvZV({p7Ym@JY()$(>&UGX^35Xsd#5&cJ9src6IiEfEap*k zJt^kC*j;K&Ff74P5XSlhdM7OW;q6D)Or~&HoZ(?CLl54yma(NV_2f*G9)8%pwv!1pKCtSVlFrkGBFMUNv+MjmXP2cit)J(|*0UCy=4geG&cYmnX zp057dyn2IA`C0lrpTR4J0}G9IC@{+V+VH%WqYbolC0H6XRO$1r(&rfrE3V%7u$#tt z0(cZm-)t9`tnx%bJ42G;WhfuD_HqLL z_)We^vbVDh^i!s04)L71vi|^ zJ>G(eJU0-)Q#&9bJ!*!w`!~!<1Y(Id&*ur{PhOTFX%GVwQeZ?;{~jn;k0X(@w@|3< zlNYj4)^d09gvjr>JoQ$p&1w<>T8F*TT zQ)~fMBer*5cU?5)r$44YiBP#1B~vjeToEC3zZoM?fK*6EyNh=J>>}pkGq$|S_m^nM z3eGpvlG4dc?oN(B9z)G3Ka@><{5FX7m=b6&k>Tg|jA`CEQ>b^#wa3D^A4aQ$54s}7 z`!HvHXCVnG%(`b?5RiuXkg}2aP6r-Q$Bh(mB7VOU-~JnSoW1**bRov%)SdAJ(!{{k z=cA|ha~|Xt(ncD-a2BM~FaykA2bzdPJm*Zpb2Dpkzp8d}ftHr^SV)OZJyflt+mM3g zbz@DdJ}O|99F;wabG|+ys3ZFeOIR(~e{9*~I}0$)bc1huedginejwz%5Pi%Dx+bC& z1xf_cnkI{I;ni4~m{7EO$H3ldqTZkSCFBLtII^H52{*UGSw?*dGZ#@}2>c1pH-5mL z?!81)46L}k;zo+K9O|=c>B0|?2!8lVO3y1@|)VNOpjB8H{0nBb+*_j1n7&> zwKroqb*ON+N#KX13P7atlIi*RCdQZ?Wa_utv!oaAk2XXX?%`wbLr_me~C$a;@o)LzUz=O5Q$S79Sh2vg2+*T&>{H{Q7p?b!H#&-dN# zcw4;O>LEmkB18n^aaDqOmY!iagOPosY{0PtxR+&an%Er|M4Jny)lIUggU&TL?R|pT=kQ z?{l+L;C73O#vB63F$~R-imt|;-QDQ8B@KtgB@Y~KyV308!G&4gsS(d}+73uh&ub+S z(^5P=yG$N%YrlCew&UbSY0@O3#=LK)*4yLWP#gveJ*@Q!&4j6%5uI*x^5T* za=JfEvpn!k_DuG6z*|RpL83w^W$hQ_^Z5k9?^o3XY)58nF9OO9hz(3kJ`coaF&7E1 z62D$gWl?7!kA%MNQ@9)$Dxb@{tgy+yCH;8K_{FOE5ua{6$asPea?CQe4$J5MlLFXM zbi)qbv^i|iRoJ{jm&M}mmwS&j$JpYZP+yg@$aQ%XBXg{{Q%pNruHeb@ArZK)eYIVk zbwGsvrvLwqiabIO3{YcNw2IN&#mX(om&W@|>5WATFo?eOy6VR}35LK0BE0%acA4C} zYEFOBzT;z=(n5Ii^t=mwjS#|b8?rV{>96EMc94S}k2MctQJ?7N7(wFe)?kDm^7zcwye%gpkh%(_!M*7XSg{$9##NP^YJyx22$NqaQS7fV%=(`x) zwTDrTZ#GbdhFi3pPR}=M$L3>fDT`AfVGM2lE@I%9EAVf1y_!$__kW(xfm0B_MUtN$aN`XMWGHAMJIUTrxc;;gVmz z{oP3TE-tK=E|z7FWiQWjqdLCn_l*`d@uLYw zHva_J=G(WNpANEKUe^P0+J?@q{m(r2+_65B%E?`Qu{yaqZQPEPUKb&Nd;+@pYV20K zAA0UbGk8G;5F7o9)QZw~{rka-&@yFUb0LEY%3b0fEyMwsH#*n#E6yxvAGagt zr8#-e|9I(S>A7xb7#->%P-HkVGuJE;(E)P5y~dg#qH(PKN9s&XaqTHgT~GWMNcroV zkQ7Z9led0kUAEltZt-gZ^4hkm+bb+yHyF$?KA2Qj`NHk@5lY03=d7=s_k<3>(nMTo z`#IgM*Sx~*>dXCU1P2R~AUCM)Wc}?O%zb~kcS8y8l4>(gZ{HU~qtBw>p1q>%Bu~sz z(ba0uWbvYAseYAXxO3)R2rxU;7&c5302@cZDY}o9{Hc-Bwwiz|UCZ?#J*n(%S4p!o zOC>Q6%dKDVl(59hySGtD)C?Qp@jrlrI5@AksIY~VXJ9fE(};gOMx@(F9xa_8eBB$B zFqC~3I8YxQ zGTMw+A~Iz&enN9&yyoz;dil0s4$*;dm*QX&CUfydvEcb5mgk*pDATH%Shj_a^756v zw(4OF!%lUSdXDSrv*R)-Fu@tP-TpHYy^ zejzBf6ggHFCyxMi&o;!ST%PZS)Iw6hH6K`bgLL{R{kcGGd%Gt3RDzl083vO@FV$oG zI6&o&+Ggsnxg%WRgVO5JOj8N)nMZl=wZpjCt5r=DA95ddS<9u=%QLW~gW3Qy(T818jL;0bnAymJ>=;oI@G`tI6ay~ueaqDZa> z36)5@%?mSnQNBrRKLz4g2Y>i5xx;x>I{rxV2wAJQA>f7V=h{w)VRldmJV@S;y*>zt z_W^a$QC%2nEeLHuUeb=Uqz~UCT*ScZI+q}T!TTaivF-Ij;DtxqdEsasXYC&5$PaPq z^(!>dx3e(Gxnahp&l+dVlJ(=>_4TADku5bs(;YqS9psT;m4JY%O^F;XpNY1TY zn<_>}X4VDAyg~#Q@gI4dowkv<*2T!tzlJsUsg~@xnUA%fzgc!2`fa<)rNxOjpHi4L zs29o5eo6hbo^|S*+GdLL&xqu`H)IMd9BY7Z^e46u78E^@D7yXjq?=;dLxt048(C(xCLRI&B|E!z=?Ft7br;A`{Q-D0vquq1LfesF+RL2h%ce$`#tG7~7$ih%ocIZ5=!|2%-f6Z)n6^+=#goc|Jq z^Jxr=wa`!StOlsjz1vXp-cegevT=RuA^V96bu+~@(-?0wBt()F^n%-W z=gs-B9mk0~_v7uO2F?8z!7ElA=(+QyZ=?NX?lsiEcdf(bdDfm zUgR?rjqCn3f_=<-eOl`z0FIf&8+M>Ept!gVhQ48)O~!S_b?YvNx%zhPk3O403S2bk zGe1Q{q<6#p=G-RIsY=698F&+K%%3ngN>SWE#Xp$=I{`ChMr*X<1n#06Evj?P^Ay~P zqYLIjsL^xW=&}5NWPNjZo!{1NY}>YNn~l>nW~0X3v5g%xcH_pj8#iuj+veTO_Xl32IZT# zGpzpmpiz*U?ZWjz`V#(ns3RPy&H3wAyr6SboPR2+Y}`bTe&s}d%P?h;hTd+2#;2oE zMV9s?Ow8BI#~-<`G0jpjv2lG%mf7H-vQnbubS4_~y4wgrd+PtK6olQo_m5Xmf7s84 z0B%fjtheBv3zKk^zUJ;XWiAR)XvIL#7&_a_t_OqY!OO~5fW1A6ecO=?jevyE?UbbB zjC@HC2!ocHH>GmkX+6jZb@00ppn|9}XGVmOW&(h~tu4?%PhA4k>MW<<+!qJPfl?x& zTcuuCAb2bn9*jZ}gtRTNKi#Zdtb-*b&0dzNys;!fgX#v`FB^N9xsOo#{=PoL4A-Y* z5FujbaxK&GVkV~_w<;f4@4G7RQ0rH59+#+%;ZP&pFKZWlp!&<-TR87zO8K-^6Xy;ra%g>xP4nY;-INvGXHyR$Q$=kmGPTa( zglW>@BYd5)WexS{JhQt56A9q1{cV};B#`BC&Tjx1$$sqbeiiA+B?)ve z^oJB=n%Ep03`P}(sOI-)REmiY{@*Mkuva}e<`Co${du~Hb1>()!Q}4GXCo7c0$kAf z%Ag&_(2M@ds)+4hPzW(487y)oL5U?46oo{5 zKwnH8?(2uT#3pge>osrx2yJc{qGjhiO?^n`k;AvLxOV z0w?RR=i#Uw7YvV^jSD?L;vLMuJCZ&vB3W+t<62vuf=qbJA8NXqyWW@`f>Moqzq|1n zddi;>@cT#+dlQm)?|uLLbc6Uf#pReR^|1>=gkpsGn?UvG1fMd%cgpv?s{JCAxBKc& zZC|Dyd{X3tVxJ$o%JX0al;9d}5ew7i)I`dsuX*41UUKpn?HH3ULohhV61fZ$vXcmv zK_d?UM~=*FN^Hg`4D`=z1zAJ@Hd|5Tj4Ih_$5yWfHZ6R&ONEGG6_hNg!?cs5()0L4 zJVrCn3^RL#p6d|Tky$4(2HnwXhWz?p%5JFd=#_W(gcj8FyOMWm#}9eOzg(PR%-C?a zewAncY#o&-zmfH(x7s|uzUmZ=EhtC)|R2R!W^4 zo_aKG=Q%>j#Q`tIFN6Hc&N6Lkk`EJomlp^;@{?;TE*y3-vFJZNMG|_uy_P*B+cv|S zS|(db3cSt%>?X*Pv8vKlovq}?2y0K81aI9;icX3K-w3C+)OKJ39{lm9uyZ^o<=Wz@ zeM%H;4F~UY)y=&=NcTxH3{;>nt|j*cuBA-x`l6K2V|6hsCS5AX^5wzOPjs|V(fV8_ zg&{!~SN3I-mKr z0seGuA3E23w$mWK<55v{aH^4?Q_dzp_jIGW3n?N7a9o!C%8#7x44N`(?Cs}Z>`k|d zy9Hu7^R^R;#1BMbFtx$?-T1%Yee-uF?bJetuGG&4HuOTkC(MW(L8! zg?6aud+<-*Pjt@=xrB2(4>7nin)K)U|lfGVOafU4f1DqU8DDoD@a{og)Y( zW#zi&fvtX73WwHDz`WA<=Xq<9uKBqWyNuPIu;28% zN$gvmcsw7chYBchJNF^peK*Af4Q=a}f=EAZSss_x9_ogo(Qt_Py`VBG=f!&6Apds- z|AE8czrYgUWdp5Y6m}7jT1OK8O5WoDO^#c;{Dp^VLP~W9y2L~2=XU19cv|262xyaY@k=EWZj!5hNEu?S| z4U6(l7oP!2yW^zbl%HFqMX8M;QI8rXmq;TVPrpnFG~AP4c|&V{OCkmdTR>^x0FhE5 z%XJ(6(vV6#VwEf&)ABV9s#LsRbCVfTvd`EHhEH|CPwV*wJqLNMdJeSU*s?aw(kTE}tY@sH8jW#^6nuxLvXC^Y+{fwDocP!Vr{*mxXG|7%QJF z*{E!;rypD%^4Nv)dC2rZ*te^~_t+|)$j@i?R`i{K;4+)gNYhyaZ#AwZ%X&=3ZSvD_ zciutq`i$v;*!X15l_3pmh!o~cxg4PKS6GjNH#1Tz$&7*D6`phK!|#P!EfM<#pKmTn z^WjQP&Kqbt1rB-wlOvFTQ28UHIM67!{!mlJD7ml?;me&1M?QvNGuXo1I)@DsHa?MB z`?att+m!kKbX@(M6=BKyWY?Kuw`|z0qR$T~LL~-n_b*!WE{Qj^sg%KFEBMY4?<3zH z?hDa$-heAQcl5Mn28?}>R8Vd)1BHjQ_yvsqi8YhX#^h(@tUyrofY)YK@7iUC40Bi- zJ)4!NT@=oAkW{vX8ul^nl{2WrYeF_PR#)J(9lgCg1fCJEuF?he8Tekz3vSIs8$y=k z_;B#WLDpkA++NXc;>HUhfcvpW=D(1B6f={}Zr(|I^-uKFlQs5o+1U_C2E+MN&oOfl zc)E0tdmS(onNVJ|N#~j^DFlV$!@XeVI8~|3OyEZI_C&{+RQIO|1;d!6rM>t@k0p3U z2;zpxMx_+->RWO_Sx%<*ks-^2#`(yGedoR`RRT;VA(9vD_eMFWmwQZq_wPUawpBC3 zwKZhV!6$7(Az4(rF_~TXt0Ot>HT%m89{6)3JvV@#s175mb&!{ITO{KVXZd!9KJjsZ9R{iDAj6ztYu4J?=jd3w?&6#;T#OQ!K9vN9QMul zck_0Y3W1@EQWIcyy-suv^4gl67}fpTJ&+!mMT@js1hfIr1t%=UW7LbKTr5)9lw%Im}21#4F%P z?Ifm3WU6NTp9_4tZ@IJD>z{r{K3>Jj8@R5au{)q7MGg$o8&Tynn!x81g%3Ei{YS9^9?y@~wf9!ty$2?K-%IEv6j(DyB#!M`1 z#J^o=|2+0a4dEYjqA;z1ukfrx4PgZJ#LEE_64-Z;>lDOq6mAF;Nx3e_4>PDyfyyOW zkT5Wc$Sy1!FvI%EC0R;|9K|Dj~1P7kTY`AxYz^U*PX=pj5IL^C+OUr{~ge%#4+q*9+0WGK>YTVB-vN46As;jRZpxdP5;KM z?4axknB2lu&#lC~bkV{1^R?lC#r^5aH8VVnK``R6<~T9e)fTn1lTY4Gd*{wYmkI~R zQHIi?_t)$MYEM<-?WV+v3m_houvXK#22|naL`-%8GrQr6NoxK3E`cV-RxSKhHm?WK4rdAY(oC!MpEx<$@ye8VV-MBi%taHLlUGVd~W-rSkmL zO@I3R>Xl8${x5|6A8RwMFG*#C;0$HWYhJ4s;4b8g_>KRDfla5AZ|^jkk7}M%WffKy z<$UW>fpOGqvS*VIaxH~94#?<(~gG;a(jLLZj^edShm#f1D08=Lgp}+R6 zEHi

Each one also carries the Horizon version, the day it was made (not the time), and a description of your machine: the operating system and version, the CPU model and thread count, the memory rounded to the gigabyte, and the GPU, its driver and the graphics backend. It also carries a random install ID. The launcher makes that ID the first time you allow something; it says nothing about you and exists only so that your data can be deleted.

Never sent: your Microsoft or Minecraft account name or UUID, world names, server or LAN addresses, chat, and your user name or home folder in file paths. Before anything is kept, those are replaced with placeholders, along with e-mail and IP addresses. The server does not store the IP address requests come from.

The launcher shows exactly what would be sent: Settings → Data collection → View what would be sent, or horizon-launcher data show. Every field is listed in docs/telemetry.md.

The "I'm playing" ping

-

The game has an anonymous "I'm playing" ping, so the launcher can show how many people play Horizon right now. It is off today: no server receives it yet, so the game sends nothing. This is what it would hold, so you know before it is ever switched on. It would be sent once a minute while you play, whatever the switches say.

-

It would hold: a random number made when the game starts and forgotten when it closes, the Horizon version, your operating system (Linux, macOS or Windows), and whether you have a world open to LAN or to friends. It would not hold: your account, your install ID, world or server names, your hardware or settings, or anything you do in the game. The random number changes every time you start the game, so two of your sessions can't be linked to each other or to you.

-

The server would keep the pings in memory only, never on disk, and not with the address they came from (that is used only to stop abuse, as below). A session would count while it pinged in the last two minutes and is then forgotten. What it would show is the number playing now, per version and with a world open, rounded.

+

The game sends an anonymous "I'm playing" ping, so the launcher can show how many people play Horizon right now. It is sent once a minute while you play, whatever the switches say.

+

It holds: a random number made when the game starts and forgotten when it closes, the Horizon version, your operating system (Linux, macOS or Windows), and whether you have a world open to LAN or to friends. It does not hold: your account, your install ID, world or server names, your hardware or settings, or anything you do in the game. The random number changes every time you start the game, so two of your sessions can't be linked to each other or to you.

+

The server keeps the pings in memory only, never on disk, and not with the address they came from (that is used only to stop abuse, as below). A session counts while it pinged in the last two minutes and is then forgotten. What it shows is the number playing now, per version and with a world open, rounded.

Why

-

To find what is slow or crashes on which machines, and fix it. If it is switched on, the ping shows players, and Horizon, how many people play right now. Benchmark uploads also show other players how Horizon runs on hardware like theirs. Nothing is sold, shared for advertising, or used to identify you.

+

To find what is slow or crashes on which machines, and fix it. The ping shows players, and Horizon, how many people play right now. Benchmark uploads also show other players how Horizon runs on hardware like theirs. Nothing is sold, shared for advertising, or used to identify you.

On what basis

-

For the switches: your consent (Article 6(1)(a) of the EU's General Data Protection Regulation). It is given kind by kind, recorded on your computer with the version of the question you answered and when, and withdrawn at any time with the same switches. Withdrawing deletes what was waiting to be sent. When what is collected changes, the launcher asks again, and nothing new is sent until you answer. The ping would hold nothing that identifies you; the address it comes from would be used only to limit how often one address may send, kept in memory for an hour at most and never stored.

+

For the switches: your consent (Article 6(1)(a) of the EU's General Data Protection Regulation). It is given kind by kind, recorded on your computer with the version of the question you answered and when, and withdrawn at any time with the same switches. Withdrawing deletes what was waiting to be sent. When what is collected changes, the launcher asks again, and nothing new is sent until you answer. The ping holds nothing that identifies you; the address it comes from is used only to limit how often one address may send, kept in memory for an hour at most and never stored.

Where and how long

-

Items wait on your computer (telemetry/ in the game folder) and are sent compressed when the launcher starts or closes, to Horizon's own server at Railway. The server keeps them for 180 days, then deletes them. What stays after that are anonymous totals per day, Horizon version, operating system, GPU maker and render distance (for example "120 sessions on macOS with Apple GPUs at render distance 12"). They hold no install ID, and groups too small to be anonymous are never shown.

+

Items wait on your computer (telemetry/ in the game folder) and are sent compressed when the launcher starts or closes, to Horizon's own server, telemetry.playhorizon.dev, hosted by Railway in the European Union (Amsterdam, the Netherlands). The server keeps them for 180 days, then deletes them. What stays after that are anonymous totals per day, Horizon version, operating system, GPU maker and render distance (for example "120 sessions on macOS with Apple GPUs at render distance 12"). They hold no install ID, and groups too small to be anonymous are never shown.

Deleting your data

Settings → Data collection → Delete my data, or horizon-launcher data delete. The server deletes everything sent under your install ID, your share of the totals is recomputed, anything waiting on your computer is removed, and you get a new install ID. You can also turn everything off, or delete the telemetry/ folder.

From 9e1c3ec860c0961385a2f2b77d13d4627b9ea833 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 21:51:16 +0200 Subject: [PATCH 062/126] perf_bench: the readiness gate only with a chunk target; a test for the quiet start Without min_chunks (the old call) wait_loaded behaves as before, which tests/test_perf_bench.py's old-builds case relies on. Co-Authored-By: Claude Opus 5.5 --- tests/test_perf_bench.py | 16 ++++++++++++++-- tools/perf_bench.py | 2 +- 2 files changed, 15 insertions(+), 3 deletions(-) diff --git a/tests/test_perf_bench.py b/tests/test_perf_bench.py index 4729c5e20..ea074442e 100644 --- a/tests/test_perf_bench.py +++ b/tests/test_perf_bench.py @@ -50,7 +50,7 @@ if __name__ == "__main__": class WaitLoadedTests(unittest.TestCase): """wait_loaded on a scripted game with a fake clock: one status per 50 ms poll.""" - def run_script(self, statuses): + def run_script(self, statuses, min_chunks=0): import tools.perf_bench as pb clock = [0.0] it = iter(statuses) @@ -62,7 +62,7 @@ class WaitLoadedTests(unittest.TestCase): pb.time.time = lambda: clock[0] pb.time.sleep = lambda s: clock.__setitem__(0, clock[0] + s) try: - return pb.wait_loaded(control, lambda p: True, 60) + return pb.wait_loaded(control, lambda p: True, 60, min_chunks) finally: pb.time.time, pb.time.sleep = real_time, real_sleep @@ -86,3 +86,15 @@ class WaitLoadedTests(unittest.TestCase): busy = [self.status(901, 1000 * i) for i in range(20)] quiet = [self.status(901, 20000 + i) for i in range(40)] self.assertAlmostEqual(self.run_script(busy + quiet), 1.0, places=6) + + def test_a_quiet_start_is_not_a_load(self): + # Right after a teleport Horizon reports steady counts and nothing queued for 1.5 s before it loads: + # with a target the clock runs on until the chunks are there and the meshing has gone quiet. + idle = [self.status(3, 0, stages=0) for _ in range(30)] + loading = [self.status(30 * (i + 1), 500 * i, stages=500) for i in range(20)] + tail = [self.status(600, 10000, stages=0) for _ in range(60)] + took = self.run_script(idle + loading + tail, min_chunks=500) + self.assertGreater(took, 2.4) + self.assertLess(took, 4.0) + # Without one (the old call), the quiet start ends the wait at once. + self.assertLess(self.run_script(idle + loading + tail), 1.6) diff --git a/tools/perf_bench.py b/tools/perf_bench.py index bf5ee5582..6ff6b8052 100644 --- a/tools/perf_bench.py +++ b/tools/perf_bench.py @@ -342,7 +342,7 @@ def wait_loaded(control, near, limit, min_chunks=0): counts = (s["chunks"], s["generated_chunks"]) first = first or counts moved = moved or counts != first or (s["chunks"] >= min_chunks > 0 and now - began > 5) - if not moved or s["chunks"] < min_chunks: + if min_chunks and (not moved or s["chunks"] < min_chunks): last, changed, previous, meshing = None, now, None, now time.sleep(0.05) continue From 16b7e600743006324a1856d357ee1021451cbb59 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 21:33:28 +0200 Subject: [PATCH 063/126] Fix #1222 at the root: vehicles for a server's players Single player on its server thread, LAN guests and dedicated-server players could not board, drive or break boats and minecarts, nor use item frames and armor stands: the client sent Interact/Attack only for mobs, the server aimed only at mobs, and nothing carried riding over the network. Client (remote.rs, remote_vehicles.rs): - Interact/Attack for boats, minecarts, item frames, armor stands and paintings, with the hit location (Minecraft.hitResult). - SetPassengers seats the player; a boat ticks on the rider's client and goes to the server as MoveVehicle and PaddleBoat every tick; a MoveVehicle back puts it where the server says; a minecart moves on the server and the rider sits in it. Server (lan_vehicles.rs, lan_actions.rs, hub.rs): - look_at_entity aims at every pickable object, at the client's hit point. - The guest's vehicle is its Entity.vehicle during its turn; tick_boats and tick_carts leave guest-ridden vehicles to their riders. - handleMoveVehicle with its checks (invalid values kick, too quickly, moved wrongly, colliding with anything new), handlePaddleBoat. - Player.rideTick: sneaking gets out, then SetPassengers and the teleport beside the vehicle (dismountTo); a minecart moves with the rider's input; a passenger's moves only turn it. - SetPassengers for guests through hub.riding; one rider per vehicle. lan_e2e: boats (host and guest board, paddle, the other side sees the boat move, sneak out, break), minecarts and frames (item frame and armor stand) for both, passing with and without --server-thread. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game.rs | 2 + crates/horizon-client/src/game/boats.rs | 13 +- crates/horizon-client/src/game/lan.rs | 8 +- crates/horizon-client/src/game/lan_actions.rs | 64 +++- .../horizon-client/src/game/lan_entities.rs | 11 +- .../horizon-client/src/game/lan_vehicles.rs | 288 ++++++++++++++++++ crates/horizon-client/src/game/minecarts.rs | 5 +- crates/horizon-client/src/game/remote.rs | 63 +++- .../horizon-client/src/game/remote_objects.rs | 10 + .../src/game/remote_vehicles.rs | 181 +++++++++++ crates/horizon-client/src/lan/guest.rs | 10 + crates/horizon-client/src/lan/hub.rs | 6 + crates/horizon-protocol/src/packets/play.rs | 17 ++ tools/lan_e2e.py | 224 +++++++++++--- 14 files changed, 834 insertions(+), 68 deletions(-) create mode 100644 crates/horizon-client/src/game/lan_vehicles.rs create mode 100644 crates/horizon-client/src/game/remote_vehicles.rs diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index ab150a0d3..48fc141c9 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -76,6 +76,7 @@ mod lan_pvp; mod lan_screen; mod lan_stations; mod lan_trading; +mod lan_vehicles; mod lan_waypoints; mod leads; mod level_particles; @@ -121,6 +122,7 @@ mod remote; mod remote_objects; mod remote_projectiles; mod remote_stations; +mod remote_vehicles; mod render_control; mod render_tick; mod respawn_anchor; diff --git a/crates/horizon-client/src/game/boats.rs b/crates/horizon-client/src/game/boats.rs index 433c588d0..6b24226d9 100644 --- a/crates/horizon-client/src/game/boats.rs +++ b/crates/horizon-client/src/game/boats.rs @@ -57,7 +57,7 @@ pub(super) const CHEST_SLOTS: usize = 27; const WIDTH: f64 = 1.375; const HEIGHT: f64 = 0.5625; /// Player.DEFAULT_VEHICLE_ATTACHMENT minus the boat's passenger attachment. -const SEAT: f64 = 0.1875 - 0.6; +pub(super) const SEAT: f64 = 0.1875 - 0.6; impl Boat { pub fn new(id: u32, wood: Arc, position: Vec3, yaw: f32) -> Self { Self { @@ -295,7 +295,7 @@ impl Game<'_> { } } /// `AbstractBoat.tick` for one boat (`controlled` when the player rides it). - fn tick_boat(&mut self, mut b: Boat, controlled: bool) -> Boat { + pub(super) fn tick_boat(&mut self, mut b: Boat, controlled: bool) -> Boat { b.previous = b.position; b.previous_yaw = b.yaw; b.old_status = b.status; @@ -448,9 +448,12 @@ impl Game<'_> { pub(super) fn tick_boats(&mut self) { // ServerLevel.tick: only entities in entity-ticking chunks tick. let ticking = self.entity_ticking_area(); + // A server player's boat is driven by its client (lan_vehicles.rs). + let driven = self.guest_vehicles(); for i in 0..self.boats.len() { let p = self.boats[i].position; if Some(self.boats[i].id) == self.riding + || driven.contains(&self.boats[i].id) || !ticking(p.x.floor() as i32, p.z.floor() as i32) { continue; @@ -659,7 +662,11 @@ impl Game<'_> { self.right = false; return true; } - if sneaking || self.boats[i].out_of_control >= 60.0 || self.riding.is_some() { + if sneaking + || self.boats[i].out_of_control >= 60.0 + || self.riding.is_some() + || self.ridden_by_guest(self.boats[i].id) + { return false; } self.riding = Some(self.boats[i].id); diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index 548a69e3f..17e1e09a3 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -807,7 +807,13 @@ impl Game<'_> { if has_guests { let host_entity = state.as_ref().map(|s| s.entity_id); self.lan_assign_ids(); - self.lan_riding(host_entity, &mut host.hub.riding); + let guests: Vec<(u32, i32)> = host + .hub + .guests + .iter() + .filter_map(|g| Some((g.vehicle?, g.entity_id))) + .collect(); + self.lan_riding(host_entity, &guests, &mut host.hub.riding); self.lan_entities(host_entity, &mut host.hub, &mut states); } else { states.clear(); diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index 7028c2eca..eccbd7f0b 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -292,7 +292,8 @@ impl Game<'_> { let (left, right) = (self.left, self.right); self.left = play.digging.is_some(); self.right = play.using.is_some() || self.using.is_some(); - let riding = self.riding.take(); + // The guest's vehicle (Entity.vehicle) for its turn. + let riding = std::mem::replace(&mut self.riding, g.vehicle); let host_station = self.station.take(); // The guest's bed, sleep counter and respawn point; the host's // respawn point, anchor and action bar stay theirs. @@ -467,7 +468,7 @@ impl Game<'_> { (self.respawn_config, self.level.spawn) = respawn; // ServerPlayer.displayClientMessage(_, true): the guest's action bar. let guest_message = std::mem::replace(&mut self.message, message); - self.riding = riding; + let guest_vehicle = std::mem::replace(&mut self.riding, riding); self.left = left; self.right = right; play.mining = std::mem::replace(&mut self.mining, mining); @@ -491,6 +492,11 @@ impl Game<'_> { self.mount_menu = host_mount_menu; self.keys = host_keys; let g = &mut host.hub.guests[i]; + let left_vehicle = g.vehicle.filter(|_| guest_vehicle.is_none()); + if guest_vehicle.is_none() { + g.vehicle_good = None; + } + g.vehicle = guest_vehicle; let fell_asleep = bed.is_some() && g.bed.is_none(); (g.bed, g.sleep_timer, g.spawn) = (bed, guest_sleep_timer, guest_spawn); g.sleeping = g.bed.is_some(); @@ -549,7 +555,24 @@ impl Game<'_> { let teleported = std::mem::take(&mut m.teleported); let moved: f64 = (0..3).map(|k| (at[k] - g.position[k]).powi(2)).sum(); g.motion = Some(Box::new(m)); - if moved > 0.0001 || turned || teleported { + // Entity.teleportTo takes a rider out of its vehicle. + let left_vehicle = match g.vehicle.filter(|_| teleported) { + Some(v) => { + (g.vehicle, g.vehicle_good) = (None, None); + Some(v) + } + None => left_vehicle, + }; + // ServerPlayer.dismountTo: the client hears it is out of the + // vehicle before the teleport beside it. A rider sits where its + // vehicle puts it (lan_vehicles.rs), with no teleport. + if let Some(vehicle) = left_vehicle { + g.send(&C::SetPassengers(play::SetPassengers { + vehicle: vehicle as i32, + passengers: Vec::new(), + })); + } + if g.vehicle.is_none() && (moved > 0.0001 || turned || teleported) { host.hub.teleport(i, Some(at)); } } @@ -900,16 +923,22 @@ impl Game<'_> { } S::Attack(p) => self.guest_attack(host, conn, p.id), S::Interact(p) => { - if let Some((position, eye)) = self.look_at_entity(host, gi, p.id) { - let _ = (position, eye); + let before = host.hub.guests[gi].vehicle; + if self + .look_at_entity(host, gi, p.id, Some(p.location)) + .is_some() + { let swung = self.as_guest(host, conn, |g| { let swings = g.swings_started; let _ = g.use_item(); g.swings_started != swings }); self.lan_swing_back(host, conn, swung); + self.guest_boarded(host, conn, before); } } + S::MoveVehicle(p) => self.guest_move_vehicle(host, conn, &p), + S::PaddleBoat(p) => self.guest_paddle_boat(host, conn, [p.left, p.right]), S::SetCreativeModeSlot(p) => { let g = &mut host.hub.guests[gi]; if !g.creative() || !(0..46).contains(&p.slot) { @@ -1147,19 +1176,39 @@ impl Game<'_> { } } - /// Aim the swapped-in player at an entity; returns its centre and the eye. + /// Aim the swapped-in player at an entity; returns where it aims and the + /// eye. A boat, minecart, armor stand, item frame or painting is aimed at + /// the point the client hit (the interact packet's location) when that + /// is on it, else at its centre. fn look_at_entity( &mut self, host: &mut LanHost, gi: usize, id: i32, + location: Option<[f64; 3]>, ) -> Option<([f64; 3], [f64; 3])> { + let object = || { + let (lo, hi, origin) = self.object_target(id)?; + let middle = [0, 1, 2].map(|k| (lo[k] + hi[k]) / 2.0); + let Some(l) = location else { + return Some(middle); + }; + let point = [0, 1, 2].map(|k| origin[k] + l[k]); + // A little inside the box, so the ray from the eye meets it. + let inside = [0, 1, 2].map(|k| { + let margin = ((hi[k] - lo[k]) / 2.0).min(0.01); + point[k].clamp(lo[k] + margin, hi[k] - margin) + }); + let on = (0..3).all(|k| (point[k] - inside[k]).abs() < 0.1); + Some(if on { inside } else { middle }) + }; let centre = match self.mobs.iter().find(|m| m.id as i32 == id) { Some(m) => [ m.position.x, m.position.y + m.kind.height * 0.5, m.position.z, ], + None if self.object_target(id).is_some() => object()?, // A dragon part or an end crystal (game/dragon.rs). None => { let b = self.tracked_special_box(id)?; @@ -1210,7 +1259,7 @@ impl Game<'_> { return; } let (old_yaw, old_pitch) = (host.hub.guests[gi].yaw, host.hub.guests[gi].pitch); - if self.look_at_entity(host, gi, id).is_none() { + if self.look_at_entity(host, gi, id, None).is_none() { return; } self.as_guest(host, conn, |g| { @@ -1676,6 +1725,7 @@ impl Game<'_> { /// regeneration and the food tick (ServerPlayer.doTick). Their hurt /// sounds are heard at the guest. fn guest_server_tick(&mut self, host: &mut LanHost, conn: u32) { + self.guest_vehicle_tick(host, conn); let Some(g) = host.hub.guest_mut(conn) else { return; }; diff --git a/crates/horizon-client/src/game/lan_entities.rs b/crates/horizon-client/src/game/lan_entities.rs index 404d00c46..f433bc06b 100644 --- a/crates/horizon-client/src/game/lan_entities.rs +++ b/crates/horizon-client/src/game/lan_entities.rs @@ -89,8 +89,17 @@ fn stand_poses(raw: Option<&Tag>) -> Vec<(u8, i32, Value)> { impl Game<'_> { /// Who rides what (`Entity.getPassengers`): mobs on mobs, and the /// host in its boat or minecart. - pub(super) fn lan_riding(&self, host_entity: Option, riding: &mut Riding) { + pub(super) fn lan_riding( + &self, + host_entity: Option, + guests: &[(u32, i32)], + riding: &mut Riding, + ) { riding.clear(); + // The server's players in their boats and minecarts. + for &(vehicle, guest) in guests { + riding.add(vehicle as i32, guest); + } for m in self.mobs.iter().filter(|m| !m.removed) { if let Some(vehicle) = m.extra.mount { riding.add(vehicle as i32, m.id as i32); diff --git a/crates/horizon-client/src/game/lan_vehicles.rs b/crates/horizon-client/src/game/lan_vehicles.rs new file mode 100644 index 000000000..01195e49e --- /dev/null +++ b/crates/horizon-client/src/game/lan_vehicles.rs @@ -0,0 +1,288 @@ +//! Boats and minecarts for a server's players: LAN guests, players on a +//! dedicated server, and single player's window on its server thread. +//! +//! A player aims at a vehicle, item frame, armor stand or painting as at a +//! mob (`ServerGamePacketListenerImpl.handleInteract`), and the game's own +//! code for it runs as that player (`AbstractBoat.interact` seats it, +//! `VehicleEntity.hurtServer` breaks the vehicle). A boat is driven by its +//! rider's client (`handleMoveVehicle`, `handlePaddleBoat`); a minecart moves +//! here with the rider's input (`ServerPlayer.getLastClientMoveIntent`). +//! Sneaking gets out (`Player.rideTick`: `wantsToStopRiding`), and the client +//! is teleported where the player lands (`ServerPlayer.dismountTo`). +use super::{Game, Keys, boats::SEAT, lan::LanHost}; +use horizon_client::collisions::SceneCollisions; +use horizon_core::geometry::{Aabb, Vec3}; +use horizon_protocol::{ + packets::play::{self, Clientbound as C}, + text::translatable, +}; + +/// `PlayerInput` flags, as the server player's client last sent them. +pub(super) fn input_keys(flags: u8) -> Keys { + Keys { + forward: flags & 1 != 0, + backward: flags & 2 != 0, + left: flags & 4 != 0, + right: flags & 8 != 0, + jump: flags & 16 != 0, + shift: flags & 32 != 0, + ..Keys::default() + } +} + +fn corners(b: Aabb) -> ([f64; 3], [f64; 3]) { + let (lo, hi) = (b.min_position(), b.max_position()); + ([lo.x, lo.y, lo.z], [hi.x, hi.y, hi.z]) +} + +impl Game<'_> { + /// The box of a boat, minecart, armor stand, item frame or painting, and + /// the point an interact packet's location is measured from (the + /// client's `remote_object_hit` uses the same points). + pub(super) fn object_target(&self, id: i32) -> Option<([f64; 3], [f64; 3], [f64; 3])> { + let id = u32::try_from(id).ok()?; + let at = |v: Vec3| [v.x, v.y, v.z]; + let centre = |p: [i32; 3]| p.map(|v| f64::from(v) + 0.5); + if let Some(b) = self.boats.iter().find(|b| b.id == id) { + let (lo, hi) = corners(b.bounds()); + return Some((lo, hi, at(b.position))); + } + if let Some(c) = self.carts.iter().find(|c| c.id == id) { + let (lo, hi) = corners(c.bounds()); + return Some((lo, hi, at(c.position))); + } + if let Some(a) = self.armor_stands.iter().find(|a| a.id == id) { + let (lo, hi) = corners(a.bounds()); + return Some((lo, hi, at(a.position))); + } + if let Some(f) = self.item_frames.iter().find(|f| f.id == id) { + let (lo, hi) = f.bounds(); + return Some((lo, hi, centre(f.pos))); + } + let p = self.paintings.iter().find(|p| p.id == id)?; + let (lo, hi) = p.bounds(); + Some((lo, hi, centre(p.pos))) + } + + /// The vehicles the server's players ride: they move with their riders, + /// not in `tick_boats` and `tick_carts`. + pub(super) fn guest_vehicles(&self) -> Vec { + self.lan.as_ref().map_or_else(Vec::new, |h| { + h.hub.guests.iter().filter_map(|g| g.vehicle).collect() + }) + } + + /// Whether a server player other than the one acting rides `vehicle` + /// (`Entity.canAddPassenger`: a boat or minecart seats one player here). + pub(super) fn ridden_by_guest(&self, vehicle: u32) -> bool { + self.lan.as_ref().is_some_and(|h| { + h.hub + .guests + .iter() + .any(|g| Some(g.conn) != self.lan_acting && g.vehicle == Some(vehicle)) + }) + } + + /// `Player.rideTick` for a server player, before its moves this tick: + /// it stays in its seat, steers its minecart, or gets out. + pub(super) fn guest_vehicle_tick(&mut self, host: &mut LanHost, conn: u32) { + let Some(gi) = host.hub.guests.iter().position(|g| g.conn == conn) else { + return; + }; + let g = &host.hub.guests[gi]; + let Some(vehicle) = g.vehicle else { + return; + }; + let (keys, dead) = (input_keys(g.input), g.dead || g.health <= 0.0); + let boat = self.boats.iter().position(|b| b.id == vehicle); + let cart = self.carts.iter().any(|c| c.id == vehicle); + // The vehicle is gone (broken, in another level) or the rider died: + // its client drops it with the entity or the death screen. + if dead || (boat.is_none() && !cart) { + let g = &mut host.hub.guests[gi]; + (g.vehicle, g.vehicle_good) = (None, None); + return; + } + if let Some(i) = boat { + // AbstractBoat.tick on the server for a boat its rider drives: + // only the hurt animation and the damage wear off here. + let b = &mut self.boats[i]; + b.hurt_time = (b.hurt_time - 1).max(0); + b.damage = (b.damage - 1.0).max(0.0); + } + // Getting out goes through leave_guest, which tells the client and + // teleports it (ServerPlayer.dismountTo). + let seat = self.as_guest(host, conn, |game| { + if let Some(i) = game.boats.iter().position(|b| Some(b.id) == game.riding) { + if keys.shift { + game.dismount(i); + return None; + } + let p = game.boats[i].position; + return Some([p.x, p.y + SEAT, p.z]); + } + // The minecart moves with the rider's input, and lets it out when + // it sneaks or the cart breaks. + game.tick_cart_riding(keys); + game.riding?; + let p = game.player.as_ref()?.position; + Some([p.x, p.y, p.z]) + }); + if let Some(Some(at)) = seat { + let g = &mut host.hub.guests[gi]; + g.previous_position = g.position; + g.position = at; + } + } + + /// After an interaction: a player that got into a vehicle sits in it, + /// and its last good vehicle position is where the vehicle is. + pub(super) fn guest_boarded(&mut self, host: &mut LanHost, conn: u32, before: Option) { + let Some(gi) = host.hub.guests.iter().position(|g| g.conn == conn) else { + return; + }; + let Some(vehicle) = host.hub.guests[gi].vehicle else { + return; + }; + if before == Some(vehicle) { + return; + } + // The host in the window rides it already. + if self.riding == Some(vehicle) { + host.hub.guests[gi].vehicle = before; + return; + } + let at = self + .boats + .iter() + .find(|b| b.id == vehicle) + .map(|b| b.position) + .or_else(|| { + self.carts + .iter() + .find(|c| c.id == vehicle) + .map(|c| c.position) + }); + let g = &mut host.hub.guests[gi]; + if let Some(p) = at { + g.vehicle_good = Some([p.x, p.y, p.z]); + g.previous_position = g.position; + g.position = [p.x, p.y + SEAT, p.z]; + g.on_ground = false; + } + } + + /// `ServerGamePacketListenerImpl.handleMoveVehicle`: the boat its rider + /// drives goes where the client says, unless it moved too quickly or + /// wrongly; then it stays, and the client is told where it is. + pub(super) fn guest_move_vehicle( + &mut self, + host: &mut LanHost, + conn: u32, + p: &play::MoveVehicleRequest, + ) { + let Some(gi) = host.hub.guests.iter().position(|g| g.conn == conn) else { + return; + }; + let [x, y, z] = p.position; + if !(x.is_finite() && y.is_finite() && z.is_finite()) + || !p.yaw.is_finite() + || !p.pitch.is_finite() + { + host.hub.kick( + conn, + translatable("multiplayer.disconnect.invalid_vehicle_movement", &[]), + ); + return; + } + let g = &host.hub.guests[gi]; + if g.awaiting_teleport.is_some() || !g.loaded { + return; + } + let owner = host.hub.singleplayer_owner == Some(g.uuid); + let (vehicle, good) = (g.vehicle, g.vehicle_good); + let back = |host: &mut LanHost, position: Vec3, yaw: f32| { + let packet = play::MoveVehicle { + position: [position.x, position.y, position.z], + yaw, + pitch: 0.0, + }; + host.hub.send_to(conn, &C::MoveVehicle(packet)); + }; + // Only a boat is driven by its rider (getControllingPassenger); a + // minecart that is elsewhere on the client is put back. + let Some(i) = vehicle.and_then(|v| self.boats.iter().position(|b| b.id == v)) else { + if let Some(c) = vehicle.and_then(|v| self.carts.iter().find(|c| c.id == v)) + && c.position.distance_squared(Vec3::new(x, y, z)) > 1.0 + { + back(host, c.position, c.yaw); + } + return; + }; + let b = &self.boats[i]; + let old = b.position; + let good = good.map_or(old, |g| Vec3::new(g[0], g[1], g[2])); + let target = Vec3::new( + x.clamp(-3.0E7, 3.0E7), + y.clamp(-2.0E7, 2.0E7), + z.clamp(-3.0E7, 3.0E7), + ); + // Moved too quickly: more than 10 blocks past its own motion. + let moved = target.distance_squared(old) - b.velocity.length_squared(); + if moved > 100.0 && !owner { + log::warn!("boat {} moved too quickly! {moved}", b.id); + back(host, old, b.yaw); + return; + } + // vehicle.move(PLAYER, target - lastGood) with the boat's collisions: + // where it can't follow the client (a quarter block off, the height + // aside), it moved wrongly. + let bounds = b.bounds(); + let mut scene = SceneCollisions { + world: &self.world, + binding: self.collision, + subject: None, + }; + let wanted = target.subtract(good); + let resolved = scene + .resolve(bounds, wanted, 0.0, b.on_ground) + .unwrap_or(wanted); + let reached = old.add_vector(resolved); + let wrongly = (target.x - reached.x).powi(2) + (target.z - reached.z).powi(2) > 0.0625; + let free_before = scene.unobstructed(bounds).unwrap_or(true); + // isEntityCollidingWithAnythingNew: a box that was free is not there. + let moved_box = bounds.move_by(target.subtract(old)); + let free_after = scene + .unobstructed(moved_box.deflate(Vec3::new(1.0E-5, 1.0E-5, 1.0E-5))) + .unwrap_or(true); + if free_before && (wrongly || !free_after) { + log::warn!("boat {} moved wrongly", b.id); + back(host, old, b.yaw); + return; + } + let b = &mut self.boats[i]; + b.previous = old; + b.velocity = target.subtract(old); + b.position = target; + b.previous_yaw = b.yaw; + b.yaw = p.yaw; + b.on_ground = p.on_ground; + let g = &mut host.hub.guests[gi]; + g.vehicle_good = Some([target.x, target.y, target.z]); + g.previous_position = g.position; + g.position = [target.x, target.y + SEAT, target.z]; + } + + /// `handlePaddleBoat`: the paddles of the boat the player drives. + pub(super) fn guest_paddle_boat(&mut self, host: &LanHost, conn: u32, paddles: [bool; 2]) { + let vehicle = host + .hub + .guests + .iter() + .find(|g| g.conn == conn) + .and_then(|g| g.vehicle); + if let Some(b) = self.boats.iter_mut().find(|b| Some(b.id) == vehicle) { + b.paddling = paddles; + } + } +} diff --git a/crates/horizon-client/src/game/minecarts.rs b/crates/horizon-client/src/game/minecarts.rs index 367dc6aaf..756202530 100644 --- a/crates/horizon-client/src/game/minecarts.rs +++ b/crates/horizon-client/src/game/minecarts.rs @@ -775,10 +775,13 @@ impl Game<'_> { self.push_carts(); // ServerLevel.tick: only entities in entity-ticking chunks tick. let ticking = self.entity_ticking_area(); + // A server player's minecart moves with its rider (lan_vehicles.rs). + let ridden = self.guest_vehicles(); let mut i = 0; while i < self.carts.len() { let p = self.carts[i].position; if Some(self.carts[i].id) == self.riding + || ridden.contains(&self.carts[i].id) || !ticking(p.x.floor() as i32, p.z.floor() as i32) { i += 1; @@ -986,7 +989,7 @@ impl Game<'_> { let held = self.held().cloned(); match self.carts[i].kind { CartKind::Rideable => { - if sneaking || self.riding.is_some() { + if sneaking || self.riding.is_some() || self.ridden_by_guest(self.carts[i].id) { return false; } self.riding = Some(self.carts[i].id); diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 9d1e82e56..f3fe7b28f 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -93,7 +93,7 @@ pub(super) struct Remote { pub(super) registries: Arc, joined: bool, status: String, - entity_id: i32, + pub(super) entity_id: i32, dimension: DimensionType, biome_map: Vec, biome_bits: u8, @@ -1367,6 +1367,10 @@ impl Game<'_> { self.turn_remote_projectile(id, rotation); } fn remove_entity(&mut self, id: i32) { + // The vehicle the player rode is gone (Entity.removeVehicle). + if self.riding == Some(id as u32) { + self.riding = None; + } self.mobs.retain(|m| m.id != id as u32); self.orbs.retain(|o| o.id != id as u32); self.dropped.retain(|d| d.id != id as u32); @@ -1753,6 +1757,8 @@ impl Game<'_> { ]; self.move_entity(p.id, position, Some((p.yaw, p.pitch)), p.on_ground); } + C::SetPassengers(p) => self.remote_set_passengers(p.vehicle, &p.passengers), + C::MoveVehicle(p) => self.remote_move_vehicle(p.position, p.yaw), // ClientPacketListener.handleRotateMob: lerpHeadTo(yHeadRot, 3). C::RotateHead(p) => { if let Some(r) = self.remote.as_mut() { @@ -2932,9 +2938,9 @@ impl Game<'_> { self.capture_loaded_world(); } let stick = self.pad_move(); - let Some(player) = self.player.as_mut() else { + if self.player.is_none() { return Ok(()); - }; + } let playing = self.screen == Screen::Playing; let held = |k| playing && self.keys.contains(&k); let keys = Keys { @@ -2955,7 +2961,14 @@ impl Game<'_> { | u8::from(keys.jump) << 4 | u8::from(keys.shift) << 5 | u8::from(keys.sprint) << 6; - self.previous_position = player.position; + // A passenger moves with its vehicle (Entity.rideTick), not by itself. + let riding = self.screen != Screen::Dead && self.remote_ride(keys); + let Some(player) = self.player.as_mut() else { + return Ok(()); + }; + if !riding { + self.previous_position = player.position; + } let before = ( player.ground.on_ground, [player.velocity.x, player.velocity.y, player.velocity.z], @@ -2972,7 +2985,7 @@ impl Game<'_> { f64::from(head[2]) + 0.5, ); player.velocity = Vec3::ZERO; - } else if !dead { + } else if !dead && !riding { player.velocity = player.velocity.add_vector(pushed); MotionWorld { entities: &ghast_collisions, @@ -3319,6 +3332,8 @@ impl Game<'_> { p.sprinting, ); let (yaw, pitch, selected) = (self.yaw, self.pitch, self.selected); + let riding = self.riding.is_some(); + let vehicle = self.remote_vehicle_packets(); let Some(r) = self.remote.as_mut() else { return; }; @@ -3341,9 +3356,18 @@ impl Game<'_> { data: 0, })); } - if let Some(packet) = r - .position_sender - .update(pos, (yaw, pitch), on_ground, collision) + if riding { + // LocalPlayer.tick: a passenger sends its look, then the vehicle + // it controls. + out.push(S::MovePlayerRot(play::MovePlayerRot { + yaw, + pitch, + flags: u8::from(on_ground) | u8::from(collision) << 1, + })); + out.extend(vehicle); + } else if let Some(packet) = + r.position_sender + .update(pos, (yaw, pitch), on_ground, collision) { out.push(packet); } @@ -3574,6 +3598,21 @@ impl Game<'_> { fn remote_use_entity(&mut self) -> bool { let sneaking = self.keys.contains(&KeyCode::ShiftLeft); + // A boat, minecart, item frame, armor stand or painting nearer than + // any mob: the server uses it (AbstractBoat.interact boards it). + if let Some(hit) = self.remote_object_hit() + && self.mob_hit().is_none_or(|(_, d)| hit.distance < d) + && self.before_block(hit.distance) + { + self.send(S::Interact(play::Interact { + id: hit.id, + hand: 0, + location: hit.location, + secondary: sneaking, + })); + self.swing_arm(); + return true; + } if let Some((i, distance)) = self.mob_hit() && self.before_block(distance) { @@ -3953,6 +3992,14 @@ impl Game<'_> { id: self.creatures.projectiles[i].id as i32, })); self.reset_attack_strength(); + } else if let Some(hit) = self.remote_object_hit() + && self.mob_hit().is_none_or(|(_, d)| hit.distance < d) + && self.before_block(hit.distance) + { + // VehicleEntity.hurtServer, ItemFrame and ArmorStand hurtServer, + // a painting broken: the server decides. + self.send(S::Attack(play::Attack { id: hit.id })); + self.reset_attack_strength(); } else if let Some((i, distance)) = self.mob_hit() && self.before_block(distance) { diff --git a/crates/horizon-client/src/game/remote_objects.rs b/crates/horizon-client/src/game/remote_objects.rs index 4cf9cb1a8..101dd981d 100644 --- a/crates/horizon-client/src/game/remote_objects.rs +++ b/crates/horizon-client/src/game/remote_objects.rs @@ -188,7 +188,12 @@ impl Game<'_> { /// A move's rotation and ground state for an object. pub(super) fn turn_remote_object(&mut self, id: i32, yaw: Option, on_ground: bool) { let id = id as u32; + // The boat the player drives turns here (isLocalInstanceAuthoritative). + let driven = self.riding; if let Some(b) = self.boats.iter_mut().find(|b| b.id == id) { + if Some(id) == driven { + return; + } if let Some(yaw) = yaw { b.yaw = yaw; } @@ -213,7 +218,12 @@ impl Game<'_> { c.previous_yaw = c.yaw; c.position = step(c.id, c.position); } + // The boat the player drives moves here, not where the server says. + let driven = self.riding; for b in &mut self.boats { + if Some(b.id) == driven { + continue; + } b.previous = b.position; b.previous_yaw = b.yaw; b.position = step(b.id, b.position); diff --git a/crates/horizon-client/src/game/remote_vehicles.rs b/crates/horizon-client/src/game/remote_vehicles.rs new file mode 100644 index 000000000..dc3b2b686 --- /dev/null +++ b/crates/horizon-client/src/game/remote_vehicles.rs @@ -0,0 +1,181 @@ +//! Boats, minecarts, item frames, armor stands and paintings for a server's +//! client: single player on its server thread, a LAN guest, a player on a +//! dedicated server. +//! +//! The client aims at them like at mobs (`Minecraft.hitResult`, then +//! `ServerboundInteractPacket`), and rides the vehicle the server seats it in +//! (`ClientPacketListener.handleSetEntityPassengersPacket`). A boat is +//! controlled by its rider's client: it ticks here and its moves go to the +//! server (`LocalPlayer.tick`: `ServerboundMoveVehiclePacket`, +//! `AbstractBoat.tick`: `ServerboundPaddleBoatPacket`). A minecart moves on +//! the server with the rider's input, and the rider sits in it. +use super::{Game, Keys, view_vector}; +use horizon_core::geometry::Vec3; +use horizon_protocol::packets::play::{self, Serverbound as S}; + +/// An object under the crosshair: its entity id, how far along the view it +/// was hit, and where (`EntityHitResult.getLocation` minus the entity's +/// position, the interact packet's location). +pub(super) struct ObjectHit { + pub id: i32, + pub distance: f64, + pub location: [f64; 3], +} + +impl Game<'_> { + /// The nearest boat, minecart, item frame, armor stand or painting the + /// view hits within reach. + pub(super) fn remote_object_hit(&self) -> Option { + let eye = self.eye_position()?; + let dir = view_vector(self.yaw, self.pitch); + let at = |d: f64| { + [ + eye[0] + dir[0] * d, + eye[1] + dir[1] * d, + eye[2] + dir[2] * d, + ] + }; + let block_centre = |p: [i32; 3]| { + [ + f64::from(p[0]) + 0.5, + f64::from(p[1]) + 0.5, + f64::from(p[2]) + 0.5, + ] + }; + let mut hits: Vec<(i32, f64, [f64; 3])> = Vec::new(); + if let Some((i, d)) = self.painting_hit() { + let p = &self.paintings[i]; + hits.push((p.id as i32, d, block_centre(p.pos))); + } + if let Some((i, d)) = self.frame_hit() { + let f = &self.item_frames[i]; + hits.push((f.id as i32, d, block_centre(f.pos))); + } + if let Some((i, d, _)) = self.armor_stand_hit() { + let a = &self.armor_stands[i]; + let p = a.position; + hits.push((a.id as i32, d, [p.x, p.y, p.z])); + } + if let Some((i, d)) = self.boat_hit() { + let p = self.boats[i].position; + hits.push((self.boats[i].id as i32, d, [p.x, p.y, p.z])); + } + if let Some((i, d)) = self.cart_hit() { + let p = self.carts[i].position; + hits.push((self.carts[i].id as i32, d, [p.x, p.y, p.z])); + } + let (id, distance, origin) = hits.into_iter().min_by(|a, b| a.1.total_cmp(&b.1))?; + let point = at(distance); + Some(ObjectHit { + id, + distance, + location: [ + point[0] - origin[0], + point[1] - origin[1], + point[2] - origin[2], + ], + }) + } + + /// `ClientPacketListener.handleSetEntityPassengersPacket`: who rides + /// `vehicle` now. The local player gets in or out; mobs and other + /// players sit where the server keeps them. + pub(super) fn remote_set_passengers(&mut self, vehicle: i32, passengers: &[i32]) { + let Some(me) = self.remote.as_ref().map(|r| r.entity_id) else { + return; + }; + let vehicle_id = vehicle as u32; + for m in &mut self.mobs { + if m.extra.mount == Some(vehicle_id) && !passengers.contains(&(m.id as i32)) { + m.extra.mount = None; + } else if passengers.contains(&(m.id as i32)) { + m.extra.mount = Some(vehicle_id); + } + } + if passengers.contains(&me) { + if self.riding != Some(vehicle_id) { + self.riding = Some(vehicle_id); + if let Some(p) = self.player.as_mut() { + p.velocity = Vec3::ZERO; + p.fall_distance = 0.0; + } + } + } else if self.riding == Some(vehicle_id) { + // The server takes the player out, then teleports it. + self.riding = None; + } + } + + /// The local player's tick in its vehicle, in place of its own movement: + /// false when it rides nothing. + pub(super) fn remote_ride(&mut self, keys: Keys) -> bool { + let Some(id) = self.riding else { + return false; + }; + let seat = if let Some(i) = self.boats.iter().position(|b| b.id == id) { + // AbstractBoat.tick on the controlling client: steer and move. + let mut b = self.boats[i].clone(); + b.input = [keys.left, keys.right, keys.forward, keys.backward]; + let b = self.tick_boat(b, true); + // positionRider: the seat turns with the boat; clampRotation. + self.yaw += b.delta_rotation; + let delta = (self.yaw - b.yaw + 180.0).rem_euclid(360.0) - 180.0; + self.yaw += delta.clamp(-105.0, 105.0) - delta; + let seat = b.position; + self.boats[i] = b; + Some(seat) + } else { + // A minecart: the server moves it, the rider sits in it. + self.carts.iter().find(|c| c.id == id).map(|c| c.position) + }; + if let Some(p) = self.player.as_mut() { + self.previous_position = p.position; + if let Some(v) = seat { + p.position = Vec3::new(v.x, v.y + super::boats::SEAT, v.z); + } + p.velocity = Vec3::ZERO; + p.fall_distance = 0.0; + } + true + } + + /// `LocalPlayer.tick` for a passenger: the boat it controls goes to the + /// server every tick with its paddles (the rider's own position does not). + pub(super) fn remote_vehicle_packets(&self) -> Vec { + let Some(b) = self + .riding + .and_then(|id| self.boats.iter().find(|b| b.id == id)) + else { + return Vec::new(); + }; + vec![ + S::MoveVehicle(play::MoveVehicleRequest { + position: [b.position.x, b.position.y, b.position.z], + yaw: b.yaw, + pitch: 0.0, + on_ground: b.on_ground, + }), + S::PaddleBoat(play::PaddleBoat { + left: b.paddling[0], + right: b.paddling[1], + }), + ] + } + + /// `ClientPacketListener.handleMoveVehicle`: the server put the boat the + /// player drives back. + pub(super) fn remote_move_vehicle(&mut self, position: [f64; 3], yaw: f32) { + let Some(b) = self + .riding + .and_then(|id| self.boats.iter_mut().find(|b| b.id == id)) + else { + return; + }; + let at = Vec3::new(position[0], position[1], position[2]); + b.previous = at; + b.position = at; + b.yaw = yaw; + b.previous_yaw = yaw; + b.velocity = Vec3::ZERO; + } +} diff --git a/crates/horizon-client/src/lan/guest.rs b/crates/horizon-client/src/lan/guest.rs index 4be5aa29f..1916344bb 100644 --- a/crates/horizon-client/src/lan/guest.rs +++ b/crates/horizon-client/src/lan/guest.rs @@ -71,6 +71,13 @@ pub struct Guest { /// The permission level (0 none, 2 game masters, 4 owners). pub permission: u8, pub sneaking: bool, + /// The last `ServerboundPlayerInputPacket` flags (forward 1, backward 2, + /// left 4, right 8, jump 16, shift 32, sprint 64). + pub input: u8, + /// The boat or minecart the player rides (`Entity.getVehicle`). + pub vehicle: Option, + /// `ServerGamePacketListenerImpl.lastGoodX/Y/Z` of the vehicle it controls. + pub vehicle_good: Option<[f64; 3]>, pub sprinting: bool, pub fall_flying: bool, pub flying: bool, @@ -233,6 +240,9 @@ impl Guest { game_mode: SURVIVAL, permission: 0, sneaking: false, + input: 0, + vehicle: None, + vehicle_good: None, sprinting: false, fall_flying: false, flying: false, diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index bb24940f4..8d7b5e29a 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -1968,6 +1968,7 @@ impl Hub { g.center = None; } S::PlayerInput(p) => { + self.guests[i].input = p.flags; self.guests[i].sneaking = p.flags & 32 != 0; self.guests[i].sprinting = p.flags & 64 != 0 && p.flags & 1 != 0; } @@ -2050,6 +2051,11 @@ impl Hub { to[2].clamp(-3.0E7, 3.0E7), ]; let (yaw, pitch) = (wrap_degrees(yaw), wrap_degrees(pitch)); + // A passenger only turns: its vehicle carries it (absSnapTo where it is). + if g.vehicle.is_some() { + (g.yaw, g.pitch) = (yaw, pitch); + return; + } let d = [0, 1, 2].map(|k| to[k] - g.first_good[k]); let moved = d[0] * d[0] + d[1] * d[1] + d[2] * d[2]; if g.sleeping { diff --git a/crates/horizon-protocol/src/packets/play.rs b/crates/horizon-protocol/src/packets/play.rs index 537ecf6ef..e737258c5 100644 --- a/crates/horizon-protocol/src/packets/play.rs +++ b/crates/horizon-protocol/src/packets/play.rs @@ -672,6 +672,11 @@ packet!( /// ClientboundSetPassengersPacket: a vehicle and every entity riding it. SetPassengers { vehicle: i32 => VarInt, passengers: Vec => List } ); +packet!( + /// ClientboundMoveVehiclePacket: the server puts a vehicle its rider + /// controls back where it was (PositionAndRotation: x, y, z, yRot, xRot). + MoveVehicle { position: [f64; 3] => Vec3d, yaw: f32 => Float, pitch: f32 => Float } +); /// ClientboundSetEquipmentPacket: (EquipmentSlot ordinal, stack) pairs. pub struct Equipment; impl Codec)>> for Equipment { @@ -1529,6 +1534,7 @@ packet_enum!(Clientbound, crate::ids::play::clientbound { SetHeldSlot(SetHeldSlot) = SET_HELD_SLOT, SetObjective(SetObjective) = SET_OBJECTIVE, SetPassengers(SetPassengers) = SET_PASSENGERS, + MoveVehicle(MoveVehicle) = MOVE_VEHICLE, ProjectilePower(ProjectilePower) = PROJECTILE_POWER, SetPlayerInventory(SetPlayerInventory) = SET_PLAYER_INVENTORY, SetPlayerTeam(SetPlayerTeam) = SET_PLAYER_TEAM, @@ -1802,6 +1808,15 @@ packet!( packet!(MovePlayerPosRot { x: f64 => Double, y: f64 => Double, z: f64 => Double, yaw: f32 => Float, pitch: f32 => Float, flags: u8 => UByte }); packet!(MovePlayerRot { yaw: f32 => Float, pitch: f32 => Float, flags: u8 => UByte }); packet!(MovePlayerStatus { flags: u8 => UByte }); +packet!( + /// ServerboundMoveVehiclePacket: where the rider moved the vehicle it + /// controls (PositionAndRotation, then onGround). + MoveVehicleRequest { position: [f64; 3] => Vec3d, yaw: f32 => Float, pitch: f32 => Float, on_ground: bool => Bool } +); +packet!( + /// ServerboundPaddleBoatPacket: the boat's left and right paddles. + PaddleBoat { left: bool => Bool, right: bool => Bool } +); packet!(PickItemFromBlock { pos: [i32; 3] => Pos, include_data: bool => Bool }); packet!( /// ServerboundPlayerActionPacket.Action: 0 start destroy, 1 change destroy @@ -1869,6 +1884,8 @@ packet_enum!(Serverbound, crate::ids::play::serverbound { MovePlayerPosRot(MovePlayerPosRot) = MOVE_PLAYER_POS_ROT, MovePlayerRot(MovePlayerRot) = MOVE_PLAYER_ROT, MovePlayerStatus(MovePlayerStatus) = MOVE_PLAYER_STATUS_ONLY, + MoveVehicle(MoveVehicleRequest) = MOVE_VEHICLE, + PaddleBoat(PaddleBoat) = PADDLE_BOAT, PickItemFromBlock(PickItemFromBlock) = PICK_ITEM_FROM_BLOCK, PingRequest(crate::packets::status::Ping) = PING_REQUEST, PlayerAbilities(PlayerAbilitiesRequest) = PLAYER_ABILITIES, diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index cc1dc9fcf..3395c01f0 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -116,8 +116,13 @@ address. The script then checks, from both sides, what a guest's game used to ge and wheat on farmland grows (random ticks), however the host runs its world. - ladder: the guest climbs down ten blocks of ladder and lands unhurt: the server resets its fall distance on a ladder every tick, as LivingEntity.handleOnClimbable does (#1255). -- boats: the host (single player, on its server thread with --server-thread) right-clicks a - boat on water and rides it, sneaks out, and breaks it with its fists (#1222). +- boats: the host (single player, on its server thread or not) and the guest each right-click a + boat on water and ride it, paddle it forward (the other side sees it move), sneak out, + and break it with their fists (#1222). +- minecarts: the host and the guest each get into a minecart on rails, sneak out beside it, and break + it (#1222). +- frames: the host and the guest each put a diamond in an item frame and turn it, and put a + helmet on an armor stand and take it back (#1222). - flight: a player in creative double-taps jump and flies, stays up, and stops flying in survival: the guest, and on the server thread the host's window too, take what may fly from the server's abilities (ClientPacketListener.handlePlayerAbilities). @@ -159,7 +164,7 @@ ROOT = Path(__file__).resolve().parents[1] GUEST_NAME = 'Guest' # The host plays single player on its server thread (--server-thread). SERVER_THREAD = False -CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder', 'boats'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder', 'boats', 'minecarts', 'frames'] class Game: @@ -2312,50 +2317,175 @@ def check_ladder(host, guest, out): guest('command', command=f'tp @s {x + 0.5} {y} {z + 0.5}') +def board(player, kind, at): + """Right-click the `kind` object near `at` and check `player` rides it.""" + found = [o for o in player('status')['objects'] if o['kind'].endswith(kind) + and abs(o['position'][0] - at[0]) < 2 and abs(o['position'][2] - at[2]) < 2] + assert found, f'no {kind} near {at}' + vehicle = found[0] + vp = vehicle['position'] + player.raw('look-at', f'{vp[0]:.2f}', f'{vp[1] + 0.3:.2f}', f'{vp[2]:.2f}') + player.raw('mouse', 'right', 'click') + player.wait(10) + riding = player('status').get('riding') + assert riding == vehicle['id'], f'right-clicking the {kind} {vehicle["id"]}: riding {riding}' + return vehicle + + +def leave_vehicle(player, kind): + player.raw('key', 'shift', 'down') + player.wait(10) + player.raw('key', 'shift', 'up') + player.wait(10) + riding = player('status').get('riding') + assert riding is None, f'sneaking out of the {kind}: riding {riding}' + + +def break_vehicle(player, vehicle_id, kind): + """Hit it with fists until it breaks: VehicleEntity.tick takes 1 off its damage every tick.""" + for _ in range(10): + here = [o for o in player('status')['objects'] if o['id'] == vehicle_id] + if not here: + return + vp = here[0]['position'] + player.raw('look-at', f'{vp[0]:.2f}', f'{vp[1] + 0.3:.2f}', f'{vp[2]:.2f}') + player.raw('mouse', 'left', 'click') + player.wait(2) + raise AssertionError(f'ten hits left the {kind} in place') + + def check_boats(host, guest, out): - """#1222: the single player boards a boat on water with a right click, sneaks out, and breaks it.""" - x, y, z = (int(v // 1) for v in pos_of(host)) - bx = x + 3 - host('command', command='gamemode survival') - host('command', command=f'fill {bx - 1} {y} {z - 1} {bx + 1} {y + 3} {z + 1} minecraft:air') - host('command', command=f'fill {bx - 1} {y - 1} {z - 1} {bx + 1} {y - 1} {z + 1} minecraft:water') - host('command', command=f'summon minecraft:oak_boat {bx + 0.5} {y - 0.1} {z + 0.5}') - host.wait(30) - boats = [o for o in host('status')['objects'] if o['kind'].endswith('oak_boat') - and abs(o['position'][0] - (bx + 0.5)) < 2 and abs(o['position'][2] - (z + 0.5)) < 2] - try: - assert boats, 'the host sees no boat on the water' - boat = boats[0] - bp = boat['position'] - host.raw('look-at', f'{bp[0]:.2f}', f'{bp[1] + 0.3:.2f}', f'{bp[2]:.2f}') - host.raw('mouse', 'right', 'click') - host.wait(10) - riding = host('status').get('riding') - assert riding == boat['id'], f'right-clicking the boat {boat["id"]}: riding {riding}' - host.raw('key', 'shift', 'down') - host.wait(10) - host.raw('key', 'shift', 'up') - host.wait(10) - riding = host('status').get('riding') - assert riding is None, f'sneaking out of the boat: riding {riding}' - host('command', command=f'tp @s {x + 0.5} {y} {z + 0.5}') - host.wait(5) - gone = False - for _ in range(10): - here = [o for o in host('status')['objects'] if o['id'] == boat['id']] - if not here: - gone = True - break - bp = here[0]['position'] - host.raw('look-at', f'{bp[0]:.2f}', f'{bp[1] + 0.3:.2f}', f'{bp[2]:.2f}') - host.raw('mouse', 'left', 'click') - # VehicleEntity.tick takes 1 off the damage every tick: hit fast. - host.wait(2) - assert gone, 'ten hits left the boat in place' - return {'boat': boat['id'], 'rode': True, 'broken': True} - finally: - host('command', command=f'kill @e[type=minecraft:oak_boat,x={bx},y={y},z={z},distance=..6]') - host('command', command=f'fill {bx - 1} {y - 1} {z - 1} {bx + 1} {y - 1} {z + 1} minecraft:stone') + """#1222: the host (single player, on its server thread or not) and the guest each board a boat + on water with a right click, paddle it forward (the other side sees it move), sneak out, and + break it with their fists.""" + result = {} + for label, player, other in (('host', host, guest), ('guest', guest, host)): + x, y, z = (int(v // 1) for v in pos_of(player)) + bx = x + 3 + player('command', command='gamemode survival') + # A pool ten blocks long, with a path beside it to walk back to the boat. + player('command', command=f'fill {bx - 3} {y} {z - 1} {bx + 1} {y + 3} {z + 9} minecraft:air') + player('command', command=f'fill {bx - 3} {y - 1} {z - 1} {bx - 2} {y - 1} {z + 9} minecraft:stone') + player('command', command=f'fill {bx - 1} {y - 1} {z - 1} {bx + 1} {y - 1} {z + 9} minecraft:water') + player('command', command=f'summon minecraft:oak_boat {bx + 0.5} {y - 0.1} {z + 0.5}') + player.wait(30) + try: + boat = board(player, 'oak_boat', (bx + 0.5, y, z + 0.5)) + start = boat['position'] + # The summoned boat faces south: forward paddles it along the pool. + player.raw('key', 'w', 'down') + player.wait(30) + player.raw('key', 'w', 'up') + player.wait(20) + mine = [o for o in player('status')['objects'] if o['id'] == boat['id']] + assert mine, f'the {label} lost its boat' + moved = math.dist(start, mine[0]['position']) + assert moved > 0.5, f'paddling forward moved the {label}\'s boat {moved:.2f} blocks' + # The other side sees the boat where its rider took it (the server accepted its moves). + theirs = [o for o in objects_near(other, mine[0]['position'], 'objects') + if o['kind'].endswith('oak_boat')] + assert theirs, f'the other side sees no boat near the {label}\'s' + far = min(math.dist(o['position'], mine[0]['position']) for o in theirs) + assert far < 1.0, f'the other side sees the {label}\'s boat {far:.2f} blocks off' + leave_vehicle(player, 'boat') + player('command', command=f'tp @s {bx - 1.5} {y} {mine[0]["position"][2]:.2f}') + player.wait(5) + break_vehicle(player, boat['id'], 'boat') + result[label] = {'boat': boat['id'], 'paddled': round(moved, 2), 'broken': True} + finally: + player('command', command=f'kill @e[type=minecraft:oak_boat,x={bx},y={y},z={z + 4},distance=..10]') + player('command', command=f'fill {bx - 1} {y - 1} {z - 1} {bx + 1} {y - 1} {z + 9} minecraft:stone') + player('command', command=f'tp @s {x + 0.5} {y} {z + 0.5}') + player.wait(5) + return result + + +def check_minecarts(host, guest, out): + """#1222: the host and the guest each get into a minecart on rails with a right click, sneak out + beside it, and break it with their fists.""" + result = {} + for label, player in (('host', host), ('guest', guest)): + x, y, z = (int(v // 1) for v in pos_of(player)) + cx = x + 3 + player('command', command='gamemode survival') + player('command', command=f'fill {cx - 2} {y} {z - 2} {cx + 2} {y + 3} {z + 6} minecraft:air') + player('command', command=f'fill {cx - 2} {y - 1} {z - 2} {cx + 2} {y - 1} {z + 6} minecraft:stone') + player('command', command=f'fill {cx} {y} {z} {cx} {y} {z + 4} minecraft:rail') + player('command', command=f'summon minecraft:minecart {cx + 0.5} {y} {z + 0.5}') + player.wait(30) + try: + cart = board(player, 'minecart', (cx + 0.5, y, z + 0.5)) + seated = pos_of(player) + assert abs(seated[0] - (cx + 0.5)) < 0.6, f'the {label} sits at {seated}, not in the cart' + leave_vehicle(player, 'minecart') + out_at = pos_of(player) + assert math.dist(out_at, seated) > 0.3, f'the {label} stayed in its seat at {out_at}' + player.wait(5) + break_vehicle(player, cart['id'], 'minecart') + result[label] = {'cart': cart['id'], 'out_at': [round(v, 2) for v in out_at], 'broken': True} + finally: + player('command', command=f'kill @e[type=minecraft:minecart,x={cx},y={y},z={z},distance=..8]') + player('command', command=f'kill @e[type=minecraft:item,x={cx},y={y},z={z},distance=..8]') + player('command', command=f'fill {cx} {y} {z} {cx} {y} {z + 4} minecraft:air') + player('command', command=f'tp @s {x + 0.5} {y} {z + 0.5}') + player.wait(5) + return result + + +def check_frames(host, guest, out): + """#1222: the host and the guest each put a diamond in an item frame and turn it, and put a + helmet on an armor stand and take it back, with right clicks.""" + result = {} + for label, player, other in (('host', host, guest), ('guest', guest, host)): + x, y, z = (int(v // 1) for v in pos_of(player)) + player('command', command='gamemode survival') + # Within a survival player's 3 blocks of reach: a frame on a wall, an armor stand beside it. + player('command', command=f'fill {x - 2} {y} {z + 1} {x + 2} {y + 2} {z + 2} minecraft:air') + player('command', command=f'fill {x - 2} {y} {z + 3} {x + 2} {y + 2} {z + 3} minecraft:stone') + player('command', command=f'summon minecraft:item_frame {x + 0.5} {y + 1.5} {z + 2.97} ' + f'{{block_pos:[I;{x},{y + 1},{z + 2}],Facing:2b}}') + player('command', command=f'summon minecraft:armor_stand {x - 1.5} {y} {z + 1.5}') + player('command', command='clear @s') + player('command', command='item replace entity @s weapon.mainhand with minecraft:diamond') + player.wait(30) + try: + frame = [o for o in player('status')['objects'] if o['kind'].endswith('item_frame') + and o['position'] == [x, y + 1, z + 2]] + assert frame, f'the {label} sees no item frame at {[x, y + 1, z + 2]}' + player.raw('look-at', f'{x + 0.5:.2f}', f'{y + 1.5:.2f}', f'{z + 2.95:.2f}') + player.raw('mouse', 'right', 'click') + player.wait(10) + player.raw('mouse', 'right', 'click') + player.wait(10) + frame = [o for o in player('status')['objects'] if o['id'] == frame[0]['id']][0] + assert frame['item'] == 'minecraft:diamond', f'the {label}\'s frame holds {frame["item"]}' + assert frame['rotation'] == 1, f'the {label}\'s frame turned to {frame["rotation"]}' + theirs = [o for o in other('status')['objects'] if o['kind'].endswith('item_frame') + and o['position'] == [x, y + 1, z + 2]] + assert theirs and theirs[0]['item'] == 'minecraft:diamond' and theirs[0]['rotation'] == 1, \ + f'the other side sees the {label}\'s frame as {theirs}' + player('command', command='item replace entity @s weapon.mainhand with minecraft:iron_helmet') + player.wait(5) + stand = [o for o in player('status')['objects'] if o['kind'] == 'minecraft:armor_stand' + and abs(o['position'][0] - (x - 1.5)) < 0.5 and abs(o['position'][2] - (z + 1.5)) < 0.5] + assert stand, f'the {label} sees no armor stand' + player.raw('look-at', f'{x - 1.5:.2f}', f'{y + 1.7:.2f}', f'{z + 1.5:.2f}') + player.raw('mouse', 'right', 'click') + player.wait(10) + worn = [o for o in player('status')['objects'] if o['id'] == stand[0]['id']][0]['equipment'] + assert 'minecraft:iron_helmet' in worn, f'the {label}\'s armor stand wears {worn}' + player.raw('look-at', f'{x - 1.5:.2f}', f'{y + 1.7:.2f}', f'{z + 1.5:.2f}') + player.raw('mouse', 'right', 'click') + player.wait(10) + worn = [o for o in player('status')['objects'] if o['id'] == stand[0]['id']][0]['equipment'] + assert 'minecraft:iron_helmet' not in worn, f'taking the helmet back left {worn}' + result[label] = {'frame': 'diamond, turned', 'stand': 'helmet on and off'} + finally: + player('command', command=f'kill @e[type=!minecraft:player,x={x - 3},y={y - 1},z={z},dx=6,dy=4,dz=6]') + player('command', command=f'fill {x - 2} {y} {z + 3} {x + 2} {y + 2} {z + 3} minecraft:air') + player('command', command='clear @s') + return result + def check_growth(host, guest, out): """Block ticks near a guest 1000 blocks from the host: only the guest's tickets tick them.""" @@ -2669,7 +2799,7 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles, 'blast': check_blast, 'light': check_light, 'plates': check_plates, 'swings': check_swings, 'cracks': check_cracks, - 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder, 'boats': check_boats} + 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder, 'boats': check_boats, 'minecarts': check_minecarts, 'frames': check_frames} def run(ctl, out, resources, checks): From afd38744824ed6a5c3b08bbaf0dd07f7c7742e3b Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 22:15:17 +0200 Subject: [PATCH 064/126] Lightning for a server's players: the bolt and the sky flash With single player on its server thread the window drew no lightning, and LAN guests and dedicated-server players never did: the server never sent the bolt (it lived outside the tracked entities) and the client had nothing to draw for a lightning_bolt AddEntity. The server gives each bolt an entity id and tracks it like the other entities; the client adds a visual-only bolt for it (LightningBolt.tick off the server: sounds, the sky flash, the drawn bolt) and ticks bolts and the flash in its level tick. `status` reports bolts and flashes, and lan_e2e's `lightning` check summons one beside each player and asserts both sides get the bolt and the flash. lan_e2e: the vehicle checks put the players apart first, and run() sets HORIZON_SERVER_THREAD explicitly either way, as #1265 does. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game.rs | 3 + crates/horizon-client/src/game/control.rs | 2 + .../horizon-client/src/game/lan_entities.rs | 5 ++ crates/horizon-client/src/game/lightning.rs | 27 +++++++- crates/horizon-client/src/game/remote.rs | 3 + .../horizon-client/src/game/remote_objects.rs | 3 + tools/lan_e2e.py | 67 +++++++++++++++---- 7 files changed, 97 insertions(+), 13 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 48fc141c9..6bb86231c 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -1324,6 +1324,8 @@ struct Game<'a> { /// `ClientAvatarState`: walked distance and view bob. avatar: horizon_client::camera::AvatarBob, flash: u32, + /// Bolts that struck here and sky flashes they made, in total (`status`). + lightning_seen: [u32; 2], /// The head of the bed while sleeping; the visual timer also survives waking. sleeping: Option<[i32; 3]>, sleep_timer: u32, @@ -11615,6 +11617,7 @@ impl<'a> Game<'a> { dragging: false, avatar: Default::default(), flash: 0, + lightning_seen: [0; 2], sleeping: None, sleep_timer: 0, dim: Dim::Overworld, diff --git a/crates/horizon-client/src/game/control.rs b/crates/horizon-client/src/game/control.rs index 6fc456f8d..a04c89ebf 100644 --- a/crates/horizon-client/src/game/control.rs +++ b/crates/horizon-client/src/game/control.rs @@ -926,6 +926,8 @@ impl Game<'_> { status["heard"] = json!(self.audio.heard); // Boats, minecarts, armor stands, item frames and paintings. status["objects"] = json!(self.objects_status()); + status["lightning"] = json!({"bolts": self.bolts.len(), "struck": self.lightning_seen[0], + "flashes": self.lightning_seen[1], "flash": self.flash}); // Primed TNT, falling blocks, projectiles, tridents and end crystals. status["projectiles"] = json!(self.projectiles_status()); status diff --git a/crates/horizon-client/src/game/lan_entities.rs b/crates/horizon-client/src/game/lan_entities.rs index f433bc06b..5f46f7c21 100644 --- a/crates/horizon-client/src/game/lan_entities.rs +++ b/crates/horizon-client/src/game/lan_entities.rs @@ -273,6 +273,7 @@ impl Game<'_> { self.tridents.iter_mut().for_each(|t| give(&mut t.id)); self.rockets.iter_mut().for_each(|r| give(&mut r.id)); self.crystals.iter_mut().for_each(|c| give(&mut c.id)); + self.bolts.iter_mut().for_each(|b| give(&mut b.id)); } /// Primed TNT, falling blocks, projectiles, tridents, firework rockets and @@ -284,6 +285,10 @@ impl Game<'_> { None => 0, }; let at = |p: horizon_core::geometry::Vec3| [p.x, p.y, p.z]; + // LightningBolt: each client draws and flashes its own. + for b in self.bolts.iter().filter(|b| b.id != 0) { + out.push(state(b.id, "minecraft:lightning_bolt", b.at, 0.0, false)); + } for t in self.tnts.iter().filter(|t| t.id != 0) { let mut e = state(t.id, "minecraft:tnt", at(t.position), 0.0, t.on_ground); e.velocity = at(t.velocity); diff --git a/crates/horizon-client/src/game/lightning.rs b/crates/horizon-client/src/game/lightning.rs index 0f43c4c54..476cb5aa4 100644 --- a/crates/horizon-client/src/game/lightning.rs +++ b/crates/horizon-client/src/game/lightning.rs @@ -9,7 +9,9 @@ use horizon_client::mobs::{Damage, DamageKind, MobEvent, SpawnSetup, Species}; use horizon_core::{position::BlockPos, random::RandomSource}; pub(super) struct Bolt { - at: [f64; 3], + /// The entity id a server's players know it by (0 until it has one). + pub id: u32, + pub at: [f64; 3], life: i32, flashes: i32, seed: i64, @@ -131,7 +133,9 @@ impl Game<'_> { let r = &mut self.world.random; let seed = r.next_long(); let flashes = r.next_int_bound(3).unwrap_or(0) + 1; + self.lightning_seen[0] += 1; self.bolts.push(Bolt { + id: 0, at, life: 2, flashes, @@ -140,6 +144,24 @@ impl Game<'_> { converted: Vec::new(), }); } + /// `ClientLevel.addEntity` for a server's lightning bolt: on a client it + /// only flashes, sounds and draws (`LightningBolt.tick` off the server). + pub(super) fn spawn_remote_bolt(&mut self, id: u32, at: [f64; 3]) { + self.bolts.retain(|b| b.id != id); + let r = &mut self.world.random; + let seed = r.next_long(); + let flashes = r.next_int_bound(3).unwrap_or(0) + 1; + self.lightning_seen[0] += 1; + self.bolts.push(Bolt { + id, + at, + life: 2, + flashes, + seed, + visual_only: true, + converted: Vec::new(), + }); + } /// `spawnFire`: fire at the strike point and `extra` random neighbours. fn bolt_fire(&mut self, at: [f64; 3], extra: i32) { if self.ui.difficulty < 2 { @@ -216,6 +238,9 @@ impl Game<'_> { } } if b.life >= 0 { + if self.flash == 0 { + self.lightning_seen[1] += 1; + } self.flash = 2; if !b.visual_only { self.thunder_hit(b); diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index f3fe7b28f..c482d9728 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -3271,6 +3271,9 @@ impl Game<'_> { }; self.tick_remote_objects(&mut step); self.tick_remote_projectiles(&mut step); + // LightningBolt.tick on a client, and the sky flash fading. + self.flash = self.flash.saturating_sub(1); + self.tick_bolts(); } lerps.retain(|_, l| l.steps > 0); if let Some(r) = self.remote.as_mut() { diff --git a/crates/horizon-client/src/game/remote_objects.rs b/crates/horizon-client/src/game/remote_objects.rs index 101dd981d..4bba24946 100644 --- a/crates/horizon-client/src/game/remote_objects.rs +++ b/crates/horizon-client/src/game/remote_objects.rs @@ -52,6 +52,8 @@ impl Game<'_> { invisible: false, check_interval: 0, }); + } else if kind == "minecraft:lightning_bolt" { + self.spawn_remote_bolt(id, position); } else if kind == "minecraft:painting" { // The variant comes with the entity data; until then the // registry's first one (VariantUtils.getAny). @@ -284,5 +286,6 @@ impl Game<'_> { self.armor_stands.retain(|a| a.id != id); self.item_frames.retain(|f| f.id != id); self.paintings.retain(|p| p.id != id); + self.bolts.retain(|b| b.id != id); } } diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 3395c01f0..d4f34ff84 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -123,6 +123,8 @@ address. The script then checks, from both sides, what a guest's game used to ge it (#1222). - frames: the host and the guest each put a diamond in an item frame and turn it, and put a helmet on an armor stand and take it back (#1222). +- lightning: a bolt summoned beside the host, then the guest: both sides get the bolt and flash the + sky (on its server thread the host's window is a client of it too). - flight: a player in creative double-taps jump and flies, stays up, and stops flying in survival: the guest, and on the server thread the host's window too, take what may fly from the server's abilities (ClientPacketListener.handlePlayerAbilities). @@ -164,7 +166,7 @@ ROOT = Path(__file__).resolve().parents[1] GUEST_NAME = 'Guest' # The host plays single player on its server thread (--server-thread). SERVER_THREAD = False -CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder', 'boats', 'minecarts', 'frames'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder', 'boats', 'minecarts', 'frames', 'lightning'] class Game: @@ -2317,6 +2319,22 @@ def check_ladder(host, guest, out): guest('command', command=f'tp @s {x + 0.5} {y} {z + 0.5}') +def apart(host, guest): + """The host where it stands and the guest 12 blocks east, each on a stone floor with room + around: neither stands in the other's way (a ray from inside a player's box hits that player).""" + x, y, z = (int(v // 1) for v in pos_of(host)) + spots = {} + for label, player, dx in (('host', host, 0), ('guest', guest, 12)): + px = x + dx + host('command', command=f'fill {px - 3} {y - 1} {z - 3} {px + 4} {y - 1} {z + 6} minecraft:stone') + host('command', command=f'fill {px - 3} {y} {z - 3} {px + 4} {y + 3} {z + 6} minecraft:air') + player('command', command=f'tp @s {px + 0.5} {y} {z + 0.5} 0 0') + spots[label] = (px, y, z) + host.wait(10) + guest.wait(10) + return spots + + def board(player, kind, at): """Right-click the `kind` object near `at` and check `player` rides it.""" found = [o for o in player('status')['objects'] if o['kind'].endswith(kind) @@ -2359,8 +2377,9 @@ def check_boats(host, guest, out): on water with a right click, paddle it forward (the other side sees it move), sneak out, and break it with their fists.""" result = {} + spots = apart(host, guest) for label, player, other in (('host', host, guest), ('guest', guest, host)): - x, y, z = (int(v // 1) for v in pos_of(player)) + x, y, z = spots[label] bx = x + 3 player('command', command='gamemode survival') # A pool ten blocks long, with a path beside it to walk back to the boat. @@ -2404,8 +2423,9 @@ def check_minecarts(host, guest, out): """#1222: the host and the guest each get into a minecart on rails with a right click, sneak out beside it, and break it with their fists.""" result = {} + spots = apart(host, guest) for label, player in (('host', host), ('guest', guest)): - x, y, z = (int(v // 1) for v in pos_of(player)) + x, y, z = spots[label] cx = x + 3 player('command', command='gamemode survival') player('command', command=f'fill {cx - 2} {y} {z - 2} {cx + 2} {y + 3} {z + 6} minecraft:air') @@ -2436,8 +2456,9 @@ def check_frames(host, guest, out): """#1222: the host and the guest each put a diamond in an item frame and turn it, and put a helmet on an armor stand and take it back, with right clicks.""" result = {} + spots = apart(host, guest) for label, player, other in (('host', host, guest), ('guest', guest, host)): - x, y, z = (int(v // 1) for v in pos_of(player)) + x, y, z = spots[label] player('command', command='gamemode survival') # Within a survival player's 3 blocks of reach: a frame on a wall, an armor stand beside it. player('command', command=f'fill {x - 2} {y} {z + 1} {x + 2} {y + 2} {z + 2} minecraft:air') @@ -2487,6 +2508,33 @@ def check_frames(host, guest, out): return result +def check_lightning(host, guest, out): + """A bolt summoned beside each player: both sides get the bolt entity and flash the sky (the + host's window too on its server thread, FEATURES 4z(f)).""" + result = {} + for label, player in (('host', host), ('guest', guest)): + x, y, z = (int(v // 1) for v in pos_of(player)) + before = {g.name: g('status')['lightning'] for g in (host, guest)} + # No fire where it strikes: on stone with nothing around. + player('command', command=f'fill {x + 4} {y - 1} {z - 2} {x + 8} {y - 1} {z + 2} minecraft:stone') + player('command', command=f'fill {x + 4} {y} {z - 2} {x + 8} {y + 3} {z + 2} minecraft:air') + player('command', command=f'summon minecraft:lightning_bolt {x + 6.5} {y} {z + 0.5}') + seen = {} + for _ in range(40): + player.wait(1) + seen = {g.name: g('status')['lightning'] for g in (host, guest)} + if all(seen[n]['struck'] > before[n]['struck'] and seen[n]['flashes'] > before[n]['flashes'] + for n in seen): + break + player('command', command=f'fill {x + 4} {y} {z - 2} {x + 8} {y + 3} {z + 2} minecraft:air') + for n in seen: + assert seen[n]['struck'] > before[n]['struck'], f"{label}'s bolt: the {n} got no bolt ({seen[n]})" + assert seen[n]['flashes'] > before[n]['flashes'], f"{label}'s bolt: the {n}'s sky didn't flash ({seen[n]})" + result[label] = {n: {'bolts': seen[n]['struck'] - before[n]['struck'], + 'flashes': seen[n]['flashes'] - before[n]['flashes']} for n in seen} + return result + + def check_growth(host, guest, out): """Block ticks near a guest 1000 blocks from the host: only the guest's tickets tick them.""" x0, y0, z0 = pos_of(guest) @@ -2799,18 +2847,13 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles, 'blast': check_blast, 'light': check_light, 'plates': check_plates, 'swings': check_swings, 'cracks': check_cracks, - 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder, 'boats': check_boats, 'minecarts': check_minecarts, 'frames': check_frames} + 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder, 'boats': check_boats, 'minecarts': check_minecarts, 'frames': check_frames, 'lightning': check_lightning} def run(ctl, out, resources, checks): host, guest = Game('host', ctl, resources), Game('guest', ctl, resources) - # Without --server-thread the host runs the game's default, the world in the frame, as players - # get it (`boats` fails there if the default goes back to the server thread before it has - # vehicles, #1222). - if SERVER_THREAD: - host.d.env['HORIZON_SERVER_THREAD'] = '1' - else: - host.d.env.pop('HORIZON_SERVER_THREAD', None) + # Either way explicitly: the game's default is the server thread. + host.d.env['HORIZON_SERVER_THREAD'] = '1' if SERVER_THREAD else '0' results = {} try: host.pid = host('launch', wait=False, offscreen=sys.platform == 'darwin')['pid'] From 1a8dae9f2102a361c6e8d3d6e0c490921e00508b Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 22:23:32 +0200 Subject: [PATCH 065/126] lan_e2e boats: the pool in a stone basin, for worlds that float Co-Authored-By: Claude Opus 5.5 --- tools/lan_e2e.py | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index d4f34ff84..a93115f63 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -2382,9 +2382,10 @@ def check_boats(host, guest, out): x, y, z = spots[label] bx = x + 3 player('command', command='gamemode survival') - # A pool ten blocks long, with a path beside it to walk back to the boat. - player('command', command=f'fill {bx - 3} {y} {z - 1} {bx + 1} {y + 3} {z + 9} minecraft:air') - player('command', command=f'fill {bx - 3} {y - 1} {z - 1} {bx - 2} {y - 1} {z + 9} minecraft:stone') + # A pool ten blocks long in a stone basin (the world may float), with a path beside it to + # walk back to the boat. + player('command', command=f'fill {bx - 3} {y} {z - 2} {bx + 2} {y + 3} {z + 10} minecraft:air') + player('command', command=f'fill {bx - 3} {y - 2} {z - 2} {bx + 2} {y - 1} {z + 10} minecraft:stone') player('command', command=f'fill {bx - 1} {y - 1} {z - 1} {bx + 1} {y - 1} {z + 9} minecraft:water') player('command', command=f'summon minecraft:oak_boat {bx + 0.5} {y - 0.1} {z + 0.5}') player.wait(30) From 63d59b26cf1f16e1a0b3d725501b99164742e9a5 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 22:35:05 +0200 Subject: [PATCH 066/126] Benchmarks: the ThinkPad's runs, and Java's per-scene wins - ThinkPad (i7-7500U, HD Graphics 620, Mesa): Horizon v2026.10.22.04 (two flights per scene) against vanilla 26.3 (two games) at render distance 12. Java loads chunks faster there and flies the mountain faster; the page says so. Render distance 32 isn't published for it: neither game loaded the spawn in 5 minutes, and Horizon kept only 900 to 1,400 columns resident when given 25. - "Where Java is ahead" also lists scenes where vanilla's average beats Horizon's by more than 5%. Co-Authored-By: Claude Opus 5.5 --- website/data/benchmarks/fleet.json | 37 +- .../thinkpad/horizon-thinkpad-rd12.json | 606 ++++++++++++++++++ .../thinkpad/vanilla-thinkpad-r1-rd12.json | 371 +++++++++++ .../thinkpad/vanilla-thinkpad-r2-rd12.json | 371 +++++++++++ website/public/benchmarks.json | 105 ++- website/src/bench.js | 11 + 6 files changed, 1496 insertions(+), 5 deletions(-) create mode 100644 website/data/benchmarks/thinkpad/horizon-thinkpad-rd12.json create mode 100644 website/data/benchmarks/thinkpad/vanilla-thinkpad-r1-rd12.json create mode 100644 website/data/benchmarks/thinkpad/vanilla-thinkpad-r2-rd12.json diff --git a/website/data/benchmarks/fleet.json b/website/data/benchmarks/fleet.json index 95cfb83f8..90996aab5 100644 --- a/website/data/benchmarks/fleet.json +++ b/website/data/benchmarks/fleet.json @@ -1,17 +1,46 @@ [ { "machine": "Mac mini (M4 Pro)", - "reports": ["macmini/horizon-macmini-rd12.json"], + "reports": [ + "macmini/horizon-macmini-rd12.json" + ], "version": "v2026.10.22.04", "capped_fps": 144, "note": "On macOS this Horizon build presents its frames in step with the 144 Hz display even with VSync off, so its average frame rate here is capped at 144: compare the 1% lows and frame times instead. The Mac mini was also running other jobs during the runs (CI, simulators; 1-minute load average 20 to 56 on 14 threads), which costs both games, vanilla more at render distance 32." }, { "machine": "Mac mini (M4 Pro)", - "reports": ["macmini/horizon-macmini-rd32.json"], + "reports": [ + "macmini/horizon-macmini-rd32.json" + ], "version": "v2026.10.22.04", "capped_fps": 144 }, - { "machine": "Mac mini (M4 Pro)", "reports": ["macmini/vanilla-macmini-rd12.json"] }, - { "machine": "Mac mini (M4 Pro)", "reports": ["macmini/vanilla-macmini-rd32.json"] } + { + "machine": "Mac mini (M4 Pro)", + "reports": [ + "macmini/vanilla-macmini-rd12.json" + ] + }, + { + "machine": "Mac mini (M4 Pro)", + "reports": [ + "macmini/vanilla-macmini-rd32.json" + ] + }, + { + "machine": "ThinkPad (i7-7500U, HD Graphics 620)", + "reports": [ + "thinkpad/horizon-thinkpad-rd12.json" + ], + "version": "v2026.10.22.04", + "note": "A 2016 laptop: 2 cores / 4 threads and Intel integrated graphics, Linux with Mesa 26.1.8 (Horizon on Vulkan, vanilla on OpenGL). It has no screen attached, so both games drew to a GPU compositor (sway on the Intel GPU) in a 1280x720 window. Horizon ran two flights per scene, vanilla two separate games of one. Render distance 32 is not shown: in 5 minutes neither game finished loading the spawn, and given 25, Horizon kept only about 900 to 1,400 chunk columns resident on this machine instead of the 3,200 a full view holds, so the two games would not have drawn the same world." + }, + { + "machine": "ThinkPad (i7-7500U, HD Graphics 620)", + "reports": [ + "thinkpad/vanilla-thinkpad-r1-rd12.json", + "thinkpad/vanilla-thinkpad-r2-rd12.json" + ] + } ] diff --git a/website/data/benchmarks/thinkpad/horizon-thinkpad-rd12.json b/website/data/benchmarks/thinkpad/horizon-thinkpad-rd12.json new file mode 100644 index 000000000..cac13169f --- /dev/null +++ b/website/data/benchmarks/thinkpad/horizon-thinkpad-rd12.json @@ -0,0 +1,606 @@ +{ + "format": "horizon-benchmark-report", + "version": 1, + "kind": "game", + "created": "2026-10-22T19:03:59Z", + "app": { + "name": "horizon-client", + "version": "0.1.0", + "commit": "02260048" + }, + "hardware": { + "os": "linux", + "arch": "x86_64", + "cpu_threads": 4, + "os_version": "NixOS 26.05 (Yarara) (kernel 6.18.55)", + "cpu": "Intel(R) Core(TM) i7-7500U CPU @ 2.70GHz", + "ram_mb": 31984, + "gpu": { + "name": "Intel(R) HD Graphics 620 (KBL GT2)", + "vendor": "intel", + "driver": "Intel open-source Mesa driver Mesa 26.1.8", + "backend": "vulkan", + "kind": "integrated" + } + }, + "conditions": { + "scenario": "perf_bench:village,forest,ocean,mountain", + "seed": "1234", + "render_distance": 12, + "simulation_distance": 12, + "vsync": false, + "offscreen": false, + "repeats": 2, + "warmup_s": 2.0, + "load_avg_1m": 0.988, + "window": [ + 1280, + 720 + ] + }, + "metrics": { + "startup.title_ms": { + "n": 2, + "mean": 3359.833, + "stdev": 71.241, + "min": 3309.458, + "max": 3410.208, + "ci95": 640.068 + }, + "startup.world_ms": { + "n": 2, + "mean": 50794.052, + "stdev": 11192.703, + "min": 42879.616, + "max": 58708.488, + "ci95": 100560.827 + }, + "chunks.village.load_ms": { + "n": 2, + "mean": 44860.072, + "stdev": 4027.103, + "min": 42012.48, + "max": 47707.664, + "ci95": 36181.501 + }, + "chunks.village.meshed_count": { + "n": 2, + "mean": 18412.5, + "stdev": 723.37, + "min": 17901.0, + "max": 18924.0, + "ci95": 6499.119 + }, + "fps.village.avg_fps": { + "n": 2, + "mean": 272.998, + "stdev": 15.604, + "min": 261.964, + "max": 284.031, + "ci95": 140.192 + }, + "fps.village.low_1pct_fps": { + "n": 2, + "mean": 45.939, + "stdev": 2.832, + "min": 43.936, + "max": 47.941, + "ci95": 25.444 + }, + "fps.village.low_01pct_fps": { + "n": 2, + "mean": 29.722, + "stdev": 2.801, + "min": 27.741, + "max": 31.702, + "ci95": 25.164 + }, + "memory.village.gpu_mb": { + "n": 2, + "mean": 402.965, + "stdev": 2.093, + "min": 401.486, + "max": 404.445, + "ci95": 18.804 + }, + "chunks.forest.load_ms": { + "n": 2, + "mean": 67527.123, + "stdev": 1738.341, + "min": 66297.93, + "max": 68756.315, + "ci95": 15618.12 + }, + "chunks.forest.meshed_count": { + "n": 2, + "mean": 23490.0, + "stdev": 992.778, + "min": 22788.0, + "max": 24192.0, + "ci95": 8919.612 + }, + "fps.forest.avg_fps": { + "n": 2, + "mean": 246.342, + "stdev": 2.258, + "min": 244.745, + "max": 247.939, + "ci95": 20.291 + }, + "fps.forest.low_1pct_fps": { + "n": 2, + "mean": 48.098, + "stdev": 2.354, + "min": 46.433, + "max": 49.762, + "ci95": 21.149 + }, + "fps.forest.low_01pct_fps": { + "n": 2, + "mean": 31.405, + "stdev": 2.788, + "min": 29.433, + "max": 33.376, + "ci95": 25.05 + }, + "memory.forest.gpu_mb": { + "n": 2, + "mean": 458.26, + "stdev": 2.943, + "min": 456.179, + "max": 460.341, + "ci95": 26.443 + }, + "chunks.ocean.load_ms": { + "n": 2, + "mean": 51484.922, + "stdev": 3499.487, + "min": 49010.411, + "max": 53959.434, + "ci95": 31441.14 + }, + "chunks.ocean.meshed_count": { + "n": 2, + "mean": 17323.5, + "stdev": 75.66, + "min": 17270.0, + "max": 17377.0, + "ci95": 679.771 + }, + "fps.ocean.avg_fps": { + "n": 2, + "mean": 204.022, + "stdev": 2.495, + "min": 202.258, + "max": 205.786, + "ci95": 22.413 + }, + "fps.ocean.low_1pct_fps": { + "n": 2, + "mean": 36.306, + "stdev": 0.351, + "min": 36.058, + "max": 36.554, + "ci95": 3.151 + }, + "fps.ocean.low_01pct_fps": { + "n": 2, + "mean": 25.509, + "stdev": 0.501, + "min": 25.155, + "max": 25.863, + "ci95": 4.498 + }, + "memory.ocean.gpu_mb": { + "n": 2, + "mean": 421.627, + "stdev": 3.887, + "min": 418.878, + "max": 424.376, + "ci95": 34.926 + }, + "chunks.mountain.load_ms": { + "n": 2, + "mean": 75031.799, + "stdev": 8886.455, + "min": 68748.127, + "max": 81315.471, + "ci95": 79840.341 + }, + "chunks.mountain.meshed_count": { + "n": 2, + "mean": 17961.5, + "stdev": 225.567, + "min": 17802.0, + "max": 18121.0, + "ci95": 2026.607 + }, + "fps.mountain.avg_fps": { + "n": 2, + "mean": 111.151, + "stdev": 5.637, + "min": 107.165, + "max": 115.137, + "ci95": 50.646 + }, + "fps.mountain.low_1pct_fps": { + "n": 2, + "mean": 25.851, + "stdev": 13.871, + "min": 16.043, + "max": 35.659, + "ci95": 124.62 + }, + "fps.mountain.low_01pct_fps": { + "n": 2, + "mean": 17.065, + "stdev": 8.985, + "min": 10.711, + "max": 23.418, + "ci95": 80.728 + }, + "memory.mountain.gpu_mb": { + "n": 2, + "mean": 602.19, + "stdev": 3.887, + "min": 599.441, + "max": 604.938, + "ci95": 34.926 + }, + "memory.rss_peak_mb": { + "n": 2, + "mean": 986.4, + "stdev": 4.593, + "min": 983.152, + "max": 989.648, + "ci95": 41.27 + }, + "memory.rss_steady_mb": { + "n": 2, + "mean": 797.12, + "stdev": 11.351, + "min": 789.094, + "max": 805.146, + "ci95": 101.983 + } + }, + "frames": [ + { + "phase": "village", + "repeat": 0, + "frames": 3409, + "seconds": 12.002, + "avg_fps": 284.031, + "low_1pct_fps": 43.936, + "low_01pct_fps": 27.741, + "p50_ms": 2.557, + "p95_ms": 10.879, + "p99_ms": 16.323, + "p999_ms": 34.079, + "max_ms": 39.182, + "cpu_p50_ms": 2.08, + "gpu_p50_ms": 2.486, + "histogram": [ + 0, + 549, + 1776, + 607, + 95, + 66, + 35, + 17, + 41, + 117, + 46, + 27, + 16, + 7, + 5, + 5, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "village", + "repeat": 1, + "frames": 3144, + "seconds": 12.002, + "avg_fps": 261.964, + "low_1pct_fps": 47.941, + "low_01pct_fps": 31.702, + "p50_ms": 2.82, + "p95_ms": 11.328, + "p99_ms": 15.64, + "p999_ms": 25.788, + "max_ms": 46.032, + "cpu_p50_ms": 2.305, + "gpu_p50_ms": 3.02, + "histogram": [ + 0, + 109, + 1797, + 717, + 128, + 67, + 34, + 20, + 53, + 102, + 59, + 32, + 10, + 10, + 5, + 0, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "forest", + "repeat": 0, + "frames": 2937, + "seconds": 12.0, + "avg_fps": 244.745, + "low_1pct_fps": 49.762, + "low_01pct_fps": 33.376, + "p50_ms": 2.77, + "p95_ms": 11.641, + "p99_ms": 16.127, + "p999_ms": 28.686, + "max_ms": 31.833, + "cpu_p50_ms": 2.211, + "gpu_p50_ms": 3.023, + "histogram": [ + 0, + 65, + 1619, + 360, + 323, + 233, + 55, + 31, + 57, + 61, + 73, + 41, + 9, + 4, + 6, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "forest", + "repeat": 1, + "frames": 2976, + "seconds": 12.003, + "avg_fps": 247.939, + "low_1pct_fps": 46.433, + "low_01pct_fps": 29.433, + "p50_ms": 2.712, + "p95_ms": 11.957, + "p99_ms": 16.649, + "p999_ms": 33.203, + "max_ms": 34.667, + "cpu_p50_ms": 2.118, + "gpu_p50_ms": 2.977, + "histogram": [ + 0, + 107, + 1608, + 453, + 236, + 226, + 58, + 45, + 48, + 49, + 74, + 43, + 16, + 7, + 4, + 2, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "ocean", + "repeat": 0, + "frames": 2428, + "seconds": 12.004, + "avg_fps": 202.258, + "low_1pct_fps": 36.058, + "low_01pct_fps": 25.863, + "p50_ms": 3.921, + "p95_ms": 13.515, + "p99_ms": 20.018, + "p999_ms": 37.372, + "max_ms": 39.911, + "cpu_p50_ms": 2.261, + "gpu_p50_ms": 4.35, + "histogram": [ + 0, + 25, + 850, + 514, + 460, + 214, + 51, + 33, + 27, + 42, + 115, + 47, + 25, + 8, + 13, + 4, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "ocean", + "repeat": 1, + "frames": 2467, + "seconds": 11.988, + "avg_fps": 205.786, + "low_1pct_fps": 36.554, + "low_01pct_fps": 25.155, + "p50_ms": 3.432, + "p95_ms": 13.9, + "p99_ms": 21.587, + "p999_ms": 36.46, + "max_ms": 41.679, + "cpu_p50_ms": 2.325, + "gpu_p50_ms": 3.908, + "histogram": [ + 0, + 13, + 1018, + 563, + 304, + 166, + 66, + 35, + 36, + 66, + 81, + 58, + 31, + 19, + 7, + 2, + 2, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "mountain", + "repeat": 0, + "frames": 1383, + "seconds": 12.012, + "avg_fps": 115.137, + "low_1pct_fps": 35.659, + "low_01pct_fps": 23.418, + "p50_ms": 8.232, + "p95_ms": 16.336, + "p99_ms": 21.375, + "p999_ms": 35.291, + "max_ms": 50.114, + "cpu_p50_ms": 3.875, + "gpu_p50_ms": 8.272, + "histogram": [ + 0, + 0, + 30, + 150, + 102, + 95, + 114, + 220, + 297, + 135, + 86, + 92, + 40, + 15, + 4, + 2, + 0, + 1, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "mountain", + "repeat": 1, + "frames": 1286, + "seconds": 12.0, + "avg_fps": 107.165, + "low_1pct_fps": 16.043, + "low_01pct_fps": 10.711, + "p50_ms": 7.582, + "p95_ms": 20.742, + "p99_ms": 46.27, + "p999_ms": 82.86, + "max_ms": 103.861, + "cpu_p50_ms": 3.753, + "gpu_p50_ms": 7.922, + "histogram": [ + 0, + 0, + 62, + 156, + 96, + 86, + 110, + 259, + 188, + 73, + 61, + 88, + 42, + 23, + 21, + 4, + 6, + 7, + 3, + 1, + 0, + 0, + 0, + 0 + ] + } + ], + "label": "horizon-thinkpad" +} diff --git a/website/data/benchmarks/thinkpad/vanilla-thinkpad-r1-rd12.json b/website/data/benchmarks/thinkpad/vanilla-thinkpad-r1-rd12.json new file mode 100644 index 000000000..6b5533826 --- /dev/null +++ b/website/data/benchmarks/thinkpad/vanilla-thinkpad-r1-rd12.json @@ -0,0 +1,371 @@ +{ + "format": "horizon-benchmark-report", + "version": 1, + "kind": "game", + "created": "2026-10-22T19:14:38Z", + "app": { + "name": "minecraft", + "version": "26.3", + "mods": [ + { + "name": "fabric-loader", + "version": "0.19.5" + } + ] + }, + "hardware": { + "os": "linux", + "arch": "x86_64", + "cpu_threads": 4, + "os_version": "NixOS 26.05 (Yarara) (kernel 6.18.55)", + "cpu": "Intel(R) Core(TM) i7-7500U CPU @ 2.70GHz", + "ram_mb": 31984, + "gpu": { + "name": "Mesa Intel(R) HD Graphics 620 (KBL GT2)", + "vendor": "Intel", + "driver": "4.6 (Core Profile) Mesa 26.1.8", + "backend": "opengl", + "kind": "" + } + }, + "conditions": { + "scenario": "perf_bench:village,forest,ocean,mountain", + "seed": "1234", + "render_distance": 12, + "simulation_distance": 12, + "vsync": false, + "offscreen": false, + "repeats": 1, + "warmup_s": 2.0, + "load_avg_1m": 5.749, + "window": [ + 1280, + 720 + ] + }, + "metrics": { + "startup.title_ms": { + "n": 1, + "mean": 16138.646, + "stdev": null, + "min": 16138.646, + "max": 16138.646, + "ci95": null + }, + "startup.world_ms": { + "n": 1, + "mean": 68774.646, + "stdev": null, + "min": 68774.646, + "max": 68774.646, + "ci95": null + }, + "chunks.village.load_ms": { + "n": 1, + "mean": 53635.946, + "stdev": null, + "min": 53635.946, + "max": 53635.946, + "ci95": null + }, + "fps.village.avg_fps": { + "n": 1, + "mean": 89.712, + "stdev": null, + "min": 89.712, + "max": 89.712, + "ci95": null + }, + "fps.village.low_1pct_fps": { + "n": 1, + "mean": 23.313, + "stdev": null, + "min": 23.313, + "max": 23.313, + "ci95": null + }, + "fps.village.low_01pct_fps": { + "n": 1, + "mean": 17.52, + "stdev": null, + "min": 17.52, + "max": 17.52, + "ci95": null + }, + "chunks.forest.load_ms": { + "n": 1, + "mean": 45938.493, + "stdev": null, + "min": 45938.493, + "max": 45938.493, + "ci95": null + }, + "fps.forest.avg_fps": { + "n": 1, + "mean": 104.223, + "stdev": null, + "min": 104.223, + "max": 104.223, + "ci95": null + }, + "fps.forest.low_1pct_fps": { + "n": 1, + "mean": 29.079, + "stdev": null, + "min": 29.079, + "max": 29.079, + "ci95": null + }, + "fps.forest.low_01pct_fps": { + "n": 1, + "mean": 19.181, + "stdev": null, + "min": 19.181, + "max": 19.181, + "ci95": null + }, + "chunks.ocean.load_ms": { + "n": 1, + "mean": 32096.642, + "stdev": null, + "min": 32096.642, + "max": 32096.642, + "ci95": null + }, + "fps.ocean.avg_fps": { + "n": 1, + "mean": 103.183, + "stdev": null, + "min": 103.183, + "max": 103.183, + "ci95": null + }, + "fps.ocean.low_1pct_fps": { + "n": 1, + "mean": 22.0, + "stdev": null, + "min": 22.0, + "max": 22.0, + "ci95": null + }, + "fps.ocean.low_01pct_fps": { + "n": 1, + "mean": 12.275, + "stdev": null, + "min": 12.275, + "max": 12.275, + "ci95": null + }, + "chunks.mountain.load_ms": { + "n": 1, + "mean": 56418.74, + "stdev": null, + "min": 56418.74, + "max": 56418.74, + "ci95": null + }, + "fps.mountain.avg_fps": { + "n": 1, + "mean": 205.996, + "stdev": null, + "min": 205.996, + "max": 205.996, + "ci95": null + }, + "fps.mountain.low_1pct_fps": { + "n": 1, + "mean": 41.77, + "stdev": null, + "min": 41.77, + "max": 41.77, + "ci95": null + }, + "fps.mountain.low_01pct_fps": { + "n": 1, + "mean": 23.358, + "stdev": null, + "min": 23.358, + "max": 23.358, + "ci95": null + }, + "memory.rss_peak_mb": { + "n": 1, + "mean": 2200.957, + "stdev": null, + "min": 2200.957, + "max": 2200.957, + "ci95": null + }, + "memory.rss_steady_mb": { + "n": 1, + "mean": 2126.844, + "stdev": null, + "min": 2126.844, + "max": 2126.844, + "ci95": null + } + }, + "frames": [ + { + "phase": "village", + "repeat": 0, + "frames": 1077, + "seconds": 12.005, + "avg_fps": 89.712, + "low_1pct_fps": 23.313, + "low_01pct_fps": 17.52, + "p50_ms": 9.15, + "p95_ms": 23.582, + "p99_ms": 34.847, + "p999_ms": 56.312, + "max_ms": 57.842, + "histogram": [ + 0, + 0, + 0, + 2, + 36, + 106, + 149, + 175, + 132, + 138, + 92, + 88, + 71, + 47, + 28, + 8, + 2, + 3, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "forest", + "repeat": 0, + "frames": 1251, + "seconds": 12.003, + "avg_fps": 104.223, + "low_1pct_fps": 29.079, + "low_01pct_fps": 19.181, + "p50_ms": 8.002, + "p95_ms": 18.85, + "p99_ms": 26.464, + "p999_ms": 50.754, + "max_ms": 53.518, + "histogram": [ + 0, + 0, + 0, + 4, + 20, + 136, + 223, + 302, + 197, + 124, + 70, + 75, + 53, + 31, + 12, + 1, + 1, + 2, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "ocean", + "repeat": 0, + "frames": 1239, + "seconds": 12.008, + "avg_fps": 103.183, + "low_1pct_fps": 22.0, + "low_01pct_fps": 12.275, + "p50_ms": 7.959, + "p95_ms": 18.934, + "p99_ms": 24.948, + "p999_ms": 74.736, + "max_ms": 88.202, + "histogram": [ + 0, + 0, + 0, + 1, + 8, + 126, + 335, + 189, + 192, + 144, + 73, + 56, + 71, + 32, + 6, + 0, + 0, + 3, + 3, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "mountain", + "repeat": 0, + "frames": 2473, + "seconds": 12.005, + "avg_fps": 205.996, + "low_1pct_fps": 41.77, + "low_01pct_fps": 23.358, + "p50_ms": 3.996, + "p95_ms": 10.11, + "p99_ms": 17.299, + "p999_ms": 37.643, + "max_ms": 46.668, + "histogram": [ + 0, + 1, + 756, + 577, + 279, + 317, + 222, + 107, + 82, + 60, + 26, + 18, + 16, + 5, + 3, + 2, + 2, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + } + ], + "label": "vanilla-thinkpad-r1" +} diff --git a/website/data/benchmarks/thinkpad/vanilla-thinkpad-r2-rd12.json b/website/data/benchmarks/thinkpad/vanilla-thinkpad-r2-rd12.json new file mode 100644 index 000000000..d010f28df --- /dev/null +++ b/website/data/benchmarks/thinkpad/vanilla-thinkpad-r2-rd12.json @@ -0,0 +1,371 @@ +{ + "format": "horizon-benchmark-report", + "version": 1, + "kind": "game", + "created": "2026-10-22T19:20:01Z", + "app": { + "name": "minecraft", + "version": "26.3", + "mods": [ + { + "name": "fabric-loader", + "version": "0.19.5" + } + ] + }, + "hardware": { + "os": "linux", + "arch": "x86_64", + "cpu_threads": 4, + "os_version": "NixOS 26.05 (Yarara) (kernel 6.18.55)", + "cpu": "Intel(R) Core(TM) i7-7500U CPU @ 2.70GHz", + "ram_mb": 31984, + "gpu": { + "name": "Mesa Intel(R) HD Graphics 620 (KBL GT2)", + "vendor": "Intel", + "driver": "4.6 (Core Profile) Mesa 26.1.8", + "backend": "opengl", + "kind": "" + } + }, + "conditions": { + "scenario": "perf_bench:village,forest,ocean,mountain", + "seed": "1234", + "render_distance": 12, + "simulation_distance": 12, + "vsync": false, + "offscreen": false, + "repeats": 1, + "warmup_s": 2.0, + "load_avg_1m": 5.332, + "window": [ + 1280, + 720 + ] + }, + "metrics": { + "startup.title_ms": { + "n": 1, + "mean": 17463.142, + "stdev": null, + "min": 17463.142, + "max": 17463.142, + "ci95": null + }, + "startup.world_ms": { + "n": 1, + "mean": 67480.142, + "stdev": null, + "min": 67480.142, + "max": 67480.142, + "ci95": null + }, + "chunks.village.load_ms": { + "n": 1, + "mean": 50565.877, + "stdev": null, + "min": 50565.877, + "max": 50565.877, + "ci95": null + }, + "fps.village.avg_fps": { + "n": 1, + "mean": 93.221, + "stdev": null, + "min": 93.221, + "max": 93.221, + "ci95": null + }, + "fps.village.low_1pct_fps": { + "n": 1, + "mean": 20.719, + "stdev": null, + "min": 20.719, + "max": 20.719, + "ci95": null + }, + "fps.village.low_01pct_fps": { + "n": 1, + "mean": 12.956, + "stdev": null, + "min": 12.956, + "max": 12.956, + "ci95": null + }, + "chunks.forest.load_ms": { + "n": 1, + "mean": 48496.598, + "stdev": null, + "min": 48496.598, + "max": 48496.598, + "ci95": null + }, + "fps.forest.avg_fps": { + "n": 1, + "mean": 103.859, + "stdev": null, + "min": 103.859, + "max": 103.859, + "ci95": null + }, + "fps.forest.low_1pct_fps": { + "n": 1, + "mean": 26.111, + "stdev": null, + "min": 26.111, + "max": 26.111, + "ci95": null + }, + "fps.forest.low_01pct_fps": { + "n": 1, + "mean": 17.943, + "stdev": null, + "min": 17.943, + "max": 17.943, + "ci95": null + }, + "chunks.ocean.load_ms": { + "n": 1, + "mean": 34745.051, + "stdev": null, + "min": 34745.051, + "max": 34745.051, + "ci95": null + }, + "fps.ocean.avg_fps": { + "n": 1, + "mean": 103.828, + "stdev": null, + "min": 103.828, + "max": 103.828, + "ci95": null + }, + "fps.ocean.low_1pct_fps": { + "n": 1, + "mean": 28.222, + "stdev": null, + "min": 28.222, + "max": 28.222, + "ci95": null + }, + "fps.ocean.low_01pct_fps": { + "n": 1, + "mean": 16.856, + "stdev": null, + "min": 16.856, + "max": 16.856, + "ci95": null + }, + "chunks.mountain.load_ms": { + "n": 1, + "mean": 53136.991, + "stdev": null, + "min": 53136.991, + "max": 53136.991, + "ci95": null + }, + "fps.mountain.avg_fps": { + "n": 1, + "mean": 204.734, + "stdev": null, + "min": 204.734, + "max": 204.734, + "ci95": null + }, + "fps.mountain.low_1pct_fps": { + "n": 1, + "mean": 43.014, + "stdev": null, + "min": 43.014, + "max": 43.014, + "ci95": null + }, + "fps.mountain.low_01pct_fps": { + "n": 1, + "mean": 20.945, + "stdev": null, + "min": 20.945, + "max": 20.945, + "ci95": null + }, + "memory.rss_peak_mb": { + "n": 1, + "mean": 2086.688, + "stdev": null, + "min": 2086.688, + "max": 2086.688, + "ci95": null + }, + "memory.rss_steady_mb": { + "n": 1, + "mean": 2020.902, + "stdev": null, + "min": 2020.902, + "max": 2020.902, + "ci95": null + } + }, + "frames": [ + { + "phase": "village", + "repeat": 0, + "frames": 1119, + "seconds": 12.004, + "avg_fps": 93.221, + "low_1pct_fps": 20.719, + "low_01pct_fps": 12.956, + "p50_ms": 8.87, + "p95_ms": 20.999, + "p99_ms": 32.814, + "p999_ms": 69.794, + "max_ms": 84.579, + "histogram": [ + 0, + 0, + 0, + 1, + 19, + 130, + 125, + 211, + 187, + 140, + 89, + 85, + 63, + 40, + 18, + 4, + 2, + 3, + 2, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "forest", + "repeat": 0, + "frames": 1247, + "seconds": 12.007, + "avg_fps": 103.859, + "low_1pct_fps": 26.111, + "low_01pct_fps": 17.943, + "p50_ms": 8.071, + "p95_ms": 20.077, + "p99_ms": 27.606, + "p999_ms": 48.322, + "max_ms": 63.142, + "histogram": [ + 0, + 0, + 0, + 2, + 36, + 171, + 170, + 296, + 231, + 125, + 52, + 43, + 57, + 41, + 14, + 5, + 3, + 1, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "ocean", + "repeat": 0, + "frames": 1246, + "seconds": 12.001, + "avg_fps": 103.828, + "low_1pct_fps": 28.222, + "low_01pct_fps": 16.856, + "p50_ms": 7.949, + "p95_ms": 17.653, + "p99_ms": 24.326, + "p999_ms": 50.371, + "max_ms": 68.283, + "histogram": [ + 0, + 0, + 0, + 0, + 3, + 72, + 329, + 263, + 142, + 179, + 116, + 60, + 52, + 20, + 4, + 2, + 2, + 1, + 1, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "mountain", + "repeat": 0, + "frames": 2457, + "seconds": 12.001, + "avg_fps": 204.734, + "low_1pct_fps": 43.014, + "low_01pct_fps": 20.945, + "p50_ms": 4.356, + "p95_ms": 9.472, + "p99_ms": 14.185, + "p999_ms": 34.466, + "max_ms": 57.719, + "histogram": [ + 0, + 2, + 633, + 520, + 318, + 417, + 268, + 128, + 68, + 60, + 17, + 11, + 4, + 4, + 3, + 2, + 0, + 2, + 0, + 0, + 0, + 0, + 0, + 0 + ] + } + ], + "label": "vanilla-thinkpad-r2" +} diff --git a/website/public/benchmarks.json b/website/public/benchmarks.json index 8bb196f43..b443513e1 100644 --- a/website/public/benchmarks.json +++ b/website/public/benchmarks.json @@ -1,7 +1,7 @@ { "format": "horizon-benchmark-summary", "version": 1, - "generated": "2026-10-22T19:42:06Z", + "generated": "2026-10-22T20:35:03Z", "min_installs": 3, "groups": [ { @@ -210,6 +210,109 @@ "chunk_load_ms": 123217 } } + }, + { + "gpu": "Intel HD Graphics 620 (KBL GT2)", + "cpu": "Intel Core i7-7500U CPU @ 2.70GHz", + "render_distance": 12, + "game": "horizon", + "source": "us", + "machine": "ThinkPad (i7-7500U, HD Graphics 620)", + "measured": "2026-10-22", + "version": "v2026.10.22.04", + "backend": "vulkan", + "os": "linux", + "window": [ + 1280, + 720 + ], + "repeats": 2, + "load_avg_1m": 0.988, + "note": "A 2016 laptop: 2 cores / 4 threads and Intel integrated graphics, Linux with Mesa 26.1.8 (Horizon on Vulkan, vanilla on OpenGL). It has no screen attached, so both games drew to a GPU compositor (sway on the Intel GPU) in a 1280x720 window. Horizon ran two flights per scene, vanilla two separate games of one. Render distance 32 is not shown: in 5 minutes neither game finished loading the spawn, and given 25, Horizon kept only about 900 to 1,400 chunk columns resident on this machine instead of the 3,200 a full view holds, so the two games would not have drawn the same world.", + "medians": { + "avg_fps": 209, + "low_1pct_fps": 39, + "p95_ms": 14, + "world_ms": 50794, + "chunk_load_ms": 59726, + "rss_peak_mb": 986, + "rss_steady_mb": 797, + "cpu_p50_ms": 2.6, + "gpu_p50_ms": 4.5 + }, + "scenes": { + "village": { + "avg_fps": 273, + "low_1pct_fps": 46, + "chunk_load_ms": 44860 + }, + "forest": { + "avg_fps": 246, + "low_1pct_fps": 48, + "chunk_load_ms": 67527 + }, + "ocean": { + "avg_fps": 204, + "low_1pct_fps": 36, + "chunk_load_ms": 51485 + }, + "mountain": { + "avg_fps": 111, + "low_1pct_fps": 26, + "chunk_load_ms": 75032 + } + } + }, + { + "gpu": "Mesa Intel HD Graphics 620 (KBL GT2)", + "cpu": "Intel Core i7-7500U CPU @ 2.70GHz", + "render_distance": 12, + "game": "vanilla", + "source": "us", + "machine": "ThinkPad (i7-7500U, HD Graphics 620)", + "measured": "2026-10-22", + "version": "26.3", + "backend": "opengl", + "os": "linux", + "window": [ + 1280, + 720 + ], + "repeats": 2, + "load_avg_1m": 5.749, + "medians": { + "avg_fps": 126, + "low_1pct_fps": 29, + "p95_ms": 17, + "world_ms": 68127, + "chunk_load_ms": 46879, + "rss_peak_mb": 2144, + "rss_steady_mb": 2074, + "cpu_p50_ms": null, + "gpu_p50_ms": null + }, + "scenes": { + "village": { + "avg_fps": 91, + "low_1pct_fps": 22, + "chunk_load_ms": 52101 + }, + "forest": { + "avg_fps": 104, + "low_1pct_fps": 28, + "chunk_load_ms": 47218 + }, + "ocean": { + "avg_fps": 104, + "low_1pct_fps": 25, + "chunk_load_ms": 33421 + }, + "mountain": { + "avg_fps": 205, + "low_1pct_fps": 42, + "chunk_load_ms": 54778 + } + } } ] } diff --git a/website/src/bench.js b/website/src/bench.js index fdc97415f..27042a8d3 100644 --- a/website/src/bench.js +++ b/website/src/bench.js @@ -78,6 +78,17 @@ export function machineHtml(name, rows) { const javaWins = METRICS.flatMap((m) => distances.filter((rd) => compareRows(m, pick(rows, "horizon", rd), pick(rows, "vanilla", rd))?.wins === "java").map((rd) => `${m.label.toLowerCase()} at ${rd}`), ); + // Per scene too: an average that Horizon wins can hide a scene where Java is faster. + const sceneName = { village: "the village", forest: "the forest", ocean: "the ocean", mountain: "the mountain" }; + for (const rd of distances) { + const h = pick(rows, "horizon", rd); + const j = pick(rows, "vanilla", rd); + for (const [scene, js] of Object.entries(j?.scenes || {})) { + const hs = h?.scenes?.[scene]; + if (!hs?.avg_fps || !js?.avg_fps || (h.capped_fps && hs.avg_fps >= h.capped_fps * 0.97)) continue; + if (js.avg_fps > hs.avg_fps * 1.05) javaWins.push(`average FPS over ${sceneName[scene] || scene} at ${rd} (${format("fps", js.avg_fps)} against ${format("fps", hs.avg_fps)})`); + } + } const facts = [ ["CPU", first.cpu], ["GPU", first.gpu], From e5fbba281cba0d239ee111e0d7a7d26c0d85f27c Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 22:36:45 +0200 Subject: [PATCH 067/126] Releases: a title made of issue numbers reads its line from the notes "Horizon 2026.10.22.07: #1255, mob pushes, fix, #1222" now shows "Single player runs in the frame again until server players have vehicles and 3 more". Co-Authored-By: Claude Opus 5.5 --- website/src/estimate.test.mjs | 7 +++++++ website/src/releases.js | 17 +++++++++++++++++ 2 files changed, 24 insertions(+) diff --git a/website/src/estimate.test.mjs b/website/src/estimate.test.mjs index 913bc2fea..3666b7fa1 100644 --- a/website/src/estimate.test.mjs +++ b/website/src/estimate.test.mjs @@ -55,3 +55,10 @@ test("a base held to its display's refresh rate gives only a floor for the avera // The lows sit under the cap: still a range. assert.ok(e.low_1pct_fps.high > e.low_1pct_fps.low); }); + +test("a release title of issue numbers falls back to its notes", async () => { + const { parts } = await import("./releases.js"); + const r = { tag_name: "v2026.10.22.07", name: "Horizon 2026.10.22.07: #1255, mob pushes, fix, #1222", body: "### Fixed\n- Fix #1222: single player runs in the frame again (#1257, fixes #1222)\n- Mob pushes: one list per mob (#1205)\n" }; + assert.equal(parts(r).line, "Single player runs in the frame again and 1 more"); + assert.equal(parts({ ...r, name: "Horizon 2026.10.22.05: Hoppers, mob tick, server tick" }).line, "Hoppers, mob tick, server tick"); +}); diff --git a/website/src/releases.js b/website/src/releases.js index 845cc8903..2e6a2e524 100644 --- a/website/src/releases.js +++ b/website/src/releases.js @@ -15,9 +15,26 @@ export function parts(r) { const version = launcherVersion(r.tag_name) ?? r.tag_name.replace(/^v/, ""); const name = (r.name || "").trim(); let line = name.includes(": ") ? name.slice(name.indexOf(": ") + 2) : name.replace(/^Horizon( launcher)?\s*/i, "").replace(version, "").trim(); + if (junk(line)) line = fromNotes(r.body) || line; return { version, line: line.charAt(0).toUpperCase() + line.slice(1), date: (r.published_at || "").slice(0, 10) }; } +// A title made of issue numbers and "fix" ("#1255, mob pushes, fix, #1222") says nothing. +const junk = (line) => { + const bits = line.split(",").map((b) => b.trim()).filter(Boolean); + return bits.length > 1 && bits.filter((b) => /^(#\d+|fix(es)?|fixed)$/i.test(b)).length * 2 >= bits.length; +}; + +// The first item that isn't a bare "Fix #123:" prefix, as the line: "Mob pushes: one list per mob… and 3 more fixes". +function fromNotes(body) { + const s = sections(body); + const items = [...s.filter((x) => /^new|what's new/i.test(x.title)), ...s.filter((x) => /^fixed/i.test(x.title))].flatMap((x) => x.items).map(plainItem); + const clean = items.map((i) => i.replace(/^(fix|fixes)\s+#\d+:\s*/i, "").replace(/^\w+\([^)]*\):\s*/, "")).filter(Boolean); + if (!clean.length) return ""; + const first = clean[0].replace(/[.]$/, ""); + return clean.length > 1 ? `${first} and ${clean.length - 1} more` : first; +} + // The notes' "### Heading" sections and their top-level items, in order. export function sections(body) { const out = []; From 7f7a05cbd093b87093267bcb88541744d9fd8591 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 22:49:31 +0200 Subject: [PATCH 068/126] Play with Friends on single player's server thread Sharing a world with an invite code refused with the integrated server on its own thread ("open a singleplayer world first"): the window is a client there. It now shares that server as Open to LAN publishes it: friends_start publishes it when it isn't, the invite tunnel points at its port, stopping sharing unpublishes it again, and the pause menu shows the Friends entry with the players the server lists. test_friends.py --server-thread runs the host's world on its server thread; the host's own move and blocks go through /tp, /fill and /setblock, which the server answers in both modes. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game/friends.rs | 24 +++++++++++++++-------- tools/test_friends.py | 18 ++++++++++++++--- 2 files changed, 31 insertions(+), 11 deletions(-) diff --git a/crates/horizon-client/src/game/friends.rs b/crates/horizon-client/src/game/friends.rs index 51dfe3fbf..69192265e 100644 --- a/crates/horizon-client/src/game/friends.rs +++ b/crates/horizon-client/src/game/friends.rs @@ -52,10 +52,12 @@ impl Game<'_> { if self.friends.is_some() { return Ok(()); } - if self.remote.is_some() || self.title.is_some() { + // Single player on its server thread shares that server, as Open to + // LAN publishes it; another server can't be shared. + if self.title.is_some() || (self.remote.is_some() && self.integrated.is_none()) { return Err("open a singleplayer world first".into()); } - let opened_lan = self.lan.is_none(); + let opened_lan = self.lan_port().is_none(); if opened_lan { // ShareToLanScreen's defaults, as the world options screen offers them. self.lan_open(LanSettings { @@ -171,14 +173,20 @@ impl Game<'_> { /// What the pause menu shows. pub(super) fn friends_view(&self) -> FriendsView { - let guests = self - .lan - .as_ref() - .map(|h| h.hub.guests.iter().map(|g| g.name.clone()).collect()) - .unwrap_or_default(); + let guests = match &self.lan { + Some(h) => h.hub.guests.iter().map(|g| g.name.clone()).collect(), + // On the server thread: the other players the server lists. + None if self.integrated.is_some() => { + let me = self.options.player_name(); + let mut names = self.remote_online_names().unwrap_or_default(); + names.retain(|n| *n != me); + names + } + None => Vec::new(), + }; let Some(s) = &self.friends else { return FriendsView { - shown: self.remote.is_none(), + shown: self.remote.is_none() || self.integrated.is_some(), ..FriendsView::default() }; }; diff --git a/tools/test_friends.py b/tools/test_friends.py index f89f3e599..3daeb28e7 100644 --- a/tools/test_friends.py +++ b/tools/test_friends.py @@ -15,6 +15,9 @@ is off: nothing leaves the machine. python3 tools/test_friends.py --client target/fast/horizon-client --relay target/fast/horizon-relay +`--server-thread` runs the host's world on its integrated server's own +thread (the window is a client of it, as Open to LAN publishes it). + `--role host|guest` runs one side only (two machines, e.g. over a tailnet): the host prints the code, the guest takes it with `--code` (`--relay-url` for a relay elsewhere, `--path relay` to force it). Needs a display on Linux @@ -86,8 +89,12 @@ class Game: # Extra words before and after the client (`--xvfb`, `--offscreen`). prefix = [] extra = [] + # The host's world on its server thread (`--server-thread`), else in the window. + server_thread = False def __init__(self, client, resources, work, name, env): + # Either way explicitly, whatever the game's default. + env = dict(env, HORIZON_SERVER_THREAD='1' if Game.server_thread and name == 'host' else '0') self.home = work / name self.home.mkdir() self.endpoint = self.home / 'c.sock' @@ -155,7 +162,9 @@ def play_together(host, guest, name, round_index): # The host moves; the guest sees the host's player there. hp = host('status')['player']['position'] target = [hp[0] + 3.0, hp[1], hp[2] + 1.0] - host(f'tp {target[0]} {target[1]} {target[2]}') + # The /tp command, not the control socket's local move: on the server thread the window is a + # client, and its server has the last word on where the host stands. + host(f'command tp @s {target[0]} {target[1]} {target[2]}') guest.wait('status', lambda v: any(math.dist(p, target) < 0.6 for p in v['server']['player_positions']), 20, 'host movement on the guest') # A block the host places, which the guest sees and then breaks. @@ -163,8 +172,9 @@ def play_together(host, guest, name, round_index): feet = [math.floor(gp[0]), math.floor(gp[1]), math.floor(gp[2])] block = [feet[0] + 2, feet[1] + 1, feet[2]] # Clear the line of sight (the test terrain has hills), then the block at eye level. - host(f'fill {feet[0] + 1} {feet[1]} {feet[2]} {feet[0] + 1} {feet[1] + 2} {feet[2]} minecraft:air') - host(f'setblock {block[0]} {block[1]} {block[2]} minecraft:gold_block') + # As commands, for the same reason as the /tp above. + host(f'command fill {feet[0] + 1} {feet[1]} {feet[2]} {feet[0] + 1} {feet[1] + 2} {feet[2]} minecraft:air') + host(f'command setblock {block[0]} {block[1]} {block[2]} minecraft:gold_block') guest.wait(f'getblock {block[0]} {block[1]} {block[2]}', lambda v: v['block'] == 'minecraft:gold_block', 20, 'the host block on the guest') eye = [gp[0], gp[1] + 1.62, gp[2]] @@ -343,10 +353,12 @@ def main(): parser.add_argument('--hold', type=float, default=0, help='guest: stay this many seconds before leaving') parser.add_argument('--baseline', action='store_true', help='first run the same checks over plain LAN') parser.add_argument('--offscreen', action='store_true', help='run the games without a window') + parser.add_argument('--server-thread', action='store_true', help="the host's world on its server thread") parser.add_argument('--xvfb', action='store_true', help='run the games under xvfb-run (headless Linux)') args = parser.parse_args() Game.prefix = ['xvfb-run', '-a'] if args.xvfb else [] Game.extra = ['--offscreen'] if args.offscreen else [] + Game.server_thread = args.server_thread args.client, args.resources = args.client.resolve(), args.resources.resolve() # Short: Unix socket paths are limited to about 100 bytes. with tempfile.TemporaryDirectory(prefix='hzf-', dir='/tmp') as directory: From 9f54087a8694a4d9b620240a93b29bad14020ef4 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Thu, 22 Oct 2026 23:04:29 +0200 Subject: [PATCH 069/126] Win screen: cover main's menu-blur match (Screen::Win) Main's Screen::blurs_background (in-world menu blur) has no arm for the new Screen::Win. WinScreen.extractBackground fills the screen with the End portal while the poem rolls and falls back to Screen.extractBackground (blurred) for the credits alone, so Game::menu_blur blurs only for the credits without the poem. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game.rs | 3 ++- crates/horizon-client/src/game/screens.rs | 4 ++++ 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 9e06e12bb..8e4f96d46 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -10061,7 +10061,8 @@ impl Game<'_> { }) || (self.title.is_none() && self.player.is_some() - && self.screen.blurs_background(self.pause_menu))); + && (self.screen.blurs_background(self.pause_menu) + || (self.screen == Screen::Win && self.win_screen_pauses())))); let radius = self.settings.menu_blur as f32; (blurred && radius >= 1.0).then_some(radius) } diff --git a/crates/horizon-client/src/game/screens.rs b/crates/horizon-client/src/game/screens.rs index 07eacfb49..b2b869340 100644 --- a/crates/horizon-client/src/game/screens.rs +++ b/crates/horizon-client/src/game/screens.rs @@ -21,6 +21,9 @@ impl Screen { | Self::Inventory | Self::Dead | Self::CommandBlock => false, + // WinScreen.extractBackground: the poem fills the screen with the End portal, the + // credits alone blur. Game::menu_blur knows which one rolls. + Self::Win => false, } } } @@ -375,6 +378,7 @@ mod tests { Screen::Inventory, Screen::Dead, Screen::CommandBlock, + Screen::Win, ] { assert!(!screen.blurs_background(true)); assert!(!screen.blurs_background(false)); From 18bf8cd2ef0fda0582bf59540ade05d0ce5a9d27 Mon Sep 17 00:00:00 2001 From: levzzz <86072227+levzzz5154@users.noreply.github.com> Date: Fri, 23 Oct 2026 02:52:48 +0500 Subject: [PATCH 070/126] Minecarts push each other in their own ticks, as vanilla does OldMinecartBehavior.tick ends with pushAndPickupEntities: after a cart moves, every other cart in its box (0.2 wider) gets push(cart). Horizon pushed all pairs once before any cart moved, so carts placed inside each other stayed exactly overlapping (push skips distances under 1e-4) and never split apart. Pushes now run per cart, after its move, with pushOtherMinecart's Mth sin table facing and float thresholds. --- crates/horizon-client/src/game/minecarts.rs | 119 +++++++++++--------- 1 file changed, 68 insertions(+), 51 deletions(-) diff --git a/crates/horizon-client/src/game/minecarts.rs b/crates/horizon-client/src/game/minecarts.rs index 756202530..b9d7f3893 100644 --- a/crates/horizon-client/src/game/minecarts.rs +++ b/crates/horizon-client/src/game/minecarts.rs @@ -16,7 +16,7 @@ use horizon_client::{ sound_engine::{CartSound, SoundEngine, SoundInstance, Sounds}, }; use horizon_core::{ - geometry::{Aabb, Vec3}, + geometry::{Aabb, Vec3, trig}, random::RandomSource, }; use horizon_world::registry::BlockStateId; @@ -683,8 +683,7 @@ impl Game<'_> { } } } - /// `AbstractMinecart.push(player)` when the player walks into a cart, - /// and carts pushing each other (`pushOtherMinecart`). + /// `AbstractMinecart.push(player)` when the player walks into a cart. fn push_carts(&mut self) { let player = self.player.as_ref().map(|p| p.position); let riding = self.riding; @@ -719,55 +718,71 @@ impl Game<'_> { } } } - for j in i + 1..self.carts.len() { - let (a, b) = (&self.carts[i], &self.carts[j]); - if !a - .bounds() - .inflate(Vec3::new(0.2, 0.0, 0.2)) - .intersects(b.bounds()) - { - continue; - } - let (mut xa, mut za) = (b.position.x - a.position.x, b.position.z - a.position.z); - let dd = xa * xa + za * za; - if dd < 1.0e-4 { - continue; - } - let d = dd.sqrt(); - let pow = (1.0 / d).min(1.0); - xa = xa / d * pow * f64::from(0.1f32) * 0.5; - za = za / d * pow * f64::from(0.1f32) * 0.5; - let dir = - glam::DVec2::new(b.position.x - a.position.x, b.position.z - a.position.z) - .normalize_or_zero(); - let r = a.yaw.to_radians(); - let facing = - glam::DVec2::new(f64::from(r.cos()), f64::from(r.sin())).normalize_or_zero(); - if dir.dot(facing).abs() < f64::from(0.8f32) { - continue; - } - let (ma, mb) = (a.velocity, b.velocity); - let (fa, fb) = (a.kind == CartKind::Furnace, b.kind == CartKind::Furnace); - let (na, nb) = if fb && !fa { - ( - Vec3::new(ma.x * 0.2 + mb.x - xa, ma.y, ma.z * 0.2 + mb.z - za), - Vec3::new(mb.x * 0.95, mb.y, mb.z * 0.95), - ) - } else if fa && !fb { - ( - Vec3::new(ma.x * 0.95, ma.y, ma.z * 0.95), - Vec3::new(mb.x * 0.2 + ma.x + xa, mb.y, mb.z * 0.2 + ma.z + za), - ) - } else { - let (xdd, zdd) = ((mb.x + ma.x) / 2.0, (mb.z + ma.z) / 2.0); - ( - Vec3::new(ma.x * 0.2 + xdd - xa, ma.y, ma.z * 0.2 + zdd - za), - Vec3::new(mb.x * 0.2 + xdd + xa, mb.y, mb.z * 0.2 + zdd + za), - ) - }; - self.carts[i].velocity = na; - self.carts[j].velocity = nb; + } + } + /// `OldMinecartBehavior.pushAndPickupEntities` for carts, at the end of + /// cart `i`'s own tick: each other cart in its box (0.2 wider on each + /// side) gets `push(cart i)`. Running it per cart, after that cart moved + /// and before the next one does, is what splits stacked carts apart. + fn push_from_cart(&mut self, i: usize) { + let reach = f64::from(0.2f32); + let hitbox = self.carts[i].bounds().inflate(Vec3::new(reach, 0.0, reach)); + for j in 0..self.carts.len() { + if j == i || !hitbox.intersects(self.carts[j].bounds()) { + continue; } + // AbstractMinecart.push(entity): `this` is cart j, `entity` cart i. + let (this, other) = (&self.carts[j], &self.carts[i]); + let (mut xa, mut za) = ( + other.position.x - this.position.x, + other.position.z - this.position.z, + ); + let dd = xa * xa + za * za; + if dd < f64::from(1.0e-4f32) { + continue; + } + let d = dd.sqrt(); + xa /= d; + za /= d; + let pow = (1.0 / d).min(1.0); + xa = xa * pow * f64::from(0.1f32) * 0.5; + za = za * pow * f64::from(0.1f32) * 0.5; + // pushOtherMinecart (old movement): only along this cart's facing. + let dir = glam::DVec2::new( + other.position.x - this.position.x, + other.position.z - this.position.z, + ) + .normalize_or_zero(); + let r = f64::from(this.yaw * 0.017453292f32); + let facing = glam::DVec2::new(f64::from(trig::cos(r)), f64::from(trig::sin(r))) + .normalize_or_zero(); + if dir.dot(facing).abs() < f64::from(0.8f32) { + continue; + } + let (mt, mo) = (this.velocity, other.velocity); + let (ft, fo) = ( + this.kind == CartKind::Furnace, + other.kind == CartKind::Furnace, + ); + let (nt, no) = if fo && !ft { + ( + Vec3::new(mt.x * 0.2 + (mo.x - xa), mt.y, mt.z * 0.2 + (mo.z - za)), + Vec3::new(mo.x * 0.95, mo.y, mo.z * 0.95), + ) + } else if !fo && ft { + ( + Vec3::new(mt.x * 0.95, mt.y, mt.z * 0.95), + Vec3::new(mo.x * 0.2 + (mt.x + xa), mo.y, mo.z * 0.2 + (mt.z + za)), + ) + } else { + let (xdd, zdd) = ((mo.x + mt.x) / 2.0, (mo.z + mt.z) / 2.0); + ( + Vec3::new(mt.x * 0.2 + (xdd - xa), mt.y, mt.z * 0.2 + (zdd - za)), + Vec3::new(mo.x * 0.2 + (xdd + xa), mo.y, mo.z * 0.2 + (zdd + za)), + ) + }; + self.carts[j].velocity = nt; + self.carts[i].velocity = no; } } /// Every cart but the ridden one (which ticks with its rider). @@ -794,6 +809,7 @@ impl Game<'_> { } if alive { self.carts[i] = c; + self.push_from_cart(i); i += 1; } else { self.carts.remove(i); @@ -867,6 +883,7 @@ impl Game<'_> { } if alive { self.carts[i] = c; + self.push_from_cart(i); } else { self.carts.remove(i); self.riding = None; From 525129fbe681fb4c8393f7f3c1fb9343f568ebd7 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 00:40:34 +0200 Subject: [PATCH 071/126] Riding animals for a server's players Single player on its server thread, LAN guests and dedicated-server players could not ride: a server player's turn had no mount input, and its client had nothing to sit on. The server now drives a server player's animal from that player's PlayerInput (forward, back, strafe, jump, sneak, sprint) and rotation, through the same tick_mount_riding the window's player uses: - the jump bar charges per player (MountState swapped with the turn); - sneaking gets off, with SetPassengers and the teleport beside it; - a mount ridden by another player can't be taken or fed (isVehicle); - an animal whose rider left stops taking its input. The client sits where positionRider puts it on the animal it was sent, and charges its own jump bar for the HUD. Ridden movement (pre-existing, also in the window): Mob.setSpeed sets zza too, so the ridden input set before the speed was lost and pigs and striders crawled while horses walked on with no key held; the input is now set after the speed (travelRidden). The ridden speed uses the effective movement speed (a cold strider's modifier, potions), and a shivering strider rides at 0.35 of it (Strider.getRiddenSpeed). lan_e2e riding: the host and a guest saddle and ride a horse (walk and jump), a pig and a strider with their sticks, a camel and a donkey, sit on a llama, harness and fly a happy ghast, and get off, with and without --server-thread. `mobs` reports ridden, controlled, saddled. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game/creatures.rs | 4 + crates/horizon-client/src/game/lan.rs | 10 ++ crates/horizon-client/src/game/lan_actions.rs | 4 + .../horizon-client/src/game/lan_vehicles.rs | 28 +++- crates/horizon-client/src/game/mounts.rs | 48 ++++--- .../src/game/remote_vehicles.rs | 8 ++ crates/horizon-client/src/mobs/equine.rs | 22 +-- tools/lan_e2e.py | 133 +++++++++++++++++- 8 files changed, 224 insertions(+), 33 deletions(-) diff --git a/crates/horizon-client/src/game/creatures.rs b/crates/horizon-client/src/game/creatures.rs index dd8c5335a..969543601 100644 --- a/crates/horizon-client/src/game/creatures.rs +++ b/crates/horizon-client/src/game/creatures.rs @@ -330,6 +330,10 @@ impl Game<'_> { "held": m.extra.main_hand.as_deref(), "mount": m.extra.mount, "rider": m.extra.rider, + // A player's input this tick, and whether it steers. + "ridden": m.rider.map(|r| r.steer), + "controlled": horizon_client::mobs::equine::controlled(m), + "saddled": m.extra.saddled, "enchants": horizon_client::mobs::gear::gear(m).map(|g| g.slots.iter().map(|s| s.iter().map(|(e, l)| format!("{e}:{l}")).collect::>()).collect::>()), "ints": m.extra.ints, "pois": [m.extra.home, m.extra.bed, m.extra.meeting], diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index 17e1e09a3..8864309cc 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -800,6 +800,16 @@ impl Game<'_> { self.send_admin_feedback(&mut host, None); } let state = self.lan_host_state(&host); + // An animal whose rider left the game (or the level) stops taking + // its input. + for m in &mut self.mobs { + if m.rider.is_some() + && self.riding != Some(m.id) + && !host.hub.guests.iter().any(|g| g.vehicle == Some(m.id)) + { + m.rider = None; + } + } // A dedicated server runs the hub without a host player. if state.is_some() || host.hub.config.dedicated { let has_guests = !host.hub.guests.is_empty(); diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index eccbd7f0b..569f4937b 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -49,6 +49,8 @@ pub(super) struct GuestPlay { /// Swings the guest's actions started this tick, for the players around /// (`LivingEntity.swing` sends ClientboundSwingAnimationPacket). swings: u32, + /// The guest's riding jump charge (`LocalPlayer.jumpRidingTicks`). + mount: super::mounts::MountState, /// The trading screen the guest has open. pub(super) merchant: Option, /// The inventory menu and the crafting table the guest crafts in. @@ -289,6 +291,7 @@ impl Game<'_> { let attack_ticks = std::mem::replace(&mut self.attack_ticks, play.attack_ticks); let attack_item = std::mem::replace(&mut self.attack_item, play.attack_item.take()); let swing = std::mem::replace(&mut self.swing, play.swing); + std::mem::swap(&mut self.mount, &mut play.mount); let (left, right) = (self.left, self.right); self.left = play.digging.is_some(); self.right = play.using.is_some() || self.using.is_some(); @@ -478,6 +481,7 @@ impl Game<'_> { play.attack_ticks = std::mem::replace(&mut self.attack_ticks, attack_ticks); play.attack_item = std::mem::replace(&mut self.attack_item, attack_item); play.swing = std::mem::replace(&mut self.swing, swing); + std::mem::swap(&mut self.mount, &mut play.mount); self.container = container; self.screen = screen; self.sign_edit = host_sign; diff --git a/crates/horizon-client/src/game/lan_vehicles.rs b/crates/horizon-client/src/game/lan_vehicles.rs index 01195e49e..8198f288e 100644 --- a/crates/horizon-client/src/game/lan_vehicles.rs +++ b/crates/horizon-client/src/game/lan_vehicles.rs @@ -26,6 +26,7 @@ pub(super) fn input_keys(flags: u8) -> Keys { right: flags & 8 != 0, jump: flags & 16 != 0, shift: flags & 32 != 0, + sprint: flags & 64 != 0, ..Keys::default() } } @@ -96,9 +97,10 @@ impl Game<'_> { let (keys, dead) = (input_keys(g.input), g.dead || g.health <= 0.0); let boat = self.boats.iter().position(|b| b.id == vehicle); let cart = self.carts.iter().any(|c| c.id == vehicle); + let mount = self.mobs.iter().any(|m| m.id == vehicle); // The vehicle is gone (broken, in another level) or the rider died: // its client drops it with the entity or the death screen. - if dead || (boat.is_none() && !cart) { + if dead || (boat.is_none() && !cart && !mount) { let g = &mut host.hub.guests[gi]; (g.vehicle, g.vehicle_good) = (None, None); return; @@ -122,8 +124,12 @@ impl Game<'_> { return Some([p.x, p.y + SEAT, p.z]); } // The minecart moves with the rider's input, and lets it out when - // it sneaks or the cart breaks. - game.tick_cart_riding(keys); + // it sneaks or the cart breaks. An animal takes the rider's input + // for its own tick (`travelRidden`), or lets it off. + if !game.tick_cart_riding(keys) && game.tick_mount_riding(keys) { + game.riding?; + game.position_rider(); + } game.riding?; let p = game.player.as_ref()?.position; Some([p.x, p.y, p.z]) @@ -163,12 +169,26 @@ impl Game<'_> { .find(|c| c.id == vehicle) .map(|c| c.position) }); - let g = &mut host.hub.guests[gi]; if let Some(p) = at { + let g = &mut host.hub.guests[gi]; g.vehicle_good = Some([p.x, p.y, p.z]); g.previous_position = g.position; g.position = [p.x, p.y + SEAT, p.z]; g.on_ground = false; + return; + } + // An animal: the rider sits where `positionRider` puts it. + let seat = self.as_guest(host, conn, |game| { + game.position_rider(); + game.player + .as_ref() + .map(|p| [p.position.x, p.position.y, p.position.z]) + }); + if let Some(Some(at)) = seat { + let g = &mut host.hub.guests[gi]; + g.previous_position = g.position; + g.position = at; + g.on_ground = false; } } diff --git a/crates/horizon-client/src/game/mounts.rs b/crates/horizon-client/src/game/mounts.rs index 42eac1e9b..c5c7dc31c 100644 --- a/crates/horizon-client/src/game/mounts.rs +++ b/crates/horizon-client/src/game/mounts.rs @@ -107,6 +107,10 @@ impl Game<'_> { let held = self.inventory[self.selected].clone(); let m = &self.mobs[index]; let species = m.species(); + // A server player rides it already (`isVehicle`: no seat, no feeding). + if self.ridden_by_guest(m.id) { + return false; + } if matches!(species, Species::Pig | Species::Strider) { return self.interact_steerable(index, item); } @@ -246,24 +250,9 @@ impl Game<'_> { self.consume_held(); true } - /// The rider's input for this tick; returns false when not on a mount. - pub(super) fn tick_mount_riding(&mut self, keys: Keys) -> bool { - let Some(i) = self.mount_index() else { - return false; - }; - if keys.shift || !self.mobs[i].alive() { - self.dismount_mount(); - return true; - } - let strafe = f32::from(u8::from(keys.left)) - f32::from(u8::from(keys.right)); - let forward = f32::from(u8::from(keys.forward)) - f32::from(u8::from(keys.backward)); - // LocalPlayer.aiStep: the riding jump charges while space is held. - let held = self.held().map(|s| s.item.clone()); - let steer = match self.mobs[i].species() { - Species::Pig => held.as_deref() == Some("minecraft:carrot_on_a_stick"), - Species::Strider => held.as_deref() == Some("minecraft:warped_fungus_on_a_stick"), - _ => false, - }; + /// `LocalPlayer.aiStep`'s riding jump: the bar charges while jump is + /// held; on release, the jump's strength (0 when there is none). + pub(super) fn charge_mount_jump(&mut self, i: usize, keys: Keys) -> f32 { // PlayerRideableJumping: horses, camels and nautili (the dash). let saddled = self.mobs[i].extra.saddled && (equine::is_equine(self.mobs[i].species()) @@ -299,6 +288,27 @@ impl Game<'_> { } st.was_jumping = keys.jump; } + jump + } + /// The rider's input for this tick; returns false when not on a mount. + pub(super) fn tick_mount_riding(&mut self, keys: Keys) -> bool { + let Some(i) = self.mount_index() else { + return false; + }; + if keys.shift || !self.mobs[i].alive() { + self.dismount_mount(); + return true; + } + let strafe = f32::from(u8::from(keys.left)) - f32::from(u8::from(keys.right)); + let forward = f32::from(u8::from(keys.forward)) - f32::from(u8::from(keys.backward)); + // LocalPlayer.aiStep: the riding jump charges while space is held. + let held = self.held().map(|s| s.item.clone()); + let steer = match self.mobs[i].species() { + Species::Pig => held.as_deref() == Some("minecraft:carrot_on_a_stick"), + Species::Strider => held.as_deref() == Some("minecraft:warped_fungus_on_a_stick"), + _ => false, + }; + let jump = self.charge_mount_jump(i, keys); let m = &mut self.mobs[i]; if jump > 0.0 { // onPlayerJump: rear while jumping (horses). @@ -324,7 +334,7 @@ impl Game<'_> { pitch: self.pitch, jump: if jump > 0.0 { jump } else { pending }, steer, - sprint: self.keys.contains(&winit::keyboard::KeyCode::ControlLeft), + sprint: keys.sprint || self.keys.contains(&winit::keyboard::KeyCode::ControlLeft), jumping: keys.jump, }); true diff --git a/crates/horizon-client/src/game/remote_vehicles.rs b/crates/horizon-client/src/game/remote_vehicles.rs index dc3b2b686..027983145 100644 --- a/crates/horizon-client/src/game/remote_vehicles.rs +++ b/crates/horizon-client/src/game/remote_vehicles.rs @@ -112,6 +112,14 @@ impl Game<'_> { let Some(id) = self.riding else { return false; }; + if let Some(i) = self.mobs.iter().position(|m| m.id == id) { + // An animal moves on the server with the rider's input + // (PlayerInput); here the jump bar charges for the HUD and the + // rider sits where `positionRider` puts it. + self.charge_mount_jump(i, keys); + self.position_rider(); + return true; + } let seat = if let Some(i) = self.boats.iter().position(|b| b.id == id) { // AbstractBoat.tick on the controlling client: steer and move. let mut b = self.boats[i].clone(); diff --git a/crates/horizon-client/src/mobs/equine.rs b/crates/horizon-client/src/mobs/equine.rs index e7d73f0fa..5bb5faf53 100644 --- a/crates/horizon-client/src/mobs/equine.rs +++ b/crates/horizon-client/src/mobs/equine.rs @@ -338,15 +338,21 @@ pub fn ridden_step(m: &mut Mob) { // Pig/Strider: always forward along the rider's look, at a fraction // of the movement speed, boosted by the stick. m.head_pitch = r.pitch * 0.5; - m.ai.xxa = 0.0; - m.ai.zza = 1.0; + // Strider.getRiddenSpeed: slower while it shivers out of the warmth. let factor = if m.species() == Species::Pig { 0.225 + } else if super::strider::suffocating(m) { + 0.35 } else { 0.55 }; let boost = boost_factor(m); - m.set_speed((m.attrs.speed * factor) as f32 * boost); + // travelRidden: setSpeed(getRiddenSpeed), then travel(getRiddenInput); + // the input is set after the speed (Mob.setSpeed also sets zza). + // getAttributeValue(MOVEMENT_SPEED): with the cold strider's modifier. + m.set_speed((m.movement_speed() * factor) as f32 * boost); + m.ai.xxa = 0.0; + m.ai.zza = 1.0; return; } if super::camel::is_camel(m.species()) { @@ -366,14 +372,14 @@ pub fn ridden_step(m: &mut Mob) { } else { r.forward }; - m.ai.xxa = r.strafe * 0.5; - m.ai.zza = forward; let bonus = if r.sprint && m.extra.anim_ticks == 0 { 0.1 } else { 0.0 }; - m.set_speed(m.attrs.speed as f32 + bonus); + m.set_speed(m.movement_speed() as f32 + bonus); + m.ai.xxa = r.strafe * 0.5; + m.ai.zza = forward; if r.jump > 0.0 { let mut ev = Vec::new(); super::camel::dash(m, r.jump, &mut ev); @@ -394,10 +400,10 @@ pub fn ridden_step(m: &mut Mob) { } else { r.forward }; + let speed = m.movement_speed() as f32; + m.set_speed(speed); m.ai.xxa = r.strafe * 0.5; m.ai.zza = forward; - let speed = m.attrs.speed as f32; - m.set_speed(speed); if m.on_ground && r.jump > 0.0 { // executeRidersJump let impulse = m.extra.vector[0] as f32 * r.jump; diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index a93115f63..894bb8627 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -123,6 +123,9 @@ address. The script then checks, from both sides, what a guest's game used to ge it (#1222). - frames: the host and the guest each put a diamond in an item frame and turn it, and put a helmet on an armor stand and take it back (#1222). +- riding: the host and the guest each saddle and ride a horse (walk, jump), a pig and a strider + (with their sticks), a camel and a donkey, sit on a llama and fly a happy ghast, and + get off by sneaking; the other side sees the animal move. - lightning: a bolt summoned beside the host, then the guest: both sides get the bolt and flash the sky (on its server thread the host's window is a client of it too). - flight: a player in creative double-taps jump and flies, stays up, and stops flying in survival: @@ -166,7 +169,7 @@ ROOT = Path(__file__).resolve().parents[1] GUEST_NAME = 'Guest' # The host plays single player on its server thread (--server-thread). SERVER_THREAD = False -CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder', 'boats', 'minecarts', 'frames', 'lightning'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder', 'boats', 'minecarts', 'frames', 'lightning', 'riding'] class Game: @@ -2509,6 +2512,132 @@ def check_frames(host, guest, out): return result +# Animals a player rides: (kind, summon NBT, what readies it, what is held to ride, the test +# while riding). `move` walks forward, `jump` charges the horse's jump bar, `rise` holds jump on +# a happy ghast, `sit` only rides (a llama goes where it likes). +RIDES = [ + ('horse', '{Tame:1b}', 'minecraft:saddle', None, 'move jump'), + ('pig', '', 'minecraft:saddle', 'minecraft:carrot_on_a_stick', 'move'), + ('strider', '', 'minecraft:saddle', 'minecraft:warped_fungus_on_a_stick', 'move'), + ('camel', '', 'minecraft:saddle', None, 'move'), + ('donkey', '{Tame:1b}', 'minecraft:saddle', None, 'move'), + ('llama', '{Tame:1b}', None, None, 'sit'), + ('happy_ghast', '', 'minecraft:white_harness', None, 'rise'), +] +HEIGHTS = {'horse': 1.6, 'donkey': 1.5, 'pig': 0.9, 'strider': 1.7, 'camel': 2.375, 'llama': 1.87, + 'happy_ghast': 4.0} + + +def mob_seen(game, mob_id): + found = [m for m in game.raw('mobs', 96).get('near', []) if m['id'] == mob_id] + return found[0] if found else None + + +def hold(game, key, ticks): + game.raw('key', key, 'down') + game.wait(ticks) + game.raw('key', key, 'up') + + +def ride(player, other, label, spot, kind, nbt, ready, stick, test): + """Summon `kind` in front of `player`, ready it (saddle, harness), get on with a right click, + run `test`, and get off by sneaking. The other side sees the animal move.""" + x, y, z = spot + # In reach (3 blocks), clear of the player: a happy ghast is 4 blocks wide. + at = (x + 0.5, z + {'happy_ghast': 3.2, 'camel': 3.0}.get(kind, 2.5)) + # The first item in hand before it appears: a happy ghast drifts out of reach quickly. + player('command', command=f'item replace entity @s weapon.mainhand with {ready or stick or "minecraft:air"}') + player('command', command=f'summon minecraft:{kind} {at[0]} {y} {at[1]} {nbt}') + player.wait(3) + found = [m for m in player.raw('mobs', 16).get('near', []) if m['kind'].endswith(kind) and m['health'] > 0] + assert found, f'the {label} sees no {kind}' + mob = found[0] + def click(item): + player('command', command=f'item replace entity @s weapon.mainhand with {item or "minecraft:air"}') + player.wait(2) + m = mob_seen(player, mob['id']) + assert m, f'the {label} lost its {kind}' + p = m['pos'] + # Back in front of it if it wandered off (a happy ghast drifts away fast). + if abs(p[0] - (x + 0.5)) > 0.5 or abs(p[2] - at[1]) > 0.5: + player('command', command=f'tp @s {p[0]:.2f} {y} {p[2] - (at[1] - z - 0.5):.2f} 0 0') + player.wait(1) + player.raw('look-at', f'{p[0]:.2f}', f'{p[1] + HEIGHTS[kind] / 2:.2f}', f'{p[2]:.2f}') + player.raw('mouse', 'right', 'click') + player.wait(5) + try: + if ready: + click(ready) + click(stick) + riding = player('status').get('riding') + assert riding == mob['id'], f'the {label} right-clicked the {kind} {mob["id"]}: riding {riding}' + result = {'rode': True} + # South, along the cleared floor. + player.raw('look-at', f'{x + 0.5:.2f}', f'{y + 1.6:.2f}', f'{z + 40.5:.2f}') + player.wait(5) + start = mob_seen(player, mob['id'])['pos'] + if 'move' in test: + hold(player, 'w', 60) + player.wait(5) + mine = mob_seen(player, mob['id'])['pos'] + theirs = mob_seen(other, mob['id']) + moved = math.dist(start, mine) + assert moved > 1.0, f"the {label}'s {kind} moved {moved:.2f} blocks in 3 s of forward" + assert theirs and math.dist(theirs['pos'], mine) < 1.5, \ + f"the other side sees the {label}'s {kind} at {theirs and theirs['pos']}, not {mine}" + seated = pos_of(player) + assert math.dist(seated[::2], mine[::2]) < 1.5, f'the {label} sits at {seated}, its {kind} at {mine}' + result['moved'] = round(moved, 2) + if 'jump' in test: + base = mob_seen(player, mob['id'])['pos'][1] + player.raw('key', 'space', 'down') + player.wait(10) + player.raw('key', 'space', 'up') + top = base + for _ in range(10): + player.wait(2) + top = max(top, mob_seen(player, mob['id'])['pos'][1]) + assert top - base > 0.4, f"the {label}'s {kind} jumped {top - base:.2f} blocks" + result['jumped'] = round(top - base, 2) + if 'rise' in test: + base = mob_seen(player, mob['id'])['pos'][1] + hold(player, 'space', 40) + player.wait(5) + rose = mob_seen(player, mob['id'])['pos'][1] - base + assert rose > 0.5, f"the {label}'s {kind} rose {rose:.2f} blocks while it held jump" + result['rose'] = round(rose, 2) + hold(player, 'shift', 10) + player.wait(10) + riding = player('status').get('riding') + assert riding is None, f'sneaking off the {kind}: the {label} still rides {riding}' + return result + finally: + player('command', command=f'kill @e[type=minecraft:{kind},x={x},y={y},z={z},distance=..48]') + player('command', command=f'tp @s {x + 0.5} {y} {z + 0.5} 0 0') + player.wait(5) + + +def check_riding(host, guest, out): + """The host (single player, on its server thread or not) and the guest each saddle and ride a + horse (walk and jump), a pig and a strider (with their sticks), a camel and a donkey, sit on a + llama, and harness and fly a happy ghast; they get off by sneaking.""" + spots = apart(host, guest) + result = {} + for label, player, other in (('host', host, guest), ('guest', guest, host)): + x, y, z = spots[label] + player('command', command='gamemode survival') + player('command', command=f'fill {x - 3} {y - 1} {z - 3} {x + 4} {y - 1} {z + 40} minecraft:stone') + player('command', command=f'fill {x - 3} {y} {z - 3} {x + 4} {y + 12} {z + 40} minecraft:air') + player.wait(10) + result[label] = {} + # LAN_E2E_RIDES=pig,horse picks some of them. + only = [k for k in os.environ.get('LAN_E2E_RIDES', '').split(',') if k] + for kind, nbt, ready, stick, test in (r for r in RIDES if not only or r[0] in only): + result[label][kind] = ride(player, other, label, (x, y, z), kind, nbt, ready, stick, test) + player('command', command='item replace entity @s weapon.mainhand with minecraft:air') + return result + + def check_lightning(host, guest, out): """A bolt summoned beside each player: both sides get the bolt entity and flash the sky (the host's window too on its server thread, FEATURES 4z(f)).""" @@ -2848,7 +2977,7 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles, 'blast': check_blast, 'light': check_light, 'plates': check_plates, 'swings': check_swings, 'cracks': check_cracks, - 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder, 'boats': check_boats, 'minecarts': check_minecarts, 'frames': check_frames, 'lightning': check_lightning} + 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder, 'boats': check_boats, 'minecarts': check_minecarts, 'frames': check_frames, 'lightning': check_lightning, 'riding': check_riding} def run(ctl, out, resources, checks): From 18078e058d52e7aef20cea156326d3816ca61918 Mon Sep 17 00:00:00 2001 From: levzzz <86072227+levzzz5154@users.noreply.github.com> Date: Fri, 23 Oct 2026 03:47:04 +0500 Subject: [PATCH 072/126] Explosions hurt and push minecarts, so TNT minecarts chain ServerExplosion.hurtEntities skipped minecarts: a TNT minecart's blast never reached the carts beside it. Carts now take the explosion's damage through VehicleEntity.hurtServer (destroyed past 40, where MinecartTNT.destroy primes a TNT cart with a 0-39 tick fuse, as damageSourceIgnitesTnt counts explosions) and the knockback from their eyes. The exploding cart is the explosion's source, so it is removed before the blast and can't hit itself. Cart ticks now look carts up by id, since a blast can remove or prime other carts mid-loop. --- crates/horizon-client/src/game/explosion.rs | 30 ++++++++++++++++++++- crates/horizon-client/src/game/minecarts.rs | 30 ++++++++++++++------- 2 files changed, 50 insertions(+), 10 deletions(-) diff --git a/crates/horizon-client/src/game/explosion.rs b/crates/horizon-client/src/game/explosion.rs index 5cf67f586..0923b4110 100644 --- a/crates/horizon-client/src/game/explosion.rs +++ b/crates/horizon-client/src/game/explosion.rs @@ -224,7 +224,7 @@ impl Game<'_> { } set.entries().map(|(k, _)| k.0).collect() } - /// `ServerExplosion.hurtEntities` (player, mobs, items, primed TNT); + /// `ServerExplosion.hurtEntities` (player, mobs, items, primed TNT, minecarts); /// the player takes `damage_type`. /// `ServerExplosion.hurtEntities` for the player: damage scaled by /// distance and exposure, through a raised shield (`hurtServer` blocks @@ -460,6 +460,34 @@ impl Game<'_> { ); } self.tnts = tnts; + // Minecarts: VehicleEntity.hurtServer (explosions ignite TNT carts), + // then the push from their eyes (0.85 of their height). + let ids: Vec = self.carts.iter().map(|c| c.id).collect(); + for id in ids { + let Some(i) = self.carts.iter().position(|c| c.id == id) else { + continue; + }; + let bounds = self.carts[i].bounds(); + let feet = self.carts[i].position; + let dist = distance([feet.x, feet.y, feet.z]) / diameter; + if dist > 1.0 { + continue; + } + let (lo, hi) = (bounds.min_position(), bounds.max_position()); + let exposure = self.seen_percent(center, [lo.x, lo.y, lo.z], [hi.x, hi.y, hi.z]); + self.hurt_cart(i, damage(dist, exposure), false, true); + let Some(c) = self.carts.iter_mut().find(|c| c.id == id) else { + continue; + }; + let eye_height = f64::from((hi.y - lo.y) as f32 * 0.85f32); + let dir = direction([feet.x, feet.y + eye_height, feet.z]); + let power = (1.0 - dist) * f64::from(exposure); + c.velocity = Vec3::new( + c.velocity.x + dir[0] * power, + c.velocity.y + dir[1] * power, + c.velocity.z + dir[2] * power, + ); + } } /// `Level.explode` on the server: positions, entities, blocks, fire; then /// the client's explosion sound. diff --git a/crates/horizon-client/src/game/minecarts.rs b/crates/horizon-client/src/game/minecarts.rs index b9d7f3893..9173139aa 100644 --- a/crates/horizon-client/src/game/minecarts.rs +++ b/crates/horizon-client/src/game/minecarts.rs @@ -637,6 +637,9 @@ impl Game<'_> { let r = self.world.random.next_double(); let power = (4.0 + r * 1.5 * speed) as f32; let at = [c.position.x, c.position.y, c.position.z]; + // The cart is the explosion's source: it is gone before the blast + // looks for entities, so it can't hit itself. + self.carts.retain(|x| x.id != c.id); let _ = self.server_explode(at, power, BlockInteraction::Destroy, false); } /// `MinecartHopper.suckInItems`: items above, into the five slots. @@ -792,14 +795,17 @@ impl Game<'_> { let ticking = self.entity_ticking_area(); // A server player's minecart moves with its rider (lan_vehicles.rs). let ridden = self.guest_vehicles(); - let mut i = 0; - while i < self.carts.len() { + // By id: an exploding cart can destroy or prime others mid-loop. + let ids: Vec = self.carts.iter().map(|c| c.id).collect(); + for id in ids { + let Some(i) = self.carts.iter().position(|c| c.id == id) else { + continue; + }; let p = self.carts[i].position; - if Some(self.carts[i].id) == self.riding - || ridden.contains(&self.carts[i].id) + if Some(id) == self.riding + || ridden.contains(&id) || !ticking(p.x.floor() as i32, p.z.floor() as i32) { - i += 1; continue; } let mut c = self.carts[i].clone(); @@ -807,10 +813,12 @@ impl Game<'_> { if c.kind == CartKind::Hopper { self.hopper_cart_pickup(&mut c); } + let Some(i) = self.carts.iter().position(|c| c.id == id) else { + continue; + }; if alive { self.carts[i] = c; self.push_from_cart(i); - i += 1; } else { self.carts.remove(i); } @@ -881,6 +889,10 @@ impl Game<'_> { p.velocity = Vec3::ZERO; p.fall_distance = 0.0; } + let Some(i) = self.carts.iter().position(|x| x.id == c.id) else { + self.riding = None; + return true; + }; if alive { self.carts[i] = c; self.push_from_cart(i); @@ -1138,8 +1150,8 @@ impl Game<'_> { } /// `VehicleEntity.hurtServer`: shake, add the damage, break past 40 (at /// once for creative players); TNT minecarts prime instead when moving - /// or hurt by fire. - fn hurt_cart(&mut self, i: usize, damage: f32, creative: bool, fire: bool) { + /// or hurt by fire or an explosion (`damageSourceIgnitesTnt`). + pub(super) fn hurt_cart(&mut self, i: usize, damage: f32, creative: bool, fire: bool) { let c = &mut self.carts[i]; c.hurt_dir = -c.hurt_dir; c.hurt_time = 10; @@ -1148,7 +1160,7 @@ impl Game<'_> { if destroyed { let mut c = self.carts.remove(i); let speed = c.velocity.x * c.velocity.x + c.velocity.z * c.velocity.z; - if c.kind == CartKind::Tnt && (fire || speed >= 0.01) { + if c.kind == CartKind::Tnt && (fire || speed >= f64::from(0.01f32)) { // MinecartTNT.destroy: prime instead of breaking. if c.fuse < 0 { self.prime_cart(&mut c); From 4eb7a98330c0b173759ca3a36ebbf62e66e61bc1 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 01:19:42 +0200 Subject: [PATCH 073/126] Website: "Playing now" on the home page, from the telemetry server's live count The home page's "At a glance" list gets a fifth row with how many play right now, read from https://telemetry.playhorizon.dev/v1/live (3 s timeout, again every minute while the tab is visible). It stays hidden while nobody plays or the server doesn't answer. The FAQ no longer says the "I'm playing" ping is off: the server is live since #1276. Co-Authored-By: Claude Opus 5.5 --- website/docs/faq.md | 2 +- website/src/index.html | 1 + website/src/main.js | 32 +++++++++++++++++++++++++++++++- 3 files changed, 33 insertions(+), 2 deletions(-) diff --git a/website/docs/faq.md b/website/docs/faq.md index 3bde1e7ea..6421a1083 100644 --- a/website/docs/faq.md +++ b/website/docs/faq.md @@ -56,7 +56,7 @@ In part. Horizon runs the full-screen effects of Java shader packs, not their ge ## Does Horizon collect data? -Only if you say yes, and each kind has its own switch. Everything is off by default. The game has an anonymous "I'm playing" ping for a live player count, but it is off today: no server receives it yet, so the game sends nothing. See [Privacy](/privacy). +Only if you say yes, and each kind has its own switch. Everything is off by default. The one thing sent without asking is an anonymous "I'm playing" ping, for the count of how many play right now: it holds a random number made each time the game starts, the version, your OS and whether a world is open to LAN, and nothing about you. See [Privacy](/privacy). ## How often does it update? diff --git a/website/src/index.html b/website/src/index.html index a36f6ff2a..9c7c3ca3e 100644 --- a/website/src/index.html +++ b/website/src/index.html @@ -96,6 +96,7 @@
  • 02Differential harnesses{{HARNESSES}}
  • 03Drawn by Horizon5 shots
  • 04Recently addedReleases
  • +

    Unofficial. Not an official Minecraft product. Not approved by or associated with Mojang or Microsoft.

    diff --git a/website/src/main.js b/website/src/main.js index e04e85eae..4298cf1fd 100644 --- a/website/src/main.js +++ b/website/src/main.js @@ -1,5 +1,6 @@ // The page's behaviour: the download buttons for this platform, the latest releases, the -// links and contributors, the navigation, the menus' tabs, the lightbox and the motion. +// links and contributors, how many play now, the navigation, the menus' tabs, the lightbox +// and the motion. // Everything degrades to the baked-in content when GitHub can't be reached. import { escape } from "./markdown.js"; import { recentHtml } from "./releases.js"; @@ -103,6 +104,34 @@ async function setUpLinks() { }); } +// --- Playing now --------------------------------------------------------------------- + +const TELEMETRY = "https://telemetry.playhorizon.dev"; + +// How many play right now, from the games' anonymous "I'm playing" pings (Privacy explains them). The +// server rounds it and makes it again at most every 15 seconds; the row stays hidden while nobody plays +// or the server doesn't answer. +async function setUpLive() { + const row = document.querySelector("[data-live]"); + if (!row) return; + const update = async () => { + try { + const res = await fetch(`${TELEMETRY}/v1/live`, { signal: AbortSignal.timeout(3000) }); + if (!res.ok) throw new Error(String(res.status)); + const { playing } = await res.json(); + if (!Number.isInteger(playing) || playing < 1) throw new Error("nobody"); + row.querySelector("[data-live-count]").textContent = playing.toLocaleString("en"); + row.hidden = false; + // It shows up after the others came in, so it skips their entrance. + row.classList.add("is-visible"); + } catch { + row.hidden = true; + } + }; + await update(); + setInterval(() => document.visibilityState === "visible" && update(), 60_000); +} + // --- Navigation ---------------------------------------------------------------------- function setUpNav() { @@ -235,3 +264,4 @@ setUpDownload(); setUpRecent(); setUpLinks(); setUpContributors(); +setUpLive(); From a4e68e6a53a9ac54773cd13cd31e182a993890c5 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 01:20:51 +0200 Subject: [PATCH 074/126] Mount inventories for a server's players, and llama inventories A server's players (single player on its server thread, LAN guests, dedicated-server players) get the horse inventory: shift + use on a tamed horse, donkey, mule, camel or llama, or the inventory key while riding one (ServerboundPlayerCommandPacket OPEN_INVENTORY), opens HorseInventoryMenu over the mount with ClientboundMountScreenOpenPacket. Clicks run on the menu engine's new Kind::Mount (saddle and body ArmorSlots that take what the mount may wear, the chest, AbstractMountInventoryMenu.quickMoveStack), and the slots go back to the mount with the item's equip sound. The client shows a server's mount screen, predicts its clicks with the same engine and sends OPEN_INVENTORY when the inventory key is pressed while riding. Llamas now have their inventory in the window too: the carpet slot and a chest of `strength` columns, no saddle slot. lan_e2e `mounts` checks it for the host and a guest, with and without --server-thread. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game.rs | 14 ++ crates/horizon-client/src/game/lan_actions.rs | 21 +- .../horizon-client/src/game/lan_mount_menu.rs | 222 ++++++++++++++++++ crates/horizon-client/src/game/llamas.rs | 3 +- crates/horizon-client/src/game/mount_menu.rs | 206 +++++++++++++--- crates/horizon-client/src/game/remote.rs | 45 ++++ crates/horizon-client/src/lan/containers.rs | 17 ++ crates/horizon-client/src/lan/hub.rs | 4 + crates/horizon-client/src/menu.rs | 138 ++++++++++- crates/horizon-protocol/src/packets/play.rs | 9 + tools/lan_e2e.py | 102 +++++++- 11 files changed, 745 insertions(+), 36 deletions(-) create mode 100644 crates/horizon-client/src/game/lan_mount_menu.rs diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 52bbad605..72017eea7 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -72,6 +72,7 @@ mod lan_chat; mod lan_crafting; mod lan_entities; mod lan_mobs; +mod lan_mount_menu; mod lan_pvp; mod lan_screen; mod lan_stations; @@ -5488,6 +5489,16 @@ impl Game<'_> { let mut v = vec![None; 45]; v.extend((0..9).map(Some)); (Kind::ItemPicker, v) + } else if let Some(columns) = self + .mount_menu_columns() + .filter(|_| self.remote.is_some() && self.mount_active()) + { + // A server's HorseInventoryMenu: the saddle, the body armour, + // the chest, then the inventory. + let mut v = vec![Some(mount_menu::SADDLE), Some(mount_menu::ARMOR)]; + v.extend((0..columns * 3).map(|i| Some(mount_menu::CHEST + i))); + v.extend((9..36).chain(0..9).map(Some)); + (Kind::Mount(columns), v) } else if merchant_open { // MerchantMenu: two payment slots, the result, then the inventory. let mut v: Vec> = vec![ @@ -5620,6 +5631,9 @@ impl Game<'_> { None => game_of.iter().position(|x| *x == Some(g)), }; let mut menu = Menu::new(kind); + if matches!(kind, Kind::Mount(_)) { + menu.mount = self.mount_menu_entity(); + } let total = menu.slot_count(); let before: Vec> = game_of .iter() diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index 569f4937b..0d70b16f6 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -57,6 +57,8 @@ pub(super) struct GuestPlay { pub(super) crafting: super::lan_crafting::GuestCrafting, /// The workstation menu the guest has open (game/lan_stations.rs). pub(super) station: Option, + /// The mount inventory the guest has open (game/lan_mount_menu.rs). + pub(super) mount_window: Option, /// The lectern the guest reads (game/lan_stations.rs). pub(super) lectern: Option, /// What the guest's body was given for its effects and enchantments. @@ -493,7 +495,9 @@ impl Game<'_> { _ => None, }; self.command_block_screen = host_command_block; - self.mount_menu = host_mount_menu; + // A mount inventory the guest's action opened (shift + use, or the + // inventory key while riding). + let guest_mount = std::mem::replace(&mut self.mount_menu, host_mount_menu).opened_mob(); self.keys = host_keys; let g = &mut host.hub.guests[i]; let left_vehicle = g.vehicle.filter(|_| guest_vehicle.is_none()); @@ -616,6 +620,9 @@ impl Game<'_> { if opened_table { self.lan_open_crafting(host, conn); } + if let Some(mob) = guest_mount { + self.lan_open_mount(host, conn, mob); + } } /// `ServerLevel.players()` in turn: the host's own player, then each @@ -971,6 +978,14 @@ impl Game<'_> { S::ContainerClick(p) if self.lan_machine_click(host, conn, &p) => {} S::ContainerClick(p) if self.lan_station_click(host, conn, &p) => {} S::ContainerClick(p) if self.lan_lectern_click(host, conn, &p) => {} + S::ContainerClick(p) if self.lan_mount_click(host, conn, &p) => {} + // ServerboundPlayerCommandPacket OPEN_INVENTORY: the ridden + // mount's inventory (`HasCustomInventoryScreen`). + S::PlayerCommand(p) if p.action == 5 => { + self.as_guest(host, conn, |g| { + g.open_ridden_mount_menu(); + }); + } S::ContainerButtonClick(p) => { self.lan_station_button(host, conn, p.container, p.button); } @@ -988,7 +1003,8 @@ impl Game<'_> { } S::ContainerClose(p) if self.lan_crafting_closed(host, conn, Some(p.container)) - || self.lan_station_closed(host, conn, Some(p.container)) => + || self.lan_station_closed(host, conn, Some(p.container)) + || self.lan_mount_closed(host, conn, Some(p.container)) => { let g = &mut host.hub.guests[gi]; if let Some(c) = g.carried.take() { @@ -1528,6 +1544,7 @@ impl Game<'_> { pub(super) fn tick_guests(&mut self, host: &mut LanHost) { self.lan_merchant_tick(host); self.lan_stations_tick(host); + self.tick_lan_mount_menus(host); self.announce_guest_advancements(host); let conns: Vec = host .hub diff --git a/crates/horizon-client/src/game/lan_mount_menu.rs b/crates/horizon-client/src/game/lan_mount_menu.rs new file mode 100644 index 000000000..78b306252 --- /dev/null +++ b/crates/horizon-client/src/game/lan_mount_menu.rs @@ -0,0 +1,222 @@ +//! The horse inventory for a server's players (`ServerPlayer.openHorseInventory`): +//! shift + use on a tamed horse, donkey, mule, camel or llama, or the +//! inventory key while riding one (`ServerboundPlayerCommandPacket` +//! OPEN_INVENTORY), opens `HorseInventoryMenu` over the mount with +//! `ClientboundMountScreenOpenPacket`. Clicks run on the menu engine +//! (`Kind::Mount`) with the mount's saddle, body item and chest copied in and +//! written back, and the slots go to the client after each change, as +//! `broadcastChanges` does. +use super::{Game, lan::LanHost, lan_crafting::input}; +use horizon_client::{ + items::ItemStack, + menu::{Kind, Menu}, +}; +use horizon_protocol::packets::play::{self, Clientbound as C}; + +/// A guest's open mount menu. +pub(super) struct GuestMount { + window: i32, + mob: u32, + columns: usize, + state: i32, + /// The menu's slots and the carried stack the client was last sent. + sent: Option<(Vec>, Option)>, +} + +impl Game<'_> { + /// `ServerPlayer.openHorseInventory` for mount `mob`: the open menu + /// closes, the client gets the mount screen and the menu's slots. + pub(super) fn lan_open_mount(&mut self, host: &mut LanHost, conn: u32, mob: u32) { + let Some(index) = self.mobs.iter().position(|m| m.id == mob) else { + return; + }; + let columns = super::mount_menu::mount_columns(&self.mobs[index]); + self.lan_mount_closed(host, conn, None); + self.lan_station_closed(host, conn, None); + self.lan_crafting_closed(host, conn, None); + self.guest_container_closed(host, conn); + let Some(window) = host.hub.open_mount_window(conn, columns as i32, mob as i32) else { + return; + }; + host.play.entry(conn).or_default().mount_window = Some(GuestMount { + window, + mob, + columns, + state: 0, + sent: None, + }); + self.lan_send_mount(host, conn); + } + + /// `HorseInventoryMenu` over mount `index`, with the player's inventory + /// loaded by the caller. + fn mount_engine_menu(&self, index: usize, columns: usize) -> Menu { + let env = self.menu_env(); + let mut menu = Menu::new(Kind::Mount(columns)); + menu.mount = Some(self.mobs[index].kind.id.to_string()); + let (saddle, body, items) = self.mount_contents(index); + menu.set_slot(&env, 0, saddle); + menu.set_slot(&env, 1, body.flatten()); + for (k, item) in items.into_iter().take(columns * 3).enumerate() { + menu.set_slot(&env, 2 + k, item); + } + menu + } + + /// The menu's slots (the mount's, then the inventory and the hotbar) + /// and the carried stack, sent when they changed since the last time. + fn lan_send_mount(&mut self, host: &mut LanHost, conn: u32) { + let Some(gm) = host.play.get(&conn).and_then(|p| p.mount_window.as_ref()) else { + return; + }; + let (mob, columns) = (gm.mob, gm.columns); + let Some(index) = self.mobs.iter().position(|m| m.id == mob) else { + return; + }; + let Some(g) = host.hub.guests.iter().find(|g| g.conn == conn) else { + return; + }; + let (saddle, body, items) = self.mount_contents(index); + let mut slots = vec![saddle, body.flatten()]; + slots.extend(items.into_iter().take(columns * 3)); + slots.extend((9..36).chain(0..9).map(|i| g.inventory[i].clone())); + let carried = g.carried.clone(); + let now = Some((slots, carried)); + let Some(gm) = host + .play + .get_mut(&conn) + .and_then(|p| p.mount_window.as_mut()) + else { + return; + }; + if gm.sent == now { + return; + } + gm.state = (gm.state + 1) & 0x7FFF; + let (window, state) = (gm.window, gm.state); + let (slots, carried) = now.clone().unwrap_or_default(); + gm.sent = now; + let content = C::ContainerSetContent(play::ContainerSetContent { + container: window, + state, + items: slots.iter().map(|s| host.hub.stack(s)).collect(), + carried: host.hub.stack(&carried), + }); + host.hub.send_to(conn, &content); + } + + /// A click on the guest's mount window; false for other windows. + pub(super) fn lan_mount_click( + &mut self, + host: &mut LanHost, + conn: u32, + p: &play::ContainerClick, + ) -> bool { + let Some((mob, columns)) = host + .play + .get(&conn) + .and_then(|pl| pl.mount_window.as_ref()) + .filter(|m| m.window == p.container) + .map(|m| (m.mob, m.columns)) + else { + return false; + }; + if let Some(gi) = host.hub.guests.iter().position(|g| g.conn == conn) + && !host.hub.guests[gi].spectator() + && let Some(index) = self.mobs.iter().position(|m| m.id == mob) + { + let mut menu = self.mount_engine_menu(index, columns); + self.guest_menu_op(host, gi, &mut menu, |menu, env| { + let _ = menu.click(env, i32::from(p.slot), i32::from(p.button), input(p.input)); + }); + self.lan_mount_store(index, columns, &menu); + } + // The client is told what the server has, whatever it predicted. + if let Some(gm) = host + .play + .get_mut(&conn) + .and_then(|pl| pl.mount_window.as_mut()) + { + gm.sent = None; + } + self.lan_send_mount(host, conn); + true + } + + /// The engine menu's mount slots back on mount `index`. + fn lan_store_slots(menu: &Menu, columns: usize) -> Vec> { + (0..columns * 3) + .map(|k| menu.slot(2 + k).cloned()) + .collect() + } + fn lan_mount_store(&mut self, index: usize, columns: usize, menu: &Menu) { + let (_, body, _) = self.mount_contents(index); + let body = body.map(|_| menu.slot(1).cloned()); + let items = Self::lan_store_slots(menu, columns); + self.mount_store(index, menu.slot(0).cloned(), body, items); + } + + /// `AbstractContainerMenu.removed` of the guest's mount menu (`window`; + /// None closes it whichever it is): the carried stack goes back to the + /// inventory. False when no such window is open. + pub(super) fn lan_mount_closed( + &mut self, + host: &mut LanHost, + conn: u32, + window: Option, + ) -> bool { + let closed = host + .play + .get_mut(&conn) + .and_then(|p| { + p.mount_window + .take_if(|m| window.is_none_or(|w| m.window == w)) + }) + .is_some(); + if closed + && let Some(gi) = host.hub.guests.iter().position(|g| g.conn == conn) + && let Some(carried) = host.hub.guests[gi].carried.take() + { + self.lan_place_back(host, gi, vec![carried]); + } + closed + } + + /// Each tick: a mount menu whose mount died or is out of reach closes + /// (`AbstractMountInventoryMenu.stillValid`: alive, within the entity + /// interaction range plus 4 of the eyes), and the others follow the + /// mount's and the inventory's slots. + pub(super) fn tick_lan_mount_menus(&mut self, host: &mut LanHost) { + let open: Vec<(u32, u32, i32)> = host + .play + .iter() + .filter_map(|(c, p)| p.mount_window.as_ref().map(|m| (*c, m.mob, m.window))) + .collect(); + for (conn, mob, window) in open { + let Some(g) = host.hub.guests.iter().find(|g| g.conn == conn) else { + continue; + }; + let eye = [g.position[0], g.position[1] + g.eye_height(), g.position[2]]; + let valid = self.mobs.iter().find(|m| m.id == mob).is_some_and(|m| { + let (w, h) = (f64::from(m.width()) / 2.0, f64::from(m.height())); + let p = [m.position.x, m.position.y, m.position.z]; + let lo = [p[0] - w, p[1], p[2] - w]; + let hi = [p[0] + w, p[1] + h, p[2] + w]; + let d: f64 = (0..3) + .map(|k| (eye[k] - eye[k].clamp(lo[k], hi[k])).powi(2)) + .sum(); + // Player.ENTITY_INTERACTION_RANGE 3, plus 4. + m.alive() && d < 7.0 * 7.0 + }); + if valid { + self.lan_send_mount(host, conn); + } else { + self.lan_mount_closed(host, conn, Some(window)); + host.hub.send_to( + conn, + &C::ContainerClose(play::ContainerClose { container: window }), + ); + } + } + } +} diff --git a/crates/horizon-client/src/game/llamas.rs b/crates/horizon-client/src/game/llamas.rs index b9be87e3e..1ce518f31 100644 --- a/crates/horizon-client/src/game/llamas.rs +++ b/crates/horizon-client/src/game/llamas.rs @@ -93,7 +93,8 @@ impl Game<'_> { return false; } if tamed && sneaking { - // The horse inventory screen is not available yet. + // AbstractHorse.openCustomInventoryScreen. + self.open_mount_menu(index); return true; } let m = &self.mobs[index]; diff --git a/crates/horizon-client/src/game/mount_menu.rs b/crates/horizon-client/src/game/mount_menu.rs index 1db2210d3..e9e1e380b 100644 --- a/crates/horizon-client/src/game/mount_menu.rs +++ b/crates/horizon-client/src/game/mount_menu.rs @@ -1,12 +1,15 @@ //! The horse inventory (`HorseInventoryMenu`, `HorseInventoryScreen`): the -//! saddle and body armour slots, the 3x5 chest of donkeys and mules and the -//! mount drawn following the cursor. It opens with E while riding a tamed -//! mount or with shift + use on a tamed one. +//! saddle and body armour slots (a llama's carpet), the chest of donkeys, +//! mules and llamas and the mount drawn following the cursor. It opens with +//! E while riding a tamed mount or with shift + use on a tamed one. On a +//! server the screen shows the server's menu (`ClientboundMountScreenOpenPacket`) +//! and its clicks go out as container clicks; a server's players get theirs +//! from game/lan_mount_menu.rs. use super::{Game, Screen}; use horizon_client::{ hud::{HudBatch, rgba}, items::ItemStack, - mobs::{Mob, Species, equine}, + mobs::{Mob, Species, equine, llama}, }; /// Menu slot ids: the saddle, the body armour and the chest from 710. @@ -17,11 +20,43 @@ pub(super) const CHEST: usize = 710; const CHEST_SIZE: usize = 15; const COLUMNS: usize = 5; +/// `AbstractHorse.getInventoryColumns`: five for a donkey's or mule's chest, +/// a llama's strength for its chest, else none. +pub(super) fn mount_columns(m: &Mob) -> usize { + let species = m.species(); + if llama::is_llama(species) { + llama::inventory_columns(m).clamp(0, 5) as usize + } else if m.extra.chested && matches!(species, Species::Donkey | Species::Mule) { + COLUMNS + } else { + 0 + } +} +/// Whether the mount has a horse inventory (`AbstractHorse`). +pub(super) fn has_mount_menu(species: Species) -> bool { + equine::is_equine(species) || llama::is_llama(species) +} +/// The saddle slot is active (`canUseSlot(SADDLE)` and `CAN_EQUIP_SADDLE`): +/// not on llamas. +fn shows_saddle(species: Species) -> bool { + !llama::is_llama(species) +} +/// The body slot is active: horse armour, or a llama's carpet. +fn shows_body(species: Species) -> bool { + can_wear_horse_armor(species) || llama::is_llama(species) +} + /// The open mount menu: copies of the mount's slots, written back on every change. #[derive(Default)] pub(super) struct MountMenu { open: Option, } +impl MountMenu { + /// The mount whose menu is open. + pub(super) fn opened_mob(&self) -> Option { + self.open.as_ref().map(|o| o.mob) + } +} struct Open { mob: u32, species: Species, @@ -40,6 +75,9 @@ fn can_wear_horse_armor(species: Species) -> bool { } /// Whether `item` fits the body slot of the species (`isEquippableInSlot`). fn body_armor_fits(species: Species, item: &str) -> bool { + if llama::is_llama(species) { + return item.ends_with("_carpet"); + } can_wear_horse_armor(species) && item.ends_with("_horse_armor") } @@ -55,18 +93,16 @@ impl Game<'_> { pub(super) fn open_mount_menu(&mut self, index: usize) { let m = &self.mobs[index]; let species = m.species(); - if !equine::is_equine(species) { + if !has_mount_menu(species) { return; } - let chested = m.extra.chested && matches!(species, Species::Donkey | Species::Mule); - let columns = if chested { COLUMNS } else { 0 }; let mut items = m.extra.items.clone(); items.resize(CHEST_SIZE, None); - let show_armor = can_wear_horse_armor(species); + let show_armor = shows_body(species); self.mount_menu.open = Some(Open { mob: m.id, species, - columns, + columns: mount_columns(m), saddle: m.saddle_item(), armor: m .extra @@ -75,10 +111,40 @@ impl Game<'_> { .filter(|_| show_armor) .map(|i| ItemStack::new(i, 1)), items, - show_saddle: true, + show_saddle: shows_saddle(species), show_armor, }); - self.carried = None; + self.show_mount_menu(); + } + /// `ClientPacketListener.handleMountScreenOpen`: a server's horse + /// inventory over mount `entity`, its slots to come in the menu's content. + pub(super) fn open_remote_mount_menu(&mut self, entity: u32, columns: usize) -> bool { + let Some(species) = self + .mobs + .iter() + .find(|m| m.id == entity) + .map(Mob::species) + .filter(|s| has_mount_menu(*s)) + else { + return false; + }; + self.mount_menu.open = Some(Open { + mob: entity, + species, + columns: columns.min(COLUMNS), + saddle: None, + armor: None, + items: vec![None; CHEST_SIZE], + show_saddle: shows_saddle(species), + show_armor: shows_body(species), + }); + self.show_mount_menu(); + true + } + fn show_mount_menu(&mut self) { + if self.remote.is_none() && self.lan_acting.is_none() { + self.carried = None; + } self.station = None; self.container = None; self.craft_size = 2; @@ -94,15 +160,39 @@ impl Game<'_> { return false; }; let m = &self.mobs[index]; - if !equine::is_equine(m.species()) || !m.extra.tame || !m.alive() { + if !has_mount_menu(m.species()) || !m.extra.tame || !m.alive() { return false; } self.open_mount_menu(index); true } + /// Riding a mount that has a horse inventory (`HasCustomInventoryScreen`). + pub(super) fn riding_mount_with_menu(&self) -> bool { + self.riding + .and_then(|id| self.mount_mob_index(id)) + .is_some_and(|i| has_mount_menu(self.mobs[i].species())) + } + /// A server closed its window: the screen's copy goes. + pub(super) fn mount_menu_reset(&mut self) { + self.mount_menu.open = None; + } + /// The entity type of the open mount menu's mount (`minecraft:horse`). + pub(super) fn mount_menu_entity(&self) -> Option { + let open = self.mount_menu.open.as_ref()?; + let m = self.mobs.iter().find(|m| m.id == open.mob)?; + Some(m.kind.id.to_string()) + } + /// The chest columns of the open mount menu (the server's window's). + pub(super) fn mount_menu_columns(&self) -> Option { + self.mount_menu.open.as_ref().map(|o| o.columns) + } /// The menu ends when the mount dies or is more than 4 blocks away /// (`AbstractMountInventoryMenu.stillValid`). pub(super) fn tick_mount_menu(&mut self) { + // A server's menu ends when the server closes it. + if self.remote.is_some() { + return; + } let Some(open) = self.mount_menu.open.as_ref() else { return; }; @@ -126,8 +216,12 @@ impl Game<'_> { self.mount_sync(); self.mount_menu.open = None; } - /// Writes the menu slots to the mount, with the equip sounds. + /// Writes the menu slots to the mount, with the equip sounds. A + /// server's menu is the server's to write. fn mount_sync(&mut self) { + if self.remote.is_some() { + return; + } let Some(open) = self.mount_menu.open.as_ref() else { return; }; @@ -135,25 +229,66 @@ impl Game<'_> { return; }; let (saddle, armor) = (open.saddle.clone(), open.armor.clone()); + let body = open.show_armor.then_some(armor); let items = open.items.clone(); - let m = &mut self.mobs[index]; + self.mount_store(index, saddle, body, items); + } + /// The slots of mount `index` as its menu shows them: the saddle, the + /// body item (None when the slot isn't active), the chest. + pub(super) fn mount_contents( + &self, + index: usize, + ) -> ( + Option, + Option>, + Vec>, + ) { + let m = &self.mobs[index]; + let species = m.species(); + let body = + shows_body(species).then(|| m.extra.head.as_deref().map(|i| ItemStack::new(i, 1))); + let mut items = m.extra.items.clone(); + items.resize(mount_columns(m) * 3, None); + (m.saddle_item(), body, items) + } + /// The menu's slots back on mount `index` (`body` None: not its slot), + /// with the equip sound of what was put on (`Equippable.equipSound`). + pub(super) fn mount_store( + &mut self, + index: usize, + saddle: Option, + body: Option>, + items: Vec>, + ) { + let m = &self.mobs[index]; let at = m.center(); - let sound = if saddle.is_some() && !m.extra.saddled { - Some("minecraft:entity.horse.saddle") - } else if armor.is_some() && m.extra.head.is_none() { - Some("minecraft:entity.horse.armor") + let put_on = if saddle.is_some() && !m.extra.saddled { + saddle.as_ref() } else { - None + body.as_ref() + .and_then(Option::as_ref) + .filter(|_| m.extra.head.is_none()) }; + let sound = put_on.map(|s| { + self.res + .items() + .get(&s.item) + .and_then(|i| i.equip_sound.clone()) + .unwrap_or_else(|| "minecraft:item.armor.equip_generic".into()) + }); + let m = &mut self.mobs[index]; m.set_saddle(saddle); - if open.show_armor { - m.extra.head = armor.map(|a| a.item); + if let Some(body) = body { + m.extra.head = body.map(|a| a.item); } + let mut items = items; + let keep = m.extra.items.len().max(CHEST_SIZE); + items.resize(keep, None); m.extra.items = items; let (x, z) = (at[0].floor() as i32 >> 4, at[2].floor() as i32 >> 4); self.world.modified.insert((x, z)); if let Some(sound) = sound { - self.audio.play(sound, Some(at), 0.5, 1.0); + self.audio.play(&sound, Some(at), 0.5, 1.0); } } pub(super) fn mount_slots(&self) -> Option> { @@ -214,7 +349,8 @@ impl Game<'_> { } /// A click in the mount menu before the generic handling. pub(super) fn mount_click(&mut self, right: bool) -> bool { - if !self.mount_active() { + // A server's menu: the click goes out like any container click. + if !self.mount_active() || self.remote.is_some() { return false; } let Some(r) = self.renderer.as_ref() else { @@ -314,12 +450,12 @@ impl Game<'_> { if open.show_armor { batch.sprite(atlas, "gui/sprites/container/slot", ox + 7.0, oy + 35.0); if open.armor.is_none() { - batch.sprite( - atlas, - "gui/sprites/container/slot/horse_armor", - ox + 8.0, - oy + 36.0, - ); + let sprite = if llama::is_llama(open.species) { + "gui/sprites/container/slot/llama_armor" + } else { + "gui/sprites/container/slot/horse_armor" + }; + batch.sprite(atlas, sprite, ox + 8.0, oy + 36.0); } } let grey = rgba(64, 64, 64, 255); @@ -448,4 +584,16 @@ mod tests { "minecraft:iron_chestplate" )); } + + #[test] + fn llamas_wear_carpets_and_no_saddle() { + assert!(body_armor_fits(Species::Llama, "minecraft:red_carpet")); + assert!(!body_armor_fits( + Species::Llama, + "minecraft:iron_horse_armor" + )); + assert!(shows_body(Species::TraderLlama)); + assert!(!shows_saddle(Species::Llama)); + assert!(shows_saddle(Species::Donkey) && !shows_body(Species::Donkey)); + } } diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index c482d9728..7ae8b9ed3 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -183,6 +183,9 @@ const CHUNK_PACKETS_PER_FRAME: Duration = Duration::from_millis(1); /// whatever their cost: the packets after a slow machine's chunks never /// wait more than a tick. const BACKLOG_LIMIT: Duration = Duration::from_millis(50); +/// The open menu name of a server's horse inventory, then its chest's +/// columns (the packet names no `MenuType`). +const MOUNT_MENU: &str = "horizon:mount"; fn face_direction(face: [i32; 3]) -> u8 { match face { @@ -1440,6 +1443,19 @@ impl Game<'_> { // CrafterMenu: the grid, the inventory, then the result (the // client's own). "minecraft:crafter_3x3" => slots(9), + // HorseInventoryMenu: the saddle, the body armour, the chest, + // then the inventory. + m if m.starts_with(MOUNT_MENU) => { + let n = m[MOUNT_MENU.len()..].parse::().ok()? * 3; + match s { + 0 => Some(super::mount_menu::SADDLE), + 1 => Some(super::mount_menu::ARMOR), + _ if s < 2 + n => Some(super::mount_menu::CHEST + s - 2), + _ if s < 2 + n + 27 => Some(9 + s - 2 - n), + _ if s < 2 + n + 36 => Some(s - 2 - n - 27), + _ => None, + } + } // A workstation: its inputs, its result, then the inventory. m => { let kind = Self::remote_station_kind(m)?; @@ -2204,6 +2220,7 @@ impl Game<'_> { } } C::OpenScreen(p) => self.remote_open_screen(p), + C::MountScreenOpen(p) => self.remote_open_mount(p), C::RecipeBookAdd(p) => self.remote_recipe_book_add(p), C::RecipeBookRemove(p) => self.remote_recipe_book_remove(p), C::RecipeBookSettings(p) => self.remote_recipe_book_settings(p), @@ -4099,6 +4116,18 @@ impl Game<'_> { } Ok(true) } + // MultiPlayerGameMode.isServerControlledInventory: riding a + // horse or llama, the server opens its inventory + // (ServerboundPlayerCommandPacket OPEN_INVENTORY). + KeyCode::KeyE if self.riding_mount_with_menu() => { + let id = self.remote.as_ref().map_or(0, |r| r.entity_id); + self.send(S::PlayerCommand(play::PlayerCommand { + id, + action: 5, + data: 0, + })); + Ok(true) + } KeyCode::KeyE => { // The inventory opens without telling the server. self.screen = if self.creative { @@ -4343,6 +4372,7 @@ impl Game<'_> { r.menu = None; r.menu_title = None; } + self.mount_menu_reset(); // The client's menu has no level access: what it holds is the server's. self.station = None; self.craft_size = 2; @@ -4527,6 +4557,21 @@ impl Game<'_> { self.screen = Screen::Inventory; self.capture(false); } + /// `ClientPacketListener.handleMountScreenOpen`: a horse's or llama's + /// inventory; for another entity the window is closed again. + fn remote_open_mount(&mut self, p: play::MountScreenOpen) { + let columns = usize::try_from(p.columns).unwrap_or(0).min(5); + if !self.open_remote_mount_menu(p.entity as u32, columns) { + self.send(S::ContainerClose(play::ContainerClose { + container: p.container, + })); + return; + } + if let Some(r) = self.remote.as_mut() { + r.menu = Some((p.container, format!("{MOUNT_MENU}{columns}"))); + r.menu_title = None; + } + } /// The type of the menu a server opened (`MenuType`'s id). pub(super) fn remote_menu_type(&self) -> Option<&str> { Some(self.remote.as_ref()?.menu.as_ref()?.1.as_str()) diff --git a/crates/horizon-client/src/lan/containers.rs b/crates/horizon-client/src/lan/containers.rs index 88f50aa3b..d43cb5c27 100644 --- a/crates/horizon-client/src/lan/containers.rs +++ b/crates/horizon-client/src/lan/containers.rs @@ -234,6 +234,23 @@ impl Hub { Some(window) } + /// ServerPlayer.openHorseInventory: the open container closes, a new + /// window id opens mount `entity`'s inventory with its chest's columns + /// (ClientboundMountScreenOpenPacket). + pub fn open_mount_window(&mut self, conn: u32, columns: i32, entity: i32) -> Option { + let i = self.guests.iter().position(|g| g.conn == conn)?; + self.close_container_at(i); + let g = &mut self.guests[i]; + g.next_window = g.next_window % 100 + 1; + let window = g.next_window; + g.send(&C::MountScreenOpen(play::MountScreenOpen { + container: window, + columns, + entity, + })); + Some(window) + } + fn send_menu_content(&mut self, i: usize, mut items: Vec>) { for j in 0..36 { items.push(self.guests[i].inventory[player_slot(j)].clone()); diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index 8d7b5e29a..bf66f979b 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -1972,6 +1972,10 @@ impl Hub { self.guests[i].sneaking = p.flags & 32 != 0; self.guests[i].sprinting = p.flags & 64 != 0 && p.flags & 1 != 0; } + // OPEN_INVENTORY is the game's: the ridden mount's inventory. + S::PlayerCommand(p) if p.action == 5 => { + events.push(HostEvent::Packet(conn, Box::new(S::PlayerCommand(p)))); + } S::PlayerCommand(p) => match p.action { 1 => self.guests[i].sprinting = true, 2 => self.guests[i].sprinting = false, diff --git a/crates/horizon-client/src/menu.rs b/crates/horizon-client/src/menu.rs index cb804e15b..cdaf73eed 100644 --- a/crates/horizon-client/src/menu.rs +++ b/crates/horizon-client/src/menu.rs @@ -114,6 +114,10 @@ pub enum Kind { Lectern, /// `MerchantMenu`: two payment slots, the result, then the inventory. Merchant, + /// `HorseInventoryMenu`: the saddle and body armour slots (`ArmorSlot`s + /// of the mount, whose entity type is `Menu::mount`), a chest of three + /// rows of this many columns (`getInventoryColumns`), then the inventory. + Mount(usize), /// `CreativeModeInventoryScreen.ItemPickerMenu`: an item tab's 45 /// display slots, then the hotbar. ItemPicker, @@ -124,6 +128,9 @@ impl Kind { if let Some(rows) = name.strip_prefix("chest") { return rows.parse().ok().map(Self::Chest); } + if let Some(columns) = name.strip_prefix("mount") { + return columns.parse().ok().map(Self::Mount); + } Some(match name { "inventory" => Self::Inventory, "crafting" => Self::Crafting, @@ -207,6 +214,9 @@ enum Role { /// `CustomCreativeSlot`: a creative tab's display slot, which the /// screen clicks itself; drags and PICKUP_ALL pass it by. CreativeDisplay, + /// An `ArmorSlot` of a mount for this `EquipmentSlot` ("saddle" or + /// "body"): `isEquippableInSlot` for `Menu::mount`, one item. + MountEquip(&'static str), } #[derive(Clone, Copy)] @@ -298,6 +308,9 @@ pub struct Menu { pub enchant_button: Option, /// `Player.mayBuild` (not adventure mode): the lectern's Take Book. pub may_build: bool, + /// A mount menu's entity type (`minecraft:horse`): what its saddle and + /// body slots take. + pub mount: Option, } /// `AnvilMenu`'s state besides its slots and `cost`. @@ -560,6 +573,22 @@ impl Menu { // The open page (LecternBlockEntity.dataAccess). data = 1; } + Kind::Mount(columns) => { + containers[MAIN] = vec![None; 2 + columns * 3]; + for (index, slot) in ["saddle", "body"].into_iter().enumerate() { + slots.push(Slot { + container: MAIN, + index, + role: Role::MountEquip(slot), + }); + } + slots.extend((2..2 + columns * 3).map(|index| Slot { + container: MAIN, + index, + role: Role::Plain, + })); + player(&mut slots); + } Kind::ItemPicker => { containers[MAIN] = vec![None; 45]; slots.extend(main(45, Role::CreativeDisplay)); @@ -654,6 +683,7 @@ impl Menu { enchant_changed: false, enchant_button: None, may_build: true, + mount: None, } .with_initial_data() } @@ -1186,6 +1216,15 @@ impl Menu { Some(slot == eq && allowed) }) .unwrap_or(false), + // LivingEntity.isEquippableInSlot: the item's equippable slot, + // and the mount among its allowed entities. + Role::MountEquip(slot) => env.items.get(&stack.item).is_some_and(|i| { + i.equip_slot.as_deref() == Some(slot) + && self + .mount + .as_deref() + .is_some_and(|m| i.equip_allowed.as_ref().is_none_or(|a| a.contains(m))) + }), Role::Shulker => Self::fits_inside(stack), Role::Fuel => Self::is_fuel(env, stack) || Self::is_bucket(stack), Role::Output | Role::CraftResult | Role::Inert => false, @@ -1257,7 +1296,7 @@ impl Menu { ); o.satisfied_by(env.items, a, b) || o.satisfied_by(env.items, b, a) }), - Role::Armor(_) => match self.slot(s) { + Role::Armor(_) | Role::MountEquip(_) => match self.slot(s) { Some(stack) => { self.creative || stack.enchantment_level("minecraft:binding_curse") == 0 } @@ -1270,7 +1309,11 @@ impl Menu { /// `Slot.getMaxStackSize(stack)`. fn slot_max(&self, env: &Env, s: usize, stack: &ItemStack) -> u32 { let own = match self.slots[s].role { - Role::Armor(_) | Role::Potion | Role::EnchantItem | Role::BeaconPay => 1, + Role::Armor(_) + | Role::MountEquip(_) + | Role::Potion + | Role::EnchantItem + | Role::BeaconPay => 1, // The lectern's bookAccess holds one. Role::Plain if self.kind == Kind::Lectern && self.slots[s].container == MAIN => 1, Role::Fuel if Self::is_bucket(stack) => return 1, @@ -2026,6 +2069,38 @@ impl Menu { } // LecternMenu.quickMoveStack moves nothing. Kind::Lectern => return None, + Kind::Mount(columns) => { + // AbstractMountInventoryMenu.quickMoveStack: no count check + // and no onTake. + check_count = false; + let start = 2 + columns * 3; + if index < start { + if !self.move_to(env, &mut stack, start, total, true) { + return None; + } + } else if self.may_place(env, 1, &stack) && self.containers[MAIN][1].is_none() { + if !self.move_to(env, &mut stack, 1, 2, false) { + return None; + } + } else if self.may_place(env, 0, &stack) && self.containers[MAIN][0].is_none() { + if !self.move_to(env, &mut stack, 0, 1, false) { + return None; + } + } else if columns == 0 || !self.move_to(env, &mut stack, 2, start, false) { + // Between the inventory and the hotbar: the stack shrinks + // in its slot and EMPTY is returned either way. + let (main_end, hotbar_end) = (start + 27, start + 36); + if (main_end..hotbar_end).contains(&index) { + self.move_to(env, &mut stack, start, main_end, false); + } else if (start..main_end).contains(&index) { + self.move_to(env, &mut stack, main_end, hotbar_end, false); + } + let slot = self.slots[index]; + self.containers[slot.container][slot.index] = + (stack.count > 0).then(|| stack.clone()); + return None; + } + } Kind::Beacon => { // BeaconMenu.quickMoveStack. after_take = true; @@ -2946,6 +3021,65 @@ pub(crate) mod tests { test(&env, &mut menu); } + /// `HorseInventoryMenu`: a shift-click wears horse armour, then saddles, + /// then fills the chest; the body slot takes only what the mount may wear. + #[test] + fn mount_menu_slots_take_what_the_mount_wears() { + with_menu(Kind::Mount(5), |env, menu| { + menu.creative = false; + menu.mount = Some("minecraft:donkey".into()); + // 2 saddle and body, 15 chest, then the inventory from 17. + assert_eq!(menu.slot_count(), 2 + 15 + 36); + let hotbar = 17 + 27; + menu.set_slot(env, hotbar, stack("iron_horse_armor", 1)); + menu.click(env, hotbar as i32, 0, Input::QuickMove).unwrap(); + // A donkey wears no horse armour: it goes in the chest. + assert_eq!(menu.slot(1), None); + assert_eq!( + menu.slot(2).map(|s| &*s.item), + Some("minecraft:iron_horse_armor") + ); + menu.set_slot(env, hotbar, stack("saddle", 1)); + menu.click(env, hotbar as i32, 0, Input::QuickMove).unwrap(); + assert_eq!(menu.slot(0).map(|s| &*s.item), Some("minecraft:saddle")); + // Back out of the mount: to the inventory, from the hotbar's end. + menu.click(env, 0, 0, Input::QuickMove).unwrap(); + assert_eq!(menu.slot(0), None); + assert_eq!( + menu.slot(17 + 35).map(|s| &*s.item), + Some("minecraft:saddle") + ); + }); + with_menu(Kind::Mount(0), |env, menu| { + menu.creative = false; + menu.mount = Some("minecraft:horse".into()); + let hotbar = 2 + 27; + menu.set_slot(env, hotbar, stack("diamond_horse_armor", 1)); + menu.click(env, hotbar as i32, 0, Input::QuickMove).unwrap(); + assert_eq!( + menu.slot(1).map(|s| &*s.item), + Some("minecraft:diamond_horse_armor") + ); + // No chest: dirt goes between the hotbar and the inventory. + menu.set_slot(env, hotbar, stack("dirt", 3)); + menu.click(env, hotbar as i32, 0, Input::QuickMove).unwrap(); + assert_eq!( + menu.slot(2).map(|s| (&*s.item, s.count)), + Some(("minecraft:dirt", 3)) + ); + assert_eq!(menu.slot(hotbar), None); + // Placing by hand: a saddle doesn't go in the body slot. + menu.carried = stack("saddle", 1); + menu.click(env, 1, 0, Input::Pickup).unwrap(); + assert_eq!( + menu.slot(1).map(|s| &*s.item), + Some("minecraft:diamond_horse_armor") + ); + menu.click(env, 0, 0, Input::Pickup).unwrap(); + assert_eq!(menu.slot(0).map(|s| &*s.item), Some("minecraft:saddle")); + }); + } + /// `onEquipItem` runs from the armour and off-hand slots' `setByPlayer` /// when the item changes: never from `Inventory.setItem` (a swap's source). #[test] diff --git a/crates/horizon-protocol/src/packets/play.rs b/crates/horizon-protocol/src/packets/play.rs index e737258c5..24eec6a05 100644 --- a/crates/horizon-protocol/src/packets/play.rs +++ b/crates/horizon-protocol/src/packets/play.rs @@ -458,6 +458,9 @@ move_entity!(MoveEntityPos, pos: true, rot: false); move_entity!(MoveEntityPosRot, pos: true, rot: true); move_entity!(MoveEntityRot, pos: false, rot: true); packet!(OpenScreen { container: i32 => VarInt, menu: i32 => VarInt, title: Tag => Nbt }); +// ClientboundMountScreenOpenPacket: a horse's or llama's inventory, with its +// chest's columns (`getInventoryColumns`). +packet!(MountScreenOpen { container: i32 => VarInt, columns: i32 => VarInt, entity: i32 => Int }); packet!(PlayerAbilities { flags: i8 => Byte, flying_speed: f32 => Float, walking_speed: f32 => Float }); /// MessageSignature.Packed: an index into the last-seen cache or a full signature. pub struct PackedSignature; @@ -1497,6 +1500,7 @@ packet_enum!(Clientbound, crate::ids::play::clientbound { MoveEntityPosRot(MoveEntityPosRot) = MOVE_ENTITY_POS_ROT, MoveEntityRot(MoveEntityRot) = MOVE_ENTITY_ROT, MerchantOffers(MerchantOffers) = MERCHANT_OFFERS, + MountScreenOpen(MountScreenOpen) = MOUNT_SCREEN_OPEN, OpenScreen(OpenScreen) = OPEN_SCREEN, Ping(Ping) = PING, PongResponse(crate::packets::status::Ping) = PONG_RESPONSE, @@ -2179,6 +2183,11 @@ mod tests { menu: 2, title: literal("Chest"), }), + Clientbound::MountScreenOpen(MountScreenOpen { + container: 4, + columns: 5, + entity: 300, + }), Clientbound::MerchantOffers(MerchantOffers { container: 3, offers: vec![NetOffer { diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 894bb8627..c5a90150f 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -123,6 +123,9 @@ address. The script then checks, from both sides, what a guest's game used to ge it (#1222). - frames: the host and the guest each put a diamond in an item frame and turn it, and put a helmet on an armor stand and take it back (#1222). +- mounts: the host and the guest each open a tamed horse's, donkey's and llama's inventory + (shift + right click, then the inventory key while riding), put on a saddle, armour + or a carpet and fill the chest by shift-clicking. - riding: the host and the guest each saddle and ride a horse (walk, jump), a pig and a strider (with their sticks), a camel and a donkey, sit on a llama and fly a happy ghast, and get off by sneaking; the other side sees the animal move. @@ -169,7 +172,7 @@ ROOT = Path(__file__).resolve().parents[1] GUEST_NAME = 'Guest' # The host plays single player on its server thread (--server-thread). SERVER_THREAD = False -CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder', 'boats', 'minecarts', 'frames', 'lightning', 'riding'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder', 'boats', 'minecarts', 'frames', 'lightning', 'riding', 'mounts'] class Game: @@ -2638,6 +2641,101 @@ def check_riding(host, guest, out): return result +# Mount inventories: (kind, summon NBT, what goes in by shift-click and the menu slot it lands +# in: 700 the saddle, 701 the body armour or carpet, 710 the chest's first slot). +MOUNT_MENUS = [ + ('horse', '{Tame:1b,NoAI:1b}', [('minecraft:saddle', 700), ('minecraft:iron_horse_armor', 701)]), + ('donkey', '{Tame:1b,NoAI:1b,ChestedHorse:1b}', [('minecraft:saddle', 700), ('minecraft:dirt', 710)]), + ('llama', '{Tame:1b,NoAI:1b,ChestedHorse:1b,Strength:3}', + [('minecraft:red_carpet', 701), ('minecraft:dirt', 710)]), +] + + +def mount_screen(game, ticks=20): + """The open mount menu's slots and items ({700: 'minecraft:saddle', ...}), waiting up to + `ticks` for it to open; None when no mount menu opened.""" + for _ in range(ticks // 2): + slots = {} + for w in game.raw('ui').get('widgets', []): + wid = w.get('id', '') + if wid.startswith('slot-') and wid[5:].isdigit() and int(wid[5:]) >= 700: + slots[int(wid[5:])] = (w.get('stack') or {}).get('item') + if slots: + return slots + game.wait(2) + return None + + +def check_mounts(host, guest, out): + """The host and the guest each open a tamed horse's, donkey's and llama's inventory with + shift + right click (`ClientboundMountScreenOpenPacket` for a server's player), put on a + saddle, horse armour or a carpet and fill the chest by shift-clicking, close it, then ride the + mount and open its inventory with the inventory key (OPEN_INVENTORY): it shows what was put + in, and the server took the items from the inventory.""" + spots = apart(host, guest) + result = {} + for label, player in (('host', host), ('guest', guest)): + x, y, z = spots[label] + player('command', command='gamemode survival') + result[label] = {} + for kind, nbt, puts in MOUNT_MENUS: + player('command', command='clear @s') + for item, _ in puts: + player('command', command=f'give @s {item}') + player('command', command=f'summon minecraft:{kind} {x + 0.5} {y} {z + 2.5} {nbt}') + player.wait(5) + found = [m for m in player.raw('mobs', 16).get('near', []) + if m['kind'].endswith(kind) and m['health'] > 0] + assert found, f'the {label} sees no {kind}' + mob = found[0] + p = mob['pos'] + aim = (f'{p[0]:.2f}', f'{p[1] + HEIGHTS[kind] / 2:.2f}', f'{p[2]:.2f}') + try: + player.raw('look-at', *aim) + player.raw('key', 'shift', 'down') + player.wait(3) + player.raw('mouse', 'right', 'click') + player.wait(5) + player.raw('key', 'shift', 'up') + slots = mount_screen(player) + assert slots is not None, f"the {label}'s shift + right click on the {kind} opened no inventory" + for item, _ in puts: + player.raw('click-slot', hotbar_slot(player, item), 'shift') + player.wait(5) + slots = mount_screen(player) + for item, slot in puts: + assert slots.get(slot) == item, f"the {label}'s {kind}: {item} shift-clicked, slot {slot} holds {slots.get(slot)}" + player.raw('key', 'esc', 'tap') + player.wait(5) + for item, _ in puts: + left = server_count(player, item.split(':')[1]) + assert left == 0, f'the server still counts {left} {item} on the {label}' + player.raw('look-at', *aim) + player.raw('mouse', 'right', 'click') + player.wait(8) + riding = player('status').get('riding') + assert riding == mob['id'], f'the {label} right-clicked its {kind}: riding {riding}' + player.raw('key', 'e', 'tap') + again = mount_screen(player) + assert again is not None, f'the inventory key on the {label}\'s {kind} opened no inventory' + for item, slot in puts: + assert again.get(slot) == item, f"the {label}'s {kind} reopened: slot {slot} holds {again.get(slot)}, not {item}" + player.raw('key', 'esc', 'tap') + player.wait(3) + hold(player, 'shift', 10) + player.wait(5) + result[label][kind] = {slot: item for item, slot in puts} + finally: + back_to_game(player) + player('command', command=f'kill @e[type=minecraft:{kind},x={x},y={y},z={z},distance=..16]') + player.wait(2) + player('command', command=f'kill @e[type=minecraft:item,x={x},y={y},z={z},distance=..16]') + player('command', command='clear @s') + player('command', command=f'tp @s {x + 0.5} {y} {z + 0.5} 0 0') + player.wait(5) + return result + + def check_lightning(host, guest, out): """A bolt summoned beside each player: both sides get the bolt entity and flash the sky (the host's window too on its server thread, FEATURES 4z(f)).""" @@ -2977,7 +3075,7 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles, 'blast': check_blast, 'light': check_light, 'plates': check_plates, 'swings': check_swings, 'cracks': check_cracks, - 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder, 'boats': check_boats, 'minecarts': check_minecarts, 'frames': check_frames, 'lightning': check_lightning, 'riding': check_riding} + 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder, 'boats': check_boats, 'minecarts': check_minecarts, 'frames': check_frames, 'lightning': check_lightning, 'riding': check_riding, 'mounts': check_mounts} def run(ctl, out, resources, checks): From bdbe59155d344623d9dec6871cfac2a11891fac1 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 01:56:28 +0200 Subject: [PATCH 075/126] Locator bar: drop the live-backdrop check main removed #1271 removed the title's live world backdrop (backdrop_live), so the locator bar hides on the title alone. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 4d56f21e6..e186e9e3f 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -9801,7 +9801,7 @@ impl Game<'_> { self.fov_degrees(camera_alpha as f32, camera.to_array()) }; self.locator_camera = - (!live && !title).then_some((camera.to_array(), view_yaw, view_pitch, fov_degrees)); + (!title).then_some((camera.to_array(), view_yaw, view_pitch, fov_degrees)); let bob = if title { glam::Mat4::IDENTITY } else { From 828398b5ecc32ae782437c6f72f640464cce08c7 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 01:59:39 +0200 Subject: [PATCH 076/126] Telemetry: every hardware fact that explains performance, broken down by class What players send (opt-in, unchanged switches) now describes the whole machine: CPU cores and base/boost clock, the GPU's maker, integrated or discrete and its VRAM, the drive under the game folder (NVMe/SSD/HDD), the screen (size, refresh, scale), on battery or mains, laptop or desktop. Perf, crash and bug items carry them in `system`; benchmark reports in `hardware`. No serials, host or user names, or paths. CONSENT_VERSION goes to 2, so players are asked again. The server keeps the new fields in `systems.extra` (the table is rebuilt once on old databases, ids kept). /v1/aggregate and /v1/benchmarks/summary add breakdowns by RAM class, VRAM class, drive, OS and integrated/discrete GPU; a class is published only with at least 3 different installs, never a raw value. website/scripts/benchmarks.mjs mirrors the classes on the shared fixtures. The summary's "not Horizon or plain vanilla" check returned None (accepted) instead of the rejection; it now matches the site's script. The launcher's "View what would be sent" and `data show` list every field. Co-Authored-By: Claude Opus 5.5 --- Cargo.lock | 1 + crates/horizon-bench/Cargo.toml | 2 + crates/horizon-bench/src/hardware.rs | 70 ++- crates/horizon-client/src/benchmark.rs | 15 + crates/horizon-client/src/game.rs | 16 + crates/horizon-client/src/gfx.rs | 12 +- crates/horizon-client/src/telemetry.rs | 67 ++- .../horizon-telemetry-server/src/classes.rs | 103 ++++ crates/horizon-telemetry-server/src/lib.rs | 1 + crates/horizon-telemetry-server/src/store.rs | 222 +++++++- .../horizon-telemetry-server/src/summary.rs | 43 +- .../horizon-telemetry-server/tests/server.rs | 39 ++ .../horizon-telemetry-server/tests/summary.rs | 4 + crates/horizon-telemetry/src/lib.rs | 5 +- crates/horizon-telemetry/src/payload.rs | 39 +- crates/horizon-telemetry/src/system.rs | 484 +++++++++++++++++- docs/benchmark-report.md | 11 +- docs/telemetry.md | 37 +- launcher/src/telemetry.rs | 40 +- website/scripts/benchmarks.mjs | 50 +- website/scripts/benchmarks.test.mjs | 28 +- website/scripts/fixtures/benchmarks/README.md | 3 + .../scripts/fixtures/benchmarks/expected.json | 7 +- .../scripts/fixtures/benchmarks/items.jsonl | 28 +- website/src/privacy.html | 16 +- 25 files changed, 1252 insertions(+), 91 deletions(-) create mode 100644 crates/horizon-telemetry-server/src/classes.rs diff --git a/Cargo.lock b/Cargo.lock index 16ae8d6eb..2f832e248 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -1395,6 +1395,7 @@ dependencies = [ name = "horizon-bench" version = "0.1.0" dependencies = [ + "horizon-telemetry", "serde", "serde_json", ] diff --git a/crates/horizon-bench/Cargo.toml b/crates/horizon-bench/Cargo.toml index b945577b0..5a1884990 100644 --- a/crates/horizon-bench/Cargo.toml +++ b/crates/horizon-bench/Cargo.toml @@ -8,3 +8,5 @@ description = "The benchmark report format (docs/benchmark-report.md), shared by [dependencies] serde = { version = "1", features = ["derive"] } serde_json = "1" +# The hardware probes shared with telemetry (cores, clocks, drive, VRAM, power, form). +horizon-telemetry = { path = "../horizon-telemetry", default-features = false } diff --git a/crates/horizon-bench/src/hardware.rs b/crates/horizon-bench/src/hardware.rs index 4e41a0405..17e460bed 100644 --- a/crates/horizon-bench/src/hardware.rs +++ b/crates/horizon-bench/src/hardware.rs @@ -16,8 +16,22 @@ pub struct Hardware { pub cpu: Option, #[serde(default, skip_serializing_if = "Option::is_none")] pub cpu_threads: Option, + /// Physical cores. + #[serde(default, skip_serializing_if = "Option::is_none")] + pub cpu_cores: Option, + /// Base and top boost clock, where the OS gives them. + #[serde(default, skip_serializing_if = "Option::is_none")] + pub cpu_base_mhz: Option, + #[serde(default, skip_serializing_if = "Option::is_none")] + pub cpu_boost_mhz: Option, #[serde(default, skip_serializing_if = "Option::is_none")] pub ram_mb: Option, + /// The drive under the game folder: `nvme`, `ssd` or `hdd`. + #[serde(default, skip_serializing_if = "Option::is_none")] + pub storage: Option, + /// `laptop` or `desktop`. + #[serde(default, skip_serializing_if = "Option::is_none")] + pub form: Option, #[serde(default, skip_serializing_if = "Option::is_none")] pub gpu: Option, #[serde(default, skip_serializing_if = "Option::is_none")] @@ -33,6 +47,9 @@ pub struct Gpu { pub backend: String, /// `integrated`, `discrete`, `virtual`, `cpu`, `other`. pub kind: String, + /// Its own memory in MiB (rounded to 256), for a discrete GPU whose driver says. + #[serde(default, skip_serializing_if = "Option::is_none")] + pub vram_mb: Option, } #[derive(Clone, Debug, Default, PartialEq, Serialize, Deserialize)] @@ -47,17 +64,50 @@ pub struct Display { impl Hardware { pub fn detect() -> Hardware { + let probes = probes(); Hardware { os: std::env::consts::OS.to_owned(), os_version: os_version(), arch: std::env::consts::ARCH.to_owned(), cpu: cpu(), cpu_threads: std::thread::available_parallelism().ok().map(|n| n.get()), + cpu_cores: probes.cores, + cpu_base_mhz: probes.base, + cpu_boost_mhz: probes.boost, ram_mb: ram_bytes().map(|b| b >> 20), + storage: None, + form: probes.form, gpu: None, display: None, } } + + /// [`Hardware::detect`] with the kind of drive `game_dir` is on. + pub fn detect_in(game_dir: &std::path::Path) -> Hardware { + Hardware { + storage: horizon_telemetry::system::storage(game_dir).map(str::to_owned), + ..Hardware::detect() + } + } +} + +/// What the telemetry probes read (`horizon_telemetry::system`). +struct Probes { + cores: Option, + base: Option, + boost: Option, + form: Option, +} + +fn probes() -> Probes { + let s = horizon_telemetry::payload::System::detect(); + let some = |n: u32| (n > 0).then_some(n); + Probes { + cores: (s.cores > 0).then_some(s.cores), + base: some(s.cpu_base_mhz), + boost: some(s.cpu_boost_mhz), + form: (!s.form.is_empty()).then_some(s.form), + } } /// The one-minute load average: above about the number of threads the machine was busy. @@ -82,25 +132,7 @@ pub fn load_average() -> Option { /// `ac` or `battery`; `None` where it can't be read (and on machines without a battery on Linux). pub fn power_source() -> Option<&'static str> { - if cfg!(target_os = "macos") { - let batt = output("pmset", &["-g", "batt"])?; - return Some(if batt.contains("'Battery Power'") { - "battery" - } else { - "ac" - }); - } - let mut on_battery = None; - for entry in std::fs::read_dir("/sys/class/power_supply").ok()?.flatten() { - let read = - |name: &str| std::fs::read_to_string(entry.path().join(name)).unwrap_or_default(); - match read("type").trim() { - "Mains" if read("online").trim() == "1" => return Some("ac"), - "Battery" => on_battery = Some("battery"), - _ => {} - } - } - on_battery + horizon_telemetry::system::power() } /// Resident memory of a process, in bytes (macOS, Linux). diff --git a/crates/horizon-client/src/benchmark.rs b/crates/horizon-client/src/benchmark.rs index 483a68848..00e3ade71 100644 --- a/crates/horizon-client/src/benchmark.rs +++ b/crates/horizon-client/src/benchmark.rs @@ -140,7 +140,22 @@ fn run(control: &Control, setup: Setup) -> Result { driver: text(&renderer["driver"]), backend: text(&renderer["backend"]).to_lowercase(), kind: text(&renderer["device_type"]), + vram_mb: None, }); + if let Some(gpu) = report.hardware.gpu.as_mut() { + let vendor = horizon_telemetry::system::gpu_vendor(&gpu.name, 0); + let vendor = if gpu.vendor.is_empty() { + vendor + } else { + gpu.vendor.as_str() + } + .to_owned(); + if gpu.kind.contains("iscrete") { + gpu.vram_mb = horizon_telemetry::system::vram_mb(&vendor); + } + } + report.hardware.storage = + horizon_telemetry::system::storage(&setup.game_dir).map(str::to_owned); report.hardware.display = serde_json::from_value(title["display"].clone()).ok(); replace_world(&setup.game_dir)?; diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 7ec21608a..f69198a92 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -10501,6 +10501,14 @@ impl ApplicationHandler for Game<'_> { return; } }; + if let Some(m) = window.current_monitor() { + horizon_client::telemetry::set_display( + m.size().width, + m.size().height, + m.refresh_rate_millihertz().map_or(0, |r| r.div_ceil(1000)), + m.scale_factor(), + ); + } match self.new_renderer(window.clone()) { Ok(r) => { self.renderer = Some(r); @@ -12592,6 +12600,14 @@ impl Loading { return; } }; + if let Some(m) = window.current_monitor() { + horizon_client::telemetry::set_display( + m.size().width, + m.size().height, + m.refresh_rate_millihertz().map_or(0, |r| r.div_ceil(1000)), + m.scale_factor(), + ); + } let offscreen = self.options.as_ref().is_some_and(|o| o.offscreen); match loading_renderer( window.clone(), diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 9250940da..956e7b208 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -694,13 +694,15 @@ fn describe_adapter(adapter: &wgpu::Adapter) { info.backend, info.device_type ); - crate::telemetry::set_gpu( - &info.name, - format!("{} {}", info.driver, info.driver_info) + crate::telemetry::set_gpu(crate::telemetry::Gpu { + name: info.name.clone(), + vendor: horizon_telemetry::system::gpu_vendor(&info.name, info.vendor).to_owned(), + kind: crate::telemetry::gpu_kind(&format!("{:?}", info.device_type)).to_owned(), + driver: format!("{} {}", info.driver, info.driver_info) .trim() .to_owned(), - format!("{:?}", info.backend), - ); + backend: format!("{:?}", info.backend), + }); crate::crash::set_detail( "Graphics Adapter", format!( diff --git a/crates/horizon-client/src/telemetry.rs b/crates/horizon-client/src/telemetry.rs index 4a4da2094..b8b7af0b4 100644 --- a/crates/horizon-client/src/telemetry.rs +++ b/crates/horizon-client/src/telemetry.rs @@ -8,7 +8,7 @@ use std::sync::atomic::{AtomicU32, Ordering}; use std::sync::{Mutex, OnceLock}; use std::time::Instant; -use horizon_telemetry::payload::{Crash, Perf, Settings, System, Timings}; +use horizon_telemetry::payload::{Crash, Display, Perf, Settings, System, Timings}; use horizon_telemetry::scrub::Scrubber; use horizon_telemetry::{Item, Payload, Source, outbox}; @@ -25,8 +25,21 @@ static STARTED: OnceLock = OnceLock::new(); static UI_READY_MS: AtomicU32 = AtomicU32::new(u32::MAX); static CORE_READY_MS: AtomicU32 = AtomicU32::new(u32::MAX); static REST_READY_MS: AtomicU32 = AtomicU32::new(u32::MAX); -/// The GPU's name, driver and backend, once the renderer has its adapter. -static GPU: Mutex> = Mutex::new(None); +/// The GPU, once the renderer has its adapter: name, maker, kind, driver, backend, its own memory. +static GPU: Mutex> = Mutex::new(None); +/// The screen the window opened on. +static DISPLAY: Mutex> = Mutex::new(None); + +/// The adapter as the renderer found it. +#[derive(Clone, Debug, Default)] +pub struct Gpu { + pub name: String, + pub vendor: String, + /// `integrated`, `discrete`, `virtual`, `cpu` or `other`. + pub kind: String, + pub driver: String, + pub backend: String, +} /// When the game started, for the time to the title screen. Call first thing in `main`. pub fn mark_start() { @@ -61,18 +74,48 @@ fn readiness_ms(mark: &AtomicU32) -> Option { (ms != u32::MAX).then_some(ms) } -pub fn set_gpu(name: &str, driver: String, backend: String) { - *GPU.lock().unwrap_or_else(|e| e.into_inner()) = Some((name.to_owned(), driver, backend)); +pub fn set_gpu(gpu: Gpu) { + *GPU.lock().unwrap_or_else(|e| e.into_inner()) = Some(gpu); } -/// This machine, with the GPU once the renderer knows it. -pub fn system() -> System { - let mut system = System::detect(); - if let Some((gpu, driver, backend)) = GPU.lock().unwrap_or_else(|e| e.into_inner()).clone() { - system.gpu = gpu; - system.driver = driver; - system.backend = backend; +/// The screen the window is on: size in physical pixels, refresh rate, scale. +pub fn set_display(width: u32, height: u32, refresh_hz: u32, scale: f64) { + *DISPLAY.lock().unwrap_or_else(|e| e.into_inner()) = Some(Display { + width, + height, + refresh_hz, + scale: scale as f32, + }); +} + +/// wgpu's device type in the words items use. +pub fn gpu_kind(device_type: &str) -> &'static str { + match device_type { + "IntegratedGpu" => "integrated", + "DiscreteGpu" => "discrete", + "VirtualGpu" => "virtual", + "Cpu" => "cpu", + _ => "other", } +} + +/// This machine, with the GPU and the screen once the renderer knows them. The drive is the one +/// under the game folder (the current folder). +pub fn system() -> System { + let home = std::env::current_dir().ok(); + let mut system = System::detect_in(home.as_deref()); + if let Some(gpu) = GPU.lock().unwrap_or_else(|e| e.into_inner()).clone() { + system.vram_mb = match gpu.kind.as_str() { + "discrete" => horizon_telemetry::system::vram_mb(&gpu.vendor).unwrap_or(0), + _ => 0, + }; + system.gpu = gpu.name; + system.gpu_vendor = gpu.vendor; + system.gpu_kind = gpu.kind; + system.driver = gpu.driver; + system.backend = gpu.backend; + } + system.display = DISPLAY.lock().unwrap_or_else(|e| e.into_inner()).clone(); system } diff --git a/crates/horizon-telemetry-server/src/classes.rs b/crates/horizon-telemetry-server/src/classes.rs new file mode 100644 index 000000000..fce2826fd --- /dev/null +++ b/crates/horizon-telemetry-server/src/classes.rs @@ -0,0 +1,103 @@ +//! The hardware classes the public output breaks results down by. Coarse on purpose: a class +//! holds many machines, and a published cell still needs `MIN_INSTALLS` different installs. +//! `website/scripts/benchmarks.mjs` has the same functions, tested on the same fixtures. +//! +//! The raw values (the exact memory, the driver, the screen) stay in the database for the +//! retention period and are never published. +use horizon_telemetry::payload::System; +use serde_json::Value; + +/// The dimensions, in the order [`of_report`] and [`of_system`] return them. +pub const DIMENSIONS: [&str; 5] = ["ram", "vram", "storage", "os", "gpu_kind"]; + +pub type Classes = [Option<&'static str>; 5]; + +/// Installed memory in GB (a little under the size on the box: some is reserved). +pub fn ram(gb: f64) -> Option<&'static str> { + Some(match gb { + g if g.is_nan() || g <= 0.0 => return None, + g if g <= 5.0 => "4 GB or less", + g if g <= 10.0 => "8 GB", + g if g <= 20.0 => "16 GB", + g if g <= 40.0 => "32 GB", + _ => "64 GB or more", + }) +} + +/// A GPU's own memory in MiB; an integrated GPU shares the system's. +pub fn vram(mb: f64, kind: &str) -> Option<&'static str> { + if gpu_kind(kind) == Some("integrated") { + return Some("shared"); + } + Some(match mb { + m if m.is_nan() || m <= 0.0 => return None, + m if m <= 2560.0 => "2 GB or less", + m if m <= 4608.0 => "4 GB", + m if m <= 6656.0 => "6 GB", + m if m <= 8704.0 => "8 GB", + m if m <= 12800.0 => "12 GB", + m if m <= 16896.0 => "16 GB", + _ => "more than 16 GB", + }) +} + +pub fn storage(s: &str) -> Option<&'static str> { + ["nvme", "ssd", "hdd"].into_iter().find(|k| *k == s) +} + +pub fn os(s: &str) -> Option<&'static str> { + ["linux", "macos", "windows"].into_iter().find(|k| *k == s) +} + +/// `integrated` or `discrete`, from either wording (`IntegratedGpu`, as wgpu says it, too). +pub fn gpu_kind(s: &str) -> Option<&'static str> { + match s { + "integrated" | "IntegratedGpu" => Some("integrated"), + "discrete" | "DiscreteGpu" => Some("discrete"), + _ => None, + } +} + +/// A benchmark report's classes (`docs/benchmark-report.md`'s `hardware`). +pub fn of_report(report: &Value) -> Classes { + let hw = &report["hardware"]; + let kind = hw["gpu"]["kind"].as_str().unwrap_or(""); + [ + hw["ram_mb"].as_f64().and_then(|mb| ram(mb / 1024.0)), + vram(hw["gpu"]["vram_mb"].as_f64().unwrap_or(0.0), kind), + storage(hw["storage"].as_str().unwrap_or("")), + os(hw["os"].as_str().unwrap_or("")), + gpu_kind(kind), + ] +} + +/// A telemetry item's machine's classes. +pub fn of_system(s: &System) -> Classes { + [ + ram(f64::from(s.ram_gb)), + vram(f64::from(s.vram_mb), &s.gpu_kind), + storage(&s.storage), + os(&s.os), + gpu_kind(&s.gpu_kind), + ] +} + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn classes_are_coarse() { + assert_eq!(ram(15.6), Some("16 GB")); + assert_eq!(ram(31.0), Some("32 GB")); + assert_eq!(ram(64.0), Some("64 GB or more")); + assert_eq!(ram(0.0), None); + assert_eq!(vram(16376.0, "discrete"), Some("16 GB")); + assert_eq!(vram(8192.0, "DiscreteGpu"), Some("8 GB")); + assert_eq!(vram(0.0, "integrated"), Some("shared")); + assert_eq!(vram(0.0, ""), None); + assert_eq!(storage("nvme"), Some("nvme")); + assert_eq!(storage("tape"), None); + assert_eq!(gpu_kind("virtual"), None); + } +} diff --git a/crates/horizon-telemetry-server/src/lib.rs b/crates/horizon-telemetry-server/src/lib.rs index c00002531..1a8e750e6 100644 --- a/crates/horizon-telemetry-server/src/lib.rs +++ b/crates/horizon-telemetry-server/src/lib.rs @@ -26,6 +26,7 @@ use axum::response::{IntoResponse, Response}; use axum::routing::{delete, get, post}; use horizon_telemetry::batch; +pub mod classes; pub mod live; pub mod store; pub mod summary; diff --git a/crates/horizon-telemetry-server/src/store.rs b/crates/horizon-telemetry-server/src/store.rs index 5188657ee..02c8803ae 100644 --- a/crates/horizon-telemetry-server/src/store.rs +++ b/crates/horizon-telemetry-server/src/store.rs @@ -1,7 +1,8 @@ //! The database: one SQLite file, kept small. //! //! - `systems`: each distinct machine description once. Rows point at it, so a CPU and GPU -//! name isn't stored again with every session. +//! name isn't stored again with every session. `extra` holds the later hardware fields +//! (cores, clocks, GPU maker and kind, VRAM, drive, screen, power, form) as JSON. //! - `perf`: one row per play session, in columns. A frame or tick summary is an 80-byte blob //! ([`pack`]), not JSON. //! - `reports`: crash and bug reports and benchmark uploads, their `data` zstd-compressed. @@ -17,6 +18,7 @@ use horizon_telemetry::Kind; use horizon_telemetry::batch::Batch; use horizon_telemetry::payload::{BUCKET_EDGES_MS, Payload, Summary, System}; use rusqlite::{Connection, OptionalExtension, params}; +use serde::{Deserialize, Serialize}; const BUCKETS: usize = BUCKET_EDGES_MS.len() + 1; @@ -27,8 +29,8 @@ CREATE TABLE IF NOT EXISTS systems ( id INTEGER PRIMARY KEY, os TEXT NOT NULL, os_version TEXT NOT NULL, arch TEXT NOT NULL, cpu TEXT NOT NULL, threads INTEGER NOT NULL, ram_gb INTEGER NOT NULL, - gpu TEXT NOT NULL, driver TEXT NOT NULL, backend TEXT NOT NULL, - UNIQUE (os, os_version, arch, cpu, threads, ram_gb, gpu, driver, backend) + gpu TEXT NOT NULL, driver TEXT NOT NULL, backend TEXT NOT NULL, extra TEXT NOT NULL DEFAULT '{}', + UNIQUE (os, os_version, arch, cpu, threads, ram_gb, gpu, driver, backend, extra) ); CREATE TABLE IF NOT EXISTS perf ( install BLOB NOT NULL, day INTEGER NOT NULL, version TEXT NOT NULL, system INTEGER NOT NULL, @@ -126,8 +128,9 @@ pub struct Store { impl Store { pub fn open(path: &str) -> rusqlite::Result { - let db = Connection::open(path)?; + let mut db = Connection::open(path)?; db.execute_batch(SCHEMA)?; + migrate(&mut db)?; Ok(Self { db }) } @@ -357,14 +360,91 @@ impl Store { })? .collect::>()? }; + let breakdowns = self.breakdowns(from, to)?; Ok(serde_json::json!({ "from_day": from, "to_day": to, "min_install_days": k, "bucket_edges_ms": BUCKET_EDGES_MS.map(|e| (f64::from(e) * 10.0).round() / 10.0), "totals": { "sessions": sessions, "hours": (hours * 10.0).round() / 10.0 }, - "groups": out, "crashes_by_version": crashes, + "groups": out, "crashes_by_version": crashes, "breakdowns": breakdowns, })) } + /// Play sessions in `from..=to` per hardware class (`classes`): for each RAM, VRAM, drive, + /// OS and GPU kind class with at least `MIN_INSTALLS` different installs, its installs, + /// sessions, hours and mean p50 and p99 frame times. From the raw rows, so only within the + /// retention period. + fn breakdowns(&self, from: u32, to: u32) -> rusqlite::Result { + #[derive(Default)] + struct Cell { + installs: HashSet>, + sessions: u64, + seconds: u64, + p50_sum: f64, + p99_sum: f64, + } + let mut cells: [HashMap<&'static str, Cell>; 5] = Default::default(); + let mut q = self.db.prepare( + "SELECT perf.install, perf.seconds, perf.frames, systems.os, systems.ram_gb, systems.extra + FROM perf JOIN systems ON systems.id = perf.system WHERE perf.day BETWEEN ?1 AND ?2", + )?; + let mut rows = q.query([from, to])?; + while let Some(r) = rows.next()? { + let Some(frames) = unpack(&r.get::<_, Vec>(2)?) else { + continue; + }; + let extra: Extra = serde_json::from_str(&r.get::<_, String>(5)?).unwrap_or_default(); + let system = System { + os: r.get(3)?, + ram_gb: r.get(4)?, + gpu_kind: extra.gpu_kind, + vram_mb: extra.vram_mb, + storage: extra.storage, + ..System::default() + }; + let install: Vec = r.get(0)?; + let seconds: u64 = r.get(1)?; + for (dim, class) in crate::classes::of_system(&system).into_iter().enumerate() { + let Some(class) = class else { continue }; + let c = cells[dim].entry(class).or_default(); + c.installs.insert(install.clone()); + c.sessions += 1; + c.seconds += seconds; + c.p50_sum += f64::from(frames.p50_ms); + c.p99_sum += f64::from(frames.p99_ms); + } + } + let mut out = serde_json::Map::new(); + for (dim, by_class) in crate::classes::DIMENSIONS.iter().zip(cells) { + let mut list: Vec<(&str, Cell)> = by_class + .into_iter() + .filter(|(_, c)| c.installs.len() >= crate::summary::MIN_INSTALLS) + .collect(); + list.sort_by(|a, b| { + b.1.installs + .len() + .cmp(&a.1.installs.len()) + .then(a.0.cmp(b.0)) + }); + if list.is_empty() { + continue; + } + let avg = |sum: f64, n: u64| (sum / n as f64 * 10.0).round() / 10.0; + out.insert( + dim.to_string(), + list.into_iter() + .map(|(class, c)| { + serde_json::json!({ + "class": class, "installs": c.installs.len(), "sessions": c.sessions, + "hours": (c.seconds as f64 / 360.0).round() / 10.0, + "p50_ms": avg(c.p50_sum, c.sessions), "p99_ms": avg(c.p99_sum, c.sessions), + }) + }) + .collect(), + ); + } + Ok(serde_json::Value::Object(out)) + } + /// Every benchmark upload received since `from_day`, with its install (to count installs, never shown) /// and release, for `summary`. pub fn benchmark_uploads( @@ -398,15 +478,74 @@ impl Store { } } +/// The hardware fields after the first nine, as `systems.extra` keeps them. +#[derive(Default, Serialize, Deserialize)] +#[serde(default)] +pub struct Extra { + pub cores: u16, + pub cpu_base_mhz: u32, + pub cpu_boost_mhz: u32, + pub gpu_vendor: String, + pub gpu_kind: String, + pub vram_mb: u32, + pub storage: String, + pub display: Option, + pub power: String, + pub form: String, +} + +impl Extra { + fn of(s: &System) -> Self { + Self { + cores: s.cores, + cpu_base_mhz: s.cpu_base_mhz, + cpu_boost_mhz: s.cpu_boost_mhz, + gpu_vendor: s.gpu_vendor.clone(), + gpu_kind: s.gpu_kind.clone(), + vram_mb: s.vram_mb, + storage: s.storage.clone(), + display: s.display.clone(), + power: s.power.clone(), + form: s.form.clone(), + } + } +} + +/// Databases from before `systems.extra`: the table rebuilt with it (ids kept), once. +fn migrate(db: &mut Connection) -> rusqlite::Result<()> { + let has_extra = db + .prepare("SELECT 1 FROM pragma_table_info('systems') WHERE name = 'extra'")? + .exists([])?; + if has_extra { + return Ok(()); + } + let tx = db.transaction()?; + tx.execute_batch( + "CREATE TABLE systems_new ( + id INTEGER PRIMARY KEY, + os TEXT NOT NULL, os_version TEXT NOT NULL, arch TEXT NOT NULL, cpu TEXT NOT NULL, + threads INTEGER NOT NULL, ram_gb INTEGER NOT NULL, + gpu TEXT NOT NULL, driver TEXT NOT NULL, backend TEXT NOT NULL, extra TEXT NOT NULL DEFAULT '{}', + UNIQUE (os, os_version, arch, cpu, threads, ram_gb, gpu, driver, backend, extra) + ); + INSERT INTO systems_new (id, os, os_version, arch, cpu, threads, ram_gb, gpu, driver, backend) + SELECT id, os, os_version, arch, cpu, threads, ram_gb, gpu, driver, backend FROM systems; + DROP TABLE systems; + ALTER TABLE systems_new RENAME TO systems;", + )?; + tx.commit() +} + fn system_id(tx: &rusqlite::Transaction, s: &System) -> rusqlite::Result { + let extra = serde_json::to_string(&Extra::of(s)).unwrap_or_else(|_| "{}".into()); tx.execute( - "INSERT OR IGNORE INTO systems (os, os_version, arch, cpu, threads, ram_gb, gpu, driver, backend) - VALUES (?1, ?2, ?3, ?4, ?5, ?6, ?7, ?8, ?9)", - params![s.os, s.os_version, s.arch, s.cpu, s.threads, s.ram_gb, s.gpu, s.driver, s.backend], + "INSERT OR IGNORE INTO systems (os, os_version, arch, cpu, threads, ram_gb, gpu, driver, backend, extra) + VALUES (?1, ?2, ?3, ?4, ?5, ?6, ?7, ?8, ?9, ?10)", + params![s.os, s.os_version, s.arch, s.cpu, s.threads, s.ram_gb, s.gpu, s.driver, s.backend, extra], )?; tx.query_row( "SELECT id FROM systems WHERE os = ?1 AND os_version = ?2 AND arch = ?3 AND cpu = ?4 - AND threads = ?5 AND ram_gb = ?6 AND gpu = ?7 AND driver = ?8 AND backend = ?9", + AND threads = ?5 AND ram_gb = ?6 AND gpu = ?7 AND driver = ?8 AND backend = ?9 AND extra = ?10", params![ s.os, s.os_version, @@ -416,7 +555,8 @@ fn system_id(tx: &rusqlite::Transaction, s: &System) -> rusqlite::Result { s.ram_gb, s.gpu, s.driver, - s.backend + s.backend, + extra ], |r| r.get(0), ) @@ -432,3 +572,65 @@ pub fn inflate(body: &[u8]) -> serde_json::Value { .and_then(|_| serde_json::from_slice(&json).ok()) .unwrap_or(serde_json::Value::Null) } + +#[cfg(test)] +mod tests { + use super::*; + + /// A database from before `systems.extra` opens, keeps its machines' ids and takes new ones. + #[test] + fn systems_from_before_extra_are_kept() { + let path = std::env::temp_dir().join(format!( + "horizon-telemetry-migrate-{}.sqlite", + std::process::id() + )); + let _ = std::fs::remove_file(&path); + { + let db = Connection::open(&path).unwrap(); + db.execute_batch( + "CREATE TABLE systems ( + id INTEGER PRIMARY KEY, + os TEXT NOT NULL, os_version TEXT NOT NULL, arch TEXT NOT NULL, cpu TEXT NOT NULL, + threads INTEGER NOT NULL, ram_gb INTEGER NOT NULL, + gpu TEXT NOT NULL, driver TEXT NOT NULL, backend TEXT NOT NULL, + UNIQUE (os, os_version, arch, cpu, threads, ram_gb, gpu, driver, backend) + ); + INSERT INTO systems VALUES (7, 'linux', 'Fedora 43', 'x86_64', 'Ryzen', 32, 32, 'RTX 4070', '570', 'Vulkan');", + ) + .unwrap(); + } + let path_str = path.to_str().unwrap(); + let mut store = Store::open(path_str).unwrap(); + let old: (String, String) = store + .db + .query_row("SELECT gpu, extra FROM systems WHERE id = 7", [], |r| { + Ok((r.get(0)?, r.get(1)?)) + }) + .unwrap(); + assert_eq!(old, ("RTX 4070".to_owned(), "{}".to_owned())); + let s = System { + os: "linux".into(), + gpu: "RTX 4070".into(), + vram_mb: 12288, + gpu_kind: "discrete".into(), + storage: "nvme".into(), + ..System::default() + }; + let tx = store.db.transaction().unwrap(); + let id = system_id(&tx, &s).unwrap(); + assert_eq!(system_id(&tx, &s).unwrap(), id, "the same machine once"); + let extra: String = tx + .query_row("SELECT extra FROM systems WHERE id = ?1", [id], |r| { + r.get(0) + }) + .unwrap(); + tx.commit().unwrap(); + let back: Extra = serde_json::from_str(&extra).unwrap(); + assert_eq!((back.vram_mb, back.storage.as_str()), (12288, "nvme")); + drop(store); + Store::open(path_str).unwrap(); // a second open doesn't rebuild again + for suffix in ["", "-wal", "-shm"] { + let _ = std::fs::remove_file(format!("{path_str}{suffix}")); + } + } +} diff --git a/crates/horizon-telemetry-server/src/summary.rs b/crates/horizon-telemetry-server/src/summary.rs index 6cec9200e..05f94f5a0 100644 --- a/crates/horizon-telemetry-server/src/summary.rs +++ b/crates/horizon-telemetry-server/src/summary.rs @@ -69,7 +69,9 @@ pub fn rejection(report: &Value) -> Option<&'static str> { if report.get("kind").and_then(Value::as_str) != Some("game") { return Some("not a game run"); } - game(&report["app"])?; + if game(&report["app"]).is_none() { + return Some("not Horizon or plain vanilla"); + } let c = &report["conditions"]; let scenario = c.get("scenario").and_then(Value::as_str).unwrap_or(""); if !(scenario == "standard" || scenario == "flight" || scenario.starts_with("perf_bench:")) { @@ -190,6 +192,8 @@ fn newest_first(a: &str, b: &str) -> std::cmp::Ordering { #[derive(Default)] struct Group { installs: HashMap, Vec<[Option; 7]>>, + /// Per dimension and class, the installs in it. + classes: [BTreeMap<&'static str, BTreeSet>>; 5], reports: usize, versions: BTreeSet, } @@ -219,6 +223,14 @@ pub fn groups(uploads: &[Upload], min_installs: usize) -> Vec { .entry(u.install.clone()) .or_default() .push(figures(r)); + for (dim, class) in crate::classes::of_report(r).into_iter().enumerate() { + if let Some(class) = class { + g.classes[dim] + .entry(class) + .or_default() + .insert(u.install.clone()); + } + } } let mut out: Vec<(usize, Value)> = by .into_iter() @@ -243,11 +255,13 @@ pub fn groups(uploads: &[Upload], min_installs: usize) -> Vec { versions.sort_by(|a, b| newest_first(a, b)); versions.truncate(3); let installs = g.installs.len(); + let breakdowns = breakdowns(&g.classes, min_installs); ( installs, json!({ "gpu": gpu, "cpu": cpu, "render_distance": rd, "game": game, "source": "players", "installs": installs, "reports": g.reports, "versions": versions, "medians": medians, + "breakdowns": breakdowns, }), ) }) @@ -257,6 +271,33 @@ pub fn groups(uploads: &[Upload], min_installs: usize) -> Vec { out.into_iter().map(|(_, v)| v).collect() } +/// Per dimension, the classes with at least `min_installs` installs, most first: +/// `{"ram": [{"class": "32 GB", "installs": 3}], …}`. A dimension with none is left out. +pub fn breakdowns( + classes: &[BTreeMap<&'static str, BTreeSet>>; 5], + min_installs: usize, +) -> Value { + let mut out = serde_json::Map::new(); + for (dim, by_class) in crate::classes::DIMENSIONS.iter().zip(classes) { + let mut cells: Vec<(&str, usize)> = by_class + .iter() + .map(|(c, set)| (*c, set.len())) + .filter(|(_, n)| *n >= min_installs) + .collect(); + cells.sort_by(|a, b| b.1.cmp(&a.1).then(a.0.cmp(b.0))); + if !cells.is_empty() { + out.insert( + dim.to_string(), + cells + .into_iter() + .map(|(class, installs)| json!({"class": class, "installs": installs})) + .collect(), + ); + } + } + Value::Object(out) +} + /// The whole answer; `generated` is an RFC 3339 UTC time. pub fn summary(uploads: &[Upload], min_installs: usize, generated: &str) -> Value { json!({ diff --git a/crates/horizon-telemetry-server/tests/server.rs b/crates/horizon-telemetry-server/tests/server.rs index 5d5b17b6a..575e4b1a1 100644 --- a/crates/horizon-telemetry-server/tests/server.rs +++ b/crates/horizon-telemetry-server/tests/server.rs @@ -157,6 +157,45 @@ async fn totals_show_only_groups_with_enough_installs() { ); } +/// Sessions split by hardware class; a class shows only with three installs, and never a raw value. +#[tokio::test] +async fn totals_break_down_by_hardware_class() { + let s = server(Config { + min_install_days: 1, + ..generous() + }); + for n in 0..4 { + let mut item = perf("NVIDIA GeForce RTX 4080", 12); + if let Payload::Perf(p) = &mut item.payload { + p.system.ram_gb = if n == 3 { 16 } else { 31 }; + p.system.vram_mb = 16376; + p.system.gpu_kind = "discrete".into(); + p.system.storage = if n == 3 { "hdd" } else { "nvme" }.into(); + } + assert_eq!( + s.post(&install(n), vec![item]).await, + StatusCode::NO_CONTENT + ); + } + let totals = s.aggregate().await; + let b = &totals["breakdowns"]; + assert_eq!( + b["ram"], + serde_json::json!([{"class": "32 GB", "installs": 3, "sessions": 3, "hours": 1.5, "p50_ms": b["ram"][0]["p50_ms"], "p99_ms": b["ram"][0]["p99_ms"]}]), + "16 GB has one install: {totals}" + ); + assert!(b["ram"][0]["p50_ms"].as_f64().unwrap() > 8.0); + assert_eq!(b["vram"][0]["class"], "16 GB"); + assert_eq!(b["vram"][0]["installs"], 4); + assert_eq!(b["storage"].as_array().unwrap().len(), 1); + assert_eq!(b["os"][0]["class"], "linux"); + assert_eq!(b["gpu_kind"][0]["class"], "discrete"); + let text = totals.to_string(); + for raw in ["16376", "570.86", "Fedora", "hdd", &install(0)] { + assert!(!text.contains(raw), "{raw} in {text}"); + } +} + #[tokio::test] async fn bad_batches_are_refused() { let s = server(generous()); diff --git a/crates/horizon-telemetry-server/tests/summary.rs b/crates/horizon-telemetry-server/tests/summary.rs index 5a59aa8a1..3232b4f87 100644 --- a/crates/horizon-telemetry-server/tests/summary.rs +++ b/crates/horizon-telemetry-server/tests/summary.rs @@ -148,6 +148,7 @@ async fn uploads_come_back_grouped_and_anonymous() { assert_eq!(origin.as_deref(), Some("https://playhorizon.dev")); let s: Value = serde_json::from_str(&body).unwrap(); assert_eq!(s["groups"], expected()["groups"]); + assert_eq!(s["groups"][0]["breakdowns"]["vram"][0]["installs"], 3); let generated = s["generated"].as_str().unwrap(); assert!( generated.len() == 20 && generated.ends_with('Z'), @@ -160,6 +161,9 @@ async fn uploads_come_back_grouped_and_anonymous() { "secret-driver", "20394", "ram_mb", + "vram_mb", + "16376", + "32768", ] { assert!(!body.contains(secret), "{secret} in {body}"); } diff --git a/crates/horizon-telemetry/src/lib.rs b/crates/horizon-telemetry/src/lib.rs index 018c13df8..86cb68673 100644 --- a/crates/horizon-telemetry/src/lib.rs +++ b/crates/horizon-telemetry/src/lib.rs @@ -30,8 +30,9 @@ pub use payload::{Item, Kind, Payload, Source}; pub const SCHEMA: u32 = 1; /// What players agree to. Bumped when what is collected changes: the launcher then asks again, -/// and until the player answers nothing new is kept or sent. -pub const CONSENT_VERSION: u32 = 1; +/// and until the player answers nothing new is kept or sent. 2: the machine's full hardware +/// (cores, clocks, VRAM, drive, screen, power, form), 2026-10-23. +pub const CONSENT_VERSION: u32 = 2; /// The ingest server (`crates/horizon-telemetry-server`, on Railway). `HORIZON_TELEMETRY_URL` /// overrides it (a local server); `HORIZON_TELEMETRY_URL=off` sends nothing at all, no ping diff --git a/crates/horizon-telemetry/src/payload.rs b/crates/horizon-telemetry/src/payload.rs index 2ed0ba88d..46f4a9af0 100644 --- a/crates/horizon-telemetry/src/payload.rs +++ b/crates/horizon-telemetry/src/payload.rs @@ -129,8 +129,9 @@ impl Item { } } -/// The machine, as coarse as is useful: no serial numbers, names or exact memory. -#[derive(Clone, Debug, Default, PartialEq, Eq, Serialize, Deserialize)] +/// The machine, as coarse as is useful: no serial numbers, names or exact memory. Every field +/// explains performance; `docs/telemetry.md` lists them. Empty or zero: not known. +#[derive(Clone, Debug, Default, PartialEq, Serialize, Deserialize)] #[serde(default)] pub struct System { /// `linux`, `macos` or `windows`. @@ -140,12 +141,42 @@ pub struct System { pub arch: String, pub cpu: String, pub threads: u16, + /// Physical cores. + pub cores: u16, + /// The CPU's base and top boost clock, where the OS says. + pub cpu_base_mhz: u32, + pub cpu_boost_mhz: u32, /// Installed memory, rounded to the GiB. pub ram_gb: u16, pub gpu: String, + /// `nvidia`, `amd`, `intel`, `apple`… + pub gpu_vendor: String, + /// `integrated`, `discrete`, `virtual` or `cpu`. + pub gpu_kind: String, + /// The GPU's own memory, rounded to 256 MiB (0 for a GPU that shares the system's). + pub vram_mb: u32, pub driver: String, /// `Metal`, `Vulkan`, `Dx12`… pub backend: String, + /// The drive under the game folder: `nvme`, `ssd` or `hdd`. + pub storage: String, + /// The screen the game's window is on. + #[serde(skip_serializing_if = "Option::is_none")] + pub display: Option, + /// `ac` or `battery`, when the game started. + pub power: String, + /// `laptop` or `desktop`. + pub form: String, +} + +/// A screen: its size in physical pixels, refresh rate and scale. +#[derive(Clone, Debug, Default, PartialEq, Serialize, Deserialize)] +#[serde(default)] +pub struct Display { + pub width: u32, + pub height: u32, + pub refresh_hz: u32, + pub scale: f32, } /// The settings that change performance. @@ -190,7 +221,7 @@ pub struct Perf { /// A crash, scrubbed: the error and its stack, the thread, and the details that say what the /// game was doing (graphics adapter, settings), never its log, world or server. -#[derive(Clone, Debug, Default, PartialEq, Eq, Serialize, Deserialize)] +#[derive(Clone, Debug, Default, PartialEq, Serialize, Deserialize)] #[serde(default)] pub struct Crash { pub system: System, @@ -202,7 +233,7 @@ pub struct Crash { } /// A bug report the player wrote, with the log only if they chose to add it after reading it. -#[derive(Clone, Debug, Default, PartialEq, Eq, Serialize, Deserialize)] +#[derive(Clone, Debug, Default, PartialEq, Serialize, Deserialize)] #[serde(default)] pub struct Bug { pub system: System, diff --git a/crates/horizon-telemetry/src/system.rs b/crates/horizon-telemetry/src/system.rs index 5993e5862..1796c302c 100644 --- a/crates/horizon-telemetry/src/system.rs +++ b/crates/horizon-telemetry/src/system.rs @@ -1,5 +1,12 @@ //! The machine as an item describes it ([`System`]): what the OS says, read the same way on -//! every start. The game adds the GPU, its driver and the graphics backend. +//! every start. The game adds the GPU (its name, maker, kind, driver and backend, then +//! [`vram_mb`] for it) and the screen. +//! +//! Only what explains performance: no serial number, host name, user name or path is read into +//! an item. The slower probes (a command to run) are read once per process. +use std::path::Path; +use std::sync::OnceLock; + use crate::payload::System; fn command_output(program: &str, args: &[&str]) -> Option { @@ -74,20 +81,422 @@ fn ram_bytes() -> Option { } } +/// Physical cores. +fn cores() -> Option { + if cfg!(target_os = "linux") { + cores_from_cpuinfo(&read("/proc/cpuinfo")?) + } else if cfg!(target_os = "macos") { + command_output("sysctl", &["-n", "hw.physicalcpu"])? + .parse() + .ok() + } else if cfg!(windows) { + powershell("(Get-CimInstance Win32_Processor | Measure-Object NumberOfCores -Sum).Sum")? + .parse() + .ok() + } else { + None + } +} + +/// Distinct (package, core) pairs; a listing without them (ARM boards) counts its processors. +fn cores_from_cpuinfo(text: &str) -> Option { + let mut pairs = std::collections::HashSet::new(); + let (mut package, mut processors) = (String::new(), 0u16); + for line in text.lines() { + let Some((key, value)) = line.split_once(':') else { + continue; + }; + match key.trim() { + "processor" => processors += 1, + "physical id" => package = value.trim().to_owned(), + "core id" => { + pairs.insert((package.clone(), value.trim().to_owned())); + } + _ => {} + } + } + let n = if pairs.is_empty() { + processors + } else { + pairs.len() as u16 + }; + (n > 0).then_some(n) +} + +/// The base and top boost clocks in MHz, where the OS gives them (not on Apple silicon). +fn cpu_mhz() -> (Option, Option) { + let khz = |path: &str| { + read(path) + .and_then(|t| t.trim().parse::().ok()) + .map(|k| k / 1000) + }; + if cfg!(target_os = "linux") { + let base = khz("/sys/devices/system/cpu/cpu0/cpufreq/base_frequency").or_else(|| { + read("/sys/devices/system/cpu/cpu0/acpi_cppc/nominal_freq") + .and_then(|t| t.trim().parse().ok()) + }); + ( + base, + khz("/sys/devices/system/cpu/cpu0/cpufreq/cpuinfo_max_freq"), + ) + } else if cfg!(target_os = "macos") { + let hz = |key: &str| { + command_output("sysctl", &["-n", key]) + .and_then(|t| t.parse::().ok()) + .map(|hz| (hz / 1_000_000) as u32) + }; + (hz("hw.cpufrequency"), hz("hw.cpufrequency_max")) + } else if cfg!(windows) { + let base = + powershell("(Get-CimInstance Win32_Processor | Select-Object -First 1).MaxClockSpeed") + .and_then(|t| t.parse().ok()); + (base, None) + } else { + (None, None) + } +} + +fn powershell(command: &str) -> Option { + command_output("powershell", &["-NoProfile", "-Command", command]) +} + +/// `nvme`, `ssd` or `hdd` for the drive `path` is on, where it can be read. +pub fn storage(path: &Path) -> Option<&'static str> { + if cfg!(target_os = "linux") { + let source = mount_source(&read("/proc/self/mountinfo")?, path)?; + let name = source.strip_prefix("/dev/")?; + // /dev/mapper/x and /dev/dm-0 (LUKS, LVM) sit on the disks in their slaves/. + let name = std::fs::canonicalize(format!("/dev/{name}")) + .ok() + .and_then(|p| p.file_name().map(|n| n.to_string_lossy().into_owned())) + .unwrap_or_else(|| name.to_owned()); + linux_disk_kind(&name, 0) + } else if cfg!(target_os = "macos") { + let df = command_output("df", &[&path.to_string_lossy()])?; + let device = df.lines().nth(1)?.split_whitespace().next()?.to_owned(); + let info = command_output("diskutil", &["info", &device])?; + disk_kind_from_diskutil(&info) + } else if cfg!(windows) { + let letter = path.to_string_lossy().chars().next()?.to_ascii_uppercase(); + if !letter.is_ascii_alphabetic() { + return None; + } + let out = powershell(&format!( + "$d = (Get-Partition -DriveLetter {letter}).DiskNumber; \ + $p = Get-PhysicalDisk | Where-Object DeviceId -eq $d; \"$($p.BusType) $($p.MediaType)\"" + ))?; + let out = out.to_ascii_lowercase(); + if out.contains("nvme") { + Some("nvme") + } else if out.contains("ssd") { + Some("ssd") + } else if out.contains("hdd") { + Some("hdd") + } else { + None + } + } else { + None + } +} + +/// The device mounted at the longest mount point above `path`, from `/proc/self/mountinfo`. +fn mount_source(mountinfo: &str, path: &Path) -> Option { + let path = std::fs::canonicalize(path).unwrap_or_else(|_| path.to_owned()); + mountinfo + .lines() + .filter_map(|line| { + let fields: Vec<&str> = line.split_whitespace().collect(); + let point = fields.get(4)?; + let dash = fields.iter().position(|f| *f == "-")?; + let source = fields.get(dash + 2)?; + path.starts_with(point) + .then(|| (point.len(), source.to_string())) + }) + .max_by_key(|(len, _)| *len) + .map(|(_, source)| source) +} + +fn linux_disk_kind(name: &str, depth: u8) -> Option<&'static str> { + if depth > 4 { + return None; + } + let class = Path::new("/sys/class/block").join(name); + // A mapper device: the first disk under it. + if let Ok(slaves) = std::fs::read_dir(class.join("slaves")) + && let Some(slave) = slaves.flatten().next() + { + return linux_disk_kind(&slave.file_name().to_string_lossy(), depth + 1); + } + // A partition: its disk is the parent directory. + let device = std::fs::canonicalize(&class).ok()?; + let disk = if device.join("partition").exists() { + device.parent()?.to_owned() + } else { + device + }; + let disk_name = disk.file_name()?.to_string_lossy(); + if disk_name.starts_with("nvme") { + return Some("nvme"); + } + match std::fs::read_to_string(disk.join("queue/rotational")) + .ok()? + .trim() + { + "0" => Some("ssd"), + "1" => Some("hdd"), + _ => None, + } +} + +fn disk_kind_from_diskutil(info: &str) -> Option<&'static str> { + let solid = field_spaced(info, "Solid State")?; + if solid != "Yes" { + return Some("hdd"); + } + let protocol = field_spaced(info, "Protocol").unwrap_or_default(); + Some( + if ["PCI-Express", "Apple Fabric", "NVMe"] + .iter() + .any(|p| protocol.contains(p)) + { + "nvme" + } else { + "ssd" + }, + ) +} + +/// ` Key: value` listings (diskutil, system_profiler). +fn field_spaced(text: &str, key: &str) -> Option { + text.lines().find_map(|l| { + let (k, v) = l.split_once(':')?; + (k.trim() == key).then(|| v.trim().to_owned()) + }) +} + +/// `ac` or `battery`; `None` where it can't be read. +pub fn power() -> Option<&'static str> { + if cfg!(target_os = "macos") { + let batt = command_output("pmset", &["-g", "batt"])?; + return Some(if batt.contains("'Battery Power'") { + "battery" + } else { + "ac" + }); + } + if cfg!(windows) { + // BatteryStatus 1: discharging. + let status = + powershell("(Get-CimInstance Win32_Battery | Select-Object -First 1).BatteryStatus")?; + return Some(if status.trim() == "1" { + "battery" + } else { + "ac" + }); + } + let mut on_battery = None; + for entry in std::fs::read_dir("/sys/class/power_supply").ok()?.flatten() { + let read = + |name: &str| std::fs::read_to_string(entry.path().join(name)).unwrap_or_default(); + match read("type").trim() { + "Mains" if read("online").trim() == "1" => return Some("ac"), + "Battery" => on_battery = Some("battery"), + _ => {} + } + } + on_battery +} + +/// `laptop` or `desktop`: the firmware's chassis type, else whether there is a battery. +fn form() -> Option<&'static str> { + if cfg!(target_os = "linux") { + if let Some(kind) = + read("/sys/class/dmi/id/chassis_type").and_then(|t| t.trim().parse::().ok()) + { + match kind { + 8 | 9 | 10 | 14 | 30 | 31 | 32 => return Some("laptop"), + 3..=7 | 13 | 15 | 16 | 35 | 36 => return Some("desktop"), + _ => {} + } + } + let battery = std::fs::read_dir("/sys/class/power_supply") + .ok()? + .flatten() + .any(|e| { + std::fs::read_to_string(e.path().join("type")).is_ok_and(|t| t.trim() == "Battery") + }); + Some(if battery { "laptop" } else { "desktop" }) + } else if cfg!(target_os = "macos") { + let batt = command_output("pmset", &["-g", "batt"])?; + Some(if batt.contains("InternalBattery") { + "laptop" + } else { + "desktop" + }) + } else if cfg!(windows) { + let n = powershell("@(Get-CimInstance Win32_Battery).Count")?; + Some(if n.trim() == "0" { "desktop" } else { "laptop" }) + } else { + None + } +} + +/// The dedicated memory of the GPU from `vendor` (`nvidia`, `amd`, `intel`, `apple`), in MiB +/// rounded to 256, where the driver says; read once. `None` for a GPU sharing the system's. +pub fn vram_mb(vendor: &str) -> Option { + static CACHE: OnceLock>>> = + OnceLock::new(); + let cache = CACHE.get_or_init(Default::default); + let mut cache = cache.lock().unwrap_or_else(|e| e.into_inner()); + *cache.entry(vendor.to_ascii_lowercase()).or_insert_with(|| { + read_vram_mb(&vendor.to_ascii_lowercase()).map(|mb| mb.div_ceil(256) * 256) + }) +} + +fn read_vram_mb(vendor: &str) -> Option { + if cfg!(target_os = "linux") { + if vendor.contains("nvidia") { + return command_output( + "nvidia-smi", + &["--query-gpu=memory.total", "--format=csv,noheader,nounits"], + )? + .lines() + .filter_map(|l| l.trim().parse::().ok()) + .max(); + } + // amdgpu (and Intel's discrete xe/i915 cards) in sysfs. + std::fs::read_dir("/sys/class/drm") + .ok()? + .flatten() + .filter_map(|e| { + let dev = e.path().join("device"); + let bytes = read(&dev.join("mem_info_vram_total").to_string_lossy()) + .or_else(|| read(&dev.join("lmem_total_bytes").to_string_lossy()))?; + bytes.trim().parse::().ok().map(|b| (b >> 20) as u32) + }) + .filter(|mb| *mb >= 512) + .max() + } else if cfg!(target_os = "macos") { + // Apple silicon shares the system's memory: no "VRAM" line. + let text = command_output("system_profiler", &["SPDisplaysDataType"])?; + text.lines() + .filter_map(|l| { + let (k, v) = l.split_once(':')?; + k.trim().starts_with("VRAM").then(|| size_mb(v))? + }) + .max() + } else if cfg!(windows) { + // AdapterRAM stops at 4 GB; the driver's registry value doesn't. + let out = powershell( + "Get-ItemProperty 'HKLM:\\SYSTEM\\ControlSet001\\Control\\Class\\{4d36e968-e325-11ce-bfc1-08002be10318}\\0*' \ + -ErrorAction SilentlyContinue | ForEach-Object { \"$($_.DriverDesc)|$($_.'HardwareInformation.qwMemorySize')\" }", + )?; + out.lines() + .filter_map(|l| { + let (name, bytes) = l.split_once('|')?; + let ok = vendor.is_empty() + || name.to_ascii_lowercase().contains(vendor) + || (vendor == "nvidia" && name.contains("GeForce")) + || (vendor == "amd" && name.contains("Radeon")); + ok.then(|| bytes.trim().parse::().ok().map(|b| (b >> 20) as u32))? + }) + .max() + } else { + None + } +} + +/// "8 GB", "1536 MB" -> MiB. +fn size_mb(text: &str) -> Option { + let mut parts = text.split_whitespace(); + let n: f64 = parts.next()?.parse().ok()?; + match parts.next()? { + "GB" => Some((n * 1024.0) as u32), + "MB" => Some(n as u32), + _ => None, + } +} + +/// What doesn't change while the game runs, read once. +struct Fixed { + cores: u16, + base: u32, + boost: u32, + form: &'static str, +} + +fn fixed() -> &'static Fixed { + static FIXED: OnceLock = OnceLock::new(); + FIXED.get_or_init(|| { + let (base, boost) = cpu_mhz(); + Fixed { + cores: cores().unwrap_or(0), + base: base.unwrap_or(0), + boost: boost.unwrap_or(0), + form: form().unwrap_or(""), + } + }) +} + impl System { - /// This machine, without the GPU. - pub fn detect() -> Self { + /// This machine, without the GPU and the screen. `home` is the game folder, for the kind of + /// drive it is on. + pub fn detect_in(home: Option<&Path>) -> Self { const GIB: f64 = (1u64 << 30) as f64; + static STORAGE: OnceLock<&'static str> = OnceLock::new(); + let fixed = fixed(); Self { os: std::env::consts::OS.to_owned(), os_version: os_version().unwrap_or_default(), arch: std::env::consts::ARCH.to_owned(), cpu: cpu().unwrap_or_default(), threads: std::thread::available_parallelism().map_or(0, |n| n.get() as u16), + cores: fixed.cores, + cpu_base_mhz: fixed.base, + cpu_boost_mhz: fixed.boost, ram_gb: ram_bytes().map_or(0, |b| (b as f64 / GIB).round() as u16), + storage: home + .map(|h| *STORAGE.get_or_init(|| storage(h).unwrap_or(""))) + .unwrap_or("") + .to_owned(), + power: power().unwrap_or("").to_owned(), + form: fixed.form.to_owned(), ..Self::default() } } + + /// [`System::detect_in`] without the drive. + pub fn detect() -> Self { + Self::detect_in(None) + } +} + +/// The GPU's maker from its name and the vendor ID wgpu reports (0: none, as on Metal). +pub fn gpu_vendor(name: &str, vendor_id: u32) -> &'static str { + match vendor_id { + 0x10de => return "nvidia", + 0x1002 | 0x1022 => return "amd", + 0x8086 => return "intel", + 0x106b => return "apple", + 0x5143 => return "qualcomm", + _ => {} + } + let name = name.to_ascii_lowercase(); + [ + ("apple", "apple"), + ("nvidia", "nvidia"), + ("geforce", "nvidia"), + ("radeon", "amd"), + ("amd", "amd"), + ("intel", "intel"), + ("adreno", "qualcomm"), + ("llvmpipe", "software"), + ("lavapipe", "software"), + ] + .into_iter() + .find(|(needle, _)| name.contains(needle)) + .map_or("", |(_, v)| v) } #[cfg(test)] @@ -114,11 +523,80 @@ mod tests { assert_eq!(field("NAME=x", "PRETTY_NAME"), None); } + #[test] + fn cores_are_counted_once_per_package() { + let two_cores_four_threads = "processor : 0\nphysical id : 0\ncore id : 0\n\nprocessor : 1\nphysical id : 0\ncore id : 1\n\nprocessor : 2\nphysical id : 0\ncore id : 0\n\nprocessor : 3\nphysical id : 0\ncore id : 1\n"; + assert_eq!(cores_from_cpuinfo(two_cores_four_threads), Some(2)); + assert_eq!( + cores_from_cpuinfo("processor : 0\nprocessor : 1\n"), + Some(2) + ); + assert_eq!(cores_from_cpuinfo(""), None); + } + + #[test] + fn the_game_folders_mount_is_found() { + let mountinfo = "22 1 259:2 / / rw - ext4 /dev/nvme0n1p2 rw\n30 22 8:1 / /mnt/games rw - ext4 /dev/sda1 rw\n"; + assert_eq!( + mount_source(mountinfo, Path::new("/home/x/.horizon")).as_deref(), + Some("/dev/nvme0n1p2") + ); + assert_eq!( + mount_source(mountinfo, Path::new("/mnt/games/horizon")).as_deref(), + Some("/dev/sda1") + ); + } + + #[test] + fn diskutil_and_sizes_are_read() { + let info = " Device Node: /dev/disk3s1\n Protocol: Apple Fabric\n Solid State: Yes\n"; + assert_eq!(disk_kind_from_diskutil(info), Some("nvme")); + assert_eq!( + disk_kind_from_diskutil(" Solid State: No\n"), + Some("hdd") + ); + assert_eq!( + disk_kind_from_diskutil(" Protocol: SATA\n Solid State: Yes\n"), + Some("ssd") + ); + assert_eq!(size_mb(" 8 GB"), Some(8192)); + assert_eq!(size_mb(" 1536 MB"), Some(1536)); + } + + #[test] + fn gpu_makers() { + assert_eq!(gpu_vendor("NVIDIA GeForce RTX 4080", 0x10de), "nvidia"); + assert_eq!(gpu_vendor("Apple M4 Pro", 0), "apple"); + assert_eq!(gpu_vendor("AMD Radeon RX 7800 XT", 0), "amd"); + assert_eq!( + gpu_vendor("Mesa Intel(R) HD Graphics 620 (KBL GT2)", 0x8086), + "intel" + ); + assert_eq!(gpu_vendor("llvmpipe (LLVM 19)", 0x10005), "software"); + } + + /// `cargo test -p horizon-telemetry -- --ignored --nocapture what_this_machine_sends` + #[test] + #[ignore] + fn what_this_machine_sends() { + let home = std::env::current_dir().unwrap(); + let mut system = System::detect_in(Some(&home)); + system.vram_mb = vram_mb("nvidia").or_else(|| vram_mb("amd")).unwrap_or(0); + println!("{}", serde_json::to_string_pretty(&system).unwrap()); + } + #[test] fn this_machine_is_described() { let system = System::detect(); assert_eq!(system.os, std::env::consts::OS); assert!(system.threads > 0); assert!(system.gpu.is_empty(), "the game fills the GPU in"); + assert!(system.cores == 0 || system.cores <= system.threads); + assert!(["", "ac", "battery"].contains(&system.power.as_str())); + assert!(["", "laptop", "desktop"].contains(&system.form.as_str())); + let dir = std::env::temp_dir(); + assert!( + ["", "nvme", "ssd", "hdd"].contains(&System::detect_in(Some(&dir)).storage.as_str()) + ); } } diff --git a/docs/benchmark-report.md b/docs/benchmark-report.md index ba7b04f61..95815da1d 100644 --- a/docs/benchmark-report.md +++ b/docs/benchmark-report.md @@ -20,7 +20,7 @@ kilobytes whatever the frame rate. Measured numbers are rounded to 3 decimals. "app": { "name": "horizon-client", "version": "0.21.0", "commit": "e96e1571" }, "hardware": { "os": "macos", "os_version": "27.0", "arch": "aarch64", - "cpu": "Apple M4 Pro", "cpu_threads": 14, "ram_mb": 65536, + "cpu": "Apple M4 Pro", "cpu_threads": 14, "cpu_cores": 14, "ram_mb": 65536, "storage": "nvme", "form": "desktop", "gpu": { "name": "Apple M4 Pro", "vendor": "apple", "driver": "", "backend": "metal", "kind": "integrated" }, "display": { "width": 2560, "height": 1440, "scale": 2.0, "refresh_hz": 60 } }, @@ -58,9 +58,12 @@ one (histogram edges included) makes it 2. optionally `commit` (Horizon builds) and `mods` (`[{ "name", "version" }]`, vanilla with mods). **`hardware`.** `os` (`macos`, `linux`, `windows`), `os_version`, `arch`, `cpu` (brand string), -`cpu_threads`, `ram_mb`; `gpu` (`name`, `vendor`, `driver`, `backend`: `metal`, `vulkan`, `dx12`, `gl`; -`kind`: `integrated`, `discrete`, `virtual`, `cpu`, `other`) and `display` (the screen the window was on: -`width`, `height` in physical pixels, `scale`, `refresh_hz`) when known. Any field can be missing. +`cpu_threads`, `cpu_cores` (physical), `cpu_base_mhz` and `cpu_boost_mhz` (where the OS gives them; not on +Apple silicon), `ram_mb`, `storage` (the drive under the game folder: `nvme`, `ssd`, `hdd`), `form` (`laptop`, +`desktop`); `gpu` (`name`, `vendor`, `driver`, `backend`: `metal`, `vulkan`, `dx12`, `gl`; +`kind`: `integrated`, `discrete`, `virtual`, `cpu`, `other`; `vram_mb`, a discrete GPU's own memory) and +`display` (the screen the window was on: `width`, `height` in physical pixels, `scale`, `refresh_hz`) when +known. Any field can be missing. On mains or battery is `conditions.power`. **`conditions`.** What has to match for two reports to be compared, all optional: `scenario`, `seed`, `render_distance`, `simulation_distance`, `window` (`[width, height]` actually rendered), `vsync`, diff --git a/docs/telemetry.md b/docs/telemetry.md index e2cb9b050..ec076eba7 100644 --- a/docs/telemetry.md +++ b/docs/telemetry.md @@ -9,7 +9,7 @@ The one exception is the anonymous ["I'm playing" ping](#the-im-playing-ping) be `telemetry/consent.json` in the game folder (`HORIZON_HOME`, else `horizon` in the platform data folder): ```json -{ "version": 1, "answered": 1792060800, "choices": { "performance": true, "crashes": true, "bugs": false, "benchmarks": false }, "install_id": "3f2c…" } +{ "version": 2, "answered": 1792060800, "choices": { "performance": true, "crashes": true, "bugs": false, "benchmarks": false }, "install_id": "3f2c…" } ``` - `version` is the consent version the player answered (`CONSENT_VERSION`). It goes up when what is collected changes. The launcher then asks again, and until the player answers nothing new is kept or sent. @@ -34,7 +34,24 @@ Every item has `day` (days since 1970, UTC: no finer time), `source` (`launcher` | `bug` | bug reports | `system`, the player's `text` (up to 4000 characters), and the `log` only if they add it after reading it | 80 KiB | 5 | | `benchmark` | benchmark uploads | the benchmark report as `docs/benchmark-report.md` defines it, as it is, with its own schema field | 128 KiB | 10 | -`system` is the OS and its version, the architecture, the CPU model and thread count, installed memory rounded to the GiB, and the GPU, driver and graphics backend. +`system` describes the machine, with what can explain its performance. A field the OS doesn't give is empty or 0: + +| Field | What | Example | +|---|---|---| +| `os`, `os_version`, `arch` | the OS, its version, the CPU architecture | `linux`, `Fedora Linux 43`, `x86_64` | +| `cpu`, `threads`, `cores` | the CPU model, its threads and physical cores | `13th Gen Intel(R) Core(TM) i7-13700KF`, 24, 16 | +| `cpu_base_mhz`, `cpu_boost_mhz` | base and boost clock, where the OS gives them (not on Apple silicon) | 3400, 5400 | +| `ram_gb` | installed memory, rounded to the GiB | 32 | +| `gpu`, `gpu_vendor`, `gpu_kind` | the GPU the game draws with, its maker, `integrated` or `discrete` | `NVIDIA GeForce RTX 4080`, `nvidia`, `discrete` | +| `vram_mb` | a discrete GPU's own memory, rounded up to 256 MiB | 16384 | +| `driver`, `backend` | the driver version and the graphics API (`Vulkan`, `Metal`, `Dx12`) | `580.95.05`, `Vulkan` | +| `storage` | the drive under the game folder: `nvme`, `ssd` or `hdd` | `nvme` | +| `display` | the screen the window opened on: `width`, `height` (physical pixels), `refresh_hz`, `scale` | 2560, 1440, 165, 1.0 | +| `power`, `form` | on mains or battery (`ac`, `battery`), `laptop` or `desktop` | `ac`, `desktop` | + +The launcher's own items (bug reports sent from it) have no GPU or screen: only the game knows them. The memory given to the game is not a setting in Horizon (no Java heap): `peak_ram_mb` is what it used. Benchmark reports carry the same facts in their `hardware` (`docs/benchmark-report.md`). + +No serial number, host name, user name, MAC address or path is read. Settings → Data collection → "View what would be sent" and `horizon-launcher data show` print every field as it would leave this machine. A summary (`frames`, `ticks`) is the count, the 50th, 95th and 99th percentile and the maximum in milliseconds (to the tenth), and 14 bucket counts: under 4 ms, 4–6, 6–8, 8–10, 10–12, 12–14, 14–16.7, 16.7–20, 20–25, 25–33.3, 33.3–50, 50–100, 100–250, and 250 ms and more. Raw frame times never leave: `Timings` records them in tenths of a millisecond (20 KB however long the session) and only its summary is kept. A perf item is under 1 KiB. @@ -75,8 +92,20 @@ The launcher reads it when it opens and every minute after, and shows "N playing - `POST /v1/batch` - `DELETE /v1/installs/`: 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. +- `GET /v1/aggregate`: the anonymous totals the website's results page reads. Its `breakdowns` split the play sessions of the period by hardware class (below), each class with its installs, sessions, hours and mean p50 and p99 frame times. +- `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, exact memory or screen. Uploads are never published one by one. Each group's `breakdowns` count its installs per hardware class. - `POST /v1/live` and `GET /v1/live`: the "I'm playing" ping and the live count. +Public output never holds a raw hardware value, only these classes (`src/classes.rs`, the same in `website/scripts/benchmarks.mjs`), and a class is published only with at least 3 different installs: + +| Breakdown | Classes | +|---|---| +| `ram` | 4 GB or less, 8 GB, 16 GB, 32 GB, 64 GB or more | +| `vram` | shared (integrated GPU), 2 GB or less, 4, 6, 8, 12, 16 GB, more than 16 GB | +| `storage` | nvme, ssd, hdd | +| `os` | linux, macos, windows | +| `gpu_kind` | integrated, discrete | + +The driver, OS version, clocks, screen and power are kept raw for the 180 days of retention, to explain a slow group, and never published. + `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. diff --git a/launcher/src/telemetry.rs b/launcher/src/telemetry.rs index 5cdd913f8..3d5fa6895 100644 --- a/launcher/src/telemetry.rs +++ b/launcher/src/telemetry.rs @@ -17,7 +17,7 @@ pub const SWITCHES: [(Kind, &str, &str); 4] = [ ( Kind::Perf, "Performance statistics", - "After each session: frame-time percentiles and a 14-bucket histogram, tick times, peak memory and startup times, with your OS, CPU, GPU, driver, memory size and the settings that change performance.", + "After each session: frame-time percentiles and a 14-bucket histogram, tick times, peak memory and startup times, with your machine (OS, CPU and its cores and clocks, memory size, GPU, its memory and driver, drive type, screen size and refresh rate, laptop or desktop, on battery or not) and the settings that change performance.", ), ( Kind::Crash, @@ -96,7 +96,7 @@ pub fn preview() -> (String, String) { ); return (what, upload::preview(&home)); } - let system = System::detect(); + let system = with_example_gpu(System::detect_in(Some(&home))); let examples = vec![ Item::new( Source::Game, @@ -137,11 +137,29 @@ pub fn preview() -> (String, String) { })) .unwrap_or_default(); ( - "Nothing is waiting. One example of each kind, from this machine (a benchmark upload is the report itself, see docs/benchmark-report.md):".into(), + "Nothing is waiting. One example of each kind, from this machine; the game fills in the GPU and screen it uses where these say example (a benchmark upload is the report itself, see docs/benchmark-report.md):".into(), json, ) } +/// What only the game knows (the GPU it draws with, the screen its window is on), as an +/// example: the launcher draws with neither. +pub fn with_example_gpu(mut system: System) -> System { + system.gpu = "example: the GPU the game draws with".into(); + system.gpu_vendor = "nvidia".into(); + system.gpu_kind = "discrete".into(); + system.vram_mb = 8192; + system.driver = "example: 570.86".into(); + system.backend = "Vulkan".into(); + system.display = Some(horizon_telemetry::payload::Display { + width: 1920, + height: 1080, + refresh_hz: 60, + scale: 1.0, + }); + system +} + /// "Delete my data": the server deletes everything sent under this install's ID, the waiting /// items go, and the install gets a new ID. If the server can't be reached the ID is kept, so /// the deletion can be asked again. @@ -203,7 +221,7 @@ pub fn bug_report(text: &str, with_log: bool) -> Result { Source::Launcher, backend::VERSION, Payload::Bug(Bug { - system: System::detect(), + system: System::detect_in(Some(&home())), text: scrubber().scrub(text.trim()), log: with_log.then(log_for_report).flatten(), }), @@ -342,6 +360,20 @@ mod tests { assert!(names(&["everything"]).is_err()); } + /// "View what would be sent" and `data show` list every hardware field. + #[test] + fn the_example_shows_every_hardware_field() { + let json = serde_json::to_string(&with_example_gpu(System::detect())).unwrap(); + let fields = "os os_version arch cpu threads cores cpu_base_mhz cpu_boost_mhz ram_gb gpu \ + gpu_vendor gpu_kind vram_mb driver backend storage width height refresh_hz scale power form"; + for field in fields.split_whitespace() { + assert!( + json.contains(&format!("\"{field}\":")), + "{field} missing from {json}" + ); + } + } + #[test] fn every_kind_has_a_switch() { assert!(Kind::ALL.iter().all(|&k| !label(k).is_empty())); diff --git a/website/scripts/benchmarks.mjs b/website/scripts/benchmarks.mjs index f8fb5b1fd..724834ea7 100644 --- a/website/scripts/benchmarks.mjs +++ b/website/scripts/benchmarks.mjs @@ -7,7 +7,9 @@ // players' `benchmark` items as the server stores them ({ install_id, day, version, data: } per line). // Players' results are grouped by GPU, CPU, render distance and game, and a group is published only with at least // MIN_INSTALLS installs, so nobody can be picked out. install_id is used to count installs and to weigh each install -// once, and never leaves this script; neither do the day, OS version, driver, RAM or screen. +// once, and never leaves this script; neither do the day, OS version, driver, the exact RAM and VRAM, or the screen. +// A group also says how its installs split by hardware class (RAM, VRAM, drive, OS, integrated or discrete GPU), +// each class only with at least MIN_INSTALLS installs. The classes are the server's (src/classes.rs). import { readFile, writeFile } from "node:fs/promises"; import { dirname, resolve } from "node:path"; import { fileURLToPath } from "node:url"; @@ -34,6 +36,43 @@ export function round(field, x) { const trim = (s) => (typeof s === "string" ? s.replace(/\(R\)|\(TM\)|\(tm\)/g, "").replace(/\s+/g, " ").trim() : ""); const gameOf = (app) => (app?.name === "horizon-client" ? "horizon" : app?.name === "minecraft" && !(app.mods || []).some((m) => m.name !== "fabric-loader") ? "vanilla" : null); +// --- Hardware classes: coarse, so that a class holds many machines --------------------------- + +export const DIMENSIONS = ["ram", "vram", "storage", "os", "gpu_kind"]; +export function ramClass(gb) { + if (!(gb > 0)) return null; + return gb <= 5 ? "4 GB or less" : gb <= 10 ? "8 GB" : gb <= 20 ? "16 GB" : gb <= 40 ? "32 GB" : "64 GB or more"; +} +export function gpuKindClass(s) { + return s === "integrated" || s === "IntegratedGpu" ? "integrated" : s === "discrete" || s === "DiscreteGpu" ? "discrete" : null; +} +// A GPU's own memory in MiB; an integrated GPU shares the system's. +export function vramClass(mb, kind) { + if (gpuKindClass(kind) === "integrated") return "shared"; + if (!(mb > 0)) return null; + for (const [max, name] of [[2560, "2 GB or less"], [4608, "4 GB"], [6656, "6 GB"], [8704, "8 GB"], [12800, "12 GB"], [16896, "16 GB"]]) if (mb <= max) return name; + return "more than 16 GB"; +} +const oneOf = (list) => (s) => (list.includes(s) ? s : null); +export const storageClass = oneOf(["nvme", "ssd", "hdd"]); +export const osClass = oneOf(["linux", "macos", "windows"]); +// A report's classes, in DIMENSIONS order. +export function classesOf(report) { + const hw = report?.hardware || {}; + const kind = hw.gpu?.kind; + return [ramClass(finite(hw.ram_mb) ? hw.ram_mb / 1024 : 0), vramClass(hw.gpu?.vram_mb, kind), storageClass(hw.storage), osClass(hw.os), gpuKindClass(kind)]; +} +// Per dimension, the classes with at least minInstalls installs, most first; dimensions without one are left out. +export function breakdowns(classes, minInstalls) { + const out = {}; + DIMENSIONS.forEach((dim, i) => { + const cells = [...classes[i]].map(([c, set]) => ({ class: c, installs: set.size })).filter((c) => c.installs >= minInstalls); + cells.sort((a, b) => b.installs - a.installs || (a.class < b.class ? -1 : a.class > b.class ? 1 : 0)); + if (cells.length) out[dim] = cells; + }); + return out; +} + // Why a report can't be compared with the others, or null when it can: the standard flight over the four scenes, // VSync off, no frame cap, drawn on a screen. export function rejection(report) { @@ -82,12 +121,17 @@ export function aggregatePlayers(items, { minInstalls = MIN_INSTALLS } = {}) { const report = item?.data; if (!item?.install_id || rejection(report)) continue; const key = JSON.stringify([trim(report.hardware.gpu.name), trim(report.hardware.cpu), report.conditions.render_distance, gameOf(report.app)]); - if (!groups.has(key)) groups.set(key, { installs: new Map(), reports: 0, versions: new Set() }); + if (!groups.has(key)) groups.set(key, { installs: new Map(), reports: 0, versions: new Set(), classes: DIMENSIONS.map(() => new Map()) }); const g = groups.get(key); g.reports++; if (item.version) g.versions.add(item.version); if (!g.installs.has(item.install_id)) g.installs.set(item.install_id, []); g.installs.get(item.install_id).push(figures(report)); + classesOf(report).forEach((c, i) => { + if (!c) return; + if (!g.classes[i].has(c)) g.classes[i].set(c, new Set()); + g.classes[i].get(c).add(item.install_id); + }); } const out = []; for (const [key, g] of groups) { @@ -95,7 +139,7 @@ export function aggregatePlayers(items, { minInstalls = MIN_INSTALLS } = {}) { const [gpu, cpu, render_distance, game] = JSON.parse(key); const perInstall = [...g.installs.values()].map((runs) => Object.fromEntries(FIELDS.map((f) => [f, median(runs.map((r) => r[f]))]))); const medians = Object.fromEntries(FIELDS.map((f) => [f, round(f, median(perInstall.map((r) => r[f])))])); - out.push({ gpu, cpu, render_distance, game, source: "players", installs: g.installs.size, reports: g.reports, versions: [...g.versions].sort(byVersionDesc).slice(0, 3), medians }); + out.push({ gpu, cpu, render_distance, game, source: "players", installs: g.installs.size, reports: g.reports, versions: [...g.versions].sort(byVersionDesc).slice(0, 3), medians, breakdowns: breakdowns(g.classes, minInstalls) }); } // Most installs first, then by GPU, CPU, render distance and game, compared as plain strings (as the server does). const cmp = (x, y) => (x < y ? -1 : x > y ? 1 : 0); diff --git a/website/scripts/benchmarks.test.mjs b/website/scripts/benchmarks.test.mjs index 7626de179..87aec484b 100644 --- a/website/scripts/benchmarks.test.mjs +++ b/website/scripts/benchmarks.test.mjs @@ -2,7 +2,7 @@ import { test } from "node:test"; import assert from "node:assert/strict"; import { readFileSync } from "node:fs"; -import { aggregatePlayers, median, ourRows, rejection, round, summary } from "./benchmarks.mjs"; +import { aggregatePlayers, median, osClass, ourRows, ramClass, rejection, round, storageClass, summary, vramClass, gpuKindClass } from "./benchmarks.mjs"; const fixture = (name) => new URL(`./fixtures/benchmarks/${name}`, import.meta.url); const items = readFileSync(fixture("items.jsonl"), "utf8").split("\n").filter(Boolean).map((l) => JSON.parse(l)); @@ -17,7 +17,7 @@ test("players' items give the expected groups", () => { test("nothing that identifies an install is published", () => { const text = JSON.stringify(aggregatePlayers(items, { minInstalls: 1 })); - for (const secret of ["a1", "a2", "install_id", "secret-os-version", "secret-driver", "20394", "ram_mb", "2560"]) assert.ok(!text.includes(secret), secret); + for (const secret of ["a1", "a2", "install_id", "secret-os-version", "secret-driver", "20394", "ram_mb", "2560", "16376", "32768", "vram_mb"]) assert.ok(!text.includes(secret), secret); }); test("a group needs three installs, not three runs", () => { @@ -26,6 +26,30 @@ test("a group needs three installs, not three runs", () => { assert.equal(aggregatePlayers(items, { minInstalls: 2 }).length, 2); }); +test("hardware classes are coarse, as the server's", () => { + assert.equal(ramClass(15.6), "16 GB"); + assert.equal(ramClass(31), "32 GB"); + assert.equal(ramClass(64), "64 GB or more"); + assert.equal(ramClass(0), null); + assert.equal(vramClass(16376, "discrete"), "16 GB"); + assert.equal(vramClass(8192, "DiscreteGpu"), "8 GB"); + assert.equal(vramClass(0, "integrated"), "shared"); + assert.equal(vramClass(0, ""), null); + assert.equal(storageClass("nvme"), "nvme"); + assert.equal(storageClass("tape"), null); + assert.equal(osClass("windows"), "windows"); + assert.equal(gpuKindClass("virtual"), null); +}); + +test("a breakdown cell needs three installs too", () => { + const [group] = aggregatePlayers(items); + assert.equal(group.breakdowns.ram, undefined); // 32 GB has two installs, 16 GB one + assert.equal(group.breakdowns.storage, undefined); + const [all] = aggregatePlayers(items, { minInstalls: 1 }); + assert.deepEqual(all.breakdowns.ram, [{ class: "32 GB", installs: 2 }, { class: "16 GB", installs: 1 }]); + assert.deepEqual(all.breakdowns.storage, [{ class: "nvme", installs: 2 }, { class: "ssd", installs: 1 }]); +}); + test("only comparable runs count", () => { const reasons = items.map((i) => rejection(i.data)); assert.deepEqual(reasons.filter(Boolean), ["VSync on or unknown", "offscreen", "frame rate capped", "not every scene", "not the standard flight", "not a version 1 benchmark report"]); diff --git a/website/scripts/fixtures/benchmarks/README.md b/website/scripts/fixtures/benchmarks/README.md index 716942893..562646a6f 100644 --- a/website/scripts/fixtures/benchmarks/README.md +++ b/website/scripts/fixtures/benchmarks/README.md @@ -7,4 +7,7 @@ Shared by the website's aggregator test (`website/scripts/benchmarks.test.mjs`) RTX 4080 + i7-13700KF at render distance 12 has three installs (one with two runs); the same install at 32, and the RTX 3060 group, have fewer than three and are left out. The other runs are rejected: VSync on, offscreen, a frame cap, a missing scene, a one-scene scenario, a report of another version, no install ID. +- Breakdowns: the RTX 4080 group's three installs share a VRAM class (16 GB), the OS and a discrete GPU, so + those cells are published; a3 has 16 GB of RAM and an SSD where a1 and a2 have 32 GB and NVMe, so neither the + RAM nor the drive cells reach three installs and those dimensions are left out. - `expected.json`: `min_installs` and `groups` of the summary (`generated` varies). diff --git a/website/scripts/fixtures/benchmarks/expected.json b/website/scripts/fixtures/benchmarks/expected.json index 43470bd02..5718fb4d4 100644 --- a/website/scripts/fixtures/benchmarks/expected.json +++ b/website/scripts/fixtures/benchmarks/expected.json @@ -10,7 +10,12 @@ "installs": 3, "reports": 4, "versions": ["v0.2.1", "v0.2.0"], - "medians": { "avg_fps": 515, "low_1pct_fps": 120, "p95_ms": 3.5, "world_ms": 4500, "chunk_load_ms": 1400, "rss_peak_mb": 1450, "rss_steady_mb": 1250 } + "medians": { "avg_fps": 515, "low_1pct_fps": 120, "p95_ms": 3.5, "world_ms": 4500, "chunk_load_ms": 1400, "rss_peak_mb": 1450, "rss_steady_mb": 1250 }, + "breakdowns": { + "vram": [{ "class": "16 GB", "installs": 3 }], + "os": [{ "class": "linux", "installs": 3 }], + "gpu_kind": [{ "class": "discrete", "installs": 3 }] + } } ] } diff --git a/website/scripts/fixtures/benchmarks/items.jsonl b/website/scripts/fixtures/benchmarks/items.jsonl index 4796fb2d2..fe541cb4d 100644 --- a/website/scripts/fixtures/benchmarks/items.jsonl +++ b/website/scripts/fixtures/benchmarks/items.jsonl @@ -1,14 +1,14 @@ -{"install_id":"a1","day":20394,"version":"v0.2.0","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"13th Gen Intel(R) Core(TM) i7-13700KF","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 4080","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete"},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165}},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":5000,"stdev":null,"min":5000,"max":5000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1400},"memory.rss_steady_mb":{"n":1,"mean":1200},"chunks.village.load_ms":{"n":1,"mean":1500},"chunks.forest.load_ms":{"n":1,"mean":1500},"chunks.ocean.load_ms":{"n":1,"mean":1500},"chunks.mountain.load_ms":{"n":1,"mean":1500}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":400,"low_1pct_fps":100,"low_01pct_fps":50,"p50_ms":2,"p95_ms":4,"p99_ms":8,"p999_ms":12,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":410,"low_1pct_fps":100,"low_01pct_fps":50,"p50_ms":2,"p95_ms":4,"p99_ms":8,"p999_ms":12,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":420,"low_1pct_fps":100,"low_01pct_fps":50,"p50_ms":2,"p95_ms":4,"p99_ms":8,"p999_ms":12,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":430,"low_1pct_fps":100,"low_01pct_fps":50,"p50_ms":2,"p95_ms":4,"p99_ms":8,"p999_ms":12,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} -{"install_id":"a1","day":20395,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"13th Gen Intel(R) Core(TM) i7-13700KF","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 4080","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete"},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165}},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":4000,"stdev":null,"min":4000,"max":4000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1500},"memory.rss_steady_mb":{"n":1,"mean":1300},"chunks.village.load_ms":{"n":1,"mean":1300},"chunks.forest.load_ms":{"n":1,"mean":1300},"chunks.ocean.load_ms":{"n":1,"mean":1300},"chunks.mountain.load_ms":{"n":1,"mean":1300}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":600,"low_1pct_fps":140,"low_01pct_fps":70,"p50_ms":2,"p95_ms":3,"p99_ms":6,"p999_ms":9,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":610,"low_1pct_fps":140,"low_01pct_fps":70,"p50_ms":2,"p95_ms":3,"p99_ms":6,"p999_ms":9,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":620,"low_1pct_fps":140,"low_01pct_fps":70,"p50_ms":2,"p95_ms":3,"p99_ms":6,"p999_ms":9,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":630,"low_1pct_fps":140,"low_01pct_fps":70,"p50_ms":2,"p95_ms":3,"p99_ms":6,"p999_ms":9,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} -{"install_id":"a2","day":20395,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"13th Gen Intel(R) Core(TM) i7-13700KF","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 4080","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete"},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165}},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":6000,"stdev":null,"min":6000,"max":6000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1300},"memory.rss_steady_mb":{"n":1,"mean":1100},"chunks.village.load_ms":{"n":1,"mean":1700},"chunks.forest.load_ms":{"n":1,"mean":1700},"chunks.ocean.load_ms":{"n":1,"mean":1700},"chunks.mountain.load_ms":{"n":1,"mean":1700}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":300,"low_1pct_fps":80,"low_01pct_fps":40,"p50_ms":2,"p95_ms":5,"p99_ms":10,"p999_ms":15,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":310,"low_1pct_fps":80,"low_01pct_fps":40,"p50_ms":2,"p95_ms":5,"p99_ms":10,"p999_ms":15,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":320,"low_1pct_fps":80,"low_01pct_fps":40,"p50_ms":2,"p95_ms":5,"p99_ms":10,"p999_ms":15,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":330,"low_1pct_fps":80,"low_01pct_fps":40,"p50_ms":2,"p95_ms":5,"p99_ms":10,"p999_ms":15,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} -{"install_id":"a3","day":20396,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"13th Gen Intel(R) Core(TM) i7-13700KF","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 4080","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete"},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165}},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":3000,"stdev":null,"min":3000,"max":3000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1600},"memory.rss_steady_mb":{"n":1,"mean":1400},"chunks.village.load_ms":{"n":1,"mean":1100},"chunks.forest.load_ms":{"n":1,"mean":1100},"chunks.ocean.load_ms":{"n":1,"mean":1100},"chunks.mountain.load_ms":{"n":1,"mean":1100}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":700,"low_1pct_fps":160,"low_01pct_fps":80,"p50_ms":2,"p95_ms":2.5,"p99_ms":5,"p999_ms":7.5,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":710,"low_1pct_fps":160,"low_01pct_fps":80,"p50_ms":2,"p95_ms":2.5,"p99_ms":5,"p999_ms":7.5,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":720,"low_1pct_fps":160,"low_01pct_fps":80,"p50_ms":2,"p95_ms":2.5,"p99_ms":5,"p999_ms":7.5,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":730,"low_1pct_fps":160,"low_01pct_fps":80,"p50_ms":2,"p95_ms":2.5,"p99_ms":5,"p999_ms":7.5,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} -{"install_id":"a4","day":20396,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"13th Gen Intel(R) Core(TM) i7-13700KF","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 4080","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete"},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165}},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":true,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":2000,"stdev":null,"min":2000,"max":2000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1700},"memory.rss_steady_mb":{"n":1,"mean":1500},"chunks.village.load_ms":{"n":1,"mean":900},"chunks.forest.load_ms":{"n":1,"mean":900},"chunks.ocean.load_ms":{"n":1,"mean":900},"chunks.mountain.load_ms":{"n":1,"mean":900}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":900,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":910,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":920,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":930,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} -{"install_id":"a5","day":20396,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"13th Gen Intel(R) Core(TM) i7-13700KF","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 4080","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete"},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165}},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"offscreen":true,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":2000,"stdev":null,"min":2000,"max":2000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1700},"memory.rss_steady_mb":{"n":1,"mean":1500},"chunks.village.load_ms":{"n":1,"mean":900},"chunks.forest.load_ms":{"n":1,"mean":900},"chunks.ocean.load_ms":{"n":1,"mean":900},"chunks.mountain.load_ms":{"n":1,"mean":900}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":900,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":910,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":920,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":930,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} -{"install_id":"a6","day":20396,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"13th Gen Intel(R) Core(TM) i7-13700KF","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 4080","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete"},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165}},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"fps_cap":60,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":2000,"stdev":null,"min":2000,"max":2000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1700},"memory.rss_steady_mb":{"n":1,"mean":1500},"chunks.village.load_ms":{"n":1,"mean":900},"chunks.forest.load_ms":{"n":1,"mean":900},"chunks.ocean.load_ms":{"n":1,"mean":900},"chunks.mountain.load_ms":{"n":1,"mean":900}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":900,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":910,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":920,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":930,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} -{"install_id":"a7","day":20396,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"13th Gen Intel(R) Core(TM) i7-13700KF","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 4080","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete"},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165}},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":2000,"stdev":null,"min":2000,"max":2000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1700},"memory.rss_steady_mb":{"n":1,"mean":1500},"chunks.village.load_ms":{"n":1,"mean":900},"chunks.forest.load_ms":{"n":1,"mean":900},"chunks.mountain.load_ms":{"n":1,"mean":900}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":900,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":910,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":920,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} -{"install_id":"a8","day":20396,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"13th Gen Intel(R) Core(TM) i7-13700KF","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 4080","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete"},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165}},"conditions":{"scenario":"village","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":2000,"stdev":null,"min":2000,"max":2000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1700},"memory.rss_steady_mb":{"n":1,"mean":1500},"chunks.village.load_ms":{"n":1,"mean":900},"chunks.forest.load_ms":{"n":1,"mean":900},"chunks.ocean.load_ms":{"n":1,"mean":900},"chunks.mountain.load_ms":{"n":1,"mean":900}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":900,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":910,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":920,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":930,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} -{"install_id":"a1","day":20396,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"13th Gen Intel(R) Core(TM) i7-13700KF","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 4080","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete"},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165}},"conditions":{"scenario":"standard","seed":"1234","render_distance":32,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":9000,"stdev":null,"min":9000,"max":9000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":2600},"memory.rss_steady_mb":{"n":1,"mean":2300},"chunks.village.load_ms":{"n":1,"mean":6000},"chunks.forest.load_ms":{"n":1,"mean":6000},"chunks.ocean.load_ms":{"n":1,"mean":6000},"chunks.mountain.load_ms":{"n":1,"mean":6000}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":120,"low_1pct_fps":30,"low_01pct_fps":15,"p50_ms":2,"p95_ms":12,"p99_ms":24,"p999_ms":36,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":130,"low_1pct_fps":30,"low_01pct_fps":15,"p50_ms":2,"p95_ms":12,"p99_ms":24,"p999_ms":36,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":140,"low_1pct_fps":30,"low_01pct_fps":15,"p50_ms":2,"p95_ms":12,"p99_ms":24,"p999_ms":36,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":150,"low_1pct_fps":30,"low_01pct_fps":15,"p50_ms":2,"p95_ms":12,"p99_ms":24,"p999_ms":36,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} -{"install_id":"b1","day":20396,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"AMD Ryzen 5 5600X 6-Core Processor","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 3060","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete"},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165}},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":7000,"stdev":null,"min":7000,"max":7000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1300},"memory.rss_steady_mb":{"n":1,"mean":1100},"chunks.village.load_ms":{"n":1,"mean":2500},"chunks.forest.load_ms":{"n":1,"mean":2500},"chunks.ocean.load_ms":{"n":1,"mean":2500},"chunks.mountain.load_ms":{"n":1,"mean":2500}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":250,"low_1pct_fps":60,"low_01pct_fps":30,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":260,"low_1pct_fps":60,"low_01pct_fps":30,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":270,"low_1pct_fps":60,"low_01pct_fps":30,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":280,"low_1pct_fps":60,"low_01pct_fps":30,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} -{"install_id":"b2","day":20396,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"AMD Ryzen 5 5600X 6-Core Processor","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 3060","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete"},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165}},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":7100,"stdev":null,"min":7100,"max":7100,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1300},"memory.rss_steady_mb":{"n":1,"mean":1100},"chunks.village.load_ms":{"n":1,"mean":2400},"chunks.forest.load_ms":{"n":1,"mean":2400},"chunks.ocean.load_ms":{"n":1,"mean":2400},"chunks.mountain.load_ms":{"n":1,"mean":2400}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":260,"low_1pct_fps":70,"low_01pct_fps":35,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":270,"low_1pct_fps":70,"low_01pct_fps":35,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":280,"low_1pct_fps":70,"low_01pct_fps":35,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":290,"low_1pct_fps":70,"low_01pct_fps":35,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} -{"install_id":"b3","day":20396,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":2,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"AMD Ryzen 5 5600X 6-Core Processor","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 3060","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete"},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165}},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":7100,"stdev":null,"min":7100,"max":7100,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1300},"memory.rss_steady_mb":{"n":1,"mean":1100},"chunks.village.load_ms":{"n":1,"mean":2400},"chunks.forest.load_ms":{"n":1,"mean":2400},"chunks.ocean.load_ms":{"n":1,"mean":2400},"chunks.mountain.load_ms":{"n":1,"mean":2400}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":260,"low_1pct_fps":70,"low_01pct_fps":35,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":270,"low_1pct_fps":70,"low_01pct_fps":35,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":280,"low_1pct_fps":70,"low_01pct_fps":35,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":290,"low_1pct_fps":70,"low_01pct_fps":35,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} -{"day":20396,"version":"v0.2.1","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"AMD Ryzen 5 5600X 6-Core Processor","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 3060","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete"},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165}},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":1,"stdev":null,"min":1,"max":1,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1},"memory.rss_steady_mb":{"n":1,"mean":1},"chunks.village.load_ms":{"n":1,"mean":1},"chunks.forest.load_ms":{"n":1,"mean":1},"chunks.ocean.load_ms":{"n":1,"mean":1},"chunks.mountain.load_ms":{"n":1,"mean":1}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":1,"low_1pct_fps":1,"low_01pct_fps":0.5,"p50_ms":2,"p95_ms":1,"p99_ms":2,"p999_ms":3,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":11,"low_1pct_fps":1,"low_01pct_fps":0.5,"p50_ms":2,"p95_ms":1,"p99_ms":2,"p999_ms":3,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":21,"low_1pct_fps":1,"low_01pct_fps":0.5,"p50_ms":2,"p95_ms":1,"p99_ms":2,"p999_ms":3,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":31,"low_1pct_fps":1,"low_01pct_fps":0.5,"p50_ms":2,"p95_ms":1,"p99_ms":2,"p999_ms":3,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} +{"install_id":"a1","day":20394,"version":"v0.2.0","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"13th Gen Intel(R) Core(TM) i7-13700KF","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 4080","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete","vram_mb":16376},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165},"storage":"nvme"},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":5000,"stdev":null,"min":5000,"max":5000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1400},"memory.rss_steady_mb":{"n":1,"mean":1200},"chunks.village.load_ms":{"n":1,"mean":1500},"chunks.forest.load_ms":{"n":1,"mean":1500},"chunks.ocean.load_ms":{"n":1,"mean":1500},"chunks.mountain.load_ms":{"n":1,"mean":1500}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":400,"low_1pct_fps":100,"low_01pct_fps":50,"p50_ms":2,"p95_ms":4,"p99_ms":8,"p999_ms":12,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":410,"low_1pct_fps":100,"low_01pct_fps":50,"p50_ms":2,"p95_ms":4,"p99_ms":8,"p999_ms":12,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":420,"low_1pct_fps":100,"low_01pct_fps":50,"p50_ms":2,"p95_ms":4,"p99_ms":8,"p999_ms":12,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":430,"low_1pct_fps":100,"low_01pct_fps":50,"p50_ms":2,"p95_ms":4,"p99_ms":8,"p999_ms":12,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} +{"install_id":"a1","day":20395,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"13th Gen Intel(R) Core(TM) i7-13700KF","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 4080","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete","vram_mb":16376},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165},"storage":"nvme"},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":4000,"stdev":null,"min":4000,"max":4000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1500},"memory.rss_steady_mb":{"n":1,"mean":1300},"chunks.village.load_ms":{"n":1,"mean":1300},"chunks.forest.load_ms":{"n":1,"mean":1300},"chunks.ocean.load_ms":{"n":1,"mean":1300},"chunks.mountain.load_ms":{"n":1,"mean":1300}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":600,"low_1pct_fps":140,"low_01pct_fps":70,"p50_ms":2,"p95_ms":3,"p99_ms":6,"p999_ms":9,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":610,"low_1pct_fps":140,"low_01pct_fps":70,"p50_ms":2,"p95_ms":3,"p99_ms":6,"p999_ms":9,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":620,"low_1pct_fps":140,"low_01pct_fps":70,"p50_ms":2,"p95_ms":3,"p99_ms":6,"p999_ms":9,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":630,"low_1pct_fps":140,"low_01pct_fps":70,"p50_ms":2,"p95_ms":3,"p99_ms":6,"p999_ms":9,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} +{"install_id":"a2","day":20395,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"13th Gen Intel(R) Core(TM) i7-13700KF","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 4080","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete","vram_mb":16376},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165},"storage":"nvme"},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":6000,"stdev":null,"min":6000,"max":6000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1300},"memory.rss_steady_mb":{"n":1,"mean":1100},"chunks.village.load_ms":{"n":1,"mean":1700},"chunks.forest.load_ms":{"n":1,"mean":1700},"chunks.ocean.load_ms":{"n":1,"mean":1700},"chunks.mountain.load_ms":{"n":1,"mean":1700}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":300,"low_1pct_fps":80,"low_01pct_fps":40,"p50_ms":2,"p95_ms":5,"p99_ms":10,"p999_ms":15,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":310,"low_1pct_fps":80,"low_01pct_fps":40,"p50_ms":2,"p95_ms":5,"p99_ms":10,"p999_ms":15,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":320,"low_1pct_fps":80,"low_01pct_fps":40,"p50_ms":2,"p95_ms":5,"p99_ms":10,"p999_ms":15,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":330,"low_1pct_fps":80,"low_01pct_fps":40,"p50_ms":2,"p95_ms":5,"p99_ms":10,"p999_ms":15,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} +{"install_id":"a3","day":20396,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"13th Gen Intel(R) Core(TM) i7-13700KF","cpu_threads":24,"ram_mb":16384,"gpu":{"name":"NVIDIA GeForce RTX 4080","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete","vram_mb":16376},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165},"storage":"ssd"},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":3000,"stdev":null,"min":3000,"max":3000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1600},"memory.rss_steady_mb":{"n":1,"mean":1400},"chunks.village.load_ms":{"n":1,"mean":1100},"chunks.forest.load_ms":{"n":1,"mean":1100},"chunks.ocean.load_ms":{"n":1,"mean":1100},"chunks.mountain.load_ms":{"n":1,"mean":1100}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":700,"low_1pct_fps":160,"low_01pct_fps":80,"p50_ms":2,"p95_ms":2.5,"p99_ms":5,"p999_ms":7.5,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":710,"low_1pct_fps":160,"low_01pct_fps":80,"p50_ms":2,"p95_ms":2.5,"p99_ms":5,"p999_ms":7.5,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":720,"low_1pct_fps":160,"low_01pct_fps":80,"p50_ms":2,"p95_ms":2.5,"p99_ms":5,"p999_ms":7.5,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":730,"low_1pct_fps":160,"low_01pct_fps":80,"p50_ms":2,"p95_ms":2.5,"p99_ms":5,"p999_ms":7.5,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} +{"install_id":"a4","day":20396,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"13th Gen Intel(R) Core(TM) i7-13700KF","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 4080","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete","vram_mb":16376},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165},"storage":"nvme"},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":true,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":2000,"stdev":null,"min":2000,"max":2000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1700},"memory.rss_steady_mb":{"n":1,"mean":1500},"chunks.village.load_ms":{"n":1,"mean":900},"chunks.forest.load_ms":{"n":1,"mean":900},"chunks.ocean.load_ms":{"n":1,"mean":900},"chunks.mountain.load_ms":{"n":1,"mean":900}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":900,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":910,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":920,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":930,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} +{"install_id":"a5","day":20396,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"13th Gen Intel(R) Core(TM) i7-13700KF","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 4080","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete","vram_mb":16376},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165},"storage":"nvme"},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"offscreen":true,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":2000,"stdev":null,"min":2000,"max":2000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1700},"memory.rss_steady_mb":{"n":1,"mean":1500},"chunks.village.load_ms":{"n":1,"mean":900},"chunks.forest.load_ms":{"n":1,"mean":900},"chunks.ocean.load_ms":{"n":1,"mean":900},"chunks.mountain.load_ms":{"n":1,"mean":900}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":900,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":910,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":920,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":930,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} +{"install_id":"a6","day":20396,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"13th Gen Intel(R) Core(TM) i7-13700KF","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 4080","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete","vram_mb":16376},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165},"storage":"nvme"},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"fps_cap":60,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":2000,"stdev":null,"min":2000,"max":2000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1700},"memory.rss_steady_mb":{"n":1,"mean":1500},"chunks.village.load_ms":{"n":1,"mean":900},"chunks.forest.load_ms":{"n":1,"mean":900},"chunks.ocean.load_ms":{"n":1,"mean":900},"chunks.mountain.load_ms":{"n":1,"mean":900}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":900,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":910,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":920,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":930,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} +{"install_id":"a7","day":20396,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"13th Gen Intel(R) Core(TM) i7-13700KF","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 4080","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete","vram_mb":16376},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165},"storage":"nvme"},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":2000,"stdev":null,"min":2000,"max":2000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1700},"memory.rss_steady_mb":{"n":1,"mean":1500},"chunks.village.load_ms":{"n":1,"mean":900},"chunks.forest.load_ms":{"n":1,"mean":900},"chunks.mountain.load_ms":{"n":1,"mean":900}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":900,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":910,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":920,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} +{"install_id":"a8","day":20396,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"13th Gen Intel(R) Core(TM) i7-13700KF","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 4080","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete","vram_mb":16376},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165},"storage":"nvme"},"conditions":{"scenario":"village","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":2000,"stdev":null,"min":2000,"max":2000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1700},"memory.rss_steady_mb":{"n":1,"mean":1500},"chunks.village.load_ms":{"n":1,"mean":900},"chunks.forest.load_ms":{"n":1,"mean":900},"chunks.ocean.load_ms":{"n":1,"mean":900},"chunks.mountain.load_ms":{"n":1,"mean":900}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":900,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":910,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":920,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":930,"low_1pct_fps":200,"low_01pct_fps":100,"p50_ms":2,"p95_ms":2,"p99_ms":4,"p999_ms":6,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} +{"install_id":"a1","day":20396,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"13th Gen Intel(R) Core(TM) i7-13700KF","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 4080","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete","vram_mb":16376},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165},"storage":"nvme"},"conditions":{"scenario":"standard","seed":"1234","render_distance":32,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":9000,"stdev":null,"min":9000,"max":9000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":2600},"memory.rss_steady_mb":{"n":1,"mean":2300},"chunks.village.load_ms":{"n":1,"mean":6000},"chunks.forest.load_ms":{"n":1,"mean":6000},"chunks.ocean.load_ms":{"n":1,"mean":6000},"chunks.mountain.load_ms":{"n":1,"mean":6000}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":120,"low_1pct_fps":30,"low_01pct_fps":15,"p50_ms":2,"p95_ms":12,"p99_ms":24,"p999_ms":36,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":130,"low_1pct_fps":30,"low_01pct_fps":15,"p50_ms":2,"p95_ms":12,"p99_ms":24,"p999_ms":36,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":140,"low_1pct_fps":30,"low_01pct_fps":15,"p50_ms":2,"p95_ms":12,"p99_ms":24,"p999_ms":36,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":150,"low_1pct_fps":30,"low_01pct_fps":15,"p50_ms":2,"p95_ms":12,"p99_ms":24,"p999_ms":36,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} +{"install_id":"b1","day":20396,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"AMD Ryzen 5 5600X 6-Core Processor","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 3060","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete","vram_mb":12288},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165},"storage":"nvme"},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":7000,"stdev":null,"min":7000,"max":7000,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1300},"memory.rss_steady_mb":{"n":1,"mean":1100},"chunks.village.load_ms":{"n":1,"mean":2500},"chunks.forest.load_ms":{"n":1,"mean":2500},"chunks.ocean.load_ms":{"n":1,"mean":2500},"chunks.mountain.load_ms":{"n":1,"mean":2500}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":250,"low_1pct_fps":60,"low_01pct_fps":30,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":260,"low_1pct_fps":60,"low_01pct_fps":30,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":270,"low_1pct_fps":60,"low_01pct_fps":30,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":280,"low_1pct_fps":60,"low_01pct_fps":30,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} +{"install_id":"b2","day":20396,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"AMD Ryzen 5 5600X 6-Core Processor","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 3060","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete","vram_mb":12288},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165},"storage":"nvme"},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":7100,"stdev":null,"min":7100,"max":7100,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1300},"memory.rss_steady_mb":{"n":1,"mean":1100},"chunks.village.load_ms":{"n":1,"mean":2400},"chunks.forest.load_ms":{"n":1,"mean":2400},"chunks.ocean.load_ms":{"n":1,"mean":2400},"chunks.mountain.load_ms":{"n":1,"mean":2400}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":260,"low_1pct_fps":70,"low_01pct_fps":35,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":270,"low_1pct_fps":70,"low_01pct_fps":35,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":280,"low_1pct_fps":70,"low_01pct_fps":35,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":290,"low_1pct_fps":70,"low_01pct_fps":35,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} +{"install_id":"b3","day":20396,"version":"v0.2.1","source":"game","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":2,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"AMD Ryzen 5 5600X 6-Core Processor","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 3060","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete","vram_mb":12288},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165},"storage":"nvme"},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":7100,"stdev":null,"min":7100,"max":7100,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1300},"memory.rss_steady_mb":{"n":1,"mean":1100},"chunks.village.load_ms":{"n":1,"mean":2400},"chunks.forest.load_ms":{"n":1,"mean":2400},"chunks.ocean.load_ms":{"n":1,"mean":2400},"chunks.mountain.load_ms":{"n":1,"mean":2400}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":260,"low_1pct_fps":70,"low_01pct_fps":35,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":270,"low_1pct_fps":70,"low_01pct_fps":35,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":280,"low_1pct_fps":70,"low_01pct_fps":35,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":290,"low_1pct_fps":70,"low_01pct_fps":35,"p50_ms":2,"p95_ms":6,"p99_ms":12,"p999_ms":18,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} +{"day":20396,"version":"v0.2.1","kind":"benchmark","data":{"format":"horizon-benchmark-report","version":1,"kind":"game","created":"2026-11-02","app":{"name":"horizon-client","version":"0.2.0"},"hardware":{"os":"linux","os_version":"secret-os-version","arch":"x86_64","cpu":"AMD Ryzen 5 5600X 6-Core Processor","cpu_threads":24,"ram_mb":32768,"gpu":{"name":"NVIDIA GeForce RTX 3060","vendor":"nvidia","driver":"secret-driver","backend":"vulkan","kind":"discrete","vram_mb":12288},"display":{"width":2560,"height":1440,"scale":1,"refresh_hz":165},"storage":"nvme"},"conditions":{"scenario":"standard","seed":"1234","render_distance":12,"simulation_distance":12,"window":[1280,720],"vsync":false,"repeats":1,"warmup_s":2},"metrics":{"startup.title_ms":{"n":1,"mean":900,"stdev":null,"min":900,"max":900,"ci95":null},"startup.world_ms":{"n":1,"mean":1,"stdev":null,"min":1,"max":1,"ci95":null},"memory.rss_peak_mb":{"n":1,"mean":1},"memory.rss_steady_mb":{"n":1,"mean":1},"chunks.village.load_ms":{"n":1,"mean":1},"chunks.forest.load_ms":{"n":1,"mean":1},"chunks.ocean.load_ms":{"n":1,"mean":1},"chunks.mountain.load_ms":{"n":1,"mean":1}},"frames":[{"phase":"village","repeat":0,"frames":1000,"seconds":12,"avg_fps":1,"low_1pct_fps":1,"low_01pct_fps":0.5,"p50_ms":2,"p95_ms":1,"p99_ms":2,"p999_ms":3,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"forest","repeat":0,"frames":1000,"seconds":12,"avg_fps":11,"low_1pct_fps":1,"low_01pct_fps":0.5,"p50_ms":2,"p95_ms":1,"p99_ms":2,"p999_ms":3,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"ocean","repeat":0,"frames":1000,"seconds":12,"avg_fps":21,"low_1pct_fps":1,"low_01pct_fps":0.5,"p50_ms":2,"p95_ms":1,"p99_ms":2,"p999_ms":3,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]},{"phase":"mountain","repeat":0,"frames":1000,"seconds":12,"avg_fps":31,"low_1pct_fps":1,"low_01pct_fps":0.5,"p50_ms":2,"p95_ms":1,"p99_ms":2,"p999_ms":3,"max_ms":50,"histogram":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]}} diff --git a/website/src/privacy.html b/website/src/privacy.html index 6b562a4cf..3e5729775 100644 --- a/website/src/privacy.html +++ b/website/src/privacy.html @@ -26,9 +26,19 @@
  • Performance statistics, after each play session of a minute or more. These are the frame-time and tick-time percentiles and a 14-bucket histogram (never a recording of each frame), the peak memory, how long the game took to start and to load the world, and the settings that change performance (render and simulation distance, frame limit, VSync, fullscreen, graphics mode).
  • Crash reports, when the game crashes. They hold the error, where it happened in Horizon's code, your graphics adapter and settings. They hold no log, no world, no server and no resource packs.
  • Bug reports that you write and send yourself. The end of the game's log goes with one only if you add it after reading it, and lines of chat are removed first.
  • -
  • Benchmark uploads of the benchmarks you run. They are shown publicly on the Benchmarks page, only as medians of groups of at least 3 different installs with the same graphics card, processor and render distance; never one by one, and never with your install ID, the day, your OS version, driver, memory or screen.
  • +
  • Benchmark uploads of the benchmarks you run. They are shown publicly on the Benchmarks page, only as medians of groups of at least 3 different installs with the same graphics card, processor and render distance; never one by one, and never with your install ID, the day, your OS version, driver, exact memory or screen.
  • -

    Each one also carries the Horizon version, the day it was made (not the time), and a description of your machine: the operating system and version, the CPU model and thread count, the memory rounded to the gigabyte, and the GPU, its driver and the graphics backend. It also carries a random install ID. The launcher makes that ID the first time you allow something; it says nothing about you and exists only so that your data can be deleted.

    +

    Each one also carries the Horizon version, the day it was made (not the time), and a description of your machine, because that is what explains how fast the game runs on it:

    +
      +
    • the operating system, its version and the processor architecture;
    • +
    • the processor model, its cores and threads, and its base and boost clock where the system gives them;
    • +
    • the memory, rounded to the gigabyte;
    • +
    • the graphics card the game draws with: its model, maker, whether it is built into the processor or separate, its own memory, its driver version and the graphics interface (Vulkan, Metal, DirectX 12);
    • +
    • the kind of drive the game folder is on (NVMe, SSD or hard disk);
    • +
    • the screen the game opened on: its size in pixels, refresh rate and scaling;
    • +
    • whether the computer is a laptop or a desktop, and whether it runs on battery.
    • +
    +

    No serial number, computer name, user name, network address or file path is read. Each item also carries a random install ID. The launcher makes that ID the first time you allow something; it says nothing about you and exists only so that your data can be deleted.

    Never sent: your Microsoft or Minecraft account name or UUID, world names, server or LAN addresses, chat, and your user name or home folder in file paths. Before anything is kept, those are replaced with placeholders, along with e-mail and IP addresses. The server does not store the IP address requests come from.

    The launcher shows exactly what would be sent: Settings → Data collection → View what would be sent, or horizon-launcher data show. Every field is listed in docs/telemetry.md.

    @@ -44,7 +54,7 @@

    For the switches: your consent (Article 6(1)(a) of the EU's General Data Protection Regulation). It is given kind by kind, recorded on your computer with the version of the question you answered and when, and withdrawn at any time with the same switches. Withdrawing deletes what was waiting to be sent. When what is collected changes, the launcher asks again, and nothing new is sent until you answer. The ping holds nothing that identifies you; the address it comes from is used only to limit how often one address may send, kept in memory for an hour at most and never stored.

    Where and how long

    -

    Items wait on your computer (telemetry/ in the game folder) and are sent compressed when the launcher starts or closes, to Horizon's own server, telemetry.playhorizon.dev, hosted by Railway in the European Union (Amsterdam, the Netherlands). The server keeps them for 180 days, then deletes them. What stays after that are anonymous totals per day, Horizon version, operating system, GPU maker and render distance (for example "120 sessions on macOS with Apple GPUs at render distance 12"). They hold no install ID, and groups too small to be anonymous are never shown.

    +

    Items wait on your computer (telemetry/ in the game folder) and are sent compressed when the launcher starts or closes, to Horizon's own server, telemetry.playhorizon.dev, hosted by Railway in the European Union (Amsterdam, the Netherlands). The server keeps them for 180 days, then deletes them. What stays after that are anonymous totals per day, Horizon version, operating system, GPU maker and render distance (for example "120 sessions on macOS with Apple GPUs at render distance 12"). They hold no install ID, and groups too small to be anonymous are never shown. Published results also show how players split by memory size (in steps: 8, 16, 32 GB…), graphics memory, drive type, operating system and built-in or separate graphics, each class only once it holds at least 3 different installs; the exact values, the driver, the clocks and the screen are never published.

    Deleting your data

    Settings → Data collection → Delete my data, or horizon-launcher data delete. The server deletes everything sent under your install ID, your share of the totals is recomputed, anything waiting on your computer is removed, and you get a new install ID. You can also turn everything off, or delete the telemetry/ folder.

    From 3f58e512e091751e95046504842054768ac3f2d8 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 02:16:54 +0200 Subject: [PATCH 077/126] Options test: Credits & Attribution follows Horizon's two buttons main (#1271) pins Horizon Settings and Mods as the grid's last buttons; this branch adds Credits & Attribution after them. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/options_ui.rs | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/crates/horizon-client/src/options_ui.rs b/crates/horizon-client/src/options_ui.rs index 617c2ee9d..383946991 100644 --- a/crates/horizon-client/src/options_ui.rs +++ b/crates/horizon-client/src/options_ui.rs @@ -4184,9 +4184,13 @@ mod tests { }) .collect() }; - // Vanilla's ten Options buttons, the last two Horizon's. + // Vanilla's Options buttons, Horizon's two in the Telemetry and Credits slots, then + // Credits & Attribution (WinScreen's credits). let main = pushes(&mut ui); - assert_eq!(&main[main.len() - 2..], [Page::Horizon, Page::Mods]); + assert_eq!( + &main[main.len() - 3..], + [Page::Horizon, Page::Mods, Page::Credits] + ); ui.push(Page::Horizon); assert_eq!( pushes(&mut ui), From a57efd4fa0a877aa285df50571d6074e6d1bcb0a Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 02:27:54 +0200 Subject: [PATCH 078/126] Launcher lock file: horizon-bench now depends on horizon-telemetry Co-Authored-By: Claude Opus 5.5 --- launcher/Cargo.lock | 1 + 1 file changed, 1 insertion(+) diff --git a/launcher/Cargo.lock b/launcher/Cargo.lock index 0e866fe19..9fdc76a8f 100644 --- a/launcher/Cargo.lock +++ b/launcher/Cargo.lock @@ -2633,6 +2633,7 @@ dependencies = [ name = "horizon-bench" version = "0.1.0" dependencies = [ + "horizon-telemetry", "serde", "serde_json", ] From b117930ae493b00e4d1a8ef44555b449bddfa967 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 01:46:35 +0200 Subject: [PATCH 079/126] No AI: one switch that turns off agent control (socket, horizon-ctl, both MCP servers) horizon_core::no_ai reads and writes the noAi line of the game's horizon-extras.txt, so the launcher and the game share one switch. While it is on the game never opens its control socket, horizon-ctl refuses every command with exit 4 and kind denied, horizon-ctl mcp and horizon-launcher mcp refuse to start (and refuse calls if it is turned on mid-session), and horizon-launcher no-ai [on|off] shows or sets it. The game's extras keep the key when they rewrite the file. Both e2e harnesses check it. Co-Authored-By: Claude Opus 5.5 --- .../src/bin/horizon-ctl/commands.rs | 5 +- .../src/bin/horizon-ctl/main.rs | 44 ++++++++- crates/horizon-client/src/extras.rs | 8 +- crates/horizon-client/src/game.rs | 8 +- crates/horizon-core/src/lib.rs | 1 + crates/horizon-core/src/no_ai.rs | 97 +++++++++++++++++++ launcher/src/backend.rs | 11 +++ launcher/src/cli.rs | 24 ++++- launcher/src/mcp.rs | 4 + tools/agent_control_e2e.py | 72 +++++++++++++- tools/launcher_mcp_e2e.py | 34 ++++++- 11 files changed, 296 insertions(+), 12 deletions(-) create mode 100644 crates/horizon-core/src/no_ai.rs diff --git a/crates/horizon-client/src/bin/horizon-ctl/commands.rs b/crates/horizon-client/src/bin/horizon-ctl/commands.rs index 230cbc880..7a3323fae 100644 --- a/crates/horizon-client/src/bin/horizon-ctl/commands.rs +++ b/crates/horizon-client/src/bin/horizon-ctl/commands.rs @@ -366,8 +366,9 @@ pub fn overview() -> String { } out.push_str( "\nEvery reply is one JSON line. Errors are {\"error\": \"...\"}; the exit status is 0 on\n\ - success, 1 when the game replied with an error, 2 for a usage error and 3 when the\n\ - game cannot be reached or started. Actions (goto, break, place...) block until done.\n\ + success, 1 when the game replied with an error, 2 for a usage error, 3 when the\n\ + game cannot be reached or started and 4 while No AI is on (the launcher's settings).\n\ + Actions (goto, break, place...) block until done.\n\ horizon-ctl help --game lists the running game's own commands, test hooks included.\n\ The socket is $HORIZON_CONTROL, else $XDG_RUNTIME_DIR/horizon-control.sock (on Windows\n\ %TEMP%\\horizon-control.json, a localhost TCP port with a token; any path ending in .json\n\ diff --git a/crates/horizon-client/src/bin/horizon-ctl/main.rs b/crates/horizon-client/src/bin/horizon-ctl/main.rs index 27d9d5ba1..5e9d43ab4 100644 --- a/crates/horizon-client/src/bin/horizon-ctl/main.rs +++ b/crates/horizon-client/src/bin/horizon-ctl/main.rs @@ -20,6 +20,8 @@ use serde_json::{Value, json}; const GAME_ERROR: u8 = 1; const USAGE: u8 = 2; const UNREACHABLE: u8 = 3; +/// No AI is on (`horizon_core::no_ai`): agent control is off. +const DENIED: u8 = 4; /// A failure, with the exit status it maps to. #[derive(Debug)] @@ -34,6 +36,13 @@ impl Failure { status: USAGE, } } + /// No AI is on in the game's home. + fn denied() -> Self { + Self { + reply: json!({ "error": horizon_core::no_ai::REFUSAL, "kind": "denied" }), + status: DENIED, + } + } fn unreachable(message: impl Into) -> Self { Self { reply: json!({ "error": message.into(), "kind": "connection" }), @@ -98,6 +107,8 @@ impl Client { pub struct Session { pub socket: PathBuf, pub timeout: Option, + /// The game's home, where No AI is read (`horizon_core::no_ai`). + pub home: PathBuf, client: Option, } @@ -106,9 +117,14 @@ impl Session { Self { socket, timeout, + home: horizon_client::logging::game_home(), client: None, } } + /// A failure while No AI is on: every command refuses (help aside). + pub fn allowed(&self) -> Result<(), Failure> { + horizon_core::no_ai::check(&self.home).map_err(|_| Failure::denied()) + } fn client(&mut self) -> Result<&mut Client, Failure> { if self.client.is_none() { self.client = Some(Client::connect(&self.socket, self.timeout)?); @@ -137,6 +153,7 @@ impl Session { let Some(name) = words.first().map(String::as_str) else { return Err(Failure::usage("no command; try horizon-ctl help")); }; + self.allowed()?; if words.iter().skip(1).any(|w| w == "--help" || w == "-h") { return Err(Failure::usage( "use horizon-ctl COMMAND --help outside scripts", @@ -183,7 +200,7 @@ impl Session { thread::sleep(Duration::from_secs_f64(seconds.max(0.0))); self.game(&format!("key {key} up")) } - "logs" => logs(&horizon_client::logging::game_home(), &words[1..]), + "logs" => logs(&self.home, &words[1..]), "wait-ready" => { let limit = if words.len() > 1 { number(1, "SECONDS")? @@ -451,6 +468,10 @@ fn main() -> ExitCode { } } } + Some("mcp") if session.allowed().is_err() => { + eprintln!("horizon-ctl mcp: {}", horizon_core::no_ai::REFUSAL); + DENIED + } Some("mcp") => match mcp::serve(&mut session) { Ok(()) => 0, Err(e) => { @@ -581,6 +602,27 @@ mod tests { assert_eq!(f.status, USAGE); } + #[test] + fn no_ai_refuses_every_command() { + let home = std::env::temp_dir().join(format!("horizon-ctl-no-ai-{}", std::process::id())); + let _ = std::fs::remove_dir_all(&home); + let mut s = Session::new(std::env::temp_dir().join("horizon-ctl-nobody.sock"), None); + s.home = home.clone(); + assert_eq!( + s.run(&["state".to_owned()]).unwrap_err().status, + UNREACHABLE + ); + horizon_core::no_ai::set(&home, true).unwrap(); + for words in [vec!["state"], vec!["logs"], vec!["launch", "--world", "A"]] { + let words: Vec = words.into_iter().map(str::to_owned).collect(); + let f = s.run(&words).unwrap_err(); + assert_eq!(f.status, DENIED, "{words:?}"); + assert_eq!(f.reply["kind"], "denied"); + assert_eq!(f.reply["error"], horizon_core::no_ai::REFUSAL); + } + let _ = std::fs::remove_dir_all(&home); + } + #[test] fn screenshot_paths_become_absolute() { let mut words = vec!["screenshot".to_owned(), "a.png".to_owned()]; diff --git a/crates/horizon-client/src/extras.rs b/crates/horizon-client/src/extras.rs index c7be78019..2dbcd1a8f 100644 --- a/crates/horizon-client/src/extras.rs +++ b/crates/horizon-client/src/extras.rs @@ -107,6 +107,8 @@ pub struct Extras { pub sort: bool, /// A vanilla key name: sorts the part under the cursor. pub sort_key: String, + /// No AI: every AI feature hidden and off (`horizon_core::no_ai`; the launcher writes it too). + pub no_ai: bool, } impl Default for Extras { fn default() -> Self { @@ -135,6 +137,7 @@ impl Default for Extras { mouse_tweaks_wheel: true, sort: false, sort_key: "key.keyboard.unknown".into(), + no_ai: false, } } } @@ -198,6 +201,7 @@ impl Extras { "mouseTweaksWheel" => e.mouse_tweaks_wheel = flag(e.mouse_tweaks_wheel), "sort" => e.sort = flag(e.sort), "sortKey" if value.starts_with("key.") => e.sort_key = value.to_owned(), + horizon_core::no_ai::KEY => e.no_ai = flag(e.no_ai), _ => {} } } @@ -205,7 +209,7 @@ impl Extras { } pub fn serialize(&self) -> String { format!( - "fullbright:{}\ndynamicLights:{}\nzoom:{}\nzoomKey:{}\nzoomLevel:{}\nzoomSmooth:{}\nzoomSensitivity:{}\nfps:{}\nfpsCorner:{}\nfpsLows:{}\nkeystrokes:{}\nkeystrokesCorner:{}\nkeystrokesCps:{}\nminimap:{}\nminimapCorner:{}\nminimapSize:{}\nminimapShape:{}\nminimapZoom:{}\nminimapRotate:{}\nautoReconnect:{}\nmouseTweaks:{}\nmouseTweaksWheel:{}\nsort:{}\nsortKey:{}\n", + "fullbright:{}\ndynamicLights:{}\nzoom:{}\nzoomKey:{}\nzoomLevel:{}\nzoomSmooth:{}\nzoomSensitivity:{}\nfps:{}\nfpsCorner:{}\nfpsLows:{}\nkeystrokes:{}\nkeystrokesCorner:{}\nkeystrokesCps:{}\nminimap:{}\nminimapCorner:{}\nminimapSize:{}\nminimapShape:{}\nminimapZoom:{}\nminimapRotate:{}\nautoReconnect:{}\nmouseTweaks:{}\nmouseTweaksWheel:{}\nsort:{}\nsortKey:{}\n{}:{}\n", bool_text(self.fullbright), bool_text(self.dynamic_lights), bool_text(self.zoom), @@ -234,6 +238,8 @@ impl Extras { bool_text(self.mouse_tweaks_wheel), bool_text(self.sort), self.sort_key, + horizon_core::no_ai::KEY, + bool_text(self.no_ai), ) } /// Binds the extra key `name` (`ZOOM_KEY`, `SORT_KEY`); false for diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index ce9183cac..aeab446d1 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -12439,7 +12439,13 @@ fn start_game<'a>( game.mods.dev = game.options.dev_mods.clone(); game.start_mods(); } - if let Some(path) = &game.options.control { + if game.options.control.is_some() && game.settings.extras.no_ai { + // No AI turns agent control off: the socket is never opened. + log::warn!( + "Horizon: control socket not opened: {}", + horizon_core::no_ai::REFUSAL + ); + } else if let Some(path) = &game.options.control { let server = horizon_client::control::Server::start(path) .map_err(|e| format!("control socket {}: {e}", path.display()))?; log::info!("Horizon: control socket {}", server.path().display()); diff --git a/crates/horizon-core/src/lib.rs b/crates/horizon-core/src/lib.rs index 9034ef2eb..e5bddbc4f 100644 --- a/crates/horizon-core/src/lib.rs +++ b/crates/horizon-core/src/lib.rs @@ -9,6 +9,7 @@ pub mod carving; pub mod density; pub mod geometry; pub mod jmath; +pub mod no_ai; pub mod noise; pub mod paletted; pub mod position; diff --git a/crates/horizon-core/src/no_ai.rs b/crates/horizon-core/src/no_ai.rs new file mode 100644 index 000000000..18b3de0f2 --- /dev/null +++ b/crates/horizon-core/src/no_ai.rs @@ -0,0 +1,97 @@ +//! The "No AI" switch: one setting that hides and turns off every AI feature of Horizon (the +//! companion, agent control through the control socket, `horizon-ctl`, its MCP server and the +//! launcher's). The launcher and the game both read and write it here, so they always agree. +//! +//! It is the `noAi` line of the game's `horizon-extras.txt`, in the game's home (the folder +//! with `options.txt`). Missing means off: AI features are available. See docs/agent-control.md. +use std::{fs, io, path::Path}; + +/// The game's extras file, beside `options.txt`. +pub const FILE: &str = "horizon-extras.txt"; +/// The key No AI is kept under there. +pub const KEY: &str = "noAi"; +/// The one line every AI surface answers with while No AI is on. +pub const REFUSAL: &str = "AI features are off: turn off No AI in the launcher's settings"; + +/// Whether `text` (an extras file) says No AI. +pub fn parse(text: &str) -> bool { + text.lines().any(|line| { + line.split_once(':') + .is_some_and(|(k, v)| k.trim() == KEY && v.trim() == "true") + }) +} + +/// Whether No AI is on for the game whose home is `home`. +pub fn is_on(home: &Path) -> bool { + fs::read_to_string(home.join(FILE)).is_ok_and(|text| parse(&text)) +} + +/// `text` with its `noAi` line set to `on`, every other line kept as it was. +pub fn with(text: &str, on: bool) -> String { + let mut out: String = text + .lines() + .filter(|line| line.split_once(':').is_none_or(|(k, _)| k.trim() != KEY)) + .flat_map(|line| [line, "\n"]) + .collect(); + out.push_str(&format!("{KEY}:{on}\n")); + out +} + +/// Turns No AI on or off for the game in `home`, keeping the file's other settings. Turning it +/// off where there is no file writes nothing (off is the default). +pub fn set(home: &Path, on: bool) -> io::Result<()> { + let path = home.join(FILE); + let text = match fs::read_to_string(&path) { + Ok(text) => text, + Err(e) if e.kind() == io::ErrorKind::NotFound => { + if !on { + return Ok(()); + } + String::new() + } + Err(e) => return Err(e), + }; + fs::create_dir_all(home)?; + fs::write(path, with(&text, on)) +} + +/// `Err(REFUSAL)` while No AI is on in `home`. +pub fn check(home: &Path) -> Result<(), &'static str> { + if is_on(home) { Err(REFUSAL) } else { Ok(()) } +} + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn reads_and_writes_the_extras_line_keeping_the_others() { + assert!(!parse("")); + assert!(!parse("noAi:false\nzoom:true\n")); + assert!(parse("zoom:true\nnoAi: true\n")); + assert_eq!( + with("zoom:true\nnoAi:false\nfps:true", true), + "zoom:true\nfps:true\nnoAi:true\n" + ); + assert_eq!(with("", false), "noAi:false\n"); + } + + #[test] + fn set_writes_only_when_needed() { + let home = std::env::temp_dir().join(format!("horizon-no-ai-{}", std::process::id())); + let _ = fs::remove_dir_all(&home); + set(&home, false).unwrap(); + assert!(!home.join(FILE).exists(), "off needs no file"); + assert!(check(&home).is_ok()); + set(&home, true).unwrap(); + assert!(is_on(&home)); + assert_eq!(check(&home), Err(REFUSAL)); + fs::write(home.join(FILE), "fps:true\nnoAi:true\n").unwrap(); + set(&home, false).unwrap(); + assert_eq!( + fs::read_to_string(home.join(FILE)).unwrap(), + "fps:true\nnoAi:false\n" + ); + let _ = fs::remove_dir_all(&home); + } +} diff --git a/launcher/src/backend.rs b/launcher/src/backend.rs index e86bd7e87..b5f511ee9 100644 --- a/launcher/src/backend.rs +++ b/launcher/src/backend.rs @@ -1269,6 +1269,17 @@ pub fn game_home() -> PathBuf { .join("horizon") } +/// Whether No AI is on: every AI feature hidden and off (`horizon_core::no_ai`, kept in the +/// game's `horizon-extras.txt` so the game reads the same switch). +pub fn no_ai() -> bool { + horizon_core::no_ai::is_on(&game_home()) +} + +/// Turns No AI on or off for the launcher and the game. +pub fn set_no_ai(on: bool) -> Result<(), String> { + horizon_core::no_ai::set(&game_home(), on).map_err(|e| format!("Could not save No AI: {e}")) +} + // ----- Logs and crash reports --------------------------------------------------------------------- /// The game's logs (`latest.log` and the day archives), as it writes them in its home. diff --git a/launcher/src/cli.rs b/launcher/src/cli.rs index 88934f3a5..7ca348a3a 100644 --- a/launcher/src/cli.rs +++ b/launcher/src/cli.rs @@ -343,8 +343,16 @@ enum Cmd { #[command(subcommand)] action: Option, }, - /// Serve the Model Context Protocol on stdin and stdout, for AI agents + /// Serve the Model Context Protocol on stdin and stdout, for AI agents (refused while No AI + /// is on) Mcp, + /// Show or set No AI: on hides and turns off every AI feature (the companion, agent control, + /// horizon-ctl and both MCP servers); off, the default, makes them available + NoAi { + /// Omit to show the current state + #[arg(value_parser = ["on", "off"])] + state: Option, + }, /// Measure the launcher: starts (the first is the cold one), page switching, idle CPU and /// memory, the release list fetch; writes a benchmark report to benchmarks/ in its data folder Benchmark { @@ -359,6 +367,7 @@ pub fn run() -> Option { let cli = Cli::parse(); let command = cli.command?; let result = match command { + Cmd::Mcp if backend::no_ai() => Err(horizon_core::no_ai::REFUSAL.into()), Cmd::Mcp => crate::mcp::serve(), command => execute(command, cli.json), }; @@ -553,6 +562,19 @@ fn execute(command: Cmd, as_json: bool) -> Result<(), String> { } } } + Cmd::NoAi { state } => { + if let Some(state) = state { + backend::set_no_ai(state == "on")?; + } + let on = backend::no_ai(); + if as_json { + json(serde_json::json!({ "no_ai": on })); + } else if on { + println!("No AI is on: every AI feature is hidden and off."); + } else { + println!("No AI is off: AI features are available."); + } + } Cmd::UpdateChannel { channel } => { let mut settings = backend::Settings::load(); if let Some(channel) = channel.as_deref().and_then(backend::UpdateChannel::parse) { diff --git a/launcher/src/mcp.rs b/launcher/src/mcp.rs index a8a324d67..5abe45325 100644 --- a/launcher/src/mcp.rs +++ b/launcher/src/mcp.rs @@ -439,6 +439,10 @@ impl Session { } Ok(json!({ "tools": list })) } + // No AI turned on during the session: nothing more runs. + "tools/call" if backend::no_ai() => { + Err((-32000, horizon_core::no_ai::REFUSAL.to_string())) + } "tools/call" => { let name = params .get("name") diff --git a/tools/agent_control_e2e.py b/tools/agent_control_e2e.py index f4c7acaa9..5be9e1865 100644 --- a/tools/agent_control_e2e.py +++ b/tools/agent_control_e2e.py @@ -11,7 +11,9 @@ states (wait-for) and reads the event log; the consume scenario eats and drinks golden apple, milk, honey, chorus fruit) and checks their effects, remainders and teleport; the pick scenario middle-clicks slots (AbstractContainerScreen's cloning): a full stack in creative, from the hotbar and from an item tab, and nothing in survival; the suggestions scenario checks -slash-command Tab completion on single player's connected client after a fresh launch. +slash-command Tab completion on single player's connected client after a fresh launch; the no-ai +scenario turns No AI on in a scratch game home and checks that horizon-ctl, its MCP server and the +game's control socket all refuse. python3 tools/agent_control_e2e.py # both modes python3 tools/agent_control_e2e.py --mode mcp # one of them @@ -571,13 +573,73 @@ SCENARIOS = {'survival': scenario, 'ui': ui_scenario, 'options': options_scenari 'consume': consume_scenario, 'pick': pick_scenario, 'suggestions': suggestions_scenario} -def run(mode, ctl, out, resources, which='survival'): +REFUSAL = "AI features are off: turn off No AI in the launcher's settings" + + +def scratch(mode, resources): + """A scratch game home with the prepared resources, and the game's environment for it.""" work = Path(tempfile.mkdtemp(prefix=f'hzac-{mode}-')) (work / '.local').mkdir() (work / '.local/horizon-client').mkdir() os.symlink(resources, work / '.local/horizon-client' / lab.VERSION) + # horizon-ctl reads No AI in the game home: this one, not the player's. + env = dict(game_env(os.environ.get('VSCREEN', 'agent-control')), HORIZON_HOME=str(work)) + return work, env + + +def no_ai_check(mode, ctl, resources): + """No AI on: horizon-ctl refuses (exit 4, kind denied), so does its MCP server, and the game + started with --control-socket never opens it.""" + work, env = scratch(mode, resources) + socket = work / 'c.sock' + try: + (work / 'horizon-extras.txt').write_text('fps:true\nnoAi:true\n') + if mode == 'cli': + for words in (['state'], ['launch', '--world', 'NoAi'], ['logs']): + r = subprocess.run([str(ctl), '--socket', str(socket), *words], cwd=work, env=env, + capture_output=True, text=True, timeout=60) + reply = json.loads(r.stdout.strip().splitlines()[-1]) + log(mode, words, reply) + assert r.returncode == 4 and reply == {'error': REFUSAL, 'kind': 'denied'}, (r.returncode, reply) + client = ctl.with_name('horizon-client') + args = [str(client), '--control-socket', str(socket), '--world', 'NoAi', '--world-frames', '30'] + if sys.platform == 'darwin': + args.append('--offscreen') + r = subprocess.run(args, cwd=work, env=env, capture_output=True, text=True, timeout=600) + text = r.stdout + r.stderr + ''.join( + p.read_text(errors='replace') for p in (work / 'logs').glob('latest.log')) + assert r.returncode == 0, f'game exit {r.returncode}: {text[-2000:]}' + assert 'control socket not opened' in text and REFUSAL in text, text[-2000:] + assert not socket.exists(), 'the game opened its control socket under No AI' + else: + r = subprocess.run([str(ctl), '--socket', str(socket), 'mcp'], cwd=work, env=env, input='', + capture_output=True, text=True, timeout=60) + log(mode, ['mcp'], {'exit': r.returncode, 'stderr': r.stderr.strip()}) + assert r.returncode == 4 and r.stderr.strip() == f'horizon-ctl mcp: {REFUSAL}', r + # Turned on during a session: the next call refuses. + (work / 'horizon-extras.txt').write_text('noAi:false\n') + m = Mcp(ctl, socket, work, env) + (work / 'horizon-extras.txt').write_text('noAi:true\n') + try: + m('state') + raise AssertionError('state ran under No AI') + except Failed as e: + assert REFUSAL in str(e) and 'denied' in str(e), e + m.close() + print(f'[{mode}] PASS: no-ai') + return True + except (Failed, AssertionError, json.JSONDecodeError, IndexError, subprocess.TimeoutExpired) as e: + print(f'[{mode}] FAIL: no-ai: {e!r}') + return False + finally: + shutil.rmtree(work, ignore_errors=True) + + +def run(mode, ctl, out, resources, which='survival'): + if which == 'no-ai': + return no_ai_check(mode, ctl, resources) + work, env = scratch(mode, resources) socket = work / 'c.sock' - env = game_env(os.environ.get('VSCREEN', 'agent-control')) driver = (Cli if mode == 'cli' else Mcp)(ctl, socket, work, env) started = time.time() try: @@ -604,7 +666,7 @@ def run(mode, ctl, out, resources, which='survival'): def main(): parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) parser.add_argument('--mode', choices=['cli', 'mcp', 'both'], default='both') - parser.add_argument('--scenario', choices=[*SCENARIOS, 'all'], default='all') + parser.add_argument('--scenario', choices=[*SCENARIOS, 'no-ai', 'all'], default='all') parser.add_argument('--bin-dir', help='prebuilt horizon-client and horizon-ctl (default: build with the fast profile)') parser.add_argument('--out', default=str(ROOT / '.local/agent-control-e2e'), help='screenshots go here') args = parser.parse_args() @@ -622,7 +684,7 @@ def main(): out = Path(args.out) out.mkdir(parents=True, exist_ok=True) modes = ['cli', 'mcp'] if args.mode == 'both' else [args.mode] - scenarios = list(SCENARIOS) if args.scenario == 'all' else [args.scenario] + scenarios = [*SCENARIOS, 'no-ai'] if args.scenario == 'all' else [args.scenario] results = {f'{m}/{s}': run(m, bins / 'horizon-ctl', out, resources, s) for m in modes for s in scenarios} print(json.dumps(results)) sys.exit(0 if all(results.values()) else 1) diff --git a/tools/launcher_mcp_e2e.py b/tools/launcher_mcp_e2e.py index 955d141d4..fbcb1b5cc 100644 --- a/tools/launcher_mcp_e2e.py +++ b/tools/launcher_mcp_e2e.py @@ -5,7 +5,9 @@ A scratch launcher home gets one "installed" version made of this checkout's bui (horizon-client and horizon-ctl) and the prepared resources in .local/horizon-client. An MCP client then talks to `horizon-launcher mcp` alone: the game tools are listed, a call before the game runs says to launch it, launch_client starts it under control, and game_wait_ready, -game_state, game_ui and game_screenshot play it until game_quit. +game_state, game_ui and game_screenshot play it until game_quit. Then No AI is turned on with +`horizon-launcher no-ai on`: `horizon-launcher mcp` refuses to start, and a session already running +refuses its next call. python3 tools/launcher_mcp_e2e.py --bin-dir target/fast --launcher launcher/target/debug/horizon-launcher @@ -96,6 +98,35 @@ def scenario(m, out): return {'tools': len(tools)} +REFUSAL = "AI features are off: turn off No AI in the launcher's settings" + + +def no_ai_scenario(launcher, env, home): + run = lambda *a: subprocess.run([str(launcher), *a], env=env, input='', capture_output=True, text=True, + timeout=60) + assert json.loads(run('no-ai', '--json').stdout) == {'no_ai': False} + m = Mcp(launcher, env) + m.rpc('initialize', {'protocolVersion': '2025-06-18', 'capabilities': {}, + 'clientInfo': {'name': 'launcher_mcp_e2e', 'version': '1'}}) + r = run('no-ai', 'on') + assert r.returncode == 0, r + assert 'noAi:true' in (home / 'horizon-extras.txt').read_text() + try: + m.call('links') + raise AssertionError('links ran under No AI') + except Failed as e: + assert REFUSAL in str(e), e + m.close() + r = run('mcp') + print(f'[launcher-mcp] mcp under No AI -> exit {r.returncode}: {r.stderr.strip()}') + assert r.returncode == 1 and r.stderr.strip() == f'error: {REFUSAL}', r + # What the launcher needs keeps working. + assert run('versions', '--installed', '--json').returncode == 0 + assert run('no-ai', 'off').returncode == 0 + assert json.loads(run('no-ai', '--json').stdout) == {'no_ai': False} + return {'no_ai': 'refused'} + + def main(): parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) parser.add_argument('--bin-dir', required=True, help='horizon-client and horizon-ctl built from this checkout') @@ -120,6 +151,7 @@ def main(): m = Mcp(Path(args.launcher).resolve(), env) try: summary = scenario(m, out) + summary.update(no_ai_scenario(Path(args.launcher).resolve(), env, work / 'home')) print(f'[launcher-mcp] PASS: {summary}') ok = True except (Failed, AssertionError, KeyError, json.JSONDecodeError) as e: From bcbf860aaae3091e48c5d331d2891cc39149b4b4 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 01:54:12 +0200 Subject: [PATCH 080/126] horizon-ctl: every player action in the one command table, with a generated reference The table gains what only the raw socket could do (options pages, connect and invite codes, disconnect, LAN, Play with Friends, books, signs, mount inventories, effects, xp, enchant, potion, fill, containers) and new commands: worlds, world-rename, world-backup, world-delete --confirm (the Select and Edit World screens, from the title screen only), servers (the Multiplayer list) and interact-entity (right-click an entity). status, mouse, pad, release, bench and stats become MCP tools; summon takes a position. Destructive and network tools carry MCP annotations. docs/horizon-ctl-commands.md is generated from the table (horizon-ctl help --markdown) and a test fails when it drifts. The agent_control_e2e manage scenario exercises the new commands. Co-Authored-By: Claude Opus 5.5 --- .../src/bin/horizon-ctl/commands.rs | 223 +++++++++++++++++- .../src/bin/horizon-ctl/main.rs | 16 ++ .../horizon-client/src/bin/horizon-ctl/mcp.rs | 8 +- crates/horizon-client/src/game.rs | 1 + crates/horizon-client/src/game/control.rs | 4 + .../horizon-client/src/game/saves_control.rs | 123 ++++++++++ crates/horizon-client/src/title.rs | 10 +- .../src/title/world_management.rs | 8 +- docs/horizon-ctl-commands.md | 140 +++++++++++ tools/agent_control_e2e.py | 55 ++++- 10 files changed, 568 insertions(+), 20 deletions(-) create mode 100644 crates/horizon-client/src/game/saves_control.rs create mode 100644 docs/horizon-ctl-commands.md diff --git a/crates/horizon-client/src/bin/horizon-ctl/commands.rs b/crates/horizon-client/src/bin/horizon-ctl/commands.rs index 230cbc880..5d5d3c7ed 100644 --- a/crates/horizon-client/src/bin/horizon-ctl/commands.rs +++ b/crates/horizon-client/src/bin/horizon-ctl/commands.rs @@ -32,16 +32,18 @@ pub enum Group { Move, Act, Screens, + Multiplayer, World, Scripting, } impl Group { - pub const ALL: [Group; 7] = [ + pub const ALL: [Group; 8] = [ Group::Session, Group::Observe, Group::Move, Group::Act, Group::Screens, + Group::Multiplayer, Group::World, Group::Scripting, ]; @@ -52,6 +54,7 @@ impl Group { Group::Move => "Move and look", Group::Act => "Act on the world", Group::Screens => "Screens, menus and chat", + Group::Multiplayer => "Multiplayer, LAN and friends", Group::World => "World and cheats", Group::Scripting => "Scripting and benchmarks", } @@ -117,6 +120,49 @@ const OVER: Param = flag( "turn with mouse motion spread over this many seconds (eased), as a player would", ); const FACE: Ty = Ty::Enum(&["down", "up", "north", "south", "west", "east"]); +const BOX: [Param; 6] = [ + p("x1", Ty::Int, "corner X"), + p("y1", Ty::Int, "corner Y"), + p("z1", Ty::Int, "corner Z"), + p("x2", Ty::Int, "opposite X"), + p("y2", Ty::Int, "opposite Y"), + p("z2", Ty::Int, "opposite Z"), +]; +const PAGES: Ty = Ty::Enum(&[ + "main", + "video", + "sound", + "controls", + "keybinds", + "controller", + "controller-binds", + "mouse", + "chat", + "accessibility", + "language", + "font", + "packs", + "mods", + "graphics", + "graphics-advanced", + "extras", + "horizon", + "shader-packs", +]); + +/// `--confirm`, required by destructive commands: the player agreed. +const CONFIRM: Param = Param { + name: "confirm", + ty: Ty::Bool, + required: true, + flag: true, + help: "true once the player agreed: it cannot be undone", +}; + +/// MCP tools that delete or overwrite the player's things (`destructiveHint`). +pub const DESTRUCTIVE: &[&str] = &["world-delete", "fill", "setblock"]; +/// MCP tools that reach other players or the network (`openWorldHint`): only when the player asks. +pub const OPEN_WORLD: &[&str] = &["connect", "lan", "friends", "chat", "command"]; macro_rules! cmd { ($name:expr, $group:ident, $usage:expr, $summary:expr, $details:expr, [$($ex:expr),* $(,)?], $params:expr, mcp: $mcp:expr, local: $local:expr $(, wire: $wire:expr)?) => { @@ -164,7 +210,19 @@ pub const COMMANDS: &[Cmd] = &[ &[flag("lines", Ty::Int, "how many lines of latest.log (default 100)"), flag("crash", Ty::Bool, "the newest crash report instead")], mcp: true, local: true), cmd!("status", Session, "status", "game, renderer and streaming state (the scripting socket's original summary)", - "", ["horizon-ctl status"], &[], mcp: false, local: false), + "Also what F3 shows: the overlay flags, the renderer, chunk streaming and memory.", ["horizon-ctl status"], &[], mcp: true, local: false), + cmd!("worlds", Session, "worlds", "the saved worlds, newest first: folder, name, mode, last played, version", + "folder is what open, world-rename, world-backup and world-delete take.", ["horizon-ctl worlds"], &[], mcp: true, local: false), + cmd!("world-rename", Session, "world-rename FOLDER NAME", "rename a world, as Edit World does (its folder stays)", + "Needs the title screen (no world open).", ["horizon-ctl world-rename Test \"My Base\""], + &[p("folder", Ty::Str, "world folder from worlds"), p("name", Ty::Rest, "the new name")], mcp: true, local: false), + cmd!("world-backup", Session, "world-backup FOLDER", "zip a world into backups/, as Edit World's Make Backup does", + "Needs the title screen. Replies once the zip is written, with its size.", ["horizon-ctl world-backup Test"], + &[p("folder", Ty::Str, "world folder from worlds")], mcp: true, local: false), + cmd!("world-delete", Session, "world-delete FOLDER --confirm", "delete a world for good, as Select World's Delete does", + "Needs the title screen and --confirm: ask the player first, it cannot be undone (world-backup keeps a copy).", + ["horizon-ctl world-delete Test --confirm"], + &[p("folder", Ty::Str, "world folder from worlds"), CONFIRM], mcp: true, local: false), cmd!("open", Session, "open WORLD [SEED] [creative]", "open or create a world from the title screen", "Opens saves/WORLD, creating it with SEED (and creative mode) when it doesn't exist.", ["horizon-ctl open Test 12345", "horizon-ctl open Build 0 creative"], @@ -190,10 +248,10 @@ pub const COMMANDS: &[Cmd] = &[ cmd!("light", Observe, "light X1 Y1 Z1 X2 Y2 Z2", "the stored sky and block light of a box", "At most 32768 blocks per request. One hex digit per block in `sky` and `block`, x fastest, then z, then y; `.` where no chunk is loaded.", ["horizon-ctl light 0 64 0 15 70 15"], - &[p("x1", Ty::Int, "corner X"), p("y1", Ty::Int, "corner Y"), p("z1", Ty::Int, "corner Z"), p("x2", Ty::Int, "opposite X"), p("y2", Ty::Int, "opposite Y"), p("z2", Ty::Int, "opposite Z")], mcp: true, local: false), + &BOX, mcp: true, local: false), cmd!("blocks", Observe, "blocks X1 Y1 Z1 X2 Y2 Z2", "the non-air blocks of a box, with counts per block", "At most 32768 blocks per request.", ["horizon-ctl blocks 0 60 0 15 70 15"], - &[p("x1", Ty::Int, "corner X"), p("y1", Ty::Int, "corner Y"), p("z1", Ty::Int, "corner Z"), p("x2", Ty::Int, "opposite X"), p("y2", Ty::Int, "opposite Y"), p("z2", Ty::Int, "opposite Z")], mcp: true, local: false), + &BOX, mcp: true, local: false), cmd!("find-block", Observe, "find-block BLOCK [RADIUS]", "the nearest loaded blocks of a kind", "Searches a cube of RADIUS (default 32, at most 64) around the player; returns the count and the 16 nearest.", ["horizon-ctl find-block oak_log", "horizon-ctl find-block diamond_ore 48"], @@ -264,12 +322,15 @@ pub const COMMANDS: &[Cmd] = &[ "down holds the key until key ... up, release or stop; wait does not release it. move, goto, jump, break and the other actions release the movement keys when they end.", ["horizon-ctl key space tap"], &[p("key", Ty::Str, "key name"), p("action", Ty::Enum(&["down", "up", "tap", "repeat"]), "what to do")], mcp: true, local: false), cmd!("mouse", Act, "mouse left|right|middle down|up|click", "press or release a mouse button in the world", "", - ["horizon-ctl mouse right click"], &[p("button", Ty::Enum(&["left", "right", "middle"]), "button"), p("action", Ty::Enum(&["down", "up", "click"]), "what to do")], mcp: false, local: false), + ["horizon-ctl mouse right click"], &[p("button", Ty::Enum(&["left", "right", "middle"]), "button"), p("action", Ty::Enum(&["down", "up", "click"]), "what to do")], mcp: true, local: false), + cmd!("interact-entity", Act, "interact-entity ID", "right-click an entity: trade with a villager, mount a horse, ride a boat, shear a sheep", + "Faces the entity (from entities), right-clicks it with the held item, waits two ticks and replies with the screen.", + ["horizon-ctl interact-entity 42"], &[p("id", Ty::Int, "entity id from entities")], mcp: true, local: true), cmd!("pad", Act, "pad BUTTON down|up|tap | pad stick left|right X Y | pad trigger left|right V | pad release | pad status", "a virtual controller: buttons, sticks and triggers as a real pad would send them", "Buttons by position: south east west north lb rb lt rt select start ls rs up down left right (south is Xbox A / PlayStation cross). Sticks run -1..1 with up positive and stay tilted until centred; triggers 0..1. Merged with any real controller; status lists the connected ones and what is held.", ["horizon-ctl pad south tap", "horizon-ctl pad stick left 0 1", "horizon-ctl pad trigger right 1", "horizon-ctl pad status"], - &[p("what", Ty::Str, "a button name, stick, trigger, release or status"), opt("a", Ty::Str, "down|up|tap, or left|right"), opt("b", Ty::Num, "stick X or trigger value"), opt("c", Ty::Num, "stick Y")], mcp: false, local: false), - cmd!("release", Act, "release", "release every key and mouse button", "", ["horizon-ctl release"], &[], mcp: false, local: false), + &[p("what", Ty::Str, "a button name, stick, trigger, release or status"), opt("a", Ty::Str, "down|up|tap, or left|right"), opt("b", Ty::Num, "stick X or trigger value"), opt("c", Ty::Num, "stick Y")], mcp: true, local: false), + cmd!("release", Act, "release", "release every key and mouse button", "", ["horizon-ctl release"], &[], mcp: true, local: false), cmd!("stop", Act, "stop", "cancel the running action (goto, break...) and release every key", "", ["horizon-ctl stop"], &[], mcp: true, local: false), // Screens cmd!("open-inventory", Screens, "open-inventory", "open the inventory screen (crafting grid 100-103, result 200)", "", @@ -317,7 +378,31 @@ pub const COMMANDS: &[Cmd] = &[ cmd!("respawn", Screens, "respawn", "respawn from the death screen", "", ["horizon-ctl respawn"], &[], mcp: true, local: false), cmd!("pause", Screens, "pause", "open the pause menu", "", ["horizon-ctl pause"], &[], mcp: true, local: false), cmd!("resume", Screens, "resume", "leave the pause menu", "", ["horizon-ctl resume"], &[], mcp: true, local: false), + cmd!("options", Screens, "options [PAGE]", "open the options screen, or one of its pages (Horizon's too)", + "Then ui lists its widgets and click, set and type change them, as with the mouse. options-set changes an options.txt value without the screen.", + ["horizon-ctl options video", "horizon-ctl options horizon"], &[opt("page", PAGES, "the page (default: the main options)")], mcp: true, local: false), + cmd!("book", Screens, "book [next|back|take|done]", "the open book or lectern: its page text, or press one of its buttons", + "", ["horizon-ctl book", "horizon-ctl book next"], &[opt("action", Ty::Enum(&["next", "back", "take", "done"]), "a button to press")], mcp: true, local: false), + cmd!("signedit", Screens, "signedit X Y Z [front|back]", "open the sign editor of the sign at X Y Z (then type and close)", + "", ["horizon-ctl signedit 3 64 1"], &[BLOCK_XYZ[0], BLOCK_XYZ[1], BLOCK_XYZ[2], opt("side", Ty::Enum(&["front", "back"]), "which side")], mcp: true, local: false), + cmd!("mount-menu", Screens, "mount-menu", "open the inventory of the horse, donkey, mule or llama being ridden", + "As the inventory key does while riding; also opens the nearest one's.", ["horizon-ctl mount-menu"], &[], mcp: true, local: false), cmd!("chat-log", Screens, "chat-log [N]", "the newest N chat messages", "", ["horizon-ctl chat-log 5"], &[], mcp: false, local: false), + // Multiplayer + cmd!("connect", Multiplayer, "connect ADDRESS [NAME]", "join a multiplayer server, or a friend's world by its invite code, from the title screen", + "ADDRESS is HOST[:PORT], or friend:CODE for an invite code. Only when the player asks: it reaches the network.", + ["horizon-ctl connect play.example.net", "horizon-ctl connect localhost:25565", "horizon-ctl connect friend:0B33K-Q405Q-..."], + &[p("address", Ty::Str, "HOST[:PORT] or friend:CODE"), opt("name", Ty::Str, "player name when offline")], mcp: true, local: false), + cmd!("disconnect", Multiplayer, "disconnect", "leave the server, back to the server list", "", ["horizon-ctl disconnect"], &[], mcp: true, local: false), + cmd!("servers", Multiplayer, "servers", "the Multiplayer screen's server list: name and address", + "Add, edit and remove them on the Multiplayer screen (click-button Multiplayer, then ui).", ["horizon-ctl servers"], &[], mcp: true, local: false), + cmd!("lan", Multiplayer, "lan open [PORT] [commands] [force] | lan close | lan status", "open the world to LAN (Open to LAN), stop, or see the guests", + "PORT 0 or none picks one; commands lets guests use cheats; force forces the game mode. Only when the player asks.", + ["horizon-ctl lan open", "horizon-ctl lan status", "horizon-ctl lan close"], + &[p("action", Ty::Enum(&["open", "close", "status"]), "what to do"), opt("port", Ty::Int, "port for open"), opt("commands", Ty::Bool, "allow cheats"), opt("force", Ty::Bool, "force the game mode")], mcp: true, local: false), + cmd!("friends", Multiplayer, "friends host|stop|status", "Play with Friends: share the open world behind an invite code, stop, or see who joined", + "status gives the code: share it only when the player asks. Friends join with connect friend:CODE.", + ["horizon-ctl friends host", "horizon-ctl friends status"], &[p("action", Ty::Enum(&["host", "stop", "status"]), "what to do")], mcp: true, local: false), // World cmd!("give", World, "give ITEM [COUNT]", "add items to the inventory", "", ["horizon-ctl give oak_log 16"], &[p("item", Ty::Str, "item id"), opt("count", Ty::Int, "how many (default 1)")], mcp: true, local: false), @@ -325,8 +410,20 @@ pub const COMMANDS: &[Cmd] = &[ &[p("ticks", Ty::Int, "day time")], mcp: true, local: false), cmd!("setblock", World, "setblock X Y Z BLOCK[props]", "set a block (with neighbour updates)", "", ["horizon-ctl setblock 0 64 0 stone"], &[BLOCK_XYZ[0], BLOCK_XYZ[1], BLOCK_XYZ[2], p("block", Ty::Str, "block state such as oak_stairs[facing=east]")], mcp: true, local: false), - cmd!("summon", World, "summon KIND [X Y Z] [baby]", "spawn a mob", "", ["horizon-ctl summon cow"], &[p("kind", Ty::Str, "mob type")], mcp: true, local: false), - cmd!("effect", World, "effect ID SECONDS [AMPLIFIER] | effect clear", "give a status effect", "", ["horizon-ctl effect speed 30 1"], &[], mcp: false, local: false), + cmd!("summon", World, "summon KIND [X Y Z] [baby]", "spawn a mob (in front of the player without a position)", "Replies with its id.", ["horizon-ctl summon cow", "horizon-ctl summon pig 10 64 3 baby"], + &[p("kind", Ty::Str, "mob type"), opt("x", Ty::Num, "X"), opt("y", Ty::Num, "Y"), opt("z", Ty::Num, "Z"), opt("baby", Ty::Bool, "a baby")], mcp: true, local: false), + cmd!("effect", World, "effect ID SECONDS [AMPLIFIER] | effect clear", "give a status effect, or clear them all", "", ["horizon-ctl effect speed 30 1", "horizon-ctl effect clear"], + &[p("id", Ty::Str, "effect id such as speed, or clear"), opt("seconds", Ty::Num, "duration"), opt("amplifier", Ty::Int, "level - 1 (default 0)")], mcp: true, local: false), + cmd!("effects", World, "effects", "the player's active status effects", "", ["horizon-ctl effects"], &[], mcp: true, local: false), + cmd!("xp", World, "xp LEVELS", "add experience levels (negative removes)", "", ["horizon-ctl xp 30"], &[p("levels", Ty::Int, "levels to add")], mcp: true, local: false), + cmd!("enchant", World, "enchant ID LEVEL", "enchant the held item (a book stores it)", "", ["horizon-ctl enchant sharpness 5"], + &[p("id", Ty::Str, "enchantment id"), p("level", Ty::Int, "level")], mcp: true, local: false), + cmd!("potion", World, "potion ITEM POTION", "give a potion item", "", ["horizon-ctl potion splash_potion healing"], + &[p("item", Ty::Enum(&["potion", "splash_potion", "lingering_potion", "tipped_arrow"]), "which item"), p("potion", Ty::Str, "potion id")], mcp: true, local: false), + cmd!("fill", World, "fill X1 Y1 Z1 X2 Y2 Z2 BLOCK", "set a box of loaded blocks", "", ["horizon-ctl fill 0 64 0 4 64 4 glass"], + &[BOX[0], BOX[1], BOX[2], BOX[3], BOX[4], BOX[5], p("block", Ty::Str, "block state")], mcp: true, local: false), + cmd!("container", World, "container X Y Z [ITEM COUNT]", "list a container's items, or add items to it", "", ["horizon-ctl container 3 64 1", "horizon-ctl container 3 64 1 diamond 3"], + &[BLOCK_XYZ[0], BLOCK_XYZ[1], BLOCK_XYZ[2], opt("item", Ty::Str, "item to add"), opt("count", Ty::Int, "how many")], mcp: true, local: false), cmd!("render-distance", World, "render-distance N", "chunks, 2..64", "", ["horizon-ctl render-distance 8"], &[p("chunks", Ty::Int, "render distance")], mcp: false, local: false), cmd!("wait", World, "wait TICKS", "wait until TICKS game ticks have passed (20 per second)", "Keys and mouse buttons held with key ... down or mouse ... down stay held while it waits. Release them with key ... up, release or stop.", @@ -340,8 +437,8 @@ pub const COMMANDS: &[Cmd] = &[ cmd!("mcp", Scripting, "mcp", "serve the Model Context Protocol on stdin/stdout, one tool per command", "Add it to an MCP client as a stdio server: command horizon-ctl, args [\"mcp\"] (with --socket PATH first if needed). The screenshot tool returns the image.", ["horizon-ctl mcp"], &[], mcp: false, local: true), - cmd!("bench", Scripting, "bench SECONDS", "reset frame stats, wait, reply with the summary", "", ["horizon-ctl bench 10"], &[], mcp: false, local: false), - cmd!("stats", Scripting, "stats [reset]", "frame-time summary since the last reset", "", ["horizon-ctl stats"], &[], mcp: false, local: false), + cmd!("bench", Scripting, "bench SECONDS", "reset frame stats, wait, reply with the summary", "", ["horizon-ctl bench 10"], &[p("seconds", Ty::Num, "how long to measure")], mcp: true, local: false), + cmd!("stats", Scripting, "stats [reset]", "frame-time summary since the last reset", "", ["horizon-ctl stats"], &[opt("reset", Ty::Bool, "start counting again")], mcp: true, local: false), cmd!("fly", Scripting, "fly X1 Y1 Z1 X2 Y2 Z2 SECONDS [PITCH [raw]]", "fly the camera along a line, then reply with the frame summary", "The reply's tick_ms and tick_ms_max are the world's smoothed tick time over the flight (the server thread's when single player runs on one). With raw, the reply also lists every frame time in milliseconds (frame_ms).", ["horizon-ctl fly 0 100 0 500 100 0 20"], &[], mcp: false, local: false), @@ -402,6 +499,73 @@ pub fn detail(c: &Cmd) -> String { out } +/// The generated reference, docs/horizon-ctl-commands.md (`horizon-ctl help --markdown`). +pub fn markdown() -> String { + let cell = |s: &str| s.replace('|', "\\|"); + let mut out = String::from( + "\n\ + # horizon-ctl commands\n\n\ + Every command `horizon-ctl` takes, its MCP tool in `horizon-ctl mcp` (the launcher's \ + `horizon-launcher mcp` offers the same tools as `game_`, all but `launch`) and its \ + arguments. Positional arguments come first, in order; `--flags` after them. \ + `horizon-ctl help --game` lists the game's own commands, test hooks included. \ + Design rules and the full inventory: [agent-control.md](agent-control.md).\n", + ); + for group in Group::ALL { + out.push_str(&format!( + "\n## {}\n\n| Command | MCP tool | What it does | Arguments |\n| --- | --- | --- | --- |\n", + group.title() + )); + for c in COMMANDS.iter().filter(|c| c.group == group) { + let tool = if c.mcp { + let mut t = format!("`{}`", tool_name(c)); + if DESTRUCTIVE.contains(&c.name) { + t.push_str(" (destructive)"); + } else if OPEN_WORLD.contains(&c.name) { + t.push_str(" (network)"); + } + t + } else { + "CLI only".to_owned() + }; + let args: Vec = c + .params + .iter() + .map(|p| { + let ty = match p.ty { + Ty::Int => "integer".to_owned(), + Ty::Num => "number".to_owned(), + Ty::Str => "string".to_owned(), + Ty::Rest => "text".to_owned(), + Ty::Bool => "boolean".to_owned(), + Ty::Enum(v) => v.join(", "), + }; + let name = if p.flag { + format!("--{}", p.name) + } else { + p.name.to_owned() + }; + let need = if p.required { ", required" } else { "" }; + format!("`{name}` ({ty}{need}): {}", cell(p.help)) + }) + .collect(); + out.push_str(&format!( + "| `{}` | {} | {} | {} |\n", + cell(c.usage), + tool, + cell(&capitalize(c.summary)), + if args.is_empty() { + "none".to_owned() + } else { + args.join("
    ") + } + )); + } + } + out +} + fn capitalize(s: &str) -> String { let mut chars = s.chars(); chars @@ -640,6 +804,43 @@ mod tests { assert_eq!(tool_name(find("look-at-entity").unwrap()), "look_at_entity"); } + #[test] + fn the_generated_reference_is_up_to_date() { + let path = concat!( + env!("CARGO_MANIFEST_DIR"), + "/../../docs/horizon-ctl-commands.md" + ); + let on_disk = std::fs::read_to_string(path).unwrap_or_default(); + assert!( + on_disk == markdown(), + "docs/horizon-ctl-commands.md is out of date: run `horizon-ctl help --markdown > docs/horizon-ctl-commands.md`" + ); + for c in COMMANDS { + assert!( + on_disk.contains(&format!("`{}", c.usage.replace('|', "\\|"))), + "{} undocumented", + c.name + ); + } + } + + #[test] + fn destructive_and_network_tools_exist() { + for name in DESTRUCTIVE.iter().chain(OPEN_WORLD) { + assert!(find(name).is_some_and(|c| c.mcp), "{name}"); + } + let delete = find("world-delete").unwrap(); + assert_eq!( + line_for(delete, &json!({ "folder": "A", "confirm": true })).unwrap(), + ["world-delete", "A", "--confirm"] + ); + let lan = find("lan").unwrap(); + assert_eq!( + line_for(lan, &json!({ "action": "open", "commands": true })).unwrap(), + ["lan", "open", "commands"] + ); + } + #[test] fn help_mentions_every_command() { let text = overview(); diff --git a/crates/horizon-client/src/bin/horizon-ctl/main.rs b/crates/horizon-client/src/bin/horizon-ctl/main.rs index 27d9d5ba1..9c2cab8fa 100644 --- a/crates/horizon-client/src/bin/horizon-ctl/main.rs +++ b/crates/horizon-client/src/bin/horizon-ctl/main.rs @@ -183,6 +183,18 @@ impl Session { thread::sleep(Duration::from_secs_f64(seconds.max(0.0))); self.game(&format!("key {key} up")) } + "interact-entity" => { + let id = match words { + [_, id] if id.parse::().is_ok() => id, + _ => return Err(Failure::usage(format!("usage: {}", usage(name)))), + }; + self.game(&format!("look-at entity {id}"))?; + self.game("mouse right click")?; + self.game("wait 2")?; + let mut screen = self.game("screen")?; + screen["ok"] = json!(true); + Ok(screen) + } "logs" => logs(&horizon_client::logging::game_home(), &words[1..]), "wait-ready" => { let limit = if words.len() > 1 { @@ -417,6 +429,10 @@ fn main() -> ExitCode { print!("{}", commands::overview()); 0 } + Some("help") if args.get(1).is_some_and(|a| a == "--markdown") => { + print!("{}", commands::markdown()); + 0 + } Some("help") if args.get(1).is_none_or(|a| a != "--game") => match args.get(1) { None => { print!("{}", commands::overview()); diff --git a/crates/horizon-client/src/bin/horizon-ctl/mcp.rs b/crates/horizon-client/src/bin/horizon-ctl/mcp.rs index 8d67953a5..ae30b7498 100644 --- a/crates/horizon-client/src/bin/horizon-ctl/mcp.rs +++ b/crates/horizon-client/src/bin/horizon-ctl/mcp.rs @@ -23,7 +23,13 @@ fn tools() -> Vec { schema = json!({ "type": "object", "properties": {} }); description = "Capture the game window and return it as a PNG image.".into(); } - json!({ "name": commands::tool_name(c), "description": description, "inputSchema": schema }) + let mut tool = json!({ "name": commands::tool_name(c), "description": description, "inputSchema": schema }); + if commands::DESTRUCTIVE.contains(&c.name) { + tool["annotations"] = json!({ "destructiveHint": true }); + } else if commands::OPEN_WORLD.contains(&c.name) { + tool["annotations"] = json!({ "openWorldHint": true }); + } + tool }) .collect() } diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index ce9183cac..d43b04cac 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -126,6 +126,7 @@ mod remote_vehicles; mod render_control; mod render_tick; mod respawn_anchor; +mod saves_control; mod saving; mod scoreboard; mod screens; diff --git a/crates/horizon-client/src/game/control.rs b/crates/horizon-client/src/game/control.rs index 6c5eec301..d25cb21ce 100644 --- a/crates/horizon-client/src/game/control.rs +++ b/crates/horizon-client/src/game/control.rs @@ -165,6 +165,9 @@ impl Game<'_> { if let Some(value) = self.events_command(&words, reply)? { return Ok(value); } + if let Some(value) = self.saves_control(&words, line, reply)? { + return Ok(value); + } if let Some(value) = self.options_control(&words, line)? { return Ok(Some(value)); } @@ -192,6 +195,7 @@ impl Game<'_> { .chain(super::ui_control::HELP) .chain(super::options::CONTROL_HELP) .chain(super::events::HELP) + .chain(super::saves_control::HELP) .chain(super::pad::HELP) .collect::>() }))), "setblock" | "fill" | "particle" | "signedit" => self.render_command(&words), diff --git a/crates/horizon-client/src/game/saves_control.rs b/crates/horizon-client/src/game/saves_control.rs new file mode 100644 index 000000000..5c0f0c6fa --- /dev/null +++ b/crates/horizon-client/src/game/saves_control.rs @@ -0,0 +1,123 @@ +//! Worlds and the multiplayer server list from the control socket: what the Select World, Edit +//! World and Multiplayer screens do, by world folder. Changing a world needs the title screen +//! (no world open), as those screens do; deleting one needs `--confirm`. +use super::Game; +use horizon_client::{Result, title}; +use serde_json::{Value, json}; +use std::{path::PathBuf, sync::mpsc::Sender, time::UNIX_EPOCH}; + +pub(super) const HELP: &[&str] = &[ + "worlds the saved worlds, newest first: folder, name, mode, last played, version", + "world-rename FOLDER NAME rename a world (Edit World; its folder stays)", + "world-backup FOLDER zip a world into backups/ (Edit World > Make Backup)", + "world-delete FOLDER --confirm delete a world for good (Select World > Delete)", + "servers the multiplayer server list (servers.dat): name and address", +]; + +fn saves() -> Result { + Ok(std::env::current_dir()?.join("saves")) +} + +impl Game<'_> { + /// Some(reply) for these commands (Some(None): the reply comes later), None for others. + pub(super) fn saves_control( + &mut self, + words: &[&str], + line: &str, + reply: &Sender, + ) -> Result>> { + let folder = || { + words + .get(1) + .copied() + .ok_or_else(|| format!("{} FOLDER: the folder from worlds", words[0])) + }; + let on_title = || { + if self.title.is_some() { + Ok(()) + } else { + Err(format!( + "{} needs the title screen: save and leave the world first (pause, then Save and Quit to Title)", + words[0] + )) + } + }; + let value = match words[0] { + "worlds" => { + let worlds: Vec = title::list_worlds(&saves()?) + .iter() + .map(|w| { + json!({ + "folder": w.folder, + "name": w.name, + "mode": if w.creative { "creative" } else { "survival" }, + "last_played": w.modified.duration_since(UNIX_EPOCH).map_or(0, |d| d.as_millis() as u64), + "commands": w.commands, + "version": w.version, + }) + }) + .collect(); + json!({ "worlds": worlds }) + } + "world-rename" => { + on_title()?; + let folder = folder()?; + let name = line + .trim_start() + .strip_prefix("world-rename") + .and_then(|rest| rest.trim_start().strip_prefix(folder)) + .map(str::trim) + .filter(|n| !n.is_empty()) + .ok_or("world-rename FOLDER NAME: missing the new name")?; + title::world_management::rename(&saves()?, folder, name)?; + if let Some(title) = self.title.as_mut() { + title.worlds_changed(); + } + json!({ "ok": true, "folder": folder, "name": name }) + } + "world-delete" => { + on_title()?; + let folder = folder()?; + if !words.contains(&"--confirm") { + return Err(format!( + "world-delete deletes {folder} for good: ask the player, then add --confirm" + ) + .into()); + } + title::world_management::delete(&saves()?, folder)?; + if let Some(title) = self.title.as_mut() { + title.worlds_changed(); + } + json!({ "ok": true, "deleted": folder }) + } + "world-backup" => { + on_title()?; + let folder = folder()?.to_owned(); + let saves = saves()?; + let backups = title::world_management::backups_path(&saves); + // A big world takes a while to zip: off the game thread, as Make Backup does. + let reply = reply.clone(); + std::thread::spawn(move || { + let answer = match title::world_management::backup(&saves, &folder) { + Ok(bytes) => { + json!({ "ok": true, "folder": folder, "backups": backups, "bytes": bytes }) + } + Err(e) => json!({ "error": format!("backup of {folder} failed: {e}") }), + }; + let _ = reply.send(answer.to_string()); + }); + return Ok(Some(None)); + } + "servers" => { + let file = horizon_client::multiplayer::servers_file(&saves()?); + let servers: Vec = horizon_protocol::servers::load(&file) + .iter() + .map(|s| json!({ "name": s.name, "address": s.ip })) + .collect(); + json!({ "servers": servers }) + } + _ => return Ok(None), + }; + Ok(Some(Some(value))) + } +} diff --git a/crates/horizon-client/src/title.rs b/crates/horizon-client/src/title.rs index 8a04df67e..b4958c600 100644 --- a/crates/horizon-client/src/title.rs +++ b/crates/horizon-client/src/title.rs @@ -15,7 +15,7 @@ use std::{ mod create_world; #[cfg(test)] mod tests; -mod world_management; +pub mod world_management; pub use create_world::{DIFFICULTIES, WorldOptions}; /// SelectWorldScreen's `HeaderAndFooterLayout(8 + 9 + 8 + 20 + 4, 60)`. @@ -500,6 +500,14 @@ impl Title { } } /// The worlds, newest first, cached for two seconds (drawn every frame). + /// Saves changed behind the screens' back (agent control renamed or deleted a world): the + /// list shows them again. + pub fn worlds_changed(&mut self) { + if matches!(self.mode, Mode::Select { .. }) { + self.return_to_list(None); + } + *self.recent.borrow_mut() = None; + } pub fn recent_worlds(&self) -> Vec { let mut recent = self.recent.borrow_mut(); match &*recent { diff --git a/crates/horizon-client/src/title/world_management.rs b/crates/horizon-client/src/title/world_management.rs index d5fc9bc58..abdd35505 100644 --- a/crates/horizon-client/src/title/world_management.rs +++ b/crates/horizon-client/src/title/world_management.rs @@ -23,7 +23,7 @@ fn world_path(saves: &Path, folder: &str) -> crate::Result { Ok(path) } -pub(super) fn rename(saves: &Path, folder: &str, name: &str) -> crate::Result<()> { +pub fn rename(saves: &Path, folder: &str, name: &str) -> crate::Result<()> { let path = world_path(saves, folder)?.join("level.dat"); let mut root = read_dat(&path).ok_or("Could not read level.dat")?; let Some(Tag::Compound(data)) = root.get_mut("Data") else { @@ -45,7 +45,7 @@ pub(super) fn reset_icon(saves: &Path, folder: &str) -> crate::Result<()> { /// file briefly held by a virus scanner, say) is retried up to five times, /// half a second apart, as vanilla does. Only the named folder directly in /// `saves` is touched: symbolic links inside it are removed, never followed. -pub(super) fn delete(saves: &Path, folder: &str) -> crate::Result<()> { +pub fn delete(saves: &Path, folder: &str) -> crate::Result<()> { let world = world_path(saves, folder)?; let lock = crate::save::SessionLock::acquire(&world)?; let lock_path = world.join("session.lock"); @@ -86,7 +86,7 @@ fn remove_contents(world: &Path, lock: &Path) -> io::Result<()> { Ok(()) } -pub(super) fn backups_path(saves: &Path) -> PathBuf { +pub fn backups_path(saves: &Path) -> PathBuf { saves.parent().unwrap_or(saves).join("backups") } @@ -112,7 +112,7 @@ pub(super) fn open_folder(path: &Path) -> crate::Result<()> { Ok(()) } -pub(super) fn backup(saves: &Path, folder: &str) -> crate::Result { +pub fn backup(saves: &Path, folder: &str) -> crate::Result { let world = world_path(saves, folder)?; let backups = backups_path(saves); fs::create_dir_all(&backups)?; diff --git a/docs/horizon-ctl-commands.md b/docs/horizon-ctl-commands.md new file mode 100644 index 000000000..c53016824 --- /dev/null +++ b/docs/horizon-ctl-commands.md @@ -0,0 +1,140 @@ + +# horizon-ctl commands + +Every command `horizon-ctl` takes, its MCP tool in `horizon-ctl mcp` (the launcher's `horizon-launcher mcp` offers the same tools as `game_`, all but `launch`) and its arguments. Positional arguments come first, in order; `--flags` after them. `horizon-ctl help --game` lists the game's own commands, test hooks included. Design rules and the full inventory: [agent-control.md](agent-control.md). + +## Session + +| Command | MCP tool | What it does | Arguments | +| --- | --- | --- | --- | +| `launch [--world NAME] [--seed N] [--creative] [--version TAG] [--game PATH] [--wait] [GAME ARGS...]` | `launch` | Start Horizon with the control socket and wait until it answers | `--world` (string): world folder to open or create
    `--seed` (string): seed for a new world
    `--creative` (boolean): creative mode for a new world
    `--version` (string): an installed launcher version tag such as v2026.10.13
    `--game` (string): path to a horizon-client binary
    `--wait` (boolean): also wait until the world is ready (default in MCP)
    `--offscreen` (boolean): render without showing a window (screenshots still work): locked or headless sessions | +| `wait-for screen NAME\|widget ID\|loaded\|chat TEXT\|event KIND [--timeout S] [--since SEQ]` | `wait_for` | Wait until the game reaches a state, then reply | `--timeout` (number): seconds (default 30)
    `--since` (integer): chat and event: count from this event seq
    `condition` (screen, widget, loaded, chat, event, required): what to wait for
    `value` (text): the screen name, widget id, chat text or event kind | +| `wait-ready [SECONDS]` | `wait_ready` | Wait until the player has spawned and no chunks are pending | `seconds` (number): how long to wait (default 120) | +| `logs [--lines N] [--crash]` | `logs` | The end of the game's log, or its newest crash report | `--lines` (integer): how many lines of latest.log (default 100)
    `--crash` (boolean): the newest crash report instead | +| `status` | `status` | Game, renderer and streaming state (the scripting socket's original summary) | none | +| `worlds` | `worlds` | The saved worlds, newest first: folder, name, mode, last played, version | none | +| `world-rename FOLDER NAME` | `world_rename` | Rename a world, as Edit World does (its folder stays) | `folder` (string, required): world folder from worlds
    `name` (text, required): the new name | +| `world-backup FOLDER` | `world_backup` | Zip a world into backups/, as Edit World's Make Backup does | `folder` (string, required): world folder from worlds | +| `world-delete FOLDER --confirm` | `world_delete` (destructive) | Delete a world for good, as Select World's Delete does | `folder` (string, required): world folder from worlds
    `--confirm` (boolean, required): true once the player agreed: it cannot be undone | +| `open WORLD [SEED] [creative]` | `open` | Open or create a world from the title screen | `world` (string, required): world folder
    `seed` (integer): seed for a new world
    `mode` (creative): creative for a creative world | +| `save` | `save` | Save the world | none | +| `quit` | `quit` | Save and exit the game | none | +| `screenshot PATH` | `screenshot` | Write the next rendered frame as a PNG | none | + +## Observe (JSON state) + +| Command | MCP tool | What it does | Arguments | +| --- | --- | --- | --- | +| `events [--since SEQ]` | `events` | What happened since SEQ, oldest first: screens, chat, deaths, respawns, items gained or lost, dimensions, worlds | `--since` (integer): only events after this seq | +| `state` | `state` | Player, world, screen and crosshair target in one reply | none | +| `looking-at` | `looking_at` | The block or entity under the crosshair | none | +| `entities [RADIUS] [TYPE]` | `entities` | Mobs, dropped items and experience orbs near the player, nearest first | `radius` (number): search radius in blocks (default 32)
    `type` (string): entity type filter | +| `block X Y Z` | `block` | The block state at a position | `x` (integer, required): block X
    `y` (integer, required): block Y
    `z` (integer, required): block Z | +| `light X1 Y1 Z1 X2 Y2 Z2` | `light` | The stored sky and block light of a box | `x1` (integer, required): corner X
    `y1` (integer, required): corner Y
    `z1` (integer, required): corner Z
    `x2` (integer, required): opposite X
    `y2` (integer, required): opposite Y
    `z2` (integer, required): opposite Z | +| `blocks X1 Y1 Z1 X2 Y2 Z2` | `blocks` | The non-air blocks of a box, with counts per block | `x1` (integer, required): corner X
    `y1` (integer, required): corner Y
    `z1` (integer, required): corner Z
    `x2` (integer, required): opposite X
    `y2` (integer, required): opposite Y
    `z2` (integer, required): opposite Z | +| `find-block BLOCK [RADIUS]` | `find_block` | The nearest loaded blocks of a kind | `block` (string, required): block id such as oak_log
    `radius` (integer): search radius (default 32) | +| `inventory` | `inventory` | Hotbar, main inventory, armor, offhand, carried stack and item counts | none | +| `screen` | `screen` | The open screen or title menu, its buttons and its slots | none | +| `messages [N]` | `messages` | Recent chat and system messages, the title and the action bar | `n` (integer): how many chat lines (default 20) | +| `menu` | CLI only | The open menu's slots and carried stack, with station details | none | + +## Move and look + +| Command | MCP tool | What it does | Arguments | +| --- | --- | --- | --- | +| `move forward\|back\|left\|right SECONDS [--sprint] [--sneak] [--jump]` | `move` | Walk in a direction relative to the view for a time | `direction` (forward, back, left, right, required): direction relative to the view
    `seconds` (number, required): how long to walk
    `--sprint` (boolean): sprint
    `--sneak` (boolean): sneak
    `--jump` (boolean): keep jumping | +| `goto X Y Z [--near R] [--sprint] [--direct] [--timeout S]` | `goto` | Walk to a position, finding a path through loaded terrain | `x` (number, required): X coordinate
    `y` (number, required): Y coordinate
    `z` (number, required): Z coordinate
    `--near` (number): arrive within this many blocks (default 0.6)
    `--sprint` (boolean): sprint
    `--direct` (boolean): walk straight when no path is found
    `--timeout` (number): give up after this many seconds (default 60) | +| `jump` | `jump` | Jump once and reply when landed | none | +| `look YAW PITCH` | `look` | Set the view direction in degrees | `yaw` (number, required): yaw in degrees
    `pitch` (number, required): pitch in degrees (-90 up .. 90 down) | +| `turn DYAW DPITCH [--over S]` | `turn` | Rotate the view by an amount | `dyaw` (number, required): yaw change in degrees
    `dpitch` (number, required): pitch change in degrees
    `--over` (number): turn with mouse motion spread over this many seconds (eased), as a player would | +| `mouse-move DX DY` | `mouse_move` | Move the mouse: relative motion that turns the view like a player's mouse | `dx` (number, required): horizontal motion (positive turns right)
    `dy` (number, required): vertical motion (positive looks down) | +| `look-at X Y Z \| look-at block X Y Z [FACE] \| look-at entity ID [--over S]` | `look_at` | Turn to face a point, a block (a visible face of it) or an entity | `x` (number, required): X coordinate
    `y` (number, required): Y coordinate
    `z` (number, required): Z coordinate
    `--over` (number): turn with mouse motion spread over this many seconds (eased), as a player would | +| `look-at-block X Y Z [FACE] [--over S]` | `look_at_block` | Aim the crosshair at a block (same as look-at block) | `x` (integer, required): block X
    `y` (integer, required): block Y
    `z` (integer, required): block Z
    `face` (down, up, north, south, west, east): which face to aim at
    `--over` (number): turn with mouse motion spread over this many seconds (eased), as a player would | +| `look-at-entity ID [--over S]` | `look_at_entity` | Face an entity (same as look-at entity) | `id` (integer, required): entity id from entities
    `--over` (number): turn with mouse motion spread over this many seconds (eased), as a player would | +| `tp X Y Z` | `tp` | Teleport the player | `x` (number, required): X coordinate
    `y` (number, required): Y coordinate
    `z` (number, required): Z coordinate | + +## Act on the world + +| Command | MCP tool | What it does | Arguments | +| --- | --- | --- | --- | +| `break X Y Z [--timeout S]` | `break` | Mine a block, holding the attack button until it breaks | `x` (integer, required): block X
    `y` (integer, required): block Y
    `z` (integer, required): block Z
    `--timeout` (number): give up after this many seconds (default 30) | +| `place X Y Z [--item ITEM]` | `place` | Place the held item (or ITEM from the hotbar) at an empty position | `x` (integer, required): block X
    `y` (integer, required): block Y
    `z` (integer, required): block Z
    `--item` (string): hotbar item to select first | +| `interact X Y Z [FACE]` | `interact` | Right-click a block: open a chest or crafting table, press a button, open a door | `x` (integer, required): block X
    `y` (integer, required): block Y
    `z` (integer, required): block Z
    `face` (down, up, north, south, west, east): which face to click | +| `use-item [--hold SECONDS]` | `use_item` | Right-click with the held item: eat, drink, throw, draw a bow | `--hold` (number): hold the button this long | +| `attack [ID]` | `attack` | Swing at what the crosshair targets (after facing entity ID) | `id` (integer): entity id to face first | +| `select SLOT\|ITEM` | `select` | Select a hotbar slot 1-9, or the hotbar slot holding ITEM | `slot` (string, required): 1-9 or an item id | +| `drop [all]` | `drop` | Drop one of the held item, or the whole stack | `all` (boolean): drop the whole stack | +| `hold KEY SECONDS` | CLI only | Press a key, wait, release it | `key` (string, required): key name
    `seconds` (number, required): how long | +| `key KEY down\|up\|tap\|repeat` | `key` | Press, release or auto-repeat a key (w a s d space shift ctrl e q esc f3 1-9 arrows ...) | `key` (string, required): key name
    `action` (down, up, tap, repeat, required): what to do | +| `mouse left\|right\|middle down\|up\|click` | `mouse` | Press or release a mouse button in the world | `button` (left, right, middle, required): button
    `action` (down, up, click, required): what to do | +| `interact-entity ID` | `interact_entity` | Right-click an entity: trade with a villager, mount a horse, ride a boat, shear a sheep | `id` (integer, required): entity id from entities | +| `pad BUTTON down\|up\|tap \| pad stick left\|right X Y \| pad trigger left\|right V \| pad release \| pad status` | `pad` | A virtual controller: buttons, sticks and triggers as a real pad would send them | `what` (string, required): a button name, stick, trigger, release or status
    `a` (string): down\|up\|tap, or left\|right
    `b` (number): stick X or trigger value
    `c` (number): stick Y | +| `release` | `release` | Release every key and mouse button | none | +| `stop` | `stop` | Cancel the running action (goto, break...) and release every key | none | + +## Screens, menus and chat + +| Command | MCP tool | What it does | Arguments | +| --- | --- | --- | --- | +| `open-inventory` | `open_inventory` | Open the inventory screen (crafting grid 100-103, result 200) | none | +| `click-slot SLOT [right] [shift]` | `click_slot` | Click a slot of the open inventory or menu | `slot` (integer, required): slot id
    `right` (boolean): right-click
    `shift` (boolean): shift-click | +| `close` | `close` | Close the open menu and return to the game | none | +| `ui` | `ui` | Every widget of the open screen: id, kind, label, bounds, value | none | +| `click ID [right\|middle] [shift]` | `click` | Click a widget of ui by its id, as the mouse would | `id` (string, required): widget id from ui
    `right` (boolean): right-click
    `middle` (boolean): middle-click
    `shift` (boolean): shift-click (slots) | +| `set ID VALUE` | `set` | Move a slider of ui to VALUE (0..1), as a click on its track | `id` (string, required): slider id from ui
    `value` (number, required): 0..1 along the track | +| `options-get [KEY...]` | `options_get` | The game's options (options.txt) by key, with their type and range or choices | `keys` (text): option keys (default: all) | +| `options-set KEY VALUE` | `options_set` | Set one option, apply it at once and save options.txt, as the options screen does | `key` (string, required): option key from options-get
    `value` (text, required): the new value | +| `click-button LABEL` | `click_button` | Click a button of the open screen or title menu by its label | `label` (text, required): button label | +| `click-at X Y [right]` | `click_at` | Click at GUI pixel X Y of the window (screen gives button rectangles) | `x` (number, required): GUI x
    `y` (number, required): GUI y
    `right` (boolean): right-click | +| `drag-at [right] X Y X Y...` | `drag_at` | Press at the first GUI point, move through the others, release at the last | `points` (text, required): right, then GUI x y pairs | +| `scroll-at X Y STEPS` | `scroll_at` | Turn the mouse wheel at GUI pixel X Y (positive scrolls up) | `x` (number, required): GUI x
    `y` (number, required): GUI y
    `steps` (number, required): wheel steps | +| `type [--field name\|seed] [--replace] TEXT` | `type` | Type into the focused text field (chat box, world name, anvil, sign...) | `--field` (name, seed): create-world field to type into
    `--replace` (boolean): clear the field first
    `text` (text, required): text to type | +| `chat TEXT` | `chat` (network) | Send a chat line (or a /command) as if typed | `text` (text, required): message | +| `command TEXT` | `command` (network) | Run a command (the leading / is optional) | `command` (text, required): command line | +| `respawn` | `respawn` | Respawn from the death screen | none | +| `pause` | `pause` | Open the pause menu | none | +| `resume` | `resume` | Leave the pause menu | none | +| `options [PAGE]` | `options` | Open the options screen, or one of its pages (Horizon's too) | `page` (main, video, sound, controls, keybinds, controller, controller-binds, mouse, chat, accessibility, language, font, packs, mods, graphics, graphics-advanced, extras, horizon, shader-packs): the page (default: the main options) | +| `book [next\|back\|take\|done]` | `book` | The open book or lectern: its page text, or press one of its buttons | `action` (next, back, take, done): a button to press | +| `signedit X Y Z [front\|back]` | `signedit` | Open the sign editor of the sign at X Y Z (then type and close) | `x` (integer, required): block X
    `y` (integer, required): block Y
    `z` (integer, required): block Z
    `side` (front, back): which side | +| `mount-menu` | `mount_menu` | Open the inventory of the horse, donkey, mule or llama being ridden | none | +| `chat-log [N]` | CLI only | The newest N chat messages | none | + +## Multiplayer, LAN and friends + +| Command | MCP tool | What it does | Arguments | +| --- | --- | --- | --- | +| `connect ADDRESS [NAME]` | `connect` (network) | Join a multiplayer server, or a friend's world by its invite code, from the title screen | `address` (string, required): HOST[:PORT] or friend:CODE
    `name` (string): player name when offline | +| `disconnect` | `disconnect` | Leave the server, back to the server list | none | +| `servers` | `servers` | The Multiplayer screen's server list: name and address | none | +| `lan open [PORT] [commands] [force] \| lan close \| lan status` | `lan` (network) | Open the world to LAN (Open to LAN), stop, or see the guests | `action` (open, close, status, required): what to do
    `port` (integer): port for open
    `commands` (boolean): allow cheats
    `force` (boolean): force the game mode | +| `friends host\|stop\|status` | `friends` (network) | Play with Friends: share the open world behind an invite code, stop, or see who joined | `action` (host, stop, status, required): what to do | + +## World and cheats + +| Command | MCP tool | What it does | Arguments | +| --- | --- | --- | --- | +| `give ITEM [COUNT]` | `give` | Add items to the inventory | `item` (string, required): item id
    `count` (integer): how many (default 1) | +| `time TICKS` | `time` | Set the time of day (0 sunrise, 6000 noon, 13000 night) | `ticks` (integer, required): day time | +| `setblock X Y Z BLOCK[props]` | `setblock` (destructive) | Set a block (with neighbour updates) | `x` (integer, required): block X
    `y` (integer, required): block Y
    `z` (integer, required): block Z
    `block` (string, required): block state such as oak_stairs[facing=east] | +| `summon KIND [X Y Z] [baby]` | `summon` | Spawn a mob (in front of the player without a position) | `kind` (string, required): mob type
    `x` (number): X
    `y` (number): Y
    `z` (number): Z
    `baby` (boolean): a baby | +| `effect ID SECONDS [AMPLIFIER] \| effect clear` | `effect` | Give a status effect, or clear them all | `id` (string, required): effect id such as speed, or clear
    `seconds` (number): duration
    `amplifier` (integer): level - 1 (default 0) | +| `effects` | `effects` | The player's active status effects | none | +| `xp LEVELS` | `xp` | Add experience levels (negative removes) | `levels` (integer, required): levels to add | +| `enchant ID LEVEL` | `enchant` | Enchant the held item (a book stores it) | `id` (string, required): enchantment id
    `level` (integer, required): level | +| `potion ITEM POTION` | `potion` | Give a potion item | `item` (potion, splash_potion, lingering_potion, tipped_arrow, required): which item
    `potion` (string, required): potion id | +| `fill X1 Y1 Z1 X2 Y2 Z2 BLOCK` | `fill` (destructive) | Set a box of loaded blocks | `x1` (integer, required): corner X
    `y1` (integer, required): corner Y
    `z1` (integer, required): corner Z
    `x2` (integer, required): opposite X
    `y2` (integer, required): opposite Y
    `z2` (integer, required): opposite Z
    `block` (string, required): block state | +| `container X Y Z [ITEM COUNT]` | `container` | List a container's items, or add items to it | `x` (integer, required): block X
    `y` (integer, required): block Y
    `z` (integer, required): block Z
    `item` (string): item to add
    `count` (integer): how many | +| `render-distance N` | CLI only | Chunks, 2..64 | `chunks` (integer, required): render distance | +| `wait TICKS` | `wait` | Wait until TICKS game ticks have passed (20 per second) | `ticks` (integer, required): game ticks | + +## Scripting and benchmarks + +| Command | MCP tool | What it does | Arguments | +| --- | --- | --- | --- | +| `script [FILE] [--keep-going]` | CLI only | Run commands from FILE (or stdin), one per line | none | +| `sleep SECONDS` | CLI only | Wait (in scripts) | none | +| `mcp` | CLI only | Serve the Model Context Protocol on stdin/stdout, one tool per command | none | +| `bench SECONDS` | `bench` | Reset frame stats, wait, reply with the summary | `seconds` (number, required): how long to measure | +| `stats [reset]` | `stats` | Frame-time summary since the last reset | `reset` (boolean): start counting again | +| `fly X1 Y1 Z1 X2 Y2 Z2 SECONDS [PITCH [raw]]` | CLI only | Fly the camera along a line, then reply with the frame summary | none | diff --git a/tools/agent_control_e2e.py b/tools/agent_control_e2e.py index f4c7acaa9..46695e8c3 100644 --- a/tools/agent_control_e2e.py +++ b/tools/agent_control_e2e.py @@ -52,10 +52,13 @@ POSITIONAL = { 'click_button': ['label'], 'type': ['text'], 'wait': ['ticks'], 'wait_ready': ['seconds'], 'command': ['command'], 'look_at_block': ['x', 'y', 'z'], 'click': ['id'], 'set': ['id', 'value'], 'give': ['item', 'count'], 'options_get': ['keys'], 'options_set': ['key', 'value'], - 'wait_for': ['condition', 'value'], + 'wait_for': ['condition', 'value'], 'open': ['world', 'seed', 'mode'], 'select': ['slot'], + 'summon': ['kind', 'x', 'y', 'z'], 'interact_entity': ['id'], 'effect': ['id', 'seconds', 'amplifier'], + 'xp': ['levels'], 'options': ['page'], 'lan': ['action'], 'world_backup': ['folder'], + 'world_rename': ['folder', 'name'], 'world_delete': ['folder'], } # Booleans the game takes as bare words. -BARE = {'click_slot': ['right', 'shift'], 'click': ['right', 'middle', 'shift']} +BARE = {'click_slot': ['right', 'shift'], 'click': ['right', 'middle', 'shift'], 'summon': ['baby']} class Failed(Exception): @@ -567,8 +570,54 @@ def suggestions_scenario(d, out): return {'completions': len(cases)} +def manage_scenario(d, out): + # The commands that close the audit's gaps: status (F3), entities by right-click, effects and xp, + # LAN status, options pages by name, then from the title screen the worlds list, Make Backup, + # rename and a delete that needs the player's confirmation. + d('open', world='Manage', seed=7) + d('wait_for', condition='loaded', timeout=400) + assert d('status')['player'] is not None + d('give', item='bucket') + d('select', slot='bucket') + pos = d('state')['position'] + cow = d('summon', kind='cow', x=pos[0], y=pos[1], z=pos[2] + 2)['id'] + d('wait', ticks=5) + d('interact_entity', id=cow) + items = {s.get('item') for s in d('inventory')['hotbar'] if s} + assert 'minecraft:milk_bucket' in items, items + d('effect', id='speed', seconds=30, amplifier=1) + effects = json.dumps(d('effects')) + assert 'speed' in effects, effects + d('xp', levels=5) + assert d('lan', action='status') is not None + d('options', page='horizon') + assert 'graphics' in widgets(d), widgets(d).keys() + d('key', key='esc', action='tap') + d('pause') + d('click', id='save-and-quit-to-title') + d('wait_for', condition='screen', value='title', timeout=60) + worlds = {w['folder']: w for w in d('worlds')['worlds']} + assert worlds['Manage']['mode'] == 'survival', worlds + assert d('world_backup', folder='Manage')['bytes'] > 0 + assert (d.cwd / 'backups').is_dir() and any((d.cwd / 'backups').glob('*_Manage.zip')) + d('world_rename', folder='Manage', name='Renamed Base') + assert {w['folder']: w for w in d('worlds')['worlds']}['Manage']['name'] == 'Renamed Base' + try: + d('world_delete', folder='Manage') + raise AssertionError('deleted without --confirm') + except Failed as e: + assert 'confirm' in str(e), e + assert (d.cwd / 'saves/Manage').is_dir() + d('world_delete', folder='Manage', confirm=True) + assert not (d.cwd / 'saves/Manage').exists() + assert 'Manage' not in {w['folder'] for w in d('worlds')['worlds']} + assert d('servers')['servers'] == [] + return {'worlds': len(worlds)} + + SCENARIOS = {'survival': scenario, 'ui': ui_scenario, 'options': options_scenario, 'events': events_scenario, - 'consume': consume_scenario, 'pick': pick_scenario, 'suggestions': suggestions_scenario} + 'consume': consume_scenario, 'pick': pick_scenario, 'suggestions': suggestions_scenario, + 'manage': manage_scenario} def run(mode, ctl, out, resources, which='survival'): From a6e3fca1dd61deadd5667f4673c25021f61c0fe5 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 02:02:33 +0200 Subject: [PATCH 081/126] horizon-ctl: interact-entity beside hold, away from the logs arm Co-Authored-By: Claude Opus 5.5 --- .../horizon-client/src/bin/horizon-ctl/main.rs | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/crates/horizon-client/src/bin/horizon-ctl/main.rs b/crates/horizon-client/src/bin/horizon-ctl/main.rs index 9c2cab8fa..d743aa09b 100644 --- a/crates/horizon-client/src/bin/horizon-ctl/main.rs +++ b/crates/horizon-client/src/bin/horizon-ctl/main.rs @@ -174,15 +174,6 @@ impl Session { ready["launch"] = reply; Ok(ready) } - "hold" => { - let (key, seconds) = match words { - [_, key, _] => (key.clone(), number(2, "SECONDS")?), - _ => return Err(Failure::usage(format!("usage: {}", usage(name)))), - }; - self.game(&format!("key {key} down"))?; - thread::sleep(Duration::from_secs_f64(seconds.max(0.0))); - self.game(&format!("key {key} up")) - } "interact-entity" => { let id = match words { [_, id] if id.parse::().is_ok() => id, @@ -195,6 +186,15 @@ impl Session { screen["ok"] = json!(true); Ok(screen) } + "hold" => { + let (key, seconds) = match words { + [_, key, _] => (key.clone(), number(2, "SECONDS")?), + _ => return Err(Failure::usage(format!("usage: {}", usage(name)))), + }; + self.game(&format!("key {key} down"))?; + thread::sleep(Duration::from_secs_f64(seconds.max(0.0))); + self.game(&format!("key {key} up")) + } "logs" => logs(&horizon_client::logging::game_home(), &words[1..]), "wait-ready" => { let limit = if words.len() > 1 { From b62a866f39f951bad3ccfb003472d7e9ea91ee07 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 02:06:07 +0200 Subject: [PATCH 082/126] agent_control_e2e manage: the player's position is under player Co-Authored-By: Claude Opus 5.5 --- tools/agent_control_e2e.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tools/agent_control_e2e.py b/tools/agent_control_e2e.py index 46695e8c3..9b85c95fa 100644 --- a/tools/agent_control_e2e.py +++ b/tools/agent_control_e2e.py @@ -579,7 +579,7 @@ def manage_scenario(d, out): assert d('status')['player'] is not None d('give', item='bucket') d('select', slot='bucket') - pos = d('state')['position'] + pos = d('state')['player']['position'] cow = d('summon', kind='cow', x=pos[0], y=pos[1], z=pos[2] + 2)['id'] d('wait', ticks=5) d('interact_entity', id=cow) From 684ec5357e5ebf9475d00e27da61e9a62aee4c93 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 02:06:28 +0200 Subject: [PATCH 083/126] agent_control_e2e manage: close the options with close Co-Authored-By: Claude Opus 5.5 --- tools/agent_control_e2e.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tools/agent_control_e2e.py b/tools/agent_control_e2e.py index 9b85c95fa..c979911ab 100644 --- a/tools/agent_control_e2e.py +++ b/tools/agent_control_e2e.py @@ -592,7 +592,7 @@ def manage_scenario(d, out): assert d('lan', action='status') is not None d('options', page='horizon') assert 'graphics' in widgets(d), widgets(d).keys() - d('key', key='esc', action='tap') + d('close') d('pause') d('click', id='save-and-quit-to-title') d('wait_for', condition='screen', value='title', timeout=60) From ef792ec3b9c28bdc416d463b49fe8e751f3ebf59 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 02:01:57 +0200 Subject: [PATCH 084/126] Launcher MCP: every CLI command is a tool of the same name, plus settings and agent-config The MCP tools are generated from the CLI's clap definition (cli_tools.rs): mods_search is horizon-launcher mods search, with the same arguments, and a call runs that command with --json. So the mod browser, modpacks, hosted servers, settings, game arguments, data collection, desktop entry and the benchmark are all reachable, and new CLI commands become tools by themselves. Destructive ones need confirm: true and carry destructiveHint. The session keeps play, server (with server_command/log/stop), account_list and account_sign_in in-process, renamed after the CLI (launch_client is play; play takes join for an invite code). New CLI commands: settings [KEY VALUE] (selected version, folders, install-new-versions, opening animation) and agent-config, the MCP config for Claude Code, Codex, Cursor and any client. play takes --world and --creative. Under No AI, mcp and agent-config are hidden and refused. Co-Authored-By: Claude Opus 5.5 --- launcher/README.md | 40 +++-- launcher/src/agents.rs | 147 ++++++++++++++++ launcher/src/cli.rs | 153 ++++++++++++++++- launcher/src/cli_tools.rs | 339 +++++++++++++++++++++++++++++++++++++ launcher/src/game_tools.rs | 12 +- launcher/src/lib.rs | 1 + launcher/src/main.rs | 1 + launcher/src/mcp.rs | 266 +++++------------------------ tools/launcher_mcp_e2e.py | 39 +++-- 9 files changed, 737 insertions(+), 261 deletions(-) create mode 100644 launcher/src/agents.rs create mode 100644 launcher/src/cli_tools.rs diff --git a/launcher/README.md b/launcher/README.md index 6cfafe590..e12ed2439 100644 --- a/launcher/README.md +++ b/launcher/README.md @@ -174,27 +174,35 @@ scripts and tests). ## AI agents (MCP) -`horizon-launcher mcp` is a Model Context Protocol server over stdio. To use it from Claude Code: +`horizon-launcher mcp` is a Model Context Protocol server over stdio. `horizon-launcher +agent-config` prints the config for Claude Code, Codex, Cursor and any MCP client, and the +command that adds it; for Claude Code: - claude mcp add horizon -- horizon-launcher mcp + claude mcp add --scope user horizon -- horizon-launcher mcp -(with the full path to the binary if it is not on your `PATH`). Its tools: `list_versions`, -`install_version`, `remove_version`, `prepare_resources`, `launch_client`, `start_server`, -`server_command`, `server_log`, `stop_server`, `patch_notes`, `links`, `update_channel`, `logs`, -`check_updates`, `accounts`, `sign_in` (returns the link and code for the player; the sign-in -finishes in the background), `sign_out`, `select_account`, and for data collection -`data_collection`, `set_data_collection`, `data_preview`, `delete_my_data` and `report_bug` -(only with the player's say-so). -A server started through MCP stops (cleanly, with `stop`) when the session ends. Starting one -needs `accept_eula`, which an agent should only pass with the player's consent. +(with the full path to the binary if it is not on your `PATH`). Every CLI command is a tool of the +same name and arguments, generated from the CLI's definition (`src/cli_tools.rs`): `versions`, +`install`, `remove`, `prepare`, `settings`, `mods_search`, `mods_install`, `modpack_import`, +`servers_create`, `data_status`... A call runs that command with `--json` and returns its +output. Tools that delete something (`remove`, `mods_remove`, `modpack_remove`, +`servers_forget`, `account_sign_out`, `data_delete`) need `confirm: true`. The session runs a few +itself, under the CLI's names: `play`, `server` with `server_command`, `server_log` and +`server_stop`, `account_list` and `account_sign_in` (returns the link and code for the player; +the sign-in finishes in the background). A server started through MCP stops (cleanly, with +`stop`) when the session ends. Starting one needs `accept_eula`, which an agent should only pass +with the player's consent. -The same server also plays the game: `launch_client` starts it with a local control socket -(`world`, `creative` and `offscreen` are optional), and every `horizon-ctl` tool of the selected +The same server also plays the game: `play` starts it with a local control socket (`world`, +`creative`, `join` and `offscreen` are optional), and every `horizon-ctl` tool of the selected version is offered as `game_`: `game_state`, `game_ui` (every widget of the open screen), `game_click`, `game_goto`, `game_break`, `game_inventory`, `game_screenshot` (an image) and the -rest of [horizon-ctl's commands](../docs/agent-control.md). The launcher runs that version's -`horizon-ctl mcp` and passes the calls through; while no game runs, they answer with an error -saying to call `launch_client`. +rest of [horizon-ctl's commands](../docs/horizon-ctl-commands.md). The launcher runs that +version's `horizon-ctl mcp` and passes the calls through; while no game runs, they answer with an +error saying to call `play`. + +`horizon-launcher no-ai on` (the Settings page's No AI switch) hides and turns off every AI +feature: `mcp` and `agent-config` refuse, the game opens no control socket and `horizon-ctl` +refuses. Every other command keeps working. The window, the command line and the MCP server all call the same core, `src/backend.rs`. diff --git a/launcher/src/agents.rs b/launcher/src/agents.rs new file mode 100644 index 000000000..8eba00125 --- /dev/null +++ b/launcher/src/agents.rs @@ -0,0 +1,147 @@ +//! Connecting an AI agent (docs/agent-control.md): the launcher's MCP server, `horizon-launcher +//! mcp`, as each common client wants it configured. `horizon-launcher agent-config` prints it and +//! the Settings page's "Connect an AI agent" shows it. Nothing here runs a client's command: the +//! window runs one only when the player clicks its button, and shows it first. +use serde_json::{json, Value}; +use std::path::Path; + +/// The name the server is added under in every client. +pub const SERVER_NAME: &str = "horizon"; + +pub struct Client { + /// `claude-code`, `codex`, `cursor` or `generic`. + pub id: &'static str, + pub name: &'static str, + /// Where its configuration lives. + pub file: &'static str, + /// What goes in that file. + pub config: String, + /// The client's own command that adds the server, when it has a CLI: (program, arguments). + pub add: Option<(&'static str, Vec)>, +} + +impl Client { + /// The add command as a shell line, to show and to copy. + pub fn add_line(&self) -> Option { + self.add + .as_ref() + .map(|(program, args)| shell_line(program, args)) + } +} + +/// The `mcpServers` JSON most clients read (Claude Code's .mcp.json, Cursor, Claude Desktop...). +fn mcp_servers_json(exe: &Path) -> String { + let config = json!({ "mcpServers": { SERVER_NAME: { "command": exe, "args": ["mcp"] } } }); + serde_json::to_string_pretty(&config).unwrap_or_default() +} + +/// A TOML basic string. +fn toml_string(s: &str) -> String { + format!("\"{}\"", s.replace('\\', "\\\\").replace('"', "\\\"")) +} + +/// The clients, for the launcher at `exe`. +pub fn clients(exe: &Path) -> Vec { + let exe_text = exe.display().to_string(); + let add = |args: &[&str]| -> Vec { + let mut words: Vec = args.iter().map(|s| (*s).to_owned()).collect(); + words.extend([exe_text.clone(), "mcp".into()]); + words + }; + vec![ + Client { + id: "claude-code", + name: "Claude Code", + file: "~/.claude.json (or .mcp.json in a project)", + config: mcp_servers_json(exe), + add: Some(( + "claude", + add(&["mcp", "add", "--scope", "user", SERVER_NAME, "--"]), + )), + }, + Client { + id: "codex", + name: "Codex", + file: "~/.codex/config.toml", + config: format!( + "[mcp_servers.{SERVER_NAME}]\ncommand = {}\nargs = [\"mcp\"]\n", + toml_string(&exe_text) + ), + add: Some(("codex", add(&["mcp", "add", SERVER_NAME, "--"]))), + }, + Client { + id: "cursor", + name: "Cursor", + file: "~/.cursor/mcp.json", + config: mcp_servers_json(exe), + add: None, + }, + Client { + id: "generic", + name: "Any MCP client", + file: "its MCP settings (a stdio server)", + config: mcp_servers_json(exe), + add: None, + }, + ] +} + +/// `program args...` quoted for a POSIX shell where a word needs it. +pub fn shell_line(program: &str, args: &[String]) -> String { + let quote = |w: &str| { + if !w.is_empty() + && w.chars() + .all(|c| c.is_ascii_alphanumeric() || "-_./:=@".contains(c)) + { + w.to_owned() + } else { + format!("'{}'", w.replace('\'', "'\\''")) + } + }; + std::iter::once(program) + .chain(args.iter().map(String::as_str)) + .map(quote) + .collect::>() + .join(" ") +} + +/// Everything `agent-config --json` prints. +pub fn json(exe: &Path) -> Value { + json!({ + "server": { "name": SERVER_NAME, "command": exe, "args": ["mcp"] }, + "clients": clients(exe).iter().map(|c| json!({ + "id": c.id, "name": c.name, "file": c.file, "config": c.config, "add": c.add_line(), + })).collect::>(), + }) +} + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn configs_name_the_launcher_and_quote_its_path() { + let exe = Path::new("/Applications/Horizon Launcher.app/Contents/MacOS/horizon-launcher"); + let all = clients(exe); + let claude = &all[0]; + assert_eq!( + claude.add_line().unwrap(), + "claude mcp add --scope user horizon -- '/Applications/Horizon Launcher.app/Contents/MacOS/horizon-launcher' mcp" + ); + let parsed: Value = serde_json::from_str(&claude.config).unwrap(); + assert_eq!(parsed["mcpServers"]["horizon"]["args"], json!(["mcp"])); + assert_eq!( + parsed["mcpServers"]["horizon"]["command"], + exe.display().to_string() + ); + let codex = &all[1]; + assert!(codex + .config + .contains("command = \"/Applications/Horizon Launcher.app")); + assert_eq!( + toml_string(r#"C:\Horizon\"x".exe"#), + r#""C:\\Horizon\\\"x\".exe""# + ); + assert!(all.iter().any(|c| c.id == "cursor" && c.add.is_none())); + } +} diff --git a/launcher/src/cli.rs b/launcher/src/cli.rs index 7ca348a3a..aba6c7ae1 100644 --- a/launcher/src/cli.rs +++ b/launcher/src/cli.rs @@ -253,6 +253,12 @@ enum Cmd { Play { #[arg(long)] version: Option, + /// Open or create this world (a folder under saves) at once + #[arg(long)] + world: Option, + /// Creative mode for a new world + #[arg(long)] + creative: bool, /// Join a friend's world with its invite code #[arg(long)] join: Option, @@ -288,6 +294,16 @@ enum Cmd { #[arg(value_parser = ["stable", "alpha"])] channel: Option, }, + /// Show the launcher's settings, or set one (the Settings page): selected-version TAG, + /// minecraft-dir PATH, server-dir PATH ("default" resets a folder), install-new-versions + /// on|off, opening-animation on|off + Settings { + #[arg(value_parser = SETTING_KEYS)] + key: Option, + /// The new value (with KEY) + #[arg(requires = "key")] + value: Option, + }, /// Show or set the extra arguments the game starts with (for example --server-thread); /// quotes group a word with spaces in it GameArgs { @@ -346,6 +362,13 @@ enum Cmd { /// Serve the Model Context Protocol on stdin and stdout, for AI agents (refused while No AI /// is on) Mcp, + /// How to connect an AI agent (Claude Code, Codex, Cursor, any MCP client) to `mcp`: the + /// config to paste and the command that adds it (refused while No AI is on) + AgentConfig { + /// Only this client + #[arg(long, value_parser = ["claude-code", "codex", "cursor", "generic"])] + client: Option, + }, /// Show or set No AI: on hides and turns off every AI feature (the companion, agent control, /// horizon-ctl and both MCP servers); off, the default, makes them available NoAi { @@ -362,12 +385,75 @@ enum Cmd { }, } +/// The CLI's definition, for the MCP tools generated from it (cli_tools.rs). +pub fn command() -> clap::Command { + ::command() +} + +/// The commands that exist for AI agents: hidden and refused while No AI is on. Every other +/// command stays: the launcher, packagers and scripts need them, and none drives the game. +pub const AI_COMMANDS: [&str; 2] = ["mcp", "agent-config"]; + +/// The keys `settings` sets. +const SETTING_KEYS: [&str; 5] = [ + "selected-version", + "minecraft-dir", + "server-dir", + "install-new-versions", + "opening-animation", +]; + +fn on_off(value: &str) -> Result { + match value { + "on" | "true" => Ok(true), + "off" | "false" => Ok(false), + _ => Err(format!("{value}: say on or off")), + } +} + +fn set_setting(s: &mut backend::Settings, key: &str, value: &str) -> Result<(), String> { + let folder = |value: &str| (value != "default").then(|| PathBuf::from(value)); + match key { + "selected-version" => s.selected = Some(backend::resolve_version(Some(value))?), + "minecraft-dir" => s.minecraft_dir = folder(value), + "server-dir" => s.server_dir = folder(value), + "install-new-versions" => s.install_new_versions = Some(on_off(value)?), + "opening-animation" => s.skip_opening = !on_off(value)?, + _ => return Err(format!("No setting {key}.")), + } + Ok(()) +} + +/// Every launcher setting, as `settings` shows them. +fn settings_json(s: &backend::Settings) -> serde_json::Value { + serde_json::json!({ + "selected_version": backend::resolve_version(None).ok(), + "minecraft_dir": s.minecraft_dir, + "server_dir": backend::server_dir(None), + "install_new_versions": s.install_new_versions.unwrap_or(true), + "opening_animation": !s.skip_opening, + "update_channel": s.update_channel.name(), + "game_args": s.game_args, + "desktop_entry": s.desktop_entry.unwrap_or(true), + "no_ai": backend::no_ai(), + }) +} + /// Runs a subcommand and returns the exit code, or None when the window should open. pub fn run() -> Option { - let cli = Cli::parse(); + use clap::FromArgMatches; + let no_ai = backend::no_ai(); + let mut definition = command(); + if no_ai { + // Hidden from the help too; a call still gets the refusal below. + for name in AI_COMMANDS { + definition = definition.mut_subcommand(name, |c| c.hide(true)); + } + } + let cli = Cli::from_arg_matches(&definition.get_matches()).unwrap_or_else(|e| e.exit()); let command = cli.command?; let result = match command { - Cmd::Mcp if backend::no_ai() => Err(horizon_core::no_ai::REFUSAL.into()), + Cmd::Mcp | Cmd::AgentConfig { .. } if no_ai => Err(horizon_core::no_ai::REFUSAL.into()), Cmd::Mcp => crate::mcp::serve(), command => execute(command, cli.json), }; @@ -505,11 +591,23 @@ fn execute(command: Cmd, as_json: bool) -> Result<(), String> { } println!("{tag} is prepared."); } - Cmd::Play { version, join, arg } => { + Cmd::Play { + version, + world, + creative, + join, + arg, + } => { let mut cmd = backend::client(&backend::resolve_version(version.as_deref())?)?; if let Some(code) = join { backend::join_friend(&mut cmd, &code)?; } + if let Some(world) = world { + cmd.arg("--world").arg(world); + } + if creative { + cmd.arg("--creative"); + } cmd.args(arg); attached(cmd)? } @@ -575,6 +673,55 @@ fn execute(command: Cmd, as_json: bool) -> Result<(), String> { println!("No AI is off: AI features are available."); } } + Cmd::AgentConfig { client } => { + use horizon_launcher::agents; + let exe = backend::exe_path(); + if as_json { + let mut all = agents::json(exe); + if let Some(id) = &client { + all["clients"] = all["clients"] + .as_array() + .into_iter() + .flatten() + .filter(|c| c["id"] == id.as_str()) + .cloned() + .collect(); + } + json(all); + return Ok(()); + } + for c in agents::clients(exe) + .iter() + .filter(|c| client.as_ref().is_none_or(|id| id == c.id)) + { + println!("{}", c.name); + if let Some(line) = c.add_line() { + println!(" Add it with: {line}"); + } + println!(" Or put this in {}:", c.file); + for line in c.config.lines() { + println!(" {line}"); + } + println!(); + } + println!("Then ask your agent to say hello: it can call the links tool, or play."); + } + Cmd::Settings { key, value } => { + let mut settings = backend::Settings::load(); + if let Some(key) = key { + let value = value.ok_or("settings KEY VALUE: the value is missing")?; + set_setting(&mut settings, &key, &value)?; + settings.save(); + } + let all = settings_json(&settings); + if as_json { + json(all); + } else { + for (key, value) in all.as_object().into_iter().flatten() { + println!("{key}: {value}"); + } + } + } Cmd::UpdateChannel { channel } => { let mut settings = backend::Settings::load(); if let Some(channel) = channel.as_deref().and_then(backend::UpdateChannel::parse) { diff --git a/launcher/src/cli_tools.rs b/launcher/src/cli_tools.rs new file mode 100644 index 000000000..e5d9d5a20 --- /dev/null +++ b/launcher/src/cli_tools.rs @@ -0,0 +1,339 @@ +//! Every launcher CLI command as an MCP tool, generated from the CLI's own definition (clap) so the +//! two can't drift: the tool `mods_search` is `horizon-launcher mods search`, its arguments are the +//! command's (snake_case), and a call runs that command with `--json` as a child process and +//! returns what it printed. A few commands keep a process or a sign-in going for the session; +//! mcp.rs runs those itself under the same names (`play`, `server`, `account_sign_in`...). +use clap::{ArgAction, Command}; +use serde_json::{json, Map, Value}; + +/// CLI commands that are not generated tools: the MCP server itself; No AI, the player's switch +/// and never an agent's; and the ones mcp.rs runs in the session. +const NOT_TOOLS: &[&str] = &[ + "mcp", + "agent-config", + "no-ai", + "play", + "server", + "account sign-in", + "account list", +]; + +/// Commands that delete the player's things: their tools need `confirm: true`. +pub const DESTRUCTIVE: &[&str] = &[ + "remove", + "modpack remove", + "mods remove", + "servers forget", + "account sign-out", + "data delete", +]; + +/// Commands that send something or reach other people: only when the player asks. +pub const OPEN_WORLD: &[&str] = &[ + "data allow", + "data send", + "data bug", + "data benchmark", + "servers create", +]; + +/// A generated tool: its name, the CLI words it runs and the clap command behind them. +pub struct Tool { + pub name: String, + pub path: Vec, + command: Command, +} + +/// The tool name of CLI words: `mods search` gives `mods_search`. +pub fn tool_name(path: &[String]) -> String { + path.join("_").replace('-', "_") +} + +/// Every generated tool, in the CLI's order. +pub fn all() -> Vec { + let mut out = Vec::new(); + walk(&crate::cli::command(), &mut Vec::new(), &mut out); + out +} + +fn walk(cmd: &Command, path: &mut Vec, out: &mut Vec) { + for sub in cmd.get_subcommands() { + path.push(sub.get_name().to_owned()); + if sub.has_subcommands() { + walk(sub, path, out); + } else if !NOT_TOOLS.contains(&path.join(" ").as_str()) { + out.push(Tool { + name: tool_name(path), + path: path.clone(), + command: sub.clone(), + }); + } + path.pop(); + } +} + +impl Tool { + fn words(&self) -> String { + self.path.join(" ") + } + pub fn destructive(&self) -> bool { + DESTRUCTIVE.contains(&self.words().as_str()) + } + + /// The tools/list entry. + pub fn describe(&self) -> Value { + let mut props = Map::new(); + let mut required = Vec::new(); + for arg in self.command.get_arguments().filter(|a| shown(a)) { + let id = arg.get_id().as_str(); + let mut help = arg.get_help().map(ToString::to_string).unwrap_or_default(); + let defaults: Vec = arg + .get_default_values() + .iter() + .map(|d| d.to_string_lossy().into_owned()) + .collect(); + if !defaults.is_empty() { + help = format!("{help} (default {})", defaults.join(", ")) + .trim_start() + .to_owned(); + } + let choices: Vec = arg + .get_possible_values() + .iter() + .map(|v| v.get_name().to_owned()) + .collect(); + let one = if !choices.is_empty() { + json!({ "type": "string", "enum": choices }) + } else if defaults.first().is_some_and(|d| d.parse::().is_ok()) { + json!({ "type": "integer" }) + } else { + json!({ "type": "string" }) + }; + let mut schema = if matches!(arg.get_action(), ArgAction::SetTrue) { + json!({ "type": "boolean" }) + } else if many(arg) { + json!({ "type": "array", "items": one }) + } else { + one + }; + if !help.is_empty() { + schema["description"] = help.into(); + } + props.insert(id.to_owned(), schema); + if arg.is_required_set() { + required.push(id.to_owned()); + } + } + if self.destructive() { + props.insert( + "confirm".into(), + json!({ "type": "boolean", "description": "true once the player agreed: it cannot be undone" }), + ); + required.push("confirm".into()); + } + let about = self + .command + .get_about() + .map(ToString::to_string) + .unwrap_or_default(); + let mut tool = json!({ + "name": self.name, + "description": format!("{about}. CLI: horizon-launcher {}", self.words()), + "inputSchema": { "type": "object", "properties": props, "required": required }, + }); + if self.destructive() { + tool["annotations"] = json!({ "destructiveHint": true }); + } else if OPEN_WORLD.contains(&self.words().as_str()) { + tool["annotations"] = json!({ "openWorldHint": true }); + } + tool + } + + /// The CLI words for a call's arguments. + pub fn argv(&self, args: &Value) -> Result, String> { + if self.destructive() && args.get("confirm").and_then(Value::as_bool) != Some(true) { + return Err(format!( + "{} cannot be undone: ask the player, then call it with confirm: true", + self.name + )); + } + let text = |v: &Value| match v { + Value::String(s) => Ok(s.clone()), + Value::Number(n) => Ok(n.to_string()), + Value::Bool(b) => Ok(b.to_string()), + other => Err(format!("{other} is not a value")), + }; + let mut words = self.path.clone(); + let mut positional = Vec::new(); + let mut last = Vec::new(); + for arg in self.command.get_arguments().filter(|a| shown(a)) { + let id = arg.get_id().as_str(); + let Some(value) = args.get(id).filter(|v| !v.is_null()) else { + if arg.is_required_set() { + return Err(format!("{id} is required")); + } + continue; + }; + let values = match value { + Value::Array(items) => items.iter().map(text).collect::, _>>()?, + v => vec![text(v)?], + }; + if matches!(arg.get_action(), ArgAction::SetTrue) { + if value.as_bool().ok_or(format!("{id} is true or false"))? { + words.push(format!("--{}", arg.get_long().unwrap_or(id))); + } + } else if arg.is_positional() { + let into = if arg.is_last_set() { + &mut last + } else { + &mut positional + }; + into.push((arg.get_index().unwrap_or(0), values)); + } else { + let long = arg.get_long().unwrap_or(id); + for v in values { + // `=` keeps a value that starts with a dash (game arguments) a value. + words.push(format!("--{long}={v}")); + } + } + } + positional.sort_by_key(|(index, _)| *index); + words.extend(positional.into_iter().flat_map(|(_, v)| v)); + if !last.is_empty() { + words.push("--".into()); + words.extend(last.into_iter().flat_map(|(_, v)| v)); + } + Ok(words) + } + + /// Runs the command as `horizon-launcher --json ...` and returns what it printed. + pub fn call(&self, args: &Value) -> Result { + let words = self.argv(args)?; + let exe = std::env::current_exe().map_err(|e| e.to_string())?; + let out = std::process::Command::new(exe) + .arg("--json") + .args(&words) + .stdin(std::process::Stdio::null()) + .output() + .map_err(|e| format!("Could not run horizon-launcher: {e}"))?; + let stdout = String::from_utf8_lossy(&out.stdout).trim().to_owned(); + let stderr = String::from_utf8_lossy(&out.stderr).trim().to_owned(); + let text = match (stdout.is_empty(), stderr.is_empty()) { + (false, true) => stdout, + (true, false) => stderr, + (true, true) => "Done.".into(), + (false, false) => format!("{stdout}\n{stderr}"), + }; + if out.status.success() { + Ok(text) + } else { + Err(text) + } + } +} + +/// Whether an argument is part of a tool (not --help, --version or the global --json). +fn shown(arg: &clap::Arg) -> bool { + !arg.is_hide_set() && !matches!(arg.get_id().as_str(), "help" | "version" | "json") +} + +/// Whether an argument takes several values (a list). +fn many(arg: &clap::Arg) -> bool { + matches!(arg.get_action(), ArgAction::Append) + || arg.get_num_args().is_some_and(|n| n.max_values() > 1) +} + +#[cfg(test)] +mod tests { + use super::*; + + fn tool(name: &str) -> Tool { + all().into_iter().find(|t| t.name == name).unwrap() + } + + #[test] + fn every_cli_command_is_a_tool_named_after_its_words() { + let names: Vec = all().into_iter().map(|t| t.name).collect(); + for want in [ + "versions", + "install", + "remove", + "prepare", + "notes", + "update", + "update_channel", + "game_args", + "settings", + "logs", + "mods_search", + "mods_install", + "modpack_import", + "servers_create", + "servers_run", + "data_status", + "data_bug", + "account_select", + "benchmark", + ] { + assert!(names.iter().any(|n| n == want), "{want} missing: {names:?}"); + } + for not in ["mcp", "no_ai", "play", "server", "account_sign_in"] { + assert!(!names.iter().any(|n| n == not), "{not}"); + } + } + + #[test] + fn arguments_become_cli_words() { + let search = tool("mods_search"); + let schema = search.describe(); + assert_eq!(schema["inputSchema"]["properties"]["text"]["type"], "array"); + let kinds = &schema["inputSchema"]["properties"]["kind"]["enum"]; + assert!( + kinds.as_array().unwrap().contains(&json!("shader")), + "{kinds}" + ); + assert_eq!( + search + .argv(&json!({ "text": ["fresh", "animations"], "kind": "shader", "everything": true })) + .unwrap(), + ["mods", "search", "--kind=shader", "--everything", "fresh", "animations"] + ); + let run = tool("servers_run"); + assert_eq!( + run.argv(&json!({ "server": "My server", "args": ["status"] })) + .unwrap(), + ["servers", "run", "My server", "--", "status"] + ); + assert!(run + .argv(&json!({ "server": "x" })) + .unwrap_err() + .contains("args is required")); + let logs = tool("logs").describe(); + assert_eq!( + logs["inputSchema"]["properties"]["lines"]["type"], + "integer" + ); + } + + #[test] + fn destructive_tools_need_confirm() { + let remove = tool("remove"); + assert_eq!(remove.describe()["annotations"]["destructiveHint"], true); + assert!(remove + .argv(&json!({ "tag": "v1" })) + .unwrap_err() + .contains("confirm")); + assert_eq!( + remove + .argv(&json!({ "tag": "v1", "confirm": true })) + .unwrap(), + ["remove", "v1"] + ); + for words in DESTRUCTIVE.iter().chain(OPEN_WORLD) { + assert!( + all().iter().any(|t| t.words() == *words), + "{words} is not a tool" + ); + } + } +} diff --git a/launcher/src/game_tools.rs b/launcher/src/game_tools.rs index 7694d24e5..3504a531f 100644 --- a/launcher/src/game_tools.rs +++ b/launcher/src/game_tools.rs @@ -1,6 +1,6 @@ //! The running game's tools in the launcher's MCP, so an agent needs one server //! (docs/agent-control.md): the selected version's `horizon-ctl mcp` runs as a child, its tools -//! are offered as `game_`, and calls go to it unchanged. `launch_client` starts the game +//! are offered as `game_`, and calls go to it unchanged. `play` starts the game //! with the control socket that child talks to. use horizon_launcher::backend; use serde_json::{json, Value}; @@ -10,7 +10,7 @@ use std::process::{Child, ChildStdin, ChildStdout, Command, Stdio}; pub const PREFIX: &str = "game_"; -/// horizon-ctl tools the launcher covers itself: `launch_client` starts the game. +/// horizon-ctl tools the launcher covers itself: `play` starts the game. const HIDDEN: &[&str] = &["launch"]; const CTL: &str = if cfg!(windows) { @@ -19,7 +19,7 @@ const CTL: &str = if cfg!(windows) { "horizon-ctl" }; -/// The control endpoint of a game started by `launch_client`: a Unix socket, or on Windows the +/// The control endpoint of a game started by `play`: a Unix socket, or on Windows the /// file naming a localhost port and its token. pub fn socket_path() -> PathBuf { backend::data_dir().join(if cfg!(unix) { @@ -151,7 +151,7 @@ fn prefixed(tools: &Value) -> Vec { let mut t = t.clone(); t["name"] = format!("{PREFIX}{}", t["name"].as_str().unwrap_or_default()).into(); t["description"] = format!( - "In the running game (start it with launch_client): {}", + "In the running game (start it with play): {}", t["description"].as_str().unwrap_or_default() ) .into(); @@ -173,7 +173,7 @@ fn explain_unreachable(mut result: Value) -> Value { }); if unreachable { result["content"] = json!([{ "type": "text", "text": json!({ - "error": "The game is not running under agent control. Start it with launch_client, then game_wait_ready.", + "error": "The game is not running under agent control. Start it with play, then game_wait_ready.", "kind": "state", }).to_string() }]); } @@ -209,7 +209,7 @@ mod tests { assert!(result["content"][0]["text"] .as_str() .unwrap() - .contains("launch_client")); + .contains("with play")); let other = json!({ "content": [{ "type": "text", "text": "{\"error\":\"no world\"}" }], "isError": true }); assert_eq!(explain_unreachable(other.clone()), other); } diff --git a/launcher/src/lib.rs b/launcher/src/lib.rs index 98228b5fc..61a9713ff 100644 --- a/launcher/src/lib.rs +++ b/launcher/src/lib.rs @@ -1,5 +1,6 @@ //! The launcher's core, shared by the GUI, the CLI and the MCP server. pub mod account; +pub mod agents; pub mod backend; pub mod browser; pub mod desktop; diff --git a/launcher/src/main.rs b/launcher/src/main.rs index 2ffea2e98..237ac0402 100644 --- a/launcher/src/main.rs +++ b/launcher/src/main.rs @@ -4,6 +4,7 @@ mod art; mod blocks; mod cli; +mod cli_tools; mod collection; mod cull; mod game_tools; diff --git a/launcher/src/mcp.rs b/launcher/src/mcp.rs index 5abe45325..8aff5aa13 100644 --- a/launcher/src/mcp.rs +++ b/launcher/src/mcp.rs @@ -2,10 +2,10 @@ //! message per line), so AI agents can install, prepare and run Horizon. Every tool goes through //! `backend`. A server started here lives as long as the session. The running game's own tools //! come from its `horizon-ctl` as `game_*` (game_tools.rs). +use crate::cli_tools; use crate::game_tools::{self, GameTools}; use horizon_launcher::account::{self, Accounts, SignIn, SignInState}; use horizon_launcher::backend::{self, Job, Logged}; -use horizon_launcher::telemetry; use serde_json::{json, Value}; use std::io::{BufRead, Write}; use std::path::PathBuf; @@ -21,55 +21,38 @@ struct Session { game: Option, } -fn tools() -> Value { +/// The tools the session runs itself, under their CLI names: they keep a process (the game, a +/// server) or a sign-in going between calls. Every other CLI command is generated (cli_tools.rs). +fn session_tools() -> Value { let version = json!({ "type": "string", "description": "An installed version tag such as v2026.10.13. Default: the selected version." }); let none = json!({ "type": "object", "properties": {} }); json!([ - { "name": "list_versions", "description": "List Horizon releases on GitHub (newest first) and the versions installed here, with which is selected and which are prepared.", - "inputSchema": { "type": "object", "properties": { "installed_only": { "type": "boolean", "description": "Skip GitHub and list only installed versions." } } } }, - { "name": "install_version", "description": "Download and install a Horizon release for this platform. Takes a minute or two.", - "inputSchema": { "type": "object", "properties": { "tag": { "type": "string", "description": "A release tag such as v2026.10.13, or \"latest\"." } }, "required": ["tag"] } }, - { "name": "remove_version", "description": "Remove an installed Horizon version and its prepared resources.", - "inputSchema": { "type": "object", "properties": { "tag": { "type": "string" } }, "required": ["tag"] } }, - { "name": "prepare_resources", "description": "Prepare a version's resources from the player's own Minecraft install (needs the Minecraft release that version is built for, played once in the official launcher, and its Java; versions before horizon-prepare also need Python 3.10+). Can take several minutes; returns the end of the log.", - "inputSchema": { "type": "object", "properties": { "version": version, "minecraft_dir": { "type": "string", "description": "The game folder of the official launcher, Prism Launcher, MultiMC, the Modrinth App, ATLauncher or GDLauncher. Default: the launcher's setting, then every launcher's default folder." } } } }, - { "name": "launch_client", "description": "Start the Horizon client (a game window on the player's screen) under agent control: the game_* tools then play it. Returns once it has started; game_wait_ready waits for the world.", + { "name": "play", "description": "Start the Horizon client (a game window on the player's screen) under agent control: the game_* tools then play it. Returns once it has started; game_wait_ready waits for the world. CLI: horizon-launcher play", "inputSchema": { "type": "object", "properties": { "version": version, "world": { "type": "string", "description": "Open or create this world (a folder under saves) at once." }, "creative": { "type": "boolean", "description": "Creative mode for a new world." }, + "join": { "type": "string", "description": "Join a friend's world with its invite code. Only when the player asks." }, "offscreen": { "type": "boolean", "description": "Render without showing a window (game_screenshot still works)." }, - "args": { "type": "array", "items": { "type": "string" }, "description": "Extra game arguments, passed through as-is (for example \"--server-thread\")." } } } }, - { "name": "start_server", "description": "Start a Horizon dedicated server. It runs until stop_server or the end of this MCP session. Requires agreeing to the Minecraft EULA.", + "arg": { "type": "array", "items": { "type": "string" }, "description": "Extra game arguments, passed through as-is (for example \"--server-thread\")." } } } }, + { "name": "server", "description": "Start a Horizon dedicated server. It runs until server_stop or the end of this MCP session. Requires agreeing to the Minecraft EULA. CLI: horizon-launcher server", "inputSchema": { "type": "object", "properties": { "version": version, "dir": { "type": "string", "description": "The server's folder. Default: the launcher's server folder." }, "accept_eula": { "type": "boolean", "description": "Agree to the Minecraft EULA (https://aka.ms/MinecraftEULA) on the player's behalf. Only with their consent." } } } }, - { "name": "server_command", "description": "Send a console command to the running server (for example \"list\" or \"say hello\"), and return the lines it printed in reply.", + { "name": "server_command", "description": "Send a console command to the server started with server (for example \"list\" or \"say hello\"), and return the lines it printed in reply.", "inputSchema": { "type": "object", "properties": { "command": { "type": "string" } }, "required": ["command"] } }, { "name": "server_log", "description": "The most recent lines of the server's console.", "inputSchema": { "type": "object", "properties": { "lines": { "type": "integer", "minimum": 1, "maximum": 2000, "description": "How many lines (default 50)." } } } }, - { "name": "stop_server", "description": "Stop the running server cleanly (it saves the world), killing it if it does not stop within 30 seconds.", "inputSchema": none }, - { "name": "patch_notes", "description": "A release's patch notes as markdown.", - "inputSchema": { "type": "object", "properties": { "tag": { "type": "string", "description": "Default: the newest release." } } } }, - { "name": "links", "description": "The Horizon links: the Discord invite, the GitHub Sponsors page and the website (an empty one is not offered).", "inputSchema": none }, - { "name": "update_channel", "description": "Show or set which Horizon releases install by themselves. \"stable\" (the default) is a tested build about once a day; \"alpha\" is every release as soon as it is built, several times a day, and can break. Only when the player asks to change it.", - "inputSchema": { "type": "object", "properties": { "channel": { "type": "string", "enum": ["stable", "alpha"], "description": "Omit to show the current channel." } } } }, - { "name": "logs", "description": "Read the game's log: the last lines of logs/latest.log in the game folder, or with crash the newest crash report (what the game wrote when it last crashed). Read-only.", - "inputSchema": { "type": "object", "properties": { "lines": { "type": "integer", "minimum": 1, "maximum": 5000, "description": "How many lines of latest.log (default 100)." }, "crash": { "type": "boolean", "description": "Return the newest crash report instead." } } } }, - { "name": "accounts", "description": "The Microsoft accounts signed in to the launcher (names and UUIDs, never tokens), which one the game plays as (none = offline), and how a sign-in started with sign_in is going.", "inputSchema": none }, - { "name": "sign_in", "description": "Start signing in a Microsoft account: returns a link and a code the player enters in their browser. The sign-in finishes in the background; check it with accounts. Only when the player asks to sign in.", "inputSchema": none }, - { "name": "sign_out", "description": "Sign an account out of the launcher (its tokens leave the keychain).", - "inputSchema": { "type": "object", "properties": { "account": { "type": "string", "description": "Its name or UUID." } }, "required": ["account"] } }, - { "name": "select_account", "description": "Choose the account the game plays as, or \"offline\" to play without one.", - "inputSchema": { "type": "object", "properties": { "account": { "type": "string", "description": "A name or UUID, or \"offline\"." } }, "required": ["account"] } }, - { "name": "check_updates", "description": "Check GitHub for a Horizon release newer than every installed version, and for a newer launcher.", "inputSchema": none }, - { "name": "data_collection", "description": "The player's opt-in data collection: which kinds they allow (performance, crashes, bugs, benchmarks; all off until they answer), the install ID, how many items wait, and the data server. Read-only.", "inputSchema": none }, - { "name": "set_data_collection", "description": "Turn kinds of data collection on or off. Only when the player asks: it records their consent.", - "inputSchema": { "type": "object", "properties": { "kinds": { "type": "array", "items": { "type": "string", "enum": ["performance", "crashes", "bugs", "benchmarks", "all"] } }, "on": { "type": "boolean" } }, "required": ["kinds", "on"] } }, - { "name": "data_preview", "description": "Exactly what would be sent (the JSON), or an example of each kind when nothing waits. Sends nothing.", "inputSchema": none }, - { "name": "delete_my_data", "description": "Ask the server to delete everything sent from this install, remove what waits, and take a new install ID. Only when the player asks.", "inputSchema": none }, - { "name": "report_bug", "description": "Send a bug report in the player's words, only once they have agreed to send it (bug reports must be allowed). With include_log the end of the game's log goes too, scrubbed and without chat: show it to the player first (the logs tool). Returns exactly what was kept.", - "inputSchema": { "type": "object", "properties": { "text": { "type": "string" }, "include_log": { "type": "boolean" } }, "required": ["text"] } }, + { "name": "server_stop", "description": "Stop the server started with server cleanly (it saves the world), killing it if it does not stop within 30 seconds.", "inputSchema": none }, + { "name": "account_list", "description": "The Microsoft accounts signed in to the launcher (names and UUIDs, never tokens), which one the game plays as (none = offline), and how a sign-in started with account_sign_in is going. CLI: horizon-launcher account list", "inputSchema": none }, + { "name": "account_sign_in", "description": "Start signing in a Microsoft account: returns a link and a code the player enters in their browser. The sign-in finishes in the background; check it with account_list. Only when the player asks to sign in. CLI: horizon-launcher account sign-in", "inputSchema": none }, ]) } +/// Every launcher tool: the session's and the generated ones. +fn tools() -> Vec { + let mut list = session_tools().as_array().cloned().unwrap_or_default(); + list.extend(cli_tools::all().iter().map(cli_tools::Tool::describe)); + list +} + fn arg_str<'a>(args: &'a Value, key: &str) -> Option<&'a str> { args.get(key) .and_then(Value::as_str) @@ -78,81 +61,8 @@ fn arg_str<'a>(args: &'a Value, key: &str) -> Option<&'a str> { impl Session { fn call(&mut self, name: &str, args: &Value) -> Result { - if matches!(name, "list_versions" | "check_updates") { - backend::reuse_prepared_everywhere(); - } match name { - "list_versions" => { - let installed = backend::installed(); - let mut out = json!({ - "installed": installed.iter().map(|t| json!({ "tag": t, "prepared": backend::is_prepared(t), "sounds": backend::has_sounds(t) })).collect::>(), - "selected": backend::resolve_version(None).ok(), - }); - if !args - .get("installed_only") - .and_then(Value::as_bool) - .unwrap_or(false) - { - out["releases"] = backend::releases()? - .iter() - .map(|r| json!({ "tag": r.tag, "name": r.name, "date": r.date, "channel": backend::UpdateChannel::of(r).name(), "available_here": r.asset.is_some() })) - .collect(); - } - Ok(serde_json::to_string_pretty(&out).unwrap()) - } - "install_version" => { - let tag = backend::install_tag( - arg_str(args, "tag").ok_or("tag is required")?, - false, - |_| {}, - )?; - Ok(if backend::is_prepared(&tag) { - format!("Installed {tag}. It is now the selected version, prepared already from another installed version.") - } else { - format!("Installed {tag}. It is now the selected version; prepare it before playing.") - }) - } - "remove_version" => { - let tag = arg_str(args, "tag").ok_or("tag is required")?; - backend::remove_version(tag)?; - Ok(format!("Removed {tag}.")) - } - "prepare_resources" => { - let tag = backend::resolve_version(arg_str(args, "version"))?; - let minecraft = - backend::minecraft_dir(arg_str(args, "minecraft_dir").map(PathBuf::from))?; - let (preparer, minecraft) = backend::preparer(&tag, &minecraft, &|_| {})?; - let sound = std::cell::RefCell::new(Vec::new()); - backend::sounds(&tag, &minecraft, &|line| sound.borrow_mut().push(line)); - let (result, tail) = match preparer { - backend::Preparer::Process(cmd) => { - let run = Logged::start(Job::Prepare, cmd)?; - let result = run.wait(); - (result, run.tail(20).join("\n")) - } - backend::Preparer::InProcess(options) => { - let lines = std::cell::RefCell::new(std::collections::VecDeque::new()); - let result = backend::prepare_in_process(&options, &|line| { - let mut lines = lines.borrow_mut(); - lines.push_back(line); - if lines.len() > 20 { - lines.pop_front(); - } - }); - let tail = lines - .into_inner() - .into_iter() - .collect::>() - .join("\n"); - (result, tail) - } - }; - let tail = format!("{}\n{tail}", sound.into_inner().join("\n")); - result - .map(|_| format!("{tag} is prepared.\n{tail}")) - .map_err(|e| format!("{e}\n{tail}")) - } - "launch_client" => { + "play" => { if self.client.as_ref().is_some_and(|c| c.finished().is_none()) { return Err("The client is already running.".into()); } @@ -167,7 +77,10 @@ impl Session { cmd.arg(format!("--{flag}")); } } - if let Some(extra) = args.get("args").and_then(Value::as_array) { + if let Some(code) = arg_str(args, "join") { + backend::join_friend(&mut cmd, code)?; + } + if let Some(extra) = args.get("arg").and_then(Value::as_array) { cmd.args(extra.iter().filter_map(Value::as_str)); } let client = Logged::start(Job::Client, cmd)?; @@ -194,7 +107,7 @@ impl Session { "Started the {tag} client. The game_* tools play it; game_wait_ready waits until the world is ready." )) } - "start_server" => { + "server" => { if self.server.as_ref().is_some_and(|s| s.finished().is_none()) { return Err("A server is already running. Stop it first.".into()); } @@ -249,7 +162,7 @@ impl Session { server.tail(lines).join("\n") )) } - "stop_server" => { + "server_stop" => { let mut server = self .server .take() @@ -260,85 +173,7 @@ impl Session { server.tail(5).join("\n") )) } - "patch_notes" => { - let r = backend::release_notes(arg_str(args, "tag"))?; - Ok(format!( - "# {} ({}, {})\n\n{}", - if r.name.is_empty() { &r.tag } else { &r.name }, - r.tag, - r.date, - r.body - )) - } - "links" => Ok(serde_json::to_string_pretty(&backend::links()).unwrap()), - "logs" => { - let lines = args.get("lines").and_then(Value::as_u64).unwrap_or(100); - let crash = args.get("crash").and_then(Value::as_bool).unwrap_or(false); - let (path, text) = backend::read_logs(lines.clamp(1, 5000) as usize, crash)?; - Ok(format!("{}\n\n{text}", path.display())) - } - "update_channel" => { - let mut settings = backend::Settings::load(); - if let Some(name) = arg_str(args, "channel") { - settings.update_channel = backend::UpdateChannel::parse(name) - .ok_or("channel is \"stable\" or \"alpha\"")?; - settings.save(); - } - Ok(format!( - "Update channel: {}", - settings.update_channel.name() - )) - } - "data_collection" => Ok(serde_json::to_string_pretty(&telemetry::status_json()) - .map_err(|e| e.to_string())?), - "set_data_collection" => { - let kinds: Vec = args - .get("kinds") - .and_then(Value::as_array) - .map(|a| { - a.iter() - .filter_map(Value::as_str) - .map(str::to_owned) - .collect() - }) - .unwrap_or_default(); - let on = args - .get("on") - .and_then(Value::as_bool) - .ok_or("on is required")?; - telemetry::set(&telemetry::parse_kinds(&kinds)?, on)?; - Ok(serde_json::to_string_pretty(&telemetry::status_json()) - .map_err(|e| e.to_string())?) - } - "data_preview" => { - let (what, text) = telemetry::preview(); - Ok(format!("{what}\n{text}")) - } - "delete_my_data" => telemetry::delete_my_data(), - "report_bug" => { - let text = arg_str(args, "text").ok_or("text is required")?; - let with_log = args - .get("include_log") - .and_then(Value::as_bool) - .unwrap_or(false); - let item = telemetry::bug_report(text, with_log)?; - let done = telemetry::submit(&item)?; - Ok(format!( - "{done}\n{}", - serde_json::to_string_pretty(&item).map_err(|e| e.to_string())? - )) - } - "check_updates" => { - let u = backend::check_updates()?; - Ok(serde_json::to_string_pretty(&json!({ - "horizon_update": u.horizon.as_ref().map(|r| &r.tag), - "installed": backend::installed(), - "launcher_update": u.launcher.as_ref().and_then(|r| backend::launcher_version(&r.tag)), - "launcher_version": backend::VERSION, - })) - .unwrap()) - } - "accounts" => { + "account_list" => { let accounts = Accounts::load(); let sign_in = self.sign_in.as_ref().map(|s| match s.state() { SignInState::Starting => json!({ "state": "starting" }), @@ -355,7 +190,7 @@ impl Session { })) .unwrap()) } - "sign_in" => { + "account_sign_in" => { account::client_id().ok_or(account::NOT_CONFIGURED)?; if let Some(s) = self.sign_in.take() { s.cancel(); @@ -380,29 +215,10 @@ impl Session { _ => Err("Microsoft did not answer. Try again.".into()), } } - "sign_out" | "select_account" => { - let who = arg_str(args, "account").ok_or("account is required")?; - let mut accounts = Accounts::load(); - if name == "select_account" && who.eq_ignore_ascii_case("offline") { - accounts.selected = None; - accounts.save()?; - return Ok("The game plays offline.".into()); - } - let a = accounts - .find(who) - .cloned() - .ok_or_else(|| format!("No signed-in account {who}."))?; - if name == "sign_out" { - accounts.remove(account::store(), &a.uuid)?; - accounts.save()?; - Ok(format!("Signed out {}.", a.name)) - } else { - accounts.selected = Some(a.uuid); - accounts.save()?; - Ok(format!("The game plays as {}.", a.name)) - } - } - _ => Err(format!("Unknown tool {name}")), + _ => match cli_tools::all().into_iter().find(|t| t.name == name) { + Some(tool) => tool.call(args), + None => Err(format!("Unknown tool {name}")), + }, } } @@ -419,7 +235,7 @@ impl Session { fn running_server(&mut self) -> Result<&mut Logged, String> { match &mut self.server { Some(s) if s.finished().is_none() => Ok(s), - _ => Err("No server is running. Start one with start_server.".into()), + _ => Err("No server is running. Start one with server.".into()), } } @@ -429,11 +245,11 @@ impl Session { "protocolVersion": params.get("protocolVersion").and_then(Value::as_str).unwrap_or(PROTOCOL), "capabilities": { "tools": {} }, "serverInfo": { "name": "horizon-launcher", "version": backend::VERSION }, - "instructions": "Manage Horizon, a Rust reimplementation of Minecraft Java Edition: install versions, prepare them from the player's own Minecraft, start the client or a dedicated server. Once launch_client started the game, the game_* tools play it: game_state, game_ui (every widget of the open screen), game_click, game_goto, game_screenshot...", + "instructions": "Manage Horizon, a Rust reimplementation of Minecraft Java Edition: install versions, prepare them from the player's own Minecraft, start the client or a dedicated server. Every tool is a horizon-launcher CLI command of the same name (mods_search is horizon-launcher mods search). Once play started the game, the game_* tools play it: game_state, game_ui (every widget of the open screen), game_click, game_goto, game_screenshot...", })), "ping" => Ok(json!({})), "tools/list" => { - let mut list = tools().as_array().cloned().unwrap_or_default(); + let mut list = tools(); if let Some(game) = self.game() { list.extend(game.tools().iter().cloned()); } @@ -448,7 +264,10 @@ impl Session { .get("name") .and_then(Value::as_str) .ok_or((-32602, "name is required".to_string()))?; - if name.starts_with(game_tools::PREFIX) { + // The launcher's own tools first: game_args is one, not a game tool. + if name.starts_with(game_tools::PREFIX) + && !tools().iter().any(|t| t["name"] == name) + { let args = params.get("arguments").cloned().unwrap_or(json!({})); let game = self.game().ok_or(( -32602, @@ -459,12 +278,7 @@ impl Session { } return game.call(name, &args).map_err(|e| (-32603, e)); } - if !tools() - .as_array() - .unwrap() - .iter() - .any(|t| t["name"] == name) - { + if !tools().iter().any(|t| t["name"] == name) { return Err((-32602, format!("Unknown tool {name}"))); } let args = params.get("arguments").cloned().unwrap_or(json!({})); diff --git a/tools/launcher_mcp_e2e.py b/tools/launcher_mcp_e2e.py index fbcb1b5cc..fecf21899 100644 --- a/tools/launcher_mcp_e2e.py +++ b/tools/launcher_mcp_e2e.py @@ -3,9 +3,10 @@ A scratch launcher home gets one "installed" version made of this checkout's builds (horizon-client and horizon-ctl) and the prepared resources in .local/horizon-client. An MCP -client then talks to `horizon-launcher mcp` alone: the game tools are listed, a call before the -game runs says to launch it, launch_client starts it under control, and game_wait_ready, -game_state, game_ui and game_screenshot play it until game_quit. Then No AI is turned on with +client then talks to `horizon-launcher mcp` alone: every CLI command is listed as a tool of the same +name (versions, settings, mods_search...), a destructive one needs confirm, the game tools are +listed, a call before the game runs says to start it, play starts it under control, and +game_wait_ready, game_state, game_ui and game_screenshot play it until game_quit. Then No AI is turned on with `horizon-launcher no-ai on`: `horizon-launcher mcp` refuses to start, and a session already running refuses its next call. @@ -70,14 +71,27 @@ def scenario(m, out): 'clientInfo': {'name': 'launcher_mcp_e2e', 'version': '1'}}) assert init['serverInfo']['name'] == 'horizon-launcher', init tools = {t['name'] for t in m.rpc('tools/list', {})['tools']} - for name in ['launch_client', 'game_state', 'game_ui', 'game_click', 'game_screenshot']: + for name in ['play', 'server', 'versions', 'settings', 'mods_search', 'modpack_list', 'servers_list', + 'data_status', 'account_list', 'game_args', 'game_state', 'game_ui', 'game_click', + 'game_screenshot']: assert name in tools, f'{name} missing from {sorted(tools)}' - assert 'game_launch' not in tools, 'launch_client covers horizon-ctl launch' + for name in ['game_launch', 'mcp', 'no_ai', 'agent_config']: + assert name not in tools, f'{name} is a tool' + + # Generated from the CLI: the same command, its JSON output. + result, texts, _ = m.call('versions', installed=True) + assert json.loads(texts[-1])['installed'] == [TAG], texts + result, texts, _ = m.call('settings', key='opening-animation', value='off') + assert json.loads(texts[-1])['opening_animation'] is False, texts + result, texts, _ = m.call('game_args') + assert 'game_args' in json.loads(texts[-1]), texts + result, texts, _ = m.call('remove', tag=TAG) + assert result['isError'] and 'confirm' in texts[-1], texts result, texts, _ = m.call('game_state') - assert result['isError'] and 'launch_client' in texts[-1], texts + assert result['isError'] and 'with play' in texts[-1], texts - result, texts, _ = m.call('launch_client', world='Agent', creative=True, + result, texts, _ = m.call('play', world='Agent', creative=True, offscreen=sys.platform == 'darwin') assert not result['isError'], texts result, texts, _ = m.call('game_wait_ready', seconds=300) @@ -105,6 +119,9 @@ def no_ai_scenario(launcher, env, home): run = lambda *a: subprocess.run([str(launcher), *a], env=env, input='', capture_output=True, text=True, timeout=60) assert json.loads(run('no-ai', '--json').stdout) == {'no_ai': False} + config = json.loads(run('agent-config', '--json').stdout) + assert config['server']['args'] == ['mcp'] and len(config['clients']) == 4, config + assert 'agent-config' in run('--help').stdout m = Mcp(launcher, env) m.rpc('initialize', {'protocolVersion': '2025-06-18', 'capabilities': {}, 'clientInfo': {'name': 'launcher_mcp_e2e', 'version': '1'}}) @@ -117,9 +134,11 @@ def no_ai_scenario(launcher, env, home): except Failed as e: assert REFUSAL in str(e), e m.close() - r = run('mcp') - print(f'[launcher-mcp] mcp under No AI -> exit {r.returncode}: {r.stderr.strip()}') - assert r.returncode == 1 and r.stderr.strip() == f'error: {REFUSAL}', r + for command in ('mcp', 'agent-config'): + r = run(command) + print(f'[launcher-mcp] {command} under No AI -> exit {r.returncode}: {r.stderr.strip()}') + assert r.returncode == 1 and r.stderr.strip() == f'error: {REFUSAL}', r + assert 'agent-config' not in run('--help').stdout and ' mcp ' not in run('--help').stdout # What the launcher needs keeps working. assert run('versions', '--installed', '--json').returncode == 0 assert run('no-ai', 'off').returncode == 0 From 51be242af0394c620fbd3f142b5728c874e6af53 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 02:35:09 +0200 Subject: [PATCH 085/126] Launcher Settings: Connect an AI agent, and the No AI switch Settings gets an AI group with the No AI switch (horizon_core::no_ai, the same switch the game reads) and, while it is off, a Connect an AI agent section that replaces the old command-line note: a picker for Claude Code, Codex, Cursor or any MCP client, the ready-made config with a Copy button, the client's own add command (claude mcp add / codex mcp add) shown and run only when the player clicks Add, and Test the connection, which starts the MCP server as a client would and says how many tools answered. Client CLIs are found on the PATH or in the folders installers use, since a launcher started from the desktop gets a short PATH on macOS. horizon-launcher agent-config --test runs the same test; the launcher harness checks it. Co-Authored-By: Claude Opus 5.5 --- launcher/src/agents.rs | 67 ++++++++++ launcher/src/agents_page.rs | 240 ++++++++++++++++++++++++++++++++++++ launcher/src/backend.rs | 2 + launcher/src/cli.rs | 13 +- launcher/src/main.rs | 38 ++---- tools/launcher_mcp_e2e.py | 2 + 6 files changed, 330 insertions(+), 32 deletions(-) create mode 100644 launcher/src/agents_page.rs diff --git a/launcher/src/agents.rs b/launcher/src/agents.rs index 8eba00125..0cc012b43 100644 --- a/launcher/src/agents.rs +++ b/launcher/src/agents.rs @@ -86,6 +86,73 @@ pub fn clients(exe: &Path) -> Vec { ] } +/// Where a client's CLI is: on the PATH, else in the folders installers use (a launcher started +/// from the desktop gets a short PATH on macOS). The bare name when it is nowhere. +pub fn locate(program: &str) -> std::path::PathBuf { + let home = dirs::home_dir().unwrap_or_default(); + let names: Vec = if cfg!(windows) { + ["exe", "cmd"] + .iter() + .map(|e| format!("{program}.{e}")) + .collect() + } else { + vec![program.to_owned()] + }; + let extra = [ + home.join(".local/bin"), + home.join(".claude/local"), + home.join(".npm-global/bin"), + home.join(".bun/bin"), + home.join(".cargo/bin"), + "/opt/homebrew/bin".into(), + "/usr/local/bin".into(), + home.join("AppData/Roaming/npm"), + ]; + std::env::var_os("PATH") + .map(|p| std::env::split_paths(&p).collect::>()) + .unwrap_or_default() + .into_iter() + .chain(extra) + .flat_map(|dir| names.iter().map(move |n| dir.join(n))) + .find(|p| p.is_file()) + .unwrap_or_else(|| program.into()) +} + +/// Starts `exe mcp` as a client would, lists its tools and returns how many answered: the +/// Settings page's "Test the connection". +pub fn self_test(exe: &Path) -> Result { + use std::io::Write; + use std::process::{Command, Stdio}; + let mut child = Command::new(exe) + .arg("mcp") + .stdin(Stdio::piped()) + .stdout(Stdio::piped()) + .stderr(Stdio::piped()) + .spawn() + .map_err(|e| format!("Could not start {}: {e}", exe.display()))?; + let lines = [ + json!({ "jsonrpc": "2.0", "id": 1, "method": "initialize", "params": { "protocolVersion": "2025-06-18", "capabilities": {}, "clientInfo": { "name": "horizon-launcher-test", "version": "1" } } }), + json!({ "jsonrpc": "2.0", "method": "notifications/initialized" }), + json!({ "jsonrpc": "2.0", "id": 2, "method": "tools/list", "params": {} }), + ]; + if let Some(mut stdin) = child.stdin.take() { + for line in &lines { + writeln!(stdin, "{line}").map_err(|e| e.to_string())?; + } + // Dropping stdin ends the session: the server answers, then exits. + } + let out = child.wait_with_output().map_err(|e| e.to_string())?; + if !out.status.success() { + return Err(String::from_utf8_lossy(&out.stderr).trim().to_owned()); + } + String::from_utf8_lossy(&out.stdout) + .lines() + .filter_map(|l| serde_json::from_str::(l).ok()) + .find(|r| r["id"] == 2) + .and_then(|r| r["result"]["tools"].as_array().map(Vec::len)) + .ok_or_else(|| "The MCP server did not list its tools.".into()) +} + /// `program args...` quoted for a POSIX shell where a word needs it. pub fn shell_line(program: &str, args: &[String]) -> String { let quote = |w: &str| { diff --git a/launcher/src/agents_page.rs b/launcher/src/agents_page.rs new file mode 100644 index 000000000..ecb393bf0 --- /dev/null +++ b/launcher/src/agents_page.rs @@ -0,0 +1,240 @@ +//! Settings' AI rows: the No AI switch (`horizon_core::no_ai`, shared with the game) and "Connect +//! an AI agent", the ready-made MCP config of each common client with Copy buttons, a one-click +//! add where the client has a CLI (run only on that click, its command shown first), and a test +//! that starts the MCP server and lists its tools. With No AI on, only the switch shows. +use super::*; +use horizon_launcher::agents; + +#[derive(Default)] +pub(crate) struct AgentsUi { + /// The client shown, an index into `agents::clients`. + client: usize, + /// Which Copy button just copied. + copied: Option<&'static str>, + /// A command or test running. + busy: bool, + /// What the last add or test said, and whether it went well. + status: Option<(bool, String)>, +} + +impl Launcher { + /// The No AI row: always shown, so it can be turned off again. + pub(crate) fn no_ai_row(&mut self, n: usize, cx: &mut Context) -> Div { + let t = self.theme; + let on = backend::no_ai(); + let toggle = + switch("no-ai", on, &t).on_click(cx.listener(move |this, _: &ClickEvent, _, cx| { + this.agents.status = backend::set_no_ai(!on).err().map(|e| (false, e)); + cx.notify(); + })); + index_row( + n, + "No AI", + Some( + div() + .child(if on { + "On: every AI feature is hidden and off. The game opens no control socket, and horizon-ctl and the MCP servers refuse." + } else { + "Hides and turns off every AI feature: agent control of the launcher and the game, horizon-ctl and the MCP servers." + }) + .into_any_element(), + ), + Some(toggle.into_any_element()), + &t, + ) + } + + /// "Connect an AI agent"; None while No AI is on. + pub(crate) fn agents_section(&mut self, cx: &mut Context) -> Option
    { + if backend::no_ai() { + return None; + } + let t = self.theme; + let exe = backend::exe_path(); + let clients = agents::clients(exe); + let pick = self.agents.client.min(clients.len() - 1); + let client = &clients[pick]; + let this = cx.entity().downgrade(); + let options: Vec<(usize, &'static str)> = clients + .iter() + .enumerate() + .map(|(i, c)| (i, c.name)) + .collect(); + let picker = segments("agent-client", &options, pick, &t, move |i, _, cx| { + let _ = this.update(cx, |this, cx| { + this.agents.client = i; + this.agents.copied = None; + this.agents.status = None; + cx.notify(); + }); + }); + let copy = |id: &'static str, text: String, cx: &mut Context| { + let copied = self.agents.copied == Some(id); + button( + id, + if copied { "Copied" } else { "Copy" }, + Kind::Secondary, + &t, + ) + .on_click(cx.listener(move |this, _: &ClickEvent, _, cx| { + cx.write_to_clipboard(gpui::ClipboardItem::new_string(text.clone())); + this.agents.copied = Some(id); + cx.notify(); + })) + }; + let code = |s: &str| { + div() + .p(px(10.)) + .bg(t.well) + .border_2() + .border_color(t.outline) + .font_family(theme::MONO) + .text_size(px(12.)) + .line_height(px(18.)) + .text_color(t.ink) + .children(s.lines().map(|l| div().child(l.to_owned()))) + }; + let mut section = plate(&t) + .flex() + .flex_col() + .gap(px(12.)) + .p(px(24.)) + .text_size(px(theme::UI.px)) + .line_height(px(21.)) + .child(text(theme::HEADING).text_color(t.ink).child("Connect an AI agent")) + .child(div().max_w(px(640.)).text_color(t.muted).child( + "Your own agent (Claude Code, Codex, Cursor or any MCP client) can drive the launcher and the game it starts, with the same commands as the terminal. It runs on your computer and talks to Horizon there; it asks before deleting anything.", + )) + .child(picker); + if let Some((program, args)) = client.add.clone() { + let line = client.add_line().unwrap_or_default(); + let label = format!("Add to {}", client.name); + let busy = self.agents.busy; + let add = button( + "agent-add", + if busy { "Running…".to_owned() } else { label }, + Kind::Primary, + &t, + ) + .on_click(cx.listener(move |this, _: &ClickEvent, _, cx| { + if this.agents.busy { + return; + } + this.agents.busy = true; + this.agents.status = None; + let (program, args) = (program, args.clone()); + let task = cx + .background_executor() + .spawn(async move { run_add(program, &args) }); + cx.spawn(async move |this, cx| { + let result = task.await; + let _ = this.update(cx, |this, cx| { + this.agents.busy = false; + this.agents.status = Some(result); + cx.notify(); + }); + }) + .detach(); + cx.notify(); + })); + section = section + .child(div().text_color(t.muted).child(format!( + "{} adds it with this command (it runs only when you click):", + client.name + ))) + .child(code(&line)) + .child(div().flex().gap(px(8.)).child(add).child(copy( + "agent-copy-command", + line.clone(), + cx, + ))); + } + section = section + .child(div().text_color(t.muted).child(format!( + "{} {}:", + if client.add.is_some() { "Or put this in" } else { "Put this in" }, + client.file + ))) + .child(code(&client.config)) + .child(div().flex().gap(px(8.)).child(copy("agent-copy-config", client.config.clone(), cx)).child( + button("agent-test", "Test the connection", Kind::Secondary, &t).on_click(cx.listener( + |this, _: &ClickEvent, _, cx| { + if this.agents.busy { + return; + } + this.agents.busy = true; + this.agents.status = None; + let exe = backend::exe_path().to_path_buf(); + let task = cx.background_executor().spawn(async move { + match agents::self_test(&exe) { + Ok(n) => (true, format!("The MCP server answered with {n} tools. Now ask your agent: \"Say hello from Horizon\".")), + Err(e) => (false, format!("The MCP server did not answer: {e}")), + } + }); + cx.spawn(async move |this, cx| { + let result = task.await; + let _ = this.update(cx, |this, cx| { + this.agents.busy = false; + this.agents.status = Some(result); + cx.notify(); + }); + }) + .detach(); + cx.notify(); + }, + )), + )); + if let Some((ok, message)) = &self.agents.status { + section = section.child( + div() + .text_color(if *ok { t.ink } else { t.danger }) + .child(message.clone()), + ); + } + Some( + section.child( + div() + .id("agent-docs") + .text_color(t.accent) + .cursor_pointer() + .hover(|s| s.opacity(0.8)) + .child("What an agent can do, and the commands") + .on_click(|_, _, cx| cx.open_url(backend::AGENT_DOCS_URL)), + ), + ) + } +} + +/// Runs a client's add command; (went well, what it said). +fn run_add(program: &str, args: &[String]) -> (bool, String) { + match std::process::Command::new(agents::locate(program)) + .args(args) + .output() + { + Ok(out) if out.status.success() => ( + true, + format!( + "Added. Restart {program} if it is open, then ask it: \"Say hello from Horizon\"." + ), + ), + Ok(out) => ( + false, + format!( + "{program} said: {}", + String::from_utf8_lossy(if out.stderr.is_empty() { + &out.stdout + } else { + &out.stderr + }) + .trim() + ), + ), + Err(e) if e.kind() == std::io::ErrorKind::NotFound => ( + false, + format!( + "{program} is not installed here (or not on the PATH): copy the config instead." + ), + ), + Err(e) => (false, format!("Could not run {program}: {e}")), + } +} diff --git a/launcher/src/backend.rs b/launcher/src/backend.rs index b5f511ee9..f88171c4e 100644 --- a/launcher/src/backend.rs +++ b/launcher/src/backend.rs @@ -11,6 +11,8 @@ use std::sync::{Arc, Mutex}; pub const REPO: &str = "ludovic111/horizon"; pub const README_URL: &str = "https://github.com/ludovic111/horizon/blob/main/launcher/README.md"; +/// The players' page on connecting an AI agent (website/docs/agents.md). +pub const AGENT_DOCS_URL: &str = "https://playhorizon.dev/docs/agents"; /// This launcher's version: the release workflow sets `HORIZON_LAUNCHER_VERSION` from the /// tag it builds (no version-bump commits); other builds say Cargo.toml's. pub const VERSION: &str = version_or(option_env!("HORIZON_LAUNCHER_VERSION")); diff --git a/launcher/src/cli.rs b/launcher/src/cli.rs index aba6c7ae1..732aa872b 100644 --- a/launcher/src/cli.rs +++ b/launcher/src/cli.rs @@ -368,6 +368,9 @@ enum Cmd { /// Only this client #[arg(long, value_parser = ["claude-code", "codex", "cursor", "generic"])] client: Option, + /// Start the MCP server as a client would and say whether it answered + #[arg(long)] + test: bool, }, /// Show or set No AI: on hides and turns off every AI feature (the companion, agent control, /// horizon-ctl and both MCP servers); off, the default, makes them available @@ -673,7 +676,15 @@ fn execute(command: Cmd, as_json: bool) -> Result<(), String> { println!("No AI is off: AI features are available."); } } - Cmd::AgentConfig { client } => { + Cmd::AgentConfig { test: true, .. } => { + let tools = horizon_launcher::agents::self_test(backend::exe_path())?; + if as_json { + json(serde_json::json!({ "answered": true, "tools": tools })); + } else { + println!("The MCP server answered with {tools} tools."); + } + } + Cmd::AgentConfig { client, .. } => { use horizon_launcher::agents; let exe = backend::exe_path(); if as_json { diff --git a/launcher/src/main.rs b/launcher/src/main.rs index 237ac0402..128bf1bcf 100644 --- a/launcher/src/main.rs +++ b/launcher/src/main.rs @@ -1,6 +1,7 @@ //! Horizon launcher: installs Horizon builds, prepares them from the player's own Minecraft, //! and starts the client or a dedicated server. +mod agents_page; mod art; mod blocks; mod cli; @@ -180,6 +181,8 @@ struct Launcher { args_focus: FocusHandle, /// Opt-in data collection: the player's answer and Settings' section (`collection`). collection: collection::Collection, + /// Settings' "Connect an AI agent" (`agents_page`). + agents: agents_page::AgentsUi, /// How many play Horizon now, while the server answers ("N playing now" on the Play page). playing: Option, tx: Sender, @@ -307,6 +310,7 @@ impl Launcher { friend_focus: cx.focus_handle(), joining: None, collection: collection::Collection::load(), + agents: agents_page::AgentsUi::default(), playing: None, tx, rx, @@ -2433,36 +2437,6 @@ impl Launcher { }; let mono = |s: String| div().font_family(theme::MONO).child(s).into_any_element(); let plain = |s: &str| div().child(s.to_string()).into_any_element(); - let agents = plate(&t) - .flex() - .flex_col() - .gap(px(10.)) - .p(px(24.)) - .text_size(px(theme::UI.px)) - .line_height(px(21.)) - .child( - text(theme::HEADING) - .text_color(t.ink) - .child("Use from the command line or AI agents"), - ) - .child(div().max_w(px(600.)).text_color(t.muted).child( - "The launcher is also a command-line tool and an MCP server. Everything here works from a terminal, or from an agent such as Claude Code:", - )) - .child( - text(theme::CAPTION) - .font_family(theme::MONO) - .text_color(t.ink) - .child("claude mcp add horizon -- horizon-launcher mcp"), - ) - .child( - div() - .id("readme") - .text_color(t.accent) - .cursor_pointer() - .hover(|s| s.opacity(0.8)) - .child("Commands and tools, in the README") - .on_click(|_, _, cx| cx.open_url(backend::README_URL)), - ); let (accounts, n) = self.account_rows(cx); let appearance = segments( "appearance", @@ -2546,6 +2520,8 @@ impl Launcher { )) .child(group("Game", "gamepad")) .child(self.game_args_row(n + 4, cx)) + .child(group("AI", "terminal")) + .child(self.no_ai_row(n + 4, cx)) .child(group("About", "info-box")) .child(index_row(n + 5, "Horizon", Some(plain(&horizon)), horizon_action, &t)) .child(index_row( @@ -2595,7 +2571,7 @@ impl Launcher { }), ) .child(self.collection_section(cx)) - .child(agents) + .children(self.agents_section(cx)) } /// Settings' Game arguments row: the extra arguments the game starts with, kept in diff --git a/tools/launcher_mcp_e2e.py b/tools/launcher_mcp_e2e.py index fecf21899..0b827d288 100644 --- a/tools/launcher_mcp_e2e.py +++ b/tools/launcher_mcp_e2e.py @@ -122,6 +122,8 @@ def no_ai_scenario(launcher, env, home): config = json.loads(run('agent-config', '--json').stdout) assert config['server']['args'] == ['mcp'] and len(config['clients']) == 4, config assert 'agent-config' in run('--help').stdout + test = json.loads(run('agent-config', '--test', '--json').stdout) + assert test['answered'] and test['tools'] > 100, test m = Mcp(launcher, env) m.rpc('initialize', {'protocolVersion': '2025-06-18', 'capabilities': {}, 'clientInfo': {'name': 'launcher_mcp_e2e', 'version': '1'}}) From 3bfb345714f479654840bd4004b3cd7862369f37 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 02:47:42 +0200 Subject: [PATCH 086/126] horizon-ctl options: the agent page (Horizon Settings > AI Agent) Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/bin/horizon-ctl/commands.rs | 1 + docs/horizon-ctl-commands.md | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/crates/horizon-client/src/bin/horizon-ctl/commands.rs b/crates/horizon-client/src/bin/horizon-ctl/commands.rs index 5d5d3c7ed..0bda3c1ad 100644 --- a/crates/horizon-client/src/bin/horizon-ctl/commands.rs +++ b/crates/horizon-client/src/bin/horizon-ctl/commands.rs @@ -148,6 +148,7 @@ const PAGES: Ty = Ty::Enum(&[ "extras", "horizon", "shader-packs", + "agent", ]); /// `--confirm`, required by destructive commands: the player agreed. diff --git a/docs/horizon-ctl-commands.md b/docs/horizon-ctl-commands.md index c53016824..4bc4b2c34 100644 --- a/docs/horizon-ctl-commands.md +++ b/docs/horizon-ctl-commands.md @@ -94,7 +94,7 @@ Every command `horizon-ctl` takes, its MCP tool in `horizon-ctl mcp` (the launch | `respawn` | `respawn` | Respawn from the death screen | none | | `pause` | `pause` | Open the pause menu | none | | `resume` | `resume` | Leave the pause menu | none | -| `options [PAGE]` | `options` | Open the options screen, or one of its pages (Horizon's too) | `page` (main, video, sound, controls, keybinds, controller, controller-binds, mouse, chat, accessibility, language, font, packs, mods, graphics, graphics-advanced, extras, horizon, shader-packs): the page (default: the main options) | +| `options [PAGE]` | `options` | Open the options screen, or one of its pages (Horizon's too) | `page` (main, video, sound, controls, keybinds, controller, controller-binds, mouse, chat, accessibility, language, font, packs, mods, graphics, graphics-advanced, extras, horizon, shader-packs, agent): the page (default: the main options) | | `book [next\|back\|take\|done]` | `book` | The open book or lectern: its page text, or press one of its buttons | `action` (next, back, take, done): a button to press | | `signedit X Y Z [front\|back]` | `signedit` | Open the sign editor of the sign at X Y Z (then type and close) | `x` (integer, required): block X
    `y` (integer, required): block Y
    `z` (integer, required): block Z
    `side` (front, back): which side | | `mount-menu` | `mount_menu` | Open the inventory of the horse, donkey, mule or llama being ridden | none | From 75d818fad64e5347ecac7eadd1e2185d384e5b52 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 02:55:38 +0200 Subject: [PATCH 087/126] Telemetry: the screen also when Wayland names it late Right after a window is made, Wayland doesn't say which screen it is on, so current_monitor() is None and display was missing (seen end to end in a headless sway). Fall back to the primary, else the only, monitor, and read it again when a session ends; agent control's status (the benchmark report's display) uses the same. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game.rs | 22 ++++++-------------- crates/horizon-client/src/game/control.rs | 2 +- crates/horizon-client/src/telemetry.rs | 25 +++++++++++++++++++++++ 3 files changed, 32 insertions(+), 17 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index f69198a92..eb916b341 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -7703,6 +7703,10 @@ impl Game<'_> { fullscreen: s.fullscreen, graphics: s.graphics_preset.clone(), }; + // Again now: on Wayland the window is on a screen only once it has been shown. + if let Some(window) = &self.window { + horizon_client::telemetry::note_display(window); + } self.perf .finish(&horizon_client::logging::game_home(), settings); } @@ -10501,14 +10505,7 @@ impl ApplicationHandler for Game<'_> { return; } }; - if let Some(m) = window.current_monitor() { - horizon_client::telemetry::set_display( - m.size().width, - m.size().height, - m.refresh_rate_millihertz().map_or(0, |r| r.div_ceil(1000)), - m.scale_factor(), - ); - } + horizon_client::telemetry::note_display(&window); match self.new_renderer(window.clone()) { Ok(r) => { self.renderer = Some(r); @@ -12600,14 +12597,7 @@ impl Loading { return; } }; - if let Some(m) = window.current_monitor() { - horizon_client::telemetry::set_display( - m.size().width, - m.size().height, - m.refresh_rate_millihertz().map_or(0, |r| r.div_ceil(1000)), - m.scale_factor(), - ); - } + horizon_client::telemetry::note_display(&window); let offscreen = self.options.as_ref().is_some_and(|o| o.offscreen); match loading_renderer( window.clone(), diff --git a/crates/horizon-client/src/game/control.rs b/crates/horizon-client/src/game/control.rs index 6c5eec301..0db55a111 100644 --- a/crates/horizon-client/src/game/control.rs +++ b/crates/horizon-client/src/game/control.rs @@ -906,7 +906,7 @@ impl Game<'_> { "streaming": self.streaming.stages().into_iter().map(|(k, v)| (k.to_string(), v.into())).collect::>(), "dirty_light": self.world.dirty_light.len(), "renderer": renderer, - "display": self.window.as_ref().and_then(|w| w.current_monitor()).map(|m| json!({ + "display": self.window.as_deref().and_then(horizon_client::telemetry::monitor).map(|m| json!({ "width": m.size().width, "height": m.size().height, "scale": m.scale_factor(), diff --git a/crates/horizon-client/src/telemetry.rs b/crates/horizon-client/src/telemetry.rs index b8b7af0b4..afd2dbc94 100644 --- a/crates/horizon-client/src/telemetry.rs +++ b/crates/horizon-client/src/telemetry.rs @@ -88,6 +88,31 @@ pub fn set_display(width: u32, height: u32, refresh_hz: u32, scale: f64) { }); } +/// The screen `window` is on, else the primary one, else the only one: right after the window +/// is made, Wayland doesn't say yet which screen it is on. +pub fn monitor(window: &winit::window::Window) -> Option { + let only = || { + let mut all = window.available_monitors(); + all.next().filter(|_| all.next().is_none()) + }; + window + .current_monitor() + .or_else(|| window.primary_monitor()) + .or_else(only) +} + +/// Keeps [`monitor`]'s size, refresh rate and scale for the items' `system.display`. +pub fn note_display(window: &winit::window::Window) { + if let Some(m) = monitor(window) { + set_display( + m.size().width, + m.size().height, + m.refresh_rate_millihertz().map_or(0, |r| r.div_ceil(1000)), + m.scale_factor(), + ); + } +} + /// wgpu's device type in the words items use. pub fn gpu_kind(device_type: &str) -> &'static str { match device_type { From 768f14919038fa03e6e5a7d6d51772c75b09c212 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 03:04:19 +0200 Subject: [PATCH 088/126] Horizon Settings > AI Agent: turn agent control on, see who is connected, copy the details Horizon Settings gains a row: "AI Agent..." and "No AI: Off". No AI hides the AI Agent page and closes the control socket at once. The AI Agent page has an Agent Control switch (horizon-extras.txt agentControl, off by default): on, the game the player starts opens the default control endpoint, so horizon-ctl and MCP clients reach it without --control. Turning it off closes the endpoint at once; dropping a control server now also stops its listener thread. The page shows whether an agent is connected, when it last sent a command and the socket, and Copy Connection Details copies the socket path, a horizon-ctl line to try and the MCP config for this game. agent_control_e2e.py --scenario setting covers it: Agent Control on opens the endpoint without --control, the pages list their widgets, Copy works, and turning the switch off removes the endpoint while the game keeps running. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/control.rs | 54 ++++++- crates/horizon-client/src/extras.rs | 25 +++- crates/horizon-client/src/game.rs | 20 +-- .../horizon-client/src/game/agent_settings.rs | 140 ++++++++++++++++++ crates/horizon-client/src/game/control.rs | 7 + crates/horizon-client/src/game/options.rs | 7 + .../horizon-client/src/game/startup_menu.rs | 3 +- crates/horizon-client/src/options_ui.rs | 64 ++++++++ tools/agent_control_e2e.py | 70 ++++++++- 9 files changed, 370 insertions(+), 20 deletions(-) create mode 100644 crates/horizon-client/src/game/agent_settings.rs diff --git a/crates/horizon-client/src/control.rs b/crates/horizon-client/src/control.rs index 9749cc9bd..931bcbdf5 100644 --- a/crates/horizon-client/src/control.rs +++ b/crates/horizon-client/src/control.rs @@ -13,7 +13,11 @@ use std::{ io::{self, BufRead, BufReader, Read, Write}, net::{Ipv4Addr, TcpListener, TcpStream}, path::{Path, PathBuf}, - sync::mpsc, + sync::{ + Arc, + atomic::{AtomicBool, AtomicUsize, Ordering}, + mpsc, + }, thread, }; @@ -151,6 +155,12 @@ pub struct Server { path: PathBuf, requests: mpsc::Receiver, sender: mpsc::Sender, + /// Clients connected now (an MCP server keeps one open; horizon-ctl one per command). + clients: Arc, + /// Set when the server is dropped: the listener stops accepting and exits. + closed: Arc, + /// The TCP port, to wake the listener when closing. + port: Option, } /// `$HORIZON_CONTROL`, else `horizon-control.sock` in the user's runtime @@ -174,10 +184,15 @@ impl Server { } let (sender, requests) = mpsc::channel(); let local = sender.clone(); + let clients = Arc::new(AtomicUsize::new(0)); + let counted = clients.clone(); + let closed = Arc::new(AtomicBool::new(false)); + let mut tcp_port = None; if uses_tcp(path) { let listener = TcpListener::bind((Ipv4Addr::LOCALHOST, 0))?; let token = random_token(); let port = listener.local_addr()?.port(); + tcp_port = Some(port); write_private( path, &serde_json::json!({ "transport": "tcp", "port": port, "token": token }) @@ -186,6 +201,8 @@ impl Server { spawn_listener( move || listener.accept().map(|(s, _)| s), sender, + counted, + closed.clone(), move |stream: TcpStream| { let _ = stream.set_nodelay(true); let mut stream = Stream::Tcp(stream); @@ -199,6 +216,8 @@ impl Server { spawn_listener( move || listener.accept().map(|(s, _)| s), sender, + counted, + closed.clone(), |s| Some(Stream::Unix(s)), )?; } @@ -207,6 +226,9 @@ impl Server { path: path.to_owned(), requests, sender: local, + clients, + closed, + port: tcp_port, }) } /// Commands from inside the process only (`--benchmark` without `--control`). @@ -216,8 +238,15 @@ impl Server { path: PathBuf::new(), requests, sender, + clients: Arc::default(), + closed: Arc::default(), + port: None, } } + /// How many clients are connected. + pub fn clients(&self) -> usize { + self.clients.load(Ordering::Relaxed) + } /// Sends commands as a socket client would, from another thread. pub fn sender(&self) -> mpsc::Sender { self.sender.clone() @@ -234,6 +263,8 @@ impl Server { fn spawn_listener( mut accept_next: impl FnMut() -> io::Result + Send + 'static, sender: mpsc::Sender, + clients: Arc, + closed: Arc, accept: impl Fn(S) -> Option + Send + Sync + 'static, ) -> io::Result<()> { let accept = std::sync::Arc::new(accept); @@ -241,17 +272,24 @@ fn spawn_listener( .name("horizon-control".into()) .spawn(move || { loop { - let Ok(stream) = accept_next() else { + let next = accept_next(); + if closed.load(Ordering::Relaxed) { + return; + } + let Ok(stream) = next else { thread::sleep(std::time::Duration::from_millis(10)); continue; }; let sender = sender.clone(); let accept = accept.clone(); + let clients = clients.clone(); let _ = thread::Builder::new() .name("horizon-control-client".into()) .spawn(move || { if let Some(stream) = accept(stream) { + clients.fetch_add(1, Ordering::Relaxed); serve(stream, &sender); + clients.fetch_sub(1, Ordering::Relaxed); } }); } @@ -287,6 +325,18 @@ fn authenticate(stream: &mut Stream, token: &str) -> bool { impl Drop for Server { fn drop(&mut self) { + if self.path.as_os_str().is_empty() { + return; + } + // Wake the listener so it sees `closed` and exits (agent control turned off in-game). + self.closed.store(true, Ordering::Relaxed); + match self.port { + Some(port) => drop(TcpStream::connect((Ipv4Addr::LOCALHOST, port))), + #[cfg(unix)] + None => drop(UnixStream::connect(&self.path)), + #[cfg(not(unix))] + None => {} + } let _ = std::fs::remove_file(&self.path); } } diff --git a/crates/horizon-client/src/extras.rs b/crates/horizon-client/src/extras.rs index 2dbcd1a8f..698741846 100644 --- a/crates/horizon-client/src/extras.rs +++ b/crates/horizon-client/src/extras.rs @@ -109,6 +109,9 @@ pub struct Extras { pub sort_key: String, /// No AI: every AI feature hidden and off (`horizon_core::no_ai`; the launcher writes it too). pub no_ai: bool, + /// Agents may control the game the player starts: it opens its control socket for + /// horizon-ctl and MCP clients (off by default; an agent's own launch always opens it). + pub agent_control: bool, } impl Default for Extras { fn default() -> Self { @@ -138,6 +141,7 @@ impl Default for Extras { sort: false, sort_key: "key.keyboard.unknown".into(), no_ai: false, + agent_control: false, } } } @@ -202,6 +206,7 @@ impl Extras { "sort" => e.sort = flag(e.sort), "sortKey" if value.starts_with("key.") => e.sort_key = value.to_owned(), horizon_core::no_ai::KEY => e.no_ai = flag(e.no_ai), + "agentControl" => e.agent_control = flag(e.agent_control), _ => {} } } @@ -209,7 +214,7 @@ impl Extras { } pub fn serialize(&self) -> String { format!( - "fullbright:{}\ndynamicLights:{}\nzoom:{}\nzoomKey:{}\nzoomLevel:{}\nzoomSmooth:{}\nzoomSensitivity:{}\nfps:{}\nfpsCorner:{}\nfpsLows:{}\nkeystrokes:{}\nkeystrokesCorner:{}\nkeystrokesCps:{}\nminimap:{}\nminimapCorner:{}\nminimapSize:{}\nminimapShape:{}\nminimapZoom:{}\nminimapRotate:{}\nautoReconnect:{}\nmouseTweaks:{}\nmouseTweaksWheel:{}\nsort:{}\nsortKey:{}\n{}:{}\n", + "fullbright:{}\ndynamicLights:{}\nzoom:{}\nzoomKey:{}\nzoomLevel:{}\nzoomSmooth:{}\nzoomSensitivity:{}\nfps:{}\nfpsCorner:{}\nfpsLows:{}\nkeystrokes:{}\nkeystrokesCorner:{}\nkeystrokesCps:{}\nminimap:{}\nminimapCorner:{}\nminimapSize:{}\nminimapShape:{}\nminimapZoom:{}\nminimapRotate:{}\nautoReconnect:{}\nmouseTweaks:{}\nmouseTweaksWheel:{}\nsort:{}\nsortKey:{}\n{}:{}\nagentControl:{}\n", bool_text(self.fullbright), bool_text(self.dynamic_lights), bool_text(self.zoom), @@ -240,6 +245,7 @@ impl Extras { self.sort_key, horizon_core::no_ai::KEY, bool_text(self.no_ai), + bool_text(self.agent_control), ) } /// Binds the extra key `name` (`ZOOM_KEY`, `SORT_KEY`); false for @@ -457,6 +463,9 @@ pub enum Item { MouseTweaksWheel, Sort, SortKey, + /// Not on the Extras page: Horizon Settings shows No AI, its AI Agent page Agent Control. + NoAi, + AgentControl, } /// The Extras page: headers and items. pub fn rows() -> Vec> { @@ -535,6 +544,8 @@ impl Item { Item::FpsLows => "Minimum and 1% low", Item::Keystrokes => "Keystrokes", Item::KeystrokesCps => "Clicks per second", + Item::NoAi => "No AI", + Item::AgentControl => "Agent Control", } } /// The switch this setting belongs to: it does nothing while that is off. @@ -548,7 +559,7 @@ impl Item { MouseTweaksWheel => MouseTweaks, SortKey => Sort, Fullbright | DynamicLights | Zoom | Minimap | Fps | Keystrokes | MouseTweaks | Sort - | AutoReconnect => { + | AutoReconnect | NoAi | AgentControl => { return None; } }) @@ -592,6 +603,12 @@ impl Item { } Item::Keystrokes => "Movement keys, jump and mouse buttons as you press them.", Item::KeystrokesCps => "Clicks in the last second under each mouse button.", + Item::NoAi => { + "Hides and turns off every AI feature: agent control, horizon-ctl and the MCP servers. The launcher's switch too." + } + Item::AgentControl => { + "Your own AI agent can play this game through horizon-ctl or an MCP client, on this computer only." + } } } /// The frame-time cost the main switch of an extra shows. @@ -622,6 +639,8 @@ impl Item { Item::MouseTweaks => e.mouse_tweaks, Item::MouseTweaksWheel => e.mouse_tweaks_wheel, Item::Sort => e.sort, + Item::NoAi => e.no_ai, + Item::AgentControl => e.agent_control, _ => return None, }) } @@ -677,6 +696,8 @@ impl Item { } Item::MinimapShape => e.minimap_round = !e.minimap_round, Item::MinimapZoom => e.minimap_zoom = next(&MINIMAP_ZOOMS, e.minimap_zoom, back), + Item::NoAi => e.no_ai = !e.no_ai, + Item::AgentControl => e.agent_control = !e.agent_control, Item::ZoomKey | Item::SortKey => {} } } diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index aeab446d1..7d12ec63c 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -3,6 +3,7 @@ mod advancements; mod advancements_screen; mod agent; +mod agent_settings; mod allays; mod armor_stands; mod banners; @@ -1427,6 +1428,10 @@ struct Game<'a> { item_columns: Option, creative_screen: Creative, control: Option, + /// The Agent Control setting the socket was last opened or closed for (`agent_settings`). + agent_control_on: bool, + /// When an agent's last command came. + agent_last: Option, frame_stats: horizon_client::control::FrameStats, /// This play session's frame and tick times, for opt-in performance statistics. perf: horizon_client::telemetry::Session, @@ -11645,6 +11650,8 @@ impl<'a> Game<'a> { item_columns: None, creative_screen: prepared.creative_screen, control: None, + agent_control_on: false, + agent_last: None, frame_stats: Default::default(), perf: Default::default(), pending_screenshot: None, @@ -12439,18 +12446,7 @@ fn start_game<'a>( game.mods.dev = game.options.dev_mods.clone(); game.start_mods(); } - if game.options.control.is_some() && game.settings.extras.no_ai { - // No AI turns agent control off: the socket is never opened. - log::warn!( - "Horizon: control socket not opened: {}", - horizon_core::no_ai::REFUSAL - ); - } else if let Some(path) = &game.options.control { - let server = horizon_client::control::Server::start(path) - .map_err(|e| format!("control socket {}: {e}", path.display()))?; - log::info!("Horizon: control socket {}", server.path().display()); - game.control = Some(server); - } + game.start_agent_control()?; if let Some(scenario) = game.options.benchmark.clone() { let control = game .control diff --git a/crates/horizon-client/src/game/agent_settings.rs b/crates/horizon-client/src/game/agent_settings.rs new file mode 100644 index 000000000..5045f1c49 --- /dev/null +++ b/crates/horizon-client/src/game/agent_settings.rs @@ -0,0 +1,140 @@ +//! Agent control as a setting (Horizon Settings > AI Agent): when the control socket is open, who +//! is connected, and the details an agent needs. The socket opens when the game was started for +//! an agent (`--control`, `--control-socket`: horizon-ctl launch, the launcher's MCP `play`) or +//! when the player turned Agent Control on, and never under No AI (`horizon_core::no_ai`). +//! Turning either switch in the game opens or closes it at once. +use super::Game; +use horizon_client::{Result, control}; +use std::path::PathBuf; + +impl Game<'_> { + /// The endpoint: the one the command line gave, else the default horizon-ctl looks for. + fn agent_socket_path(&self) -> PathBuf { + self.options + .control + .clone() + .unwrap_or_else(control::default_path) + } + + /// At startup: open the socket if the game was started for an agent or Agent Control is on. + pub(super) fn start_agent_control(&mut self) -> Result<()> { + self.agent_control_on = self.settings.extras.agent_control; + if self.options.benchmark.is_some() && self.options.control.is_none() { + return Ok(()); + } + if self.settings.extras.no_ai { + if self.options.control.is_some() { + log::warn!( + "Horizon: control socket not opened: {}", + horizon_core::no_ai::REFUSAL + ); + } + return Ok(()); + } + if let Some(path) = &self.options.control { + // Asked for on the command line: failing to listen is an error. + let server = control::Server::start(path) + .map_err(|e| format!("control socket {}: {e}", path.display()))?; + log::info!("Horizon: control socket {}", server.path().display()); + self.control = Some(server); + } else if self.agent_control_on { + self.open_agent_socket(); + } + Ok(()) + } + + /// The setting's socket: a failure (another game holds the default endpoint) is logged and + /// shown on the AI Agent page, not fatal. + fn open_agent_socket(&mut self) { + let path = self.agent_socket_path(); + match control::Server::start(&path) { + Ok(server) => { + log::info!("Horizon: control socket {}", server.path().display()); + self.control = Some(server); + } + Err(e) => log::warn!("Horizon: control socket {}: {e}", path.display()), + } + } + + /// After a settings change: No AI closes the socket; Agent Control turned on or off opens or + /// closes it. + pub(super) fn sync_agent_control(&mut self) { + let wanted = self.settings.extras.agent_control; + let changed = wanted != self.agent_control_on; + self.agent_control_on = wanted; + let open = self + .control + .as_ref() + .is_some_and(|c| !c.path().as_os_str().is_empty()); + if self.settings.extras.no_ai || (changed && !wanted) { + if open { + log::info!("Horizon: control socket closed"); + self.control = None; + } + } else if changed && wanted && self.control.is_none() { + self.open_agent_socket(); + } + } + + /// An agent's command arrived. + pub(super) fn agent_command_seen(&mut self) { + self.agent_last = Some(std::time::Instant::now()); + } + + /// The AI Agent page's lines: the state, then where agents connect. + pub(super) fn agent_status_lines(&self) -> Vec { + let server = self + .control + .as_ref() + .filter(|c| !c.path().as_os_str().is_empty()); + let mut lines = vec![match server { + Some(s) if s.clients() > 0 => { + let ago = self + .agent_last + .map(|t| format!(", last command {} s ago", t.elapsed().as_secs())) + .unwrap_or_default(); + format!( + "Connected: {} agent connection{}{ago}", + s.clients(), + if s.clients() == 1 { "" } else { "s" } + ) + } + Some(_) => "Waiting for an agent.".into(), + None => "Off: agents can't reach this game.".into(), + }]; + if let Some(s) = server { + if self.options.control.is_some() && !self.agent_control_on { + lines.push("Opened for this session by the program that started the game.".into()); + } + // The full path is too wide for the page: Copy Connection Details has it. + let name = s.path().file_name().unwrap_or_default().to_string_lossy(); + lines.push(format!( + "Socket: {name} (copy the details for its full path)" + )); + } + lines.push("Local only: agents on this computer, never the network.".into()); + lines + } + + /// What Copy Connection Details puts on the clipboard: the socket, a horizon-ctl line to try, + /// and an MCP client's config for this game. + pub(super) fn agent_details(&self) -> String { + let socket = self.agent_socket_path(); + let ctl = std::env::current_exe() + .unwrap_or_default() + .with_file_name(if cfg!(windows) { + "horizon-ctl.exe" + } else { + "horizon-ctl" + }); + let config = serde_json::json!({ "mcpServers": { "horizon-game": { + "command": ctl, "args": ["--socket", socket, "mcp"] } } }); + format!( + "Horizon agent control (this computer only)\nSocket: {}\nTry it: \"{}\" --socket \"{}\" state\nMCP config:\n{}\n", + socket.display(), + ctl.display(), + socket.display(), + serde_json::to_string_pretty(&config).unwrap_or_default() + ) + } +} diff --git a/crates/horizon-client/src/game/control.rs b/crates/horizon-client/src/game/control.rs index 6c5eec301..23843bddf 100644 --- a/crates/horizon-client/src/game/control.rs +++ b/crates/horizon-client/src/game/control.rs @@ -117,6 +117,7 @@ impl Game<'_> { self.answer(request, event_loop); } while let Some(request) = self.control.as_ref().and_then(|c| c.try_recv()) { + self.agent_command_seen(); self.answer(request, event_loop); if self.pending_save.is_some() { break; @@ -125,6 +126,11 @@ impl Game<'_> { if self.control.is_some() { self.watch_events(); } + if self.screen == Screen::Options + && self.ui.options.page() == horizon_client::options_ui::Page::Agent + { + self.ui.options.agent_status = self.agent_status_lines(); + } } fn answer(&mut self, request: horizon_client::control::Request, event_loop: &ActiveEventLoop) { @@ -565,6 +571,7 @@ impl Game<'_> { "graphics-advanced" => Page::GraphicsAdvanced, "extras" => Page::Extras, "horizon" => Page::Horizon, + "agent" => Page::Agent, "shader-packs" => Page::ShaderPacks, other => return Err(format!("unknown options page {other}").into()), }; diff --git a/crates/horizon-client/src/game/options.rs b/crates/horizon-client/src/game/options.rs index 61036d18c..dd298619d 100644 --- a/crates/horizon-client/src/game/options.rs +++ b/crates/horizon-client/src/game/options.rs @@ -200,6 +200,13 @@ impl Game<'_> { self.settings.save(&Self::options_path()); self.apply_settings(); self.sync_mods(); + self.sync_agent_control(); + self.ui.options.agent_status = self.agent_status_lines(); + } + Event::CopyAgentDetails => { + use horizon_client::clipboard::Clipboard; + let text = self.agent_details(); + self.clipboard.set(&text); } Event::Close if self.ui.options.resource_error.is_some() => {} Event::Close => { diff --git a/crates/horizon-client/src/game/startup_menu.rs b/crates/horizon-client/src/game/startup_menu.rs index 0c8376397..05a08ee61 100644 --- a/crates/horizon-client/src/game/startup_menu.rs +++ b/crates/horizon-client/src/game/startup_menu.rs @@ -370,7 +370,8 @@ impl Loading { let _ = std::fs::create_dir_all(&dir); packs::open_folder(&dir); } - Event::ButtonClick => {} + // The startup menu runs before the game opens a control socket. + Event::ButtonClick | Event::CopyAgentDetails => {} } } } diff --git a/crates/horizon-client/src/options_ui.rs b/crates/horizon-client/src/options_ui.rs index 6431ae613..a981bfdee 100644 --- a/crates/horizon-client/src/options_ui.rs +++ b/crates/horizon-client/src/options_ui.rs @@ -874,6 +874,8 @@ pub enum Page { /// Horizon Settings: every page Horizon adds, as a mod's settings /// screen hangs off vanilla's Options. Horizon, + /// AI Agent: agent control on or off, whether an agent is connected, the connection details. + Agent, } #[derive(Clone, Debug, PartialEq)] enum Act { @@ -894,6 +896,7 @@ enum Act { /// Pick shader pack `i` of `OptionsUi::shader_packs` (again: off). ToggleShaderPack(usize), OpenShaderPackFolder, + CopyAgentDetails, } enum WKind { Button { @@ -943,6 +946,8 @@ pub enum Event { OpenModFolder, /// Create `shaderpacks/` if needed and open it. OpenShaderPackFolder, + /// Copy how an agent connects (the AI Agent page). + CopyAgentDetails, } /// `SliderableValueSet.applyValueImmediately`: these apply 600 ms after /// the last change (`OptionInstanceSliderButton.delayedApplyAt`). @@ -998,6 +1003,8 @@ pub struct OptionsUi { pub shader_packs: crate::shader_pack::Folder, /// The pack that failed to load last and why (set by the game). pub shader_pack_error: Option<(String, String)>, + /// The AI Agent page's status lines (set by the game while it shows). + pub agent_status: Vec, } impl Default for OptionsUi { fn default() -> Self { @@ -1028,6 +1035,7 @@ impl Default for OptionsUi { graphics: Default::default(), shader_packs: Default::default(), shader_pack_error: None, + agent_status: Vec::new(), } } } @@ -1086,6 +1094,7 @@ fn horizon_page_tooltip(page: Page) -> Option<&'static str> { Page::Extras => { "Optional additions, all off by default: the game stays vanilla until you turn one on." } + Page::Agent => "Let your own AI agent play: horizon-ctl and MCP clients on this computer.", Page::Mods => { "Mods made for Horizon, from the horizon-mods folder. Each runs in a sandbox and stays off until you turn it on." } @@ -1107,6 +1116,11 @@ fn pairs(opts: &[Opt]) -> Vec { .collect() } impl OptionsUi { + /// A switch of `horizon-extras.txt` as the Extras page draws it: "Caption: On". + fn extra_button(&self, s: &Settings, item: crate::extras::Item) -> Widget { + let label = format!("{}: {}", item.caption(), item.value(&s.extras)); + button(0.0, 0.0, 150.0, Text::literal(label), Act::Extra(item)) + } fn settings_search_active(&self) -> bool { self.settings_search.focused && matches!(self.page(), Page::Video | Page::Controls | Page::KeyBinds) @@ -1200,6 +1214,7 @@ impl OptionsUi { Page::PadBinds => "Controller Binds", Page::Extras => "Horizon Extras", Page::Horizon => "Horizon Settings", + Page::Agent => "AI Agent", } } fn scrollbar_x(&self, width: f32) -> f32 { @@ -1316,8 +1331,31 @@ impl OptionsUi { open("Extras...", Page::Extras), Some(open("Mods...", Page::Mods)), ), + // No AI hides the AI Agent page and everything AI. + if s.extras.no_ai { + Row::Buttons(self.extra_button(s, crate::extras::Item::NoAi), None) + } else { + Row::Buttons( + open("AI Agent...", Page::Agent), + Some(self.extra_button(s, crate::extras::Item::NoAi)), + ) + }, ] } + Page::Agent => { + let mut rows = vec![Row::Buttons( + self.extra_button(s, crate::extras::Item::AgentControl), + Some(button( + 0.0, + 0.0, + 150.0, + Text::literal("Copy Connection Details"), + Act::CopyAgentDetails, + )), + )]; + rows.extend(self.agent_status.iter().cloned().map(Row::Note)); + rows + } Page::Video => { // Horizon's graphics screens, Simple and Advanced. let mut rows = vec![Row::Buttons( @@ -2499,6 +2537,7 @@ impl OptionsUi { events.push(Event::Changed); } Act::OpenShaderPackFolder => events.push(Event::OpenShaderPackFolder), + Act::CopyAgentDetails => events.push(Event::CopyAgentDetails), Act::None => {} } } @@ -4146,8 +4185,33 @@ mod tests { Page::Controller, Page::Extras, Page::Mods, + Page::Agent, ] ); + // No AI hides the AI Agent page. + let mut no_ai = Settings::default(); + no_ai.extras.no_ai = true; + let (widgets, _, _, _) = ui.layout(&no_ai, 427.0, 240.0); + assert!(!widgets.iter().any(|w| matches!( + &w.kind, + WKind::Button { + act: Act::Push(Page::Agent), + .. + } + ))); + // The AI Agent page: the switch, Copy and the status the game sets. + ui.push(Page::Agent); + ui.agent_status = vec!["Waiting for an agent.".into()]; + let (widgets, _, _, _) = ui.layout(&s, 427.0, 240.0); + let acts: Vec<&Act> = widgets + .iter() + .filter_map(|w| match &w.kind { + WKind::Button { act, .. } => Some(act), + _ => None, + }) + .collect(); + assert!(acts.contains(&&Act::Extra(crate::extras::Item::AgentControl))); + assert!(acts.contains(&&Act::CopyAgentDetails)); // Vanilla's own pages keep the Horizon pages they had. ui.stack = vec![Page::Main, Page::Video]; let video = pushes(&mut ui); diff --git a/tools/agent_control_e2e.py b/tools/agent_control_e2e.py index 5be9e1865..ce012e714 100644 --- a/tools/agent_control_e2e.py +++ b/tools/agent_control_e2e.py @@ -54,7 +54,7 @@ POSITIONAL = { 'click_button': ['label'], 'type': ['text'], 'wait': ['ticks'], 'wait_ready': ['seconds'], 'command': ['command'], 'look_at_block': ['x', 'y', 'z'], 'click': ['id'], 'set': ['id', 'value'], 'give': ['item', 'count'], 'options_get': ['keys'], 'options_set': ['key', 'value'], - 'wait_for': ['condition', 'value'], + 'wait_for': ['condition', 'value'], 'options': ['page'], } # Booleans the game takes as bare words. BARE = {'click_slot': ['right', 'shift'], 'click': ['right', 'middle', 'shift']} @@ -635,9 +635,73 @@ def no_ai_check(mode, ctl, resources): shutil.rmtree(work, ignore_errors=True) +def setting_check(mode, ctl, out, resources): + """Agent Control turned on in Horizon Settings > AI Agent: the game the player starts (no + --control) opens the default endpoint, the page shows the agent connected, Copy Connection + Details copies the socket, and turning the switch off closes the endpoint at once.""" + work, env = scratch(mode, resources) + socket = work / 'c.sock' + env['HORIZON_CONTROL'] = str(socket) # the default endpoint, this home's + (work / 'horizon-extras.txt').write_text('agentControl:true\n') + args = [str(ctl.with_name('horizon-client'))] + if sys.platform == 'darwin': + args.append('--offscreen') + game = subprocess.Popen(args, cwd=work, env=env, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) + d = None + try: + deadline = time.time() + 300 + while not socket.exists(): + assert game.poll() is None, f'the game exited ({game.returncode})' + assert time.time() < deadline, 'Agent Control on, but no control socket' + time.sleep(0.5) + d = (Cli if mode == 'cli' else Mcp)(ctl, socket, work, env) + assert d('state')['screen'] == 'title' # the player's own game, at its title screen + d('options', page='horizon') + tree = widgets(d) + assert {'ai-agent', 'no-ai'} <= set(tree), sorted(tree) + d('screenshot', path=str(out / f'{mode}-horizon-settings.png')) + d('options', page='agent') + tree = widgets(d) + switch = next(w for w in tree.values() if w.get('label', '').startswith('Agent Control')) + assert switch['label'] == 'Agent Control: On', switch + d('screenshot', path=str(out / f'{mode}-ai-agent.png')) + copy = next(w for w in tree.values() if w.get('label') == 'Copy Connection Details') + d('click', id=copy['id']) + # Off: the endpoint goes away and the next command can't reach the game. + try: + d('click', id=switch['id']) + except Failed: + pass # the reply may be lost with the socket + deadline = time.time() + 30 + while socket.exists(): + assert time.time() < deadline, 'Agent Control off, but the socket stayed' + time.sleep(0.5) + assert 'agentControl:false' in (work / 'horizon-extras.txt').read_text() + assert game.poll() is None, 'the game exited when Agent Control went off' + print(f'[{mode}] PASS: setting') + return True + except (Failed, AssertionError, StopIteration, json.JSONDecodeError, subprocess.TimeoutExpired) as e: + print(f'[{mode}] FAIL: setting: {e!r}') + return False + finally: + if d is not None: + try: + d.close() + except Exception: + pass + game.terminate() + try: + game.wait(30) + except subprocess.TimeoutExpired: + game.kill() + shutil.rmtree(work, ignore_errors=True) + + def run(mode, ctl, out, resources, which='survival'): if which == 'no-ai': return no_ai_check(mode, ctl, resources) + if which == 'setting': + return setting_check(mode, ctl, out, resources) work, env = scratch(mode, resources) socket = work / 'c.sock' driver = (Cli if mode == 'cli' else Mcp)(ctl, socket, work, env) @@ -666,7 +730,7 @@ def run(mode, ctl, out, resources, which='survival'): def main(): parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) parser.add_argument('--mode', choices=['cli', 'mcp', 'both'], default='both') - parser.add_argument('--scenario', choices=[*SCENARIOS, 'no-ai', 'all'], default='all') + parser.add_argument('--scenario', choices=[*SCENARIOS, 'no-ai', 'setting', 'all'], default='all') parser.add_argument('--bin-dir', help='prebuilt horizon-client and horizon-ctl (default: build with the fast profile)') parser.add_argument('--out', default=str(ROOT / '.local/agent-control-e2e'), help='screenshots go here') args = parser.parse_args() @@ -684,7 +748,7 @@ def main(): out = Path(args.out) out.mkdir(parents=True, exist_ok=True) modes = ['cli', 'mcp'] if args.mode == 'both' else [args.mode] - scenarios = [*SCENARIOS, 'no-ai'] if args.scenario == 'all' else [args.scenario] + scenarios = [*SCENARIOS, 'no-ai', 'setting'] if args.scenario == 'all' else [args.scenario] results = {f'{m}/{s}': run(m, bins / 'horizon-ctl', out, resources, s) for m in modes for s in scenarios} print(json.dumps(results)) sys.exit(0 if all(results.values()) else 1) From 7db6ce51a60d0166438eddf9b9e327c0c4004a84 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 03:10:58 +0200 Subject: [PATCH 089/126] Docs: control Horizon with your AI agent (players), the full inventory (developers) website/docs/agents.md, in the nav under "Going further", is the player's page. It covers what an agent can do, connecting it from the launcher, copy-paste config for Claude Code, Codex, Cursor and any MCP client, the game's AI Agent page, a CLI quick reference, safety and No AI. docs/agent-control.md is rewritten for developers: - the surfaces, and why one MCP server covers the launcher and the game; - the inventory, before and after, for the launcher and the game; - No AI on every surface, and the launcher commands that stay; - connecting from the launcher and the game; - the design rules for a new command. docs/launcher-commands.md lists every launcher command, its arguments and its MCP tool. It is generated from the clap definition (cli_tools::markdown). The launcher test the_launcher_reference_is_up_to_date fails when it is stale or a tool is undocumented, like horizon-ctl's generated reference. Co-Authored-By: Claude Opus 5.5 --- docs/agent-control.md | 455 ++++++++++++++++++++---------------- docs/launcher-commands.md | 478 ++++++++++++++++++++++++++++++++++++++ launcher/src/cli_tools.rs | 127 ++++++++++ website/docs/agents.md | 126 ++++++++++ website/docs/nav.json | 2 +- 5 files changed, 990 insertions(+), 198 deletions(-) create mode 100644 docs/launcher-commands.md create mode 100644 website/docs/agents.md diff --git a/docs/agent-control.md b/docs/agent-control.md index 8fc59b484..5383cc03c 100644 --- a/docs/agent-control.md +++ b/docs/agent-control.md @@ -1,237 +1,298 @@ # Agent control: driving the launcher and the game -AI agents and scripts control Horizon through four surfaces: +A player's own AI agent (Claude Code, Codex, Cursor, any MCP client) or a script can do +everything a player does with the mouse and keyboard, in the launcher and in the game. This page +covers developers: the surfaces, the full inventory, and the rules every new command follows. +Players read [Control Horizon with your AI agent](../website/docs/agents.md) +(playhorizon.dev/docs/agents). + +The command lists are generated, so they can't drift: + +- [launcher-commands.md](launcher-commands.md): every `horizon-launcher` command, its arguments + and its MCP tool. It comes from the CLI's clap definition (`cli_tools::markdown`), and the + launcher test `the_launcher_reference_is_up_to_date` fails when it is stale or a tool is missing. +- [horizon-ctl-commands.md](horizon-ctl-commands.md): every `horizon-ctl` command, its MCP tool + and its arguments. It comes from the command table (`horizon-ctl help --markdown`), and the + test `the_generated_reference_is_up_to_date` fails when it is stale. + +## Surfaces | Surface | Where | Transport | | --- | --- | --- | -| Game control socket | `horizon-client --control` (`crates/horizon-client/src/control.rs`, commands in `src/game/control.rs`, `agent.rs` and friends) | text line in, one JSON line out; Unix socket, or localhost TCP + token where there is none | -| `horizon-ctl` | `crates/horizon-client/src/bin/horizon-ctl/` | CLI over the socket: one table of commands (`commands.rs`) gives help, argument checks and the MCP tools | -| `horizon-ctl mcp` | same | MCP over stdio, a tool per `horizon-ctl` command | -| Launcher CLI and MCP | `launcher/src/cli.rs`, `launcher/src/mcp.rs` | `horizon-launcher [--json]`; `horizon-launcher mcp` (stdio) | +| Game control socket | `horizon-client --control` / `--control-socket PATH`, or Agent Control on in Horizon Settings > AI Agent (`crates/horizon-client/src/control.rs`; commands in `src/game/control.rs`, `agent.rs`, `ui_control.rs`, `saves_control.rs` and friends) | text line in, one JSON line out; Unix socket, or localhost TCP and a token where there is none | +| `horizon-ctl` | `crates/horizon-client/src/bin/horizon-ctl/` | CLI over the socket; one table of commands (`commands.rs`) gives the help, the argument checks, the MCP tools and the reference | +| `horizon-ctl mcp` | same | MCP over stdio, one tool per command of the table | +| Launcher CLI | `launcher/src/cli.rs` | `horizon-launcher [--json]` | +| Launcher MCP | `launcher/src/mcp.rs`, `cli_tools.rs`, `game_tools.rs` | `horizon-launcher mcp` (stdio): every CLI command as a tool, the session tools, and the game's tools as `game_*` | +| Connecting | `launcher/src/agents.rs`, `agents_page.rs`; `src/game/agent_settings.rs` | `horizon-launcher agent-config`; Settings > AI in the launcher; Horizon Settings > AI Agent in the game | +| No AI | `crates/horizon-core/src/no_ai.rs` | `noAi:true` in `/horizon-extras.txt`, read by every surface | -This page is the inventory of what each surface can do and the design every new command -follows. Quick start for players and scripts: [native-client.md](native-client.md#agent-control-horizon-ctl-and-mcp). +## One MCP server for everything -## What exists today +An agent adds one server, `horizon-launcher mcp`. It holds: -Legend: **yes** complete, **part** partial (see note), **no** missing, **—** not applicable. -"Socket" is the game's own command; `horizon-ctl` and its MCP offer the subset in its table -(`horizon-ctl help --game` lists everything the game takes, test hooks included). +- **The launcher's CLI, generated.** `cli_tools.rs` walks the clap definition. Each command is a + tool named after its words (`mods search` is `mods_search`). Its arguments are the command's, + in snake_case, with clap's help, choices and defaults. A call runs that command with `--json` + as a child process and returns what it printed. A new CLI command is a new tool with no extra + code. +- **Session tools**, which keep something running between calls: + - `play` (the game, under control: `world`, `creative`, `join`, `offscreen`, `arg`); + - `server`, `server_command`, `server_log`, `server_stop`; + - `account_sign_in`, `account_list`. +- **The game's tools.** It runs the selected version's `horizon-ctl mcp` (shipped beside the + game) as a child. It lists that server's tools as `game_`, all but `launch`, and passes + calls and results through, images included. `play` starts the game with a control socket in + the launcher's data folder. While no game answers, `game_*` calls say to call `play`. + +Why one server rather than two: the game's tools stay defined once, in horizon-ctl's table. The +agent's client needs one entry and one approval. The version that plays is always the one the +launcher selected, so the game's tools always match the game. `horizon-ctl mcp` stays available +on its own, for a game started by hand or by a script. + +## Inventory, before and after + +Before is `main` at 2026-10-23, before #1342, #1343, #1344, #1345 and #1353. After is with +them. CLI is `horizon-launcher` for the launcher and `horizon-ctl` for the game. MCP is +`horizon-launcher mcp` (the game's tools as `game_*`) and `horizon-ctl mcp`. **part** means only +through a generic command (`ui` and `click` by widget, or a raw socket line that horizon-ctl +passes on without checking it). ### Launcher -| Capability | Window | CLI | MCP | Notes | -| --- | --- | --- | --- | --- | -| Releases, installed versions, select | yes | yes | yes | `versions`, `list_versions`; selecting happens on install only (no `select` command) | -| Install / remove a version | yes | yes | yes | | -| Prepare resources | yes | yes | yes | | -| Start the client | yes | yes (attached) | yes | MCP starts it detached and cannot reach it afterwards | -| 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 | -| Logs, crash report | yes | yes | yes | | -| Updates (Horizon and launcher) | yes | yes | yes | MCP only checks | -| Patch notes, links | yes | yes | yes | | -| Benchmark | — | yes | no | | -| Telemetry consent | PR #250 | PR #250 | PR #250 | opt-in, in review | -| Friends: join by invite code | yes | yes (`play --join`) | no | | -| Profiles, packs, mods | no | no | no | the launcher has none yet | -| The running game's controls | — | no | no | an agent needs a second MCP server (`horizon-ctl mcp`) | +| Capability | Window | CLI before | MCP before | CLI after | MCP after | Notes | +| --- | --- | --- | --- | --- | --- | --- | +| Releases and installed versions | Play, version picker | yes | yes | yes | yes | `versions [--installed]` | +| Install, remove a version | Play | yes | yes | yes | yes | `remove` needs `confirm` in MCP | +| Pick the version that plays | Play | no | no | yes | yes | `settings selected-version TAG` | +| Prepare resources | Play | yes | yes | yes | yes | | +| Start the game | Play | yes | yes | yes | yes | `play --world --creative --join --arg`; MCP `play` adds `offscreen` | +| Join a friend by invite code | Play | yes | no | yes | yes | `play --join CODE` | +| Dedicated server here: start, console, log, stop | Servers | yes | yes | yes | yes | `server`; MCP `server`, `server_command`, `server_log`, `server_stop` | +| Hosted servers: list, create, set up, run a command, forget | Servers | yes | no | yes | yes | `servers ...`; `servers_forget` needs `confirm` | +| Accounts: list, sign in, sign out, select, offline | Settings | yes | part | yes | yes | names and UUIDs only; sign-in is a device code; `account_offline` was missing | +| Update channel (Alpha, Stable) | Settings | yes | yes | yes | yes | | +| Game folder, server folder, install new versions, opening animation | Settings | no | no | yes | yes | `settings [KEY VALUE]` | +| Extra game arguments | Settings | yes | no | yes | yes | `game-args` | +| Applications menu entry (Linux) | Settings | yes | no | yes | yes | `desktop-entry` | +| Updates: check and install | Settings | yes | part | yes | yes | MCP could only check | +| Patch notes, links | Patch notes, footer | yes | yes | yes | yes | | +| Game log, crash reports | Settings | yes | yes | yes | yes | `logs [--crash]` | +| Data collection: status, allow, deny, show, delete, send, bug, benchmark upload | Settings > Data | yes | part | yes | yes | sending was missing in MCP; `data_delete` needs `confirm` | +| Mod browser: search, check, install, update, remove, list (mods, resource packs, shader packs, modpacks) | Mods | yes | no | yes | yes | `mods ...`; `mods_remove` needs `confirm` | +| Modpacks: import, port, play, remove, list | Modpacks | yes | no | yes | yes | `modpack ...`; `modpack_remove` needs `confirm` | +| Launcher benchmark | (none) | yes | no | yes | yes | | +| The game it started | (the game) | (horizon-ctl) | yes | (horizon-ctl) | yes | `game_*` | +| Connect an AI agent | Settings > AI | no | (none) | yes | (none) | `agent-config [--client] [--test]`; the agent is already connected, so there is no tool | +| No AI | Settings > AI | no | (none) | yes | (none) | `no-ai [on\|off]`; the player's switch, never an agent's | ### Game -| Capability | Socket | horizon-ctl / MCP | Notes | -| --- | --- | --- | --- | -| Session: launch, wait until ready, open/create a world, save, quit, logs | yes | yes | `launch`, `wait-ready`, `open`, `save`, `quit`, `logs` | -| Player and world state | yes | yes | `state`, `status` (renderer, streaming, memory) | -| Crosshair target | yes | yes | `looking-at` | -| Blocks: one, a box, nearest of a kind | yes | yes | `block`, `blocks`, `find-block` | -| Entities near the player | yes | yes | `entities [RADIUS] [TYPE]`; no single-entity detail | -| Inventory, armor, offhand, carried stack | yes | yes | `inventory` | -| Containers and stations: read, click slots | yes | yes | `screen`/`menu`, `click-slot ID`, `container X Y Z` | -| Crafting (grid, result, recipe book) | part | part | grid by `click-slot`; the recipe book only by `click-at` | -| Movement, look, path-finding | yes | yes | `move`, `goto`, `look`, `look-at`, `turn --over`, `mouse-move` | -| Act on the world | yes | yes | `break`, `place`, `interact`, `use-item`, `attack`, `select`, `drop` | -| Raw input: keys, mouse buttons | yes | yes | `key`, `mouse`, `release`; `key w down` stays held through `wait` until `key w up`, `release` or `stop` | -| Controllers | yes | yes | `pad` button/stick/trigger/status (a virtual pad) | -| Chat and commands | yes | yes | `chat`, `command`, `type`, `messages`, `chat-log` | -| Screens: which is open | yes | yes | `screen` gives a label (`title`, `options`, `inventory`...) but not the options page or sub-screen | -| Screens: widgets | part | part | `screen` lists **labelled buttons** only (label, bounds, enabled); sliders, fields, list rows, tabs and switches are invisible | -| Screens: act on a widget | part | part | `click-button LABEL` (buttons only), `click-at X Y`; no slider set, no field focus, no row select by id | -| Options | part | no | `options PAGE` opens a page and `render-distance N` sets one value; no read, no set of the other ~120 options | -| Packs (resource packs) | no | no | only through the Packs screen by pixel | -| F3 debug data | part | part | `status` has the overlay flags and the renderer; not the F3 lines | -| Screenshots | yes | yes | PNG of the next frame (works `--offscreen`) | -| Recording video | no | no | | -| Benchmarks and frame stats | yes | yes | `bench`, `stats`, `fly`, `--benchmark` | -| Multiplayer: connect, disconnect, respawn | yes | part | `connect`/`disconnect` are socket-only | -| LAN and friends hosting | yes | no | `lan open/close/status`, `friends host/stop/status` socket-only | -| Cheats and test hooks | yes | part | `give`, `time`, `setblock`, `summon`, `effect`; `xp`, `enchant`, `potion`, `trade`, `fill`, `particle`, `sculk` socket-only | -| Waits | part | part | `wait TICKS`, `wait-ready`; no "until screen X", "until chunks loaded", "until chat says Y" | -| Events | no | no | everything is polled | -| Errors with reasons | part | part | `{"error": "text"}`; horizon-ctl adds `kind` (`usage`, `connection`) to its own errors only | +| Capability | Screen | CLI before | MCP before | CLI after | MCP after | Notes | +| --- | --- | --- | --- | --- | --- | --- | +| Start, wait until ready, save, quit, log | (all) | yes | yes | yes | yes | `launch`, `wait-ready`, `save`, `quit`, `logs` | +| Every widget of every screen, by id; click, set, type | (all) | yes | yes | yes | yes | `ui`, `click ID`, `set ID VALUE`, `type`; `click-at`, `drag-at`, `scroll-at` by pixel | +| Title menu, pause menu | Title, Pause | yes | yes | yes | yes | `ui`/`click`, `pause`, `resume` | +| Worlds: list | Select World | part | part | yes | yes | `worlds` | +| Worlds: create, open | Create New World | yes | yes | yes | yes | `open WORLD [SEED] [creative]` | +| Worlds: rename, back up | Edit World | part | part | yes | yes | `world-rename`, `world-backup` | +| Worlds: delete | Select World | part | part | yes | yes | `world-delete FOLDER --confirm`; it was possible through `click` without any confirm | +| Servers list | Multiplayer | part | part | yes | yes | `servers` (names and addresses; reads servers.dat) | +| Join a server or an invite code, leave | Multiplayer | part | no | yes | yes | `connect`, `disconnect` | +| Open to LAN | Pause > Open to LAN | part | no | yes | yes | `lan open\|close\|status` | +| Play with Friends: host, stop, status | Pause | part | no | yes | yes | `friends host\|stop\|status` | +| Vanilla options, every page | Options | yes | part | yes | yes | `options-get`, `options-set` (all of options.txt, typed); `options PAGE` was socket-only | +| Horizon Settings: Graphics, Shader Packs, Controller, Extras, Mods, AI Agent | Horizon Settings | part | part | yes | yes | `options horizon\|graphics\|extras\|agent...`, then `ui`/`click`/`set` | +| Agent control on or off, status, connection details | Horizon Settings > AI Agent | no | no | yes | yes | new page (#1353) | +| Key binds | Controls > Key Binds | yes | yes | yes | yes | `options-set key_key.jump key.keyboard.j` | +| Resource packs, shader packs | Options > Resource Packs, Shader Packs | part | part | yes | yes | `options packs`, `options shader-packs`, then `ui` rows and `click`; `options-set resourcePacks` | +| Chat and commands | Chat | yes | yes | yes | yes | `chat`, `command`, `messages`, `chat-log` | +| Inventory, containers, stations | Inventory, Chest... | yes | part | yes | yes | `inventory`, `screen`, `click-slot`; `container X Y Z` was socket-only | +| Crafting, recipe book | Crafting | part | part | yes | yes | the grid by `click-slot`; the recipe book by `ui`/`click` | +| Trading, riding, shearing (right-click an entity) | Merchant, Horse | part | no | yes | yes | `interact-entity ID`; `mouse` was CLI-only | +| Horse, llama inventory | Horse | no | no | yes | yes | `mount-menu` | +| Books, lecterns, signs | Book, Sign | part | part | yes | yes | `book [next\|back\|take\|done]`, `signedit X Y Z` | +| Move, look, find a path | (playing) | yes | yes | yes | yes | `move`, `goto`, `look`, `look-at`, `turn`, `jump` | +| Mine, place, use, attack, hotbar, drop | (playing) | yes | yes | yes | yes | `break`, `place`, `interact`, `use-item`, `attack`, `select`, `drop` | +| Raw keys and mouse buttons | (all) | yes | part | yes | yes | `key`; `mouse`, `release` were CLI-only | +| Controllers | (all) | yes | no | yes | yes | `pad` | +| Respawn | Death | yes | yes | yes | yes | `respawn` | +| Screenshots | (all) | yes | yes | yes | yes | PNG of the next frame, `--offscreen` too | +| F3 data | F3 | yes | part | yes | yes | `key f3`; `status` (renderer, chunks, memory) was CLI-only | +| Waits and events | (all) | yes | yes | yes | yes | `wait`, `wait-for`, `events` | +| Effects, experience, enchantments, potions, fill | (cheats) | part | no | yes | yes | `effect`, `effects`, `xp`, `enchant`, `potion`, `fill` | +| Benchmarks and frame stats | (all) | yes | part | yes | yes | `bench`, `stats` were CLI-only; `fly` | -### After the PRs in [Status](#status) +## No AI -| 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 | -| 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 | -| Events | none (poll) | `events [--since SEQ]`: screen, chat, death, respawn, item, dimension, world | -| Launch headless | `--offscreen` by hand | `launch --offscreen` in horizon-ctl and its MCP; `launch_client {offscreen}` | -| The running game from the launcher's MCP | no (a second server) | every game tool as `game_*` through `horizon-launcher mcp` | +One switch hides and turns off every AI feature: `noAi:true` in `/horizon-extras.txt`. +The game home is `HORIZON_HOME`, else the data dir's `horizon`. The game reads its extras from +its working directory, which is that folder. `horizon_core::no_ai` reads and writes the switch: -## Design +- `is_on(home)` and `check(home)` read it; +- `set(home, on)` keeps the file's other lines, and writes no file to turn off a switch that was + never on; +- `REFUSAL` is the one line every surface prints. -### One vocabulary, four surfaces +The switch is in three places: Settings > AI in the launcher, Horizon Settings in the game +(`Item::NoAi`), and `horizon-launcher no-ai on|off`. When it is on: + +| Surface | What happens | +| --- | --- | +| Game | opens no control socket, even with `--control` (it logs the refusal); Horizon Settings hides AI Agent...; turning it on in a running game closes the socket at once | +| `horizon-ctl` | every command refuses: exit status 4, `{"error": REFUSAL, "kind": "denied"}` | +| `horizon-ctl mcp` | refuses to start (exit 4, REFUSAL on stderr); a session already running refuses each call | +| `horizon-launcher mcp` | refuses to start; a running session answers each `tools/call` with error -32000 and REFUSAL | +| Launcher CLI | `mcp` and `agent-config` are hidden from the help and refuse | +| Launcher window | Settings > AI shows only the No AI switch, without Connect an AI agent | +| Companion (#1068) | uses the same switch (see horizon-parity companion-notes.md) | + +Every other launcher command stays usable: versions, install, remove, prepare, play, server, +notes, links, account, update-channel, settings, game-args, logs, update, desktop-entry, data, +modpack, mods, servers, no-ai and benchmark. None of them drives the game for an agent. The +launcher itself, packagers, the docs and players' scripts need them, and `no-ai` has to stay to +turn the switch off. + +## Connecting + +- **Launcher, Settings > AI > Connect an AI agent:** + - a client picker (Claude Code, Codex, Cursor, any MCP client) with its config and a Copy button; + - for clients with a CLI, the add command, shown and run only on **Add to ...**: + `claude mcp add --scope user horizon -- mcp`, `codex mcp add horizon -- mcp`; + - **Test the connection** (`agents::self_test`) starts ` mcp`, lists its tools and says + how many answered. + - `horizon-launcher agent-config [--client ID] [--json] [--test]` prints the same thing. +- **Game, Horizon Settings > AI Agent:** + - **Agent Control** (`agentControl` in horizon-extras.txt, off by default) opens the default + endpoint (`$HORIZON_CONTROL`, else `horizon-control.sock` in the runtime directory) in a game + the player started. Turning it off closes the endpoint and stops its listener. + - The page shows whether a client is connected (`Server::clients`), when the last command came, + and the socket's name. + - **Copy Connection Details** copies the socket path, a `horizon-ctl --socket ... state` line + and an `mcpServers` config for this game's `horizon-ctl mcp`. +- **The default:** a game an agent starts (`play` in MCP, `horizon-ctl launch`, `--control`) is + under control. A game the player starts from the window is not, until they turn Agent Control + on. An open socket lets any program of that user drive the game, so it opens only when an agent + asked for the game, or when the player chose it. + +## Design rules for a new command + +### One vocabulary - **A command has one name**, kebab-case, the same on the socket, in `horizon-ctl` and in the - launcher CLI. Its MCP tool is the name with `_` for `-` (`click-slot` → `click_slot`). - The launcher's MCP offers the game's tools under a `game_` prefix (`game_click_slot`) so they - never collide with its own (`logs` exists on both sides). -- **Arguments** are positional words then `--flags`; the `horizon-ctl` table (`Param`) is the - source of truth and generates the MCP `inputSchema`. A new game command is not done until it - is in that table. + launcher CLI. Its MCP tool is the name with `_` for `-` (`click-slot` is `click_slot`). In the + launcher, a subcommand's words are joined (`mods search` is `mods_search`). The launcher's MCP + offers every game tool as `game_`, so none collides with its own (`logs` is on both + sides). A launcher tool whose name starts with `game_` (`game_args`) is matched first. +- **Arguments:** positional words, then `--flags`. + - The game: the `horizon-ctl` table (`Param`) is the source of truth. It generates the MCP + `inputSchema` and the reference. A game command is not done until it is in that table. + - The launcher: the clap definition is the source of truth. Give every argument a help line; + it becomes the tool's description. - **Replies are one JSON object.** A query returns its data; an action returns `{"ok": true, ...}` plus what changed (`clicked`, `screen`, `drops`...). -- **Errors** are `{"error": "", "kind": ""}`. Kinds: - `usage` (bad or missing argument), `unknown` (no such command, widget, option, entity), - `state` (the game is not in a state that allows it: no world, wrong screen, disabled - widget), `busy` (another action or benchmark runs), `timeout`, `connection` (game not - reachable), `denied` (needs consent, below). The message names what to do next - ("no world open; use: open WORLD"). -- **Shapes are shared**: a position is `[x, y, z]`; a block is - `{"pos", "block", "state", "loaded"}`; an item stack is `{"item", "count", "damage"?, - "components"?}`; a slot is a stack plus `"slot": ID` (the slot ids of - `click-slot`); bounds are `[x, y, w, h]` in GUI pixels, the coordinates of `click-at`. +- **Errors** are `{"error": "", "kind": ""}`. The kinds: + - `usage`: a bad or missing argument; + - `unknown`: no such command, widget, option or entity; + - `state`: the game is not in a state that allows it (no world, wrong screen, disabled widget); + - `busy`: another action or a benchmark is running; + - `timeout`; + - `connection`: the game can't be reached; + - `denied`: No AI is on (exit status 4). -### Structured UI: the widget tree + The message names what to do next ("no world open; use: open WORLD"). +- **Shapes are shared:** + - a position is `[x, y, z]`; + - a block is `{"pos", "block", "state", "loaded"}`; + - an item stack is `{"item", "count", "damage"?, "components"?}`; + - a slot is a stack plus `"slot": ID` (the slot ids of `click-slot`); + - bounds are `[x, y, w, h]` in GUI pixels, the coordinates of `click-at`. -`ui` returns every interactive element the last frame drew, on every screen (title menus, -pause, options pages, inventories and stations, chat, death, Play with Friends): +### Safety + +- **Local only.** The socket is a Unix socket in the user's runtime directory, or a TCP port on + 127.0.0.1 behind a 128-bit token in a file only the user can read. It is never `0.0.0.0` and + never a network listener. Both MCP servers use stdio. +- **Confirm what can't be undone.** A command that deletes the player's things requires + `confirm` and carries the MCP `destructiveHint`. In the game these are `world-delete`, `fill` + and `setblock` (the table's `DESTRUCTIVE`); in the launcher, `remove`, `modpack remove`, + `mods remove`, `servers forget`, `account sign-out` and `data delete` (`cli_tools::DESTRUCTIVE`). + Without `confirm: true` the call is refused and the message says to ask the player. In the game + CLI the flag is `--confirm`. The launcher CLI asks nothing: a person typing `remove` meant it. +- **Ask before reaching out.** A command that sends data or reaches other people carries + `openWorldHint`, and its description says "only when the player asks". In the game these are + `connect`, `lan`, `friends`, `chat` and `command`; in the launcher, `data allow`, `data send`, + `data bug`, `data benchmark` and `servers create`. `play`'s `join` argument says the same. + Telemetry stays opt-in, and only `data allow` turns it on. +- **No secrets.** No surface returns tokens, session files, keychain entries or invite secrets + the player didn't ask to share: + - accounts are names and UUIDs; + - sign-in is a device code the player enters; + - `--session-file` is read once and deleted; + - `servers` reads names and addresses only. +- **Vanilla behaviour untouched.** Control code reads state and synthesizes the input events a + player produces; registering widgets for the tree draws nothing. A change to game files runs + `tools/parity.py --changed origin/main`. + +### The widget tree + +`ui` returns every interactive element the last frame drew, on every screen: ```json {"screen": "options", "gui_size": [427, 240], "frame": 3061, "widgets": [ {"id": "fov", "kind": "slider", "label": "FOV: 70", "bounds": [40, 50, 150, 20], "enabled": true, "value": 0.5}, - {"id": "video-settings", "kind": "button", "label": "Video Settings...", "bounds": [...], "enabled": true}, - {"id": "row-2", "kind": "row", "bounds": [...], "enabled": true}, {"id": "done", "kind": "button", "label": "Done", "bounds": [...], "enabled": true}]} ``` -- **Ids are stable and readable**: the label up to its `:` as a slug (`FOV: 70` → `fov`, - `Video Settings...` → `video-settings`); a repeated slug gets `-2`, `-3` in draw order; - unlabelled elements are `-` 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; inventory, creative and menu slots are `slot-` 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`. -- **Actions by id**: `click ID [right|middle]` (move the pointer there and click, exactly as a - player would; `middle` is the pick block button, which clones a stack in creative), `set ID VALUE` (a slider to a 0..1 position, a click on its track, as vanilla - `AbstractSliderButton.onClick` reads the pointer). `type TEXT` keeps typing into the focused - field; `click` on a field focuses it. After a click or a set, the next `ui`, `click` or - `set` waits for a redrawn frame, so it never reads the screen the click left. -- **No new code paths in screens**: the tree is built from what the draw functions already - register for the controller's focus navigation (`widgets.rs`), so every screen that a - controller can drive is in it, and clicks go through the same window events as the mouse. +- **Ids are stable and readable.** An id is the label up to its `:`, as a slug (`FOV: 70` is + `fov`, `AI Agent...` is `ai-agent`). A repeated slug gets `-2`, `-3`; unlabelled elements are + `-`. A slider's id doesn't change with its value. Slots are `slot-` with their + stack. +- **Kinds:** `button`, `slider` (`value` 0..1), `field`, `row` (a world, server, pack or + language), `tab` (`selected`), `slot`. +- **Actions:** + - `click ID [right|middle] [shift]` clicks where the mouse would. + - `set ID VALUE` moves a slider. + - `type` types into the focused field. -### Options + After a click, the next `ui`, `click` or `set` waits for a redrawn frame. +- **No new code paths in screens.** The tree is built from what the draw functions already + register for controller navigation (`widgets.rs`). -- `options-get [KEY...]`: every option of `options.txt` by its vanilla key, with its value - and what it accepts: `{"key": "fov", "value": 70, "type": "int", "min": 30, "max": 110}`, - enums with `choices`, key bindings as `key.keyboard.w`. Next: Horizon's own files - (`horizon-graphics.txt`, `horizon-controller.txt`, extras) under their own keys. -- `options-set KEY VALUE`: validated like vanilla's `OptionInstance.set` (out of range is an - error here, not a silent reset), applied at once as the options screen would apply it, and - saved. Reply: the new value. -- `options [PAGE]` keeps opening a page for screenshots and for `ui`. +### Waits and events -### Inventory, containers, world, entities +- `wait-for screen NAME|widget ID|loaded|chat TEXT|event KIND [--timeout S] [--since SEQ]` + replies when the condition holds, or with `kind: timeout`. +- `events [--since SEQ]` returns what happened since SEQ: screens, chat, deaths, respawns, items, + dimensions and worlds (the newest 256). Take `last` before an action, and wait with `--since`, + so the action's event can't slip in before the wait. -The existing commands stay and keep their shapes: `inventory`, `screen`, `click-slot`, -`block`, `blocks`, `find-block`, `entities`, `looking-at`. Planned additions: `entity ID` -(full detail: equipment, effects, passengers, AI state), `entities` filters by position and -radius around any point (`--at X Y Z`), and `blocks --of BLOCK` to keep a box query small. +## Tests -### Waits +- **Unit tests:** + - horizon-ctl: the table, the schemas, the reference, the No AI refusal, the destructive and + network annotations; + - the launcher: generated tools, `confirm`, the reference, the agent configs; + - `horizon_core::no_ai`; + - `options_ui`: the AI Agent page, and that No AI hides it. +- **`tools/agent_control_e2e.py`** drives a real game, offscreen on macOS and on a virtual screen + on Linux, through the CLI and MCP: + - `survival`, `ui`, `options`, `events`, `consume`, `pick`, `suggestions`; + - `manage`: worlds, servers, effects, books, LAN, the options pages and `confirm`; + - `no-ai`: every surface refuses; + - `setting`: Agent Control on opens the endpoint, the AI Agent page, Copy, and off closes it. +- **`tools/launcher_mcp_e2e.py`** drives `horizon-launcher mcp`: the generated tools, `play` and + the `game_*` tools, `confirm`, `agent-config` and `--test`, and No AI. -`wait-for CONDITION [--timeout S] [--since SEQ]` replies when the condition holds, or with -an error of kind `timeout` saying what screen it ended on (`wait TICKS` waits for ticks): +## Later -- `screen NAME` (the label `state` shows), `widget ID` (a widget is on screen), -- `loaded` (a world is open, the player exists and no chunk is pending), -- `chat TEXT` (a new chat line containing TEXT), `event KIND` (an event of that kind); - both count from `--since SEQ`, else from now: take `last` from `events` before an action - so its event can't slip in before the wait starts. +These are tracked in FEATURES.md (LATER): -### Events - -`events [--since SEQ]` returns what happened since SEQ, oldest first, and `last`, the SEQ to -pass next time (the game keeps the newest 256): - -```json -{"event": "world", "seq": 1, "tick": 0, "state": "opened", "name": "Survival"} -{"event": "screen", "seq": 2, "tick": 0, "from": "title", "to": "playing"} -{"event": "item", "seq": 3, "tick": 110, "item": "minecraft:oak_log", "delta": 3} -{"event": "chat", "seq": 4, "tick": 140, "text": "[Player] hello"} -{"event": "death", "seq": 7, "tick": 300} -{"event": "respawn", "seq": 9, "tick": 330} -{"event": "dimension", "seq": 12, "tick": 900, "from": "minecraft:overworld", "to": "minecraft:the_nether"} -``` - -Events are found by comparing state once per event loop turn on the game thread, and only -under `--control` (no hooks inside game logic), so they cannot change what the game does. -Next: `subscribe [KIND...]`, the same events as a stream on one connection, for clients that -keep one open (MCP tools reply once, so `events` is what MCP offers). - -### The launcher's MCP proxies the game - -An agent configures one MCP server, `horizon-launcher mcp`. It runs the selected version's -`horizon-ctl mcp` (shipped beside the game) as a child and lists every one of its tools as -`game_` (all but `launch`), passing calls and results (images included) through, so -the game's tools are defined once, in horizon-ctl's table. `launch_client` starts the game -with a control socket in the launcher's data folder (`world`, `creative`, `offscreen` -optional) and returns once it answers. While no game listens, `game_*` calls fail with -`kind: "state"` and say to call `launch_client`. A game the player starts from the window -is not under control. - -### Safety - -- **Local only.** The socket is a Unix socket in the user's runtime directory, or a TCP port - on 127.0.0.1 behind a 128-bit token in a file only the user can read. Never `0.0.0.0`, - never a network listener; the launcher's MCP is stdio. -- **No secrets.** No surface returns tokens, session files or keychain entries: accounts are - names and UUIDs, `--session-file` is read once and deleted, and `options-get` leaves out - nothing secret because `options.txt` holds none (server addresses are in `servers.dat`, - which no command reads). -- **Consent for anything that sends data.** Commands that reach the network (`connect`, - `chat`/`command` on a server, `lan open`, `friends host`, `install_version`, - `check_updates`, telemetry) carry the MCP `openWorldHint` annotation and their description - says "only when the player asks". Telemetry stays opt-in (PR #250); no agent command turns - it on. Destructive ones (`remove_version`, `sign_out`, `fill`, `setblock`) carry - `destructiveHint`. -- **Vanilla behaviour untouched.** Control code reads state and synthesizes the same input - events a player produces; registering widgets for the tree draws nothing. Every PR that - touches game files runs `tools/parity.py --changed origin/main`. - -## Status - -| Step | PR | -| --- | --- | -| This document | #321 | -| `ui`, `click ID`, `set ID VALUE`: the widget tree of every screen | #349 | -| `options-get` / `options-set` | #350 | -| `wait-for`, `events` | #351 | -| The launcher's MCP proxies the game (`game_*`), `launch_client` under control | #342 | -| Next: `subscribe` (a stream), error `kind` on every game error, MCP annotations (`openWorldHint`, `destructiveHint`) | | -| Next: `entity ID`, `entities --at`, packs (`packs list|enable|disable`), F3 lines, Horizon's own option files, launcher settings over CLI/MCP | | - -Each PR adds its tests: unit tests next to the code, and scenarios in -`tools/agent_control_e2e.py` (`survival`, `ui`, `options`, `events`; CLI and MCP) and -`tools/launcher_mcp_e2e.py`, which drive the real game offscreen on macOS or on a virtual -screen on Linux. `tools/lan_e2e.py` runs two games at once, a host that opens its world to LAN -and a guest that joins it, and checks from both sides what a guest sees and can do (player -list, own model, armour, name tags, chest lids, crafting, fall damage). +- Horizon's own option files by key (`horizon-graphics.txt`, controller, extras) next to + `options-get` and `options-set`. +- Adding and removing saved servers by command. +- `subscribe`: events as a stream on one connection. +- Launcher window screenshots in this page's PRs. +- No AI changed in the launcher while a game is open: the game rewrites its extras when it saves. +- A confirmation question in the launcher CLI for destructive commands. diff --git a/docs/launcher-commands.md b/docs/launcher-commands.md new file mode 100644 index 000000000..579659e68 --- /dev/null +++ b/docs/launcher-commands.md @@ -0,0 +1,478 @@ +# Launcher commands + + + +Every command of `horizon-launcher`, and the tool `horizon-launcher mcp` offers for it. A tool's arguments are the command's, in snake_case. A tool runs the command with `--json` and returns what it printed. The tools that change the player's things for good need `confirm: true`. The tools that send something or reach other people say "only when the player asks". The game's own tools, `game_*`, are in [horizon-ctl-commands.md](horizon-ctl-commands.md). With No AI on, `mcp` and `agent-config` are hidden and refuse; every other command stays. See [agent-control.md](agent-control.md#no-ai). + +## `horizon-launcher versions` + +List Horizon releases, or the installed versions. + + horizon-launcher versions + +- `--installed`: Only the versions installed here (no network) + +MCP: `versions`. + +## `horizon-launcher install` + +Download and install a release (a tag such as v2026.10.13, or "latest"). + + horizon-launcher install + +- `TAG` + +MCP: `install`. + +## `horizon-launcher remove` + +Remove an installed version. + + horizon-launcher remove + +- `TAG` + +MCP: `remove`, needs `confirm: true`. + +## `horizon-launcher prepare` + +Prepare a version's resources from your own Minecraft install. + + horizon-launcher prepare + +- `--minecraft`: The game folder of the official launcher, Prism Launcher, MultiMC, the Modrinth App, ATLauncher or GDLauncher (default: the launcher's, then every launcher's default) + +MCP: `prepare`. + +## `horizon-launcher play` + +Start the client. + + horizon-launcher play + +- `--world`: Open or create this world (a folder under saves) at once +- `--creative`: Creative mode for a new world +- `--join`: Join a friend's world with its invite code +- `--arg`: An extra argument for the game, passed through as-is (repeatable), for example --server-thread + +MCP: `play`, then the `game_*` tools. + +## `horizon-launcher server` + +Run a dedicated server here; type commands into its console. + + horizon-launcher server + +- `--dir`: The server's folder (default: the one the launcher uses) +- `--accept-eula`: Agree to the Minecraft EULA (https://aka.ms/MinecraftEULA) + +MCP: `server`, `server_command`, `server_log`, `server_stop`. + +## `horizon-launcher notes` + +Show a release's patch notes (default: the newest). + + horizon-launcher notes [TAG] + +- `TAG` + +MCP: `notes`. + +## `horizon-launcher links` + +Show the Discord, sponsor and website links. + + horizon-launcher links + +MCP: `links`. + +## `horizon-launcher account list` + +The signed-in accounts and which one plays. + + horizon-launcher account list + +MCP: `account_list`. + +## `horizon-launcher account sign-in` + +Sign in with a Microsoft account in your browser (device code). + + horizon-launcher account sign-in + +MCP: `account_sign_in`. + +## `horizon-launcher account sign-out` + +Sign out: the account's tokens leave the keychain. + + horizon-launcher account sign-out + +- `WHO`: Its name or UUID + +MCP: `account_sign_out`, needs `confirm: true`. + +## `horizon-launcher account select` + +Play as this account. + + horizon-launcher account select + +- `WHO` + +MCP: `account_select`. + +## `horizon-launcher account offline` + +Play offline, without an account. + + horizon-launcher account offline + +MCP: `account_offline`. + +## `horizon-launcher update-channel` + +Show or set which Horizon releases install by themselves: stable (a tested build about once a day) or alpha (every release as soon as it is built; can break). + + horizon-launcher update-channel [CHANNEL] + +- `CHANNEL` (stable, alpha): Omit to show the current channel + +MCP: `update_channel`. + +## `horizon-launcher settings` + +Show the launcher's settings, or set one (the Settings page): selected-version TAG, minecraft-dir PATH, server-dir PATH ("default" resets a folder), install-new-versions on|off, opening-animation on|off. + + horizon-launcher settings [KEY] [VALUE] + +- `KEY` (selected-version, minecraft-dir, server-dir, install-new-versions, opening-animation) +- `VALUE`: The new value (with KEY) + +MCP: `settings`. + +## `horizon-launcher game-args` + +Show or set the extra arguments the game starts with (for example --server-thread); quotes group a word with spaces in it. + + horizon-launcher game-args [ARGS] + +- `ARGS`: Omit to show the current arguments + +MCP: `game_args`. + +## `horizon-launcher logs` + +Print the end of the game's log (logs/latest.log in the game folder), or its newest crash report. + + horizon-launcher logs + +- `--lines`: How many lines of latest.log +- `--crash`: The newest crash report instead + +MCP: `logs`. + +## `horizon-launcher update` + +Look for a newer Horizon release and launcher, and install them. + + horizon-launcher update + +- `--check`: Only report what is available + +MCP: `update`. + +## `horizon-launcher desktop-entry` + +Linux: put Horizon in the applications menu (an entry and the icon, under $XDG_DATA_HOME), or take it out with --remove. + + horizon-launcher desktop-entry + +- `--remove`: Remove the entry and the icon, and stop adding them back + +MCP: `desktop_entry`. + +## `horizon-launcher data status` + +What is allowed, the install ID and how many items wait (the default). + + horizon-launcher data status + +MCP: `data_status`. + +## `horizon-launcher data allow` + +Turn kinds on: performance, crashes, bugs, benchmarks, or all. + + horizon-launcher data allow ... + +- `KINDS` + +MCP: `data_allow`, only when the player asks. + +## `horizon-launcher data deny` + +Turn kinds off: performance, crashes, bugs, benchmarks, or all. + + horizon-launcher data deny ... + +- `KINDS` + +MCP: `data_deny`. + +## `horizon-launcher data show` + +Print exactly what would be sent. + + horizon-launcher data show + +MCP: `data_show`. + +## `horizon-launcher data delete` + +Delete everything sent from here, and what waits, and take a new install ID. + + horizon-launcher data delete + +MCP: `data_delete`, needs `confirm: true`. + +## `horizon-launcher data send` + +Send what is waiting now. + + horizon-launcher data send + +MCP: `data_send`, only when the player asks. + +## `horizon-launcher data bug` + +Send a bug report you write; it is printed first, as it would leave. + + horizon-launcher data bug + +- `TEXT` +- `--log`: Add the end of the game's log (scrubbed, without chat) +- `--yes`: Send without asking + +MCP: `data_bug`, only when the player asks. + +## `horizon-launcher data benchmark` + +Upload a benchmark report (docs/benchmark-report.md); it is printed first. + + horizon-launcher data benchmark + +- `FILE` +- `--yes` + +MCP: `data_benchmark`, only when the player asks. + +## `horizon-launcher modpack list` + +The imported packs and their coverage (the default). + + horizon-launcher modpack list + +MCP: `modpack_list`. + +## `horizon-launcher modpack import` + +Import a .mrpack, a CurseForge zip or an instance folder, and write its coverage report. + + horizon-launcher modpack import + +- `PATH` + +MCP: `modpack_import`. + +## `horizon-launcher modpack port` + +Get the jars of what this computer can port and carry them over. + + horizon-launcher modpack port + +- `PACK`: The pack's folder name, as list shows it +- `--from`: A folder with your own jars (an installed instance, a downloads folder) + +MCP: `modpack_port`. + +## `horizon-launcher modpack play` + +Play a ported pack as its own profile. + + horizon-launcher modpack play + +- `PACK` + +MCP: `modpack_play`. + +## `horizon-launcher modpack remove` + +Remove an imported pack: its jars, ports and the profile's saves. + + horizon-launcher modpack remove + +- `PACK` + +MCP: `modpack_remove`, needs `confirm: true`. + +## `horizon-launcher mods list` + +What the browser installed (the default). + + horizon-launcher mods list + +MCP: `mods_list`. + +## `horizon-launcher mods search` + +Search for packs Horizon loads. + + horizon-launcher mods search [TEXT]... + +- `TEXT` +- `--kind` (mod, resource, shader, modpack) +- `--everything`: Also what was made for other versions or runs only partly, each marked +- `--source` (modrinth, curseforge) + +MCP: `mods_search`. + +## `horizon-launcher mods check` + +Say how well a Java mod runs in Horizon: its jar is downloaded (checksum checked), carried over and read; the answer is kept. + + horizon-launcher mods check + +- `PROJECT` +- `--everything`: Allow a version made for another Minecraft version (1.21 and later) +- `--source` (modrinth, curseforge) + +MCP: `mods_check`. + +## `horizon-launcher mods install` + +Install a pack and what it needs, by its id or slug (checksums checked); a Java mod is ported into horizon-mods and turned on; a modpack is imported. + + horizon-launcher mods install + +- `PROJECT` +- `--everything`: Allow a version made for another Minecraft version +- `--source` (modrinth, curseforge) + +MCP: `mods_install`. + +## `horizon-launcher mods update` + +Update what the browser installed (or one pack). + + horizon-launcher mods update [PROJECT] + +- `PROJECT` +- `--check`: Only say what is newer + +MCP: `mods_update`. + +## `horizon-launcher mods remove` + +Remove a pack the browser installed. + + horizon-launcher mods remove + +- `PROJECT` + +MCP: `mods_remove`, needs `confirm: true`. + +## `horizon-launcher servers list` + +The servers, their folder and whether they run. + + horizon-launcher servers list + +MCP: `servers_list`. + +## `horizon-launcher servers create` + +Create a server; with no options it is a new world, survival, normal, 10 players, friends only. + + horizon-launcher servers create + +- `--name` +- `--seed`: The new world's seed (default: random) +- `--copy-world`: Start from a copy of this world folder (one of your saves) +- `--mode` (survival, creative, adventure, spectator) +- `--difficulty` (peaceful, easy, normal, hard) +- `--max-players` +- `--open`: Let anyone in (no whitelist) +- `--check-accounts`: Check players' Minecraft accounts (they must sign in with Microsoft) +- `--player`: Who may join (repeatable); the first becomes an operator +- `--accept-eula`: Agree to the Minecraft EULA (https://aka.ms/MinecraftEULA) + +MCP: `servers_create`, only when the player asks. + +## `horizon-launcher servers set-up` + +Copy an installed, prepared version's programs and game files for the servers (again). + + horizon-launcher servers set-up + +MCP: `servers_set_up`. + +## `horizon-launcher servers run` + +Run a horizon-server command on a server, for example: servers run "My server" -- status. + + horizon-launcher servers run -- ... + +- `SERVER`: The server's name or folder +- `ARGS` + +MCP: `servers_run`. + +## `horizon-launcher servers forget` + +Take a server off the list (its folder stays). + + horizon-launcher servers forget + +- `SERVER` + +MCP: `servers_forget`, needs `confirm: true`. + +## `horizon-launcher mcp` + +Serve the Model Context Protocol on stdin and stdout, for AI agents (refused while No AI is on). + + horizon-launcher mcp + +MCP: none: this command is the MCP server. + +## `horizon-launcher agent-config` + +How to connect an AI agent (Claude Code, Codex, Cursor, any MCP client) to `mcp`: the config to paste and the command that adds it (refused while No AI is on). + + horizon-launcher agent-config + +- `--client` (claude-code, codex, cursor, generic): Only this client +- `--test`: Start the MCP server as a client would and say whether it answered + +MCP: none: it prints how to connect a client to `mcp`. + +## `horizon-launcher no-ai` + +Show or set No AI: on hides and turns off every AI feature (the companion, agent control, horizon-ctl and both MCP servers); off, the default, makes them available. + + horizon-launcher no-ai [STATE] + +- `STATE` (on, off): Omit to show the current state + +MCP: none: the player's switch. + +## `horizon-launcher benchmark` + +Measure the launcher: starts (the first is the cold one), page switching, idle CPU and memory, the release list fetch; writes a benchmark report to benchmarks/ in its data folder. + + horizon-launcher benchmark + +- `--repeats`: How many times to start it + +MCP: `benchmark`. diff --git a/launcher/src/cli_tools.rs b/launcher/src/cli_tools.rs index e5d9d5a20..307f17dba 100644 --- a/launcher/src/cli_tools.rs +++ b/launcher/src/cli_tools.rs @@ -232,6 +232,111 @@ impl Tool { } } +/// The tools mcp.rs runs itself for a CLI command, and what an agent uses instead of the +/// player-only ones. +#[cfg(test)] +fn session_tool(words: &str) -> &'static str { + match words { + "play" => "`play`, then the `game_*` tools", + "server" => "`server`, `server_command`, `server_log`, `server_stop`", + "account sign-in" => "`account_sign_in`", + "account list" => "`account_list`", + "mcp" => "none: this command is the MCP server", + "agent-config" => "none: it prints how to connect a client to `mcp`", + _ => "none: the player's switch", + } +} + +/// docs/launcher-commands.md: every CLI command, its arguments and its MCP tool, from the CLI's +/// definition. A test keeps the file equal to this. +#[cfg(test)] +fn markdown() -> String { + let mut out = String::from( + "# Launcher commands\n\n\n\n\ +Every command of `horizon-launcher`, and the tool `horizon-launcher mcp` offers for it. A tool's \ +arguments are the command's, in snake_case. A tool runs the command with `--json` and returns what it printed. \ +The tools that change the player's things for good need `confirm: true`. \ +The tools that send something or reach other people say \"only when the player asks\". \ +The game's own tools, `game_*`, are in [horizon-ctl-commands.md](horizon-ctl-commands.md). \ +With No AI on, `mcp` and `agent-config` are hidden and refuse; every other command stays. See [agent-control.md](agent-control.md#no-ai).\n\n", + ); + let mut rows = Vec::new(); + collect(&crate::cli::command(), &mut Vec::new(), &mut rows); + let generated: Vec = all().iter().map(|t| t.words()).collect(); + for (words, cmd) in rows { + let usage = cmd + .clone() + .bin_name(format!("horizon-launcher {words}")) + .render_usage() + .to_string(); + let usage = usage + .trim_start_matches("Usage: ") + .replace(" [OPTIONS]", ""); + out += &format!("## `horizon-launcher {words}`\n\n"); + if let Some(about) = cmd.get_about() { + out += &format!("{about}.\n\n"); + } + out += &format!(" {usage}\n\n"); + let args: Vec<&clap::Arg> = cmd.get_arguments().filter(|a| shown(a)).collect(); + for arg in &args { + let name = match arg.get_long() { + Some(long) => format!("--{long}"), + None => arg.get_id().as_str().to_uppercase(), + }; + let help = arg.get_help().map(ToString::to_string).unwrap_or_default(); + let choices: Vec = arg + .get_possible_values() + .iter() + .map(|v| v.get_name().to_owned()) + .collect(); + let choices = if choices.is_empty() || matches!(arg.get_action(), ArgAction::SetTrue) { + String::new() + } else { + format!(" ({})", choices.join(", ")) + }; + let help = if help.is_empty() { + String::new() + } else { + format!(": {help}") + }; + out += &format!("- `{name}`{choices}{help}\n"); + } + if !args.is_empty() { + out += "\n"; + } + let mcp = if generated.contains(&words) { + let path: Vec = words.split(' ').map(str::to_owned).collect(); + let mut text = format!("`{}`", tool_name(&path)); + if DESTRUCTIVE.contains(&words.as_str()) { + text += ", needs `confirm: true`"; + } else if OPEN_WORLD.contains(&words.as_str()) { + text += ", only when the player asks"; + } + text + } else { + session_tool(&words).to_owned() + }; + out += &format!("MCP: {mcp}.\n\n"); + } + out.truncate(out.trim_end().len()); + out.push('\n'); + out +} + +/// Every command a player can type, groups included when they run on their own. +#[cfg(test)] +fn collect(cmd: &Command, path: &mut Vec, out: &mut Vec<(String, Command)>) { + for sub in cmd.get_subcommands().filter(|c| c.get_name() != "help") { + path.push(sub.get_name().to_owned()); + if sub.has_subcommands() { + collect(sub, path, out); + } else { + out.push((path.join(" "), sub.clone())); + } + path.pop(); + } +} + /// Whether an argument is part of a tool (not --help, --version or the global --json). fn shown(arg: &clap::Arg) -> bool { !arg.is_hide_set() && !matches!(arg.get_id().as_str(), "help" | "version" | "json") @@ -315,6 +420,28 @@ mod tests { ); } + #[test] + fn the_launcher_reference_is_up_to_date() { + let path = + std::path::Path::new(env!("CARGO_MANIFEST_DIR")).join("../docs/launcher-commands.md"); + let want = markdown(); + if std::env::var_os("HORIZON_WRITE_DOCS").is_some() { + std::fs::write(&path, &want).unwrap(); + } + let have = std::fs::read_to_string(&path).unwrap_or_default(); + assert!( + have == want, + "docs/launcher-commands.md is out of date: HORIZON_WRITE_DOCS=1 cargo test --manifest-path launcher/Cargo.toml the_launcher_reference" + ); + for tool in all() { + assert!( + have.contains(&format!("`{}`", tool.name)), + "{} undocumented", + tool.name + ); + } + } + #[test] fn destructive_tools_need_confirm() { let remove = tool("remove"); diff --git a/website/docs/agents.md b/website/docs/agents.md new file mode 100644 index 000000000..32ba58362 --- /dev/null +++ b/website/docs/agents.md @@ -0,0 +1,126 @@ +# Control Horizon with your AI agent + +Your own AI agent can drive the launcher and the game: Claude Code, Codex, Cursor or any client that speaks MCP (the Model Context Protocol). It runs on your computer and uses the same commands you can type in a terminal. It can install a version, start the game, play it, change settings and manage your worlds. Before it deletes anything, it asks you. If you don't want any of this, one **No AI** switch hides and turns off every AI feature. + +## What an agent can do + +Everything you can do with the mouse and keyboard, through commands instead of clicks: + +- **In the launcher:** + - install, remove and prepare versions; + - start the game, alone or with a world, or a server; + - your settings, the update channel and the extra game arguments; + - the mod browser (mods, resource packs, shader packs, modpacks), imported modpacks and hosted servers; + - your accounts (names only), logs and crash reports, patch notes, the data collection settings and the benchmark. +- **In the game:** + - read what is on screen (every button, slider, field and slot, by name), click and type; + - move, look, mine, place, attack, use items and pick from the hotbar; + - the inventory, chests and every other container, crafting, trading, books and signs; + - every options page, including Horizon Settings, and any option by its key; + - worlds (create, open, rename, back up, delete), servers, LAN and Play with Friends; + - chat and commands, screenshots, F3 data, waiting for an event and the game's log. + +The full lists are in the repository: [launcher commands](https://github.com/ludovic111/horizon/blob/main/docs/launcher-commands.md) and [game commands](https://github.com/ludovic111/horizon/blob/main/docs/horizon-ctl-commands.md). + +## Connect it from the launcher + +The easiest way. Open the launcher's **Settings** and scroll to **AI**: + +1. Under **Connect an AI agent**, pick your client: **Claude Code**, **Codex**, **Cursor** or **Any MCP client**. +2. For Claude Code and Codex, **Add to Claude Code** (or **Add to Codex**) runs that client's own command to add Horizon. The command is shown above the button, and runs only when you click it. For the others, **Copy** the config and paste it into the file named above it. +3. **Test the connection** starts Horizon's MCP server the way your client will and says how many tools it offers. +4. Restart your agent if it was open, then ask it: "Say hello from Horizon". + +One server, called `horizon`, covers both the launcher and the game. Ask your agent to start the game and it starts it under its control. The game's tools are the ones whose names begin with `game_`. + +## Copy-paste config + +The launcher prints these with the exact path of your copy: `horizon-launcher agent-config`. The paths below are the usual ones: + +- **macOS:** `/Applications/Horizon.app/Contents/MacOS/horizon-launcher` +- **Windows:** where you extracted the zip, for example `C:\Horizon\horizon-launcher.exe` +- **Linux:** where you put the AppImage or binary + +**Claude Code**, in a terminal: + +```sh +claude mcp add --scope user horizon -- /Applications/Horizon.app/Contents/MacOS/horizon-launcher mcp +``` + +**Codex**, in a terminal: + +```sh +codex mcp add horizon -- /Applications/Horizon.app/Contents/MacOS/horizon-launcher mcp +``` + +Or in `~/.codex/config.toml`: + +```toml +[mcp_servers.horizon] +command = "/Applications/Horizon.app/Contents/MacOS/horizon-launcher" +args = ["mcp"] +``` + +**Cursor** (`~/.cursor/mcp.json`), **Claude Desktop**, and **any other MCP client** that takes the usual JSON: + +```json +{ + "mcpServers": { + "horizon": { + "command": "/Applications/Horizon.app/Contents/MacOS/horizon-launcher", + "args": ["mcp"] + } + } +} +``` + +The server talks over its standard input and output, so it needs no port and is never on the network. + +## A game you started yourself + +A game your agent starts is under its control. A game you start with **Play** is not, unless you allow it. In the game, open **Options**, then **Horizon Settings**, then **AI Agent...**: + +- **Agent Control: On** lets agents on this computer reach the game you started. It is off by default. +- The page shows whether an agent is connected and when it last sent a command. +- **Copy Connection Details** copies where the game listens, a command to try, and an MCP config for `horizon-ctl`, the game's own command line, which comes with the game. + +Turning **Agent Control** off disconnects agents at once. + +## The command line + +The same commands, for scripts and terminals. `--json` prints JSON. + +- See the versions: `horizon-launcher versions` +- Install the newest: `horizon-launcher install latest` +- Play a world: `horizon-launcher play --world "My world"` +- Change a setting: `horizon-launcher settings install-new-versions on` +- Find a shader pack: `horizon-launcher mods search --kind shader sildurs` +- Read the game's log: `horizon-launcher logs` +- Turn No AI on: `horizon-launcher no-ai on` +- Start a game agents control: `horizon-ctl launch --world Test` +- See the game's state: `horizon-ctl state` +- See what is on screen: `horizon-ctl ui` +- Click a button by name: `horizon-ctl click singleplayer` +- Walk somewhere: `horizon-ctl goto 10 64 -3` +- Take a screenshot: `horizon-ctl screenshot shot.png` + +`horizon-ctl help` lists every game command. `horizon-launcher help` lists the launcher's. + +## Safety + +- **Your computer only.** The launcher's server talks only to the agent that started it. The game listens on a local socket that only your user account can open; where there is none (Windows), it uses a localhost port and a secret token in a file only you can read. Nothing listens on your network. +- **It asks before deleting.** Removing a version, a modpack, a mod or a server, deleting a world or your collected data, and signing out need `confirm: true` from the agent. A call without it is refused and tells the agent to ask you first. +- **It asks before reaching out.** The tools that send something or reach other people say "only when the player asks". That covers joining a server, chatting on one, opening to LAN, hosting for friends, creating a server and sending data or a bug report. Data collection stays off until you allow it yourself. +- **No secrets.** No command returns your account tokens, session files or invite secrets. Accounts appear as names. Signing in stays a code that you enter in your own browser. +- **Your agent, your rules.** Clients such as Claude Code ask you before each tool they haven't been allowed to use. Allow only what you are happy for them to do. + +## No AI: turn it all off + +In the launcher's **Settings**, under **AI**, turn on **No AI**. You can also use **No AI** in the game's **Horizon Settings**, or type `horizon-launcher no-ai on`. Then: + +- the **Connect an AI agent** section and the game's **AI Agent** page are hidden; +- the game opens no control socket, even when it is started with one; +- `horizon-ctl`, `horizon-ctl mcp` and `horizon-launcher mcp` refuse with "AI features are off: turn off No AI in the launcher's settings"; +- the launcher's own commands (install, play, server, update and the rest) keep working, so scripts and packagers don't break. + +Turn it off the same way to bring everything back. diff --git a/website/docs/nav.json b/website/docs/nav.json index bef3aac57..e44fddb26 100644 --- a/website/docs/nav.json +++ b/website/docs/nav.json @@ -2,6 +2,6 @@ { "group": "Start here", "pages": ["index", "install"] }, { "group": "Playing", "pages": ["settings", "multiplayer", "troubleshooting"] }, { "group": "Hosting", "pages": ["hosting"] }, - { "group": "Going further", "pages": ["modpacks", "mods", "performance"] }, + { "group": "Going further", "pages": ["modpacks", "mods", "performance", "agents"] }, { "group": "Project", "pages": ["contributing", "faq"] } ] From 0a450d2963e8b0d5a6bc7e5d3709fcbc3fe9fdf8 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 03:11:31 +0200 Subject: [PATCH 090/126] Benchmarks: the desktop (RTX 4080), players' hardware breakdowns, memory in the estimate - The desktop measured: Horizon v2026.10.22.13 against vanilla 26.3 at render distance 12 and 32, 3 runs each, 1280x720, VSync off, in a headless sway on the RTX 4080 (never on its screen). Replaces the "not yet measured" note. - /benchmarks shows each players' group's hardware split (RAM, VRAM, drive, system, GPU kind) and, once the telemetry server has some, a "Players' hardware" table from /v1/aggregate's breakdowns. Hidden without data. - The picker takes the memory too. Players' groups whose installs have neither the picked RAM nor the GPU's VRAM class count as further away, and the result says what they had and when a game's peak memory is a large share of the RAM. - Each GPU in the spec table has its memory (0: shared). Co-Authored-By: Claude Opus 5.5 --- website/build.mjs | 4 +- .../desktop/horizon-desktop-rd12.json | 774 ++++++++++++++++++ .../desktop/horizon-desktop-rd32.json | 774 ++++++++++++++++++ .../desktop/vanilla-desktop-rd12.json | 723 ++++++++++++++++ .../desktop/vanilla-desktop-rd32.json | 723 ++++++++++++++++ website/data/benchmarks/fleet.json | 27 + website/public/benchmarks.json | 207 ++++- website/src/bench.js | 35 +- website/src/benchmarks-page.js | 33 +- website/src/benchmarks.html | 16 +- website/src/estimate.js | 43 +- website/src/estimate.test.mjs | 37 + website/src/hardware.js | 79 +- website/src/style.css | 3 +- 14 files changed, 3425 insertions(+), 53 deletions(-) create mode 100644 website/data/benchmarks/desktop/horizon-desktop-rd12.json create mode 100644 website/data/benchmarks/desktop/horizon-desktop-rd32.json create mode 100644 website/data/benchmarks/desktop/vanilla-desktop-rd12.json create mode 100644 website/data/benchmarks/desktop/vanilla-desktop-rd32.json diff --git a/website/build.mjs b/website/build.mjs index 698079dc1..a47a40a79 100644 --- a/website/build.mjs +++ b/website/build.mjs @@ -238,8 +238,8 @@ const siteFooter = `
    const fixed = (x, n) => Number(x).toFixed(n); const specTable = - `` + - GPUS.map((g) => ``).join("") + + `
    Graphics cardFP32 TFLOPSBandwidth, GB/s
    ${escape(g.name)}${fixed(g.tflops, 1)}${g.gbps}
    ` + + GPUS.map((g) => ``).join("") + `
    Graphics cardFP32 TFLOPSBandwidth, GB/sMemory, GB
    ${escape(g.name)}${fixed(g.tflops, 1)}${g.gbps}${g.vram_gb || "shared"}
    ` + CPUS.map((c) => ``).join("") + `
    ProcessorBoost, GHzGeneration factorSingle-thread score
    ${escape(c.name)}${fixed(c.ghz, 2)}${fixed(c.ipc, 2)}${fixed(singleThread(c), 2)}
    `; diff --git a/website/data/benchmarks/desktop/horizon-desktop-rd12.json b/website/data/benchmarks/desktop/horizon-desktop-rd12.json new file mode 100644 index 000000000..4b833f730 --- /dev/null +++ b/website/data/benchmarks/desktop/horizon-desktop-rd12.json @@ -0,0 +1,774 @@ +{ + "format": "horizon-benchmark-report", + "version": 1, + "kind": "game", + "created": "2026-10-23T00:36:08Z", + "app": { + "name": "horizon-client", + "version": "0.1.0", + "commit": "07e71797" + }, + "hardware": { + "os": "linux", + "arch": "x86_64", + "cpu_threads": 24, + "os_version": "NixOS 26.05 (Yarara) (kernel 6.18.57)", + "cpu": "13th Gen Intel(R) Core(TM) i7-13700KF", + "ram_mb": 31904, + "gpu": { + "name": "NVIDIA GeForce RTX 4080", + "vendor": "nvidia", + "driver": "NVIDIA 595.71.05", + "backend": "vulkan", + "kind": "discrete" + } + }, + "conditions": { + "scenario": "perf_bench:village,forest,ocean,mountain", + "seed": "1234", + "render_distance": 12, + "simulation_distance": 12, + "vsync": false, + "offscreen": false, + "repeats": 3, + "warmup_s": 2.0, + "load_avg_1m": 17.934, + "window": [ + 1280, + 720 + ] + }, + "metrics": { + "startup.title_ms": { + "n": 3, + "mean": 10795.933, + "stdev": 13944.902, + "min": 2694.75, + "max": 26898.014, + "ci95": 34643.852 + }, + "startup.world_ms": { + "n": 3, + "mean": 17972.549, + "stdev": 13965.287, + "min": 6319.925, + "max": 33452.436, + "ci95": 34694.496 + }, + "chunks.village.load_ms": { + "n": 3, + "mean": 1260.016, + "stdev": 503.052, + "min": 679.248, + "max": 1560.056, + "ci95": 1249.753 + }, + "chunks.village.meshed_count": { + "n": 3, + "mean": 9182.667, + "stdev": 24.705, + "min": 9160.0, + "max": 9209.0, + "ci95": 61.375 + }, + "fps.village.avg_fps": { + "n": 3, + "mean": 2593.701, + "stdev": 266.92, + "min": 2285.61, + "max": 2755.256, + "ci95": 663.12 + }, + "fps.village.low_1pct_fps": { + "n": 3, + "mean": 253.998, + "stdev": 45.489, + "min": 203.519, + "max": 291.815, + "ci95": 113.011 + }, + "fps.village.low_01pct_fps": { + "n": 3, + "mean": 129.195, + "stdev": 39.949, + "min": 99.233, + "max": 174.551, + "ci95": 99.247 + }, + "memory.village.gpu_mb": { + "n": 3, + "mean": 982.0, + "stdev": 0.0, + "min": 982.0, + "max": 982.0, + "ci95": 0.0 + }, + "chunks.forest.load_ms": { + "n": 3, + "mean": 1591.886, + "stdev": 579.89, + "min": 950.688, + "max": 2079.581, + "ci95": 1440.643 + }, + "chunks.forest.meshed_count": { + "n": 3, + "mean": 10278.667, + "stdev": 9.292, + "min": 10271.0, + "max": 10289.0, + "ci95": 23.083 + }, + "fps.forest.avg_fps": { + "n": 3, + "mean": 3426.658, + "stdev": 200.328, + "min": 3202.184, + "max": 3587.268, + "ci95": 497.683 + }, + "fps.forest.low_1pct_fps": { + "n": 3, + "mean": 327.656, + "stdev": 39.232, + "min": 283.548, + "max": 358.656, + "ci95": 97.466 + }, + "fps.forest.low_01pct_fps": { + "n": 3, + "mean": 141.195, + "stdev": 12.058, + "min": 127.735, + "max": 151.011, + "ci95": 29.956 + }, + "memory.forest.gpu_mb": { + "n": 3, + "mean": 1323.333, + "stdev": 295.603, + "min": 982.0, + "max": 1494.0, + "ci95": 734.379 + }, + "chunks.ocean.load_ms": { + "n": 3, + "mean": 2659.926, + "stdev": 2159.489, + "min": 1288.28, + "max": 5149.172, + "ci95": 5364.902 + }, + "chunks.ocean.meshed_count": { + "n": 3, + "mean": 9016.0, + "stdev": 517.249, + "min": 8623.0, + "max": 9602.0, + "ci95": 1285.023 + }, + "fps.ocean.avg_fps": { + "n": 3, + "mean": 3277.475, + "stdev": 71.523, + "min": 3210.907, + "max": 3353.092, + "ci95": 177.688 + }, + "fps.ocean.low_1pct_fps": { + "n": 3, + "mean": 387.862, + "stdev": 43.664, + "min": 341.534, + "max": 428.255, + "ci95": 108.476 + }, + "fps.ocean.low_01pct_fps": { + "n": 3, + "mean": 173.188, + "stdev": 61.528, + "min": 104.34, + "max": 222.8, + "ci95": 152.857 + }, + "memory.ocean.gpu_mb": { + "n": 3, + "mean": 1238.0, + "stdev": 0.0, + "min": 1238.0, + "max": 1238.0, + "ci95": 0.0 + }, + "chunks.mountain.load_ms": { + "n": 3, + "mean": 1675.173, + "stdev": 449.734, + "min": 1361.858, + "max": 2190.49, + "ci95": 1117.293 + }, + "chunks.mountain.meshed_count": { + "n": 3, + "mean": 10546.0, + "stdev": 34.699, + "min": 10516.0, + "max": 10584.0, + "ci95": 86.203 + }, + "fps.mountain.avg_fps": { + "n": 3, + "mean": 2672.531, + "stdev": 87.428, + "min": 2572.733, + "max": 2735.621, + "ci95": 217.202 + }, + "fps.mountain.low_1pct_fps": { + "n": 3, + "mean": 275.049, + "stdev": 9.403, + "min": 264.82, + "max": 283.318, + "ci95": 23.361 + }, + "fps.mountain.low_01pct_fps": { + "n": 3, + "mean": 123.382, + "stdev": 2.627, + "min": 121.404, + "max": 126.363, + "ci95": 6.527 + }, + "memory.mountain.gpu_mb": { + "n": 3, + "mean": 1238.0, + "stdev": 0.0, + "min": 1238.0, + "max": 1238.0, + "ci95": 0.0 + }, + "memory.rss_peak_mb": { + "n": 3, + "mean": 1414.479, + "stdev": 24.614, + "min": 1386.086, + "max": 1429.77, + "ci95": 61.148 + }, + "memory.rss_steady_mb": { + "n": 3, + "mean": 1202.283, + "stdev": 33.096, + "min": 1169.059, + "max": 1235.25, + "ci95": 82.223 + } + }, + "frames": [ + { + "phase": "village", + "repeat": 0, + "frames": 33063, + "seconds": 12.0, + "avg_fps": 2755.256, + "low_1pct_fps": 266.659, + "low_01pct_fps": 99.233, + "p50_ms": 0.306, + "p95_ms": 0.459, + "p99_ms": 1.268, + "p999_ms": 4.771, + "max_ms": 124.422, + "cpu_p50_ms": 0.271, + "gpu_p50_ms": 0.065, + "histogram": [ + 32542, + 268, + 30, + 153, + 44, + 15, + 6, + 1, + 0, + 1, + 1, + 0, + 0, + 0, + 1, + 0, + 0, + 0, + 0, + 1, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "village", + "repeat": 1, + "frames": 27428, + "seconds": 12.0, + "avg_fps": 2285.61, + "low_1pct_fps": 203.519, + "low_01pct_fps": 113.802, + "p50_ms": 0.336, + "p95_ms": 0.715, + "p99_ms": 2.315, + "p999_ms": 7.476, + "max_ms": 13.28, + "cpu_p50_ms": 0.299, + "gpu_p50_ms": 0.066, + "histogram": [ + 26734, + 400, + 37, + 94, + 67, + 35, + 23, + 24, + 10, + 3, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "village", + "repeat": 2, + "frames": 32883, + "seconds": 12.0, + "avg_fps": 2740.237, + "low_1pct_fps": 291.815, + "low_01pct_fps": 174.551, + "p50_ms": 0.31, + "p95_ms": 0.437, + "p99_ms": 1.399, + "p999_ms": 5.007, + "max_ms": 9.523, + "cpu_p50_ms": 0.275, + "gpu_p50_ms": 0.066, + "histogram": [ + 32316, + 314, + 13, + 161, + 46, + 25, + 6, + 1, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "forest", + "repeat": 0, + "frames": 41887, + "seconds": 12.0, + "avg_fps": 3490.521, + "low_1pct_fps": 340.763, + "low_01pct_fps": 144.838, + "p50_ms": 0.242, + "p95_ms": 0.38, + "p99_ms": 1.172, + "p999_ms": 5.439, + "max_ms": 9.908, + "cpu_p50_ms": 0.21, + "gpu_p50_ms": 0.084, + "histogram": [ + 41255, + 377, + 76, + 110, + 21, + 16, + 17, + 7, + 8, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "forest", + "repeat": 1, + "frames": 38443, + "seconds": 12.005, + "avg_fps": 3202.184, + "low_1pct_fps": 283.548, + "low_01pct_fps": 127.735, + "p50_ms": 0.248, + "p95_ms": 0.49, + "p99_ms": 1.533, + "p999_ms": 6.44, + "max_ms": 13.381, + "cpu_p50_ms": 0.216, + "gpu_p50_ms": 0.084, + "histogram": [ + 37784, + 375, + 85, + 95, + 33, + 26, + 19, + 14, + 10, + 0, + 2, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "forest", + "repeat": 2, + "frames": 43048, + "seconds": 12.0, + "avg_fps": 3587.268, + "low_1pct_fps": 358.656, + "low_01pct_fps": 151.011, + "p50_ms": 0.241, + "p95_ms": 0.318, + "p99_ms": 1.122, + "p999_ms": 4.817, + "max_ms": 10.326, + "cpu_p50_ms": 0.209, + "gpu_p50_ms": 0.084, + "histogram": [ + 42442, + 354, + 87, + 95, + 31, + 14, + 10, + 8, + 6, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "ocean", + "repeat": 0, + "frames": 38531, + "seconds": 12.0, + "avg_fps": 3210.907, + "low_1pct_fps": 341.534, + "low_01pct_fps": 104.34, + "p50_ms": 0.265, + "p95_ms": 0.44, + "p99_ms": 1.171, + "p999_ms": 4.04, + "max_ms": 169.171, + "cpu_p50_ms": 0.232, + "gpu_p50_ms": 0.082, + "histogram": [ + 37966, + 321, + 156, + 54, + 16, + 9, + 3, + 2, + 3, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 1, + 0, + 0, + 0 + ] + }, + { + "phase": "ocean", + "repeat": 1, + "frames": 40238, + "seconds": 12.0, + "avg_fps": 3353.092, + "low_1pct_fps": 428.255, + "low_01pct_fps": 222.8, + "p50_ms": 0.262, + "p95_ms": 0.385, + "p99_ms": 1.199, + "p999_ms": 3.403, + "max_ms": 9.156, + "cpu_p50_ms": 0.23, + "gpu_p50_ms": 0.081, + "histogram": [ + 39659, + 325, + 186, + 49, + 11, + 3, + 1, + 3, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "ocean", + "repeat": 2, + "frames": 39222, + "seconds": 12.0, + "avg_fps": 3268.426, + "low_1pct_fps": 393.798, + "low_01pct_fps": 192.424, + "p50_ms": 0.265, + "p95_ms": 0.415, + "p99_ms": 1.317, + "p999_ms": 3.623, + "max_ms": 10.651, + "cpu_p50_ms": 0.232, + "gpu_p50_ms": 0.081, + "histogram": [ + 38610, + 357, + 169, + 59, + 12, + 7, + 4, + 1, + 1, + 2, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "mountain", + "repeat": 0, + "frames": 30873, + "seconds": 12.0, + "avg_fps": 2572.733, + "low_1pct_fps": 264.82, + "low_01pct_fps": 122.378, + "p50_ms": 0.326, + "p95_ms": 0.605, + "p99_ms": 1.424, + "p999_ms": 6.393, + "max_ms": 14.698, + "cpu_p50_ms": 0.291, + "gpu_p50_ms": 0.082, + "histogram": [ + 30329, + 300, + 11, + 155, + 37, + 10, + 10, + 13, + 3, + 3, + 1, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "mountain", + "repeat": 1, + "frames": 32828, + "seconds": 12.0, + "avg_fps": 2735.621, + "low_1pct_fps": 283.318, + "low_01pct_fps": 121.404, + "p50_ms": 0.32, + "p95_ms": 0.496, + "p99_ms": 1.264, + "p999_ms": 5.842, + "max_ms": 17.335, + "cpu_p50_ms": 0.286, + "gpu_p50_ms": 0.082, + "histogram": [ + 32256, + 320, + 50, + 130, + 27, + 15, + 9, + 7, + 9, + 3, + 1, + 0, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "mountain", + "repeat": 2, + "frames": 32511, + "seconds": 12.0, + "avg_fps": 2709.239, + "low_1pct_fps": 277.009, + "low_01pct_fps": 126.363, + "p50_ms": 0.319, + "p95_ms": 0.536, + "p99_ms": 1.362, + "p999_ms": 5.537, + "max_ms": 15.451, + "cpu_p50_ms": 0.285, + "gpu_p50_ms": 0.082, + "histogram": [ + 31962, + 290, + 26, + 173, + 18, + 16, + 10, + 6, + 4, + 4, + 0, + 2, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + } + ], + "label": "horizon-desktop" +} diff --git a/website/data/benchmarks/desktop/horizon-desktop-rd32.json b/website/data/benchmarks/desktop/horizon-desktop-rd32.json new file mode 100644 index 000000000..f096ad61b --- /dev/null +++ b/website/data/benchmarks/desktop/horizon-desktop-rd32.json @@ -0,0 +1,774 @@ +{ + "format": "horizon-benchmark-report", + "version": 1, + "kind": "game", + "created": "2026-10-23T00:43:34Z", + "app": { + "name": "horizon-client", + "version": "0.1.0", + "commit": "07e71797" + }, + "hardware": { + "os": "linux", + "arch": "x86_64", + "cpu_threads": 24, + "os_version": "NixOS 26.05 (Yarara) (kernel 6.18.57)", + "cpu": "13th Gen Intel(R) Core(TM) i7-13700KF", + "ram_mb": 31904, + "gpu": { + "name": "NVIDIA GeForce RTX 4080", + "vendor": "nvidia", + "driver": "NVIDIA 595.71.05", + "backend": "vulkan", + "kind": "discrete" + } + }, + "conditions": { + "scenario": "perf_bench:village,forest,ocean,mountain", + "seed": "1234", + "render_distance": 32, + "simulation_distance": 12, + "vsync": false, + "offscreen": false, + "repeats": 3, + "warmup_s": 2.0, + "load_avg_1m": 22.354, + "window": [ + 1280, + 720 + ] + }, + "metrics": { + "startup.title_ms": { + "n": 3, + "mean": 3223.157, + "stdev": 1895.181, + "min": 1770.597, + "max": 5366.923, + "ci95": 4708.272 + }, + "startup.world_ms": { + "n": 3, + "mean": 8999.144, + "stdev": 1593.439, + "min": 7467.122, + "max": 10647.611, + "ci95": 3958.641 + }, + "chunks.village.load_ms": { + "n": 3, + "mean": 2702.493, + "stdev": 332.199, + "min": 2494.684, + "max": 3085.624, + "ci95": 825.294 + }, + "chunks.village.meshed_count": { + "n": 3, + "mean": 42899.667, + "stdev": 866.726, + "min": 41974.0, + "max": 43692.0, + "ci95": 2153.241 + }, + "fps.village.avg_fps": { + "n": 3, + "mean": 685.508, + "stdev": 151.759, + "min": 512.479, + "max": 796.037, + "ci95": 377.022 + }, + "fps.village.low_1pct_fps": { + "n": 3, + "mean": 93.031, + "stdev": 31.096, + "min": 57.146, + "max": 112.055, + "ci95": 77.253 + }, + "fps.village.low_01pct_fps": { + "n": 3, + "mean": 60.993, + "stdev": 17.294, + "min": 41.024, + "max": 71.142, + "ci95": 42.965 + }, + "memory.village.gpu_mb": { + "n": 3, + "mean": 2390.0, + "stdev": 0.0, + "min": 2390.0, + "max": 2390.0, + "ci95": 0.0 + }, + "chunks.forest.load_ms": { + "n": 3, + "mean": 4823.42, + "stdev": 395.462, + "min": 4545.561, + "max": 5276.174, + "ci95": 982.461 + }, + "chunks.forest.meshed_count": { + "n": 3, + "mean": 69214.333, + "stdev": 243.052, + "min": 68957.0, + "max": 69440.0, + "ci95": 603.824 + }, + "fps.forest.avg_fps": { + "n": 3, + "mean": 590.362, + "stdev": 195.262, + "min": 373.61, + "max": 752.506, + "ci95": 485.096 + }, + "fps.forest.low_1pct_fps": { + "n": 3, + "mean": 75.679, + "stdev": 34.507, + "min": 41.158, + "max": 110.171, + "ci95": 85.726 + }, + "fps.forest.low_01pct_fps": { + "n": 3, + "mean": 41.943, + "stdev": 22.598, + "min": 22.254, + "max": 66.617, + "ci95": 56.141 + }, + "memory.forest.gpu_mb": { + "n": 3, + "mean": 2646.0, + "stdev": 0.0, + "min": 2646.0, + "max": 2646.0, + "ci95": 0.0 + }, + "chunks.ocean.load_ms": { + "n": 3, + "mean": 3628.996, + "stdev": 953.676, + "min": 3030.638, + "max": 4728.784, + "ci95": 2369.254 + }, + "chunks.ocean.meshed_count": { + "n": 3, + "mean": 66732.667, + "stdev": 470.761, + "min": 66379.0, + "max": 67267.0, + "ci95": 1169.531 + }, + "fps.ocean.avg_fps": { + "n": 3, + "mean": 867.7, + "stdev": 24.924, + "min": 840.039, + "max": 888.411, + "ci95": 61.919 + }, + "fps.ocean.low_1pct_fps": { + "n": 3, + "mean": 113.015, + "stdev": 5.586, + "min": 106.569, + "max": 116.454, + "ci95": 13.878 + }, + "fps.ocean.low_01pct_fps": { + "n": 3, + "mean": 64.662, + "stdev": 4.205, + "min": 60.245, + "max": 68.618, + "ci95": 10.448 + }, + "memory.ocean.gpu_mb": { + "n": 3, + "mean": 2646.0, + "stdev": 0.0, + "min": 2646.0, + "max": 2646.0, + "ci95": 0.0 + }, + "chunks.mountain.load_ms": { + "n": 3, + "mean": 7552.085, + "stdev": 1200.747, + "min": 6352.523, + "max": 8754.014, + "ci95": 2983.062 + }, + "chunks.mountain.meshed_count": { + "n": 3, + "mean": 75906.0, + "stdev": 159.69, + "min": 75725.0, + "max": 76027.0, + "ci95": 396.725 + }, + "fps.mountain.avg_fps": { + "n": 3, + "mean": 544.171, + "stdev": 109.268, + "min": 419.998, + "max": 625.628, + "ci95": 271.458 + }, + "fps.mountain.low_1pct_fps": { + "n": 3, + "mean": 73.334, + "stdev": 15.459, + "min": 56.192, + "max": 86.217, + "ci95": 38.405 + }, + "fps.mountain.low_01pct_fps": { + "n": 3, + "mean": 44.998, + "stdev": 6.524, + "min": 37.602, + "max": 49.935, + "ci95": 16.207 + }, + "memory.mountain.gpu_mb": { + "n": 3, + "mean": 3243.333, + "stdev": 147.802, + "min": 3158.0, + "max": 3414.0, + "ci95": 367.189 + }, + "memory.rss_peak_mb": { + "n": 3, + "mean": 1956.853, + "stdev": 83.778, + "min": 1868.5, + "max": 2035.148, + "ci95": 208.133 + }, + "memory.rss_steady_mb": { + "n": 3, + "mean": 1646.435, + "stdev": 30.998, + "min": 1617.857, + "max": 1679.389, + "ci95": 77.01 + } + }, + "frames": [ + { + "phase": "village", + "repeat": 0, + "frames": 9552, + "seconds": 11.999, + "avg_fps": 796.037, + "low_1pct_fps": 112.055, + "low_01pct_fps": 70.812, + "p50_ms": 0.975, + "p95_ms": 2.218, + "p99_ms": 6.816, + "p999_ms": 12.22, + "max_ms": 17.3, + "cpu_p50_ms": 0.933, + "gpu_p50_ms": 0.247, + "histogram": [ + 5935, + 2999, + 296, + 57, + 16, + 93, + 68, + 44, + 23, + 11, + 6, + 3, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "village", + "repeat": 1, + "frames": 6150, + "seconds": 12.0, + "avg_fps": 512.479, + "low_1pct_fps": 57.146, + "low_01pct_fps": 41.024, + "p50_ms": 1.162, + "p95_ms": 5.201, + "p99_ms": 14.081, + "p999_ms": 21.346, + "max_ms": 34.138, + "cpu_p50_ms": 1.106, + "gpu_p50_ms": 0.264, + "histogram": [ + 2098, + 2525, + 744, + 369, + 87, + 86, + 41, + 41, + 46, + 29, + 21, + 33, + 20, + 8, + 1, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "village", + "repeat": 2, + "frames": 8981, + "seconds": 12.007, + "avg_fps": 748.007, + "low_1pct_fps": 109.891, + "low_01pct_fps": 71.142, + "p50_ms": 1.021, + "p95_ms": 2.555, + "p99_ms": 7.187, + "p999_ms": 12.828, + "max_ms": 16.902, + "cpu_p50_ms": 0.975, + "gpu_p50_ms": 0.263, + "histogram": [ + 4071, + 4237, + 311, + 93, + 10, + 61, + 94, + 55, + 30, + 7, + 9, + 2, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "forest", + "repeat": 0, + "frames": 9031, + "seconds": 12.001, + "avg_fps": 752.506, + "low_1pct_fps": 110.171, + "low_01pct_fps": 66.617, + "p50_ms": 1.047, + "p95_ms": 2.413, + "p99_ms": 6.6, + "p999_ms": 13.248, + "max_ms": 16.878, + "cpu_p50_ms": 1.005, + "gpu_p50_ms": 0.398, + "histogram": [ + 1109, + 7289, + 301, + 62, + 69, + 80, + 44, + 36, + 20, + 6, + 8, + 6, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "forest", + "repeat": 1, + "frames": 7740, + "seconds": 12.001, + "avg_fps": 644.97, + "low_1pct_fps": 75.707, + "low_01pct_fps": 36.957, + "p50_ms": 1.091, + "p95_ms": 3.344, + "p99_ms": 8.483, + "p999_ms": 23.855, + "max_ms": 29.382, + "cpu_p50_ms": 1.046, + "gpu_p50_ms": 0.4, + "histogram": [ + 304, + 6528, + 456, + 139, + 55, + 72, + 51, + 53, + 40, + 13, + 7, + 8, + 1, + 6, + 7, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "forest", + "repeat": 2, + "frames": 4484, + "seconds": 12.002, + "avg_fps": 373.61, + "low_1pct_fps": 41.158, + "low_01pct_fps": 22.254, + "p50_ms": 1.526, + "p95_ms": 7.517, + "p99_ms": 18.1, + "p999_ms": 33.482, + "max_ms": 58.633, + "cpu_p50_ms": 1.445, + "gpu_p50_ms": 0.414, + "histogram": [ + 4, + 2841, + 562, + 454, + 169, + 140, + 65, + 63, + 39, + 30, + 29, + 32, + 30, + 14, + 7, + 1, + 3, + 1, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "ocean", + "repeat": 0, + "frames": 10661, + "seconds": 12.0, + "avg_fps": 888.411, + "low_1pct_fps": 116.454, + "low_01pct_fps": 68.618, + "p50_ms": 0.878, + "p95_ms": 2.165, + "p99_ms": 5.268, + "p999_ms": 13.015, + "max_ms": 18.852, + "cpu_p50_ms": 0.837, + "gpu_p50_ms": 0.35, + "histogram": [ + 8240, + 1821, + 246, + 135, + 98, + 39, + 25, + 8, + 18, + 11, + 16, + 2, + 2, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "ocean", + "repeat": 1, + "frames": 10496, + "seconds": 12.0, + "avg_fps": 874.651, + "low_1pct_fps": 116.021, + "low_01pct_fps": 60.245, + "p50_ms": 0.864, + "p95_ms": 2.203, + "p99_ms": 5.482, + "p999_ms": 12.557, + "max_ms": 20.239, + "cpu_p50_ms": 0.821, + "gpu_p50_ms": 0.353, + "histogram": [ + 7610, + 2286, + 236, + 124, + 98, + 56, + 21, + 25, + 15, + 13, + 4, + 2, + 4, + 2, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "ocean", + "repeat": 2, + "frames": 10080, + "seconds": 11.999, + "avg_fps": 840.039, + "low_1pct_fps": 106.569, + "low_01pct_fps": 65.123, + "p50_ms": 0.889, + "p95_ms": 2.576, + "p99_ms": 5.746, + "p999_ms": 13.975, + "max_ms": 17.531, + "cpu_p50_ms": 0.845, + "gpu_p50_ms": 0.351, + "histogram": [ + 7336, + 1986, + 372, + 136, + 117, + 44, + 14, + 19, + 21, + 16, + 9, + 7, + 3, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "mountain", + "repeat": 0, + "frames": 7043, + "seconds": 12.001, + "avg_fps": 586.888, + "low_1pct_fps": 77.592, + "low_01pct_fps": 47.456, + "p50_ms": 1.203, + "p95_ms": 3.879, + "p99_ms": 8.496, + "p999_ms": 17.959, + "max_ms": 23.68, + "cpu_p50_ms": 1.159, + "gpu_p50_ms": 0.356, + "histogram": [ + 0, + 5932, + 573, + 213, + 48, + 93, + 64, + 45, + 27, + 18, + 6, + 10, + 8, + 6, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "mountain", + "repeat": 1, + "frames": 7508, + "seconds": 12.001, + "avg_fps": 625.628, + "low_1pct_fps": 86.217, + "low_01pct_fps": 49.935, + "p50_ms": 1.2, + "p95_ms": 3.217, + "p99_ms": 7.725, + "p999_ms": 16.759, + "max_ms": 22.613, + "cpu_p50_ms": 1.157, + "gpu_p50_ms": 0.361, + "histogram": [ + 0, + 6649, + 448, + 117, + 26, + 70, + 93, + 40, + 25, + 14, + 10, + 7, + 4, + 5, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "mountain", + "repeat": 2, + "frames": 5040, + "seconds": 12.0, + "avg_fps": 419.998, + "low_1pct_fps": 56.192, + "low_01pct_fps": 37.602, + "p50_ms": 1.71, + "p95_ms": 6.335, + "p99_ms": 12.398, + "p999_ms": 23.227, + "max_ms": 32.253, + "cpu_p50_ms": 1.634, + "gpu_p50_ms": 0.429, + "histogram": [ + 0, + 3163, + 1077, + 371, + 104, + 58, + 48, + 71, + 47, + 41, + 17, + 16, + 17, + 7, + 3, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + } + ], + "label": "horizon-desktop" +} diff --git a/website/data/benchmarks/desktop/vanilla-desktop-rd12.json b/website/data/benchmarks/desktop/vanilla-desktop-rd12.json new file mode 100644 index 000000000..e21615c9b --- /dev/null +++ b/website/data/benchmarks/desktop/vanilla-desktop-rd12.json @@ -0,0 +1,723 @@ +{ + "format": "horizon-benchmark-report", + "version": 1, + "kind": "game", + "created": "2026-10-23T00:52:47Z", + "app": { + "name": "minecraft", + "version": "26.3", + "mods": [ + { + "name": "fabric-loader", + "version": "0.19.5" + } + ] + }, + "hardware": { + "os": "linux", + "arch": "x86_64", + "cpu_threads": 24, + "os_version": "NixOS 26.05 (Yarara) (kernel 6.18.57)", + "cpu": "13th Gen Intel(R) Core(TM) i7-13700KF", + "ram_mb": 31904, + "gpu": { + "name": "NVIDIA GeForce RTX 4080", + "vendor": "NVIDIA", + "driver": "1.4.329 NVIDIA 595.71.05", + "backend": "vulkan", + "kind": "" + } + }, + "conditions": { + "scenario": "perf_bench:village,forest,ocean,mountain", + "seed": "1234", + "render_distance": 12, + "simulation_distance": 12, + "vsync": false, + "offscreen": false, + "repeats": 3, + "warmup_s": 2.0, + "load_avg_1m": 25.007, + "window": [ + 1280, + 720 + ] + }, + "metrics": { + "startup.title_ms": { + "n": 3, + "mean": 12177.771, + "stdev": 8960.751, + "min": 6852.719, + "max": 22523.26, + "ci95": 22261.536 + }, + "startup.world_ms": { + "n": 3, + "mean": 30469.771, + "stdev": 9525.862, + "min": 23924.719, + "max": 41398.26, + "ci95": 23665.464 + }, + "chunks.village.load_ms": { + "n": 3, + "mean": 8002.915, + "stdev": 2750.518, + "min": 5499.832, + "max": 10947.467, + "ci95": 6833.218 + }, + "fps.village.avg_fps": { + "n": 3, + "mean": 2481.889, + "stdev": 303.157, + "min": 2203.739, + "max": 2805.025, + "ci95": 753.144 + }, + "fps.village.low_1pct_fps": { + "n": 3, + "mean": 385.31, + "stdev": 241.771, + "min": 129.951, + "max": 610.699, + "ci95": 600.641 + }, + "fps.village.low_01pct_fps": { + "n": 3, + "mean": 107.075, + "stdev": 81.437, + "min": 16.766, + "max": 174.928, + "ci95": 202.318 + }, + "memory.village.gpu_mb": { + "n": 3, + "mean": 44.667, + "stdev": 41.789, + "min": 6.0, + "max": 89.0, + "ci95": 103.818 + }, + "chunks.forest.load_ms": { + "n": 3, + "mean": 9653.503, + "stdev": 3442.183, + "min": 7186.472, + "max": 13585.896, + "ci95": 8551.546 + }, + "fps.forest.avg_fps": { + "n": 3, + "mean": 2367.898, + "stdev": 266.822, + "min": 2176.324, + "max": 2672.655, + "ci95": 662.876 + }, + "fps.forest.low_1pct_fps": { + "n": 3, + "mean": 208.784, + "stdev": 102.377, + "min": 91.127, + "max": 277.551, + "ci95": 254.34 + }, + "fps.forest.low_01pct_fps": { + "n": 3, + "mean": 56.84, + "stdev": 59.634, + "min": 10.785, + "max": 124.2, + "ci95": 148.151 + }, + "memory.forest.gpu_mb": { + "n": 3, + "mean": 44.667, + "stdev": 41.789, + "min": 6.0, + "max": 89.0, + "ci95": 103.818 + }, + "chunks.ocean.load_ms": { + "n": 3, + "mean": 10441.986, + "stdev": 2957.968, + "min": 7966.98, + "max": 13717.953, + "ci95": 7348.594 + }, + "fps.ocean.avg_fps": { + "n": 3, + "mean": 2727.058, + "stdev": 257.941, + "min": 2429.545, + "max": 2887.978, + "ci95": 640.812 + }, + "fps.ocean.low_1pct_fps": { + "n": 3, + "mean": 246.78, + "stdev": 35.091, + "min": 211.805, + "max": 281.986, + "ci95": 87.178 + }, + "fps.ocean.low_01pct_fps": { + "n": 3, + "mean": 55.43, + "stdev": 45.634, + "min": 26.317, + "max": 108.023, + "ci95": 113.369 + }, + "memory.ocean.gpu_mb": { + "n": 3, + "mean": 44.667, + "stdev": 41.789, + "min": 6.0, + "max": 89.0, + "ci95": 103.818 + }, + "chunks.mountain.load_ms": { + "n": 3, + "mean": 15248.98, + "stdev": 1927.895, + "min": 13668.264, + "max": 17396.829, + "ci95": 4789.544 + }, + "fps.mountain.avg_fps": { + "n": 3, + "mean": 2824.349, + "stdev": 222.395, + "min": 2568.693, + "max": 2973.143, + "ci95": 552.505 + }, + "fps.mountain.low_1pct_fps": { + "n": 3, + "mean": 407.099, + "stdev": 174.268, + "min": 207.655, + "max": 529.972, + "ci95": 432.941 + }, + "fps.mountain.low_01pct_fps": { + "n": 3, + "mean": 69.832, + "stdev": 35.341, + "min": 29.188, + "max": 93.326, + "ci95": 87.8 + }, + "memory.mountain.gpu_mb": { + "n": 3, + "mean": 44.667, + "stdev": 41.789, + "min": 6.0, + "max": 89.0, + "ci95": 103.818 + }, + "memory.rss_peak_mb": { + "n": 3, + "mean": 3078.311, + "stdev": 77.595, + "min": 3022.469, + "max": 3166.914, + "ci95": 192.773 + }, + "memory.rss_steady_mb": { + "n": 3, + "mean": 2882.664, + "stdev": 183.911, + "min": 2768.117, + "max": 3094.801, + "ci95": 456.898 + } + }, + "frames": [ + { + "phase": "village", + "repeat": 0, + "frames": 29243, + "seconds": 12.0, + "avg_fps": 2436.904, + "low_1pct_fps": 415.279, + "low_01pct_fps": 129.532, + "p50_ms": 0.354, + "p95_ms": 0.691, + "p99_ms": 1.231, + "p999_ms": 3.925, + "max_ms": 17.066, + "histogram": [ + 28752, + 394, + 53, + 20, + 6, + 2, + 3, + 4, + 0, + 5, + 0, + 3, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "village", + "repeat": 1, + "frames": 26445, + "seconds": 12.0, + "avg_fps": 2203.739, + "low_1pct_fps": 129.951, + "low_01pct_fps": 16.766, + "p50_ms": 0.33, + "p95_ms": 0.712, + "p99_ms": 1.185, + "p999_ms": 4.919, + "max_ms": 460.22, + "histogram": [ + 26007, + 352, + 38, + 16, + 6, + 6, + 2, + 5, + 3, + 4, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 2, + 2, + 2, + 0, + 0 + ] + }, + { + "phase": "village", + "repeat": 2, + "frames": 33661, + "seconds": 12.0, + "avg_fps": 2805.025, + "low_1pct_fps": 610.699, + "low_01pct_fps": 174.928, + "p50_ms": 0.315, + "p95_ms": 0.5, + "p99_ms": 0.95, + "p999_ms": 2.426, + "max_ms": 12.54, + "histogram": [ + 33371, + 251, + 9, + 6, + 7, + 0, + 10, + 4, + 0, + 2, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "forest", + "repeat": 0, + "frames": 32072, + "seconds": 12.0, + "avg_fps": 2672.655, + "low_1pct_fps": 257.674, + "low_01pct_fps": 35.534, + "p50_ms": 0.336, + "p95_ms": 0.37, + "p99_ms": 0.797, + "p999_ms": 2.624, + "max_ms": 735.482, + "histogram": [ + 31895, + 137, + 11, + 14, + 1, + 1, + 1, + 3, + 3, + 1, + 2, + 2, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 1, + 0 + ] + }, + { + "phase": "forest", + "repeat": 1, + "frames": 27011, + "seconds": 12.411, + "avg_fps": 2176.324, + "low_1pct_fps": 91.127, + "low_01pct_fps": 10.785, + "p50_ms": 0.346, + "p95_ms": 0.401, + "p99_ms": 0.934, + "p999_ms": 3.871, + "max_ms": 818.414, + "histogram": [ + 26776, + 162, + 31, + 17, + 5, + 3, + 2, + 4, + 1, + 2, + 0, + 1, + 2, + 0, + 0, + 0, + 0, + 0, + 0, + 1, + 0, + 1, + 3, + 0 + ] + }, + { + "phase": "forest", + "repeat": 2, + "frames": 27058, + "seconds": 12.001, + "avg_fps": 2254.715, + "low_1pct_fps": 277.551, + "low_01pct_fps": 124.2, + "p50_ms": 0.367, + "p95_ms": 0.761, + "p99_ms": 2.117, + "p999_ms": 5.229, + "max_ms": 18.327, + "histogram": [ + 26114, + 645, + 153, + 91, + 23, + 15, + 4, + 4, + 4, + 1, + 1, + 2, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "ocean", + "repeat": 0, + "frames": 34656, + "seconds": 12.0, + "avg_fps": 2887.978, + "low_1pct_fps": 246.55, + "low_01pct_fps": 31.951, + "p50_ms": 0.301, + "p95_ms": 0.374, + "p99_ms": 0.744, + "p999_ms": 1.84, + "max_ms": 529.481, + "histogram": [ + 34514, + 111, + 10, + 3, + 3, + 3, + 3, + 0, + 1, + 1, + 2, + 1, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 1, + 0, + 1, + 1, + 0 + ] + }, + { + "phase": "ocean", + "repeat": 1, + "frames": 34364, + "seconds": 12.0, + "avg_fps": 2863.651, + "low_1pct_fps": 211.805, + "low_01pct_fps": 26.317, + "p50_ms": 0.299, + "p95_ms": 0.354, + "p99_ms": 0.726, + "p999_ms": 2.066, + "max_ms": 406.779, + "histogram": [ + 34238, + 91, + 8, + 9, + 4, + 0, + 3, + 2, + 2, + 1, + 0, + 1, + 0, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 2, + 2, + 0, + 0 + ] + }, + { + "phase": "ocean", + "repeat": 2, + "frames": 29155, + "seconds": 12.0, + "avg_fps": 2429.545, + "low_1pct_fps": 281.986, + "low_01pct_fps": 108.023, + "p50_ms": 0.328, + "p95_ms": 0.694, + "p99_ms": 1.869, + "p999_ms": 5.426, + "max_ms": 21.079, + "histogram": [ + 28371, + 532, + 131, + 52, + 30, + 19, + 3, + 6, + 1, + 3, + 3, + 1, + 1, + 2, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "mountain", + "repeat": 0, + "frames": 35678, + "seconds": 12.0, + "avg_fps": 2973.143, + "low_1pct_fps": 529.972, + "low_01pct_fps": 93.326, + "p50_ms": 0.316, + "p95_ms": 0.353, + "p99_ms": 0.67, + "p999_ms": 2.332, + "max_ms": 142.274, + "histogram": [ + 35573, + 63, + 14, + 8, + 2, + 1, + 0, + 6, + 5, + 1, + 1, + 1, + 0, + 1, + 1, + 0, + 0, + 0, + 0, + 1, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "mountain", + "repeat": 1, + "frames": 30825, + "seconds": 12.0, + "avg_fps": 2568.693, + "low_1pct_fps": 207.655, + "low_01pct_fps": 29.188, + "p50_ms": 0.329, + "p95_ms": 0.457, + "p99_ms": 0.904, + "p999_ms": 4.074, + "max_ms": 296.278, + "histogram": [ + 30573, + 169, + 34, + 20, + 8, + 0, + 1, + 4, + 3, + 2, + 2, + 2, + 0, + 1, + 1, + 0, + 0, + 1, + 1, + 0, + 2, + 1, + 0, + 0 + ] + }, + { + "phase": "mountain", + "repeat": 2, + "frames": 35175, + "seconds": 12.0, + "avg_fps": 2931.211, + "low_1pct_fps": 483.67, + "low_01pct_fps": 86.982, + "p50_ms": 0.32, + "p95_ms": 0.366, + "p99_ms": 0.701, + "p999_ms": 3.252, + "max_ms": 186.727, + "histogram": [ + 35054, + 67, + 17, + 17, + 2, + 2, + 2, + 4, + 3, + 3, + 1, + 2, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 1, + 0, + 0, + 0 + ] + } + ], + "label": "vanilla-desktop" +} diff --git a/website/data/benchmarks/desktop/vanilla-desktop-rd32.json b/website/data/benchmarks/desktop/vanilla-desktop-rd32.json new file mode 100644 index 000000000..439ab94a1 --- /dev/null +++ b/website/data/benchmarks/desktop/vanilla-desktop-rd32.json @@ -0,0 +1,723 @@ +{ + "format": "horizon-benchmark-report", + "version": 1, + "kind": "game", + "created": "2026-10-23T01:07:26Z", + "app": { + "name": "minecraft", + "version": "26.3", + "mods": [ + { + "name": "fabric-loader", + "version": "0.19.5" + } + ] + }, + "hardware": { + "os": "linux", + "arch": "x86_64", + "cpu_threads": 24, + "os_version": "NixOS 26.05 (Yarara) (kernel 6.18.57)", + "cpu": "13th Gen Intel(R) Core(TM) i7-13700KF", + "ram_mb": 31904, + "gpu": { + "name": "NVIDIA GeForce RTX 4080", + "vendor": "NVIDIA", + "driver": "1.4.329 NVIDIA 595.71.05", + "backend": "vulkan", + "kind": "" + } + }, + "conditions": { + "scenario": "perf_bench:village,forest,ocean,mountain", + "seed": "1234", + "render_distance": 32, + "simulation_distance": 12, + "vsync": false, + "offscreen": false, + "repeats": 3, + "warmup_s": 2.0, + "load_avg_1m": 21.652, + "window": [ + 1280, + 720 + ] + }, + "metrics": { + "startup.title_ms": { + "n": 3, + "mean": 8940.211, + "stdev": 2530.108, + "min": 6019.207, + "max": 10448.156, + "ci95": 6285.645 + }, + "startup.world_ms": { + "n": 3, + "mean": 58553.544, + "stdev": 16445.393, + "min": 39635.207, + "max": 69435.156, + "ci95": 40855.919 + }, + "chunks.village.load_ms": { + "n": 3, + "mean": 19818.416, + "stdev": 5189.664, + "min": 14041.61, + "max": 24086.671, + "ci95": 12892.88 + }, + "fps.village.avg_fps": { + "n": 3, + "mean": 881.018, + "stdev": 156.975, + "min": 710.499, + "max": 1019.508, + "ci95": 389.978 + }, + "fps.village.low_1pct_fps": { + "n": 3, + "mean": 110.182, + "stdev": 38.396, + "min": 83.662, + "max": 154.211, + "ci95": 95.388 + }, + "fps.village.low_01pct_fps": { + "n": 3, + "mean": 42.667, + "stdev": 23.983, + "min": 19.55, + "max": 67.431, + "ci95": 59.582 + }, + "memory.village.gpu_mb": { + "n": 3, + "mean": 66.333, + "stdev": 51.859, + "min": 7.0, + "max": 103.0, + "ci95": 128.835 + }, + "chunks.forest.load_ms": { + "n": 3, + "mean": 28927.436, + "stdev": 5464.979, + "min": 22671.485, + "max": 32771.861, + "ci95": 13576.855 + }, + "fps.forest.avg_fps": { + "n": 3, + "mean": 1072.17, + "stdev": 7.49, + "min": 1067.189, + "max": 1080.784, + "ci95": 18.609 + }, + "fps.forest.low_1pct_fps": { + "n": 3, + "mean": 164.583, + "stdev": 1.587, + "min": 162.781, + "max": 165.773, + "ci95": 3.943 + }, + "fps.forest.low_01pct_fps": { + "n": 3, + "mean": 75.682, + "stdev": 1.798, + "min": 73.791, + "max": 77.37, + "ci95": 4.467 + }, + "memory.forest.gpu_mb": { + "n": 3, + "mean": 66.333, + "stdev": 51.859, + "min": 7.0, + "max": 103.0, + "ci95": 128.835 + }, + "chunks.ocean.load_ms": { + "n": 3, + "mean": 19245.588, + "stdev": 3584.123, + "min": 16135.104, + "max": 23165.065, + "ci95": 8904.175 + }, + "fps.ocean.avg_fps": { + "n": 3, + "mean": 893.83, + "stdev": 538.989, + "min": 273.707, + "max": 1249.655, + "ci95": 1339.03 + }, + "fps.ocean.low_1pct_fps": { + "n": 3, + "mean": 141.621, + "stdev": 90.353, + "min": 40.103, + "max": 213.218, + "ci95": 224.467 + }, + "fps.ocean.low_01pct_fps": { + "n": 3, + "mean": 56.775, + "stdev": 31.752, + "min": 20.453, + "max": 79.261, + "ci95": 78.883 + }, + "memory.ocean.gpu_mb": { + "n": 3, + "mean": 66.333, + "stdev": 51.859, + "min": 7.0, + "max": 103.0, + "ci95": 128.835 + }, + "chunks.mountain.load_ms": { + "n": 3, + "mean": 59282.69, + "stdev": 12376.117, + "min": 50806.144, + "max": 73484.868, + "ci95": 30746.461 + }, + "fps.mountain.avg_fps": { + "n": 3, + "mean": 550.795, + "stdev": 248.553, + "min": 264.54, + "max": 711.867, + "ci95": 617.489 + }, + "fps.mountain.low_1pct_fps": { + "n": 3, + "mean": 33.217, + "stdev": 15.316, + "min": 15.734, + "max": 44.271, + "ci95": 38.051 + }, + "fps.mountain.low_01pct_fps": { + "n": 3, + "mean": 5.325, + "stdev": 1.985, + "min": 3.177, + "max": 7.092, + "ci95": 4.932 + }, + "memory.mountain.gpu_mb": { + "n": 3, + "mean": 66.333, + "stdev": 51.859, + "min": 7.0, + "max": 103.0, + "ci95": 128.835 + }, + "memory.rss_peak_mb": { + "n": 3, + "mean": 3483.918, + "stdev": 54.851, + "min": 3420.879, + "max": 3520.746, + "ci95": 136.268 + }, + "memory.rss_steady_mb": { + "n": 3, + "mean": 3418.959, + "stdev": 50.107, + "min": 3363.992, + "max": 3462.084, + "ci95": 124.482 + } + }, + "frames": [ + { + "phase": "village", + "repeat": 0, + "frames": 10957, + "seconds": 12.0, + "avg_fps": 913.047, + "low_1pct_fps": 92.672, + "low_01pct_fps": 19.55, + "p50_ms": 0.804, + "p95_ms": 2.202, + "p99_ms": 4.333, + "p999_ms": 13.43, + "max_ms": 410.29, + "histogram": [ + 7884, + 2368, + 440, + 147, + 39, + 26, + 15, + 15, + 3, + 7, + 3, + 8, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 1, + 0, + 0 + ] + }, + { + "phase": "village", + "repeat": 1, + "frames": 8526, + "seconds": 12.0, + "avg_fps": 710.499, + "low_1pct_fps": 83.662, + "low_01pct_fps": 41.019, + "p50_ms": 0.892, + "p95_ms": 3.72, + "p99_ms": 7.437, + "p999_ms": 20.294, + "max_ms": 30.234, + "histogram": [ + 4933, + 2204, + 727, + 332, + 133, + 67, + 38, + 29, + 20, + 19, + 4, + 5, + 6, + 5, + 4, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "village", + "repeat": 2, + "frames": 12236, + "seconds": 12.002, + "avg_fps": 1019.508, + "low_1pct_fps": 154.211, + "low_01pct_fps": 67.431, + "p50_ms": 0.803, + "p95_ms": 1.825, + "p99_ms": 3.764, + "p999_ms": 10.283, + "max_ms": 23.801, + "histogram": [ + 9657, + 2078, + 286, + 118, + 27, + 26, + 13, + 10, + 5, + 5, + 5, + 4, + 1, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "forest", + "repeat": 0, + "frames": 12823, + "seconds": 12.001, + "avg_fps": 1068.537, + "low_1pct_fps": 165.773, + "low_01pct_fps": 77.37, + "p50_ms": 0.842, + "p95_ms": 1.298, + "p99_ms": 3.415, + "p999_ms": 10.457, + "max_ms": 18.103, + "histogram": [ + 11615, + 909, + 137, + 66, + 30, + 20, + 13, + 16, + 3, + 7, + 3, + 2, + 2, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "forest", + "repeat": 1, + "frames": 12970, + "seconds": 12.001, + "avg_fps": 1080.784, + "low_1pct_fps": 165.196, + "low_01pct_fps": 75.886, + "p50_ms": 0.841, + "p95_ms": 1.246, + "p99_ms": 3.428, + "p999_ms": 9.769, + "max_ms": 30.26, + "histogram": [ + 11881, + 845, + 93, + 62, + 27, + 15, + 16, + 9, + 11, + 6, + 3, + 1, + 0, + 0, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "forest", + "repeat": 2, + "frames": 12807, + "seconds": 12.001, + "avg_fps": 1067.189, + "low_1pct_fps": 162.781, + "low_01pct_fps": 73.791, + "p50_ms": 0.842, + "p95_ms": 1.31, + "p99_ms": 3.393, + "p999_ms": 11.153, + "max_ms": 19.229, + "histogram": [ + 11611, + 933, + 108, + 62, + 24, + 28, + 13, + 6, + 7, + 6, + 5, + 2, + 2, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "ocean", + "repeat": 0, + "frames": 3285, + "seconds": 12.002, + "avg_fps": 273.707, + "low_1pct_fps": 40.103, + "low_01pct_fps": 20.453, + "p50_ms": 3.047, + "p95_ms": 7.993, + "p99_ms": 14.596, + "p999_ms": 36.882, + "max_ms": 71.876, + "histogram": [ + 210, + 775, + 629, + 685, + 337, + 266, + 123, + 116, + 51, + 37, + 18, + 11, + 7, + 8, + 6, + 4, + 1, + 0, + 1, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "ocean", + "repeat": 1, + "frames": 13898, + "seconds": 12.0, + "avg_fps": 1158.128, + "low_1pct_fps": 171.541, + "low_01pct_fps": 70.612, + "p50_ms": 0.716, + "p95_ms": 1.492, + "p99_ms": 3.27, + "p999_ms": 9.156, + "max_ms": 21.227, + "histogram": [ + 12221, + 1268, + 244, + 83, + 23, + 20, + 8, + 9, + 10, + 3, + 4, + 1, + 2, + 2, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "ocean", + "repeat": 2, + "frames": 14996, + "seconds": 12.0, + "avg_fps": 1249.655, + "low_1pct_fps": 213.218, + "low_01pct_fps": 79.261, + "p50_ms": 0.713, + "p95_ms": 1.166, + "p99_ms": 2.533, + "p999_ms": 8.971, + "max_ms": 18.592, + "histogram": [ + 13939, + 816, + 131, + 58, + 17, + 8, + 8, + 4, + 4, + 3, + 2, + 5, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0, + 0 + ] + }, + { + "phase": "mountain", + "repeat": 0, + "frames": 3175, + "seconds": 12.002, + "avg_fps": 264.54, + "low_1pct_fps": 15.734, + "low_01pct_fps": 3.177, + "p50_ms": 2.117, + "p95_ms": 9.913, + "p99_ms": 20.257, + "p999_ms": 48.141, + "max_ms": 619.805, + "histogram": [ + 319, + 1186, + 482, + 399, + 211, + 166, + 102, + 83, + 71, + 48, + 30, + 30, + 16, + 16, + 6, + 3, + 4, + 1, + 0, + 0, + 0, + 0, + 2, + 0 + ] + }, + { + "phase": "mountain", + "repeat": 1, + "frames": 8543, + "seconds": 12.001, + "avg_fps": 711.867, + "low_1pct_fps": 39.646, + "low_01pct_fps": 5.706, + "p50_ms": 1.033, + "p95_ms": 2.025, + "p99_ms": 5.49, + "p999_ms": 17.993, + "max_ms": 365.508, + "histogram": [ + 2186, + 5922, + 181, + 98, + 43, + 43, + 22, + 17, + 12, + 5, + 2, + 3, + 1, + 2, + 0, + 0, + 0, + 0, + 0, + 0, + 3, + 3, + 0, + 0 + ] + }, + { + "phase": "mountain", + "repeat": 2, + "frames": 8112, + "seconds": 12.0, + "avg_fps": 675.978, + "low_1pct_fps": 44.271, + "low_01pct_fps": 7.092, + "p50_ms": 1.043, + "p95_ms": 2.629, + "p99_ms": 5.842, + "p999_ms": 16.976, + "max_ms": 258.087, + "histogram": [ + 1494, + 5923, + 365, + 141, + 57, + 61, + 24, + 19, + 6, + 5, + 6, + 2, + 3, + 1, + 0, + 0, + 0, + 0, + 0, + 0, + 3, + 2, + 0, + 0 + ] + } + ], + "label": "vanilla-desktop" +} diff --git a/website/data/benchmarks/fleet.json b/website/data/benchmarks/fleet.json index 90996aab5..0a32fb46f 100644 --- a/website/data/benchmarks/fleet.json +++ b/website/data/benchmarks/fleet.json @@ -42,5 +42,32 @@ "thinkpad/vanilla-thinkpad-r1-rd12.json", "thinkpad/vanilla-thinkpad-r2-rd12.json" ] + }, + { + "machine": "Desktop (RTX 4080, i7-13700KF)", + "reports": [ + "desktop/horizon-desktop-rd12.json" + ], + "version": "v2026.10.22.13", + "note": "Linux (NixOS) with the NVIDIA 595 driver. The desktop is in daily use, so both games drew to a separate GPU compositor (a headless sway rendering on the RTX 4080) in a 1280x720 window, never on its screen: Horizon through Wayland, vanilla through Xwayland, both on Vulkan. Other jobs were running during the runs (1-minute load average 18 to 25 on 24 threads), which costs both games, chunk loading most." + }, + { + "machine": "Desktop (RTX 4080, i7-13700KF)", + "reports": [ + "desktop/horizon-desktop-rd32.json" + ], + "version": "v2026.10.22.13" + }, + { + "machine": "Desktop (RTX 4080, i7-13700KF)", + "reports": [ + "desktop/vanilla-desktop-rd12.json" + ] + }, + { + "machine": "Desktop (RTX 4080, i7-13700KF)", + "reports": [ + "desktop/vanilla-desktop-rd32.json" + ] } ] diff --git a/website/public/benchmarks.json b/website/public/benchmarks.json index b443513e1..1288f3e66 100644 --- a/website/public/benchmarks.json +++ b/website/public/benchmarks.json @@ -1,7 +1,7 @@ { "format": "horizon-benchmark-summary", "version": 1, - "generated": "2026-10-22T20:35:03Z", + "generated": "2026-10-23T01:09:54Z", "min_installs": 3, "groups": [ { @@ -313,6 +313,211 @@ "chunk_load_ms": 54778 } } + }, + { + "gpu": "NVIDIA GeForce RTX 4080", + "cpu": "13th Gen Intel Core i7-13700KF", + "render_distance": 12, + "game": "horizon", + "source": "us", + "machine": "Desktop (RTX 4080, i7-13700KF)", + "measured": "2026-10-23", + "version": "v2026.10.22.13", + "backend": "vulkan", + "os": "linux", + "window": [ + 1280, + 720 + ], + "repeats": 3, + "load_avg_1m": 17.934, + "note": "Linux (NixOS) with the NVIDIA 595 driver. The desktop is in daily use, so both games drew to a separate GPU compositor (a headless sway rendering on the RTX 4080) in a 1280x720 window, never on its screen: Horizon through Wayland, vanilla through Xwayland, both on Vulkan. Other jobs were running during the runs (1-minute load average 18 to 25 on 24 threads), which costs both games, chunk loading most.", + "medians": { + "avg_fps": 2993, + "low_1pct_fps": 311, + "p95_ms": 0.5, + "world_ms": 17973, + "chunk_load_ms": 1797, + "rss_peak_mb": 1414, + "rss_steady_mb": 1202, + "cpu_p50_ms": 0.3, + "gpu_p50_ms": 0.1 + }, + "scenes": { + "village": { + "avg_fps": 2594, + "low_1pct_fps": 254, + "chunk_load_ms": 1260 + }, + "forest": { + "avg_fps": 3427, + "low_1pct_fps": 328, + "chunk_load_ms": 1592 + }, + "ocean": { + "avg_fps": 3277, + "low_1pct_fps": 388, + "chunk_load_ms": 2660 + }, + "mountain": { + "avg_fps": 2673, + "low_1pct_fps": 275, + "chunk_load_ms": 1675 + } + } + }, + { + "gpu": "NVIDIA GeForce RTX 4080", + "cpu": "13th Gen Intel Core i7-13700KF", + "render_distance": 32, + "game": "horizon", + "source": "us", + "machine": "Desktop (RTX 4080, i7-13700KF)", + "measured": "2026-10-23", + "version": "v2026.10.22.13", + "backend": "vulkan", + "os": "linux", + "window": [ + 1280, + 720 + ], + "repeats": 3, + "load_avg_1m": 22.354, + "medians": { + "avg_fps": 672, + "low_1pct_fps": 89, + "p95_ms": 3.6, + "world_ms": 8999, + "chunk_load_ms": 4677, + "rss_peak_mb": 1957, + "rss_steady_mb": 1646, + "cpu_p50_ms": 1.1, + "gpu_p50_ms": 0.3 + }, + "scenes": { + "village": { + "avg_fps": 686, + "low_1pct_fps": 93, + "chunk_load_ms": 2702 + }, + "forest": { + "avg_fps": 590, + "low_1pct_fps": 76, + "chunk_load_ms": 4823 + }, + "ocean": { + "avg_fps": 868, + "low_1pct_fps": 113, + "chunk_load_ms": 3629 + }, + "mountain": { + "avg_fps": 544, + "low_1pct_fps": 73, + "chunk_load_ms": 7552 + } + } + }, + { + "gpu": "NVIDIA GeForce RTX 4080", + "cpu": "13th Gen Intel Core i7-13700KF", + "render_distance": 12, + "game": "vanilla", + "source": "us", + "machine": "Desktop (RTX 4080, i7-13700KF)", + "measured": "2026-10-23", + "version": "26.3", + "backend": "vulkan", + "os": "linux", + "window": [ + 1280, + 720 + ], + "repeats": 3, + "load_avg_1m": 25.007, + "medians": { + "avg_fps": 2600, + "low_1pct_fps": 312, + "p95_ms": 0.5, + "world_ms": 30470, + "chunk_load_ms": 10837, + "rss_peak_mb": 3078, + "rss_steady_mb": 2883, + "cpu_p50_ms": null, + "gpu_p50_ms": null + }, + "scenes": { + "village": { + "avg_fps": 2482, + "low_1pct_fps": 385, + "chunk_load_ms": 8003 + }, + "forest": { + "avg_fps": 2368, + "low_1pct_fps": 209, + "chunk_load_ms": 9654 + }, + "ocean": { + "avg_fps": 2727, + "low_1pct_fps": 247, + "chunk_load_ms": 10442 + }, + "mountain": { + "avg_fps": 2824, + "low_1pct_fps": 407, + "chunk_load_ms": 15249 + } + } + }, + { + "gpu": "NVIDIA GeForce RTX 4080", + "cpu": "13th Gen Intel Core i7-13700KF", + "render_distance": 32, + "game": "vanilla", + "source": "us", + "machine": "Desktop (RTX 4080, i7-13700KF)", + "measured": "2026-10-23", + "version": "26.3", + "backend": "vulkan", + "os": "linux", + "window": [ + 1280, + 720 + ], + "repeats": 3, + "load_avg_1m": 21.652, + "medians": { + "avg_fps": 849, + "low_1pct_fps": 112, + "p95_ms": 3.1, + "world_ms": 58554, + "chunk_load_ms": 31819, + "rss_peak_mb": 3484, + "rss_steady_mb": 3419, + "cpu_p50_ms": null, + "gpu_p50_ms": null + }, + "scenes": { + "village": { + "avg_fps": 881, + "low_1pct_fps": 110, + "chunk_load_ms": 19818 + }, + "forest": { + "avg_fps": 1072, + "low_1pct_fps": 165, + "chunk_load_ms": 28927 + }, + "ocean": { + "avg_fps": 894, + "low_1pct_fps": 142, + "chunk_load_ms": 19246 + }, + "mountain": { + "avg_fps": 551, + "low_1pct_fps": 33, + "chunk_load_ms": 59283 + } + } } ] } diff --git a/website/src/bench.js b/website/src/bench.js index 27042a8d3..40185c79d 100644 --- a/website/src/bench.js +++ b/website/src/bench.js @@ -117,6 +117,39 @@ export function machinesHtml(summary) { return [...by].map(([name, rows]) => machineHtml(name, rows)).join("\n"); } +// The hardware breakdowns (the server's classes), in words. +export const DIMENSIONS = [ + { key: "ram", label: "Memory", word: (c) => `${c} RAM` }, + { key: "vram", label: "Graphics memory", word: (c) => (c === "shared" ? "shared graphics memory" : `${c} graphics memory`) }, + { key: "storage", label: "Drive", word: (c) => ({ nvme: "NVMe", ssd: "SSD", hdd: "hard disk" })[c] || c }, + { key: "os", label: "System", word: (c) => ({ linux: "Linux", macos: "macOS", windows: "Windows" })[c] || c }, + { key: "gpu_kind", label: "Graphics", word: (c) => (c === "integrated" ? "integrated GPU" : c === "discrete" ? "separate GPU" : c) }, +]; + +// A group's breakdowns in one line: "32 GB RAM (3) · NVMe (3) · Linux (3)". Empty without any. +export function breakdownLine(breakdowns) { + return DIMENSIONS.flatMap((d) => (breakdowns?.[d.key] || []).map((c) => `${d.word(c.class)} (${c.installs})`)).join(" · "); +} + +// GET /v1/aggregate's breakdowns: players' play sessions per hardware class. Empty without any. +export function hardwareHtml(aggregate) { + const b = aggregate?.breakdowns || {}; + const dims = DIMENSIONS.filter((d) => b[d.key]?.length); + if (!dims.length) return ""; + const rows = dims + .flatMap((d) => + b[d.key].map( + (c, i) => + `${i === 0 ? `${escape(d.label)}` : ""}${escape(d.word(c.class))}${c.installs}${Math.round(c.hours).toLocaleString("en")}${format("ms", c.p50_ms)}${format("ms", c.p99_ms)}`, + ), + ) + .join(""); + return `
    + + ${rows} +
    ByClassInstallsHours playedFrame time, medianFrame time, 99th percentile
    `; +} + // Players' groups: one row each, at least `min_installs` installs. export function playersHtml(summary) { const groups = (summary?.groups || []).filter((g) => g.source === "players"); @@ -124,7 +157,7 @@ export function playersHtml(summary) { return `

    No player results yet. A GPU and CPU pair shows here once at least ${summary?.min_installs || 3} different installs have shared a benchmark with it.

    `; const rows = groups .map( - (g) => `${escape(g.gpu)}${escape(g.cpu)}${g.render_distance}${g.game === "vanilla" ? "Java" : "Horizon"}${["avg_fps", "low_1pct_fps", "p95_ms", "world_ms", "rss_steady_mb"].map((k) => `${format(METRICS.find((m) => m.key === k).kind, g.medians?.[k])}`).join("")}From ${g.installs} players`, + (g) => `${escape(g.gpu)}${escape(g.cpu)}${g.render_distance}${g.game === "vanilla" ? "Java" : "Horizon"}${["avg_fps", "low_1pct_fps", "p95_ms", "world_ms", "rss_steady_mb"].map((k) => `${format(METRICS.find((m) => m.key === k).kind, g.medians?.[k])}`).join("")}From ${g.installs} players${breakdownLine(g.breakdowns) ? `${escape(breakdownLine(g.breakdowns))}` : ""}`, ) .join(""); return `
    diff --git a/website/src/benchmarks-page.js b/website/src/benchmarks-page.js index 23307aa88..5d05848e3 100644 --- a/website/src/benchmarks-page.js +++ b/website/src/benchmarks-page.js @@ -1,8 +1,8 @@ // The Benchmarks page: players' results from the telemetry server (the baked summary when it doesn't answer) // and the hardware picker (a measurement when there is one, else an estimate from src/estimate.js). import { escape } from "./markdown.js"; -import { METRICS, cell, compareRows, format, playersHtml } from "./bench.js"; -import { estimate, measured } from "./estimate.js"; +import { METRICS, cell, compareRows, format, hardwareHtml, playersHtml } from "./bench.js"; +import { estimate, measured, memoryNotes } from "./estimate.js"; import { findCpu, findGpu } from "./hardware.js"; import { setUpMenu, setUpTheme } from "./chrome.js"; @@ -27,6 +27,20 @@ async function live() { } } +// Players' play sessions per hardware class (last 30 days); the section stays hidden until there are some. +async function hardware() { + try { + const res = await fetch(`${TELEMETRY}/v1/aggregate?days=30`, { signal: AbortSignal.timeout(3000) }); + if (!res.ok) return; + const html = hardwareHtml(await res.json()); + if (!html) return; + document.getElementById("players-hardware-table").innerHTML = html; + document.getElementById("players-hardware").hidden = false; + } catch { + // Nothing to show. + } +} + const picker = document.getElementById("picker"); const out = document.getElementById("pick-result"); @@ -57,19 +71,25 @@ function render() { const gpu = findGpu(picker.gpu.value); const cpu = findCpu(picker.cpu.value); const rd = Number(picker.rd.value); + const ramGb = Number(picker.ram.value) || null; if (!gpu || !cpu) return; + // Horizon's and Java's notes, each once (the players' hardware is the same for both). + const notesHtml = (...lists) => { + const notes = [...new Set(lists.flat())]; + return notes.length ? `
      ${notes.map((n) => `
    • ${escape(n)}
    • `).join("")}
    ` : ""; + }; const mh = measured(groups, gpu, cpu, rd, "horizon"); const mj = measured(groups, gpu, cpu, rd, "vanilla"); if (mh.length || mj.length) { const h = mh[0]; const j = mj[0]; - out.innerHTML = `

    ${[h, j].filter(Boolean).map(sourceBadge).join(" ")}

    ${measuredTable(h, j)}${ + out.innerHTML = `

    ${[h, j].filter(Boolean).map(sourceBadge).join(" ")}

    ${measuredTable(h, j)}${notesHtml(...[h, j].filter(Boolean).map((row) => memoryNotes(row, gpu, ramGb)))}${ h && h.source === "us" && h.measured ? `

    Measured ${escape(h.measured)} with Horizon ${escape(h.version)}. The full table is under Measured by us.

    ` : "" }`; return; } - const h = estimate(groups, gpu, cpu, rd, "horizon"); - const j = estimate(groups, gpu, cpu, rd, "vanilla"); + const h = estimate(groups, gpu, cpu, rd, "horizon", { ramGb }); + const j = estimate(groups, gpu, cpu, rd, "vanilla", { ramGb }); if (!h && !j) { out.innerHTML = `

    Nothing measured at render distance ${rd} to estimate from yet.

    `; return; @@ -77,7 +97,7 @@ function render() { const base = (h || j).base; const f = (h || j).factors; const times = (x) => `${x >= 1 ? x.toFixed(x >= 10 ? 0 : 1) : x.toFixed(2)}x`; - out.innerHTML = `

    Estimate From ${escape(base.source === "us" ? base.machine : `${base.gpu} with ${base.cpu}`)} (${escape(base.gpu)}, ${escape(base.cpu)}): GPU factor ${times(f.gpu)}, CPU factor ${times(f.cpu)}. How

    ${estimateTable(h, j)}

    Ranges, not measurements: the real figure depends on drivers, the graphics API and cooling too. Memory is the measured machine's.

    `; + out.innerHTML = `

    Estimate From ${escape(base.source === "us" ? base.machine : `${base.gpu} with ${base.cpu}`)} (${escape(base.gpu)}, ${escape(base.cpu)}): GPU factor ${times(f.gpu)}, CPU factor ${times(f.cpu)}. How

    ${estimateTable(h, j)}${notesHtml(h?.notes || [], j?.notes || [])}

    Ranges, not measurements: the real figure depends on drivers, the graphics API and cooling too. Memory is the measured machine's.

    `; } setUpTheme(); @@ -85,3 +105,4 @@ setUpMenu(); picker.addEventListener("change", render); render(); live(); +hardware(); diff --git a/website/src/benchmarks.html b/website/src/benchmarks.html index f79f7bcd9..41e270c5b 100644 --- a/website/src/benchmarks.html +++ b/website/src/benchmarks.html @@ -37,17 +37,15 @@
    {{MACHINES}}
    -
    -

    Not yet measured against Java: the desktop (RTX 4080, Core i7-13700KF). It is in daily use; the comparison runs on it once it is free. The last figures from it are Horizon alone, from an older build (2026-10-13, offscreen, tools/graphics_bench.py): over the village, 2,409 FPS at render distance 8, 1,041 at 16 and 48 at 32, where that build still stuttered while loading. They are not comparable with the tables above; the picker estimates the RTX 4080 from the measured machines instead.

    -

    Your hardware

    -

    Pick a graphics card and a processor. If we or at least three players have measured that pair, you see what was measured; otherwise an estimate from the nearest measured machine, as a range.

    +

    Pick a graphics card, a processor and, if you know it, your memory. If we or at least three players have measured that pair, you see what was measured; otherwise an estimate from the nearest measured machine, as a range.

    +
    Render distance @@ -58,13 +56,20 @@

    From players

    -

    Players who allow benchmark uploads in the launcher's data collection settings share the report of horizon-client --benchmark standard. Results are grouped by graphics card, processor and render distance, and a group shows only once at least 3 different installs are in it, so no one can be picked out. Only medians are published: no install ID, date, driver, memory size or screen.

    +

    Players who allow benchmark uploads in the launcher's data collection settings share the report of horizon-client --benchmark standard. Results are grouped by graphics card, processor and render distance, and a group shows only once at least 3 different installs are in it, so no one can be picked out. Only medians are published, with how the group's installs split by memory, graphics memory, drive and system in coarse classes (each class only with at least 3 installs too): no install ID, date, driver, exact memory or screen.

    {{PLAYERS_SOURCE}}

    {{PLAYERS}}
    + +

    How the estimates work

    @@ -74,6 +79,7 @@
  • CPU factor: the ratio of the two processors' single-thread scores: top boost clock times a rough factor per chip generation (Zen 4 = 1).
  • Frame rate: when the measured run split each frame into CPU and GPU time, the slower side is scaled by its factor; otherwise by the geometric mean of both. Whatever the split, the real figure lies between the measured one scaled by the smaller and by the larger factor; we widen that by 15% for the roughness of the table, and show it as the range.
  • Load times are CPU work (generating, lighting and meshing chunks), scaled by the CPU factor. Memory is not scaled: it follows the world and the settings, not the speed.
  • +
  • Memory size: when players' results say how much memory and graphics memory their machines have, a measured group whose players have neither yours counts as further away, and the estimate says what they had. With your memory picked, it also says when the game's peak use is a large share of it.
  • Estimates ignore drivers, the graphics API, thermal limits and the operating system, which can matter as much as the chip. Treat them as a rough idea, and run horizon-client --benchmark standard on your own machine for the real figure.

    diff --git a/website/src/estimate.js b/website/src/estimate.js index 245ec4094..ccd053cc0 100644 --- a/website/src/estimate.js +++ b/website/src/estimate.js @@ -9,7 +9,10 @@ // the roughness of the table: that is the range shown. // - World and chunk load times are CPU work (generation, lighting, meshing): scaled by the CPU factor. // - Memory is not scaled: it depends on the world and settings, not on speed. -import { findCpu, findGpu, singleThread } from "./hardware.js"; +// - Memory size: players' groups say how their installs split by RAM and by the GPU's own memory (breakdowns). A +// base whose players have neither the picked RAM nor the picked GPU's memory class counts as further away, and +// the estimate says what the base's players had, and when the game's peak memory is a large share of the RAM. +import { findCpu, findGpu, ramClass, singleThread, vramClass } from "./hardware.js"; const MARGIN = 0.15; @@ -20,6 +23,35 @@ export function factors(fromGpu, fromCpu, toGpu, toCpu) { } const distance = (f) => Math.abs(Math.log(f.gpu)) + Math.abs(Math.log(f.cpu)); +// Added to the distance per memory class (RAM, VRAM) the base's players don't have: about a 20% speed gap. +const MEMORY_MISMATCH = 0.2; + +// The classes a row's installs have in a breakdown, or null when it has none (our own rows, older summaries). +const classesIn = (row, dim) => (row.breakdowns?.[dim]?.length ? row.breakdowns[dim].map((c) => c.class) : null); + +function mismatch(row, gpu, ramGb) { + let d = 0; + const vram = classesIn(row, "vram"); + if (vram && !vram.includes(vramClass(gpu))) d += MEMORY_MISMATCH; + const ram = classesIn(row, "ram"); + if (ram && ramGb && !ram.includes(ramClass(ramGb))) d += MEMORY_MISMATCH; + return d; +} + +// What to say about memory: the base's players' RAM and VRAM when they differ from the pick, and the game's peak +// memory against the picked RAM. +export function memoryNotes(row, gpu, ramGb) { + const notes = []; + const list = (dim) => row.breakdowns[dim].map((c) => `${c.class} (${c.installs})`).join(", "); + const vram = classesIn(row, "vram"); + if (vram && gpu && !vram.includes(vramClass(gpu))) notes.push(`The measured players' graphics cards have ${list("vram")} of their own memory; this one has ${gpu.vram_gb ? `${gpu.vram_gb} GB` : "none (it shares the system's)"}.`); + const ram = classesIn(row, "ram"); + if (ram && ramGb && !ram.includes(ramClass(ramGb))) notes.push(`The measured players have ${list("ram")} of memory, not ${ramGb} GB.`); + const peak = row.medians?.rss_peak_mb; + if (ramGb && peak && peak / 1024 > ramGb * 0.4) + notes.push(`${row.game === "vanilla" ? "Java" : "Horizon"} used up to ${(peak / 1024).toFixed(1)} GB here: with ${ramGb} GB, close other programs, or the system may swap and stutter.`); + return notes; +} // The rows (benchmarks.json groups) usable as a base: a known GPU and CPU. function known(rows) { @@ -34,19 +66,19 @@ export function measured(rows, gpu, cpu, rd, game) { } // The nearest measured machine for a target GPU and CPU, for one game and render distance. -export function nearest(rows, gpu, cpu, rd, game) { +export function nearest(rows, gpu, cpu, rd, game, { ramGb } = {}) { let best = null; for (const r of known(rows)) { if (r.row.render_distance !== rd || r.row.game !== game) continue; const f = factors(r.gpu, r.cpu, gpu, cpu); - const d = distance(f); + const d = distance(f) + mismatch(r.row, gpu, ramGb); if (!best || d < best.d) best = { ...r, f, d }; } return best; } -export function estimate(rows, gpu, cpu, rd, game) { - const base = nearest(rows, gpu, cpu, rd, game); +export function estimate(rows, gpu, cpu, rd, game, { ramGb } = {}) { + const base = nearest(rows, gpu, cpu, rd, game, { ramGb }); if (!base) return null; const m = base.row.medians; const { gpu: g, cpu: c } = base.f; @@ -73,5 +105,6 @@ export function estimate(rows, gpu, cpu, rd, game) { chunk_load_ms: time(m.chunk_load_ms, c), rss_steady_mb: m.rss_steady_mb == null ? null : { value: m.rss_steady_mb }, rss_peak_mb: m.rss_peak_mb == null ? null : { value: m.rss_peak_mb }, + notes: memoryNotes(base.row, gpu, ramGb), }; } diff --git a/website/src/estimate.test.mjs b/website/src/estimate.test.mjs index 3666b7fa1..d46f9c4b5 100644 --- a/website/src/estimate.test.mjs +++ b/website/src/estimate.test.mjs @@ -62,3 +62,40 @@ test("a release title of issue numbers falls back to its notes", async () => { assert.equal(parts(r).line, "Single player runs in the frame again and 1 more"); assert.equal(parts({ ...r, name: "Horizon 2026.10.22.05: Hoppers, mob tick, server tick" }).line, "Hoppers, mob tick, server tick"); }); + +test("players' memory classes steer the base and the notes", async () => { + const { memoryNotes } = await import("./estimate.js"); + const { ramClass, vramClass } = await import("./hardware.js"); + assert.equal(vramClass(findGpu("NVIDIA GeForce RTX 4080")), "16 GB"); + assert.equal(vramClass(findGpu("NVIDIA GeForce RTX 3080")), "12 GB"); + assert.equal(vramClass(findGpu("Apple M4 Pro")), "shared"); + assert.equal(ramClass(16), "16 GB"); + // Two equally near groups: the one whose players have the picked GPU's memory class wins. + const players = (vram, ram, fps) => + row("NVIDIA GeForce RTX 4070", "AMD Ryzen 5 7600X", { avg_fps: fps, rss_peak_mb: 3600 }, { source: "players", installs: 3, breakdowns: { vram: [{ class: vram, installs: 3 }], ram: [{ class: ram, installs: 3 }] } }); + const a = players("8 GB", "16 GB", 400); + const b = { ...players("12 GB", "32 GB", 500), cpu: "AMD Ryzen 7 7800X3D" }; + const gpu = findGpu("NVIDIA GeForce RTX 4070 Ti"); + const cpu = findCpu("AMD Ryzen 5 7600X"); + assert.equal(nearest([a, b], gpu, cpu, 12, "horizon").row, b, "12 GB like the 4070 Ti, though the CPU differs"); + assert.equal(nearest([a, b], gpu, cpu, 12, "horizon", { ramGb: 16 }).row, a, "both classes count"); + assert.deepEqual(memoryNotes(b, gpu, 32), []); + const notes = memoryNotes(a, gpu, 8); + assert.equal(notes.length, 3); + assert.match(notes[0], /8 GB \(3\) of their own memory; this one has 12 GB/); + assert.match(notes[1], /16 GB \(3\) of memory, not 8 GB/); + assert.match(notes[2], /Horizon used up to 3\.5 GB/); + // Our own rows have no breakdowns: only the peak memory note. + assert.deepEqual(memoryNotes(mac, gpu, 32), []); + assert.equal(estimate([a], gpu, cpu, 12, "horizon", { ramGb: 8 }).notes.length, 3); +}); + +test("breakdowns read as words, and the hardware table shows only with data", async () => { + const { breakdownLine, hardwareHtml } = await import("./bench.js"); + assert.equal(breakdownLine({ ram: [{ class: "32 GB", installs: 3 }], storage: [{ class: "nvme", installs: 4 }], gpu_kind: [{ class: "discrete", installs: 3 }] }), "32 GB RAM (3) · NVMe (4) · separate GPU (3)"); + assert.equal(breakdownLine(undefined), ""); + assert.equal(hardwareHtml({ breakdowns: {} }), ""); + const html = hardwareHtml({ breakdowns: { os: [{ class: "linux", installs: 5, sessions: 9, hours: 4.5, p50_ms: 6.2, p99_ms: 14 }] } }); + assert.match(html, /Linux/); + assert.match(html, /6\.2 ms/); +}); diff --git a/website/src/hardware.js b/website/src/hardware.js index d65c84ae2..bf4c8bbbd 100644 --- a/website/src/hardware.js +++ b/website/src/hardware.js @@ -1,42 +1,43 @@ // The hardware the Benchmarks page can estimate for, from specifications only (our own table, no benchmark // database): each GPU's FP32 shader throughput in TFLOPS and its memory bandwidth in GB/s as its maker states them, +// its own memory in GB (vram_gb; 0 for a GPU that shares the system's: integrated, Apple silicon), // and each CPU's single-thread score = its top boost clock (GHz) x our rough per-generation factor (instructions per // clock, Zen 4 = 1). The factors are round numbers, so estimates are ranges, and the page says so. // `match` finds a reported name (the GPU and CPU strings in benchmark reports) in this table. export const GPUS = [ - { name: "NVIDIA GeForce RTX 4090", tflops: 82.6, gbps: 1008, match: /RTX 4090/i }, - { name: "NVIDIA GeForce RTX 4080", tflops: 48.7, gbps: 717, match: /RTX 4080(?! SUPER)/i }, - { name: "NVIDIA GeForce RTX 4070 Ti", tflops: 40.1, gbps: 504, match: /RTX 4070 Ti/i }, - { name: "NVIDIA GeForce RTX 4070", tflops: 29.1, gbps: 504, match: /RTX 4070(?! Ti)/i }, - { name: "NVIDIA GeForce RTX 4060 Ti", tflops: 22.1, gbps: 288, match: /RTX 4060 Ti/i }, - { name: "NVIDIA GeForce RTX 4060", tflops: 15.1, gbps: 272, match: /RTX 4060(?! Ti)/i }, - { name: "NVIDIA GeForce RTX 3080", tflops: 29.8, gbps: 760, match: /RTX 3080(?! Ti)/i }, - { name: "NVIDIA GeForce RTX 3070", tflops: 20.3, gbps: 448, match: /RTX 3070(?! Ti)/i }, - { name: "NVIDIA GeForce RTX 3060", tflops: 12.7, gbps: 360, match: /RTX 3060(?! Ti)/i }, - { name: "NVIDIA GeForce RTX 3050", tflops: 9.1, gbps: 224, match: /RTX 3050/i }, - { name: "NVIDIA GeForce RTX 2060", tflops: 6.5, gbps: 336, match: /RTX 2060(?! SUPER)/i }, - { name: "NVIDIA GeForce GTX 1660 SUPER", tflops: 5.0, gbps: 336, match: /GTX 1660 SUPER/i }, - { name: "NVIDIA GeForce GTX 1060 6GB", tflops: 4.4, gbps: 192, match: /GTX 1060/i }, - { name: "NVIDIA GeForce GTX 1050 Ti", tflops: 2.1, gbps: 112, match: /GTX 1050 Ti/i }, - { name: "AMD Radeon RX 7900 XTX", tflops: 61.4, gbps: 960, match: /RX 7900 XTX/i }, - { name: "AMD Radeon RX 7800 XT", tflops: 37.3, gbps: 624, match: /RX 7800 XT/i }, - { name: "AMD Radeon RX 7600", tflops: 21.8, gbps: 288, match: /RX 7600(?! XT)/i }, - { name: "AMD Radeon RX 6700 XT", tflops: 13.2, gbps: 384, match: /RX 6700 XT/i }, - { name: "AMD Radeon RX 6600", tflops: 8.9, gbps: 224, match: /RX 6600(?! XT)/i }, - { name: "AMD Radeon RX 580", tflops: 6.2, gbps: 256, match: /RX 580/i }, - { name: "AMD Radeon 780M (integrated)", tflops: 8.6, gbps: 89, match: /780M/i }, - { name: "Steam Deck (AMD Van Gogh)", tflops: 1.6, gbps: 88, match: /VanGogh|Van Gogh|Custom GPU 0405/i }, - { name: "Intel Arc A770", tflops: 19.7, gbps: 560, match: /Arc.*A770/i }, - { name: "Intel Iris Xe Graphics (96 EU)", tflops: 2.1, gbps: 68, match: /Iris\(?R?\)? Xe/i }, - { name: "Intel HD Graphics 620", tflops: 0.4, gbps: 34, match: /\bU?HD Graphics 620\b/i }, - { name: "Apple M1", tflops: 2.6, gbps: 68, match: /^Apple M1$/i }, - { name: "Apple M2", tflops: 3.6, gbps: 100, match: /^Apple M2$/i }, - { name: "Apple M3", tflops: 4.1, gbps: 100, match: /^Apple M3$/i }, - { name: "Apple M4", tflops: 4.3, gbps: 120, match: /^Apple M4$/i }, - { name: "Apple M1 Pro (16-core GPU)", tflops: 5.2, gbps: 200, match: /^Apple M1 Pro$/i }, - { name: "Apple M4 Pro (20-core GPU)", tflops: 8.5, gbps: 273, match: /^Apple M4 Pro$/i }, - { name: "Apple M4 Max (40-core GPU)", tflops: 17.0, gbps: 546, match: /^Apple M4 Max$/i }, + { name: "NVIDIA GeForce RTX 4090", tflops: 82.6, gbps: 1008, vram_gb: 24, match: /RTX 4090/i }, + { name: "NVIDIA GeForce RTX 4080", tflops: 48.7, gbps: 717, vram_gb: 16, match: /RTX 4080(?! SUPER)/i }, + { name: "NVIDIA GeForce RTX 4070 Ti", tflops: 40.1, gbps: 504, vram_gb: 12, match: /RTX 4070 Ti/i }, + { name: "NVIDIA GeForce RTX 4070", tflops: 29.1, gbps: 504, vram_gb: 12, match: /RTX 4070(?! Ti)/i }, + { name: "NVIDIA GeForce RTX 4060 Ti", tflops: 22.1, gbps: 288, vram_gb: 8, match: /RTX 4060 Ti/i }, + { name: "NVIDIA GeForce RTX 4060", tflops: 15.1, gbps: 272, vram_gb: 8, match: /RTX 4060(?! Ti)/i }, + { name: "NVIDIA GeForce RTX 3080", tflops: 29.8, gbps: 760, vram_gb: 10, match: /RTX 3080(?! Ti)/i }, + { name: "NVIDIA GeForce RTX 3070", tflops: 20.3, gbps: 448, vram_gb: 8, match: /RTX 3070(?! Ti)/i }, + { name: "NVIDIA GeForce RTX 3060", tflops: 12.7, gbps: 360, vram_gb: 12, match: /RTX 3060(?! Ti)/i }, + { name: "NVIDIA GeForce RTX 3050", tflops: 9.1, gbps: 224, vram_gb: 8, match: /RTX 3050/i }, + { name: "NVIDIA GeForce RTX 2060", tflops: 6.5, gbps: 336, vram_gb: 6, match: /RTX 2060(?! SUPER)/i }, + { name: "NVIDIA GeForce GTX 1660 SUPER", tflops: 5.0, gbps: 336, vram_gb: 6, match: /GTX 1660 SUPER/i }, + { name: "NVIDIA GeForce GTX 1060 6GB", tflops: 4.4, gbps: 192, vram_gb: 6, match: /GTX 1060/i }, + { name: "NVIDIA GeForce GTX 1050 Ti", tflops: 2.1, gbps: 112, vram_gb: 4, match: /GTX 1050 Ti/i }, + { name: "AMD Radeon RX 7900 XTX", tflops: 61.4, gbps: 960, vram_gb: 24, match: /RX 7900 XTX/i }, + { name: "AMD Radeon RX 7800 XT", tflops: 37.3, gbps: 624, vram_gb: 16, match: /RX 7800 XT/i }, + { name: "AMD Radeon RX 7600", tflops: 21.8, gbps: 288, vram_gb: 8, match: /RX 7600(?! XT)/i }, + { name: "AMD Radeon RX 6700 XT", tflops: 13.2, gbps: 384, vram_gb: 12, match: /RX 6700 XT/i }, + { name: "AMD Radeon RX 6600", tflops: 8.9, gbps: 224, vram_gb: 8, match: /RX 6600(?! XT)/i }, + { name: "AMD Radeon RX 580", tflops: 6.2, gbps: 256, vram_gb: 8, match: /RX 580/i }, + { name: "AMD Radeon 780M (integrated)", tflops: 8.6, gbps: 89, vram_gb: 0, match: /780M/i }, + { name: "Steam Deck (AMD Van Gogh)", tflops: 1.6, gbps: 88, vram_gb: 0, match: /VanGogh|Van Gogh|Custom GPU 0405/i }, + { name: "Intel Arc A770", tflops: 19.7, gbps: 560, vram_gb: 16, match: /Arc.*A770/i }, + { name: "Intel Iris Xe Graphics (96 EU)", tflops: 2.1, gbps: 68, vram_gb: 0, match: /Iris\(?R?\)? Xe/i }, + { name: "Intel HD Graphics 620", tflops: 0.4, gbps: 34, vram_gb: 0, match: /\bU?HD Graphics 620\b/i }, + { name: "Apple M1", tflops: 2.6, gbps: 68, vram_gb: 0, match: /^Apple M1$/i }, + { name: "Apple M2", tflops: 3.6, gbps: 100, vram_gb: 0, match: /^Apple M2$/i }, + { name: "Apple M3", tflops: 4.1, gbps: 100, vram_gb: 0, match: /^Apple M3$/i }, + { name: "Apple M4", tflops: 4.3, gbps: 120, vram_gb: 0, match: /^Apple M4$/i }, + { name: "Apple M1 Pro (16-core GPU)", tflops: 5.2, gbps: 200, vram_gb: 0, match: /^Apple M1 Pro$/i }, + { name: "Apple M4 Pro (20-core GPU)", tflops: 8.5, gbps: 273, vram_gb: 0, match: /^Apple M4 Pro$/i }, + { name: "Apple M4 Max (40-core GPU)", tflops: 17.0, gbps: 546, vram_gb: 0, match: /^Apple M4 Max$/i }, ]; // ghz: top single-core boost clock; ipc: our per-generation factor (Zen 4 = 1). @@ -71,3 +72,17 @@ export const CPUS = [ export const singleThread = (cpu) => cpu.ghz * cpu.ipc; export const findGpu = (name) => GPUS.find((g) => g.name === name || g.match.test(name || "")) || null; export const findCpu = (name) => CPUS.find((c) => c.name === name || c.match.test(name || "")) || null; + +// The telemetry server's hardware classes (crates/horizon-telemetry-server/src/classes.rs), which players' +// results are broken down by: memory and a GPU's own memory in coarse steps. +export function ramClass(gb) { + if (!(gb > 0)) return null; + return gb <= 5 ? "4 GB or less" : gb <= 10 ? "8 GB" : gb <= 20 ? "16 GB" : gb <= 40 ? "32 GB" : "64 GB or more"; +} +export function vramClass(gpu) { + if (!gpu) return null; + if (!gpu.vram_gb) return "shared"; + const mb = gpu.vram_gb * 1024; + for (const [max, name] of [[2560, "2 GB or less"], [4608, "4 GB"], [6656, "6 GB"], [8704, "8 GB"], [12800, "12 GB"], [16896, "16 GB"]]) if (mb <= max) return name; + return "more than 16 GB"; +} diff --git a/website/src/style.css b/website/src/style.css index 9ced17c69..8517a2f43 100644 --- a/website/src/style.css +++ b/website/src/style.css @@ -723,6 +723,8 @@ code { border-radius: 0; background: var(--well); box-shadow: 0 0 0 1px var(--ou .pick-result { margin-top: 16px; padding: 20px; background: var(--panel); border: var(--block-outline) solid var(--outline); box-shadow: var(--panel-edges); } .pick-head { margin-bottom: 12px; font-size: var(--text-caption); color: var(--ink-soft); line-height: 1.8; } .pick-result .meta { margin-top: 12px; } +.pick-notes { margin: 12px 0 0; padding-left: 20px; font-size: var(--text-caption); color: var(--ink-soft); line-height: 1.6; } +.players-hardware th[scope="rowgroup"] { vertical-align: top; } .empty { color: var(--muted); } .prose-section .prose { max-width: 80ch; } .spec-table { margin-top: 24px; } @@ -740,4 +742,3 @@ code { border-radius: 0; background: var(--well); box-shadow: 0 0 0 1px var(--ou .release-detail { padding-left: 0; margin-left: 0; } .machine { padding: 16px; } } -.older-runs { margin-top: 16px; max-width: 90ch; padding: 16px 20px; background: var(--well); box-shadow: 0 0 0 var(--block-outline) var(--outline); font-size: var(--text-caption); } From 213cffcf3eba0ff4afb7a2a6f7eb9d4c4193929c Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 03:13:09 +0200 Subject: [PATCH 091/126] Benchmark report: the screen read again at the end of the run Under Wayland the title screen can come before the window is on a screen, so the report's hardware.display stayed empty (seen end to end in a headless sway). Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/benchmark.rs | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/crates/horizon-client/src/benchmark.rs b/crates/horizon-client/src/benchmark.rs index 00e3ade71..bcb94589c 100644 --- a/crates/horizon-client/src/benchmark.rs +++ b/crates/horizon-client/src/benchmark.rs @@ -239,6 +239,10 @@ fn run(control: &Control, setup: Setup) -> Result { let status = control.status(); let renderer = &status["renderer"]; + // On Wayland the window is on a screen only once it has been shown: ask again. + if report.hardware.display.is_none() { + report.hardware.display = serde_json::from_value(status["display"].clone()).ok(); + } let c = &mut report.conditions; c.scenario = Some(setup.scenario.clone()); c.seed = Some(SEED.to_string()); From d6f8dda823921845fed39d5b1722d33afc4e4dc9 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 05:13:25 +0200 Subject: [PATCH 092/126] Metal: the GPU frame timer measures the frame again (read about 0.01 ms) On Apple GPUs timestamps go only at pass boundaries, and the frame was bracketed by two one-thread compute passes. Two things made it read about 0.01 ms: - Metal resolves counter samples without waiting for the passes that write them. Resolved in the frame's own command buffer, the end timestamp was mostly the one an earlier frame left in the shared query. Each readback slot now has its own queries, and with markers a slot is resolved in a later frame, once on_submitted_work_done says the GPU finished the frame it timed. - A compute pass depends on nothing, so the end marker ran alongside the frame's render passes. The end is now a render pass that loads the frame's target, shading one pixel with every write masked: it runs after every pass that drew into the target. The start stays a compute pass (cheaper than a load and store of the target). M4 Pro, render distance 32, offscreen: GPU p50 0.002 ms before, now 1.95 ms against a 1.95 ms frame (village) and 4.46 ms against 4.51 ms (mountain), where the frame is GPU-bound. Vulkan and DirectX 12, which write timestamps between commands, are unchanged but for the per-slot queries. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/gfx.rs | 8 +- crates/horizon-client/src/gfx/timing.rs | 230 ++++++++++++++++++------ 2 files changed, 185 insertions(+), 53 deletions(-) diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index dfa2c7239..c0b873a5e 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -4003,7 +4003,11 @@ impl Renderer { cull.end(&self.device, &mut encoder); } if let Some(timer) = &mut self.gpu_timer { - timer.end(&mut encoder); + timer.end( + &self.device, + &mut encoder, + (&view_target, self.config.format.remove_srgb_suffix()), + ); } let readback = self.screenshot.take().and_then(|path| { // The copy and PNG writer both assume 8-bit pixels; a float surface would make @@ -4034,7 +4038,7 @@ impl Renderer { cull.submitted(); } if let Some(timer) = &mut self.gpu_timer { - timer.submitted(); + timer.submitted(&self.queue); timer.collect(&self.device, &mut self.gpu_times); } if let Some((path, buffer)) = readback { diff --git a/crates/horizon-client/src/gfx/timing.rs b/crates/horizon-client/src/gfx/timing.rs index 8f8eee6ee..5fc566fe7 100644 --- a/crates/horizon-client/src/gfx/timing.rs +++ b/crates/horizon-client/src/gfx/timing.rs @@ -1,18 +1,35 @@ //! GPU frame time from timestamp queries, read back a few frames late so the //! CPU never waits for it. Frames whose readback slot is still busy go untimed. //! -//! Where the GPU can only time pass boundaries (Apple GPUs on Metal), the -//! frame is bracketed by two one-thread compute passes that write the -//! timestamps (Metal leaves an empty pass's timestamps at zero). +//! Where the GPU can only time pass boundaries (Apple GPUs on Metal), a +//! one-thread compute pass stamps the frame's start, and a render pass over +//! the frame's target that shades one pixel with every write masked stamps +//! its end (Metal leaves the timestamps of a pass that does nothing at zero). +//! A pass that loads the target runs after every pass that draws into it; a +//! compute pass, which depends on nothing, ran alongside them. Metal also +//! resolves timestamps without waiting for the passes that write them, so +//! they are resolved in a later frame, once the GPU has finished this one. +//! Resolved in the frame itself, the end was mostly the one an earlier frame +//! left in the query, and frames read about 0.01 ms. use std::sync::{ Arc, atomic::{AtomicU8, Ordering}, }; -const SLOTS: usize = 4; +/// Frames in flight at once; on Metal a slot is busy for about five frames. +const SLOTS: usize = 8; +/// Each slot's timestamps have their own queries and resolve range. +const RESOLVE_STRIDE: u64 = wgpu::QUERY_RESOLVE_BUFFER_ALIGNMENT; +/// The frame's target and its format. +pub type Target<'a> = (&'a wgpu::TextureView, wgpu::TextureFormat); const FREE: u8 = 0; -const PENDING: u8 = 1; -const MAPPED: u8 = 2; +/// Its frame is submitted; with markers, until the GPU has finished it. +const RUNNING: u8 = 1; +/// Its frame is finished: its timestamps can be resolved. +const DONE: u8 = 2; +/// Resolved and on its way back. +const PENDING: u8 = 3; +const MAPPED: u8 = 4; struct Slot { buffer: wgpu::Buffer, @@ -27,10 +44,29 @@ pub struct GpuTimer { current: Option, next: usize, period_ns: f32, - /// Timestamps between commands, or else this pass's boundaries. - marker: Option, + /// Timestamps between commands, or else these passes' boundaries. + markers: Option, + /// Slots resolved in this frame's commands, read back once it is submitted. + resolved: Vec, } +/// The marker passes: the start's compute pipeline, and the end's shader and +/// pipeline, for the target format it was made for. +struct Markers { + module: wgpu::ShaderModule, + start: wgpu::ComputePipeline, + end: Option<(wgpu::TextureFormat, wgpu::RenderPipeline)>, +} + +/// The start's one thread; the end's triangle over the whole target (the +/// pass's scissor keeps one pixel), shading nothing it writes. +const MARKER: &str = + "@vertex fn cover(@builtin(vertex_index) i: u32) -> @builtin(position) vec4 { + return vec4(f32(i & 1u) * 4.0 - 1.0, f32(i >> 1u) * 4.0 - 1.0, 0.0, 1.0); +} +@fragment fn nothing() -> @location(0) vec4 { return vec4(0.0); } +@compute @workgroup_size(1) fn mark() {}"; + impl GpuTimer { /// The features timing uses that the adapter has (none: no timing). pub fn features(adapter: &wgpu::Adapter) -> wgpu::Features { @@ -44,11 +80,11 @@ impl GpuTimer { let queries = device.create_query_set(&wgpu::QuerySetDescriptor { label: Some("Frame timestamps"), ty: wgpu::QueryType::Timestamp, - count: 2, + count: 2 * SLOTS as u32, }); let resolve = device.create_buffer(&wgpu::BufferDescriptor { label: Some("Frame timestamp resolve"), - size: 16, + size: RESOLVE_STRIDE * SLOTS as u64, usage: wgpu::BufferUsages::QUERY_RESOLVE | wgpu::BufferUsages::COPY_SRC, mapped_at_creation: false, }); @@ -70,42 +106,43 @@ impl GpuTimer { current: None, next: 0, period_ns: queue.get_timestamp_period(), - marker: (!device + markers: (!device .features() .contains(wgpu::Features::TIMESTAMP_QUERY_INSIDE_ENCODERS)) .then(|| { let module = device.create_shader_module(wgpu::ShaderModuleDescriptor { label: Some("Frame timestamp"), - source: wgpu::ShaderSource::Wgsl( - "@compute @workgroup_size(1) fn mark() {}".into(), - ), + source: wgpu::ShaderSource::Wgsl(MARKER.into()), }); - device.create_compute_pipeline(&wgpu::ComputePipelineDescriptor { - label: Some("Frame timestamp"), - layout: None, - module: &module, - entry_point: Some("mark"), - compilation_options: Default::default(), - cache: None, - }) + Markers { + start: device.create_compute_pipeline(&wgpu::ComputePipelineDescriptor { + label: Some("Frame timestamp"), + layout: None, + module: &module, + entry_point: Some("mark"), + compilation_options: Default::default(), + cache: None, + }), + module, + end: None, + } }), + resolved: Vec::new(), }) } pub fn begin(&mut self, encoder: &mut wgpu::CommandEncoder) { + if self.markers.is_some() { + for slot in 0..SLOTS { + if self.slots[slot].state.load(Ordering::Acquire) == DONE { + self.resolve(encoder, slot); + } + } + } let slot = self.next; self.current = (self.slots[slot].state.load(Ordering::Acquire) == FREE).then_some(slot); - if self.current.is_some() { - self.stamp(encoder, 0); - } - } - pub fn end(&mut self, encoder: &mut wgpu::CommandEncoder) { let Some(slot) = self.current else { return }; - self.stamp(encoder, 1); - encoder.resolve_query_set(&self.queries, 0..2, &self.resolve, 0); - encoder.copy_buffer_to_buffer(&self.resolve, 0, &self.slots[slot].buffer, 0, 16); - } - fn stamp(&self, encoder: &mut wgpu::CommandEncoder, index: u32) { - let Some(marker) = &self.marker else { + let index = 2 * slot as u32; + let Some(markers) = &self.markers else { encoder.write_timestamp(&self.queries, index); return; }; @@ -113,29 +150,85 @@ impl GpuTimer { label: Some("Frame timestamp"), timestamp_writes: Some(wgpu::ComputePassTimestampWrites { query_set: &self.queries, - beginning_of_pass_write_index: (index == 0).then_some(0), - end_of_pass_write_index: (index == 1).then_some(1), + beginning_of_pass_write_index: Some(index), + end_of_pass_write_index: None, }), }); - pass.set_pipeline(marker); + pass.set_pipeline(&markers.start); pass.dispatch_workgroups(1, 1, 1); } - /// After the frame's submission: start reading its timestamps back. - pub fn submitted(&mut self) { + /// After the frame's last pass into `target` (the frame's own, of `format`). + pub fn end( + &mut self, + device: &wgpu::Device, + encoder: &mut wgpu::CommandEncoder, + (target, format): Target, + ) { + let Some(slot) = self.current else { return }; + let index = 2 * slot as u32 + 1; + let Some(markers) = &mut self.markers else { + encoder.write_timestamp(&self.queries, index); + self.resolve(encoder, slot); + return; + }; + if markers.end.as_ref().is_none_or(|(f, _)| *f != format) { + markers.end = Some((format, end_pipeline(device, &markers.module, format))); + } + let (_, pipeline) = markers.end.as_ref().expect("made above"); + let mut pass = encoder.begin_render_pass(&wgpu::RenderPassDescriptor { + label: Some("Frame timestamp"), + color_attachments: &[Some(wgpu::RenderPassColorAttachment { + view: target, + depth_slice: None, + resolve_target: None, + ops: wgpu::Operations { + load: wgpu::LoadOp::Load, + store: wgpu::StoreOp::Store, + }, + })], + timestamp_writes: Some(wgpu::RenderPassTimestampWrites { + query_set: &self.queries, + beginning_of_pass_write_index: None, + end_of_pass_write_index: Some(index), + }), + ..Default::default() + }); + pass.set_pipeline(pipeline); + pass.set_scissor_rect(0, 0, 1, 1); + pass.draw(0..3, 0..1); + } + /// Copy `slot`'s timestamps to its readback buffer. + fn resolve(&mut self, encoder: &mut wgpu::CommandEncoder, slot: usize) { + let (first, at) = (2 * slot as u32, RESOLVE_STRIDE * slot as u64); + encoder.resolve_query_set(&self.queries, first..first + 2, &self.resolve, at); + encoder.copy_buffer_to_buffer(&self.resolve, at, &self.slots[slot].buffer, 0, 16); + self.slots[slot].state.store(RUNNING, Ordering::Release); + self.resolved.push(slot); + } + /// After the frame's submission: start reading back what it resolved, + /// and with markers, wait for the GPU to finish the frame it timed. + pub fn submitted(&mut self, queue: &wgpu::Queue) { + for slot in self.resolved.drain(..) { + let state = self.slots[slot].state.clone(); + state.store(PENDING, Ordering::Release); + self.slots[slot] + .buffer + .slice(..) + .map_async(wgpu::MapMode::Read, move |result| { + state.store( + if result.is_ok() { MAPPED } else { FREE }, + Ordering::Release, + ); + }); + } let Some(slot) = self.current.take() else { return; }; - let state = self.slots[slot].state.clone(); - state.store(PENDING, Ordering::Release); - self.slots[slot] - .buffer - .slice(..) - .map_async(wgpu::MapMode::Read, move |result| { - state.store( - if result.is_ok() { MAPPED } else { FREE }, - Ordering::Release, - ); - }); + if self.markers.is_some() { + let state = self.slots[slot].state.clone(); + state.store(RUNNING, Ordering::Release); + queue.on_submitted_work_done(move || state.store(DONE, Ordering::Release)); + } self.next = (slot + 1) % SLOTS; } /// GPU milliseconds of frames whose timestamps have arrived, oldest first. @@ -149,11 +242,46 @@ impl GpuTimer { if let Ok(data) = slot.buffer.slice(..).get_mapped_range() { // Read unaligned: the mapping isn't guaranteed to be 8-byte aligned. let stamps: [u64; 2] = bytemuck::pod_read_unaligned(&data[..16]); - let ticks = stamps[1].saturating_sub(stamps[0]); - out.push((ticks as f64 * f64::from(self.period_ns) / 1e6) as f32); + // A start marker that ran late (rare on Metal) leaves the frame untimed. + if let Some(ticks) = stamps[1].checked_sub(stamps[0]) { + out.push((ticks as f64 * f64::from(self.period_ns) / 1e6) as f32); + } } slot.buffer.unmap(); slot.state.store(FREE, Ordering::Release); } } } + +/// The end marker's pipeline for a `format` target, every write masked. +fn end_pipeline( + device: &wgpu::Device, + module: &wgpu::ShaderModule, + format: wgpu::TextureFormat, +) -> wgpu::RenderPipeline { + device.create_render_pipeline(&wgpu::RenderPipelineDescriptor { + label: Some("Frame timestamp"), + layout: None, + vertex: wgpu::VertexState { + module, + entry_point: Some("cover"), + compilation_options: Default::default(), + buffers: &[], + }, + primitive: wgpu::PrimitiveState::default(), + depth_stencil: None, + multisample: wgpu::MultisampleState::default(), + fragment: Some(wgpu::FragmentState { + module, + entry_point: Some("nothing"), + compilation_options: Default::default(), + targets: &[Some(wgpu::ColorTargetState { + format, + blend: None, + write_mask: wgpu::ColorWrites::empty(), + })], + }), + multiview_mask: None, + cache: None, + }) +} From 0c133101b695d8bccfa6d546411da6a171a80888 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 00:55:22 +0200 Subject: [PATCH 093/126] Screen overlays: wrap texels with a select, not integer modulo The camera overlays (the vignette every frame) read up to four texels a pixel, each wrapped with two integer modulos. Intel GPUs emulate integer division. Reducing the coordinate to one period first (fract, as the shader did before) leaves every read at most one texel outside the sprite, so a select wraps it. Same texels and weights; clamp-to-edge is unchanged. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/screen.wgsl | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/crates/horizon-client/src/screen.wgsl b/crates/horizon-client/src/screen.wgsl index a82b0f890..f32274bc8 100644 --- a/crates/horizon-client/src/screen.wgsl +++ b/crates/horizon-client/src/screen.wgsl @@ -23,9 +23,11 @@ struct Out { } const SAMPLE_BLUR: u32 = 1u; const SAMPLE_CLAMP: u32 = 2u; -// A texel of the sprite, addressed by repeat or clamp-to-edge. +// A texel of the sprite, addressed by repeat or clamp-to-edge. With repeat, `p` is at most one +// texel outside the sprite (`sample` reduces the coordinate first), so wrapping is a select: no +// integer division, which Intel GPUs emulate (it cost 0.85 ms a frame on the vignette on an HD 620). fn texel(origin: vec2, size: vec2, p: vec2, clamp_edge: bool) -> vec4 { - var q = ((p % size) + size) % size; + var q = select(select(p, p - size, p >= size), p + size, p < vec2(0)); if clamp_edge { q = clamp(p, vec2(0), size - 1); } return textureLoad(atlas, origin + q, 0); } @@ -34,7 +36,8 @@ fn sample(in: Out) -> vec4 { let origin = vec2(round(in.rect.xy * dims)); let size = max(vec2(round((in.rect.zw - in.rect.xy) * dims)), vec2(1)); let clamp_edge = (in.sampling & SAMPLE_CLAMP) != 0u; - let p = in.uv * vec2(size); + // Repeat: one period of the sprite, so every texel read is at most one outside it. + let p = select(fract(in.uv), in.uv, clamp_edge) * vec2(size); if (in.sampling & SAMPLE_BLUR) == 0u { return texel(origin, size, vec2(floor(p)), clamp_edge) * in.color; } From 7acebbae45fb84ec7c905e05f4ac4e4220914d0b Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 04:23:58 +0200 Subject: [PATCH 094/126] Server players: the HUD's bubbles and golden hearts follow the server, absorption is saved, Nether lava pushes harder The server sends a player's own air supply and absorption amount (Entity.DATA_AIR_SUPPLY_ID, Player.DATA_PLAYER_ABSORPTION_ID) when they change, and the client applies them: on the server thread and as a LAN guest the breath meter follows the server's Respiration-extended air (#1304) and the golden hearts show (#1306). The connected client's tick sets the helmet's Respiration and the Nether's FAST_LAVA as the window's own tick does (#1309). AbsorptionAmount is written from the live body and read back on load, in the window's world and for a server's players (#1307). lan_e2e: absorption, breath and lava checks. Co-Authored-By: Claude Opus 5.5 --- .../horizon-client/src/attribute_updates.rs | 5 + crates/horizon-client/src/game.rs | 1 + crates/horizon-client/src/game/agent.rs | 2 + crates/horizon-client/src/game/lan.rs | 3 + crates/horizon-client/src/game/lan_actions.rs | 6 + crates/horizon-client/src/game/remote.rs | 31 ++++- crates/horizon-client/src/lan/guest.rs | 9 ++ crates/horizon-client/src/lan/hub.rs | 25 +++- crates/horizon-client/src/lan/playerdata.rs | 7 + crates/horizon-client/src/motion.rs | 2 + crates/horizon-client/src/save.rs | 10 +- tools/lan_e2e.py | 122 +++++++++++++++++- 12 files changed, 215 insertions(+), 8 deletions(-) diff --git a/crates/horizon-client/src/attribute_updates.rs b/crates/horizon-client/src/attribute_updates.rs index b81db5835..1dcc21028 100644 --- a/crates/horizon-client/src/attribute_updates.rs +++ b/crates/horizon-client/src/attribute_updates.rs @@ -22,6 +22,11 @@ impl PlayerMotion { pub fn refresh_attributes(&mut self) -> Result<()> { live_updates::refresh(self) } + /// `Player.internalSetAbsorptionAmount`: the amount as given, unclamped + /// (the saved `AbsorptionAmount`, or what a client's server sent). + pub fn internal_set_absorption(&mut self, value: f32) -> Result<()> { + self.store_absorption(value) + } } impl HealthWorld for PlayerMotion { type Error = Box; diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 5da86dfaf..d689ad8fc 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -9516,6 +9516,7 @@ impl Game<'_> { if let Some(p) = &self.player { level.position = Some([p.position.x, p.position.y, p.position.z]); level.health = p.health.health(); + level.absorption = p.health.absorption(); let extra = level .player_extra .get_or_insert_with(|| horizon_world::nbt::Tag::Compound(Default::default())); diff --git a/crates/horizon-client/src/game/agent.rs b/crates/horizon-client/src/game/agent.rs index ea686e711..b30adca5c 100644 --- a/crates/horizon-client/src/game/agent.rs +++ b/crates/horizon-client/src/game/agent.rs @@ -459,6 +459,8 @@ impl Game<'_> { "sneaking": self.keys.contains(&KeyCode::ShiftLeft), "sprinting": self.keys.contains(&KeyCode::ControlLeft), "health": p.health.health(), + "absorption": p.health.absorption(), + "air": p.air, "food": p.health.food.food, "saturation": p.health.food.saturation, "xp": { "level": self.experience.level, "progress": self.experience.progress, "total": self.experience.total }, diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index 4e05ea600..0ea2a6faa 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -393,6 +393,9 @@ impl Game<'_> { "sneaking": g.sneaking, "sleeping": g.bed, "health": g.health, + // The server's body: its air supply and golden hearts. + "air": g.motion.as_ref().map(|m| m.air), + "absorption": g.motion.as_ref().map(|m| m.health.absorption()), // FoodData: food level, saturation and exhaustion. "food": [ f64::from(g.food), diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index 0d70b16f6..65cbf2e5f 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -217,6 +217,12 @@ impl Game<'_> { host.hub.guests[i].position[2], ); host.hub.guests[i].motion = PlayerMotion::new(self.motion, p).ok().map(Box::new); + // The saved golden hearts go on the first body of a player who + // has been here before. + let saved = host.hub.guests[i].saved_absorption.take(); + if let (Some(m), Some(amount)) = (host.hub.guests[i].motion.as_mut(), saved) { + let _ = m.internal_set_absorption(amount); + } let kept = host.hub.guests[i].logs_kept.take(); if let (Some(m), Some((hurts, attacks))) = (host.hub.guests[i].motion.as_mut(), kept) { m.hurt_log = hurts; diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 5461a4cd0..70096277f 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -1867,11 +1867,27 @@ impl Game<'_> { // player lies down in the bed, or gets up. if self.remote.as_ref().is_some_and(|r| r.entity_id == p.id) { for (index, _, value) in &p.values { - if let (14, Value::OptPos(bed)) = (index, value) { - if bed.is_some() && self.sleeping.is_none() { - self.sleep_timer = 0; + match (index, value) { + (14, Value::OptPos(bed)) => { + if bed.is_some() && self.sleeping.is_none() { + self.sleep_timer = 0; + } + self.sleeping = *bed; } - self.sleeping = *bed; + // Entity.DATA_AIR_SUPPLY_ID and + // Player.DATA_PLAYER_ABSORPTION_ID: the bubbles + // and golden hearts the server's player has. + (1, Value::Int(air)) => { + if let Some(pl) = self.player.as_mut() { + pl.air = *air; + } + } + (17, Value::Float(amount)) => { + if let Some(pl) = self.player.as_mut() { + let _ = pl.internal_set_absorption(*amount); + } + } + _ => {} } } } @@ -2997,6 +3013,13 @@ impl Game<'_> { ); let was_flying = player.flying; player.yaw = self.yaw; + // As the window's own tick has them: the helmet's Respiration + // (decreaseAirSupply) and the dimension's FAST_LAVA, the Nether's + // stronger lava current. + player.respiration = self.armor[0] + .as_ref() + .map_or(0, |s| s.enchantment_level("minecraft:respiration") as i32); + player.fluids.fast_lava = self.dim == Dim::Nether; let dead = self.screen == Screen::Dead; // LivingEntity.isImmobile: a sleeper lies still in the bed. if let Some(head) = self.sleeping { diff --git a/crates/horizon-client/src/lan/guest.rs b/crates/horizon-client/src/lan/guest.rs index 1916344bb..3c5d4b50c 100644 --- a/crates/horizon-client/src/lan/guest.rs +++ b/crates/horizon-client/src/lan/guest.rs @@ -149,6 +149,9 @@ pub struct Guest { /// The ender chest inventory (`PlayerEnderChestContainer`, 27 slots). pub ender_items: Vec>, pub health: f32, + /// The saved `AbsorptionAmount`, until the player's first body on the + /// server takes it (the body holds the live amount). + pub saved_absorption: Option, pub food: i32, pub saturation: f32, pub xp_level: i32, @@ -168,6 +171,10 @@ pub struct Guest { /// `lastSentHealth`, `lastSentFood` and `lastFoodSaturationZero`. pub sent_health: Option<(f32, i32, bool)>, pub sent_xp: Option<(f32, i32, i32)>, + /// The air supply and absorption the player's client was last sent + /// (Entity.DATA_AIR_SUPPLY_ID, Player.DATA_PLAYER_ABSORPTION_ID); their + /// defaults until either changes. + pub sent_air: (i32, f32), /// Where the player last died (Player.lastDeathLocation), sent with the respawn. pub last_death: Option<[i32; 3]>, /// The last action sequence to acknowledge at the next tick (-1: none). @@ -280,6 +287,7 @@ impl Guest { craft_result: None, ender_items: vec![None; 27], health: 20.0, + saved_absorption: None, food: 20, saturation: 5.0, xp_level: 0, @@ -292,6 +300,7 @@ impl Guest { menu_state: 0, sent_health: None, sent_xp: None, + sent_air: (300, 0.0), last_death: None, ack_up_to: std::cell::Cell::new(-1), sent_selected: 0, diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index bf66f979b..1455e60b8 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -1755,6 +1755,27 @@ impl Hub { })); } } + // ServerEntity.sendDirtyEntityData: the air supply and the absorption + // amount the server's body changed go to the player, whose HUD draws + // them (bubbles, golden hearts). + let g = &mut self.guests[i]; + if let Some(m) = g.motion.as_ref() { + let now = (m.air, m.health.absorption()); + let mut values = Vec::new(); + if now.0 != g.sent_air.0 { + values.push((1, serializer::INT, Value::Int(now.0))); + } + if now.1.to_bits() != g.sent_air.1.to_bits() { + values.push((17, serializer::FLOAT, Value::Float(now.1))); + } + if !values.is_empty() { + g.sent_air = now; + g.send(&C::SetEntityData(play::SetEntityData { + id: g.entity_id, + values, + })); + } + } // Sent when the health or the food level changes, or the saturation // reaches or leaves zero; a dead player's health of 0 too. let g = &mut self.guests[i]; @@ -2465,9 +2486,11 @@ impl Hub { global: false, })); } - // lastSentExp, lastSentHealth and lastSentFood. + // lastSentExp, lastSentHealth and lastSentFood; the client's new + // player starts with the default air and no absorption. g.sent_health = None; g.sent_xp = None; + g.sent_air = (300, 0.0); let (cx, cz) = g.chunk(); g.send(&C::SetChunkCacheCenter(play::SetChunkCacheCenter { x: cx, diff --git a/crates/horizon-client/src/lan/playerdata.rs b/crates/horizon-client/src/lan/playerdata.rs index 8797f25a2..6a26306fb 100644 --- a/crates/horizon-client/src/lan/playerdata.rs +++ b/crates/horizon-client/src/lan/playerdata.rs @@ -61,6 +61,7 @@ pub fn apply(guest: &mut Guest, level: &Level) { guest.head_yaw = guest.yaw; guest.on_ground = level.on_ground; guest.health = level.health; + guest.saved_absorption = Some(level.absorption); guest.food = level.food; guest.saturation = level.saturation; guest.xp_level = level.xp_level; @@ -123,6 +124,12 @@ pub fn store(guest: &Guest, level: &mut Level) { level.dimension = guest.dimension.clone(); level.rotation = [guest.yaw, guest.pitch]; level.health = guest.health; + level.absorption = guest + .motion + .as_ref() + .map_or(guest.saved_absorption.unwrap_or(0.0), |m| { + m.health.absorption() + }); level.food = guest.food; level.saturation = guest.saturation; level.xp_level = guest.xp_level; diff --git a/crates/horizon-client/src/motion.rs b/crates/horizon-client/src/motion.rs index 1920026b9..c0c882e0f 100644 --- a/crates/horizon-client/src/motion.rs +++ b/crates/horizon-client/src/motion.rs @@ -338,6 +338,8 @@ impl PlayerMotion { .and_then(|t| crate::save::number(t.get("Air"))) .unwrap_or(300) as i32; self.set_health(level.health, false)?; + // LivingEntity.readAdditionalSaveData: internalSetAbsorptionAmount. + self.internal_set_absorption(level.absorption)?; self.health.food.food = level.food; self.health.food.saturation = level.saturation; self.flying = level.flying; diff --git a/crates/horizon-client/src/save.rs b/crates/horizon-client/src/save.rs index 0cfe3c585..2fbb04dc4 100644 --- a/crates/horizon-client/src/save.rs +++ b/crates/horizon-client/src/save.rs @@ -2266,6 +2266,8 @@ pub struct Level { pub position: Option<[f64; 3]>, pub rotation: [f32; 2], pub health: f32, + /// LivingEntity `AbsorptionAmount`: the golden hearts left. + pub absorption: f32, pub food: i32, pub saturation: f32, /// (slot, item, count, damage): 0..36 inventory, 100..103 armor (feet..head), 150 offhand. @@ -2455,6 +2457,7 @@ impl Level { } self.motion = read_doubles::<3>(p.get("Motion")).unwrap_or_default(); self.health = f("Health").map_or(20.0, |v| v as f32); + self.absorption = f("AbsorptionAmount").map_or(0.0, |v| v as f32); self.food = n("foodLevel").map_or(20, |v| v as i32); self.saturation = f("foodSaturationLevel").map_or(5.0, |v| v as f32); self.food_exhaustion = f("foodExhaustionLevel").unwrap_or(0.0) as f32; @@ -2626,6 +2629,7 @@ impl Level { ("OnGround", Tag::Byte(i8::from(self.on_ground))), ("fall_distance", Tag::Double(self.fall_distance.to_bits())), ("Health", Tag::Float(self.health.to_bits())), + ("AbsorptionAmount", Tag::Float(self.absorption.to_bits())), ("foodLevel", Tag::Int(self.food)), ("foodSaturationLevel", Tag::Float(self.saturation.to_bits())), ( @@ -2731,7 +2735,6 @@ impl Level { ("seenCredits", Tag::Byte(0)), ("HurtTime", Tag::Short(0)), ("DeathTime", Tag::Short(0)), - ("AbsorptionAmount", Tag::Float(0)), ("FallFlying", Tag::Byte(0)), ] { map.entry(key.into()).or_insert(value); @@ -4114,6 +4117,7 @@ mod tests { position: Some([1.5, 70.0, -3.25]), rotation: [90.0, 10.0], health: 17.0, + absorption: 5.0, food: 15, saturation: 2.5, inventory: vec![ @@ -4144,6 +4148,7 @@ mod tests { assert_eq!(back.position, Some([1.5, 70.0, -3.25])); assert_eq!(back.rotation, [90.0, 10.0]); assert_eq!((back.health, back.food, back.saturation), (17.0, 15, 2.5)); + assert_eq!(back.absorption, 5.0); let mut inv = back.inventory.clone(); inv.sort(); assert_eq!( @@ -4178,10 +4183,13 @@ mod tests { let mut again = Level { player_extra: Some(extra), ender_items: ender, + // The live amount, not the one the loaded compound held (#1307). + absorption: 2.0, ..back }; again.write(&dir).unwrap(); let third = Level::read(&dir).unwrap(); + assert_eq!(third.absorption, 2.0); assert!(matches!( third .player_extra diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index c5a90150f..a4fdafe71 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -131,6 +131,12 @@ address. The script then checks, from both sides, what a guest's game used to ge get off by sneaking; the other side sees the animal move. - lightning: a bolt summoned beside the host, then the guest: both sides get the bolt and flash the sky (on its server thread the host's window is a client of it too). +- absorption: the host and the guest each take Absorption II and a hit of 3: their own HUD has the + server's golden hearts, 8 then 5 (#1306). +- breath: the host and the guest each stay underwater for 15 s in a Respiration III helmet: their + own bubbles follow the server's air, which the enchantment makes last (#1304). +- lava: (--server-thread) the host and the guest each stand in a Nether lava current with Fire + Resistance, which pushes them at the Nether's strength (#1309). - flight: a player in creative double-taps jump and flies, stays up, and stops flying in survival: the guest, and on the server thread the host's window too, take what may fly from the server's abilities (ClientPacketListener.handlePlayerAbilities). @@ -172,7 +178,7 @@ ROOT = Path(__file__).resolve().parents[1] GUEST_NAME = 'Guest' # The host plays single player on its server thread (--server-thread). SERVER_THREAD = False -CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder', 'boats', 'minecarts', 'frames', 'lightning', 'riding', 'mounts'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder', 'boats', 'minecarts', 'frames', 'lightning', 'riding', 'mounts', 'absorption', 'breath', 'lava'] class Game: @@ -2297,6 +2303,117 @@ def check_flight(host, guest, out): +def own(game): + """The player's own state, as its client has it.""" + return game('state')['player'] + + +def server_player(host, game): + """The player's entry on the server: the guest's in the host's `lan status`, on the server + thread the host's too; the host's own world otherwise.""" + if game is host and not SERVER_THREAD: + return own(host) + name = GUEST_NAME if game is not host else host.player + return next(g for g in host.raw('lan', 'status')['guests'] if g['name'] == name) + + +def check_absorption(host, guest, out): + """Absorption II's golden hearts on each player's own HUD: 8 of them, and 5 once a hit of 3 took + its share: the client shows what the server's player has (#1306).""" + seen = {} + for game in (host, guest): + game('command', command='gamemode survival') + game('command', command='effect give @s minecraft:absorption 120 1') + game.wait(10) + given = own(game)['absorption'] + game('command', command='damage @s 3 minecraft:generic') + game.wait(20) + me = own(game) + server = server_player(host, game) + game.shot(out, 'absorption') + game('command', command='effect clear @s minecraft:absorption') + seen[game.name] = {'given': given, 'left': me['absorption'], 'health': me['health'], + 'server': server.get('absorption')} + for name, s in seen.items(): + assert s['given'] == 8.0 and s['left'] == 5.0 == s['server'] and s['health'] == 20.0, \ + f'{name}: {seen}' + return seen + + +def check_breath(host, guest, out): + """Underwater in a Respiration III helmet for 15 s: the enchantment makes the air last on the + server, and each player's own bubbles follow the server's air (#1304).""" + hx, hy, hz = (int(v // 1) for v in pos_of(host)) + seen = {} + for game, dz in ((host, -4), (guest, 4)): + x, y, z = hx + 3, hy, hz + dz + game('command', command='gamemode survival') + game('command', command='item replace entity @s armor.head with ' + 'minecraft:diamond_helmet[minecraft:enchantments={"minecraft:respiration":3}]') + game('command', command=f'fill {x - 1} {y - 1} {z - 1} {x + 1} {y + 2} {z + 1} minecraft:stone') + game('command', command=f'fill {x} {y} {z} {x} {y + 1} {z} minecraft:water') + game('command', command=f'tp @s {x + 0.5} {y} {z + 0.5}') + host.wait(300) + for game in (host, guest): + game.shot(out, 'breath') + seen[game.name] = {'own': own(game)['air'], 'server': server_player(host, game).get('air')} + for game, dz in ((host, -4), (guest, 4)): + x, y, z = hx + 3, hy, hz + dz + game('command', command='item replace entity @s armor.head with minecraft:air') + host('command', command=f'fill {x - 1} {y - 1} {z - 1} {x + 1} {y + 2} {z + 1} minecraft:air') + host('command', command=f'fill {x - 1} {y - 1} {z - 1} {x + 1} {y - 1} {z + 1} minecraft:stone') + guest.wait(40) + # 300 ticks lose about 75 of the 300 with Respiration III, all of it without. + for name, s in seen.items(): + assert s['server'] > 150 and abs(s['own'] - s['server']) <= 10, f'{name}: {seen}' + return seen + + +def check_lava(host, guest, out): + """(--server-thread) Standing in a settled Nether lava current with Fire Resistance: the + Nether's FAST_LAVA pushes each player about three times as hard as the Overworld's (#1309).""" + if not SERVER_THREAD: + return 'skipped (needs --server-thread)' + seen = {} + back = {g.name: pos_of(g) for g in (host, guest)} + try: + for game, z in ((host, 0), (guest, 6)): + game('command', command=f'execute in minecraft:the_nether run tp @s 0.5 100 {z + 0.5}') + state = wait_dimension(game, 'minecraft:the_nether', 600) + assert state.get('dimension') == 'minecraft:the_nether', f'{game.name} is in {state.get("dimension")}' + game.wait(40) + # A one-wide obsidian channel along x: a source at x = -3, the current flowing east. + game('command', command=f'fill -5 98 {z - 2} 6 104 {z + 2} minecraft:air') + game('command', command=f'fill -5 98 {z - 1} 6 98 {z + 1} minecraft:obsidian') + game('command', command=f'fill -5 99 {z - 1} 6 99 {z - 1} minecraft:obsidian') + game('command', command=f'fill -5 99 {z + 1} 6 99 {z + 1} minecraft:obsidian') + game('command', command=f'fill -4 99 {z} -4 99 {z} minecraft:obsidian') + game('command', command='effect give @s minecraft:fire_resistance 120 0 true') + game('command', command='gamemode survival') + game('command', command=f'setblock -3 99 {z} minecraft:lava') + host.wait(100) + for game, z in ((host, 0), (guest, 6)): + game('command', command=f'tp @s 0.5 99 {z + 0.5}') + host.wait(60) + for game, z in ((host, 0), (guest, 6)): + v = own(game)['velocity'] + seen[game.name] = {'vx': v[0], 'level': game.raw('block', 0, 99, z).get('state')} + game.shot(out, 'lava') + finally: + for game, z in ((host, 0), (guest, 6)): + host('command', command=f'execute in minecraft:the_nether run fill -5 98 {z - 2} 6 104 {z + 2} minecraft:air') + x, y, zz = back[game.name] + game('command', command='effect clear @s minecraft:fire_resistance') + game('command', command=f'execute in minecraft:overworld run tp @s {x:.2f} {y:.2f} {zz:.2f}') + for game in (host, guest): + wait_dimension(game, 'minecraft:overworld', 600) + guest.wait(40) + # The Overworld's current settles at about 0.0047 a tick, the Nether's at about 0.014. + for name, s in seen.items(): + assert s['vx'] > 0.009, f'{name}: {seen}' + return seen + + def check_ladder(host, guest, out): """#1255: climbing down a ladder doesn't hurt where the guest lands.""" x, y, z = (int(v // 1) for v in pos_of(guest)) @@ -3075,7 +3192,8 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles, 'blast': check_blast, 'light': check_light, 'plates': check_plates, 'swings': check_swings, 'cracks': check_cracks, - 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder, 'boats': check_boats, 'minecarts': check_minecarts, 'frames': check_frames, 'lightning': check_lightning, 'riding': check_riding, 'mounts': check_mounts} + 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder, 'boats': check_boats, 'minecarts': check_minecarts, 'frames': check_frames, 'lightning': check_lightning, 'riding': check_riding, 'mounts': check_mounts, + 'absorption': check_absorption, 'breath': check_breath, 'lava': check_lava} def run(ctl, out, resources, checks): From ed28e1dd0d6f6959179ba5f1914cfb69de14d1ae Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 04:56:08 +0200 Subject: [PATCH 095/126] Contact damage: magma, cactus, lit campfires and sweet berry bushes hurt in both modes Entity.applyEffectsFromBlocks: MagmaBlock.stepOn burns a player standing on it who is not sneaking (hot_floor, 1), CactusBlock and CampfireBlock.entityInside hurt what touches them (cactus 1, campfire 1, soul campfire 2, lit only). A server's players (LAN guests, and the host on the server thread) now get these and the grown sweet berry bush prick along the moves their client sent that tick: the server rebuilds the tick's movement history and runs the damage half of the block effects. lan_e2e `contacts`: magma, sneaking on magma, a lit campfire, a cactus, grown and young berry bushes, for the host and the guest. Fixes #1305, #1311, #1312, #1313. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game/lan_actions.rs | 25 +++++++ crates/horizon-client/src/motion.rs | 73 ++++++++++++++++++- .../horizon-client/src/motion/environment.rs | 2 +- tools/lan_e2e.py | 64 +++++++++++++++- 4 files changed, 158 insertions(+), 6 deletions(-) diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index 0d70b16f6..9d1181b80 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -1765,6 +1765,7 @@ impl Game<'_> { } let in_wall = !g.sleeping && self.in_wall(g.position, g.eye_height()); let at = g.position; + let sneaking = g.sneaking; let sounds = self.as_guest(host, conn, |game| { let (rules, motion) = (game.world.health_rules, game.motion); let health = &motion.health; @@ -1783,6 +1784,26 @@ impl Game<'_> { let _ = w.fluid_base_tick(); w.player.ground.on_ground = from_ground; let travelled: Vec<[f64; 3]> = moves.iter().map(|m| m.0).collect(); + // Entity.move's movementThisTick: each move, from where the + // tick's first one started. + let end = w.player.position; + let start = travelled + .iter() + .fold(end, |p, d| p.subtract(Vec3::new(d[0], d[1], d[2]))); + w.player.history.clear(); + let mut from = start; + for d in &travelled { + let delta = Vec3::new(d[0], d[1], d[2]); + let to = from.add_vector(delta); + w.player + .history + .add(horizon_world::entity_move::MovementRecord { + from, + to, + original: Some(delta), + }); + from = to; + } for (moved, on_ground) in moves { let movement = Vec3::new(moved[0], moved[1], moved[2]); if w.player.ground.on_ground && !on_ground && moved[1] > 0.0 { @@ -1808,6 +1829,10 @@ impl Game<'_> { if w.climbable().unwrap_or(false) { w.player.fall_distance = 0.0; } + // Entity.applyEffectsFromBlocks along those moves: magma, cactus, + // lit campfires and grown sweet berry bushes hurt (#1305). + w.player.shift_key_down = sneaking; + let _ = w.server_block_damage(start); let _ = w.tick_environment_damage(); let _ = w.apply_fire_contact(); let _ = w.server_hazards_tick(in_wall); diff --git a/crates/horizon-client/src/motion.rs b/crates/horizon-client/src/motion.rs index 1920026b9..8831a5912 100644 --- a/crates/horizon-client/src/motion.rs +++ b/crates/horizon-client/src/motion.rs @@ -1029,9 +1029,22 @@ impl MotionWorld<'_, '_, '_> { } /// `Entity.applyEffectsFromBlocks` for the blocks Horizon's player reacts /// to inside its movement path: powder snow (`PowderSnowBlock.entityInside` - /// and the FREEZE / EXTINGUISH effects), cobwebs and sweet berry bushes. Pressure plates, tripwires and - /// rails are the world tick's scan. + /// and the FREEZE / EXTINGUISH effects), cobwebs, sweet berry bushes, + /// cactus and lit campfires, and the magma block it stands on + /// (`stepOn`). Pressure plates, tripwires and rails are the world tick's + /// scan. pub fn apply_effects_from_blocks(&mut self) -> Result<()> { + self.effects_from_blocks(false) + } + /// What `applyEffectsFromBlocks` does to a server's player along the + /// moves its client sent since `from` (in its history): the damage of + /// magma, cactus, lit campfires and grown sweet berry bushes. Its client + /// moves it, so the slowing and the rest are the client's. + pub fn server_block_damage(&mut self, from: Vec3) -> Result<()> { + self.player.old_position = from; + self.effects_from_blocks(true) + } + fn effects_from_blocks(&mut self, damage_only: bool) -> Result<()> { use horizon_world::entity_move::MovementRecord; let mut movements: Vec = self.player.history.records().iter().copied().collect(); @@ -1056,6 +1069,19 @@ impl MotionWorld<'_, '_, '_> { if self.player.spectator { return Ok(()); } + // Block.stepOn for the block under an entity on the ground: + // MagmaBlock's hot floor hurts unless it steps carefully (sneaks). + if self.player.ground.on_ground { + let on = self.legacy_on_position()?; + let magma = self + .assets + .registry + .state(self.block(on)) + .is_some_and(|s| s.name == "minecraft:magma_block"); + if magma && !self.player.shift_key_down { + self.environment_hurt("minecraft:hot_floor", 1.0)?; + } + } let mut visited = std::collections::HashSet::new(); let mut entered = Vec::new(); for movement in &movements { @@ -1081,6 +1107,7 @@ impl MotionWorld<'_, '_, '_> { &mut visited, &mut entered, budget, + damage_only, )?; from = to; } @@ -1093,11 +1120,19 @@ impl MotionWorld<'_, '_, '_> { &mut visited, &mut entered, 16, + damage_only, )?; } } if budget <= 0 { - self.check_inside_blocks(movement.to, movement.to, &mut visited, &mut entered, 1)?; + self.check_inside_blocks( + movement.to, + movement.to, + &mut visited, + &mut entered, + 1, + damage_only, + )?; } } // InsideBlockEffectApplier.StepBasedCollector: the blocks entered @@ -1137,6 +1172,7 @@ impl MotionWorld<'_, '_, '_> { visited: &mut std::collections::HashSet, entered: &mut Vec<(i32, BlockPos)>, max_iterations: i32, + damage_only: bool, ) -> Result { let deflated = self.player.dimensions.bounds(to).deflate(Vec3::new( f64::from(1.0e-5_f32), @@ -1213,6 +1249,33 @@ impl MotionWorld<'_, '_, '_> { } }; if inside && visited.insert(p.pack()) { + // CactusBlock and CampfireBlock.entityInside (`entity.hurt`). + match name { + "minecraft:cactus" => self.environment_hurt("minecraft:cactus", 1.0)?, + "minecraft:campfire" | "minecraft:soul_campfire" => { + let lit = self + .assets + .registry + .state(state) + .and_then(|s| s.properties.get("lit")) + .is_some_and(|v| v == "true"); + let damage = if name == "minecraft:campfire" { + 1.0 + } else { + 2.0 + }; + if lit { + self.environment_hurt("minecraft:campfire", damage)?; + } + } + "minecraft:sweet_berry_bush" if damage_only => { + self.sweet_berry_bush_damage(state)?; + } + _ => {} + } + if damage_only { + continue; + } match name { "minecraft:powder_snow" => { self.powder_snow_inside(p)?; @@ -1261,6 +1324,10 @@ impl MotionWorld<'_, '_, '_> { /// is at least 0.003 on X or Z. fn sweet_berry_bush_inside(&mut self, state: BlockStateId) -> Result<()> { self.make_stuck_in_block(Vec3::new(f64::from(0.8_f32), 0.75, f64::from(0.8_f32))); + self.sweet_berry_bush_damage(state) + } + /// The server's half of `SweetBerryBushBlock.entityInside`: the prick. + fn sweet_berry_bush_damage(&mut self, state: BlockStateId) -> Result<()> { let age = self .assets .registry diff --git a/crates/horizon-client/src/motion/environment.rs b/crates/horizon-client/src/motion/environment.rs index a9bb33678..fc3c63c77 100644 --- a/crates/horizon-client/src/motion/environment.rs +++ b/crates/horizon-client/src/motion/environment.rs @@ -6,7 +6,7 @@ use horizon_world::{ living_fluid::{LivingFluidWorld, TravelFluidTag}, }; impl MotionWorld<'_, '_, '_> { - fn environment_hurt(&mut self, source: &str, damage: f32) -> Result<()> { + pub(super) fn environment_hurt(&mut self, source: &str, damage: f32) -> Result<()> { if self.player.invulnerable || self.player.spectator { return Ok(()); } diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index c5a90150f..4226f8521 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -131,6 +131,9 @@ address. The script then checks, from both sides, what a guest's game used to ge get off by sneaking; the other side sees the animal move. - lightning: a bolt summoned beside the host, then the guest: both sides get the bolt and flash the sky (on its server thread the host's window is a client of it too). +- contacts: the host and the guest each stand on magma (and sneak on it), stand on a lit campfire, + walk against a cactus and through grown sweet berry bushes: the server hurts them, but + not the sneaking player or young bushes (#1305, #1311, #1312, #1313). - flight: a player in creative double-taps jump and flies, stays up, and stops flying in survival: the guest, and on the server thread the host's window too, take what may fly from the server's abilities (ClientPacketListener.handlePlayerAbilities). @@ -172,7 +175,7 @@ ROOT = Path(__file__).resolve().parents[1] GUEST_NAME = 'Guest' # The host plays single player on its server thread (--server-thread). SERVER_THREAD = False -CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder', 'boats', 'minecarts', 'frames', 'lightning', 'riding', 'mounts'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder', 'boats', 'minecarts', 'frames', 'lightning', 'riding', 'mounts', 'contacts'] class Game: @@ -2297,6 +2300,62 @@ def check_flight(host, guest, out): +def own(game): + """The player's own state, as its client has it.""" + return game('state')['player'] + + +def check_contacts(host, guest, out): + """Blocks that hurt what touches them, on the server: standing on magma (but not sneaking on it) + and on a lit campfire, walking against a cactus and through grown sweet berry bushes, for the + host and the guest (#1305, #1311, #1312, #1313); a young bush pricks no one.""" + hx, hy, hz = (int(v // 1) for v in pos_of(host)) + host('command', command='gamerule natural_health_regeneration false') + seen = {} + try: + for game, dz in ((host, -4), (guest, 4)): + x, y, z = hx + 2, hy, hz + dz + game('command', command='gamemode survival') + game('command', command='effect clear @s') + for case, blocks, walk in ( + ('magma', [(0, -1, 'minecraft:magma_block')], False), + ('sneaking', [(0, -1, 'minecraft:magma_block')], False), + ('campfire', [(0, 0, 'minecraft:campfire[lit=true]')], False), + ('cactus', [(2, -1, 'minecraft:sand'), (2, 0, 'minecraft:cactus')], True), + ('berries', [(k, -1, 'minecraft:grass_block') for k in range(1, 4)] + + [(k, 0, 'minecraft:sweet_berry_bush[age=3]') for k in range(1, 4)], True), + ('young', [(k, -1, 'minecraft:grass_block') for k in range(1, 4)] + + [(k, 0, 'minecraft:sweet_berry_bush[age=0]') for k in range(1, 4)], True)): + game('command', command='effect give @s minecraft:instant_health 1 5 true') + game('command', command=f'fill {x - 1} {y - 2} {z - 1} {x + 4} {y - 1} {z + 1} minecraft:stone') + game('command', command=f'fill {x - 1} {y} {z - 1} {x + 4} {y + 2} {z + 1} minecraft:air') + # A wall ends the walk before the player leaves the floor. + game('command', command=f'fill {x + 5} {y - 1} {z - 1} {x + 5} {y + 2} {z + 1} minecraft:stone') + for dx, dy, block in blocks: + game('command', command=f'setblock {x + dx} {y + dy} {z} {block}') + stand = 0.5 if case == 'campfire' else 0.0 + game('command', command=f'tp @s {x + 0.5} {y + stand} {z + 0.5}') + game.raw('look-at', f'{x + 10:.2f}', f'{y + 1.6:.2f}', f'{z + 0.5:.2f}') + game.wait(30) + before = own(game)['health'] + keys = (['shift'] if case == 'sneaking' else []) + (['w'] if walk else []) + for k in keys: + game.raw('key', k, 'down') + game.wait(60) + for k in keys: + game.raw('key', k, 'up') + game.wait(10) + seen[f'{game.name}-{case}'] = (before, own(game)['health']) + game.shot(out, f'contacts-{case}') + host('command', command=f'fill {x - 1} {y} {z - 1} {x + 5} {y + 2} {z + 1} minecraft:air') + finally: + host('command', command='gamerule natural_health_regeneration true') + for case, (before, after) in seen.items(): + safe = case.endswith(('sneaking', 'young')) + assert (after == before) if safe else (after < before), f'{case}: {before} -> {after} (all: {seen})' + return seen + + def check_ladder(host, guest, out): """#1255: climbing down a ladder doesn't hurt where the guest lands.""" x, y, z = (int(v // 1) for v in pos_of(guest)) @@ -3075,7 +3134,8 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles, 'blast': check_blast, 'light': check_light, 'plates': check_plates, 'swings': check_swings, 'cracks': check_cracks, - 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder, 'boats': check_boats, 'minecarts': check_minecarts, 'frames': check_frames, 'lightning': check_lightning, 'riding': check_riding, 'mounts': check_mounts} + 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder, 'boats': check_boats, 'minecarts': check_minecarts, 'frames': check_frames, 'lightning': check_lightning, 'riding': check_riding, 'mounts': check_mounts, + 'contacts': check_contacts} def run(ctl, out, resources, checks): From 2898b40670eb253a924560d5edfe8c3a4256a725 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 04:58:56 +0200 Subject: [PATCH 096/126] Server players: an axe-disabled shield stays down 5 s, death forgets the digging ItemCooldowns ticks once a tick for each player: a server's players count their shield cooldown down in tick_guests, and the host's world in tick_world (it was in tick_using, which ran for the host and again for every guest's swap, so a guest's shield came back early on the server thread). A guest that dies stops digging (its mining, the delay and the crack go), so the block it was breaking doesn't break once it respawns. lan_e2e: `shield` (a vindicator's axe disables each player's shield; the server's cooldown then falls 40 in 40 ticks) and `deathmining` (die while breaking obsidian, respawn, the obsidian stays). `lan status` and the agent state report the shield cooldown. Fixes #1315, #1316. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game.rs | 5 +- crates/horizon-client/src/game/agent.rs | 1 + crates/horizon-client/src/game/lan.rs | 2 + crates/horizon-client/src/game/lan_actions.rs | 30 ++++ tools/lan_e2e.py | 133 +++++++++++++++++- 5 files changed, 167 insertions(+), 4 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 5da86dfaf..f15b6e9f6 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -3581,8 +3581,6 @@ impl Game<'_> { } } fn tick_using(&mut self) { - // ItemCooldowns.tick for the shield. - self.shield_cooldown = self.shield_cooldown.saturating_sub(1); let Some(hand) = self.used_hand() else { return; }; @@ -4285,6 +4283,9 @@ impl Game<'_> { fn tick_world(&mut self, running: bool) -> Result<()> { self.update_chunk_tickets(); horizon_client::spans::time("tick_effects", || self.tick_effects()); + // Player.tick's ItemCooldowns.tick for the window's player (a + // server's players count theirs down in `tick_guests`). + self.shield_cooldown = self.shield_cooldown.saturating_sub(1); horizon_client::spans::time("tick_using", || self.tick_using()); horizon_client::spans::time("tick_hud", || self.tick_hud()); // The player's digging comes in with its packets, before the level diff --git a/crates/horizon-client/src/game/agent.rs b/crates/horizon-client/src/game/agent.rs index ea686e711..f9a8e8c04 100644 --- a/crates/horizon-client/src/game/agent.rs +++ b/crates/horizon-client/src/game/agent.rs @@ -461,6 +461,7 @@ impl Game<'_> { "health": p.health.health(), "food": p.health.food.food, "saturation": p.health.food.saturation, + "shield_cooldown": self.shield_cooldown, "xp": { "level": self.experience.level, "progress": self.experience.progress, "total": self.experience.total }, "effects": self.potions.effects.list.iter().map(|e| json!({ "id": e.id, "duration_ticks": e.duration, "amplifier": e.amplifier })).collect::>(), }) diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index 4e05ea600..f09d2cc22 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -390,6 +390,8 @@ impl Game<'_> { "placed": g.placed, "loaded": g.loaded, "game_mode": g.game_mode, + // ItemCooldowns: the ticks the shield an axe disabled stays down. + "shield_cooldown": h.play.get(&g.conn).map_or(0, |p| p.shield_cooldown), "sneaking": g.sneaking, "sleeping": g.bed, "health": g.health, diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index 0d70b16f6..4cf5d0a0e 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -34,6 +34,8 @@ pub(super) struct GuestPlay { destroy_delay: u32, using: Option<(usize, u32)>, use_delay: u32, + /// The shield's ItemCooldowns entry: an axe disabled it for this many ticks. + pub(super) shield_cooldown: u32, attack_ticks: u32, /// The main hand's item at the guest's last tick (`Game::attack_item`). attack_item: Option>, @@ -117,6 +119,7 @@ pub(super) struct GuestSwap { destroy_delay: u32, using: Option<(usize, u32)>, use_delay: u32, + pub(super) shield_cooldown: u32, attack_ticks: u32, attack_item: Option>, swing: horizon_client::first_person::SwingState, @@ -290,6 +293,7 @@ impl Game<'_> { let destroy_delay = std::mem::replace(&mut self.destroy_delay, play.destroy_delay); let using = std::mem::replace(&mut self.using, play.using.take()); let use_delay = std::mem::replace(&mut self.use_delay, play.use_delay); + let shield_cooldown = std::mem::replace(&mut self.shield_cooldown, play.shield_cooldown); let attack_ticks = std::mem::replace(&mut self.attack_ticks, play.attack_ticks); let attack_item = std::mem::replace(&mut self.attack_item, play.attack_item.take()); let swing = std::mem::replace(&mut self.swing, play.swing); @@ -369,6 +373,7 @@ impl Game<'_> { destroy_delay, using, use_delay, + shield_cooldown, attack_ticks, attack_item, swing, @@ -421,6 +426,7 @@ impl Game<'_> { destroy_delay, using, use_delay, + shield_cooldown, attack_ticks, attack_item, swing, @@ -480,6 +486,7 @@ impl Game<'_> { play.destroy_delay = std::mem::replace(&mut self.destroy_delay, destroy_delay); play.using = std::mem::replace(&mut self.using, using); play.use_delay = std::mem::replace(&mut self.use_delay, use_delay); + play.shield_cooldown = std::mem::replace(&mut self.shield_cooldown, shield_cooldown); play.attack_ticks = std::mem::replace(&mut self.attack_ticks, attack_ticks); play.attack_item = std::mem::replace(&mut self.attack_item, attack_item); play.swing = std::mem::replace(&mut self.swing, swing); @@ -1562,6 +1569,9 @@ impl Game<'_> { continue; } let play = host.play.entry(conn).or_default(); + // Player.tick's ItemCooldowns.tick, once a tick for each player + // (the shield an axe disabled). + play.shield_cooldown = play.shield_cooldown.saturating_sub(1); let digging = play.digging; let using = play.using.is_some(); let delayed = play.destroy_delay > 0 || play.use_delay > 0 || play.attack_ticks < 100; @@ -1616,6 +1626,9 @@ impl Game<'_> { self.guest_dig_feedback(host, conn); self.guest_pickups(host, gi); self.guest_orbs(host, gi); + if host.hub.guests[gi].health <= 0.0 && !host.hub.guests[gi].dead { + self.guest_forget_digging(host, conn); + } let g = &mut host.hub.guests[gi]; if g.health <= 0.0 && !g.dead { g.dead = true; @@ -1968,6 +1981,23 @@ impl Game<'_> { /// `level.destroyBlockProgress(id, pos, -1)` for a guest: its crack on `pos` is gone, for the /// host and the other guests. + /// A player who dies digs and uses nothing any more: the block it was + /// breaking, or had left to break (`hasDelayedDestroy`), stays, and its + /// crack goes. Respawning gives it a new ServerPlayerGameMode (#1315). + fn guest_forget_digging(&mut self, host: &mut LanHost, conn: u32) { + let Some(play) = host.play.get_mut(&conn) else { + return; + }; + let cracked = play.digging.take().filter(|_| play.last_progress >= 0); + play.mining = None; + play.delayed = None; + play.destroy_delay = 0; + play.using = None; + play.last_progress = -1; + if let Some((pos, _)) = cracked { + self.guest_crack_gone(host, conn, pos); + } + } fn guest_crack_gone(&mut self, host: &mut LanHost, conn: u32, pos: [i32; 3]) { let Some(id) = host.hub.guest(conn).map(|g| g.entity_id) else { return; diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index c5a90150f..c68fbff7d 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -131,6 +131,10 @@ address. The script then checks, from both sides, what a guest's game used to ge get off by sneaking; the other side sees the animal move. - lightning: a bolt summoned beside the host, then the guest: both sides get the bolt and flash the sky (on its server thread the host's window is a client of it too). +- shield: the host axes the guest's raised shield, then the guest the host's: it stays disabled + for 5 s on that player's own cooldown, then blocks again (#1316). +- deathmining: the host and the guest each die while breaking obsidian and let go on the death + screen: once respawned, the obsidian stays (#1315). - flight: a player in creative double-taps jump and flies, stays up, and stops flying in survival: the guest, and on the server thread the host's window too, take what may fly from the server's abilities (ClientPacketListener.handlePlayerAbilities). @@ -172,7 +176,7 @@ ROOT = Path(__file__).resolve().parents[1] GUEST_NAME = 'Guest' # The host plays single player on its server thread (--server-thread). SERVER_THREAD = False -CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder', 'boats', 'minecarts', 'frames', 'lightning', 'riding', 'mounts'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder', 'boats', 'minecarts', 'frames', 'lightning', 'riding', 'mounts', 'shield', 'deathmining'] class Game: @@ -2297,6 +2301,130 @@ def check_flight(host, guest, out): +def own(game): + """The player's own state, as its client has it.""" + return game('state')['player'] + + +def server_player(host, game): + """The player's entry on the server: the guest's in the host's `lan status`, on the server + thread the host's too; the host's own world otherwise.""" + if game is host and not SERVER_THREAD: + return own(host) + name = GUEST_NAME if game is not host else host.player + return next(g for g in host.raw('lan', 'status')['guests'] if g['name'] == name) + + +def check_shield(host, guest, out): + """An axe disables a raised shield for 5 s (100 ticks), counted down once a tick on the + server: a vindicator's axe hits each player's shield, then the cooldown left falls by about 40 + over 40 ticks (#1316).""" + host('command', command='gamerule natural_health_regeneration false') + rates = {} + try: + for game, dz in ((host, -4), (guest, 4)): + x, y, z = (int(v // 1) for v in pos_of(host)) + z += dz + game('command', command='gamemode survival') + game('command', command='effect give @s minecraft:resistance 60 4 true') + game('command', command='effect give @s minecraft:instant_health 1 5 true') + game('command', command='item replace entity @s weapon.mainhand with minecraft:air') + game('command', command='item replace entity @s weapon.offhand with minecraft:shield') + game('command', command=f'fill {x - 1} {y} {z - 1} {x + 4} {y + 2} {z + 1} minecraft:air') + game('command', command=f'fill {x - 1} {y - 1} {z - 1} {x + 4} {y - 1} {z + 1} minecraft:stone') + game('command', command=f'tp @s {x + 0.5} {y} {z + 0.5}') + game.wait(10) + game.raw('look-at', f'{x + 2.5:.2f}', f'{y + 1.5:.2f}', f'{z + 0.5:.2f}') + game.raw('mouse', 'right', 'down') + game.wait(10) + host('command', command=f'summon minecraft:vindicator {x + 2.5} {y} {z + 0.5} ' + '{PersistenceRequired:1b,Rotation:[90f,0f]}') + host('command', command='item replace entity @e[type=minecraft:vindicator] weapon.mainhand ' + 'with minecraft:iron_axe') + first = None + for _ in range(60): + game.wait(5) + first = server_player(host, game).get('shield_cooldown', 0) + if first: + break + host('command', command='kill @e[type=minecraft:vindicator]') + game.raw('mouse', 'right', 'up') + assert first, f'{game.name}: the vindicator never disabled the shield' + start = server_player(host, game)['shield_cooldown'] + game.wait(40) + end = server_player(host, game)['shield_cooldown'] + rates[game.name] = {'first': first, 'start': start, 'end': end} + game.shot(out, 'shield') + game('command', command='item replace entity @s weapon.offhand with minecraft:air') + game('command', command='effect clear @s') + finally: + host('command', command='kill @e[type=minecraft:vindicator]') + host('command', command='gamerule natural_health_regeneration true') + for name, r in rates.items(): + assert r['first'] <= 100, f'{name}: {rates}' + # Once a tick: 40 down over 40 ticks, give or take the ticks the two queries straddle. + assert 30 <= r['start'] - r['end'] <= 50, f'{name}: {rates}' + return rates + + +def respawn_when_ready(game): + """Press Respawn once the death screen lets it (DeathScreen's 20-tick delay, counted from when + the screen opens).""" + for _ in range(20): + try: + return game.raw('respawn') + except Failed as e: + if 'not active yet' not in str(e): + raise + game.wait(10) + return game.raw('respawn') + + +def check_death_mining(host, guest, out): + """A player who dies while breaking obsidian, and lets go of attack on the death screen, doesn't + break it once respawned: death forgets the digging (#1315).""" + host('command', command='gamerule keep_inventory true') + hx, hy, hz = (int(v // 1) for v in pos_of(host)) + seen = {} + try: + for game, dz in ((host, -3), (guest, 3)): + x, y, z = hx + 2, hy, hz + dz + game('command', command='gamemode survival') + game('command', command='item replace entity @s weapon.mainhand with minecraft:diamond_pickaxe') + game('command', command=f'setblock {x + 2} {y} {z} minecraft:obsidian') + game('command', command=f'tp @s {x + 0.5} {y} {z + 0.5}') + game.wait(10) + game.raw('look-at', f'{x + 2.5:.2f}', f'{y + 0.5:.2f}', f'{z + 0.5:.2f}') + game.wait(5) + game.raw('mouse', 'left', 'down') + game.wait(10) + game('command', command='kill @s') + game.wait(10) + # The death screen lets go of the button (Minecraft.setScreen); let go again once back. + try: + game.raw('mouse', 'left', 'up') + except Failed: + pass + game.wait(10) + respawn_when_ready(game) + game.wait(2) + try: + game.raw('mouse', 'left', 'up') + except Failed: + pass + # Obsidian takes a diamond pickaxe about 190 ticks. + game.wait(240) + seen[game.name] = host.raw('block', x + 2, y, z).get('block') + game.shot(out, 'death-mining') + host('command', command=f'setblock {x + 2} {y} {z} minecraft:air') + game('command', command='item replace entity @s weapon.mainhand with minecraft:air') + finally: + host('command', command='gamerule keep_inventory false') + for name, block in seen.items(): + assert block == 'minecraft:obsidian', f'{name}: {seen}' + return seen + + def check_ladder(host, guest, out): """#1255: climbing down a ladder doesn't hurt where the guest lands.""" x, y, z = (int(v // 1) for v in pos_of(guest)) @@ -3075,7 +3203,8 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles, 'blast': check_blast, 'light': check_light, 'plates': check_plates, 'swings': check_swings, 'cracks': check_cracks, - 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder, 'boats': check_boats, 'minecarts': check_minecarts, 'frames': check_frames, 'lightning': check_lightning, 'riding': check_riding, 'mounts': check_mounts} + 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder, 'boats': check_boats, 'minecarts': check_minecarts, 'frames': check_frames, 'lightning': check_lightning, 'riding': check_riding, 'mounts': check_mounts, + 'shield': check_shield, 'deathmining': check_death_mining} def run(ctl, out, resources, checks): From 5c4600e4034ed5a5a0fc50c3d498dccbc8ab04cf Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 04:59:14 +0200 Subject: [PATCH 097/126] /setworldspawn moves the world spawn, not the player's respawn point SetWorldSpawnCommand sets the level's spawn and its angle; a player without a bed or anchor respawns there (it used to set the player's own spawn point, so other players and later deaths kept the old one). The angle is saved in level.dat's spawn (yaw, pitch), and a guest whose saved respawn point is the world spawn follows it when it moves. lan_e2e `worldspawn`: /setworldspawn 24 blocks east, then the host and the guest die and respawn there. Fixes #1310. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game/commands.rs | 14 +++++- crates/horizon-client/src/lan/playerdata.rs | 7 ++- crates/horizon-client/src/save.rs | 13 +++++- tools/lan_e2e.py | 50 ++++++++++++++++++++- 4 files changed, 78 insertions(+), 6 deletions(-) diff --git a/crates/horizon-client/src/game/commands.rs b/crates/horizon-client/src/game/commands.rs index f174f98c1..f35354f74 100644 --- a/crates/horizon-client/src/game/commands.rs +++ b/crates/horizon-client/src/game/commands.rs @@ -2322,7 +2322,19 @@ impl Game<'_> { Some(Arg::Coords(c)) => c.rotation(self.source_rotation()), _ => [0.0, 0.0], }; - self.level.spawn = Some([f64::from(pos[0]), f64::from(pos[1]), f64::from(pos[2])]); + // LevelData.setRespawnData: the world's spawn (level.dat `spawn`). + let old = self.level.world_spawn.replace(pos); + self.level.world_spawn_angle = rot; + // A player whose respawn point is the world spawn (no bed, anchor or + // spawnpoint of its own) respawns at the new one. + let floor = |s: Vec3| [s.x.floor() as i32, s.y.floor() as i32, s.z.floor() as i32]; + if self.respawn_config.is_none() && self.spawn.map(floor) == old { + self.spawn = Some(Vec3::new( + f64::from(pos[0]) + 0.5, + f64::from(pos[1]), + f64::from(pos[2]) + 0.5, + )); + } let args = [ Text::literal(pos[0].to_string()), Text::literal(pos[1].to_string()), diff --git a/crates/horizon-client/src/lan/playerdata.rs b/crates/horizon-client/src/lan/playerdata.rs index 8797f25a2..841f4da38 100644 --- a/crates/horizon-client/src/lan/playerdata.rs +++ b/crates/horizon-client/src/lan/playerdata.rs @@ -71,7 +71,12 @@ pub fn apply(guest: &mut Guest, level: &Level) { guest.game_mode = level.mode(); guest.flying = level.flying; guest.selected = (level.selected_slot.max(0) as usize).min(8); - guest.spawn = level.spawn.map(|s| [s[0] + 0.5, s[1], s[2] + 0.5]); + // A point that is the world spawn is none of the player's own: it + // respawns wherever the world spawn is then (`setworldspawn`). + guest.spawn = level + .spawn + .filter(|s| Some(s.map(|v| v.floor() as i32)) != level.world_spawn) + .map(|s| [s[0] + 0.5, s[1], s[2] + 0.5]); guest.saved = level.player_extra.clone(); guest.recipe_book = level.recipe_book.clone(); guest.dimension = match level.dimension.as_str() { diff --git a/crates/horizon-client/src/save.rs b/crates/horizon-client/src/save.rs index 0cfe3c585..8787415d9 100644 --- a/crates/horizon-client/src/save.rs +++ b/crates/horizon-client/src/save.rs @@ -2288,6 +2288,8 @@ pub struct Level { pub dimension: String, /// World spawn (`level.dat` `spawn`), distinct from a bed respawn point. pub world_spawn: Option<[i32; 3]>, + /// The world spawn's yaw and pitch (`setworldspawn`'s rotation). + pub world_spawn_angle: [f32; 2], pub difficulty: String, pub hardcore: bool, /// `difficulty_settings.locked` (LevelData.isDifficultyLocked). @@ -2365,6 +2367,11 @@ impl Level { ] }), }; + let angle = |k: &str| match data.get("spawn").and_then(|s| s.get(k)) { + Some(Tag::Float(b)) => f32::from_bits(*b), + _ => 0.0, + }; + level.world_spawn_angle = [angle("yaw"), angle("pitch")]; if let Some(d) = data.get("difficulty_settings") { level.difficulty = text(d.get("difficulty")).unwrap_or_else(|| "normal".into()); level.hardcore = n(d.get("hardcore")) != 0; @@ -2857,8 +2864,8 @@ impl Level { Tag::compound([ ("pos", Tag::IntArray(spawn.to_vec())), ("dimension", string("minecraft:overworld")), - ("yaw", Tag::Float(0f32.to_bits())), - ("pitch", Tag::Float(0f32.to_bits())), + ("yaw", Tag::Float(self.world_spawn_angle[0].to_bits())), + ("pitch", Tag::Float(self.world_spawn_angle[1].to_bits())), ]), ), ("difficulty_settings", difficulty), @@ -4126,6 +4133,7 @@ mod tests { xp_total: 30, dimension: "minecraft:the_nether".into(), world_spawn: Some([8, 64, 8]), + world_spawn_angle: [45.0, -10.0], spawn: Some([20.0, 70.0, 20.0]), difficulty_locked: true, flying: true, @@ -4160,6 +4168,7 @@ mod tests { ); assert_eq!(back.dimension, "minecraft:the_nether"); assert_eq!(back.world_spawn, Some([8, 64, 8])); + assert_eq!(back.world_spawn_angle, [45.0, -10.0]); assert_eq!(back.spawn, Some([20.0, 70.0, 20.0])); assert!(back.difficulty_locked); assert!(back.weather.raining); diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index c5a90150f..6f416306b 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -131,6 +131,8 @@ address. The script then checks, from both sides, what a guest's game used to ge get off by sneaking; the other side sees the animal move. - lightning: a bolt summoned beside the host, then the guest: both sides get the bolt and flash the sky (on its server thread the host's window is a client of it too). +- worldspawn: the host moves the world spawn (`setworldspawn`): the host and the guest, with no bed, + respawn there (#1310). - flight: a player in creative double-taps jump and flies, stays up, and stops flying in survival: the guest, and on the server thread the host's window too, take what may fly from the server's abilities (ClientPacketListener.handlePlayerAbilities). @@ -172,7 +174,7 @@ ROOT = Path(__file__).resolve().parents[1] GUEST_NAME = 'Guest' # The host plays single player on its server thread (--server-thread). SERVER_THREAD = False -CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder', 'boats', 'minecarts', 'frames', 'lightning', 'riding', 'mounts'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder', 'boats', 'minecarts', 'frames', 'lightning', 'riding', 'mounts', 'worldspawn'] class Game: @@ -2297,6 +2299,49 @@ def check_flight(host, guest, out): +def respawn_when_ready(game): + """Press Respawn once the death screen lets it (DeathScreen's 20-tick delay, counted from when + the screen opens).""" + for _ in range(20): + try: + return game.raw('respawn') + except Failed as e: + if 'not active yet' not in str(e): + raise + game.wait(10) + return game.raw('respawn') + + +def check_world_spawn(host, guest, out): + """`setworldspawn` moves the world spawn: the host and the guest, with no bed of their own, + respawn there once killed (#1310).""" + hx, hy, hz = (int(v // 1) for v in pos_of(host)) + sx, sz = hx + 24, hz + host('command', command='gamerule respawn_radius 0') + host('command', command=f'fill {sx - 2} {hy - 1} {sz - 2} {sx + 2} {hy - 1} {sz + 2} minecraft:stone') + host('command', command=f'fill {sx - 2} {hy} {sz - 2} {sx + 2} {hy + 3} {sz + 2} minecraft:air') + seen = {} + try: + host('command', command=f'setworldspawn {sx} {hy} {sz}') + for game in (host, guest): + game('command', command='gamemode survival') + game('command', command='kill @s') + game.wait(20) + respawn_when_ready(game) + game.wait(60) + seen[game.name] = [round(v, 2) for v in pos_of(game)] + game.shot(out, 'world-spawn') + finally: + host('command', command=f'setworldspawn {hx} {hy} {hz}') + host('command', command='gamerule respawn_radius 10') + for game in (host, guest): + game('command', command=f'tp @s {hx + 0.5} {hy} {hz + 0.5}') + guest.wait(20) + for name, at in seen.items(): + assert abs(at[0] - (sx + 0.5)) < 1 and abs(at[2] - (sz + 0.5)) < 1, f'{name}: {seen}, spawn {sx} {sz}' + return seen + + def check_ladder(host, guest, out): """#1255: climbing down a ladder doesn't hurt where the guest lands.""" x, y, z = (int(v // 1) for v in pos_of(guest)) @@ -3075,7 +3120,8 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles, 'blast': check_blast, 'light': check_light, 'plates': check_plates, 'swings': check_swings, 'cracks': check_cracks, - 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder, 'boats': check_boats, 'minecarts': check_minecarts, 'frames': check_frames, 'lightning': check_lightning, 'riding': check_riding, 'mounts': check_mounts} + 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder, 'boats': check_boats, 'minecarts': check_minecarts, 'frames': check_frames, 'lightning': check_lightning, 'riding': check_riding, 'mounts': check_mounts, + 'worldspawn': check_world_spawn} def run(ctl, out, resources, checks): From 65bd2d0d45e15710af70cad00f642ae80f48b86e Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 04:59:19 +0200 Subject: [PATCH 098/126] Items push out of blocks; a server's client digs at the server's speed ItemEntity.tick: an item stuck inside a full block (one set on it) has no physics on the server and moves toward the closest free side (Entity.moveTowardsClosestSpace: north, south, west, east, up; 0.1 to 0.3 a tick), instead of staying in the block (#1252). A server's client (LAN guests, and the window on the server thread) digs at the same speed as the server: getDestroyProgress with the submerged mining speed, haste, fatigue and efficiency, not the plain tool speed, so it no longer finishes early under water and gets the block put back (#1254). lan_e2e: `drops` (a diamond under a block set on it comes out, in both views) and `underwater` (dirt by hand at eye height under water: about halfway at 35 ticks on client and server, broken by 105). Fixes #1252, #1254. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/entities.rs | 78 ++++++++++++++++++++++-- crates/horizon-client/src/game.rs | 9 ++- crates/horizon-client/src/game/agent.rs | 2 + crates/horizon-client/src/game/remote.rs | 19 ++---- tests/test_remote_mining.py | 4 ++ tools/lan_e2e.py | 77 ++++++++++++++++++++++- 6 files changed, 167 insertions(+), 22 deletions(-) diff --git a/crates/horizon-client/src/entities.rs b/crates/horizon-client/src/entities.rs index cfbdb0636..65536d710 100644 --- a/crates/horizon-client/src/entities.rs +++ b/crates/horizon-client/src/entities.rs @@ -98,12 +98,73 @@ impl ItemEntity { lava_hurt, } } - /// Returns false when the item should be removed. + /// `ItemEntity.tick` on a server: an item whose box is inside a block + /// (one placed where it lay) has no physics this tick + /// (`level.noCollision(box.deflate(1.0E-7))`). + pub fn inside_block(&self, world: &World, collision: &BlockCollisionRegistry<'_>) -> bool { + let mut scene = SceneCollisions { + world, + binding: collision, + subject: None, + }; + let inner = self.bounds().deflate(Vec3::new(1.0e-7, 1.0e-7, 1.0e-7)); + !crate::collisions::no_collision_empty(&mut scene, inner) + } + /// `Entity.moveTowardsClosestSpace` from the middle of the item's box: + /// towards the nearest side of its block (north, south, west, east or + /// up) without a full collision cube, at `speed` (`nextFloat() * 0.2 + + /// 0.1`). + pub fn move_towards_closest_space(&mut self, world: &World, facts: &BlockFacts, speed: f32) { + let bounds = self.bounds(); + let at = Vec3::new( + self.position.x, + (bounds.min_position().y + bounds.max_position().y) / 2.0, + self.position.z, + ); + let pos = [ + at.x.floor() as i32, + at.y.floor() as i32, + at.z.floor() as i32, + ]; + let delta = [ + at.x - f64::from(pos[0]), + at.y - f64::from(pos[1]), + at.z - f64::from(pos[2]), + ]; + // (axis, step): NORTH, SOUTH, WEST, EAST, UP. + let mut closest = (1, 1); + let mut nearest = f64::MAX; + for (axis, step) in [(2, -1), (2, 1), (0, -1), (0, 1), (1, 1)] { + let mut n = pos; + n[axis] += step; + if !facts.get(world.block(n[0], n[1], n[2])).full_collision { + let d = if step > 0 { + 1.0 - delta[axis] + } else { + delta[axis] + }; + if d < nearest { + nearest = d; + closest = (axis, step); + } + } + } + let push = f64::from(closest.1 as f32 * speed); + let v = self.velocity.scale(0.75); + self.velocity = match closest.0 { + 0 => Vec3::new(push, v.y, v.z), + 1 => Vec3::new(v.x, push, v.z), + _ => Vec3::new(v.x, v.y, push), + }; + } + /// Returns false when the item should be removed. `no_physics`: the item + /// moves through blocks this tick ([`ItemEntity::inside_block`]). pub fn tick( &mut self, world: &World, facts: &BlockFacts, collision: &BlockCollisionRegistry<'_>, + no_physics: bool, ) -> bool { self.ticks += 1; self.previous = self.position; @@ -140,15 +201,22 @@ impl ItemEntity { subject: None, }; let wanted = self.velocity; - let moved = scene - .resolve(self.bounds(), wanted, 0.0, self.on_ground) - .unwrap_or(Vec3::ZERO); + // Entity.move with noPhysics: straight through, the ground as it was. + let moved = if no_physics { + wanted + } else { + scene + .resolve(self.bounds(), wanted, 0.0, self.on_ground) + .unwrap_or(Vec3::ZERO) + }; self.position = Vec3::new( self.position.x + moved.x, self.position.y + moved.y, self.position.z + moved.z, ); - self.on_ground = wanted.y < 0.0 && moved.y != wanted.y; + if !no_physics { + self.on_ground = wanted.y < 0.0 && moved.y != wanted.y; + } if moved.x != wanted.x { self.velocity.x = 0.0; } diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 5da86dfaf..0b1ca23fd 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -2101,7 +2101,14 @@ impl Game<'_> { ) { continue; } - let alive = item.tick(&self.world, self.res.facts(), self.collision); + // ItemEntity.tick's noPhysics (servers only): out of a block + // placed on it, towards the closest open side (#1252). + let no_physics = merging && item.inside_block(&self.world, self.collision); + if no_physics { + let speed = self.world.random.next_float() * 0.2 + 0.1; + item.move_towards_closest_space(&self.world, self.res.facts(), speed); + } + let alive = item.tick(&self.world, self.res.facts(), self.collision, no_physics); cells.moved(i, item.previous, item.position); // ItemEntity.tick: merge every 2 ticks while moving between // blocks, every 40 otherwise, before the lifetime check. diff --git a/crates/horizon-client/src/game/agent.rs b/crates/horizon-client/src/game/agent.rs index ea686e711..15564dc3e 100644 --- a/crates/horizon-client/src/game/agent.rs +++ b/crates/horizon-client/src/game/agent.rs @@ -478,6 +478,8 @@ impl Game<'_> { "sleeping": self.sleeping, // The item in use: its slot and for how many ticks. "using": self.using.map(|(slot, ticks)| json!({ "slot": slot, "ticks": ticks })), + // The block being dug: how far along, after how many ticks. + "mining": self.mining.as_ref().map(|m| json!({ "pos": m.pos, "progress": m.progress, "ticks": m.ticks })), // The arm swings started (LivingEntity.swing). "swings": self.swings_started, "time": { "day_time": self.world.day_time, "day": self.world.day_time.div_euclid(24000), "time_of_day": self.world.day_time.rem_euclid(24000) }, diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 5461a4cd0..563ab4170 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -3469,22 +3469,13 @@ impl Game<'_> { return; } let facts = self.res.facts().get(state).clone(); - let held = self.held().cloned(); - let mut speed = self.res.items().mining_speed(held.as_ref(), &facts.name); - if self.player.as_ref().is_some_and(|p| !p.ground.on_ground) { - speed /= 5.0; - } - let harvest = !facts.requires_tool - || self - .res - .items() - .correct_for_drops(held.as_ref(), &facts.name); - let progress = if facts.hardness < 0.0 { - 0.0 - } else if facts.hardness == 0.0 { + // The server's own getDestroyProgress: under water, off the ground, + // with haste, fatigue and efficiency, so the client stops digging + // when the server is done too (#1254). + let progress = if facts.hardness == 0.0 { 1.0 } else { - speed / facts.hardness / if harvest { 30.0 } else { 100.0 } + self.destroy_progress(hit.pos) }; let same = self .remote diff --git a/tests/test_remote_mining.py b/tests/test_remote_mining.py index 236b85c28..1a35b3865 100644 --- a/tests/test_remote_mining.py +++ b/tests/test_remote_mining.py @@ -79,6 +79,10 @@ impl Game { } fn pick(&self) -> Option { Some(self.hit) } fn held(&self) -> Option<&()> { None } + // Game::destroy_progress (hand.rs) for a harvestable block on the ground. + fn destroy_progress(&self, _: [i32; 3]) -> f32 { + self.res.speed / self.res.facts.hardness / 30.0 + } fn next_sequence(&mut self) -> i32 { self.sequence += 1; self.sequence } fn predict_break(&mut self, pos: [i32; 3], _: u32, _: i32) { self.world.broken.push(pos); } fn send(&mut self, S::PlayerAction(packet): S) { self.packets.push(packet); } diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index c5a90150f..6bdc52905 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -131,6 +131,10 @@ address. The script then checks, from both sides, what a guest's game used to ge get off by sneaking; the other side sees the animal move. - lightning: a bolt summoned beside the host, then the guest: both sides get the bolt and flash the sky (on its server thread the host's window is a client of it too). +- drops: an item lies where the host, then the guest, places a block: it comes out of the block + on the server, and both sides see it outside (#1252). +- underwater: the host and the guest each dig dirt by hand standing under water: five times slower + than in the air on their own client as on the server, and it breaks (#1254). - flight: a player in creative double-taps jump and flies, stays up, and stops flying in survival: the guest, and on the server thread the host's window too, take what may fly from the server's abilities (ClientPacketListener.handlePlayerAbilities). @@ -172,7 +176,7 @@ ROOT = Path(__file__).resolve().parents[1] GUEST_NAME = 'Guest' # The host plays single player on its server thread (--server-thread). SERVER_THREAD = False -CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder', 'boats', 'minecarts', 'frames', 'lightning', 'riding', 'mounts'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'arrows', 'kills', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'loom', 'stonecutter', 'grindstone', 'anvil', 'smithing', 'enchanting', 'beacon', 'crafter', 'lectern', 'cartography', 'trials', 'clicks', 'sleep', 'predict', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'worn', 'blast', 'barter', 'deflect', 'fireball', 'light', 'time', 'swings', 'cracks', 'plates', 'effects', 'portals', 'distance', 'growth', 'flight', 'ladder', 'boats', 'minecarts', 'frames', 'lightning', 'riding', 'mounts', 'drops', 'underwater'] class Game: @@ -2297,6 +2301,74 @@ def check_flight(host, guest, out): +def check_drops(host, guest, out): + """A dropped item lying where a block is then placed comes out of it (#1252): the server moves + it towards the closest open side (ItemEntity.tick's noPhysics, Entity.moveTowardsClosestSpace), + and both sides see it outside the block. The host places one, then the guest.""" + hx, hy, hz = (int(v // 1) for v in pos_of(host)) + seen = {} + for game, dz in ((host, -3), (guest, 3)): + x, y, z = hx + 3, hy, hz + dz + game('command', command=f'fill {x - 1} {y} {z - 1} {x + 1} {y + 2} {z + 1} minecraft:air') + game('command', command=f'summon minecraft:item {x + 0.5} {y} {z + 0.5} ' + '{Item:{id:"minecraft:diamond",count:1},PickupDelay:32767}') + game.wait(20) + game('command', command=f'setblock {x} {y} {z} minecraft:stone') + game.wait(60) + for viewer in (host, guest): + near = [e['pos'] for e in viewer.raw('entities', 24, 'minecraft:item')['entities'] + if abs(e['pos'][0] - x - 0.5) < 2 and abs(e['pos'][2] - z - 0.5) < 2] + seen[f'{game.name} places, {viewer.name} sees'] = ([x, y, z], near) + game.shot(out, 'drops') + host('command', command='kill @e[type=minecraft:item]') + host('command', command=f'setblock {x} {y} {z} minecraft:air') + for name, (block, near) in seen.items(): + inside = [p for p in near if all(block[i] <= p[i] < block[i] + 1 for i in range(3))] + assert near and not inside, f'{name}: items {near} in block {block} (all: {seen})' + return seen + + +def check_underwater(host, guest, out): + """Digging dirt by hand underwater, standing on the bottom of a pool: five times slower than in + the air (SUBMERGED_MINING_SPEED), on the player's own client as on the server. Halfway through + the client is about halfway (it doesn't break the block early, which the server would put + back), and the block breaks (#1254). The dirt is at eye height, the player's head under water. + The host, then the guest.""" + hx, hy, hz = (int(v // 1) for v in pos_of(host)) + seen = {} + for game, dz in ((host, -4), (guest, 4)): + x, y, z = hx + 3, hy, hz + dz + game('command', command='gamemode survival') + game('command', command='item replace entity @s weapon.mainhand with minecraft:air') + game('command', command=f'fill {x - 1} {y - 1} {z - 1} {x + 2} {y + 3} {z + 1} minecraft:stone') + game('command', command=f'fill {x} {y} {z} {x} {y + 2} {z} minecraft:water') + game('command', command=f'setblock {x + 1} {y + 1} {z} minecraft:dirt') + game('command', command=f'tp @s {x + 0.5} {y} {z + 0.5}') + game.wait(40) + game.raw('look-at', f'{x + 1.5:.2f}', f'{y + 1.5:.2f}', f'{z + 0.5:.2f}') + game.wait(5) + game.raw('mouse', 'left', 'down') + # Dirt by hand: 15 ticks in the air, 75 under water. + game.wait(35) + halfway = {'mining': game('state').get('mining'), 'client': game.raw('block', x + 1, y + 1, z).get('block'), + 'server': host.raw('block', x + 1, y + 1, z).get('block'), 'y': y + 1} + game.wait(70) + game.raw('mouse', 'left', 'up') + game.wait(10) + done = host.raw('block', x + 1, y + 1, z).get('block') + game.shot(out, 'underwater') + seen[game.name] = {'halfway': halfway, 'done': done} + host('command', command=f'fill {x - 1} {y - 1} {z - 1} {x + 2} {y + 3} {z + 1} minecraft:air') + host('command', command=f'fill {x - 1} {y - 1} {z - 1} {x + 2} {y - 1} {z + 1} minecraft:stone') + for name, s in seen.items(): + h = s['halfway'] + assert h['client'] == 'minecraft:dirt' == h['server'], f'{name} broke it early: {seen}' + assert h['mining'] and h['mining']['pos'][1] == h['y'] and 0.3 < h['mining']['progress'] < 0.7, f'{name} digs at the wrong speed: {seen}' + # Broken: air, or the pool's water flowing in. + assert s['done'] in ('minecraft:air', 'minecraft:water'), f'{name} never broke it: {seen}' + return seen + + def check_ladder(host, guest, out): """#1255: climbing down a ladder doesn't hurt where the guest lands.""" x, y, z = (int(v // 1) for v in pos_of(guest)) @@ -3075,7 +3147,8 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles, 'blast': check_blast, 'light': check_light, 'plates': check_plates, 'swings': check_swings, 'cracks': check_cracks, - 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder, 'boats': check_boats, 'minecarts': check_minecarts, 'frames': check_frames, 'lightning': check_lightning, 'riding': check_riding, 'mounts': check_mounts} + 'time': check_time, 'growth': check_growth, 'flight': check_flight, 'fireball': check_fireball, 'deflect': check_deflect, 'barter': check_barter, 'worn': check_worn, 'kills': check_kills, 'arrows': check_arrows, 'predict': check_predict, 'ladder': check_ladder, 'boats': check_boats, 'minecarts': check_minecarts, 'frames': check_frames, 'lightning': check_lightning, 'riding': check_riding, 'mounts': check_mounts, + 'drops': check_drops, 'underwater': check_underwater} def run(ctl, out, resources, checks): From feeefb3a33db6cc33c0798f535d9bdc0e7aeb306 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 05:38:46 +0200 Subject: [PATCH 099/126] Mobs: a punch shows smooth and slow, as on vanilla's client The server sends a knocked-back, pushed or jumping mob's move at once (Entity.needsSync), and the remote client walks every living entity along the server's positions with vanilla's SteppedInterpolationHandler: each position takes the type's update interval to reach, sped up while steps pile up. Before, the client waited for the next due update and then lerped there in fewer ticks, so a hit pig jumped away fast. tools/test_stepped_interpolation_parity.py drives vanilla's unmodified InterpolationData and the Rust port with the same packets and ticks (random cases and a punched pig's knockback); 135236 positions and rotations match bit for bit. Fixes #1374 Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game/dragon.rs | 1 + crates/horizon-client/src/game/lan.rs | 5 + .../horizon-client/src/game/lan_entities.rs | 1 + crates/horizon-client/src/game/remote.rs | 144 ++++++-- crates/horizon-client/src/lan/entity.rs | 39 +- crates/horizon-client/src/lan/hub.rs | 1 + crates/horizon-client/src/mobs.rs | 7 + crates/horizon-client/src/mobs/living.rs | 3 + crates/horizon-client/tests/lan_bot.rs | 1 + .../examples/stepped_interpolation_fixture.rs | 93 +++++ crates/horizon-world/src/lib.rs | 1 + .../src/stepped_interpolation.rs | 341 ++++++++++++++++++ .../VanillaSteppedInterpolationOracle.java | 148 ++++++++ tools/test_stepped_interpolation_parity.py | 103 ++++++ 14 files changed, 858 insertions(+), 30 deletions(-) create mode 100644 crates/horizon-world/examples/stepped_interpolation_fixture.rs create mode 100644 crates/horizon-world/src/stepped_interpolation.rs create mode 100644 mods/horizon/src/test/java/dev/horizonlab/parity/VanillaSteppedInterpolationOracle.java create mode 100644 tools/test_stepped_interpolation_parity.py diff --git a/crates/horizon-client/src/game/dragon.rs b/crates/horizon-client/src/game/dragon.rs index 222e59229..6dd02893d 100644 --- a/crates/horizon-client/src/game/dragon.rs +++ b/crates/horizon-client/src/game/dragon.rs @@ -2700,6 +2700,7 @@ impl Game<'_> { equipment: Vec::new(), attributes: Vec::new(), precise: false, + needs_sync: false, }) } } diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index 4e05ea600..e2c218a34 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -760,6 +760,7 @@ impl Game<'_> { (e.yaw, e.pitch, e.head_yaw) = (m.yaw, m.head_pitch, m.head_yaw); e.on_ground = m.on_ground; e.velocity = [m.velocity.x, m.velocity.y, m.velocity.z]; + e.needs_sync = m.needs_sync; mob_meta(m, hub, &mut e.meta); mob_equipment(m, hub, &mut e.equipment); self.mob_attributes(m, &mut e.attributes); @@ -828,6 +829,10 @@ impl Game<'_> { } else { states.clear(); } + // ServerEntity.sendChanges clears needsSync once it has looked. + for m in &mut self.mobs { + m.needs_sync = false; + } let entities = states.as_slice(); let spawn = self.spawn.map_or([0.5, 80.0, 0.5], |s| [s.x, s.y, s.z]); let events = { diff --git a/crates/horizon-client/src/game/lan_entities.rs b/crates/horizon-client/src/game/lan_entities.rs index 5f46f7c21..631498edd 100644 --- a/crates/horizon-client/src/game/lan_entities.rs +++ b/crates/horizon-client/src/game/lan_entities.rs @@ -39,6 +39,7 @@ fn state(id: u32, kind: &str, position: [f64; 3], yaw: f32, on_ground: bool) -> equipment: Vec::new(), attributes: Vec::new(), precise: false, + needs_sync: false, } } diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 5461a4cd0..454773e38 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -40,7 +40,11 @@ use horizon_protocol::{ registry::{Builtin, DimensionType, Dynamic, ceil_log2}, text::{Language, format_java, plain}, }; -use horizon_world::{nbt::Tag, registry::BlockStateId}; +use horizon_world::{ + nbt::Tag, + registry::BlockStateId, + stepped_interpolation::{Path, PosRot, Start, SteppedInterpolation}, +}; use std::{ collections::{HashMap, VecDeque}, sync::Arc, @@ -85,6 +89,15 @@ struct Lerp { steps: u32, } +/// `SteppedInterpolationHandler.doInterpolate`'s `setPos` and `setRot` on a +/// mob: its yaw kept continuous (the same turn as vanilla's, without the +/// wrap that would spin it in the frame between ticks), its pitch clamped. +fn place_interpolated(m: &mut Mob, at: PosRot) { + m.position = Vec3::new(at.position[0], at.position[1], at.position[2]); + m.yaw += wrap_degrees(at.yaw - m.yaw); + m.head_pitch = (at.pitch % 360.0).clamp(-90.0, 90.0); +} + pub(super) struct Remote { pub session: Session, pub brand: String, @@ -123,6 +136,8 @@ pub(super) struct Remote { use_target: Option<[i32; 3]>, entities: HashMap, lerps: HashMap, + /// Living entities' `SteppedInterpolationHandler`s. + stepped: HashMap, /// `LivingEntity.lerpHeadTo`: the head yaw and the ticks left to reach it. head_lerps: HashMap, /// Item entities waiting for their item data. @@ -380,6 +395,7 @@ impl Game<'_> { use_target: None, entities: HashMap::new(), lerps: HashMap::new(), + stepped: HashMap::new(), head_lerps: HashMap::new(), pending_items: HashMap::new(), health: (20.0, 20, 5.0), @@ -931,6 +947,7 @@ impl Game<'_> { if let Some(r) = self.remote.as_mut() { r.entities.clear(); r.lerps.clear(); + r.stepped.clear(); r.head_lerps.clear(); r.pending_items.clear(); // A new ClientLevel: a new chunk storage, centred on 0, 0. @@ -1322,6 +1339,9 @@ impl Game<'_> { mob.persistent = true; self.mobs.retain(|m| m.id != id as u32); self.mobs.push(mob); + if let Some(r) = self.remote.as_mut() { + r.stepped.remove(&id); + } } if let Some(r) = self.remote.as_mut() { if kind == "minecraft:item" { @@ -1336,23 +1356,77 @@ impl Game<'_> { ); } } + /// A move packet for entity `id`: to the end of `path` (None: a + /// rotation alone), turned to `rotation` if it has one. `far_snaps`: + /// an `EntityPositionSync`, which puts an entity more than 64 blocks + /// away there at once. fn move_entity( &mut self, id: i32, - position: [f64; 3], + path: Option, rotation: Option<(f32, f32)>, on_ground: bool, + far_snaps: bool, ) { let mob = self.mobs.iter_mut().find(|m| m.id == id as u32); + let tracked = self + .remote + .as_ref() + .and_then(|r| r.entities.get(&id)) + .map(|t| t.position); + let position = path + .as_ref() + .map(Path::end) + .or(tracked) + .or_else(|| { + mob.as_ref() + .map(|m| [m.position.x, m.position.y, m.position.z]) + }) + .unwrap_or([0.0; 3]); if let Some(r) = self.remote.as_mut() { if let Some(t) = r.entities.get_mut(&id) { t.position = position; } + if let Some(m) = mob { + // A living entity: LivingEntity.createInterpolationHandler's + // SteppedInterpolationHandler, over its type's update interval. + let entity = PosRot { + position: [m.position.x, m.position.y, m.position.z], + yaw: m.yaw, + pitch: m.head_pitch, + }; + let far = far_snaps && { + let d = [0, 1, 2].map(|i| position[i] - entity.position[i]); + d[0] * d[0] + d[1] * d[1] + d[2] * d[2] > 4096.0 + }; + let handler = r.stepped.entry(id).or_insert_with(|| { + let interval = horizon_client::lan::tracking::settings(&m.kind.id).1; + SteppedInterpolation::new(interval as i32) + }); + let snap = if far { + handler.cancel(); + let (yaw, pitch) = rotation.unwrap_or((m.yaw, m.head_pitch)); + Some(PosRot { + position, + yaw, + pitch, + }) + } else { + match handler.interpolate_to(entity, path, rotation) { + Start::Snap(at) => Some(at), + Start::Interpolating | Start::Unchanged => None, + } + }; + if let Some(at) = snap { + place_interpolated(m, at); + m.previous = m.position; + } + m.on_ground = on_ground; + return; + } // AbstractInterpolationHandler.interpolateTo: without a rotation, - // the one it was heading for (or has). - let rotation = rotation - .or_else(|| r.lerps.get(&id).and_then(|l| l.rotation)) - .or_else(|| mob.as_ref().map(|m| (m.yaw, m.head_pitch))); + // the one it was heading for. + let rotation = rotation.or_else(|| r.lerps.get(&id).and_then(|l| l.rotation)); r.lerps.insert( id, Lerp { @@ -1365,9 +1439,6 @@ impl Game<'_> { *p = position; } } - if let Some(m) = mob { - m.on_ground = on_ground; - } self.turn_remote_object(id, rotation.map(|(yaw, _)| yaw), on_ground); self.turn_remote_projectile(id, rotation); } @@ -1384,6 +1455,7 @@ impl Game<'_> { if let Some(r) = self.remote.as_mut() { r.entities.remove(&id); r.lerps.remove(&id); + r.stepped.remove(&id); r.head_lerps.remove(&id); r.pending_items.remove(&id); } @@ -1743,17 +1815,36 @@ impl Game<'_> { .and_then(|r| r.entities.get(&m.id)) .map(|t| t.position); let Some(base) = base else { return Ok(()) }; - let position = m.delta.as_ref().map_or(base, |d| d.end(base)); + // VecDeltaCodec.decode: each step's position from the last. + let path = m.delta.as_ref().map(|d| match d { + play::VecDelta::Linear(_) => Path::Linear(d.end(base)), + play::VecDelta::Stepped(steps) => { + let mut at = base; + Path::Stepped( + steps + .iter() + .map(|(delta, ticks)| { + at = play::VecDelta::apply(at, *delta); + (at, *ticks) + }) + .collect(), + ) + } + }); let rotation = m.rotation.map(|(y, x)| { ( horizon_protocol::buf::unpack_degrees(y), horizon_protocol::buf::unpack_degrees(x), ) }); - self.move_entity(m.id, position, rotation, m.on_ground); + self.move_entity(m.id, path, rotation, m.on_ground, false); } C::EntityPositionSync(p) => { - self.move_entity(p.id, p.path.end(), Some((p.yaw, p.pitch)), p.on_ground) + let path = match p.path { + play::PositionPath::Linear(at) => Path::Linear(at), + play::PositionPath::Stepped(steps) => Path::Stepped(steps), + }; + self.move_entity(p.id, Some(path), Some((p.yaw, p.pitch)), p.on_ground, true) } C::TeleportEntity(p) => { let base = self @@ -1773,7 +1864,13 @@ impl Game<'_> { rel(play::relative::Y, 1), rel(play::relative::Z, 2), ]; - self.move_entity(p.id, position, Some((p.yaw, p.pitch)), p.on_ground); + self.move_entity( + p.id, + Some(Path::Linear(position)), + Some((p.yaw, p.pitch)), + p.on_ground, + false, + ); } C::SetPassengers(p) => self.remote_set_passengers(p.vehicle, &p.passengers), C::MoveVehicle(p) => self.remote_move_vehicle(p.position, p.yaw), @@ -3149,6 +3246,7 @@ impl Game<'_> { return; }; let mut lerps = std::mem::take(&mut r.lerps); + let stepped = &mut r.stepped; let head_lerps = &mut r.head_lerps; let players = &r.level_players; let mut using = Vec::new(); @@ -3179,22 +3277,12 @@ impl Game<'_> { // LivingEntity.updateSwingTime. m.anim.attack_anim_o = m.anim.attack_anim; horizon_client::mobs::ai::tick_swing(m); - // Entity.commonTick: LinearInterpolationHandler.interpolate. - if let Some(l) = lerps.get_mut(&(m.id as i32)) - && l.steps > 0 + // Entity.tick: the SteppedInterpolationHandler's step. + if let Some(at) = stepped + .get_mut(&(m.id as i32)) + .and_then(|h| h.interpolate()) { - let n = f64::from(l.steps); - m.position = Vec3::new( - m.position.x + (l.target[0] - m.position.x) / n, - m.position.y + (l.target[1] - m.position.y) / n, - m.position.z + (l.target[2] - m.position.z) / n, - ); - if let Some((yaw, pitch)) = l.rotation { - let alpha = 1.0 / l.steps as f32; - m.yaw += wrap_degrees(yaw - m.yaw) * alpha; - m.head_pitch += (pitch - m.head_pitch) * alpha; - } - l.steps -= 1; + place_interpolated(m, at); } // LivingEntity.aiStep: the head's own interpolation. if let Some((yaw, steps)) = head_lerps.get_mut(&(m.id as i32)) diff --git a/crates/horizon-client/src/lan/entity.rs b/crates/horizon-client/src/lan/entity.rs index c4e8052c0..86fea8b65 100644 --- a/crates/horizon-client/src/lan/entity.rs +++ b/crates/horizon-client/src/lan/entity.rs @@ -59,6 +59,8 @@ pub struct EntityState { /// `Entity.getRequiresPrecisePosition` (primed TNT and falling blocks /// touching a block): moves are sent as full position syncs. pub precise: bool, + /// `Entity.needsSync`: send its changes this tick, due or not. + pub needs_sync: bool, } impl EntityState { @@ -79,6 +81,7 @@ impl EntityState { self.equipment.clear(); self.attributes.clear(); self.precise = false; + self.needs_sync = false; } } @@ -322,7 +325,7 @@ impl ServerEntity { // SynchedEntityData.isDirty: once for every client. let dirty = e.meta != self.meta; let due = self.interval != 0 && self.tick.is_multiple_of(self.interval); - if due || dirty { + if due || dirty || e.needs_sync { let rotation = (pack_degrees(e.pitch), pack_degrees(e.yaw)); let turned = |a: i8, b: i8| (i32::from(a) - i32::from(b)).abs() >= 1; let rotate = self.arrow @@ -398,7 +401,7 @@ impl ServerEntity { } else { None }; - if self.track_deltas { + if self.track_deltas || e.needs_sync { let diff: f64 = (0..3) .map(|k| (e.velocity[k] - self.velocity[k]).powi(2)) .sum(); @@ -855,6 +858,7 @@ mod tests { equipment: Vec::new(), attributes: Vec::new(), precise: false, + needs_sync: false, } } @@ -918,6 +922,37 @@ mod tests { assert!(matches!(jump[0], play::Clientbound::EntityPositionSync(_))); } + #[test] + fn a_knocked_back_mob_is_sent_at_once() { + let mut s = added(&state(0.0)); + changes(&mut s, &state(0.0)); + // Not due (tick 1 of 3), but LivingEntity.knockback set needsSync: + // its move and its new motion go out now. + let mut knocked = state(0.3); + knocked.velocity = [0.2, 0.3, 0.0]; + knocked.needs_sync = true; + let out = changes(&mut s, &knocked); + assert!( + matches!( + out[..], + [ + play::Clientbound::SetEntityMotion(_), + play::Clientbound::MoveEntityPos(_) + ] + ), + "{out:?}" + ); + // Then every third tick again. + assert!(changes(&mut s, &state(0.5)).is_empty()); + assert!(matches!( + changes(&mut s, &state(0.6))[..], + [ + play::Clientbound::SetEntityMotion(_), + play::Clientbound::MoveEntityPos(_) + ] + )); + } + #[test] fn fireballs_bundle_their_motion_with_their_power() { let mut e = state(0.0); diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index bf66f979b..060ec7193 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -1547,6 +1547,7 @@ impl Hub { equipment, attributes, precise: false, + needs_sync: false, } } diff --git a/crates/horizon-client/src/mobs.rs b/crates/horizon-client/src/mobs.rs index db2ebeb60..76f622d9c 100644 --- a/crates/horizon-client/src/mobs.rs +++ b/crates/horizon-client/src/mobs.rs @@ -792,6 +792,9 @@ pub struct Mob { pub on_ground: bool, pub horizontal_collision: bool, pub vertical_collision_below: bool, + /// `Entity.needsSync`: knocked back, pushed or jumped since its server + /// last sent it, so the next update goes out at once. + pub needs_sync: bool, pub health: f32, pub hurt_time: i32, pub invulnerable: i32, @@ -1361,8 +1364,10 @@ impl PendingPushes { } /// Adds the pending pushes aimed at `m` to its velocity, in push order. pub fn apply_mob_pushes(m: &mut Mob, pending: &mut PendingPushes) { + // Entity.push(x, y, z) sets needsSync. let mut add = |v: Vec3| { m.velocity = Vec3::new(m.velocity.x + v.x, m.velocity.y + v.y, m.velocity.z + v.z); + m.needs_sync = true; }; if !pending.list.is_empty() { pending.list.retain(|(id, v)| { @@ -1529,6 +1534,7 @@ impl Mob { on_ground: false, horizontal_collision: false, vertical_collision_below: false, + needs_sync: false, hurt_time: 0, invulnerable: 0, death_time: 0, @@ -1769,6 +1775,7 @@ impl Mob { if power <= 0.0 { return; } + self.needs_sync = true; while xd * xd + zd * zd < f64::from(1.0e-5_f32) { xd = (self.random.next_double() - self.random.next_double()) * 0.01; zd = (self.random.next_double() - self.random.next_double()) * 0.01; diff --git a/crates/horizon-client/src/mobs/living.rs b/crates/horizon-client/src/mobs/living.rs index ebbfabf6b..d5b3c7091 100644 --- a/crates/horizon-client/src/mobs/living.rs +++ b/crates/horizon-client/src/mobs/living.rs @@ -832,6 +832,9 @@ impl Mob { }; } pub fn jump_from_ground(&mut self, w: &MobWorld) { + // LivingEntity.jumpFromGround (and the rabbit's and cubes' own, + // which call it or do the same): needsSync. + self.needs_sync = true; if self.species() == super::Species::Rabbit { super::rabbit::jump(self, w); return; diff --git a/crates/horizon-client/tests/lan_bot.rs b/crates/horizon-client/tests/lan_bot.rs index bd22d6e0a..4f5f17a3b 100644 --- a/crates/horizon-client/tests/lan_bot.rs +++ b/crates/horizon-client/tests/lan_bot.rs @@ -433,6 +433,7 @@ fn guests_see_each_other_and_the_world_entities() { equipment: Vec::new(), attributes: Vec::new(), precise: false, + needs_sync: false, }; let first = thread::spawn(move || { let mut bot = connect(port, "Alex", false)?; diff --git a/crates/horizon-world/examples/stepped_interpolation_fixture.rs b/crates/horizon-world/examples/stepped_interpolation_fixture.rs new file mode 100644 index 000000000..d2228d8b5 --- /dev/null +++ b/crates/horizon-world/examples/stepped_interpolation_fixture.rs @@ -0,0 +1,93 @@ +//! The Rust side of tools/test_stepped_interpolation_parity.py: replays the +//! harness's events (VanillaSteppedInterpolationOracle's input format) on +//! `SteppedInterpolation` and writes the entity after each one. +use horizon_world::stepped_interpolation::{Path, PosRot, Start, SteppedInterpolation}; +use std::fmt::Write as _; + +/// `Entity.setRot`: yaw and pitch wrapped, pitch clamped (`setXRot`). +fn set_rot(entity: &mut PosRot, yaw: f32, pitch: f32) { + entity.yaw = yaw % 360.0; + entity.pitch = (pitch % 360.0 % 360.0).clamp(-90.0, 90.0); +} + +fn main() { + let args: Vec = std::env::args().collect(); + let input = std::fs::read_to_string(&args[1]).expect("input"); + let mut out = String::new(); + let mut handler = SteppedInterpolation::new(0); + let mut entity = PosRot::default(); + for line in input.lines() { + let f: Vec<&str> = line.split_whitespace().collect(); + let num = |i: usize| f[i].parse::().expect("number"); + let what = match f[0] { + "case" => { + handler = SteppedInterpolation::new(f[1].parse().expect("steps")); + entity = PosRot { + position: [num(2), num(3), num(4)], + yaw: f[5].parse().expect("yaw"), + pitch: f[6].parse().expect("pitch"), + }; + "c" + } + "move" => { + let mut i = 2; + let path = match f[1] { + "L" => { + i += 3; + Some(Path::Linear([num(2), num(3), num(4)])) + } + "S" => { + let n: usize = f[2].parse().expect("count"); + i = 3; + let mut steps = Vec::new(); + for _ in 0..n { + steps.push(( + [num(i), num(i + 1), num(i + 2)], + f[i + 3].parse().expect("ticks"), + )); + i += 4; + } + Some(Path::Stepped(steps)) + } + _ => None, + }; + let rotation = (f[i] == "R").then(|| { + ( + f[i + 1].parse().expect("yaw"), + f[i + 2].parse().expect("pitch"), + ) + }); + match handler.interpolate_to(entity, path, rotation) { + Start::Snap(at) => { + entity.position = at.position; + set_rot(&mut entity, at.yaw, at.pitch); + "s" + } + Start::Unchanged => "k", + Start::Interpolating => "i", + } + } + "tick" => match handler.interpolate() { + Some(at) => { + entity.position = at.position; + set_rot(&mut entity, at.yaw, at.pitch); + "t" + } + None => "n", + }, + other => panic!("unknown event {other}"), + }; + let p = entity.position; + writeln!( + out, + "{what} {:x} {:x} {:x} {:x} {:x}", + p[0].to_bits(), + p[1].to_bits(), + p[2].to_bits(), + entity.yaw.to_bits(), + entity.pitch.to_bits() + ) + .expect("write"); + } + std::fs::write(&args[2], out).expect("output"); +} diff --git a/crates/horizon-world/src/lib.rs b/crates/horizon-world/src/lib.rs index 819262d46..b6d05ecf6 100644 --- a/crates/horizon-world/src/lib.rs +++ b/crates/horizon-world/src/lib.rs @@ -137,6 +137,7 @@ pub mod player_equipment; pub mod living_use_flags; pub mod status_effect; +pub mod stepped_interpolation; pub mod synced_values; pub mod inventory_use; diff --git a/crates/horizon-world/src/stepped_interpolation.rs b/crates/horizon-world/src/stepped_interpolation.rs new file mode 100644 index 000000000..a7157d90a --- /dev/null +++ b/crates/horizon-world/src/stepped_interpolation.rs @@ -0,0 +1,341 @@ +//! How a client moves a living entity it doesn't simulate along the +//! positions its server sends (vanilla `SteppedInterpolationHandler`, which +//! `LivingEntity.createInterpolationHandler` gives every living entity on a +//! client): each position is a step the entity walks to in the type's update +//! interval (3 ticks for most mobs), one after the other, sped up while +//! steps pile up. A punched mob's first move, sent at once (`needsSync`), +//! thus takes three ticks to show, and the rest follow it. + +use std::collections::VecDeque; + +/// A position and rotation (`PositionAndRotation`). +#[derive(Clone, Copy, Debug, Default, PartialEq)] +pub struct PosRot { + pub position: [f64; 3], + pub yaw: f32, + pub pitch: f32, +} + +impl PosRot { + /// `PositionAndRotation.is`: the same rotation and `Vec3.equals` + /// position (`Double.compare`, so -0.0 is not 0.0). + fn is(&self, position: [f64; 3], yaw: f32, pitch: f32) -> bool { + self.yaw == yaw && self.pitch == pitch && same_position(self.position, position) + } +} + +/// `Vec3.equals`. +fn same_position(a: [f64; 3], b: [f64; 3]) -> bool { + (0..3).all(|i| a[i].to_bits() == b[i].to_bits()) +} + +/// `PositionPath`: where a move packet puts an entity, either straight +/// there or through the positions the server stepped it through, each +/// with the ticks it took. +#[derive(Clone, Debug, PartialEq)] +pub enum Path { + Linear([f64; 3]), + Stepped(Vec<([f64; 3], i32)>), +} + +impl Path { + pub fn end(&self) -> [f64; 3] { + match self { + Path::Linear(p) => *p, + Path::Stepped(steps) => steps.last().map_or([0.0; 3], |s| s.0), + } + } +} + +/// What the client does with the entity when a packet arrives. +#[derive(Clone, Copy, Debug, PartialEq)] +pub enum Start { + /// Moves on to it over the coming ticks. + Interpolating, + /// Already headed there: nothing changes. + Unchanged, + /// Is put there at once (`snapTo`): types with no update interval. + Snap(PosRot), +} + +/// `SteppedInterpolationHandler` and its `InterpolationData`. +#[derive(Clone, Debug)] +pub struct SteppedInterpolation { + /// `AbstractInterpolationHandler.interpolationSteps`: the type's + /// `updateInterval`. + steps: i32, + /// The data's own position and rotation: where the last packet said. + target: PosRot, + /// `lastStepPosRot`: where the step being walked started. + last: PosRot, + remaining: VecDeque<(PosRot, i32)>, + current_step_ticks: f32, + remaining_ticks: f32, + speed: f32, +} + +/// `Mth.wrapDegrees(float)`. +fn wrap_degrees(degrees: f32) -> f32 { + let mut wrapped = degrees % 360.0; + if wrapped >= 180.0 { + wrapped -= 360.0; + } + if wrapped < -180.0 { + wrapped += 360.0; + } + wrapped +} + +/// `Mth.lerp(float, float, float)`. +fn lerp(a: f32, from: f32, to: f32) -> f32 { + from + a * (to - from) +} + +/// `Mth.rotLerp`. +fn rot_lerp(a: f32, from: f32, to: f32) -> f32 { + from + a * wrap_degrees(to - from) +} + +impl SteppedInterpolation { + /// The handler of an entity type whose update interval is `steps` ticks. + pub fn new(steps: i32) -> Self { + Self { + steps, + target: PosRot::default(), + last: PosRot::default(), + remaining: VecDeque::new(), + current_step_ticks: 0.0, + remaining_ticks: 0.0, + speed: 1.0, + } + } + /// `hasActiveInterpolation`. + pub fn active(&self) -> bool { + !self.remaining.is_empty() + } + /// Where the entity is headed: the last packet's position and rotation + /// while interpolating (`AbstractInterpolationHandler.interpolateTo`'s + /// `current`), else where it is. + pub fn heading(&self, entity: PosRot) -> PosRot { + if self.active() { self.target } else { entity } + } + /// `AbstractInterpolationHandler.interpolateTo(path, yRot, xRot, + /// hasRotation)` for an entity at `entity`: a packet without a position + /// (`path` None) keeps the one it is headed for, one without a rotation + /// the rotation. + pub fn interpolate_to( + &mut self, + entity: PosRot, + path: Option, + rotation: Option<(f32, f32)>, + ) -> Start { + let current = self.heading(entity); + let path = path.unwrap_or(Path::Linear(current.position)); + let (yaw, pitch) = rotation.unwrap_or((current.yaw, current.pitch)); + let end = path.end(); + if self.steps == 0 { + self.cancel(); + return Start::Snap(PosRot { + position: end, + yaw, + pitch, + }); + } + if self.active() && self.target.is(end, yaw, pitch) { + return Start::Unchanged; + } + // SteppedInterpolationHandler.startInterpolating. + if !self.active() { + self.last = entity; + self.current_step_ticks = 1.0; + } + if same_position(end, self.target.position) { + self.add_step( + PosRot { + position: end, + yaw, + pitch, + }, + self.steps, + ); + } else { + self.add_steps(&path, yaw, pitch); + } + self.target = PosRot { + position: end, + yaw, + pitch, + }; + Start::Interpolating + } + /// `cancel` (`InterpolationData.reset`). + pub fn cancel(&mut self) { + self.remaining.clear(); + self.remaining_ticks = 0.0; + self.speed = 1.0; + } + /// `AbstractInterpolationHandler.interpolate`, once a client tick: where + /// the entity is put, or None when there is nothing to walk (and the + /// handler resets). The client moves the entity only this way, so the + /// target never needs the deltas `adjustInterpolationTargetFromDeltas` + /// would add. + pub fn interpolate(&mut self) -> Option { + if !self.active() { + self.cancel(); + return None; + } + // doInterpolate: getNewPositionAndRotation, then advance by the + // level's relative tick speed (1 at the normal tick rate). + let at = self.new_position(); + self.advance(1.0); + Some(at) + } + /// `InterpolationData.addStep`. + fn add_step(&mut self, step: PosRot, ticks: i32) { + self.remaining.push_back((step, ticks)); + self.remaining_ticks += ticks as f32; + } + /// `InterpolationData.addSteps`: a stepped path's steps take their own + /// ticks, turning by the share of the path each one ends. + fn add_steps(&mut self, path: &Path, yaw: f32, pitch: f32) { + match path { + Path::Linear(p) => self.add_step( + PosRot { + position: *p, + yaw, + pitch, + }, + self.steps, + ), + Path::Stepped(steps) => { + if yaw == self.target.yaw && pitch == self.target.pitch { + for (p, ticks) in steps { + self.add_step( + PosRot { + position: *p, + yaw, + pitch, + }, + *ticks, + ); + } + return; + } + let total: i32 = steps.iter().map(|s| s.1).sum(); + let mut offset = 0; + let (from_yaw, from_pitch) = (self.target.yaw, self.target.pitch); + for (p, ticks) in steps { + offset += ticks; + let a = offset as f32 / total as f32; + let step = PosRot { + position: *p, + yaw: rot_lerp(a, from_yaw, yaw), + pitch: lerp(a, from_pitch, pitch), + }; + self.add_step(step, *ticks); + } + } + } + } + /// `InterpolationData.getNewPositionAndRotation`. + fn new_position(&mut self) -> PosRot { + while let Some(&(step, ticks)) = self.remaining.front() { + if self.current_step_ticks < ticks as f32 { + let a = self.current_step_ticks / ticks as f32; + let t = f64::from(a); + let (from, to) = (self.last.position, step.position); + return PosRot { + position: [0, 1, 2].map(|i| from[i] + (to[i] - from[i]) * t), + yaw: rot_lerp(a, self.last.yaw, step.yaw), + pitch: lerp(a, self.last.pitch, step.pitch), + }; + } + self.current_step_ticks -= ticks as f32; + self.last = step; + self.remaining.pop_front(); + } + self.target + } + /// `InterpolationData.advance`: faster while more than one update's + /// worth of steps waits. + fn advance(&mut self, ticks: f32) { + let steps = self.steps as f32; + let target_speed = (self.remaining_ticks / steps).max(1.0); + self.speed = lerp(1.0 / steps, self.speed, target_speed); + let moved = if ticks * self.speed < self.remaining_ticks { + ticks * self.speed + } else { + self.speed = 1.0; + self.remaining_ticks + }; + self.current_step_ticks += moved; + self.remaining_ticks -= moved; + } +} + +#[cfg(test)] +mod tests { + use super::*; + + fn at(x: f64) -> PosRot { + PosRot { + position: [x, 0.0, 0.0], + yaw: 0.0, + pitch: 0.0, + } + } + + #[test] + fn a_position_takes_the_update_interval_to_reach() { + let mut h = SteppedInterpolation::new(3); + let mut entity = at(0.0); + h.interpolate_to(entity, Some(Path::Linear([0.3, 0.0, 0.0])), None); + let mut seen = Vec::new(); + while let Some(p) = h.interpolate() { + entity = p; + seen.push((p.position[0] * 1000.0).round() / 1000.0); + } + assert_eq!(seen, [0.1, 0.2, 0.3]); + assert!(!h.active()); + assert_eq!(entity.position[0], 0.3); + } + + #[test] + fn steps_that_pile_up_are_walked_faster() { + let mut h = SteppedInterpolation::new(3); + let mut entity = at(0.0); + let mut ticks = 0; + for k in 1..=4 { + h.interpolate_to(entity, Some(Path::Linear([f64::from(k), 0.0, 0.0])), None); + if let Some(p) = h.interpolate() { + entity = p; + } + ticks += 1; + } + while let Some(p) = h.interpolate() { + entity = p; + ticks += 1; + } + // Four packets a tick apart: 12 ticks of steps, walked in fewer. + assert!(ticks < 12, "{ticks}"); + assert_eq!(entity.position[0], 4.0); + } + + #[test] + fn no_update_interval_snaps() { + let mut h = SteppedInterpolation::new(0); + let start = h.interpolate_to( + at(0.0), + Some(Path::Linear([2.0, 0.0, 0.0])), + Some((90.0, 0.0)), + ); + assert_eq!( + start, + Start::Snap(PosRot { + position: [2.0, 0.0, 0.0], + yaw: 90.0, + pitch: 0.0 + }) + ); + } +} diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaSteppedInterpolationOracle.java b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaSteppedInterpolationOracle.java new file mode 100644 index 000000000..b3edd6e48 --- /dev/null +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaSteppedInterpolationOracle.java @@ -0,0 +1,148 @@ +package dev.horizonlab.parity; + +import java.io.PrintWriter; +import java.lang.reflect.Constructor; +import java.lang.reflect.Field; +import java.lang.reflect.Method; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.ArrayList; +import java.util.List; +import java.util.Objects; +import net.minecraft.core.PositionAndRotation; +import net.minecraft.world.entity.PositionPath; +import net.minecraft.world.entity.PositionStep; +import net.minecraft.world.phys.Vec3; + +/** + * How a client walks a living entity along the positions its server sends: the unmodified + * {@code SteppedInterpolationHandler.InterpolationData} (setStartingPoint, addStep, addSteps, + * getNewPositionAndRotation, advance, reset), driven the way + * {@code AbstractInterpolationHandler.interpolateTo} / {@code interpolate} and + * {@code SteppedInterpolationHandler.startInterpolating} / {@code doInterpolate} drive it, with the + * entity's own {@code setPos} / {@code setRot}. The handler's entity hooks are out of scope: the + * entity moves only by its interpolation (no deltas to adjust) at the normal tick rate. + * + *

    Input (args[0]), one event a line: {@code case STEPS X Y Z YAW PITCH} (a fresh entity there + * with a handler of that many interpolation steps), {@code move L X Y Z} or {@code move S N + * (X Y Z TICKS)xN} or {@code move N} (no position), then {@code R YAW PITCH} or {@code -} (no + * rotation), and {@code tick}. Output (args[1]): the entity after every event. + */ +public final class VanillaSteppedInterpolationOracle { + private static Method method(Class owner, String name, Class... types) throws Exception { + Method m = owner.getDeclaredMethod(name, types); + m.setAccessible(true); + return m; + } + + private static String hex(double v) { + return Long.toHexString(Double.doubleToRawLongBits(v)); + } + + private static String hex(float v) { + return Integer.toHexString(Float.floatToRawIntBits(v)); + } + + public static void main(String[] args) throws Exception { + Class dataClass = Class.forName("net.minecraft.world.entity.SteppedInterpolationHandler$InterpolationData"); + Constructor create = dataClass.getDeclaredConstructor(); + create.setAccessible(true); + Method advance = method(dataClass, "advance", float.class, int.class); + Method addStep = method(dataClass, "addStep", Vec3.class, float.class, float.class, int.class); + Method addSteps = method(dataClass, "addSteps", PositionPath.class, float.class, float.class, int.class); + Method setStartingPoint = method(dataClass, "setStartingPoint", Vec3.class, float.class, float.class); + Method next = method(dataClass, "getNewPositionAndRotation"); + Method reset = method(dataClass, "reset"); + Field remaining = dataClass.getDeclaredField("remainingSteps"); + remaining.setAccessible(true); + + Object data = null; + int steps = 0; + Vec3 pos = Vec3.ZERO; + float yRot = 0; + float xRot = 0; + try (PrintWriter out = new PrintWriter(Files.newBufferedWriter(Path.of(args[1])))) { + for (String line : Files.readAllLines(Path.of(args[0]))) { + String[] f = line.trim().split(" "); + int i = 1; + String what; + switch (f[0]) { + case "case" -> { + data = create.newInstance(); + steps = Integer.parseInt(f[1]); + pos = new Vec3(Double.parseDouble(f[2]), Double.parseDouble(f[3]), Double.parseDouble(f[4])); + yRot = Float.parseFloat(f[5]); + xRot = Float.parseFloat(f[6]); + what = "c"; + } + case "move" -> { + PositionPath path = null; + switch (f[i++]) { + case "L" -> { + path = PositionPath.of(new Vec3(Double.parseDouble(f[i]), Double.parseDouble(f[i + 1]), Double.parseDouble(f[i + 2]))); + i += 3; + } + case "S" -> { + int n = Integer.parseInt(f[i++]); + List list = new ArrayList<>(); + for (int k = 0; k < n; k++) { + list.add(new PositionStep(new Vec3(Double.parseDouble(f[i]), Double.parseDouble(f[i + 1]), Double.parseDouble(f[i + 2])), Integer.parseInt(f[i + 3]))); + i += 4; + } + path = PositionPath.stepped(List.copyOf(list)); + } + default -> { + } + } + boolean hasRotation = f[i].equals("R"); + float y = hasRotation ? Float.parseFloat(f[i + 1]) : 0; + float x = hasRotation ? Float.parseFloat(f[i + 2]) : 0; + boolean active = !((List) remaining.get(data)).isEmpty(); + PositionAndRotation.Mutable target = (PositionAndRotation.Mutable) data; + // AbstractInterpolationHandler.interpolateTo(path, yRot, xRot, hasRotation). + PositionAndRotation current = active ? target : PositionAndRotation.of(pos, yRot, xRot); + if (path == null) path = PositionPath.of(current.position()); + if (!hasRotation) { + y = current.yRot(); + x = current.xRot(); + } + Vec3 end = path.endPosition(); + if (steps == 0) { + // snapTo, then cancel. + pos = end; + yRot = y % 360.0F; + xRot = Math.clamp(x % 360.0F % 360.0F, -90.0F, 90.0F); + reset.invoke(data); + what = "s"; + } else if (active && target.is(end, y, x)) { + what = "k"; + } else { + // SteppedInterpolationHandler.startInterpolating. + if (!active) setStartingPoint.invoke(data, pos, yRot, xRot); + if (Objects.equals(end, target.position())) addStep.invoke(data, end, y, x, steps); + else addSteps.invoke(data, path, y, x, steps); + target.set(end, y, x); + what = "i"; + } + } + case "tick" -> { + // AbstractInterpolationHandler.interpolate. + if (((List) remaining.get(data)).isEmpty()) { + reset.invoke(data); + what = "n"; + } else { + PositionAndRotation t = (PositionAndRotation) next.invoke(data); + pos = t.position(); + yRot = t.yRot() % 360.0F; + xRot = Math.clamp(t.xRot() % 360.0F % 360.0F, -90.0F, 90.0F); + advance.invoke(data, 1.0F, steps); + what = "t"; + } + } + default -> throw new IllegalArgumentException(line); + } + out.println(what + " " + hex(pos.x) + " " + hex(pos.y) + " " + hex(pos.z) + " " + hex(yRot) + " " + hex(xRot)); + } + } + } +} diff --git a/tools/test_stepped_interpolation_parity.py b/tools/test_stepped_interpolation_parity.py new file mode 100644 index 000000000..998d5a4ba --- /dev/null +++ b/tools/test_stepped_interpolation_parity.py @@ -0,0 +1,103 @@ +#!/usr/bin/env python3 +"""Compare how a client walks a living entity along its server's positions with vanilla. + +Vanilla's unmodified SteppedInterpolationHandler.InterpolationData (VanillaSteppedInterpolationOracle +drives it as the handler does) and horizon-world's SteppedInterpolation replay the same packets and +client ticks: move packets with and without a position or rotation, straight or stepped paths, +repeats of the one the entity is headed for, packets a tick apart that pile up and others after it +stopped, for update intervals of 1 to 3 ticks, plus a punched pig's knockback as the server sends it +(its first move at once, `needsSync`, then every update interval). The entity's position and rotation +after every event must match bit for bit. The handler's entity hooks (deltas, passengers) are out of +scope. +""" +import os +import random +import subprocess +try: + from . import lab, test_rust_parity as base +except ImportError: + import lab + import test_rust_parity as base + +# A pig punched on flat ground, its positions on the server tick by tick (knockback 0.4 along x). +KNOCKBACK = [(0.0, 0.0), (0.3032, 0.3608), (0.4638, 0.636), (0.6049, 0.8273), (0.7279, 0.9363), (0.8345, 0.9648), + (0.926, 0.9143), (1.0037, 0.7864), (1.0688, 0.5827), (1.1223, 0.3046), (1.1654, 0.0), (1.1147, 0.0), + (0.9968, 0.0), (0.8418, 0.0), (0.6664, 0.0)] + + +def position(rng, p): + return [round(v + rng.uniform(-0.6, 0.6), rng.choice([2, 4, 17])) for v in p] + + +def rotation(rng): + return [round(rng.uniform(-400, 400), rng.choice([0, 1, 3])), round(rng.uniform(-120, 120), rng.choice([0, 2]))] + + +def cases(count, seed): + rng = random.Random(seed) + lines = [] + for interval in (1, 2, 3): + # The knockback: a packet for the hit tick's move, then every interval (each phase). + for phase in range(interval): + lines.append(f'case {interval} 10.5 64.0 0.5 90.0 0.0') + for k in range(1, len(KNOCKBACK)): + if k == 1 or (k + phase) % interval == 0: + x, y = KNOCKBACK[k] + lines.append(f'move L {10.5 + x!r} {64 + y!r} 0.5 -') + lines.append('tick') + lines += ['tick'] * 6 + for _ in range(count): + p = [rng.uniform(-100, 100), rng.uniform(-64, 300), rng.uniform(-100, 100)] + yaw, pitch = rotation(rng) + lines.append(f'case {rng.choice([1, 2, 3, 3, 3])} {p[0]!r} {p[1]!r} {p[2]!r} {yaw!r} {pitch!r}') + last = None + for _ in range(rng.randrange(1, 40)): + if rng.random() < 0.45: + lines.append('tick') + continue + if last is not None and rng.random() < 0.15: + line = last # the same packet again + else: + if rng.random() < 0.1: + line = 'move N' + elif rng.random() < 0.2: + n = rng.randrange(1, 5) + steps = [] + for _ in range(n): + p = position(rng, p) + steps.append(f'{p[0]!r} {p[1]!r} {p[2]!r} {rng.randrange(1, 4)}') + line = f'move S {n} ' + ' '.join(steps) + else: + p = position(rng, p) if rng.random() < 0.9 else p + line = f'move L {p[0]!r} {p[1]!r} {p[2]!r}' + rot = rotation(rng) if rng.random() < 0.6 else None + line += f' R {rot[0]!r} {rot[1]!r}' if rot else ' -' + last = line + lines.append(line) + lines += ['tick'] * rng.choice([0, 1, 1, 2, 3, 6]) + return lines + + +def main(): + lock, jars, libraries = base.verify_artifacts() + build = lab.LOCAL / 'stepped-interpolation-parity' + build.mkdir(parents=True, exist_ok=True) + classes = build / 'classes' + classes.mkdir(exist_ok=True) + events = build / 'events.txt' + events.write_text('\n'.join(cases(3000, 1374)) + '\n', encoding='utf-8') + classpath = os.pathsep.join(map(str, [jars['client'], *libraries])) + oracle = lab.ROOT / 'mods/horizon/src/test/java/dev/horizonlab/parity/VanillaSteppedInterpolationOracle.java' + subprocess.run(['javac', '--release', str(lock['minecraft']['java_major']), '-proc:none', + '-cp', classpath, '-d', str(classes), str(oracle)], check=True) + subprocess.run(['java', '-Xmx512M', '-cp', str(classes) + os.pathsep + classpath, + 'dev.horizonlab.parity.VanillaSteppedInterpolationOracle', str(events), str(build / 'vanilla.txt')], + check=True) + subprocess.run(['cargo', 'run', '--quiet', '--release', '-p', 'horizon-world', '--example', + 'stepped_interpolation_fixture', '--', str(events), str(build / 'rust.txt')], cwd=lab.ROOT, check=True) + matched = base.compare(build / 'vanilla.txt', build / 'rust.txt') + print(f'Stepped interpolation parity passed: {matched} entity positions and rotations match vanilla') + + +if __name__ == '__main__': + main() From 144741b7c7f165353dc4c34ae0e9ebad0707cbb6 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 06:39:22 +0200 Subject: [PATCH 100/126] Screen overlays: one texture sample, as on main The vignette, drawn over every frame, went from one texture sample to up to four texel loads and per-pixel address arithmetic: +0.85 ms of GPU a frame on an HD 620 (integer modulo, removed in the commit before), still +0.4 ms after it. - A blurred sprite gets a one-texel border in the atlas, copied from its opposite edges: the hardware's bilinear sample of the atlas with the entity group's linear sampler is then GL_LINEAR with repeat, edges included. Clamp-to-edge keeps the sample point half a texel inside the sprite, which is what the hardware's clamp does for both filters. - Each sampling has its own pipeline, the shader specialised by override constants: a repeat sprite runs main's arithmetic and one sample, nearest or linear; only clamp adds a clamp. The sampling moves from the vertices to the quad, so the vertex layout is main's again. - A black vignette changes no pixel (it darkens by texture x colour), and is no longer drawn: in daylight its brightness fades to 0 within half a minute, so most frames outdoors skip it, which main never could. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/gfx.rs | 92 ++++++++++++--------- crates/horizon-client/src/hud.rs | 54 +++++++++++- crates/horizon-client/src/screen.wgsl | 56 ++++++------- crates/horizon-client/src/screen_effects.rs | 29 +++++-- 4 files changed, 156 insertions(+), 75 deletions(-) diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 3aa4ace2a..f1cc3393d 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -357,8 +357,9 @@ pub struct Renderer { border_group: wgpu::BindGroup, border_uniform: wgpu::Buffer, border_vertices: wgpu::Buffer, - /// Screen effects: alpha-blended and vignette (`dst * (1 - src)`) pipelines. - screen_pipelines: [wgpu::RenderPipeline; 2], + /// Screen effects: alpha-blended, then vignette (`dst * (1 - src)`) + /// pipelines, each for every sampling (index `blend * 4 + sampling`). + screen_pipelines: [wgpu::RenderPipeline; 8], screen_buffer: wgpu::Buffer, screen_capacity: u64, entity_group: wgpu::BindGroup, @@ -1983,7 +1984,7 @@ impl Renderer { source: wgpu::ShaderSource::Wgsl(include_str!("screen.wgsl").into()), }); let screen_attributes = - wgpu::vertex_attr_array![0=>Float32x2,1=>Float32x2,2=>Float32x4,3=>Float32x4,4=>Uint32]; + wgpu::vertex_attr_array![0=>Float32x2,1=>Float32x2,2=>Float32x4,3=>Float32x4]; let screen_vertex = [Some(wgpu::VertexBufferLayout { array_stride: std::mem::size_of::() as u64, step_mode: wgpu::VertexStepMode::Vertex, @@ -2001,37 +2002,52 @@ impl Renderer { operation: wgpu::BlendOperation::Add, }, }; - let screen_pipelines = - [("fs_screen", alpha_blend), ("fs_vignette", vignette_blend)].map(|(entry, blend)| { - device.create_render_pipeline(&wgpu::RenderPipelineDescriptor { - label: Some("Screen effects"), - layout: Some(&entity_layout), - vertex: wgpu::VertexState { - module: &screen_shader, - entry_point: Some("vs_screen"), - compilation_options: Default::default(), - buffers: &screen_vertex, - }, - primitive: wgpu::PrimitiveState { - cull_mode: None, - ..Default::default() - }, - depth_stencil: None, - multisample: Default::default(), - fragment: Some(wgpu::FragmentState { - module: &screen_shader, - entry_point: Some(entry), - compilation_options: Default::default(), - targets: &[Some(wgpu::ColorTargetState { - format: config.format.remove_srgb_suffix(), - blend: Some(blend), - write_mask: wgpu::ColorWrites::ALL, - })], - }), - multiview_mask: None, - cache: None, - }) - }); + // One per blend and `.png.mcmeta` sampling (screen_effects::SAMPLE_*): + // the shader is specialised, so a pixel pays for none of the others. + let screen_pipelines: [wgpu::RenderPipeline; 8] = std::array::from_fn(|i| { + let (entry, blend) = if i & 4 == 0 { + ("fs_screen", alpha_blend) + } else { + ("fs_vignette", vignette_blend) + }; + let on = |bit: u32| f64::from(u8::from(i as u32 & bit != 0)); + let constants = [ + ("BLUR", on(crate::screen_effects::SAMPLE_BLUR)), + ("CLAMP", on(crate::screen_effects::SAMPLE_CLAMP)), + ]; + let compilation_options = wgpu::PipelineCompilationOptions { + constants: &constants, + ..Default::default() + }; + device.create_render_pipeline(&wgpu::RenderPipelineDescriptor { + label: Some("Screen effects"), + layout: Some(&entity_layout), + vertex: wgpu::VertexState { + module: &screen_shader, + entry_point: Some("vs_screen"), + compilation_options: compilation_options.clone(), + buffers: &screen_vertex, + }, + primitive: wgpu::PrimitiveState { + cull_mode: None, + ..Default::default() + }, + depth_stencil: None, + multisample: Default::default(), + fragment: Some(wgpu::FragmentState { + module: &screen_shader, + entry_point: Some(entry), + compilation_options, + targets: &[Some(wgpu::ColorTargetState { + format: config.format.remove_srgb_suffix(), + blend: Some(blend), + write_mask: wgpu::ColorWrites::ALL, + })], + }), + multiview_mask: None, + cache: None, + }) + }); let screen_capacity = 64; let screen_buffer = device.create_buffer(&wgpu::BufferDescriptor { label: Some("Screen effect vertices"), @@ -3911,11 +3927,11 @@ impl Renderer { pass.set_index_buffer(self.indices.slice(..), wgpu::IndexFormat::Uint32); pass.set_vertex_buffer(0, self.screen_buffer.slice(..)); for (i, quad) in frame.screen.iter().enumerate() { - let pipeline = match quad.blend { - crate::screen_effects::Blend::Alpha => &self.screen_pipelines[0], - crate::screen_effects::Blend::Vignette => &self.screen_pipelines[1], + let blend = match quad.blend { + crate::screen_effects::Blend::Alpha => 0, + crate::screen_effects::Blend::Vignette => 4, }; - pass.set_pipeline(pipeline); + pass.set_pipeline(&self.screen_pipelines[blend + (quad.sampling & 3) as usize]); pass.draw_indexed(0..6, (i * 4) as i32, 0..1); } } diff --git a/crates/horizon-client/src/hud.rs b/crates/horizon-client/src/hud.rs index 43ae29c74..dbd44266a 100644 --- a/crates/horizon-client/src/hud.rs +++ b/crates/horizon-client/src/hud.rs @@ -104,6 +104,20 @@ fn walk(dir: &Path, out: &mut Vec) { } /// A packed atlas image: sprite name, size and RGBA pixels. type PackedImage = (String, u32, u32, Vec); +/// `image` inside a one-texel border copied from its opposite edges, the +/// texels repeat addressing reads past each edge. +fn wrap_border((name, w, h, data): &PackedImage) -> PackedImage { + let (bw, bh) = (w + 2, h + 2); + let mut out = Vec::with_capacity((bw * bh * 4) as usize); + for y in 0..bh { + let row = (y + h - 1) % h; + for x in 0..bw { + let at = ((row * w + (x + w - 1) % w) * 4) as usize; + out.extend_from_slice(&data[at..at + 4]); + } + } + (name.clone(), bw, bh, out) +} /// Sprites the atlas definitions (`atlases/*.json`) add beyond the texture /// files already packed: generated ones (`paletted_permutations` such as the /// armour trim sprites, `unstitch` regions) and files listed under another id. @@ -326,6 +340,16 @@ impl HudAtlas { if full { Self::slots(&mut images, crate::trims::slot_size(root)); } + // Blurred sprites are sampled linearly in the atlas (screen.wgsl): a + // border wrapped from their own edges keeps the filter off their + // neighbours, as repeat addressing of their own texture would. + let mut bordered = std::collections::HashSet::new(); + for image in &mut images { + if flags.get(&image.0).is_some_and(|f: &TextureFlags| f.blur) { + *image = wrap_border(image); + bordered.insert(image.0.clone()); + } + } images.sort_by(|a, b| b.2.cmp(&a.2).then(b.1.cmp(&a.1))); let width = 4096u32; let mut placements = Vec::with_capacity(images.len()); @@ -350,6 +374,8 @@ impl HudAtlas { let dst = (((py + row) * width + px) * 4) as usize; pixels[dst..dst + (w * 4) as usize].copy_from_slice(src); } + let b = u32::from(bordered.contains(name)); + let (px, py, w, h) = (px + b, py + b, w - 2 * b, h - 2 * b); sprites.insert( name.clone(), Rect { @@ -357,8 +383,8 @@ impl HudAtlas { v0: py as f32 / height as f32, u1: (px + w) as f32 / width as f32, v1: (py + h) as f32 / height as f32, - w: *w, - h: *h, + w, + h, }, ); } @@ -1246,6 +1272,30 @@ impl HudRenderer { mod tests { use super::*; + #[test] + fn a_wrapped_border_repeats_the_opposite_edges() { + // 2x2 texels a b / c d, one byte each in red. + let image = ( + "x".to_owned(), + 2, + 2, + [1u8, 2, 3, 4] + .iter() + .flat_map(|&v| [v, 0, 0, 255]) + .collect(), + ); + let (_, w, h, data) = wrap_border(&image); + assert_eq!((w, h), (4, 4)); + let red: Vec = data.chunks(4).map(|t| t[0]).collect(); + #[rustfmt::skip] + assert_eq!(red, [ + 4, 3, 4, 3, + 2, 1, 2, 1, + 4, 3, 4, 3, + 2, 1, 2, 1, + ]); + } + #[test] fn the_fonts_only_atlas_measures_text_like_the_full_one() { // A synthetic default font: two 8x8 glyphs, 3 and 5 pixels wide. diff --git a/crates/horizon-client/src/screen.wgsl b/crates/horizon-client/src/screen.wgsl index f32274bc8..e70aeb896 100644 --- a/crates/horizon-client/src/screen.wgsl +++ b/crates/horizon-client/src/screen.wgsl @@ -3,51 +3,49 @@ // with the sampler vanilla gives it (ReloadableTexture.setSampler: linear // when `blur`, clamp-to-edge when `clamp`, else nearest and repeat). @group(0) @binding(1) var atlas: texture_2d; +// The block sprites' sampler (nearest), and the entity group's lightmap +// sampler (linear) for `blur`. A blurred sprite has a one-texel border in the +// atlas, wrapped as repeat reads it (hud.rs), so the hardware's bilinear +// sample is GL_LINEAR with repeat; clamp-to-edge keeps the sample point half +// a texel inside. Each sampling has its own pipeline (gfx.rs), so a pixel +// costs what it did with nearest and repeat only: one sample. +@group(0) @binding(2) var nearest_sampler: sampler; +@group(0) @binding(4) var linear_sampler: sampler; +override BLUR: bool = false; +override CLAMP: bool = false; struct Out { @builtin(position) clip: vec4, @location(0) uv: vec2, @location(1) @interpolate(flat) rect: vec4, @location(2) color: vec4, - @location(3) @interpolate(flat) sampling: u32, + // With clamp-to-edge, the sprite's first and last texel centres. + @location(3) @interpolate(flat) edges: vec4, } @vertex fn vs_screen(@location(0) pos: vec2, @location(1) uv: vec2, - @location(2) rect: vec4, @location(3) color: vec4, - @location(4) sampling: u32) -> Out { + @location(2) rect: vec4, @location(3) color: vec4) -> Out { var out: Out; out.clip = vec4(pos, 0.0, 1.0); out.uv = uv; out.rect = rect; out.color = color; - out.sampling = sampling; + let half = 0.5 / vec2(textureDimensions(atlas)); + out.edges = vec4(rect.xy + half, rect.zw - half); return out; } -const SAMPLE_BLUR: u32 = 1u; -const SAMPLE_CLAMP: u32 = 2u; -// A texel of the sprite, addressed by repeat or clamp-to-edge. With repeat, `p` is at most one -// texel outside the sprite (`sample` reduces the coordinate first), so wrapping is a select: no -// integer division, which Intel GPUs emulate (it cost 0.85 ms a frame on the vignette on an HD 620). -fn texel(origin: vec2, size: vec2, p: vec2, clamp_edge: bool) -> vec4 { - var q = select(select(p, p - size, p >= size), p + size, p < vec2(0)); - if clamp_edge { q = clamp(p, vec2(0), size - 1); } - return textureLoad(atlas, origin + q, 0); -} fn sample(in: Out) -> vec4 { - let dims = vec2(textureDimensions(atlas)); - let origin = vec2(round(in.rect.xy * dims)); - let size = max(vec2(round((in.rect.zw - in.rect.xy) * dims)), vec2(1)); - let clamp_edge = (in.sampling & SAMPLE_CLAMP) != 0u; - // Repeat: one period of the sprite, so every texel read is at most one outside it. - let p = select(fract(in.uv), in.uv, clamp_edge) * vec2(size); - if (in.sampling & SAMPLE_BLUR) == 0u { - return texel(origin, size, vec2(floor(p)), clamp_edge) * in.color; + var f = in.uv; + if !CLAMP { + // Repeat: one period of the sprite. + f = fract(f); } - // GL_LINEAR: the four texels around the sample point, weighted. - let c = p - 0.5; - let i = vec2(floor(c)); - let t = c - floor(c); - let a = mix(texel(origin, size, i, clamp_edge), texel(origin, size, i + vec2(1, 0), clamp_edge), t.x); - let b = mix(texel(origin, size, i + vec2(0, 1), clamp_edge), texel(origin, size, i + vec2(1, 1), clamp_edge), t.x); - return mix(a, b, t.y) * in.color; + var uv = in.rect.xy + f * (in.rect.zw - in.rect.xy); + if CLAMP { + uv = clamp(uv, in.edges.xy, in.edges.zw); + } + if BLUR { + return textureSampleLevel(atlas, linear_sampler, uv, 0.0) * in.color; + } + return textureSampleLevel(atlas, nearest_sampler, uv, 0.0) * in.color; } @fragment fn fs_screen(in: Out) -> @location(0) vec4 { let c = sample(in); diff --git a/crates/horizon-client/src/screen_effects.rs b/crates/horizon-client/src/screen_effects.rs index 48f468d4d..269a534e7 100644 --- a/crates/horizon-client/src/screen_effects.rs +++ b/crates/horizon-client/src/screen_effects.rs @@ -27,8 +27,6 @@ pub struct ScreenVertex { /// Atlas rectangle (u0, v0, u1, v1) of the sprite. pub rect: [f32; 4], pub color: [f32; 4], - /// How the sprite is sampled: [`SAMPLE_BLUR`] and [`SAMPLE_CLAMP`]. - pub sampling: u32, } /// Linear filtering (`TextureMetadataSection.blur`), else nearest. pub const SAMPLE_BLUR: u32 = 1; @@ -43,6 +41,8 @@ pub fn sampling(flags: TextureFlags) -> u32 { pub struct ScreenQuad { pub vertices: [ScreenVertex; 4], pub blend: Blend, + /// How the sprite is sampled: [`SAMPLE_BLUR`] and [`SAMPLE_CLAMP`]. + pub sampling: u32, } /// What the camera sees this frame. @@ -124,9 +124,9 @@ impl ScreenEffects { uv: uv[i], rect, color, - sampling, }), blend: Blend::Alpha, + sampling, }; let full = [[-1.0, -1.0], [1.0, -1.0], [1.0, 1.0], [-1.0, 1.0]]; // ScreenEffectRenderer.submitBlockSprite: u1/v1 at (-1, -1), colour 0xFF191919. @@ -187,10 +187,10 @@ impl ScreenEffects { uv: [[0.0, 0.0], [1.0, 0.0], [1.0, 1.0], [0.0, 1.0]][i], rect, color, - sampling, } }), blend, + sampling, }; let rgba = |c: u32| { let [a, r, g, b] = c.to_be_bytes(); @@ -213,6 +213,12 @@ impl ScreenEffects { } else { Blend::Alpha }; + // The vignette darkens by texture × colour: black (in + // daylight its brightness fades to 0 within half a + // minute) leaves every pixel as it was. + if blend == Blend::Vignette && color & 0x00ff_ffff == 0 { + continue; + } if let Some(rect) = sprite(texture) { out.push(gui(rect, rgba(*color), blend, texture_sampling(texture))); } @@ -283,7 +289,18 @@ mod tests { let quads = e.build(&input); assert_eq!(quads.len(), 1); assert_eq!(quads[0].blend, Blend::Vignette); - assert_eq!(quads[0].vertices[0].sampling, 0); + assert_eq!(quads[0].sampling, 0); + // A black vignette (faded out in daylight) changes no pixel: no quad. + // Below 1/255 the colour's channels are 0; a border warning tints it. + for (brightness, warning, drawn) in [(0.003, 0.0, 0), (0.004, 0.0, 1), (0.0, 0.5, 1)] { + let overlays = [crate::hud_overlays::vignette(320, 240, brightness, warning)]; + let input = ScreenInputs { + block_overlay: None, + gui_overlays: &overlays, + ..input + }; + assert_eq!(e.build(&input).len(), drawn, "{brightness} {warning}"); + } } #[test] fn standalone_textures_sample_by_their_metadata() { @@ -323,7 +340,7 @@ mod tests { on_fire: false, gui_overlays: &[crate::hud_overlays::vignette(320, 240, 1.0, 0.0)], }); - let sampling: Vec<_> = quads.iter().map(|q| q.vertices[0].sampling).collect(); + let sampling: Vec<_> = quads.iter().map(|q| q.sampling).collect(); assert_eq!(sampling, [0, SAMPLE_CLAMP, SAMPLE_BLUR]); } #[test] From 5c9f11b9546e4067ba9fc406290024a3428e64fc Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 07:58:53 +0200 Subject: [PATCH 101/126] Benchmark: a 1080p set next to 720p perf_bench ran every game in a 1280x720 window only. It now runs the standard set at 1280x720 and 1920x1080 (--sizes picks others), each size its own reports:

    05Releases

    Recently added

    -

    Alpha builds come out many times a day, as changes land; about once a day the tested ones become Stable, the launcher's default. The newest, and what they added:

    +

    New versions come out many times a day, as changes land, and the launcher installs each one once it has passed its test. The newest, and what they added:

    {{RECENT}} diff --git a/website/src/main.js b/website/src/main.js index 4298cf1fd..7a0714d1b 100644 --- a/website/src/main.js +++ b/website/src/main.js @@ -17,9 +17,9 @@ const reducedMotion = matchMedia("(prefers-reduced-motion: reduce)").matches; const isLauncher = (r) => isLauncherTag(r.tag_name) && !r.prerelease; -// The newest 100 releases (GitHub's most per page). Game betas come out several times a day, so the stable game -// release and the newest launcher release can both be older than all of them. The stable game release is then -// GitHub's "latest" (betas and launcher releases are never marked latest); the launcher release is looked up by its +// The newest 100 releases (GitHub's most per page). The newest game release that is not a pre-release (the old +// Alpha channel's, docs/release-flow.md) and the newest launcher release can be older than all of them. The game +// release is then GitHub's "latest" (pre-releases and launcher releases never are); the launcher release is looked up by its // tag (the newest launcher@ tag with a published release, or launcher-v before 0.2: docs/versioning.md). async function loadReleases() { const list = (await get(`https://api.github.com/repos/${REPO}/releases?per_page=100`)).filter((r) => !r.draft).map(slim); @@ -83,7 +83,7 @@ async function setUpDownload() { // --- Recently added and the links from main --------------------------------- -// "Recently added": the newest game releases, Alpha and Stable. +// "Recently added": the newest game releases. async function setUpRecent() { const html = recentHtml((await releases).filter((r) => isGame(r.tag_name))); if (html) document.getElementById("recent-releases").innerHTML = html; diff --git a/website/src/releases.html b/website/src/releases.html index f0e4b2de4..989164653 100644 --- a/website/src/releases.html +++ b/website/src/releases.html @@ -4,7 +4,7 @@ Releases · Horizon - + @@ -30,11 +30,10 @@

    ReleasesEvery version, newest first

    What's new in Horizon

    -

    Each release lists what it adds and fixes, then its full notes and its downloads. Alpha builds come out many times a day as changes land and can break; about once a day the tested ones become Stable, what the launcher installs unless you pick Alpha in its Settings. The launcher has its own releases.

    +

    Each release lists what it adds and fixes, then its full notes and its downloads. New versions come out many times a day as changes land, and the launcher installs each one once it has passed its test. The launcher has its own releases.

    - - +

    {{RELEASE_COUNT}}

    diff --git a/website/src/releases.js b/website/src/releases.js index 2e6a2e524..de59c8fef 100644 --- a/website/src/releases.js +++ b/website/src/releases.js @@ -1,13 +1,13 @@ // The release notes on the site: the home page's "Recently added" block and the Releases page (every release, // newest first). Shared by build.mjs (baked into the pages) and the pages' scripts (refreshed from GitHub). // Tags: the game's vX.Y.Z and the launcher's launcher@X.Y.Z from 0.2, vYYYY.MM.DD[.N] and launcher-vX.Y.Z before -// (src/versions.js). Alpha is a game pre-release, Stable a game release (docs/release-flow.md, "Channels"). +// (src/versions.js). One channel (docs/release-flow.md, "One channel"): a release is the game's or the launcher's. import { markdown, inline, escape } from "./markdown.js"; import { isLauncher, launcherVersion, newestFirst } from "./versions.js"; const REPO = "ludovic111/horizon"; -export const channel = (r) => (isLauncher(r.tag_name) ? "Launcher" : r.prerelease ? "Alpha" : "Stable"); +export const channel = (r) => (isLauncher(r.tag_name) ? "Launcher" : "Game"); const anchor = (r) => `release-${r.tag_name.replace(/[^\w.-]/g, "-")}`; // "Horizon 0.2.3: Cave culling, weather" (before 0.2, "Horizon 2026.10.13: …") reads as the version and its line. @@ -90,7 +90,7 @@ export function recentHtml(list, { rows = 5, picks = 3 } = {}) { }) .join(""); // What landed last: the "New" items of the newest releases with the highest pull request numbers (a release's - // notes list everything since the last Stable, oldest first). + // notes list everything since the release before it, oldest first). const pr = (item) => Math.max(0, ...[...item.matchAll(/#(\d+)/g)].map((m) => Number(m[1]))); const seen = new Set(); const picked = game diff --git a/website/src/style.css b/website/src/style.css index 8517a2f43..323cd6e83 100644 --- a/website/src/style.css +++ b/website/src/style.css @@ -630,14 +630,13 @@ code { border-radius: 0; background: var(--well); box-shadow: 0 0 0 1px var(--ou .page-main > .container > .lede { font-size: var(--text-body); } .page-main .disclaimer { margin-top: 48px; } -/* Channel and source badges: small square tags. */ +/* Release and source badges: small square tags. */ .badge { display: inline-flex; align-items: center; height: 22px; padding: 0 8px; margin-right: 10px; vertical-align: 2px; font: 500 12px / 1 var(--pixel); letter-spacing: 0.02em; text-transform: uppercase; white-space: nowrap; border: var(--block-outline) solid var(--outline); background: var(--well); color: var(--ink-soft); } -.badge-stable { background: color-mix(in srgb, var(--success) 22%, var(--panel)); color: var(--ink); } -.badge-alpha { background: color-mix(in srgb, var(--warn) 24%, var(--panel)); color: var(--ink); } +.badge-game { background: color-mix(in srgb, var(--success) 22%, var(--panel)); color: var(--ink); } .badge-launcher { background: color-mix(in srgb, var(--accent) 20%, var(--panel)); color: var(--ink); } .badge-us { background: color-mix(in srgb, var(--accent) 20%, var(--panel)); color: var(--ink); } .badge-players { background: color-mix(in srgb, var(--success) 22%, var(--panel)); color: var(--ink); } From 630f5210722059eb1d50d64f79e12fc21bac4f47 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 11:53:00 +0200 Subject: [PATCH 112/126] Launcher: one update channel, and the menu entry is never taken over Every release is now published as the release (one channel, Ludovic's decision of 2026-10-23), so the launcher drops its Stable/Alpha choice: the Updates row in Settings, `horizon-launcher update-channel` and its MCP tool, the channel on the Versions page, in `versions` and in the footer. It updates to the newest game release that is not a pre-release (GitHub's latest) and looks every 30 minutes. The pre-releases of the old Alpha channel stay listed and installable by hand, never as an update. Old `update_channel` / `beta_builds` keys in settings.json are ignored. On Linux a release build that starts no longer rewrites the applications-menu entry to point at itself. It writes the entry only when there is none, or when the program it starts (TryExec, else Exec) no longer exists; turning the Settings switch on or `desktop-entry` still points it at this launcher, and HORIZON_LAUNCHER_DESKTOP_EXEC is still honored. A test build started with the real HOME took over a working entry and then left it broken when its target/ was deleted (2026-10-23). Co-Authored-By: Claude Opus 5.5 --- docs/agent-control.md | 3 +- docs/launcher-commands.md | 10 - launcher/README.md | 30 +-- launcher/src/backend.rs | 233 +++++------------- launcher/src/backend/release_loading_tests.rs | 4 - launcher/src/cli.rs | 26 +- launcher/src/cli_tools.rs | 1 - launcher/src/desktop.rs | 147 ++++++++++- launcher/src/main.rs | 63 +---- website/docs/agents.md | 2 +- 10 files changed, 230 insertions(+), 289 deletions(-) diff --git a/docs/agent-control.md b/docs/agent-control.md index 5383cc03c..9d5db2597 100644 --- a/docs/agent-control.md +++ b/docs/agent-control.md @@ -71,7 +71,6 @@ passes on without checking it). | Dedicated server here: start, console, log, stop | Servers | yes | yes | yes | yes | `server`; MCP `server`, `server_command`, `server_log`, `server_stop` | | Hosted servers: list, create, set up, run a command, forget | Servers | yes | no | yes | yes | `servers ...`; `servers_forget` needs `confirm` | | Accounts: list, sign in, sign out, select, offline | Settings | yes | part | yes | yes | names and UUIDs only; sign-in is a device code; `account_offline` was missing | -| Update channel (Alpha, Stable) | Settings | yes | yes | yes | yes | | | Game folder, server folder, install new versions, opening animation | Settings | no | no | yes | yes | `settings [KEY VALUE]` | | Extra game arguments | Settings | yes | no | yes | yes | `game-args` | | Applications menu entry (Linux) | Settings | yes | no | yes | yes | `desktop-entry` | @@ -148,7 +147,7 @@ The switch is in three places: Settings > AI in the launcher, Horizon Settings i | Companion (#1068) | uses the same switch (see horizon-parity companion-notes.md) | Every other launcher command stays usable: versions, install, remove, prepare, play, server, -notes, links, account, update-channel, settings, game-args, logs, update, desktop-entry, data, +notes, links, account, settings, game-args, logs, update, desktop-entry, data, modpack, mods, servers, no-ai and benchmark. None of them drives the game for an agent. The launcher itself, packagers, the docs and players' scripts need them, and `no-ai` has to stay to turn the switch off. diff --git a/docs/launcher-commands.md b/docs/launcher-commands.md index 579659e68..9e09cd00b 100644 --- a/docs/launcher-commands.md +++ b/docs/launcher-commands.md @@ -130,16 +130,6 @@ Play offline, without an account. MCP: `account_offline`. -## `horizon-launcher update-channel` - -Show or set which Horizon releases install by themselves: stable (a tested build about once a day) or alpha (every release as soon as it is built; can break). - - horizon-launcher update-channel [CHANNEL] - -- `CHANNEL` (stable, alpha): Omit to show the current channel - -MCP: `update_channel`. - ## `horizon-launcher settings` Show the launcher's settings, or set one (the Settings page): selected-version TAG, minecraft-dir PATH, server-dir PATH ("default" resets a folder), install-new-versions on|off, opening-animation on|off. diff --git a/launcher/README.md b/launcher/README.md index e12ed2439..16ef197c7 100644 --- a/launcher/README.md +++ b/launcher/README.md @@ -78,16 +78,13 @@ page `servers.json` (the list), `servers//` (the servers created there) an `server-runtime/` (the programs and game files they run). - **Settings**: install new Horizon versions automatically (on unless you turn it off; the - selected version only moves to the new one if you were on the newest), which ones (Updates, - below), the opening animation, the game's extra command-line arguments, and the launcher's own - version and update state. -- **Updates**: **Stable** (the default) installs a tested build about once a day, the betas that - `promote.yml` makes stable; **Alpha** installs every release as soon as it is built, several - times a day, and can break (docs/release-flow.md, "Channels"). While it is open, the launcher - looks for new releases every 4 hours on Stable and every 30 minutes on Alpha. Kept as `update_channel` in - `settings.json`; a `beta_builds: true` from launchers before 0.2 reads as Alpha (so does a `nightly` from the channel's first name). - `horizon-launcher update-channel [stable|alpha]` shows or sets it. The **Versions** page - shows each release's channel. The launcher's own updates don't depend on it. + selected version only moves to the new one if you were on the newest), the opening animation, + the game's extra command-line arguments, and the launcher's own version and update state. +- **Updates**: there is one channel. Every release is published as the release, GitHub's latest, + once its smoke test passed (docs/release-flow.md), and the launcher installs it. The game + pre-releases of the old Alpha channel (v0.2.1 on) stay on the Versions page to install + by hand, but are never installed as an update. The `update_channel` and `beta_builds` keys + older launchers wrote in `settings.json` are ignored and dropped on the next save. - **Game arguments**: extra arguments added to the game's command line (for example `--server-thread`), one line where quotes group a word with spaces. They are appended after the launcher's own arguments, kept as `game_args` in `settings.json`, and apply the next time the @@ -102,7 +99,7 @@ their content overflows. Drag the thumb or click the track to navigate without a ## Updates -The launcher looks for a newer Horizon release when it starts and every four hours while it +The launcher looks for a newer Horizon release when it starts and every 30 minutes while it is open, and shows a small "available, Install" line on Play. It also updates itself from GitHub releases tagged `launcher@X.Y.Z` (Horizon's own are `vX.Y.Z`; @@ -111,8 +108,14 @@ every 0.2 tag counts as newer than all of those (docs/versioning.md). It downloa own binary, and offers "Restart" in the footer. Development builds and `HORIZON_LAUNCHER_NO_SELF_UPDATE=1` never replace themselves. +On Linux a release build that starts writes its applications-menu entry only when there is +none, or when the program the entry starts (its `TryExec`, else its `Exec`) no longer exists. +An entry pointing at another launcher that works is left alone, so a test or development build +never takes it over. Turning the Settings switch on, or `horizon-launcher desktop-entry`, +points the entry at this launcher whatever is there. + Linux packagers can set `HORIZON_LAUNCHER_DESKTOP_EXEC` to a wrapper's absolute path. -Menu entries created by Settings or `desktop-entry` then start that wrapper, which can +Menu entries the launcher writes then start that wrapper, which can set `HORIZON_LAUNCHER_NO_SELF_UPDATE=1` to keep launcher updates with the package manager. Launcher releases are automatic (docs/release-flow.md in the repository): when main changes the @@ -134,7 +137,6 @@ The same binary is a command-line tool; without a subcommand it opens the window horizon-launcher server [--dir ] [--version ] [--accept-eula] horizon-launcher notes [] patch notes as plain text horizon-launcher links the Discord, sponsor and website links - horizon-launcher update-channel [stable|alpha] show or set which releases install by themselves horizon-launcher game-args [] show or set the extra arguments the game starts with horizon-launcher update [--check] Horizon and the launcher horizon-launcher logs [--lines N] [--crash] the end of the game's log, or its newest crash report @@ -168,7 +170,7 @@ The same binary is a command-line tool; without a subcommand it opens the window horizon-launcher data benchmark upload a benchmark report, printed first `--json` prints JSON where there is something to report (`versions`, `install`, `notes`, -`next`, `links`, `update-channel`, `game-args`, `update --check`, `logs`, `account`, `benchmark`, `data`, `modpack`). Errors go to stderr with exit code 1. `server` runs in the terminal, +`next`, `links`, `game-args`, `update --check`, `logs`, `account`, `benchmark`, `data`, `modpack`). Errors go to stderr with exit code 1. `server` runs in the terminal, so lines you type reach its console. `HORIZON_LAUNCHER_HOME` replaces the data folder (for scripts and tests). diff --git a/launcher/src/backend.rs b/launcher/src/backend.rs index f88171c4e..87034c43f 100644 --- a/launcher/src/backend.rs +++ b/launcher/src/backend.rs @@ -37,8 +37,9 @@ pub struct Release { pub body: String, pub date: String, pub asset: Option<(String, u64)>, - /// A beta: a game release not promoted to stable yet (a GitHub pre-release, docs/release-flow.md). - pub beta: bool, + /// A GitHub pre-release: the Alpha builds from before every release went out as the release + /// (v0.2.1 on, docs/release-flow.md). Listed and installed by hand, never as an update. + pub prerelease: bool, } #[cfg(all(target_os = "linux", target_arch = "x86_64"))] @@ -264,7 +265,7 @@ fn parse_releases( .take(10) .collect(), asset: found, - beta: r["prerelease"].as_bool().unwrap_or(false), + prerelease: r["prerelease"].as_bool().unwrap_or(false), }); } out.sort_by(|a, b| compare_versions(&b.tag, &a.tag)); @@ -348,75 +349,14 @@ pub fn latest(releases: &[Release]) -> Option<&Release> { releases.iter().find(|r| r.asset.is_some()) } -/// The releases a launcher installs by itself: stable ones, and betas too on the Alpha channel. -pub fn channel(releases: &[Release], channel: UpdateChannel) -> Vec { - releases - .iter() - .filter(|r| channel.takes(r)) - .cloned() - .collect() +/// The releases a launcher installs by itself: every one that is published as a release, so +/// GitHub's latest when it comes out. The pre-releases of the old Alpha channel are left out. +pub fn installable_updates(releases: &[Release]) -> Vec { + releases.iter().filter(|r| !r.prerelease).cloned().collect() } -/// Which game releases install by themselves (Settings, "Updates"; docs/release-flow.md, "Channels"). -#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, serde::Serialize, serde::Deserialize)] -#[serde(rename_all = "lowercase")] -pub enum UpdateChannel { - /// A tested build about once a day: the betas promote.yml makes stable. - #[default] - Stable, - /// Every release as soon as it is built, pre-releases included. It was called "nightly" - /// while the channels were new: that name is still read. - #[serde(alias = "nightly")] - Alpha, -} - -impl UpdateChannel { - pub fn name(self) -> &'static str { - match self { - UpdateChannel::Stable => "stable", - UpdateChannel::Alpha => "alpha", - } - } - - /// Its name in Settings and on the Versions page. - pub fn label(self) -> &'static str { - match self { - UpdateChannel::Stable => "Stable", - UpdateChannel::Alpha => "Alpha", - } - } - - pub fn parse(name: &str) -> Option { - match name { - "stable" => Some(UpdateChannel::Stable), - "alpha" | "nightly" => Some(UpdateChannel::Alpha), - _ => None, - } - } - - /// Whether this channel installs `release`: betas only reach Alpha. - pub fn takes(self, release: &Release) -> bool { - self == UpdateChannel::Alpha || !release.beta - } - - /// How often a launcher left open looks for new releases: Alpha's come many times a day, - /// Stable's once. - pub fn check_every(self) -> std::time::Duration { - std::time::Duration::from_secs(match self { - UpdateChannel::Stable => 4 * 3600, - UpdateChannel::Alpha => 30 * 60, - }) - } - - /// The channel a release is on when it is listed: betas are Alpha's only. - pub fn of(release: &Release) -> Self { - if release.beta { - UpdateChannel::Alpha - } else { - UpdateChannel::Stable - } - } -} +/// How often a launcher left open looks for new releases: they come out several times a day. +pub const CHECK_EVERY: std::time::Duration = std::time::Duration::from_secs(30 * 60); /// The community, sponsor and website links, from `launcher/links.json` on main, so they can change /// without a launcher release. An empty address hides its button. @@ -1745,17 +1685,10 @@ fn launcher_update_from(releases: &[Release], own: &str) -> Option { pub fn releases_and_updates( on_releases: impl FnOnce(Result, String>), ) -> Result { - releases_and_updates_with( - Settings::load().update_channel, - release_list, - installed, - launcher_releases_in, - on_releases, - ) + releases_and_updates_with(release_list, installed, launcher_releases_in, on_releases) } fn releases_and_updates_with( - update_channel: UpdateChannel, load: impl FnOnce() -> Result, installed: impl FnOnce() -> Vec, launchers: impl FnOnce(&serde_json::Value) -> Vec, @@ -1769,7 +1702,7 @@ fn releases_and_updates_with( } }; let releases = parse_releases(&list, ASSET, is_game_tag); - let horizon = horizon_update(&channel(&releases, update_channel), &installed()); + let horizon = horizon_update(&installable_updates(&releases), &installed()); on_releases(Ok(releases)); Ok(Updates { horizon, @@ -1791,15 +1724,14 @@ pub fn select_after_update(selected: Option<&str>, installed_before: &[String]) } } -/// Installs `tag` (or with "latest" the newest release of the player's channel), then updates the selection as +/// Installs `tag` (or with "latest" the newest release, pre-releases left out), then updates the selection as /// `select_after_update` says when `as_update`, or always selects it otherwise. pub fn install_tag(tag: &str, as_update: bool, progress: impl Fn(f32)) -> Result { let releases = releases()?; let release = if tag == "latest" { - let update_channel = Settings::load().update_channel; releases .iter() - .find(|r| r.asset.is_some() && update_channel.takes(r)) + .find(|r| r.asset.is_some() && !r.prerelease) .ok_or("No release has a build for this platform yet.")? } else { releases @@ -2262,10 +2194,6 @@ pub struct Settings { /// default. Appended after the launcher's own arguments, so they can add to or override them. #[serde(default, skip_serializing_if = "String::is_empty")] pub game_args: String, - /// Which releases install by themselves: Stable by default. Launchers before 0.2 had a "Beta - /// builds" switch instead; [`Settings::parse`] reads its `beta_builds: true` as Alpha. - #[serde(default)] - pub update_channel: UpdateChannel, /// Dark, Light, or the system's: the launcher's look. Dark by default. #[serde(default)] pub appearance: Appearance, @@ -2284,20 +2212,7 @@ impl Settings { return Self::default(); }; if let Some(fields) = value.as_object_mut() { - // The switch from before 0.2: on meant every release at once, the Alpha channel. - if fields.remove("beta_builds") == Some(serde_json::Value::Bool(true)) { - fields - .entry("update_channel") - .or_insert_with(|| UpdateChannel::Alpha.name().into()); - } - // A channel this launcher doesn't know is Stable, not a reason to lose every setting. - if fields - .get("update_channel") - .is_some_and(|c| c.as_str().and_then(UpdateChannel::parse).is_none()) - { - fields.remove("update_channel"); - } - // The same for an appearance from a newer launcher. + // An appearance from a newer launcher is Dark, not a reason to lose every setting. if fields .get("appearance") .is_some_and(|a| serde_json::from_value::(a.clone()).is_err()) @@ -2517,41 +2432,35 @@ mod tests { assert_eq!(offered(&["v2026.10.15.1", "v2026.10.14"]), None); } - /// Betas (GitHub pre-releases) install by themselves only on the Alpha channel; Stable waits - /// for promote.yml's daily promotion (docs/release-flow.md, "Channels"). + /// Every release is published as the release, and launchers update to it. The pre-releases + /// of the old Alpha channel (v0.2.1 on) are only installed by hand: a launcher that + /// had one installed waits for the next release instead of going back. #[test] - fn updates_follow_the_stable_channel_unless_alpha_is_picked() { + fn updates_follow_every_release_and_leave_the_old_alpha_ones_out() { let asset = ASSET.unwrap_or("horizon-linux-x86_64.tar.gz"); let list = serde_json::json!([ - {"tag_name": "v2026.10.19.02", "prerelease": true, "assets": [{"name": asset, "browser_download_url": "b", "size": 1}]}, - {"tag_name": "v2026.10.19.01", "assets": [{"name": asset, "browser_download_url": "s", "size": 1}]}, + {"tag_name": "v0.2.13", "assets": [{"name": asset, "browser_download_url": "n", "size": 1}]}, + {"tag_name": "v0.2.12", "prerelease": true, "assets": [{"name": asset, "browser_download_url": "a", "size": 1}]}, + {"tag_name": "v0.2.0", "assets": [{"name": asset, "browser_download_url": "s", "size": 1}]}, ]); let releases = parse_releases(&list, Some(asset), is_game_tag); assert_eq!( - releases.iter().map(|r| r.beta).collect::>(), - [true, false] + releases.iter().map(|r| r.prerelease).collect::>(), + [false, true, false] ); - let offered = |alpha: bool, installed: &[&str]| { + let offered = |releases: &[Release], installed: &[&str]| { let installed: Vec = installed.iter().map(|t| t.to_string()).collect(); - let on = if alpha { - UpdateChannel::Alpha - } else { - UpdateChannel::Stable - }; - horizon_update(&channel(&releases, on), &installed).map(|r| r.tag) + horizon_update(&installable_updates(releases), &installed).map(|r| r.tag) }; - assert_eq!(offered(false, &[]), Some("v2026.10.19.01".into())); - assert_eq!( - offered(true, &["v2026.10.19.01"]), - Some("v2026.10.19.02".into()) - ); - assert_eq!(offered(false, &["v2026.10.19.01"]), None); - // A beta installed earlier is never "updated" to an older stable build. - assert_eq!(offered(false, &["v2026.10.19.02"]), None); - assert_eq!( - releases.iter().map(UpdateChannel::of).collect::>(), - [UpdateChannel::Alpha, UpdateChannel::Stable] - ); + assert_eq!(offered(&releases, &[]), Some("v0.2.13".into())); + assert_eq!(offered(&releases, &["v0.2.0"]), Some("v0.2.13".into())); + assert_eq!(offered(&releases, &["v0.2.12"]), Some("v0.2.13".into())); + assert_eq!(offered(&releases, &["v0.2.13"]), None); + // Before the first release of the single channel: the old Alpha one stays where it is. + let before = &releases[1..]; + assert_eq!(offered(before, &["v0.2.0"]), None); + assert_eq!(offered(before, &["v0.2.12", "v0.2.0"]), None); + assert_eq!(CHECK_EVERY.as_secs(), 30 * 60); } #[test] @@ -2573,48 +2482,20 @@ mod tests { } #[test] - fn the_update_channel_is_stored_by_name_and_the_old_beta_switch_reads_as_alpha() { - let read = |text: &str| Settings::parse(text).update_channel; - assert_eq!(read(""), UpdateChannel::Stable); - assert_eq!(read("{}"), UpdateChannel::Stable); - assert_eq!( - read(r#"{"update_channel": "stable"}"#), - UpdateChannel::Stable - ); - assert_eq!(read(r#"{"update_channel": "alpha"}"#), UpdateChannel::Alpha); - // The channel's first name, from launchers built while it was called Nightly. - assert_eq!( - read(r#"{"update_channel": "nightly"}"#), - UpdateChannel::Alpha - ); - assert_eq!(UpdateChannel::parse("nightly"), Some(UpdateChannel::Alpha)); - // Launchers before 0.2: "Beta builds" on is Alpha, off is Stable. - assert_eq!(read(r#"{"beta_builds": true}"#), UpdateChannel::Alpha); - assert_eq!(read(r#"{"beta_builds": false}"#), UpdateChannel::Stable); - // Once a channel is picked, it wins over a switch left behind. - let both = r#"{"beta_builds": true, "update_channel": "stable"}"#; - assert_eq!(read(both), UpdateChannel::Stable); - // An unknown channel is Stable, and the rest of the settings survive it. - let odd = - Settings::parse(r#"{"update_channel": "beta", "game_args": "--x", "beta_builds": 1}"#); - assert_eq!(odd.update_channel, UpdateChannel::Stable); - assert_eq!(odd.game_args, "--x"); - // Saved as a name, without the old switch. - let mut settings = Settings::parse(r#"{"selected": "v0.2.0", "beta_builds": true}"#); - let saved = serde_json::to_value(&settings).unwrap(); - assert_eq!(saved["update_channel"], "alpha"); - assert!(saved.get("beta_builds").is_none()); - assert_eq!(saved["selected"], "v0.2.0"); - settings.update_channel = UpdateChannel::Stable; - let text = serde_json::to_string(&settings).unwrap(); - assert_eq!(read(&text), UpdateChannel::Stable); - for c in [UpdateChannel::Stable, UpdateChannel::Alpha] { - assert_eq!(UpdateChannel::parse(c.name()), Some(c)); + fn the_old_update_channel_settings_are_dropped_and_the_rest_kept() { + for old in [ + r#"{"update_channel": "alpha", "game_args": "--x", "selected": "v0.2.0"}"#, + r#"{"update_channel": "stable", "game_args": "--x", "selected": "v0.2.0"}"#, + r#"{"beta_builds": true, "game_args": "--x", "selected": "v0.2.0"}"#, + r#"{"beta_builds": false, "update_channel": "nightly", "game_args": "--x", "selected": "v0.2.0"}"#, + ] { + let settings = Settings::parse(old); + assert_eq!(settings.game_args, "--x", "{old}"); + assert_eq!(settings.selected.as_deref(), Some("v0.2.0"), "{old}"); + let saved = serde_json::to_value(&settings).unwrap(); + assert!(saved.get("update_channel").is_none(), "{old}"); + assert!(saved.get("beta_builds").is_none(), "{old}"); } - // An open launcher looks again every 4 hours on Stable, every 30 minutes on Alpha. - let minutes = |c: UpdateChannel| c.check_every().as_secs() / 60; - assert_eq!(minutes(UpdateChannel::Stable), 240); - assert_eq!(minutes(UpdateChannel::Alpha), 30); } #[test] @@ -2635,7 +2516,7 @@ mod tests { body: String::new(), date: String::new(), asset: Some(("u".into(), 1)), - beta: false, + prerelease: false, }; assert!(launcher_update(&[r(own_tag())]).is_none()); assert_eq!(launcher_version(&own_tag()), Some(VERSION)); @@ -2675,7 +2556,7 @@ mod tests { body: String::new(), date: String::new(), asset: Some(("u".into(), 1)), - beta: false, + prerelease: false, }; let mut list = vec![ r("launcher-v0.16.0"), @@ -2744,10 +2625,14 @@ mod tests { ]); let releases = parse_releases(&list, Some(asset), is_game_tag); let installed = ["v2026.10.19.15".to_string(), "v2026.10.12".to_string()]; - let offered = |on| horizon_update(&channel(&releases, on), &installed).map(|r| r.tag); - // A beta 0.2.0 reaches launchers on Alpha; Stable ones wait for its promotion. - assert_eq!(offered(UpdateChannel::Alpha), Some("v0.2.0".into())); - assert_eq!(offered(UpdateChannel::Stable), None); + // A pre-release 0.2.0 is not an update; once published as the release, it is one. + let offered = |releases: &[Release]| { + horizon_update(&installable_updates(releases), &installed).map(|r| r.tag) + }; + assert_eq!(offered(&releases), None); + let mut released = releases.clone(); + released[0].prerelease = false; + assert_eq!(offered(&released), Some("v0.2.0".into())); let mut sorted = vec![ "v2026.10.19.15".to_string(), "v0.2.1".into(), @@ -2837,7 +2722,7 @@ mod tests { body: String::new(), date: String::new(), asset: Some(("u".into(), 1)), - beta: false, + prerelease: false, }; let releases = [r("v2026.10.13"), r("v2026.10.12")]; assert_eq!( diff --git a/launcher/src/backend/release_loading_tests.rs b/launcher/src/backend/release_loading_tests.rs index 4aaa616a2..d7f839bde 100644 --- a/launcher/src/backend/release_loading_tests.rs +++ b/launcher/src/backend/release_loading_tests.rs @@ -45,7 +45,6 @@ fn baseline(load: impl Fn() -> Result) -> (Vec Result) -> (Vec, Updates) { let mut releases = None; let updates = releases_and_updates_with( - UpdateChannel::Stable, load, installed_fixture, |list| parse_releases(list, LAUNCHER_ASSET, is_launcher_tag), @@ -82,7 +81,6 @@ fn errors_reach_releases_and_updates_without_fallback() { ] { let mut published = None; let result = releases_and_updates_with( - UpdateChannel::Stable, || Err(error.into()), || panic!("no installed scan after failure"), |_| panic!("no fallback after failure"), @@ -97,7 +95,6 @@ fn errors_reach_releases_and_updates_without_fallback() { fn publish_games_before_older_launcher_fallback() { let events = RefCell::new(Vec::new()); let result = releases_and_updates_with( - UpdateChannel::Stable, || Ok(serde_json::json!([{"tag_name": "v2026.10.14", "assets": []}])), Vec::new, |list| { @@ -132,7 +129,6 @@ fn failed_launcher_fallback_keeps_game_result_and_checks_stay_fresh() { for day in [14, 15] { let mut published = None; let updates = releases_and_updates_with( - UpdateChannel::Stable, || { requests.fetch_add(1, Ordering::Relaxed); Ok(serde_json::json!([{"tag_name": format!("v2026.10.{day}")}])) diff --git a/launcher/src/cli.rs b/launcher/src/cli.rs index 732aa872b..9d8e51d93 100644 --- a/launcher/src/cli.rs +++ b/launcher/src/cli.rs @@ -287,13 +287,6 @@ enum Cmd { #[command(subcommand)] action: Option, }, - /// Show or set which Horizon releases install by themselves: stable (a tested build about once - /// a day) or alpha (every release as soon as it is built; can break) - UpdateChannel { - /// Omit to show the current channel - #[arg(value_parser = ["stable", "alpha"])] - channel: Option, - }, /// Show the launcher's settings, or set one (the Settings page): selected-version TAG, /// minecraft-dir PATH, server-dir PATH ("default" resets a folder), install-new-versions /// on|off, opening-animation on|off @@ -435,7 +428,6 @@ fn settings_json(s: &backend::Settings) -> serde_json::Value { "server_dir": backend::server_dir(None), "install_new_versions": s.install_new_versions.unwrap_or(true), "opening_animation": !s.skip_opening, - "update_channel": s.update_channel.name(), "game_args": s.game_args, "desktop_entry": s.desktop_entry.unwrap_or(true), "no_ai": backend::no_ai(), @@ -504,7 +496,7 @@ fn attached(mut cmd: Command) -> Result<(), String> { fn release_json(r: &Release) -> serde_json::Value { serde_json::json!({ - "tag": r.tag, "name": r.name, "date": r.date, "channel": backend::UpdateChannel::of(r).name(), + "tag": r.tag, "name": r.name, "date": r.date, "prerelease": r.prerelease, "available_here": r.asset.is_some(), "installed": backend::installed().contains(&r.tag), }) } @@ -555,8 +547,7 @@ fn execute(command: Cmd, as_json: bool) -> Result<(), String> { (false, true) => "", (false, false) => "no build for this platform", }; - let channel = backend::UpdateChannel::of(r).name(); - println!("{:<15} {} {:<7} {}", r.tag, r.date, channel, state); + println!("{:<15} {} {}", r.tag, r.date, state); } } Cmd::Install { tag } => { @@ -733,19 +724,6 @@ fn execute(command: Cmd, as_json: bool) -> Result<(), String> { } } } - Cmd::UpdateChannel { channel } => { - let mut settings = backend::Settings::load(); - if let Some(channel) = channel.as_deref().and_then(backend::UpdateChannel::parse) { - settings.update_channel = channel; - settings.save(); - } - let channel = settings.update_channel.name(); - if as_json { - json(serde_json::json!({ "update_channel": channel })); - } else { - println!("Update channel: {channel}"); - } - } Cmd::GameArgs { args } => { let mut settings = backend::Settings::load(); if let Some(line) = args { diff --git a/launcher/src/cli_tools.rs b/launcher/src/cli_tools.rs index 307f17dba..7653311ac 100644 --- a/launcher/src/cli_tools.rs +++ b/launcher/src/cli_tools.rs @@ -366,7 +366,6 @@ mod tests { "prepare", "notes", "update", - "update_channel", "game_args", "settings", "logs", diff --git a/launcher/src/desktop.rs b/launcher/src/desktop.rs index 1c9fe931e..281850cb6 100644 --- a/launcher/src/desktop.rs +++ b/launcher/src/desktop.rs @@ -2,8 +2,12 @@ //! `applications/horizon-launcher.desktop` (pointing at wherever the binary is now) and Horizon's //! icon into the `hicolor` theme, under `$XDG_DATA_HOME` (`~/.local/share` by default), so no root //! is needed; `horizon.desktop` (hidden from menus) gives the game's window its icon on Wayland. -//! A release build does this when it starts, and again whenever the binary has moved; the -//! Settings switch and `horizon-launcher desktop-entry --remove` take it all away again. +//! A release build writes it when it starts only if there is no entry yet or the one there starts +//! a program that is gone ([`repair`]), so a development or test build never takes over a working +//! entry. Turning the Settings switch on (or `horizon-launcher desktop-entry`) points it at this +//! binary whatever is there ([`install`]); the switch off and `desktop-entry --remove` take it all +//! away again. +use std::ffi::OsStr; use std::fs; use std::io; use std::path::{Path, PathBuf}; @@ -153,15 +157,85 @@ pub fn remove_in(data: &Path) -> io::Result<()> { Ok(()) } -/// Registers the launcher, using a distributor's wrapper when one is configured. -/// Both GUI registration (including the settings switch) and the CLI use this path. +/// The program an entry starts: its `TryExec`, else the first word of its `Exec` (unquoted as +/// [`quote`] writes it). None when the entry names neither. +fn entry_target(entry: &str) -> Option { + let mut in_main = false; + let (mut exec, mut try_exec) = (None, None); + for line in entry.lines().map(str::trim) { + if line.starts_with('[') { + in_main = line == "[Desktop Entry]"; + } else if let Some((key, value)) = line.split_once('=').filter(|_| in_main) { + match key.trim() { + "TryExec" if try_exec.is_none() => try_exec = Some(value.trim()), + "Exec" if exec.is_none() => exec = Some(value.trim()), + _ => {} + } + } + } + if let Some(program) = try_exec.filter(|p| !p.is_empty()) { + return Some(program.to_string()); + } + let exec = exec?; + let program = match exec.strip_prefix('"') { + Some(rest) => { + let (mut out, mut chars) = (String::new(), rest.chars()); + while let Some(c) = chars.next() { + match c { + '"' => break, + '\\' => out.extend(chars.next()), + c => out.push(c), + } + } + out + } + None => exec.split_whitespace().next()?.to_string(), + }; + (!program.is_empty()).then_some(program) +} + +/// Whether an entry's program is there: a path that exists, or a bare name found on `path` +/// (`$PATH`), as menus look `TryExec` up. +fn target_exists(program: &str, path: Option<&OsStr>) -> bool { + if program.contains('/') { + return Path::new(program).exists(); + } + path.is_some_and(|dirs| std::env::split_paths(dirs).any(|dir| dir.join(program).is_file())) +} + +/// Whether the launcher may write its entry by itself: there is none under `data`, or the one +/// there starts a program that no longer exists. An entry pointing at another launcher that +/// still works is left alone. +pub fn needs_repair_in(data: &Path, path: Option<&OsStr>) -> bool { + match fs::read_to_string(data.join("applications").join(LAUNCHER_ENTRY)) { + Ok(entry) => !entry_target(&entry).is_some_and(|p| target_exists(&p, path)), + Err(e) => e.kind() == io::ErrorKind::NotFound, + } +} + +/// What the entry starts: a distributor's wrapper (`HORIZON_LAUNCHER_DESKTOP_EXEC`) when one is +/// configured, else the binary at `exe`. +fn target(exe: &Path) -> PathBuf { + std::env::var_os("HORIZON_LAUNCHER_DESKTOP_EXEC") + .filter(|path| !path.is_empty()) + .map_or_else(|| exe.to_path_buf(), PathBuf::from) +} + +/// Registers the launcher whatever entry is there: for the player turning it on (the Settings +/// switch, `horizon-launcher desktop-entry`). pub fn install(exe: &Path) -> Result { let data = data_home().ok_or("No home folder to put the menu entry in.")?; - let wrapper = std::env::var_os("HORIZON_LAUNCHER_DESKTOP_EXEC") - .filter(|path| !path.is_empty()) - .map(PathBuf::from); - install_in(&data, wrapper.as_deref().unwrap_or(exe)) - .map_err(|e| format!("{}: {e}", data.display())) + install_in(&data, &target(exe)).map_err(|e| format!("{}: {e}", data.display())) +} + +/// At start: registers the launcher only when [`needs_repair_in`] says so. Returns whether it +/// wrote anything. +pub fn repair(exe: &Path) -> Result { + let data = data_home().ok_or("No home folder to put the menu entry in.")?; + if !needs_repair_in(&data, std::env::var_os("PATH").as_deref()) { + return Ok(false); + } + install_in(&data, &target(exe)).map_err(|e| format!("{}: {e}", data.display())) } pub fn remove() -> Result<(), String> { @@ -206,4 +280,59 @@ mod tests { remove_in(&data).unwrap(); let _ = fs::remove_dir_all(&data); } + + #[test] + fn the_target_is_try_exec_else_the_first_word_of_exec() { + let ours = launcher_entry(Path::new("/opt/a b/horizon \"x\"/horizon-launcher")); + assert_eq!( + entry_target(&ours).as_deref(), + Some("/opt/a b/horizon \"x\"/horizon-launcher") + ); + let without_try = ours.replace("TryExec=", "X-Old="); + assert_eq!( + entry_target(&without_try).as_deref(), + Some("/opt/a b/horizon \"x\"/horizon-launcher") + ); + let wrapper = "[Desktop Entry]\nExec=flatpak run dev.horizon.Launcher %U\n"; + assert_eq!(entry_target(wrapper).as_deref(), Some("flatpak")); + // Only the main group counts: an action's Exec is not the launcher. + let action = "[Desktop Action play]\nExec=/a\n[Desktop Entry]\nExec=/b --x\n"; + assert_eq!(entry_target(action).as_deref(), Some("/b")); + assert_eq!(entry_target("[Desktop Entry]\nName=Horizon\n"), None); + assert_eq!(entry_target("[Desktop Entry]\nExec=\nTryExec=\n"), None); + } + + /// A build that starts never takes over an entry that works (a test or development build + /// started on a player's machine, 2026-10-23); it writes one only when there is none or the + /// program it starts is gone. + #[test] + fn a_start_writes_the_entry_only_when_none_works() { + let root = + std::env::temp_dir().join(format!("horizon-desktop-repair-{}", std::process::id())); + let _ = fs::remove_dir_all(&root); + let (data, bin) = (root.join("data"), root.join("bin")); + fs::create_dir_all(&bin).unwrap(); + let installed = bin.join("horizon-launcher"); + fs::write(&installed, b"").unwrap(); + let entry = data.join("applications").join(LAUNCHER_ENTRY); + let path = Some(bin.as_os_str()); + + // No entry: write one. + assert!(needs_repair_in(&data, path)); + install_in(&data, &installed).unwrap(); + // Ours works: a build elsewhere leaves it alone. + assert!(!needs_repair_in(&data, path)); + // So does one another launcher wrote, found on PATH or by its path. + fs::write(&entry, "[Desktop Entry]\nExec=horizon-launcher %U\n").unwrap(); + assert!(!needs_repair_in(&data, path)); + assert!(needs_repair_in(&data, None)); + // The program is gone (a deleted target/ folder, a moved binary): write it again. + install_in(&data, &installed).unwrap(); + fs::remove_file(&installed).unwrap(); + assert!(needs_repair_in(&data, path)); + // An entry that starts nothing is broken too. + fs::write(&entry, "[Desktop Entry]\nName=Horizon\n").unwrap(); + assert!(needs_repair_in(&data, path)); + let _ = fs::remove_dir_all(&root); + } } diff --git a/launcher/src/main.rs b/launcher/src/main.rs index 128bf1bcf..18e8295b1 100644 --- a/launcher/src/main.rs +++ b/launcher/src/main.rs @@ -238,15 +238,16 @@ impl Launcher { if settings.minecraft_dir.is_none() { settings.minecraft_dir = backend::default_minecraft_dir(); } - // Release builds on Linux keep their entry in the applications menu up to date (a moved - // binary changes it); `HORIZON_LAUNCHER_DESKTOP_ENTRY=1` does it in a development build. + // Release builds on Linux put their entry back in the applications menu when there is + // none or it starts a program that is gone (a moved or deleted binary), never over one + // that works; `HORIZON_LAUNCHER_DESKTOP_ENTRY=1` does it in a development build. if cfg!(target_os = "linux") && settings.desktop_entry() && (!cfg!(debug_assertions) || std::env::var_os("HORIZON_LAUNCHER_DESKTOP_ENTRY").is_some()) { std::thread::spawn(|| { - let _ = horizon_launcher::desktop::install(backend::exe_path()); + let _ = horizon_launcher::desktop::repair(backend::exe_path()); }); } let installed = backend::installed(); @@ -658,8 +659,10 @@ impl Launcher { changed = true; } } - let every = self.settings.update_channel.check_every(); - if self.checked.is_some_and(|at| at.elapsed() > every) { + if self + .checked + .is_some_and(|at| at.elapsed() > backend::CHECK_EVERY) + { self.check_updates(); } if changed { @@ -1698,14 +1701,10 @@ impl Launcher { )); } foot = foot.child( - caps(format!( - "Launcher {} · {}", - backend::VERSION, - self.settings.update_channel.label() - )) - .px(px(8.)) - .pt(px(6.)) - .text_color(t.muted), + caps(format!("Launcher {}", backend::VERSION)) + .px(px(8.)) + .pt(px(6.)) + .text_color(t.muted), ); div() .id("sidebar") @@ -2339,25 +2338,6 @@ impl Launcher { cx.notify(); }), ); - use backend::UpdateChannel::{Alpha, Stable}; - let this = cx.entity().downgrade(); - let update_channel = segments( - "update-channel", - &[(Stable, Stable.label()), (Alpha, Alpha.label())], - self.settings.update_channel, - &t, - move |picked, _, cx| { - let _ = this.update(cx, |this, cx| { - if this.settings.update_channel != picked { - this.settings.update_channel = picked; - this.settings.save(); - // What counts as new changed: check again (and install it if that is on). - this.check_updates(); - } - cx.notify(); - }); - }, - ); let opening = switch("opening", !self.settings.skip_opening, &t).on_click(cx.listener( |this, _: &ClickEvent, _, cx| { this.settings.skip_opening = !this.settings.skip_opening; @@ -2487,22 +2467,6 @@ impl Launcher { Some(toggle.into_any_element()), &t, )) - .child(index_row( - n + 2, - "Updates", - Some( - div() - .flex() - .flex_col() - .child("Stable: a tested build about once a day.") - .child( - "Alpha: every change as soon as it is built, several times a day; can break.", - ) - .into_any_element(), - ), - Some(update_channel.into_any_element()), - &t, - )) .child(group("Launcher", "monitor")) .child(index_row( n + 3, @@ -2955,8 +2919,7 @@ impl Launcher { let tag = release.tag.clone(); let installed = self.installed.contains(&tag); let selected = self.selected() == Some(&tag); - let channel = backend::UpdateChannel::of(&release).label(); - let mut meta = vec![channel.to_string(), release.date.clone()]; + let mut meta = vec![release.date.clone()]; if let Some((_, size)) = release.asset { meta.push(megabytes(size)); } diff --git a/website/docs/agents.md b/website/docs/agents.md index 32ba58362..02042be4d 100644 --- a/website/docs/agents.md +++ b/website/docs/agents.md @@ -9,7 +9,7 @@ Everything you can do with the mouse and keyboard, through commands instead of c - **In the launcher:** - install, remove and prepare versions; - start the game, alone or with a world, or a server; - - your settings, the update channel and the extra game arguments; + - your settings and the extra game arguments; - the mod browser (mods, resource packs, shader packs, modpacks), imported modpacks and hosted servers; - your accounts (names only), logs and crash reports, patch notes, the data collection settings and the benchmark. - **In the game:** From 9fcf91e4bce67dce335874e97fa8eb3fbc05dfec Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 11:09:56 +0200 Subject: [PATCH 113/126] Metal: occlusion culling of solid sections, the depth test in the shader GPU occlusion culling ran on Vulkan only: its test needs early fragment tests, which naga's Metal backend does not emit. On Metal the boxes are tested in a pass of their own: phase 1's depth is bound read-only as the attachment and as a texture, and the fragment shader compares its own depth with it (reversed Z, greater or equal), as the fixed-function test would. HORIZON_GPU_CULL=shader takes this path on Vulkan too, for checks. Frames drawn flat (the default on Apple GPUs at high render distances) still skip culling here. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/gfx.rs | 64 +++++-- crates/horizon-client/src/gfx/cull.rs | 213 ++++++++++++++++++++---- crates/horizon-client/src/gfx/cull.wgsl | 28 +++- 3 files changed, 246 insertions(+), 59 deletions(-) diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index e379ace7c..183f7823e 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -316,7 +316,8 @@ pub struct Renderer { flat: Option, /// `flat` draws this frame's sections (off: the per-section draws). flat_on: bool, - /// Occlusion culling of solid section draws, where multi-draw is native. + /// Occlusion culling of solid section draws, where the GPU's instance + /// counts reach a multi-draw's entries (Vulkan, Metal). cull: Option, cull_on: bool, sky: wgpu::RenderPipeline, @@ -1408,7 +1409,6 @@ impl Renderer { usage: wgpu::BufferUsages::VERTEX | wgpu::BufferUsages::COPY_DST, mapped_at_creation: false, }); - let depth = Self::depth(&device, &config); let (atlas_pixels, atlas_width, atlas_height) = hud_atlas; let atlas = device.create_texture_with_data( &queue, @@ -2112,14 +2112,22 @@ impl Renderer { .features() .contains(wgpu::Features::INDIRECT_FIRST_INSTANCE); // HORIZON_GPU_CULL=0 turns occlusion culling off, `all` culls every - // frame however little it hides (A/B checks). + // frame however little it hides, `shader` tests in the shader as on + // Metal (A/B checks). let cull_env = std::env::var("HORIZON_GPU_CULL"); - let cull = (cull_env.as_deref() != Ok("0") && cull::Cull::supported(&adapter, &device)) - .then(|| { - let mut cull = cull::Cull::new(&device, config.format.remove_srgb_suffix()); + let cull = cull::Cull::supported(&adapter, &device) + .filter(|_| cull_env.as_deref() != Ok("0")) + .map(|depth_test| match cull_env.as_deref() { + Ok("shader") => cull::DepthTest::InShader, + _ => depth_test, + }) + .map(|depth_test| { + let mut cull = + cull::Cull::new(&device, config.format.remove_srgb_suffix(), depth_test); cull.always = cull_env.as_deref() == Ok("all"); cull }); + let depth = Self::depth(&device, &config, cull.as_ref()); let world_post = world_post::Post::new(&device, config.format.remove_srgb_suffix()); let uploads = upload::Uploads::new(&device); let section_uploads = upload::Uploads::with_chunk(&device, SECTION_UPLOAD_CHUNK); @@ -2327,7 +2335,13 @@ impl Renderer { self.surface = Some(surface); Ok(()) } - fn depth(device: &wgpu::Device, config: &wgpu::SurfaceConfiguration) -> wgpu::TextureView { + /// The world's depth, which occlusion culling's test may read. + fn depth( + device: &wgpu::Device, + config: &wgpu::SurfaceConfiguration, + cull: Option<&cull::Cull>, + ) -> wgpu::TextureView { + let read = cull.is_some_and(|c| c.depth_test() == cull::DepthTest::InShader); device .create_texture(&wgpu::TextureDescriptor { label: Some("Horizon depth"), @@ -2340,7 +2354,11 @@ impl Renderer { sample_count: 1, dimension: wgpu::TextureDimension::D2, format: wgpu::TextureFormat::Depth32Float, - usage: wgpu::TextureUsages::RENDER_ATTACHMENT, + usage: if read { + wgpu::TextureUsages::RENDER_ATTACHMENT | wgpu::TextureUsages::TEXTURE_BINDING + } else { + wgpu::TextureUsages::RENDER_ATTACHMENT + }, view_formats: &[], }) .create_view(&Default::default()) @@ -2391,7 +2409,7 @@ impl Renderer { } else { self.offscreen = Some(Self::offscreen_target(&self.device, &self.config)); } - self.depth = Self::depth(&self.device, &self.config); + self.depth = Self::depth(&self.device, &self.config, self.cull.as_ref()); } /// Whether sections are drawn as one index list per frame (`flat`). pub fn flat_draws(&self) -> bool { @@ -3096,16 +3114,18 @@ impl Renderer { .inverse() .transform_point3(Vec3::ZERO); // Occlusion culling leaves the sections its last result did not see - // to phase 2, after the others, with instance counts of 0. + // to phase 2, after the others, with instance counts of 0. Frames + // drawn flat are not culled (phase 2's counts reach only per-section + // draws): those with as many draws as the last frame drew flat. + let flat_likely = self.flat_on + && self + .flat + .as_ref() + .is_some_and(|f| self.section_draws >= f.min_draws); let mut cull = self .cull .as_mut() - .filter(|_| { - self.cull_on - && !frame.title - && self.multi_draw - && !(self.flat_on && self.flat.is_some()) - }) + .filter(|_| self.cull_on && !frame.title && self.multi_draw && !flat_likely) .and_then(|cull| cull.begin(&self.device).then_some(cull)); self.phase2_draws.clear(); self.phase2_pages.clear(); @@ -3493,7 +3513,10 @@ impl Renderer { ); let flat_frame = match &mut self.flat { Some(flat) - if self.flat_on && !self.draws.is_empty() && self.draws.len() >= flat.min_draws => + if self.flat_on + && !culling + && !self.draws.is_empty() + && self.draws.len() >= flat.min_draws => { let sections = &self.sections; let lods = &self.lods; @@ -3567,6 +3590,9 @@ impl Renderer { Some((color, depth)) => (color, depth), None => (&view_target, &self.depth), }; + if culling && let Some(cull) = &mut self.cull { + cull.bind_depth(&self.device, world_depth); + } let cull = self.cull.as_ref().filter(|_| culling && solid_draws > 0); { let attachments = [Some(wgpu::RenderPassColorAttachment { @@ -3659,12 +3685,14 @@ impl Renderer { pass.set_vertex_buffer(1, self.instances.slice(..)); match cull { Some(cull) => { - // Phase 1 and the boxes against its depth, then + // Phase 1 and the boxes against its depth (in + // its pass, or one of their own on Metal), then // what they found in sight, in a pass that loads // both targets (it reads the test's results). self.draw_sections(&mut pass, &self.indirect, 0, 0, phase1_draws); cull.test(&mut pass); drop(pass); + cull.test_pass(&mut encoder); let attachments = [Some(wgpu::RenderPassColorAttachment { view: world_view, resolve_target: None, diff --git a/crates/horizon-client/src/gfx/cull.rs b/crates/horizon-client/src/gfx/cull.rs index bcb738de3..77574e850 100644 --- a/crates/horizon-client/src/gfx/cull.rs +++ b/crates/horizon-client/src/gfx/cull.rs @@ -22,8 +22,16 @@ //! Every solid draw is an entry of one of the two lists, so the CPU records //! as many draws as without culling: drivers that unroll an indirect //! multi-draw on the CPU (Mesa's on Intel Gen9) pay per entry. Phase 2's -//! counts come from the GPU, which needs a native multi-draw and forced -//! early depth tests: Vulkan. Translucent draws are not culled. +//! counts come from the GPU, which reads them from the draws themselves: +//! Vulkan's native multi-draw, and Metal's, which wgpu replays as one +//! indirect draw per entry. Translucent draws are not culled. +//! +//! Metal cannot force the depth test before a fragment shader that writes +//! storage (naga writes no `[[early_fragment_tests]]`), so there the boxes +//! are drawn in a pass of their own between the phases, which reads phase +//! 1's depth as a texture and makes the same comparison in the shader: the +//! fragment's depth against the stored one, greater or equal passing. The +//! same fragments pass, so the same sections are seen. use std::num::NonZeroU64; use std::sync::{ Arc, @@ -74,10 +82,40 @@ struct Group { group: wgpu::BindGroup, } +/// Where the boxes' depth test runs. +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub enum DepthTest { + /// Forced before the fragment shader, in phase 1's pass (Vulkan). + Early, + /// In the fragment shader, against phase 1's depth read as a texture, + /// in a pass of its own (Metal). + InShader, +} + +/// The Vulkan entry point: the depth test forced early, which naga cannot +/// write for Metal (so it is not in `cull.wgsl`, which every backend takes). +const EARLY_TEST: &str = " +@fragment +@early_depth_test(force) +fn fs_box_early(in: Box) -> @location(0) vec4 { + see(in.test); + return vec4(0.0); +} +"; + +/// The test's depth texture binding (`InShader`), for the view it was made with. +struct DepthGroup { + view: wgpu::TextureView, + group: wgpu::BindGroup, +} + pub struct Cull { pipeline: wgpu::RenderPipeline, layout: wgpu::BindGroupLayout, group: Option, + depth_test: DepthTest, + depth_layout: Option, + depth_group: Option, params: wgpu::Buffer, /// Phase 2's draws: the solid draws after phase 1's in the frame's list. pub phase2: wgpu::Buffer, @@ -134,20 +172,33 @@ impl Cull { pub fn features(adapter: &wgpu::Adapter) -> wgpu::Features { adapter.features() & wgpu::Features::SHADER_EARLY_DEPTH_TEST } - /// Whether the device draws an indirect multi-draw natively and runs - /// fragment shaders that write storage only past an early depth test. - pub fn supported(adapter: &wgpu::Adapter, device: &wgpu::Device) -> bool { - adapter.get_info().backend == wgpu::Backend::Vulkan - && device.features().contains( - wgpu::Features::SHADER_EARLY_DEPTH_TEST | wgpu::Features::INDIRECT_FIRST_INSTANCE, - ) + /// Where the device can run the test, if it can: Vulkan with early + /// depth tests, or Metal, both drawing an indirect multi-draw's entries + /// with the instance counts the GPU wrote, with fragment shaders that + /// write storage. + pub fn supported(adapter: &wgpu::Adapter, device: &wgpu::Device) -> Option { + let depth_test = match adapter.get_info().backend { + wgpu::Backend::Vulkan + if device + .features() + .contains(wgpu::Features::SHADER_EARLY_DEPTH_TEST) => + { + DepthTest::Early + } + wgpu::Backend::Metal => DepthTest::InShader, + _ => return None, + }; + (device + .features() + .contains(wgpu::Features::INDIRECT_FIRST_INSTANCE) && adapter.get_downlevel_capabilities().flags.contains( wgpu::DownlevelFlags::VERTEX_STORAGE | wgpu::DownlevelFlags::FRAGMENT_WRITABLE_STORAGE, - ) + )) + .then_some(depth_test) } /// `color` is the world pass's colour format. - pub fn new(device: &wgpu::Device, color: wgpu::TextureFormat) -> Self { + pub fn new(device: &wgpu::Device, color: wgpu::TextureFormat, depth_test: DepthTest) -> Self { let entry = |binding, visibility, ty| wgpu::BindGroupLayoutEntry { binding, visibility, @@ -180,13 +231,41 @@ impl Cull { }); let module = device.create_shader_module(wgpu::ShaderModuleDescriptor { label: Some("Section culling"), - source: wgpu::ShaderSource::Wgsl(include_str!("cull.wgsl").into()), + source: wgpu::ShaderSource::Wgsl(source(depth_test).into()), + }); + let depth_layout = (depth_test == DepthTest::InShader).then(|| { + device.create_bind_group_layout(&wgpu::BindGroupLayoutDescriptor { + label: Some("Section culling depth"), + entries: &[entry( + 0, + fragment, + wgpu::BindingType::Texture { + sample_type: wgpu::TextureSampleType::Depth, + view_dimension: wgpu::TextureViewDimension::D2, + multisampled: false, + }, + )], + }) }); let pipeline_layout = device.create_pipeline_layout(&wgpu::PipelineLayoutDescriptor { label: Some("Section culling"), - bind_group_layouts: &[Some(&layout)], + bind_group_layouts: &[Some(&layout), depth_layout.as_ref()], ..Default::default() }); + // In the shader: no colour target, and phase 1's depth attached read + // only (a pass needs an attachment), its test left to the shader. + let (fragment_entry, targets, depth_compare) = match depth_test { + DepthTest::Early => ( + "fs_box_early", + &[Some(wgpu::ColorTargetState { + format: color, + blend: None, + write_mask: wgpu::ColorWrites::empty(), + })][..], + wgpu::CompareFunction::GreaterEqual, + ), + DepthTest::InShader => ("fs_box", &[][..], wgpu::CompareFunction::Always), + }; let pipeline = device.create_render_pipeline(&wgpu::RenderPipelineDescriptor { label: Some("Section culling"), layout: Some(&pipeline_layout), @@ -204,20 +283,16 @@ impl Cull { depth_stencil: Some(wgpu::DepthStencilState { format: wgpu::TextureFormat::Depth32Float, depth_write_enabled: Some(false), - depth_compare: Some(wgpu::CompareFunction::GreaterEqual), + depth_compare: Some(depth_compare), stencil: Default::default(), bias: Default::default(), }), multisample: Default::default(), fragment: Some(wgpu::FragmentState { module: &module, - entry_point: Some("fs_box"), + entry_point: Some(fragment_entry), compilation_options: Default::default(), - targets: &[Some(wgpu::ColorTargetState { - format: color, - blend: None, - write_mask: wgpu::ColorWrites::empty(), - })], + targets, }), multiview_mask: None, cache: None, @@ -226,6 +301,9 @@ impl Cull { pipeline, layout, group: None, + depth_test, + depth_layout, + depth_group: None, params: buffer( device, "Section culling parameters", @@ -399,17 +477,69 @@ impl Cull { } } - /// In the world pass after phase 1: draw the tested boxes against its - /// depth. Leaves the pass's pipeline and group 0 changed. + pub fn depth_test(&self) -> DepthTest { + self.depth_test + } + + /// In the world pass after phase 1 (`Early`): draw the tested boxes + /// against its depth. Leaves the pass's pipeline and group 0 changed. pub fn test(&self, pass: &mut wgpu::RenderPass<'_>) { let Some(Group { group, .. }) = &self.group else { return; }; + if self.depth_test != DepthTest::Early || self.test_data.is_empty() { + return; + } + pass.set_pipeline(&self.pipeline); + pass.set_bind_group(0, group, &[]); + pass.draw(0..36, 0..self.test_data.len() as u32); + } + + /// Before the world pass (`InShader`): the binding of the depth the + /// world is drawn with this frame. + pub fn bind_depth(&mut self, device: &wgpu::Device, depth: &wgpu::TextureView) { + let Some(layout) = &self.depth_layout else { + return; + }; + if self.depth_group.as_ref().is_none_or(|g| g.view != *depth) { + self.depth_group = Some(DepthGroup { + view: depth.clone(), + group: device.create_bind_group(&wgpu::BindGroupDescriptor { + label: Some("Section culling depth"), + layout, + entries: &[wgpu::BindGroupEntry { + binding: 0, + resource: wgpu::BindingResource::TextureView(depth), + }], + }), + }); + } + } + + /// Between the phases (`InShader`): draw the tested boxes in a pass of + /// their own that reads phase 1's depth, bound by `bind_depth`. + pub fn test_pass(&self, encoder: &mut wgpu::CommandEncoder) { + let (Some(Group { group, .. }), Some(DepthGroup { view, group: depth })) = + (&self.group, &self.depth_group) + else { + return; + }; if self.test_data.is_empty() { return; } + let mut pass = encoder.begin_render_pass(&wgpu::RenderPassDescriptor { + label: Some("Section culling"), + color_attachments: &[], + depth_stencil_attachment: Some(wgpu::RenderPassDepthStencilAttachment { + view, + depth_ops: None, + stencil_ops: None, + }), + ..Default::default() + }); pass.set_pipeline(&self.pipeline); pass.set_bind_group(0, group, &[]); + pass.set_bind_group(1, depth, &[]); pass.draw(0..36, 0..self.test_data.len() as u32); } @@ -498,16 +628,33 @@ impl Cull { } } -#[cfg(test)] -mod tests { - #[test] - fn shader_validates() { - let module = naga::front::wgsl::parse_str(include_str!("cull.wgsl")).unwrap(); - naga::valid::Validator::new( - naga::valid::ValidationFlags::all(), - naga::valid::Capabilities::all(), - ) - .validate(&module) - .unwrap(); +/// The test's shader for `depth_test`. +fn source(depth_test: DepthTest) -> String { + let common = include_str!("cull.wgsl"); + match depth_test { + DepthTest::Early => format!("{common}{EARLY_TEST}"), + DepthTest::InShader => common.to_owned(), + } +} + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn shaders_validate() { + for (depth_test, capabilities) in [ + (DepthTest::Early, naga::valid::Capabilities::all()), + // What wgpu's Metal backend allows: no early depth test. + ( + DepthTest::InShader, + naga::valid::Capabilities::all() - naga::valid::Capabilities::EARLY_DEPTH_TEST, + ), + ] { + let module = naga::front::wgsl::parse_str(&source(depth_test)).unwrap(); + naga::valid::Validator::new(naga::valid::ValidationFlags::all(), capabilities) + .validate(&module) + .unwrap_or_else(|e| panic!("{depth_test:?}: {e:?}")); + } } } diff --git a/crates/horizon-client/src/gfx/cull.wgsl b/crates/horizon-client/src/gfx/cull.wgsl index faa495caf..b06d4ccc2 100644 --- a/crates/horizon-client/src/gfx/cull.wgsl +++ b/crates/horizon-client/src/gfx/cull.wgsl @@ -86,16 +86,28 @@ fn vs_box(@builtin(vertex_index) v: u32, @builtin(instance_index) t: u32) -> Box return out; } -// Runs only for fragments that pass the depth test (forced early). -@fragment -@early_depth_test(force) -fn fs_box(in: Box) -> @location(0) vec4 { - if results[in.test] != params.stamp { - results[in.test] = params.stamp; - let test = tests[in.test]; +// The box is seen at this fragment: store the stamp, and give its phase 2 +// draws their instance. +fn see(t: u32) { + if results[t] != params.stamp { + results[t] = params.stamp; + let test = tests[t]; for (var k = 0u; k < test.z; k++) { phase2[(test.y + k) * 5u + 1u] = 1u; } } - return vec4(0.0); +} + +// Phase 1's depth, where the test runs in the shader (gfx/cull.rs). +@group(1) @binding(0) var depth: texture_depth_2d; + +// The world pass's reversed depth test, greater or equal passing, made here: +// where it cannot be forced before a shader that writes storage, a fragment +// that fails it would still write. Where it can, `fs_box_early` (cull.rs) +// runs only for the fragments that pass it. +@fragment +fn fs_box(in: Box) { + if in.position.z >= textureLoad(depth, vec2(in.position.xy), 0) { + see(in.test); + } } From 14be6ca3943944c6a80ff9f747375e6c363fe7b5 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 12:03:25 +0200 Subject: [PATCH 114/126] Metal: occlusion culling with flat draws too Flat draws (one index list per frame, the default on Apple GPUs at high render distances) turned occlusion culling off. Now phase 2's draws are flattened after the test, by a compute pass that copies only the sections the test saw, and each page run is drawn indirectly with the count it reached. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/gfx.rs | 132 +++-- crates/horizon-client/src/gfx/flat.rs | 587 ++++++++++++++++----- crates/horizon-client/src/gfx/flatten.wgsl | 47 +- 3 files changed, 577 insertions(+), 189 deletions(-) diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 183f7823e..91da4f616 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -83,6 +83,40 @@ mod world_post; const COMPLETE_COLUMN: u32 = (1 << (crate::chunk::HEIGHT / 16)) - 1; /// A section's instance: its camera-relative origin and, in `w`, the step of /// its fixed-point UVs (`terrain.wgsl`'s `terrain_uv`). +/// The world pass again after occlusion culling's test: it loads both +/// targets (phase 2 draws over phase 1, reading the test's results). +fn world_pass_after_culling<'e>( + encoder: &'e mut wgpu::CommandEncoder, + view: &wgpu::TextureView, + depth: &wgpu::TextureView, + pack: bool, +) -> wgpu::RenderPass<'e> { + encoder.begin_render_pass(&wgpu::RenderPassDescriptor { + label: Some("Horizon world, after culling"), + color_attachments: &[Some(wgpu::RenderPassColorAttachment { + view, + resolve_target: None, + depth_slice: None, + ops: wgpu::Operations { + load: wgpu::LoadOp::Load, + store: wgpu::StoreOp::Store, + }, + })], + depth_stencil_attachment: Some(wgpu::RenderPassDepthStencilAttachment { + view: depth, + depth_ops: Some(wgpu::Operations { + load: wgpu::LoadOp::Load, + store: if pack { + wgpu::StoreOp::Store + } else { + wgpu::StoreOp::Discard + }, + }), + stencil_ops: None, + }), + ..Default::default() + }) +} fn section_instance(origin: [f32; 3]) -> [f32; 4] { [ origin[0], @@ -3114,18 +3148,11 @@ impl Renderer { .inverse() .transform_point3(Vec3::ZERO); // Occlusion culling leaves the sections its last result did not see - // to phase 2, after the others, with instance counts of 0. Frames - // drawn flat are not culled (phase 2's counts reach only per-section - // draws): those with as many draws as the last frame drew flat. - let flat_likely = self.flat_on - && self - .flat - .as_ref() - .is_some_and(|f| self.section_draws >= f.min_draws); + // to phase 2, after the others, with instance counts of 0. let mut cull = self .cull .as_mut() - .filter(|_| self.cull_on && !frame.title && self.multi_draw && !flat_likely) + .filter(|_| self.cull_on && !frame.title && self.multi_draw) .and_then(|cull| cull.begin(&self.device).then_some(cull)); self.phase2_draws.clear(); self.phase2_pages.clear(); @@ -3511,16 +3538,24 @@ impl Renderer { frame.hud, [self.config.width, self.config.height], ); + if culling && let Some(cull) = &mut self.cull { + cull.upload( + &self.device, + &mut self.uploads, + &mut encoder, + &self.draws[phase1_draws as usize..solid_draws as usize], + &self.instances, + &self.globals, + ); + } let flat_frame = match &mut self.flat { Some(flat) - if self.flat_on - && !culling - && !self.draws.is_empty() - && self.draws.len() >= flat.min_draws => + if self.flat_on && !self.draws.is_empty() && self.draws.len() >= flat.min_draws => { let sections = &self.sections; let lods = &self.lods; let sorted = &self.sorted_indices; + let phase2 = self.cull.as_ref().filter(|_| culling).map(|c| &c.phase2); crate::spans::time("flatten", || { flat.prepare( &self.device, @@ -3528,7 +3563,9 @@ impl Renderer { &mut self.uploads, &self.draws, &self.draw_pages, + phase1_draws as usize, solid_draws as usize, + phase2, visible .iter() .filter_map(|v| { @@ -3563,16 +3600,6 @@ impl Renderer { 0, bytemuck::cast_slice(&self.draws), ); - if culling && let Some(cull) = &mut self.cull { - cull.upload( - &self.device, - &mut self.uploads, - &mut encoder, - &self.draws[phase1_draws as usize..solid_draws as usize], - &self.instances, - &self.globals, - ); - } } let view_target = target_texture.create_view(&wgpu::TextureViewDescriptor { format: Some(self.config.format.remove_srgb_suffix()), @@ -3673,9 +3700,28 @@ impl Renderer { match self.flat.as_ref().filter(|_| flat_frame) { Some(flat) => { pass.set_pipeline(&flat.solid); - flat.draw(&mut pass, &flat.calls[..flat.solid_calls], |p| { - self.arena.buffer(p) - }); + let vertices = |p| self.arena.buffer(p); + match cull { + // As below: phase 1, the test, then phase 2's draws + // that the test saw, copied after it. + Some(cull) => { + flat.draw(&mut pass, &flat.calls[..flat.phase1_calls], vertices); + cull.test(&mut pass); + drop(pass); + cull.test_pass(&mut encoder); + flat.flatten_phase2(&mut encoder); + pass = world_pass_after_culling( + &mut encoder, + world_view, + world_depth, + pack, + ); + pass.set_bind_group(0, &self.group, &[]); + pass.set_pipeline(&flat.solid); + flat.draw_phase2(&mut pass, vertices); + } + None => flat.draw(&mut pass, &flat.calls[..flat.solid_calls], vertices), + } pass.set_bind_group(0, &self.group, &[]); pass.set_index_buffer(self.indices.slice(..), wgpu::IndexFormat::Uint32); } @@ -3693,34 +3739,12 @@ impl Renderer { cull.test(&mut pass); drop(pass); cull.test_pass(&mut encoder); - let attachments = [Some(wgpu::RenderPassColorAttachment { - view: world_view, - resolve_target: None, - depth_slice: None, - ops: wgpu::Operations { - load: wgpu::LoadOp::Load, - store: wgpu::StoreOp::Store, - }, - })]; - pass = encoder.begin_render_pass(&wgpu::RenderPassDescriptor { - label: Some("Horizon world, after culling"), - color_attachments: &attachments, - depth_stencil_attachment: Some( - wgpu::RenderPassDepthStencilAttachment { - view: world_depth, - depth_ops: Some(wgpu::Operations { - load: wgpu::LoadOp::Load, - store: if pack { - wgpu::StoreOp::Store - } else { - wgpu::StoreOp::Discard - }, - }), - stencil_ops: None, - }, - ), - ..Default::default() - }); + pass = world_pass_after_culling( + &mut encoder, + world_view, + world_depth, + pack, + ); pass.set_bind_group(0, &self.group, &[]); pass.set_pipeline(&self.solid); pass.set_index_buffer( diff --git a/crates/horizon-client/src/gfx/flat.rs b/crates/horizon-client/src/gfx/flat.rs index a1ae20d09..2d0a8d27c 100644 --- a/crates/horizon-client/src/gfx/flat.rs +++ b/crates/horizon-client/src/gfx/flat.rs @@ -11,11 +11,37 @@ //! so each block names one section: its id here, which indexes the frame's //! camera-relative origins (computed on the CPU exactly as for the instance //! attribute). +//! +//! With occlusion culling (`cull`), phase 1's draws and the translucent ones +//! are copied before the world pass, as without it. Phase 2's draws are +//! copied after the test, which tells which ones it saw: each run of a page +//! reserves room for all of its draws, the copy packs the seen ones at its +//! start, and the run is drawn indirectly with the count the copy reached. use super::arena::GRAIN; /// One section draw for `flatten.wgsl`: index count, first sorted index (or -/// `QUADS` for a solid draw), base vertex, first index in the list. +/// `QUADS` for a solid draw; phase 2: its entry in phase 2's draws), base +/// vertex, first index in the list (phase 2: its draw call in phase 2). type Range = [u32; 4]; + +/// Where a group of ranges takes its indices. +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +enum Source { + /// Solid draws: quads. + Quads, + /// Occlusion culling's phase 2: quads, of the sections its test saw. + Seen, + /// Translucent draws: this sorted index page. + Sorted(u32), +} + +/// The frame's draw calls, as `plan` lays them out. +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +struct Plan { + phase1_calls: usize, + solid_calls: usize, + total: u64, +} const QUADS: u32 = u32::MAX; const GROUP_LIMIT: u32 = 65535; @@ -38,6 +64,15 @@ pub struct Flat { pub translucent: wgpu::RenderPipeline, flatten: wgpu::ComputePipeline, compute_layout: wgpu::BindGroupLayout, + flatten_seen: wgpu::ComputePipeline, + seen_layout: wgpu::BindGroupLayout, + /// Phase 2's draw calls (`DrawIndexedIndirectArgs`), whose index counts + /// `flatten_seen` makes. + phase2_calls: wgpu::Buffer, + phase2_call_capacity: u64, + phase2_call_data: Vec<[u32; 5]>, + /// The copy of phase 2's draws, and its ranges. + phase2_group: Option<(wgpu::BindGroup, u32)>, draw_layout: wgpu::BindGroupLayout, blocks_per_page: u64, pages: Vec>, @@ -52,12 +87,14 @@ pub struct Flat { ranges: wgpu::Buffer, range_capacity: u64, range_data: Vec, - /// Segments of `range_data` by index source: (sorted index page or - /// `None` for solid draws, first range, ranges). - segments: Vec<(Option, u64, u64)>, + /// Segments of `range_data` by index source: (source, first range, + /// ranges). + segments: Vec<(Source, u64, u64)>, empty: wgpu::Buffer, - /// This frame's draw calls: solid ones, then translucent ones. + /// This frame's draw calls: solid ones (phase 1's, then phase 2's when + /// culling), then translucent ones. pub calls: Vec, + pub phase1_calls: usize, pub solid_calls: usize, /// Frames with fewer section draws keep the per-section draws. pub min_draws: usize, @@ -121,42 +158,60 @@ fn buffer( /// Lays out the frame's index list: each draw's range (destinations in draw /// order) grouped by index source into `ranges`, every group padded to /// `align` entries for binding, with `segments` naming each group; and the -/// draw calls, one per run of draws in the same vertex page, solid and -/// translucent apart. Returns the first translucent call and the list's -/// length. +/// draw calls, one per run of draws in the same vertex page, phase 1's solid +/// ones, phase 2's (draws `phase1_draws..solid_draws`) and translucent ones +/// apart. A phase 2 range names its draw in phase 2 and its call in phase 2 +/// instead of a destination: the call's room holds all of its draws. fn plan( draws: &[[u32; 5]], pages: &[(u32, Option)], + phase1_draws: usize, solid_draws: usize, align: u64, calls: &mut Vec, ranges: &mut Vec, - segments: &mut Vec<(Option, u64, u64)>, -) -> (usize, u64) { + segments: &mut Vec<(Source, u64, u64)>, +) -> Plan { calls.clear(); ranges.clear(); segments.clear(); - let mut solid_calls = None; + let (mut phase1_calls, mut solid_calls) = (None, None); let mut total = 0u64; - let mut by_source: Vec<(Option, Vec)> = Vec::new(); + let mut by_source: Vec<(Source, Vec)> = Vec::new(); for (i, (d, &(page, sorted))) in draws.iter().zip(pages).enumerate() { - let first = if sorted.is_some() { d[2] } else { QUADS }; - let range = [d[0], first, d[3], total as u32]; - match by_source.iter_mut().find(|(s, _)| *s == sorted) { - Some((_, list)) => list.push(range), - None => by_source.push((sorted, vec![range])), + if i == phase1_draws { + phase1_calls.get_or_insert(calls.len()); } if i == solid_draws { solid_calls = Some(calls.len()); } match calls.last_mut() { - Some(last) if last.page == page && i != solid_draws => last.count += d[0], + Some(last) if last.page == page && i != phase1_draws && i != solid_draws => { + last.count += d[0] + } _ => calls.push(Call { page, first: total as u32, count: d[0], }), } + let (source, range) = match sorted { + Some(p) => (Source::Sorted(p), [d[0], d[2], d[3], total as u32]), + None if (phase1_draws..solid_draws).contains(&i) => ( + Source::Seen, + [ + d[0], + (i - phase1_draws) as u32, + d[3], + (calls.len() - 1 - phase1_calls.unwrap_or(0)) as u32, + ], + ), + None => (Source::Quads, [d[0], QUADS, d[3], total as u32]), + }; + match by_source.iter_mut().find(|(s, _)| *s == source) { + Some((_, list)) => list.push(range), + None => by_source.push((source, vec![range])), + } total += u64::from(d[0]); } for (source, list) in by_source { @@ -165,7 +220,12 @@ fn plan( let padded = (ranges.len() as u64).next_multiple_of(align); ranges.resize(padded as usize, [0; 4]); } - (solid_calls.unwrap_or(calls.len()), total) + let solid_calls = solid_calls.unwrap_or(calls.len()); + Plan { + phase1_calls: phase1_calls.unwrap_or(calls.len()).min(solid_calls), + solid_calls, + total, + } } impl Flat { @@ -201,24 +261,37 @@ impl Flat { storage(2, compute, false), ], }); + let seen_layout = device.create_bind_group_layout(&wgpu::BindGroupLayoutDescriptor { + label: Some("Flatten phase 2 section draws"), + entries: &[ + storage(0, compute, true), + storage(2, compute, false), + storage(3, compute, true), + storage(4, compute, false), + ], + }); let module = device.create_shader_module(wgpu::ShaderModuleDescriptor { label: Some("Flatten section draws"), source: wgpu::ShaderSource::Wgsl(include_str!("flatten.wgsl").into()), }); - let flatten = device.create_compute_pipeline(&wgpu::ComputePipelineDescriptor { - label: Some("Flatten section draws"), - layout: Some( - &device.create_pipeline_layout(&wgpu::PipelineLayoutDescriptor { - label: Some("Flatten section draws"), - bind_group_layouts: &[Some(&compute_layout)], - ..Default::default() - }), - ), - module: &module, - entry_point: Some("flatten"), - compilation_options: Default::default(), - cache: None, - }); + let compute_pipeline = |layout: &wgpu::BindGroupLayout, entry| { + device.create_compute_pipeline(&wgpu::ComputePipelineDescriptor { + label: Some("Flatten section draws"), + layout: Some( + &device.create_pipeline_layout(&wgpu::PipelineLayoutDescriptor { + label: Some("Flatten section draws"), + bind_group_layouts: &[Some(layout)], + ..Default::default() + }), + ), + module: &module, + entry_point: Some(entry), + compilation_options: Default::default(), + cache: None, + }) + }; + let flatten = compute_pipeline(&compute_layout, "flatten"); + let flatten_seen = compute_pipeline(&seen_layout, "flatten_seen"); let storage_usage = wgpu::BufferUsages::STORAGE; Self { solid: pipeline(&layout, "Terrain solid (flat)", "fs_solid", None), @@ -230,6 +303,17 @@ impl Flat { ), flatten, compute_layout, + flatten_seen, + seen_layout, + phase2_calls: buffer( + device, + "Flat section draw calls, phase 2", + 20, + wgpu::BufferUsages::INDIRECT | storage_usage, + ), + phase2_call_capacity: 1, + phase2_call_data: Vec::new(), + phase2_group: None, draw_layout, blocks_per_page: page_vertices.div_ceil(GRAIN), pages: Vec::new(), @@ -251,6 +335,7 @@ impl Flat { segments: Vec::new(), empty: buffer(device, "No sorted indices", 16, storage_usage), calls: Vec::new(), + phase1_calls: 0, solid_calls: 0, min_draws: if std::env::var("HORIZON_FLAT_DRAWS").as_deref() == Ok("1") { 0 @@ -321,6 +406,9 @@ impl Flat { /// the origins of the sections they draw by id. Records the copy into /// `encoder`; `calls` then lists the frame's draw calls. False when the /// frame cannot be drawn flat (the per-section draws then apply). + /// + /// When culling, the solid draws from `phase1_draws` are phase 2's, which + /// `phase2` holds as the test leaves them: `flatten_phase2` copies them. #[allow(clippy::too_many_arguments)] pub fn prepare( &mut self, @@ -329,10 +417,18 @@ impl Flat { uploads: &mut super::upload::Uploads, draws: &[[u32; 5]], pages: &[(u32, Option)], + phase1_draws: usize, solid_draws: usize, + phase2: Option<&wgpu::Buffer>, origins: impl Iterator, sorted_page: impl Fn(u32) -> wgpu::Buffer, ) -> bool { + self.phase2_group = None; + let phase1_draws = if phase2.is_some() { + phase1_draws + } else { + solid_draws + }; // Origins by section id. self.origin_data.clear(); for (id, o) in origins { @@ -362,18 +458,25 @@ impl Flat { bytemuck::cast_slice(&self.origin_data), ); } - let (solid_calls, total) = plan( + let Plan { + phase1_calls, + solid_calls, + total, + } = plan( draws, pages, + phase1_draws, solid_draws, self.range_align, &mut self.calls, &mut self.range_data, &mut self.segments, ); + self.phase1_calls = phase1_calls; self.solid_calls = solid_calls; if total == 0 || total * 4 > device.limits().max_storage_buffer_binding_size { self.calls.clear(); + self.phase1_calls = 0; self.solid_calls = 0; return false; } @@ -401,22 +504,82 @@ impl Flat { 0, bytemuck::cast_slice(&self.range_data), ); + // Phase 2's calls start empty, each at the start of its room. + self.phase2_call_data.clear(); + self.phase2_call_data.extend( + self.calls[phase1_calls..solid_calls] + .iter() + .map(|c| [0, 1, c.first, 0, 0]), + ); + let phase2_calls = self.phase2_call_data.len() as u64; + if phase2_calls > self.phase2_call_capacity { + self.phase2_call_capacity = phase2_calls.next_power_of_two(); + self.phase2_calls = buffer( + device, + "Flat section draw calls, phase 2", + self.phase2_call_capacity * 20, + wgpu::BufferUsages::INDIRECT | wgpu::BufferUsages::STORAGE, + ); + } + if phase2_calls > 0 { + uploads.buffer( + encoder, + &self.phase2_calls, + 0, + bytemuck::cast_slice(&self.phase2_call_data), + ); + } + let ranges_at = |first: u64, count: u64| { + wgpu::BindingResource::Buffer(wgpu::BufferBinding { + buffer: &self.ranges, + offset: first * 16, + size: wgpu::BufferSize::new(count * 16), + }) + }; + if let (Some(phase2), Some(&(_, first, count))) = ( + phase2, + self.segments.iter().find(|(s, ..)| *s == Source::Seen), + ) { + let group = device.create_bind_group(&wgpu::BindGroupDescriptor { + label: Some("Flatten phase 2 section draws"), + layout: &self.seen_layout, + entries: &[ + wgpu::BindGroupEntry { + binding: 0, + resource: ranges_at(first, count), + }, + wgpu::BindGroupEntry { + binding: 2, + resource: self.indices.as_entire_binding(), + }, + wgpu::BindGroupEntry { + binding: 3, + resource: phase2.as_entire_binding(), + }, + wgpu::BindGroupEntry { + binding: 4, + resource: self.phase2_calls.as_entire_binding(), + }, + ], + }); + self.phase2_group = Some((group, count as u32)); + } let groups: Vec<(wgpu::BindGroup, u32)> = self .segments .iter() - .map(|&(source, first, count)| { - let sorted = source.map(&sorted_page); + .filter_map(|&(source, first, count)| { + let sorted = match source { + Source::Quads => None, + Source::Seen => return None, + Source::Sorted(page) => Some(sorted_page(page)), + }; let group = device.create_bind_group(&wgpu::BindGroupDescriptor { label: Some("Flatten section draws"), layout: &self.compute_layout, entries: &[ wgpu::BindGroupEntry { binding: 0, - resource: wgpu::BindingResource::Buffer(wgpu::BufferBinding { - buffer: &self.ranges, - offset: first * 16, - size: wgpu::BufferSize::new(count * 16), - }), + resource: ranges_at(first, count), }, wgpu::BindGroupEntry { binding: 1, @@ -428,7 +591,7 @@ impl Flat { }, ], }); - (group, count as u32) + Some((group, count as u32)) }) .collect(); let mut pass = encoder.begin_compute_pass(&wgpu::ComputePassDescriptor { @@ -464,6 +627,19 @@ impl Flat { } true } + /// After occlusion culling's test: copies the phase 2 draws it saw. + pub fn flatten_phase2(&self, encoder: &mut wgpu::CommandEncoder) { + let Some((group, count)) = &self.phase2_group else { + return; + }; + let mut pass = encoder.begin_compute_pass(&wgpu::ComputePassDescriptor { + label: Some("Flatten phase 2 section draws"), + timestamp_writes: None, + }); + pass.set_pipeline(&self.flatten_seen); + pass.set_bind_group(0, group, &[]); + pass.dispatch_workgroups((*count).min(GROUP_LIMIT), count.div_ceil(GROUP_LIMIT), 1); + } /// Draws `calls` with a flat pipeline set and `vertices` giving each /// page's vertex buffer. pub fn draw<'a>( @@ -474,15 +650,38 @@ impl Flat { ) { pass.set_index_buffer(self.indices.slice(..), wgpu::IndexFormat::Uint32); for call in calls { - let table = self.pages[call.page as usize] - .as_ref() - .and_then(|t| t.group.as_ref()) - .expect("prepared page"); - pass.set_vertex_buffer(0, vertices(call.page).slice(..)); - pass.set_bind_group(1, table, &[]); + self.bind_page(pass, call.page, &vertices); pass.draw_indexed(call.first..call.first + call.count, 0, 0..1); } } + /// Draws phase 2's calls, as `flatten_phase2` left them. + pub fn draw_phase2<'a>( + &self, + pass: &mut wgpu::RenderPass<'_>, + vertices: impl Fn(u32) -> &'a wgpu::Buffer, + ) { + pass.set_index_buffer(self.indices.slice(..), wgpu::IndexFormat::Uint32); + for (k, call) in self.calls[self.phase1_calls..self.solid_calls] + .iter() + .enumerate() + { + self.bind_page(pass, call.page, &vertices); + pass.draw_indexed_indirect(&self.phase2_calls, k as u64 * 20); + } + } + fn bind_page<'a>( + &self, + pass: &mut wgpu::RenderPass<'_>, + page: u32, + vertices: &impl Fn(u32) -> &'a wgpu::Buffer, + ) { + let table = self.pages[page as usize] + .as_ref() + .and_then(|t| t.group.as_ref()) + .expect("prepared page"); + pass.set_vertex_buffer(0, vertices(page).slice(..)); + pass.set_bind_group(1, table, &[]); + } } #[cfg(test)] @@ -516,16 +715,22 @@ mod tests { fn plan_draws_runs_of_a_page_in_order() { let (draws, pages, solid) = sample(); let (mut calls, mut ranges, mut segments) = (Vec::new(), Vec::new(), Vec::new()); - let (solid_calls, total) = plan( + let Plan { + phase1_calls, + solid_calls, + total, + } = plan( &draws, &pages, solid, + solid, 4, &mut calls, &mut ranges, &mut segments, ); assert_eq!(total, 6 * 13); + assert_eq!(phase1_calls, solid_calls); let call = |page, first, count| Call { page, first, count }; // Pages 0, 0 | 1 | 0, then translucent 0, 0 (never merged with solid). assert_eq!( @@ -539,16 +744,65 @@ mod tests { ); assert_eq!(solid_calls, 3); // Solid ranges, then each sorted page's, every group padded to 4. - assert_eq!(segments, [(None, 0, 4), (Some(0), 4, 1), (Some(1), 8, 1)]); + assert_eq!( + segments, + [ + (Source::Quads, 0, 4), + (Source::Sorted(0), 4, 1), + (Source::Sorted(1), 8, 1) + ] + ); assert_eq!(ranges[3], [24, QUADS, 1024, 36]); assert_eq!(ranges[4], [12, 6, 768, 60]); assert_eq!(ranges[8], [6, 0, 40, 72]); assert_eq!(ranges.len(), 12); } + /// Phase 2's draws (here the third and fourth) get calls of their own, + /// each with room for all of its draws, and ranges naming their draw + /// and call in phase 2. + #[test] + fn plan_gives_phase_2_calls_of_its_own() { + let (draws, pages, solid) = sample(); + let (mut calls, mut ranges, mut segments) = (Vec::new(), Vec::new(), Vec::new()); + let plan = plan( + &draws, + &pages, + 2, + solid, + 4, + &mut calls, + &mut ranges, + &mut segments, + ); + assert_eq!( + plan, + Plan { + phase1_calls: 1, + solid_calls: 3, + total: 6 * 13 + } + ); + let call = |page, first, count| Call { page, first, count }; + // Phase 1: page 0 | phase 2: page 1, page 0 | translucent: page 0. + assert_eq!( + calls, + [ + call(0, 0, 30), + call(1, 30, 6), + call(0, 36, 24), + call(0, 60, 18) + ] + ); + assert_eq!(segments[1], (Source::Seen, 4, 2)); + assert_eq!(ranges[4], [6, 0, 256, 0]); + assert_eq!(ranges[5], [24, 1, 1024, 1]); + } + /// The compute pass writes exactly the indices the per-section draws /// read: quads 0 1 2 0 2 3 for solid draws, sorted indices otherwise, - /// plus the base vertex. + /// plus the base vertex. With culling, phase 2's runs hold the indices + /// of the draws the test saw, in order, and their calls count them. #[test] fn flatten_writes_the_indices_of_the_per_section_draws() { let instance = wgpu::Instance::new(wgpu::InstanceDescriptor::new_without_display_handle()); @@ -564,101 +818,170 @@ mod tests { use wgpu::util::DeviceExt; let (draws, pages, solid) = sample(); let align = (u64::from(device.limits().min_storage_buffer_offset_alignment) / 16).max(1); - let (mut calls, mut ranges, mut segments) = (Vec::new(), Vec::new(), Vec::new()); - let (_, total) = plan( - &draws, - &pages, - solid, - align, - &mut calls, - &mut ranges, - &mut segments, - ); let sorted: [Vec; 2] = [ (0..32).map(|i| (i * 7) % 32).collect(), (0..8).rev().collect(), ]; - let mut expected = Vec::new(); - for (d, (_, page)) in draws.iter().zip(&pages) { - for k in 0..d[0] { - let i = match page { - None => (k / 6) * 4 + [0, 1, 2, 0, 2, 3][(k % 6) as usize], - Some(p) => sorted[*p as usize][(d[2] + k) as usize], - }; - expected.push(d[3] + i); - } - } - let storage = |entries: &[u32]| { + let indices = |d: &[u32; 5], sorted_page: Option| -> Vec { + (0..d[0]) + .map(|k| { + d[3] + match sorted_page { + None => (k / 6) * 4 + [0, 1, 2, 0, 2, 3][(k % 6) as usize], + Some(p) => sorted[p as usize][(d[2] + k) as usize], + } + }) + .collect() + }; + let storage = |entries: &[u32], usage| { device.create_buffer_init(&wgpu::util::BufferInitDescriptor { label: None, contents: bytemuck::cast_slice(entries), - usage: wgpu::BufferUsages::STORAGE, + usage: wgpu::BufferUsages::STORAGE | usage, }) }; - let range_buffer = storage(bytemuck::cast_slice(&ranges)); - let sorted_buffers = [storage(&sorted[0]), storage(&sorted[1]), storage(&[0; 4])]; - let out = device.create_buffer(&wgpu::BufferDescriptor { - label: None, - size: total * 4, - usage: wgpu::BufferUsages::STORAGE | wgpu::BufferUsages::COPY_SRC, - mapped_at_creation: false, - }); - let read = device.create_buffer(&wgpu::BufferDescriptor { - label: None, - size: total * 4, - usage: wgpu::BufferUsages::MAP_READ | wgpu::BufferUsages::COPY_DST, - mapped_at_creation: false, - }); + let none = wgpu::BufferUsages::empty(); + let sorted_buffers = [ + storage(&sorted[0], none), + storage(&sorted[1], none), + storage(&[0; 4], none), + ]; let module = device.create_shader_module(wgpu::ShaderModuleDescriptor { label: None, source: wgpu::ShaderSource::Wgsl(include_str!("flatten.wgsl").into()), }); - let pipeline = device.create_compute_pipeline(&wgpu::ComputePipelineDescriptor { - label: None, - layout: None, - module: &module, - entry_point: Some("flatten"), - compilation_options: Default::default(), - cache: None, - }); - let mut encoder = device.create_command_encoder(&Default::default()); - { - let mut pass = encoder.begin_compute_pass(&Default::default()); - pass.set_pipeline(&pipeline); - for &(source, first, count) in &segments { - let group = device.create_bind_group(&wgpu::BindGroupDescriptor { - label: None, - layout: &pipeline.get_bind_group_layout(0), - entries: &[ - wgpu::BindGroupEntry { - binding: 0, - resource: wgpu::BindingResource::Buffer(wgpu::BufferBinding { - buffer: &range_buffer, - offset: first * 16, - size: wgpu::BufferSize::new(count * 16), - }), - }, - wgpu::BindGroupEntry { - binding: 1, - resource: sorted_buffers[source.map_or(2, |p| p as usize)] - .as_entire_binding(), - }, - wgpu::BindGroupEntry { - binding: 2, - resource: out.as_entire_binding(), - }, - ], - }); - pass.set_bind_group(0, &group, &[]); - pass.dispatch_workgroups(count as u32, 1, 1); + let pipeline = |entry| { + device.create_compute_pipeline(&wgpu::ComputePipelineDescriptor { + label: None, + layout: None, + module: &module, + entry_point: Some(entry), + compilation_options: Default::default(), + cache: None, + }) + }; + let (flatten, flatten_seen) = (pipeline("flatten"), pipeline("flatten_seen")); + let read_back = |buffer: &wgpu::Buffer, words: u64| -> Vec { + let read = device.create_buffer(&wgpu::BufferDescriptor { + label: None, + size: words * 4, + usage: wgpu::BufferUsages::MAP_READ | wgpu::BufferUsages::COPY_DST, + mapped_at_creation: false, + }); + let mut encoder = device.create_command_encoder(&Default::default()); + encoder.copy_buffer_to_buffer(buffer, 0, &read, 0, words * 4); + queue.submit([encoder.finish()]); + read.slice(..).map_async(wgpu::MapMode::Read, |_| {}); + device.poll(wgpu::PollType::wait_indefinitely()).unwrap(); + bytemuck::cast_slice(&read.slice(..).get_mapped_range().unwrap()).to_vec() + }; + // Without culling, then with the third and fourth draws in phase 2, + // of which the test saw only the fourth. + for phase1 in [solid, 2] { + let (mut calls, mut ranges, mut segments) = (Vec::new(), Vec::new(), Vec::new()); + let plan = plan( + &draws, + &pages, + phase1, + solid, + align, + &mut calls, + &mut ranges, + &mut segments, + ); + // Phase 2's draws as the test leaves them: instance counts of 0, + // 1 where it saw the section. + let mut phase2: Vec<[u32; 5]> = draws[phase1..solid] + .iter() + .map(|&[count, _, first, base, instance]| [count, 0, first, base, instance]) + .collect(); + if let Some(last) = phase2.last_mut() { + last[1] = 1; + } + let phase2_calls: Vec<[u32; 5]> = calls[plan.phase1_calls..plan.solid_calls] + .iter() + .map(|c| [0, 1, c.first, 0, 0]) + .collect(); + let range_buffer = storage(bytemuck::cast_slice(&ranges), none); + let phase2_buffer = storage( + bytemuck::cast_slice(&[phase2.as_slice(), &[[0; 5]]].concat()), + none, + ); + let calls_buffer = storage( + bytemuck::cast_slice(&[phase2_calls.as_slice(), &[[0; 5]]].concat()), + wgpu::BufferUsages::COPY_SRC, + ); + let out = storage(&vec![0; plan.total as usize], wgpu::BufferUsages::COPY_SRC); + let mut encoder = device.create_command_encoder(&Default::default()); + { + let mut pass = encoder.begin_compute_pass(&Default::default()); + for &(source, first, count) in &segments { + let ranges = wgpu::BindingResource::Buffer(wgpu::BufferBinding { + buffer: &range_buffer, + offset: first * 16, + size: wgpu::BufferSize::new(count * 16), + }); + let entry = |binding, resource| wgpu::BindGroupEntry { binding, resource }; + let (pipeline, entries) = match source { + Source::Seen => ( + &flatten_seen, + vec![ + entry(0, ranges), + entry(2, out.as_entire_binding()), + entry(3, phase2_buffer.as_entire_binding()), + entry(4, calls_buffer.as_entire_binding()), + ], + ), + Source::Quads | Source::Sorted(_) => { + let page = match source { + Source::Sorted(p) => p as usize, + _ => 2, + }; + ( + &flatten, + vec![ + entry(0, ranges), + entry(1, sorted_buffers[page].as_entire_binding()), + entry(2, out.as_entire_binding()), + ], + ) + } + }; + let group = device.create_bind_group(&wgpu::BindGroupDescriptor { + label: None, + layout: &pipeline.get_bind_group_layout(0), + entries: &entries, + }); + pass.set_pipeline(pipeline); + pass.set_bind_group(0, &group, &[]); + pass.dispatch_workgroups(count as u32, 1, 1); + } + } + queue.submit([encoder.finish()]); + let got = read_back(&out, plan.total); + // Phase 1's and the translucent calls: each of their draws, in order. + let expected: Vec = (0..draws.len()) + .filter(|i| !(phase1..solid).contains(i)) + .flat_map(|i| indices(&draws[i], pages[i].1)) + .collect(); + let drawn: Vec = calls + .iter() + .enumerate() + .filter(|(c, _)| !(plan.phase1_calls..plan.solid_calls).contains(c)) + .flat_map(|(_, c)| got[c.first as usize..(c.first + c.count) as usize].to_vec()) + .collect(); + assert_eq!(drawn, expected); + // Phase 2: page 1's run drew nothing; page 0's holds the fourth + // draw's indices. + if phase1 < solid { + let counts = read_back(&calls_buffer, phase2_calls.len() as u64 * 5); + assert_eq!(counts[0], 0); + assert_eq!(counts[5], draws[3][0]); + let run = &calls[plan.phase1_calls + 1]; + assert_eq!( + got[run.first as usize..(run.first + draws[3][0]) as usize], + indices(&draws[3], None) + ); } } - encoder.copy_buffer_to_buffer(&out, 0, &read, 0, total * 4); - queue.submit([encoder.finish()]); - read.slice(..).map_async(wgpu::MapMode::Read, |_| {}); - device.poll(wgpu::PollType::wait_indefinitely()).unwrap(); - let got: Vec = - bytemuck::cast_slice(&read.slice(..).get_mapped_range().unwrap()).to_vec(); - assert_eq!(got, expected); } } diff --git a/crates/horizon-client/src/gfx/flatten.wgsl b/crates/horizon-client/src/gfx/flatten.wgsl index 2f57f8775..d722d7b9f 100644 --- a/crates/horizon-client/src/gfx/flatten.wgsl +++ b/crates/horizon-client/src/gfx/flatten.wgsl @@ -4,9 +4,11 @@ // translucent ones read their sorted indices. struct Range { count: u32, - // First sorted index, or QUADS for a solid draw. + // First sorted index, or QUADS for a solid draw (`flatten_seen`: its + // entry in occlusion culling's phase 2 draws). first: u32, base: u32, + // First index in the list (`flatten_seen`: its draw call). dst: u32, } const QUADS: u32 = 0xffffffffu; @@ -14,6 +16,13 @@ const GROUP: u32 = 64u; @group(0) @binding(0) var ranges: array; @group(0) @binding(1) var sorted: array; @group(0) @binding(2) var out: array; + +// Index `k` of a solid draw: quad k / 6's vertices 0 1 2 0 2 3. +fn quad(k: u32) -> u32 { + let c = k % 6u; + return (k / 6u) * 4u + select(select(c - 2u, 0u, c == 3u), c, c < 3u); +} + @compute @workgroup_size(64) fn flatten(@builtin(workgroup_id) group: vec3, @builtin(local_invocation_index) lane: u32) { @@ -25,11 +34,43 @@ fn flatten(@builtin(workgroup_id) group: vec3, for (var k = lane; k < d.count; k += GROUP) { var i: u32; if d.first == QUADS { - let c = k % 6u; - i = (k / 6u) * 4u + select(select(c - 2u, 0u, c == 3u), c, c < 3u); + i = quad(k); } else { i = sorted[d.first + k]; } out[d.dst + k] = d.base + i; } } + +// Occlusion culling's phase 2 (gfx/cull.rs), after its test: the draws as +// the test left them (`DrawIndexedIndirectArgs`, the instance count 1 where +// it saw the section), and phase 2's draw calls, whose index counts start +// at 0. A draw the test saw takes the next indices of its call's run. +@group(0) @binding(3) var draws: array; +@group(0) @binding(4) var calls: array>; +const UNSEEN: u32 = 0xffffffffu; +var start: u32; + +@compute @workgroup_size(64) +fn flatten_seen(@builtin(workgroup_id) group: vec3, + @builtin(local_invocation_index) lane: u32) { + let r = group.y * 65535u + group.x; + if r >= arrayLength(&ranges) { + return; + } + let d = ranges[r]; + if lane == 0u { + var s = UNSEEN; + if draws[d.first * 5u + 1u] != 0u { + s = atomicLoad(&calls[d.dst * 5u + 2u]) + atomicAdd(&calls[d.dst * 5u], d.count); + } + start = s; + } + let s = workgroupUniformLoad(&start); + if s == UNSEEN { + return; + } + for (var k = lane; k < d.count; k += GROUP) { + out[s + k] = d.base + quad(k); + } +} From 1d81c67b7b4a2ae05fc20bd6e8fc0b9691238df9 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 12:13:58 +0200 Subject: [PATCH 115/126] Build naga once for the game, its tests and its examples horizon-client's dev-dependency on naga added the hlsl-out feature for the gfx.rs test that translates every shader for DirectX 12. With resolver 2 a dev-dependency's features apply only to tests and examples, so Cargo kept two builds of naga, wgpu-hal, wgpu-core, wgpu, horizon-shaderpack and the horizon-client lib, and rebuilt them on the first example or test after a game build. Measured on the Mac mini (cargo build of the game, then one example): the example took 37.3 s and recompiled that whole stack before, 1.2 s and only its own crate after; the target dir is 1 GB smaller (4.9 to 3.9 GB). The game binary is the same size: nothing calls the HLSL writer, so the linker drops it. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/Cargo.toml | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/crates/horizon-client/Cargo.toml b/crates/horizon-client/Cargo.toml index 48e2e57d4..cd5d86fe7 100644 --- a/crates/horizon-client/Cargo.toml +++ b/crates/horizon-client/Cargo.toml @@ -30,7 +30,9 @@ serde = { version = "1", features = ["derive"] } serde_json = { version = "1.0.151", features = ["raw_value"] } # Shader packs: pack.toml, and WGSL checked before it reaches wgpu. toml = "1.1" -naga = { version = "30.0.1", features = ["wgsl-in"] } +# hlsl-out: the gfx.rs tests translate every shader as wgpu's DirectX 12 backend does. A normal feature, +# not a dev-dependency's, so builds, tests and examples share one build of naga, wgpu and this crate. +naga = { version = "30.0.1", features = ["wgsl-in", "hlsl-out"] } # Java (OptiFine/Iris) shader packs, translated to WGSL. horizon-shaderpack = { path = "../horizon-shaderpack" } # Sound (ALSA on Linux); the `audio` feature. @@ -81,7 +83,3 @@ rng-trace = ["horizon-core/rng-trace"] [lints] workspace = true - -[dev-dependencies] -# Every WGSL shader translated as wgpu's DirectX 12 backend does (gfx.rs tests). -naga = { version = "30.0.1", features = ["wgsl-in", "hlsl-out"] } From 660407fa58d03fa6e41fe2edc7d4ae3658841233 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 13:22:10 +0200 Subject: [PATCH 116/126] Metal: cull only frames with 4,096 section draws or more On Apple's GPUs the passes the test adds cost a fixed share of the frame (it is stored and reloaded at each), which the hidden sections repay only at high render distances: at 12 culling cost an M4 Pro 0.05 ms of GPU time a frame, at 32 it saved 0.25 to 1.6 ms. Other backends keep culling every frame; HORIZON_GPU_CULL=all culls every frame on Metal too. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/gfx.rs | 14 ++++++++++---- crates/horizon-client/src/gfx/cull.rs | 10 ++++++++++ 2 files changed, 20 insertions(+), 4 deletions(-) diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 91da4f616..022d14dcd 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -2146,8 +2146,8 @@ impl Renderer { .features() .contains(wgpu::Features::INDIRECT_FIRST_INSTANCE); // HORIZON_GPU_CULL=0 turns occlusion culling off, `all` culls every - // frame however little it hides, `shader` tests in the shader as on - // Metal (A/B checks). + // frame however few its draws and little it hides, `shader` tests in + // the shader as on Metal (A/B checks). let cull_env = std::env::var("HORIZON_GPU_CULL"); let cull = cull::Cull::supported(&adapter, &device) .filter(|_| cull_env.as_deref() != Ok("0")) @@ -2159,6 +2159,9 @@ impl Renderer { let mut cull = cull::Cull::new(&device, config.format.remove_srgb_suffix(), depth_test); cull.always = cull_env.as_deref() == Ok("all"); + if !cull.always && adapter.get_info().backend == wgpu::Backend::Metal { + cull.min_draws = cull::TILED_MIN_DRAWS; + } cull }); let depth = Self::depth(&device, &config, cull.as_ref()); @@ -3148,11 +3151,14 @@ impl Renderer { .inverse() .transform_point3(Vec3::ZERO); // Occlusion culling leaves the sections its last result did not see - // to phase 2, after the others, with instance counts of 0. + // to phase 2, after the others, with instance counts of 0. Whether + // the frame has draws enough goes by the last one's. let mut cull = self .cull .as_mut() - .filter(|_| self.cull_on && !frame.title && self.multi_draw) + .filter(|c| { + self.cull_on && !frame.title && self.multi_draw && self.section_draws >= c.min_draws + }) .and_then(|cull| cull.begin(&self.device).then_some(cull)); self.phase2_draws.clear(); self.phase2_pages.clear(); diff --git a/crates/horizon-client/src/gfx/cull.rs b/crates/horizon-client/src/gfx/cull.rs index 77574e850..57049eb4d 100644 --- a/crates/horizon-client/src/gfx/cull.rs +++ b/crates/horizon-client/src/gfx/cull.rs @@ -46,6 +46,13 @@ const RETEST: u32 = 8; /// more than they save. Else one frame in `PROBE` tests every section. const MIN_SHARE: f32 = 0.1; const PROBE: u32 = 64; +/// On Metal, section draws from which a frame culls. Apple's GPUs store and +/// reload the whole frame at each of the passes the test adds, a fixed cost +/// that the sections it hides repay only at high render distances: on an M4 +/// Pro at 1080p and render distance 12 (1,000–1,600 draws) culling added +/// about 0.05 ms of GPU time while hiding 15–30% of the solid indices; at +/// 32 (drawn flat, over this many draws) it saved 0.25–1.6 ms. +pub const TILED_MIN_DRAWS: usize = 4096; /// Boxes over more than this share of the screen count as seen untested. const BIG: f32 = 0.25; /// Results read back at once, some frames late so the CPU never waits. @@ -141,6 +148,8 @@ pub struct Cull { pub hidden: ([usize; 2], f32), /// Cull every frame, whatever the hidden share (A/B checks). pub always: bool, + /// Frames with fewer section draws than this do not cull. + pub min_draws: usize, } fn buffer( @@ -337,6 +346,7 @@ impl Cull { stamp: 0, hidden: ([0; 2], 1.0), always: false, + min_draws: 0, } } From eafe97da7468315d1bd159ccee038a8cee72e62d Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 14:02:12 +0200 Subject: [PATCH 117/126] Shader packs: keep what Iris does, drop what doesn't work, apply settings on Done Review fixes for #1414 (contribution gate): - Java packs no longer get Horizon's shadow map: it was mirrored in y and reversed in depth against the GL conventions the packs sample with, had no distortion and only the camera's sections, so BSL drew no shadows while the pass cost 0.65 ms (MakeUp, M4 Pro). shadowtex* stays a far depth, as on main; the packs' own shadow programs are #1326. - Invented uniforms removed (centerDepthSmooth fixed at 0.5, ambientOcclusionLevel and shadowMapResolution as uniforms, constant temp/rainfall/biome/held items); an unknown uniform stays zero as before. wetness keeps its Iris smoothing. Unused directives removed. - texture.. is scoped to Iris's stages (final reads the composite ones) instead of overriding the sampler in every pass; texture.noise replaces noisetex. One noise generator and one RGBA upload for both pack kinds. - The G-buffer pass, the opaque-depth copy and the shadow pass run only for a pack that reads them (naga's per-entry-point binding use, not a text search): every pack paid all three before. - Api 2's prelude additions go in their own file after api 1's, so api 1 packs keep the names they declare (aces_tonemap, material_at...). - Stage kinds shadow, gbuffer, deferred and final ran as composite: only composite is accepted; api 2 adds formats (validated), profiles, option descriptions and a noise texture. - Shader Pack Settings applies once when the page closes, as Iris's Done (each click or slider step rebuilt the pack: 2.7 s per click, 12.7 s for one drag with BSL). Labels follow Iris (.lang, else the name). A pack whose options can't be read isn't read again every frame. - Saved option values an option doesn't list are ignored, as OptiFine's ShaderOption.setValue (a stale file broke BSL's compile). - Import: the blocking file dialog (osascript/zenity/kdialog/PowerShell on the event loop) is gone; a pack dropped on the Shader Packs page is copied and picked, as Iris's onFilesDrop. Drops elsewhere do nothing, an existing pack isn't overwritten, links aren't followed. - Docs and the example say what the code does (SSAO, not GTAO). Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game.rs | 2 +- crates/horizon-client/src/game/options.rs | 3 - crates/horizon-client/src/game/packs.rs | 54 ---- .../horizon-client/src/game/shader_packs.rs | 29 +- .../horizon-client/src/game/startup_menu.rs | 29 +- crates/horizon-client/src/gfx.rs | 28 +- crates/horizon-client/src/gfx/java_stages.rs | 190 +++--------- crates/horizon-client/src/gfx/pack_stages.rs | 111 ++++--- crates/horizon-client/src/gfx/world_post.rs | 37 +-- crates/horizon-client/src/java_pack.rs | 67 +++-- crates/horizon-client/src/options_ui.rs | 221 +++++++++----- crates/horizon-client/src/shader_pack.rs | 281 ++++++++++-------- .../src/shader_pack_prelude.wgsl | 108 +------ .../src/shader_pack_prelude_api2.wgsl | 108 +++++++ crates/horizon-shaderpack/src/options.rs | 18 +- crates/horizon-shaderpack/src/pipeline.rs | 112 +------ crates/horizon-shaderpack/src/translate.rs | 19 +- docs/shader-packs.md | 74 ++++- examples/shaderpacks/horizon-ultra/pack.toml | 15 +- .../horizon-ultra/shaders/bloom_godrays.wgsl | 4 +- .../shaders/deferred_lighting.wgsl | 6 +- 21 files changed, 732 insertions(+), 784 deletions(-) create mode 100644 crates/horizon-client/src/shader_pack_prelude_api2.wgsl diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index c763bd58a..ae7b182b4 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -10728,7 +10728,7 @@ impl ApplicationHandler for Game<'_> { self.pending_save.as_mut().unwrap().quit = true; } WindowEvent::DroppedFile(path) => { - self.import_shader_pack_path(&path); + self.drop_shader_pack(&path); } WindowEvent::Focused(focused) => { self.focused = focused; diff --git a/crates/horizon-client/src/game/options.rs b/crates/horizon-client/src/game/options.rs index c715b4d1a..d422f0218 100644 --- a/crates/horizon-client/src/game/options.rs +++ b/crates/horizon-client/src/game/options.rs @@ -243,9 +243,6 @@ impl Game<'_> { super::packs::open_folder(&dir); } Event::Credits => self.open_win_screen(false, super::win::Finish::Options), - Event::ImportShaderPack => { - self.import_shader_pack_dialog(); - } Event::ReloadShaderPack => { self.load_shader_pack(); } diff --git a/crates/horizon-client/src/game/packs.rs b/crates/horizon-client/src/game/packs.rs index 13de550e1..94e61d948 100644 --- a/crates/horizon-client/src/game/packs.rs +++ b/crates/horizon-client/src/game/packs.rs @@ -34,60 +34,6 @@ pub fn open_folder(dir: &Path) { log::warn!("Horizon: could not open {}: {e}", dir.display()); } } -/// Open a native file dialog to pick a shader pack `.zip` or folder, falling -/// back to opening `dir` in the system file manager when no dialog helper is present. -pub fn pick_shader_pack(dir: &Path) -> Option { - let _ = std::fs::create_dir_all(dir); - let output = if cfg!(target_os = "windows") { - std::process::Command::new("powershell") - .args([ - "-NoProfile", - "-Command", - "Add-Type -AssemblyName System.Windows.Forms; $f = New-Object System.Windows.Forms.OpenFileDialog; $f.Filter = 'Shader Packs (*.zip;pack.toml)|*.zip;pack.toml|All Files (*.*)|*.*'; if ($f.ShowDialog() -eq 'OK') { Write-Output $f.FileName }", - ]) - .output() - .ok() - } else if cfg!(target_os = "macos") { - std::process::Command::new("osascript") - .args([ - "-e", - "POSIX path of (choose file with prompt \"Select Shader Pack (.zip)\")", - ]) - .output() - .ok() - } else { - std::process::Command::new("zenity") - .args([ - "--file-selection", - "--title=Import Shader Pack (.zip)", - "--file-filter=Shader Packs (*.zip) | *.zip", - ]) - .output() - .ok() - .filter(|o| o.status.success()) - .or_else(|| { - std::process::Command::new("kdialog") - .args(["--getopenfilename", ".", "*.zip|Shader Packs (*.zip)"]) - .output() - .ok() - }) - }; - if let Some(out) = output - && out.status.success() - { - let raw = String::from_utf8_lossy(&out.stdout).trim().to_owned(); - if !raw.is_empty() { - let p = PathBuf::from(raw); - if p.file_name().is_some_and(|n| n == "pack.toml") { - return p.parent().map(Path::to_path_buf); - } - return Some(p); - } - return None; - } - open_folder(dir); - None -} /// The resource root to load from, given the vanilla root and the selection. pub fn startup_root(vanilla: &Path, selected: &[String]) -> std::io::Result { let all = packs::discover(vanilla, &packs_dir()); diff --git a/crates/horizon-client/src/game/shader_packs.rs b/crates/horizon-client/src/game/shader_packs.rs index d7ec206ec..a501543bd 100644 --- a/crates/horizon-client/src/game/shader_packs.rs +++ b/crates/horizon-client/src/game/shader_packs.rs @@ -101,30 +101,19 @@ impl Game<'_> { self.load_shader_pack(); } } - /// Import a shader pack from `source` into `shaderpacks/`, activate it, and reload. - pub(super) fn import_shader_pack_path(&mut self, source: &std::path::Path) { - let dest = dir(); - match shader_pack::import_pack(source, &dest) { - Ok(id) => { - self.ui.options.shader_packs = Default::default(); - self.ui.options.shader_packs.poll(dest); - self.settings.horizon.shader_pack = id; - self.ui.options.shader_pack_config = None; - self.ui.options.sync_shader_pack_config(&self.settings); + /// A file dropped on the window: a shader pack while the Shader Packs + /// page shows (`OptionsUi::drop_shader_pack`). + pub(super) fn drop_shader_pack(&mut self, path: &std::path::Path) { + match self.ui.options.drop_shader_pack(&mut self.settings, path) { + Some(Ok(())) => { self.settings.save(&Self::options_path()); self.load_shader_pack(); } - Err(e) => { - log::warn!("Horizon: shader pack import failed: {e}"); - self.system_message(Text::literal(format!("Shader pack import: {e}"))); + Some(Err(e)) => { + log::warn!("Horizon: shader pack {}: {e}", path.display()); + self.system_message(Text::literal(format!("Shader pack: {e}"))); } - } - } - /// Open the system file picker (or `shaderpacks/` folder) to import a shader pack. - pub(super) fn import_shader_pack_dialog(&mut self) { - let dest = dir(); - if let Some(chosen) = super::packs::pick_shader_pack(&dest) { - self.import_shader_pack_path(&chosen); + None => {} } } fn shader_pack_error(&mut self, id: &str, error: &str) { diff --git a/crates/horizon-client/src/game/startup_menu.rs b/crates/horizon-client/src/game/startup_menu.rs index e01dd6dc6..ebf062a83 100644 --- a/crates/horizon-client/src/game/startup_menu.rs +++ b/crates/horizon-client/src/game/startup_menu.rs @@ -387,19 +387,6 @@ impl Loading { self.menu.win = Some((screen, Instant::now())); } } - Event::ImportShaderPack => { - let dir = horizon_client::shader_pack::folder(); - if let Some(chosen) = packs::pick_shader_pack(&dir) - && let Ok(id) = horizon_client::shader_pack::import_pack(&chosen, &dir) - { - self.menu.options.shader_packs = Default::default(); - self.menu.options.shader_packs.poll(dir); - self.settings.horizon.shader_pack = id; - self.menu.options.shader_pack_config = None; - self.menu.options.sync_shader_pack_config(&self.settings); - self.save_menu_settings(); - } - } Event::ReloadShaderPack => { self.save_menu_settings(); } @@ -469,14 +456,14 @@ impl Loading { self.apply_menu_settings(); } WindowEvent::DroppedFile(path) => { - let dir = horizon_client::shader_pack::folder(); - if let Ok(id) = horizon_client::shader_pack::import_pack(&path, &dir) { - self.menu.options.shader_packs = Default::default(); - self.menu.options.shader_packs.poll(dir); - self.settings.horizon.shader_pack = id; - self.menu.options.shader_pack_config = None; - self.menu.options.sync_shader_pack_config(&self.settings); - self.save_menu_settings(); + match self + .menu + .options + .drop_shader_pack(&mut self.settings, &path) + { + Some(Ok(())) => self.save_menu_settings(), + Some(Err(e)) => log::warn!("Horizon: shader pack {}: {e}", path.display()), + None => {} } } WindowEvent::RedrawRequested => self.draw(), diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 38a3e0521..255f4dd0a 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -3679,14 +3679,16 @@ impl Renderer { } // The world's targets: the screen, or the scaled target of `post`. let pack = self.pack.is_some() && !frame.title; - let shadow_cfg = if pack { - self.pack.as_ref().and_then(|p| match p { - Pack::Horizon(s) if s.needs_shadow => Some((s.shadow_res, s.shadow_dist)), - Pack::Java(s) if s.needs_shadow() => Some(s.shadow_config(frame.shader.dimension)), - _ => None, - }) - } else { - None + // What the pack reads beyond the world's colour and depth: each costs + // a pass (the shadow map, the G-buffer) or a copy (the opaque depth). + let (shadow_cfg, gbuffer, opaque_depth) = match self.pack.as_ref().filter(|_| pack) { + Some(Pack::Horizon(s)) => ( + s.needs_shadow.then_some((s.shadow_res, s.shadow_dist)), + s.needs_gbuffer, + s.needs_opaque_depth, + ), + Some(Pack::Java(s)) => (None, false, s.reads_opaque_depth), + None => (None, false, false), }; if let Some((shadow_res, shadow_dist)) = shadow_cfg { self.world_post @@ -3944,7 +3946,7 @@ impl Renderer { pass.set_vertex_buffer(0, self.debug_line_buffer.slice(..)); pass.draw(0..4, debug_depth..debug_depth + debug_top); } - if pack { + if opaque_depth { drop(pass); self.world_post.capture_opaque_depth(&mut encoder); let attachments = [Some(wgpu::RenderPassColorAttachment { @@ -4042,7 +4044,7 @@ impl Renderer { ); } } - if pack && scaled.is_some() { + if gbuffer && scaled.is_some() { self.world_post.build_gbuffer( &self.queue, &mut encoder, @@ -4617,7 +4619,11 @@ mod tests { ); assert!(files.len() >= 10, "{files:?}"); for path in files { - let text = std::fs::read_to_string(&path).unwrap(); + let mut text = std::fs::read_to_string(&path).unwrap(); + // Api 2's prelude follows api 1's (`shader_pack::ShaderPack::load`). + if path.ends_with("shader_pack_prelude_api2.wgsl") { + text = format!("{}\n{text}", crate::shader_pack::PRELUDE); + } // entity.wgsl comes after the overlay's constants (entity_shader). let module = naga::front::wgsl::parse_str(&text) .or_else(|_| { diff --git a/crates/horizon-client/src/gfx/java_stages.rs b/crates/horizon-client/src/gfx/java_stages.rs index 8091b0703..f86055919 100644 --- a/crates/horizon-client/src/gfx/java_stages.rs +++ b/crates/horizon-client/src/gfx/java_stages.rs @@ -1,16 +1,17 @@ //! A Java (OptiFine/Iris) shader pack on the GPU (docs/shader-packs.md): //! Iris's colour targets (`colortex0..`, each with a main and an alternate -//! side), pre-translucent depth (`depthtex1`/`depthtex2`), directional -//! shadow map (`shadowtex0`/`shadowtex1`) and the pack's `begin`, `prepare`, -//! `deferred`, `composite` and `final` programs as full-screen passes over -//! them, as Iris's `CompositeRenderer` runs them. Horizon's world enters -//! `colortex0` and `depthtex0..2` after `prepare`, where Iris's gbuffers -//! programs would have drawn, and the last picture goes to `world_post`. The +//! side) and the pack's `begin`, `prepare`, `deferred`, `composite` and +//! `final` programs as full-screen passes over them, as Iris's +//! `CompositeRenderer` runs them. Horizon's world enters `colortex0` and +//! `depthtex0` after `prepare`, where Iris's gbuffers programs would have +//! drawn (`depthtex1`/`depthtex2`: its depth before translucent geometry), +//! and the last picture goes to `world_post`. The //! targets keep GL's layout (row 0 at the bottom, which the translated vertex //! programs produce), so the world is flipped going in and the picture coming //! out. -use super::pack_stages::FrameUniform; -use crate::java_pack::{JavaFolder, JavaPasses}; +use super::pack_stages::{FrameUniform, noise, rgba_view}; +use crate::java_pack::{JavaFolder, JavaPasses, NOISE_KEY, texture_key}; +use crate::shader_pack::Rgba; use glam::{Mat3, Mat4, Vec3, Vec4}; use horizon_shaderpack::pipeline::TargetSettings; use horizon_shaderpack::pipeline::{Directives, Program, target_index}; @@ -30,8 +31,6 @@ pub struct JavaFrame { pub moon_angle: f32, } -/// Iris's `noisetex` size (`noiseTextureResolution`'s default). -const NOISE_SIZE: u32 = 256; /// The vertex buffers a pass may read (wgpu's default limit). const MAX_ATTRIBUTES: usize = 8; @@ -173,7 +172,8 @@ enum Source { /// `depthtex1` / `depthtex2`: the opaque world's depth (before translucent water). OpaqueDepth, Noise, - /// `shadowtex*`: directional sun/moon shadow map depth (or far depth for DH/Voxy). + /// `shadowtex*`: no shadow map yet, so a far depth (nothing in shadow); + /// also Distant Horizons' and Voxy's depth, as without those mods. Shadow, /// Anything else (`shadowcolor*`, custom textures): white or black. Blank(bool), @@ -267,11 +267,13 @@ struct Folder { passes: Vec, final_pass: Option, directives: Directives, - shadow_enabled: bool, } pub struct JavaStages { pub id: String, + /// A pass samples `depthtex1`/`depthtex2`: the world's depth is kept + /// before translucent geometry draws. + pub reads_opaque_depth: bool, format: wgpu::TextureFormat, common: Common, folders: Vec, @@ -285,25 +287,12 @@ pub struct JavaStages { uniform_state: UniformState, /// `eyeBrightnessSmooth`, block then sky. eye_smooth: [SmoothFloat; 2], - /// `wetness`, smoothed with `wetnessHalflife` / `drynessHalflife`. + /// `wetness`: `rainStrength` smoothed with `wetnessHalflife` going up + /// and `drynessHalflife` going down. wetness_smooth: SmoothFloat, - /// `centerDepthSmooth`, smoothed with `centerDepthHalflife`. - center_depth_smooth: SmoothFloat, } impl JavaStages { - /// Whether any dimension folder in this pack reads directional shadow maps. - pub fn needs_shadow(&self) -> bool { - self.folders.iter().any(|f| f.shadow_enabled) - } - - /// Shadow map resolution and distance for `dimension`. - pub fn shadow_config(&self, dimension: i8) -> (u32, f32) { - let idx = self.folder_for[(dimension.clamp(-1, 1) + 1) as usize].unwrap_or(0); - let d = &self.folders[idx].directives; - (d.shadow_map_resolution, d.shadow_distance) - } - /// The pipelines of a loaded Java pack, or wgpu's error. pub fn new( device: &wgpu::Device, @@ -342,15 +331,20 @@ impl JavaStages { passes, final_pass, directives: plan.directives, - shadow_enabled: plan.shadow_enabled, }) }) .collect::, _>>()?; if let Some(error) = pollster::block_on(scope.pop()) { return Err(error.to_string()); } + let reads_opaque_depth = folders + .iter() + .flat_map(|f| f.passes.iter().chain(&f.final_pass)) + .flat_map(|p| &p.samplers) + .any(|s| s.source == Source::OpaqueDepth); Ok(Self { id: id.to_owned(), + reads_opaque_depth, format, common, folders, @@ -364,7 +358,6 @@ impl JavaStages { uniform_state: UniformState::default(), eye_smooth: [SmoothFloat::default(); 2], wetness_smooth: SmoothFloat::default(), - center_depth_smooth: SmoothFloat::default(), }) } @@ -405,10 +398,6 @@ impl JavaStages { self.previous, ); inputs.set_world(&world, directives.sun_path_rotation); - inputs.shadow_view = post.shadow_view; - inputs.shadow_projection = post.gl_shadow_projection(); - inputs.ambient_occlusion_level = directives.ambient_occlusion_level; - inputs.shadow_map_resolution = directives.shadow_map_resolution as f32; let half_life = directives.eye_brightness_half_life; for (i, smooth) in self.eye_smooth.iter_mut().enumerate() { inputs.eye_smooth[i] = smooth.update(inputs.eye[i], half_life, half_life, frame_time); @@ -419,12 +408,6 @@ impl JavaStages { directives.dryness_half_life, frame_time, ); - inputs.center_depth_smooth = self.center_depth_smooth.update( - 0.5, - directives.center_depth_half_life, - directives.center_depth_half_life, - frame_time, - ); self.uniforms .update(&mut self.uniform_state, frame_time, &|name| { inputs.builtin(name) @@ -599,7 +582,6 @@ impl JavaStages { &targets, &depth, &opaque_depth, - post, &self.common, &mut blank, ) @@ -780,11 +762,8 @@ fn blit_pipeline( } impl Common { - fn new( - device: &wgpu::Device, - queue: &wgpu::Queue, - custom_map: &BTreeMap)>, - ) -> Self { + /// `custom` holds the pack's `texture.*` images (`JavaPasses::custom_textures`). + fn new(device: &wgpu::Device, queue: &wgpu::Queue, custom: &BTreeMap) -> Self { let sampler = |filter, address, compare| { device.create_sampler(&wgpu::SamplerDescriptor { label: Some("Java shader pack"), @@ -798,68 +777,15 @@ impl Common { }) }; use wgpu::{AddressMode::*, FilterMode::*}; - // Iris's noise: random RGB, opaque. - let mut seed = 0x2545_f491_u32; - let noise_bytes: Vec = (0..NOISE_SIZE * NOISE_SIZE * 4) - .map(|i| { - seed ^= seed << 13; - seed ^= seed >> 17; - seed ^= seed << 5; - if i % 4 == 3 { 255 } else { (seed >> 24) as u8 } - }) + let noise = match custom.get(NOISE_KEY) { + Some(image) => rgba_view(device, queue, "noisetex", image), + None => rgba_view(device, queue, "noisetex", &noise()), + }; + let custom_textures = custom + .iter() + .filter(|(key, _)| *key != NOISE_KEY) + .map(|(key, image)| (key.clone(), rgba_view(device, queue, key, image))) .collect(); - let noise = device.create_texture(&wgpu::TextureDescriptor { - label: Some("noisetex"), - size: wgpu::Extent3d { - width: NOISE_SIZE, - height: NOISE_SIZE, - depth_or_array_layers: 1, - }, - mip_level_count: 1, - sample_count: 1, - dimension: wgpu::TextureDimension::D2, - format: wgpu::TextureFormat::Rgba8Unorm, - usage: wgpu::TextureUsages::TEXTURE_BINDING | wgpu::TextureUsages::COPY_DST, - view_formats: &[], - }); - queue.write_texture( - noise.as_image_copy(), - &noise_bytes, - wgpu::TexelCopyBufferLayout { - offset: 0, - bytes_per_row: Some(NOISE_SIZE * 4), - rows_per_image: None, - }, - noise.size(), - ); - let mut custom_textures = BTreeMap::new(); - for (name, (w, h, bytes)) in custom_map { - let tex = device.create_texture(&wgpu::TextureDescriptor { - label: Some(name), - size: wgpu::Extent3d { - width: *w, - height: *h, - depth_or_array_layers: 1, - }, - mip_level_count: 1, - sample_count: 1, - dimension: wgpu::TextureDimension::D2, - format: wgpu::TextureFormat::Rgba8Unorm, - usage: wgpu::TextureUsages::TEXTURE_BINDING | wgpu::TextureUsages::COPY_DST, - view_formats: &[], - }); - queue.write_texture( - tex.as_image_copy(), - bytes, - wgpu::TexelCopyBufferLayout { - offset: 0, - bytes_per_row: Some(*w * 4), - rows_per_image: None, - }, - tex.size(), - ); - custom_textures.insert(name.clone(), tex.create_view(&Default::default())); - } // The full-screen triangle (0, 0), (2, 0), (0, 2): the pack's // projection maps 0..1 to the screen. Texture coordinates are the // position; colours white; normals up. @@ -899,7 +825,7 @@ impl Common { nearest: sampler(Nearest, ClampToEdge, None), repeat: sampler(Linear, Repeat, None), compare: sampler(Linear, ClampToEdge, Some(wgpu::CompareFunction::LessEqual)), - noise: noise.create_view(&Default::default()), + noise, custom_textures, vertices, world_layout: device.create_bind_group_layout(&wgpu::BindGroupLayoutDescriptor { @@ -1239,21 +1165,22 @@ impl PassGpu { targets: &BTreeMap, depth: &wgpu::TextureView, opaque_depth: &wgpu::TextureView, - post: &super::world_post::Post, common: &Common, blank: &mut Vec, ) -> wgpu::BindGroup { let mut views = Vec::new(); for s in &self.samplers { - let view = if let Some(custom) = common - .custom_textures - .get(&s.name) - .filter(|_| !s.compare && s.dimension == wgpu::TextureViewDimension::D2) - { + let custom = (!s.compare && s.dimension == wgpu::TextureViewDimension::D2) + .then(|| { + common + .custom_textures + .get(&texture_key(&self.program, &s.name)) + }) + .flatten(); + let view = if let Some(custom) = custom { custom.clone() } else { match (s.compare, s.source) { - (true, Source::Shadow) if post.shadow_active => post.shadow_depth().clone(), (true, _) => blank_view(device, queue, blank, s, BlankKind::FarDepth), (false, Source::Target(i)) if s.dimension == wgpu::TextureViewDimension::D2 => { match targets.get(&i) { @@ -1612,8 +1539,6 @@ struct Inputs { view: Mat4, /// GL's: near at -1, far at 1. projection: Mat4, - shadow_view: Mat4, - shadow_projection: Mat4, camera: Vec3, previous: (Mat4, Mat4, Vec3), size: [f32; 2], @@ -1624,10 +1549,8 @@ struct Inputs { /// `eyeBrightness` and `eyeBrightnessSmooth`: block, sky light × 16. eye: [f32; 2], eye_smooth: [f32; 2], + /// `wetness` (`JavaStages::wetness_smooth`). wetness: f32, - center_depth_smooth: f32, - ambient_occlusion_level: f32, - shadow_map_resolution: f32, /// `CelestialUniforms`, in view space. sun_position: Vec3, moon_position: Vec3, @@ -1676,8 +1599,6 @@ impl Inputs { let mut out = Self { view, projection, - shadow_view: Mat4::IDENTITY, - shadow_projection: Mat4::IDENTITY, camera, previous: previous.unwrap_or((view, projection, camera)), size: size.map(|v| v as f32), @@ -1688,9 +1609,6 @@ impl Inputs { eye: [0.0; 2], eye_smooth: [0.0; 2], wetness: frame.weather[0], - center_depth_smooth: 0.5, - ambient_occlusion_level: 1.0, - shadow_map_resolution: 2048.0, sun_position: Vec3::ZERO, moon_position: Vec3::ZERO, up_position: Vec3::ZERO, @@ -1790,35 +1708,21 @@ impl Inputs { "skyColor" => f.sky_color[..3].to_vec(), "isEyeInWater" => vec![f.camera_state[0]], "nightVision" => vec![f.camera_state[1]], - "darknessFactor" | "darknessLightFactor" => vec![f.camera_state[2]], - "blindness" => vec![f.camera_state[3]], + "darknessFactor" => vec![f.camera_state[2]], "screenBrightness" => vec![1.0], - "centerDepthSmooth" => vec![self.center_depth_smooth], - "ambientOcclusionLevel" => vec![self.ambient_occlusion_level], - "shadowMapResolution" => vec![self.shadow_map_resolution], "eyeBrightness" => self.eye.to_vec(), // An ivec2: the smoothed value truncated. "eyeBrightnessSmooth" => self.eye_smooth.map(f32::trunc).to_vec(), "hasSkylight" => vec![f.dimension[1]], - "heldItemId" | "heldItemId2" | "heldBlockLightValue" | "heldBlockLightValue2" => { - vec![0.0] - } - "biome" | "biome_category" => vec![0.0], - "biome_precipitation" => vec![if f.weather[0] > 0.01 { 1.0 } else { 0.0 }], - "temp" => vec![0.8], - "rainfall" => vec![0.4], - "alphaTestRef" => vec![0.1], - "renderStage" => vec![0.0], - "playerMood" | "currentColorSpace" => vec![0.0], "iris_ModelViewMatrix" | "iris_ModelViewMatrixInverse" => mat(Mat4::IDENTITY), "iris_ProjectionMatrix" | "iris_ModelViewProjectionMatrix" => mat(screen), "iris_ProjectionMatrixInverse" => mat(screen.inverse()), "iris_TextureMatrix" => (0..8).flat_map(|_| mat(Mat4::IDENTITY)).collect(), "iris_NormalMatrix" => Mat3::IDENTITY.to_cols_array().to_vec(), - "shadowModelView" => mat(self.shadow_view), - "shadowModelViewInverse" => mat(self.shadow_view.inverse()), - "shadowProjection" => mat(self.shadow_projection), - "shadowProjectionInverse" => mat(self.shadow_projection.inverse()), + "shadowModelView" + | "shadowModelViewInverse" + | "shadowProjection" + | "shadowProjectionInverse" => mat(Mat4::IDENTITY), _ => return None, }) } diff --git a/crates/horizon-client/src/gfx/pack_stages.rs b/crates/horizon-client/src/gfx/pack_stages.rs index 08a6b9aea..f80a64ce1 100644 --- a/crates/horizon-client/src/gfx/pack_stages.rs +++ b/crates/horizon-client/src/gfx/pack_stages.rs @@ -5,7 +5,7 @@ //! and writes its own target; the last target goes to the screen through //! `world_post` (copy or FXAA) under the hand and HUD. Only exists while a //! pack is selected. -use crate::shader_pack::{ShaderPack, StageKind, VERTEX_ENTRY}; +use crate::shader_pack::{Rgba, ShaderPack, VERTEX_ENTRY}; use horizon_shaderpack::uniforms::SmoothFloat; /// The `Frame` uniform of the prelude (`shader_pack_prelude.wgsl`). @@ -45,7 +45,59 @@ pub struct FrameExtUniform { pub environment: [f32; 4], } -const NOISE_SIZE: u32 = 256; +/// Iris's `noisetex` without a `texture.noise`: 256² random RGB, opaque. +/// Horizon packs get the same one unless `[textures] noise` replaces it. +pub(super) fn noise() -> Rgba { + const SIZE: u32 = 256; + let mut seed = 0x2545_f491_u32; + let pixels = (0..SIZE * SIZE * 4) + .map(|i| { + seed ^= seed << 13; + seed ^= seed >> 17; + seed ^= seed << 5; + if i % 4 == 3 { 255 } else { (seed >> 24) as u8 } + }) + .collect(); + Rgba { + width: SIZE, + height: SIZE, + pixels, + } +} + +/// `image` as a sampled RGBA8 texture. +pub(super) fn rgba_view( + device: &wgpu::Device, + queue: &wgpu::Queue, + label: &str, + image: &Rgba, +) -> wgpu::TextureView { + let texture = device.create_texture(&wgpu::TextureDescriptor { + label: Some(label), + size: wgpu::Extent3d { + width: image.width, + height: image.height, + depth_or_array_layers: 1, + }, + mip_level_count: 1, + sample_count: 1, + dimension: wgpu::TextureDimension::D2, + format: wgpu::TextureFormat::Rgba8Unorm, + usage: wgpu::TextureUsages::TEXTURE_BINDING | wgpu::TextureUsages::COPY_DST, + view_formats: &[], + }); + queue.write_texture( + texture.as_image_copy(), + &image.pixels, + wgpu::TexelCopyBufferLayout { + offset: 0, + bytes_per_row: Some(image.width * 4), + rows_per_image: None, + }, + texture.size(), + ); + texture.create_view(&Default::default()) +} struct Pass { pipeline: wgpu::RenderPipeline, @@ -64,6 +116,10 @@ struct Target { pub struct PackStages { pub id: String, pub needs_shadow: bool, + /// The stages read the G-buffer (`build_gbuffer`) or the depth before + /// translucent geometry (`capture_opaque_depth`). + pub needs_gbuffer: bool, + pub needs_opaque_depth: bool, pub shadow_res: u32, pub shadow_dist: f32, layout: wgpu::BindGroupLayout, @@ -162,7 +218,7 @@ impl PackStages { .iter() .enumerate() .map(|(idx, stage)| { - let is_last = idx + 1 == stage_count || stage.kind == StageKind::Final; + let is_last = idx + 1 == stage_count; let target_format = if is_last { format } else { @@ -240,49 +296,16 @@ impl PackStages { ..Default::default() }) }; - let (nw, nh, noise_bytes) = match &pack.custom_noise { - Some((w, h, bytes)) => (*w, *h, bytes.clone()), - None => { - let mut seed = 0x2545_f491_u32; - let bytes: Vec = (0..NOISE_SIZE * NOISE_SIZE * 4) - .map(|i| { - seed ^= seed << 13; - seed ^= seed >> 17; - seed ^= seed << 5; - if i % 4 == 3 { 255 } else { (seed >> 24) as u8 } - }) - .collect(); - (NOISE_SIZE, NOISE_SIZE, bytes) - } + let noise_view = match &pack.custom_noise { + Some(image) => rgba_view(device, queue, "Shader pack noise", image), + None => rgba_view(device, queue, "Shader pack noise", &noise()), }; - let noise_tex = device.create_texture(&wgpu::TextureDescriptor { - label: Some("Shader pack noise"), - size: wgpu::Extent3d { - width: nw, - height: nh, - depth_or_array_layers: 1, - }, - mip_level_count: 1, - sample_count: 1, - dimension: wgpu::TextureDimension::D2, - format: wgpu::TextureFormat::Rgba8Unorm, - usage: wgpu::TextureUsages::TEXTURE_BINDING | wgpu::TextureUsages::COPY_DST, - view_formats: &[], - }); - queue.write_texture( - noise_tex.as_image_copy(), - &noise_bytes, - wgpu::TexelCopyBufferLayout { - offset: 0, - bytes_per_row: Some(nw * 4), - rows_per_image: None, - }, - noise_tex.size(), - ); - let (shadow_res, shadow_dist, _) = pack.shadow_config(0); + let (shadow_res, shadow_dist) = pack.shadow_config(); Ok(Self { id: pack.id.clone(), needs_shadow: pack.needs_shadow(), + needs_gbuffer: pack.needs_gbuffer(), + needs_opaque_depth: pack.needs_opaque_depth(), shadow_res, shadow_dist, layout, @@ -302,7 +325,7 @@ impl PackStages { wgpu::AddressMode::ClampToEdge, Some(wgpu::CompareFunction::GreaterEqual), ), - noise_view: noise_tex.create_view(&Default::default()), + noise_view, passes, targets: Vec::new(), output: None, @@ -462,7 +485,7 @@ impl PackStages { f32::from(eye_light[0]) * 16.0, f32::from(eye_light[1]) * 16.0, wet, - uniform.view_params[2] * 0.5, + 0.0, ], }; uniform.time[0] = self.started.elapsed().as_secs_f32(); diff --git a/crates/horizon-client/src/gfx/world_post.rs b/crates/horizon-client/src/gfx/world_post.rs index 69d95aae6..f592e8a1f 100644 --- a/crates/horizon-client/src/gfx/world_post.rs +++ b/crates/horizon-client/src/gfx/world_post.rs @@ -1,19 +1,19 @@ //! Resolution scale, FXAA, and shader-pack G-buffer/shadow targets (Horizon //! settings): the world renders into its own target at the scaled size, then //! one full-screen pass copies or anti-aliases it onto the screen, under the -//! hand and HUD. When a shader pack is active, `Post` also maintains: -//! - `opaque_depth` (`depthtex1`/`depthtex2`): depth captured before -//! translucent terrain (water, stained glass, ice) renders; -//! - `normal` (`colortex1`/`scene_normal`) and `material` -//! (`colortex2`/`scene_material`): G-buffer surface normals and material -//! properties reconstructed from depth and scene colour; -//! - `shadow_depth` (`shadowtex0`/`shadowtex1`): the directional sun/moon -//! shadow map and its light-space `shadow_view` and `shadow_proj` matrices. +//! hand and HUD. For a shader pack that reads them, `Post` also keeps: +//! - `opaque_depth`: the depth before translucent terrain (water, stained +//! glass, ice) draws, a Java pack's `depthtex1`/`depthtex2`; +//! - `normal` and `material`, an api 2 pack's `scene_normal` and +//! `scene_material`: surface normals and material properties +//! reconstructed from depth and scene colour; +//! - `shadow_depth`, an api 2 pack's: the sun/moon shadow map and its +//! light-space `shadow_view` and `shadow_proj` matrices. //! //! With none of them on, the world renders straight to the screen as before. use super::pack_stages::FrameUniform; -use glam::{Mat4, Vec3, Vec4}; +use glam::{Mat4, Vec3}; const GBUFFER_WGSL: &str = r#" struct GbufferParams { @@ -632,45 +632,34 @@ impl Post { self.target.as_ref().map(|t| t.size) } - /// Pre-translucent depth view (`depthtex1`/`depthtex2` / `opaque_depth`). + /// The depth before translucent geometry (`capture_opaque_depth`). pub fn opaque_depth(&self) -> &wgpu::TextureView { self.target .as_ref() .map_or(&self.fallback_shadow, |t| &t.opaque_depth) } - /// Reconstructed world-space normal G-buffer view (`colortex1` / `scene_normal`). + /// Reconstructed world-space normals (`scene_normal`). pub fn normal(&self) -> &wgpu::TextureView { self.target .as_ref() .map_or(&self.fallback_color, |t| &t.normal) } - /// Reconstructed material/lightmap G-buffer view (`colortex2` / `scene_material`). + /// Reconstructed material and light (`scene_material`). pub fn material(&self) -> &wgpu::TextureView { self.target .as_ref() .map_or(&self.fallback_color, |t| &t.material) } - /// Directional sun/moon shadow map view (`shadowtex0`/`shadowtex1` / `shadow_depth`). + /// The sun/moon shadow map (`shadow_depth` of api 2 packs). pub fn shadow_depth(&self) -> &wgpu::TextureView { self.shadow .as_ref() .map_or(&self.fallback_shadow, |s| &s.depth) } - /// OpenGL-convention (-1..1 Z) shadow projection for Java/Iris shader packs. - pub fn gl_shadow_projection(&self) -> Mat4 { - let to_gl = Mat4::from_cols( - Vec4::X, - Vec4::Y, - Vec4::new(0.0, 0.0, -2.0, 0.0), - Vec4::new(0.0, 0.0, 1.0, 1.0), - ); - to_gl * self.shadow_proj - } - /// Bindings that copy (or anti-alias) `view` onto the screen in `finish_with`. pub fn bind(&self, device: &wgpu::Device, view: &wgpu::TextureView) -> wgpu::BindGroup { device.create_bind_group(&wgpu::BindGroupDescriptor { diff --git a/crates/horizon-client/src/java_pack.rs b/crates/horizon-client/src/java_pack.rs index 5a37aa223..5e592d1b6 100644 --- a/crates/horizon-client/src/java_pack.rs +++ b/crates/horizon-client/src/java_pack.rs @@ -1,9 +1,9 @@ //! Java (OptiFine/Iris) shader packs in `shaderpacks/` (docs/shader-packs.md): //! a folder holding `shaders/`, or a `.zip`. `horizon-shaderpack` translates //! their full-screen programs (`begin`, `prepare`, `deferred`, `composite`, -//! `final`) to WGSL, and `gfx/java_stages.rs` runs them over Horizon's world, -//! G-buffers, pre-translucent depth (`depthtex1`) and directional shadow map -//! (`shadowtex0`/`shadowtex1`) as Iris runs them over its own. +//! `final`) to WGSL, and `gfx/java_stages.rs` runs them over Horizon's world +//! as Iris runs them over its own. Geometry programs (`gbuffers_*`, +//! `shadow`) don't run yet: the world is drawn by Horizon. use horizon_shaderpack::{ JavaPack, pipeline::{Directives, Program, TargetSettings}, @@ -30,10 +30,24 @@ pub struct JavaFolder { pub final_pass: Option, /// The targets whose alternate side holds the frame's last write. pub flipped_at_end: BTreeSet, - /// `sunPathRotation`, `eyeBrightnessHalflife`, shadow and wetness directives. + /// `sunPathRotation`, `eyeBrightnessHalflife`, `wetnessHalflife` and + /// `drynessHalflife`. pub directives: Directives, - /// Whether this dimension's passes read directional shadow maps. - pub shadow_enabled: bool, +} + +/// The key of `texture.noise` (`noisetex`) in [`JavaPasses::custom_textures`]. +pub const NOISE_KEY: &str = "noise"; + +/// The key of `texture..` in [`JavaPasses::custom_textures`] +/// for a pass of `program` (`world0/composite2`): Iris's texture stages, where +/// `final` reads the `composite` ones. +pub fn texture_key(program: &str, sampler: &str) -> String { + let name = program.rsplit('/').next().unwrap_or(program); + let stage = match name.trim_end_matches(|c: char| c.is_ascii_digit()) { + "final" => "composite", + stage => stage, + }; + format!("{stage}.{sampler}") } /// A loaded Java pack. @@ -43,8 +57,9 @@ pub struct JavaPasses { pub uniforms: CustomUniforms, /// What the pack keeps of the vanilla sky (`clouds`, `sun`, `moon`). pub sky: SkyDirectives, - /// Decoded RGBA8 custom textures (`sampler_name` → `(width, height, rgba)`). - pub custom_textures: BTreeMap)>, + /// `texture..` and `texture.noise` images, by + /// `"."` and [`NOISE_KEY`]. + pub custom_textures: BTreeMap, } impl JavaPasses { @@ -135,7 +150,6 @@ pub fn load( final_pass, flipped_at_end: plan.flipped_at_end, directives: plan.directives, - shadow_enabled: plan.shadow_enabled, }); } if folders.is_empty() { @@ -143,15 +157,23 @@ pub fn load( } let mut custom_textures = BTreeMap::new(); for tex in properties.custom_textures() { - if let Some(bytes) = pack.files.read_bytes(&tex.path) { - match crate::shader_pack::decode_png_rgba(&bytes) { - Ok(decoded) => { - custom_textures.insert(tex.sampler, decoded); - } - Err(e) => { - log::warn!("Horizon: shader pack texture {}: {e}", tex.path); - } + let key = match tex.stage { + Some(stage) => format!("{stage}.{}", tex.sampler), + None if tex.sampler == NOISE_KEY => NOISE_KEY.to_owned(), + None => continue, + }; + // Only PNGs for now: resource locations and raw `.dat` textures are + // skipped and the sampler reads what it would without them. + let image = pack + .files + .read_bytes(&tex.path) + .ok_or_else(|| "not in the pack".to_owned()) + .and_then(|bytes| crate::shader_pack::decode_png(&bytes)); + match image { + Ok(image) => { + custom_textures.insert(key, image); } + Err(e) => log::warn!("Horizon: shader pack texture {}: {e}", tex.path), } } let uniforms = properties.custom_uniforms(); @@ -170,6 +192,17 @@ pub fn load( mod tests { use super::*; + #[test] + fn custom_textures_belong_to_iris_s_stages() { + assert_eq!(texture_key("world0/composite2", "gaux1"), "composite.gaux1"); + assert_eq!(texture_key("final", "colortex4"), "composite.colortex4"); + assert_eq!( + texture_key("world-1/deferred10", "noisetex"), + "deferred.noisetex" + ); + assert_eq!(texture_key("prepare", "depthtex2"), "prepare.depthtex2"); + } + #[test] fn loads_the_full_screen_passes_of_a_java_pack() { let dir = Path::new(env!("CARGO_MANIFEST_DIR")) diff --git a/crates/horizon-client/src/options_ui.rs b/crates/horizon-client/src/options_ui.rs index 4ae78da40..1bb9953bf 100644 --- a/crates/horizon-client/src/options_ui.rs +++ b/crates/horizon-client/src/options_ui.rs @@ -10,6 +10,7 @@ use crate::{ keybinds::{self, CATEGORIES, KeyBinds, MAPPINGS}, lang::{self, LanguageInfo}, settings::{SOUND_SOURCES, Settings}, + shader_pack::PackConfig, text::{self, Style, Text}, ui, }; @@ -903,8 +904,6 @@ enum Act { /// Credits & Attribution's Credits button (WinScreen without the poem). Credits, CopyAgentDetails, - /// Pick and import a shader pack `.zip` or folder into `shaderpacks/`. - ImportShaderPack, ShaderPackProfile, ShaderPackSubscreen(String), ShaderPackBackScreen, @@ -968,9 +967,8 @@ pub enum Event { Credits, /// Copy how an agent connects (the AI Agent page). CopyAgentDetails, - /// Pick and import a shader pack `.zip` or folder into `shaderpacks/`. - ImportShaderPack, - /// Reload the active shader pack after its options file changed. + /// The shader pack settings page closed with changes: they are saved, + /// the pack is built again with them. ReloadShaderPack, } /// `SliderableValueSet.applyValueImmediately`: these apply 600 ms after @@ -1030,11 +1028,12 @@ pub struct OptionsUi { /// The AI Agent page's status lines (set by the game while it shows). pub agent_status: Vec, /// Loaded interactive configuration for the currently selected shader pack. - pub shader_pack_config: Option, - /// Classic shader option slider currently being dragged. + pub shader_pack_config: Option, + /// The shader pack option slider being dragged. pub(crate) dragging_shader_option: Option, - /// Horizon shader option slider currently being dragged. - pub(crate) hdragging_shader_option: Option, + /// `shader_pack_config` changed since the settings page opened: leaving + /// it saves the values and reloads the pack. + shader_pack_edited: bool, } impl Default for OptionsUi { fn default() -> Self { @@ -1068,7 +1067,7 @@ impl Default for OptionsUi { agent_status: Vec::new(), shader_pack_config: None, dragging_shader_option: None, - hdragging_shader_option: None, + shader_pack_edited: false, } } } @@ -1225,22 +1224,58 @@ impl OptionsUi { { return; } - let dir = if self.shader_packs.dir.as_os_str().is_empty() { + // A pack whose options can't be read has none, rather than being + // read again every frame. + let config = PackConfig::load(&self.shader_pack_dir(), id).unwrap_or_else(|e| { + log::warn!("Horizon: shader pack {id} options: {e}"); + PackConfig { + id: id.to_owned(), + ..Default::default() + } + }); + self.shader_pack_config = Some(config); + self.shader_pack_edited = false; + } + fn shader_pack_dir(&self) -> std::path::PathBuf { + if self.shader_packs.dir.as_os_str().is_empty() { crate::shader_pack::folder() } else { self.shader_packs.dir.clone() - }; - self.shader_pack_config = crate::shader_pack::PackConfig::load(&dir, id).ok(); + } + } + /// A file or folder dropped on the window: on the Shader Packs page (as + /// Iris's `ShaderPackScreen.onFilesDrop`), a pack copied into + /// `shaderpacks/` and picked. `None` elsewhere; the caller saves the + /// settings and loads the pack on `Some(Ok)`. + pub fn drop_shader_pack( + &mut self, + s: &mut Settings, + path: &std::path::Path, + ) -> Option> { + if self.page() != Page::ShaderPacks { + return None; + } + let dir = self.shader_pack_dir(); + Some(crate::shader_pack::import_pack(path, &dir).map(|id| { + self.shader_packs = Default::default(); + self.shader_packs.poll(dir); + s.horizon.shader_pack = id; + self.sync_shader_pack_config(s); + })) + } + /// Change the shader pack's options, applied when its page closes. + fn edit_shader_pack(&mut self, edit: impl FnOnce(&mut PackConfig)) { + if let Some(cfg) = &mut self.shader_pack_config { + edit(cfg); + self.shader_pack_edited = true; + } } /// Save the active shader pack options to `shaderpacks/.txt`. - pub(crate) fn save_shader_pack_config(&self) { - if let Some(cfg) = &self.shader_pack_config { - let dir = if self.shader_packs.dir.as_os_str().is_empty() { - crate::shader_pack::folder() - } else { - self.shader_packs.dir.clone() - }; - let _ = cfg.save(&dir); + fn save_shader_pack_config(&self) { + if let Some(cfg) = &self.shader_pack_config + && let Err(e) = cfg.save(&self.shader_pack_dir()) + { + log::warn!("Horizon: shader pack {} options: {e}", cfg.id); } } pub(crate) fn shader_pack_failed(&self, id: &str) -> bool { @@ -1658,27 +1693,10 @@ impl OptionsUi { button( 0.0, 0.0, - 150.0, + 310.0, Text::literal("Shader Pack Settings..."), Act::Push(Page::ShaderPackOptions), ), - Some(button( - 0.0, - 0.0, - 150.0, - Text::literal("Import Shader Pack..."), - Act::ImportShaderPack, - )), - )); - } else { - rows.push(Row::Buttons( - button( - 0.0, - 0.0, - 310.0, - Text::literal("Import Shader Pack..."), - Act::ImportShaderPack, - ), None, )); } @@ -2725,14 +2743,12 @@ impl OptionsUi { }) { let v = ui::slider_value(wd.x, wd.w, x); - if let Some(cfg) = &mut self.shader_pack_config - && let Some(opt) = cfg.options.get_mut(idx) - { - opt.set_slider_pos(v); - } - self.save_shader_pack_config(); + self.edit_shader_pack(|cfg| { + if let Some(opt) = cfg.options.get_mut(idx) { + opt.set_slider_pos(v); + } + }); events.push(Event::Changed); - events.push(Event::ReloadShaderPack); } return events; } @@ -2821,14 +2837,9 @@ impl OptionsUi { Act::OpenShaderPackFolder => events.push(Event::OpenShaderPackFolder), Act::Credits => events.push(Event::Credits), Act::CopyAgentDetails => events.push(Event::CopyAgentDetails), - Act::ImportShaderPack => events.push(Event::ImportShaderPack), Act::ShaderPackProfile => { - if let Some(cfg) = &mut self.shader_pack_config { - cfg.cycle_profile(right); - } - self.save_shader_pack_config(); + self.edit_shader_pack(|cfg| cfg.cycle_profile(false)); events.push(Event::Changed); - events.push(Event::ReloadShaderPack); } Act::ShaderPackSubscreen(sub) => { if let Some(cfg) = &mut self.shader_pack_config { @@ -2843,22 +2854,16 @@ impl OptionsUi { self.scroll = 0.0; } Act::ShaderPackOption(i) => { - if let Some(cfg) = &mut self.shader_pack_config - && let Some(opt) = cfg.options.get_mut(i) - { - opt.cycle(right); - } - self.save_shader_pack_config(); + self.edit_shader_pack(|cfg| { + if let Some(opt) = cfg.options.get_mut(i) { + opt.cycle(false); + } + }); events.push(Event::Changed); - events.push(Event::ReloadShaderPack); } Act::ResetShaderPackOptions => { - if let Some(cfg) = &mut self.shader_pack_config { - cfg.reset_all(); - } - self.save_shader_pack_config(); + self.edit_shader_pack(PackConfig::reset_all); events.push(Event::Changed); - events.push(Event::ReloadShaderPack); } Act::None => {} } @@ -2873,14 +2878,12 @@ impl OptionsUi { WKind::ShaderOptionSlider { index, .. } => { self.dragging_shader_option = Some(index); let v = ui::slider_value(wd.x, wd.w, x); - if let Some(cfg) = &mut self.shader_pack_config - && let Some(opt) = cfg.options.get_mut(index) - { - opt.set_slider_pos(v); - } - self.save_shader_pack_config(); + self.edit_shader_pack(|cfg| { + if let Some(opt) = cfg.options.get_mut(index) { + opt.set_slider_pos(v); + } + }); events.push(Event::Changed); - events.push(Event::ReloadShaderPack); } WKind::LanguageRow { code, .. } => { if self.language_choice.as_deref() == Some(code.as_str()) { @@ -2910,9 +2913,7 @@ impl OptionsUi { } // AbstractSliderButton suppresses the press sound and plays once on // release, even if the pointer has left the widget or its value stayed. - let slider = self.dragging.take().is_some() - || self.dragging_shader_option.take().is_some() - || self.hdragging_shader_option.take().is_some(); + let slider = self.dragging.take().is_some() || self.dragging_shader_option.take().is_some(); let graphics_slider = self.graphics.release(); if slider || graphics_slider { vec![Event::ButtonClick] @@ -2992,6 +2993,12 @@ impl OptionsUi { events.push(Event::Language(code)); } } + // Iris's ShaderPackScreen applies its edits on Done, so the + // pack is rebuilt once, not on every click or slider step. + Page::ShaderPackOptions if std::mem::take(&mut self.shader_pack_edited) => { + self.save_shader_pack_config(); + events.push(Event::ReloadShaderPack); + } Page::Packs => { // PackSelectionScreen.onClose: PackSelectionModel.commit. if let Some(p) = self.pack_screen.take() @@ -3416,19 +3423,73 @@ mod tests { false, ); assert_eq!(s.horizon.shader_pack, "", "a second click turns it off"); - let import_btn = find(&mut ui, &s, &|a| *a == Act::ImportShaderPack).unwrap(); + let _ = std::fs::remove_dir_all(&dir); + } + + #[test] + fn a_dropped_pack_is_picked_and_its_settings_apply_on_done() { + let atlas = atlas(); + let mut s = Settings::default(); + let mut ui = OptionsUi::default(); + let size = (480.0, 240.0); + let dir = + std::env::temp_dir().join(format!("horizon-shaderpack-drop-{}", std::process::id())); + let _ = std::fs::remove_dir_all(&dir); + std::fs::create_dir_all(&dir).unwrap(); + ui.shader_packs.poll(dir.clone()); + let sample = std::path::Path::new(env!("CARGO_MANIFEST_DIR")) + .join("../../examples/shaderpacks/horizon-sample"); assert_eq!( + ui.drop_shader_pack(&mut s, &sample), + None, + "only on its page" + ); + ui.show(Page::ShaderPacks); + assert_eq!(ui.drop_shader_pack(&mut s, &sample), Some(Ok(()))); + assert_eq!(s.horizon.shader_pack, "horizon-sample"); + assert!(dir.join("horizon-sample/pack.toml").is_file()); + let again = ui.drop_shader_pack(&mut s, &sample).unwrap().unwrap_err(); + assert!(again.contains("already"), "{again}"); + + let click = |ui: &mut OptionsUi, s: &mut Settings, act: &dyn Fn(&Act) -> bool| { + let w = ui + .layout(s, size.0, size.1) + .0 + .into_iter() + .find(|w| matches!(&w.kind, WKind::Button { act: a, active: true, .. } if act(a))) + .unwrap(); ui.click( - &mut s, + s, &atlas, - import_btn.x + 1.0, - import_btn.y + 1.0, + w.x + 1.0, + w.y + 1.0, size, [480, 240], false, false, - ), - vec![Event::ButtonClick, Event::ImportShaderPack] + ) + }; + click(&mut ui, &mut s, &|a| { + *a == Act::Push(Page::ShaderPackOptions) + }); + assert_eq!(ui.page(), Page::ShaderPackOptions); + for _ in 0..3 { + let events = click(&mut ui, &mut s, &|a| matches!(a, Act::ShaderPackOption(_))); + assert!(!events.contains(&Event::ReloadShaderPack), "{events:?}"); + } + let txt = dir.join("horizon-sample.txt"); + assert!(!txt.exists(), "nothing is saved before Done"); + let events = click(&mut ui, &mut s, &|a| *a == Act::Done); + assert!(events.contains(&Event::ReloadShaderPack), "{events:?}"); + assert_eq!(ui.page(), Page::ShaderPacks); + assert!(txt.is_file(), "Done saves the values"); + click(&mut ui, &mut s, &|a| { + *a == Act::Push(Page::ShaderPackOptions) + }); + let events = click(&mut ui, &mut s, &|a| *a == Act::Done); + assert!( + !events.contains(&Event::ReloadShaderPack), + "no change: no reload" ); let _ = std::fs::remove_dir_all(&dir); } diff --git a/crates/horizon-client/src/shader_pack.rs b/crates/horizon-client/src/shader_pack.rs index f5a15ca79..d00384748 100644 --- a/crates/horizon-client/src/shader_pack.rs +++ b/crates/horizon-client/src/shader_pack.rs @@ -18,6 +18,13 @@ pub const API: u32 = 2; /// The folder beside `options.txt` that holds the packs. pub const DIR: &str = "shaderpacks"; pub const PRELUDE: &str = include_str!("shader_pack_prelude.wgsl"); +/// What api 2 adds after [`PRELUDE`] (`api = 2` packs only). +pub const PRELUDE_API2: &str = include_str!("shader_pack_prelude_api2.wgsl"); +/// [`PRELUDE_API2`]'s bindings that cost a pass when a stage reads them. +const BINDING_SCENE_NORMAL: u32 = 7; +const BINDING_SCENE_MATERIAL: u32 = 8; +const BINDING_OPAQUE_DEPTH: u32 = 9; +const BINDING_SHADOW_DEPTH: u32 = 10; /// The prelude's vertex entry point, shared by every stage. pub const VERTEX_ENTRY: &str = "horizon_stage_vertex"; const MAX_STAGES: usize = 16; @@ -58,8 +65,6 @@ struct StageEntry { entry: Option, scale: Option, format: Option, - #[serde(default)] - mipmap: bool, } #[derive(Deserialize)] #[serde(deny_unknown_fields)] @@ -74,20 +79,11 @@ struct OptionEntry { values: Option>, } -/// Where a stage runs. Api 1 has `composite` only; Api 2 adds `shadow`, -/// `gbuffer`, `deferred` and `final`. +/// Where a stage runs: `composite` only so far (docs/shader-packs.md, Stages). #[derive(Clone, Copy, Debug, PartialEq, Eq)] pub enum StageKind { - /// Directional sun/moon shadow map pass. - Shadow, - /// Material / G-buffer evaluation pass over world colour, depth and normals. - Gbuffer, - /// Opaque world lighting pass (runs before translucent water/weather). - Deferred, /// After the world pass, before the hand: reads the scene's colour and depth. Composite, - /// Final tonemapping / anti-aliasing pass before HUD and menus. - Final, } #[derive(Clone, Debug)] pub struct Stage { @@ -99,11 +95,13 @@ pub struct Stage { pub entry: String, /// Target size relative to the world's. pub scale: f32, - /// Optional target format name (`rgba16float`, `rgba8unorm`). + /// The target's format ([`STAGE_FORMATS`]); `None`: the screen's. pub format: Option, - /// Whether the previous stage's output is mipmapped before this stage runs. - pub mipmap: bool, + /// The prelude bindings (group 0) the stage reads. + pub bindings: BTreeSet, } +/// The `format`s a stage's target can have. +pub const STAGE_FORMATS: [&str; 3] = ["rgba8unorm", "rgba16float", "rgb10a2unorm"]; #[derive(Clone, Copy, Debug, PartialEq)] pub enum OptionKind { Bool, @@ -377,22 +375,18 @@ impl PackConfig { fn load_java(path: &Path, id: &str, saved: &BTreeMap) -> Result { let pack = JavaPack::open(path)?; let values = pack.values(saved); + // The menus don't know the GPU: `shaders.properties` is read as on an + // unknown one (the screens and profiles of the packs tested don't + // depend on it). let env = Environment::iris("Unknown", "", 4); let props = pack.properties(&values, &env).unwrap_or_default(); let lang = pack.translations("en_us"); let sliders: BTreeSet<&str> = props.sliders().into_iter().collect(); - let option_label = |name: &str, comment: Option<&str>| -> String { - lang.get(&format!("option.{name}")) - .cloned() - .or_else(|| { - comment - .map(str::trim) - .filter(|c| !c.is_empty() && c.len() <= 40 && !c.contains('.')) - .map(str::to_owned) - }) - .unwrap_or_else(|| humanize_identifier(name)) - }; + // Iris's names: the `.lang` entry, else the name itself; the tooltip + // from `.lang`, else the option's comment. + let named = |key: String, name: &str| lang.get(&key).cloned().unwrap_or(name.to_owned()); + let option_label = |name: &str| named(format!("option.{name}"), name); let option_desc = |name: &str, comment: Option<&str>| -> String { lang.get(&format!("option.{name}.comment")) .cloned() @@ -407,7 +401,7 @@ impl PackConfig { let idx = options.len(); options.push(PackOption { key: name.clone(), - label: option_label(name, b.comment.as_deref()), + label: option_label(name), description: option_desc(name, b.comment.as_deref()), kind: OptionKind::Bool, values: Vec::new(), @@ -428,19 +422,12 @@ impl PackConfig { let choices: Vec<(String, String)> = s .allowed .iter() - .map(|raw| { - let label = lang - .get(&format!("value.{name}.{raw}")) - .or_else(|| lang.get(&format!("option.{name}.value.{raw}"))) - .cloned() - .unwrap_or_else(|| raw.clone()); - (raw.clone(), label) - }) + .map(|raw| (raw.clone(), named(format!("value.{name}.{raw}"), raw))) .collect(); let idx = options.len(); options.push(PackOption { key: name.clone(), - label: option_label(name, s.comment.as_deref()), + label: option_label(name), description: option_desc(name, s.comment.as_deref()), kind: OptionKind::Choice { slider: sliders.contains(name.as_str()), @@ -460,10 +447,7 @@ impl PackConfig { .unwrap_or_default() .into_iter() .map(|p| { - let label = lang - .get(&format!("profile.{}", p.name)) - .cloned() - .unwrap_or_else(|| humanize_identifier(&p.name)); + let label = named(format!("profile.{}", p.name), &p.name); PackProfile { name: p.name, label, @@ -501,10 +485,7 @@ impl PackConfig { } } MenuElement::Screen(sub) => { - let label = lang - .get(&format!("screen.{sub}")) - .cloned() - .unwrap_or_else(|| humanize_identifier(&sub)); + let label = named(format!("screen.{sub}"), &sub); items.push(ScreenItem::Subscreen(sub, label)); } MenuElement::Option(opt) => { @@ -523,10 +504,7 @@ impl PackConfig { } let name_str = screen_name.unwrap_or("").to_owned(); let label = match screen_name { - Some(n) => lang - .get(&format!("screen.{n}")) - .cloned() - .unwrap_or_else(|| humanize_identifier(n)), + Some(n) => named(format!("screen.{n}"), n), None => id.to_owned(), }; PackScreen { @@ -700,7 +678,7 @@ pub struct ShaderPack { pub stages: Vec, pub options: Vec, /// Optional custom noise/LUT texture bytes (RGBA8, width, height) from `[textures]`. - pub custom_noise: Option<(u32, u32, Vec)>, + pub custom_noise: Option, /// A Java (OptiFine/Iris) pack's translated passes, instead of `stages`. pub java: Option, dir: PathBuf, @@ -813,6 +791,9 @@ pub fn import_pack(source: &Path, target_dir: &Path) -> Result { if dest.canonicalize().ok() == source.canonicalize().ok() { return Ok(name); } + if dest.exists() { + return Err(format!("{name} is already in {DIR}/")); + } if source.is_file() { fs::copy(&source, &dest).map_err(|e| format!("failed to copy {name}: {e}"))?; } else { @@ -827,10 +808,13 @@ fn copy_dir_recursive(src: &Path, dst: &Path) -> Result<(), String> { for entry in entries.flatten() { let path = entry.path(); let target = dst.join(entry.file_name()); - if path.is_dir() { - copy_dir_recursive(&path, &target)?; - } else { - fs::copy(&path, &target).map_err(|e| format!("{}: {e}", target.display()))?; + // Links aren't followed: one pointing up the tree would never end. + match entry.file_type() { + Ok(t) if t.is_dir() => copy_dir_recursive(&path, &target)?, + Ok(t) if t.is_file() => { + fs::copy(&path, &target).map_err(|e| format!("{}: {e}", target.display()))?; + } + _ => {} } } Ok(()) @@ -858,17 +842,13 @@ impl Folder { self.dir = dir; self.read = Some(std::time::Instant::now()); } - - pub fn invalidate(&mut self) { - self.read = None; - } } /// A Java pack has no manifest: its name is its file name. fn java_info(name: String) -> Info { Info { name, - description: "Iris/OptiFine pack: G-buffers, shadow map and post passes.".into(), + description: "Iris/OptiFine pack: its full-screen passes run.".into(), authors: Vec::new(), version: String::new(), license: String::new(), @@ -888,7 +868,16 @@ fn manifest(dir: &Path) -> Result { Ok(manifest) } -pub(crate) fn decode_png_rgba(bytes: &[u8]) -> Result<(u32, u32, Vec), String> { +/// An RGBA8 image (`decode_png`). +#[derive(Clone, Debug, PartialEq, Eq)] +pub struct Rgba { + pub width: u32, + pub height: u32, + pub pixels: Vec, +} + +/// A PNG of any colour type as [`Rgba`]. +pub(crate) fn decode_png(bytes: &[u8]) -> Result { let mut decoder = png::Decoder::new(std::io::Cursor::new(bytes)); decoder.set_transformations(png::Transformations::EXPAND | png::Transformations::STRIP_16); let mut reader = decoder.read_info().map_err(|e| e.to_string())?; @@ -913,7 +902,11 @@ pub(crate) fn decode_png_rgba(bytes: &[u8]) -> Result<(u32, u32, Vec), Strin png::ColorType::Grayscale => buf.into_iter().flat_map(|g| [g, g, g, 255]).collect(), _ => return Err("unsupported PNG color format".into()), }; - Ok((w, h, rgba)) + Ok(Rgba { + width: w, + height: h, + pixels: rgba, + }) } impl ShaderPack { @@ -936,18 +929,25 @@ impl ShaderPack { .collect::, _>>()?; let mut stages = Vec::new(); for entry in manifest.stage { - let kind = match (pack_api, entry.kind.as_str()) { - (_, "composite") => StageKind::Composite, - (2.., "shadow") => StageKind::Shadow, - (2.., "gbuffer") => StageKind::Gbuffer, - (2.., "deferred") => StageKind::Deferred, - (2.., "final") => StageKind::Final, - (_, other) => { + let kind = match entry.kind.as_str() { + "composite" => StageKind::Composite, + other => { return Err(format!( - "pack.toml: stage kind `{other}` isn't supported (api {pack_api} has `composite`)" + "pack.toml: stage kind `{other}` isn't supported (api {API} has `composite`)" )); } }; + if pack_api == 1 && entry.format.is_some() { + return Err(format!("pack.toml: {}: `format` needs api 2", entry.shader)); + } + if let Some(format) = entry.format.as_deref() + && !STAGE_FORMATS.contains(&format) + { + return Err(format!( + "pack.toml: stage format `{format}` isn't one of {}", + STAGE_FORMATS.join(", ") + )); + } let scale = entry.scale.unwrap_or(1.0); if !(0.25..=2.0).contains(&scale) { return Err(format!( @@ -961,8 +961,17 @@ impl ShaderPack { } let code = fs::read_to_string(&path).map_err(|e| format!("{}: {e}", entry.shader))?; let entry_point = entry.entry.unwrap_or_else(|| "fs_main".into()); - let source = format!("{PRELUDE}\n{code}"); - validate(&source, &entry.shader, &entry_point)?; + let prelude = match pack_api { + 1 => PRELUDE.to_owned(), + _ => format!("{PRELUDE}\n{PRELUDE_API2}"), + }; + let source = format!("{prelude}\n{code}"); + let bindings = validate( + &source, + prelude.lines().count(), + &entry.shader, + &entry_point, + )?; stages.push(Stage { kind, file: entry.shader, @@ -970,20 +979,21 @@ impl ShaderPack { entry: entry_point, scale, format: entry.format, - mipmap: entry.mipmap, + bindings, }); } let mut custom_noise = None; - if let Some(rel) = manifest - .textures - .get("noise") - .or_else(|| manifest.textures.values().next()) - { + for (name, rel) in &manifest.textures { + if name != "noise" { + return Err(format!( + "pack.toml: texture `{name}` isn't supported (api {API} has `noise`)" + )); + } if rel.contains("..") { return Err(format!("pack.toml: texture {rel} is outside the pack")); } let bytes = fs::read(dir.join(rel)).map_err(|e| format!("{rel}: {e}"))?; - custom_noise = Some(decode_png_rgba(&bytes).map_err(|e| format!("{rel}: {e}"))?); + custom_noise = Some(decode_png(&bytes).map_err(|e| format!("{rel}: {e}"))?); } Ok(Self { id: dir @@ -1016,43 +1026,38 @@ impl ShaderPack { .file_name() .map(|n| n.to_string_lossy().into_owned()) .unwrap_or_default(); - let options = PackConfig::load_java(path, &id, values) - .map(|c| c.options) - .unwrap_or_default(); Ok(Self { info: java_info(id.clone()), id, stages: Vec::new(), - options, + options: Vec::new(), custom_noise: None, java: Some(java), dir: path.to_path_buf(), stamp, }) } - /// Whether this pack requests directional shadow map rendering. - pub fn needs_shadow(&self) -> bool { - if let Some(java) = &self.java { - return java.folders.iter().any(|f| f.shadow_enabled); - } - self.stages.iter().any(|s| { - s.kind == StageKind::Shadow - || s.source.contains("sample_shadow") - || s.source.contains("shadow_depth") - }) + /// Whether a stage reads one of the prelude's `bindings`. + fn reads(&self, bindings: &[u32]) -> bool { + self.stages + .iter() + .any(|s| bindings.iter().any(|b| s.bindings.contains(b))) } - /// Shadow map resolution requested by this pack, and shadow distance in blocks. - pub fn shadow_config(&self, dimension: i8) -> (u32, f32, f32) { - if let Some(java) = &self.java - && let Some(idx) = java.folder_for(dimension) - { - let d = &java.folders[idx].directives; - return ( - d.shadow_map_resolution, - d.shadow_distance, - d.sun_path_rotation, - ); - } + /// Whether a stage reads the shadow map (`shadow_depth`, `sample_shadow`). + pub fn needs_shadow(&self) -> bool { + self.reads(&[BINDING_SHADOW_DEPTH]) + } + /// Whether a stage reads the G-buffer (`scene_normal`, `scene_material`). + pub fn needs_gbuffer(&self) -> bool { + self.reads(&[BINDING_SCENE_NORMAL, BINDING_SCENE_MATERIAL]) + } + /// Whether the world's depth before translucent geometry is kept + /// (`opaque_depth`, which the G-buffer is also built from). + pub fn needs_opaque_depth(&self) -> bool { + self.needs_gbuffer() || self.reads(&[BINDING_OPAQUE_DEPTH]) + } + /// The shadow map's resolution and distance in blocks. + pub fn shadow_config(&self) -> (u32, f32) { let res = self .options .iter() @@ -1065,7 +1070,7 @@ impl ShaderPack { .find(|o| o.key == "shadow_distance" || o.key == "shadowDistance") .map(|o| (o.value as f32).clamp(16.0, 512.0)) .unwrap_or(128.0); - (res, dist, 0.0) + (res, dist) } /// The pipeline-overridable constants every stage gets: the option values. pub fn constants(&self) -> Vec<(&str, f64)> { @@ -1139,8 +1144,15 @@ fn option( /// naga parses and validates the stage (prelude included) and checks its /// fragment entry point; errors point into the pack's own file. -fn validate(source: &str, file: &str, entry: &str) -> Result<(), String> { - let prelude_lines = PRELUDE.lines().count() as u32 + 1; +/// Parse and validate a stage: the prelude's bindings (group 0) its entry +/// point uses, or the error at the stage's own line. +fn validate( + source: &str, + prelude_lines: usize, + file: &str, + entry: &str, +) -> Result, String> { + let prelude_lines = prelude_lines as u32 + 1; let at = |location: Option| match location { Some(l) if l.line_number > prelude_lines => { format!( @@ -1153,20 +1165,28 @@ fn validate(source: &str, file: &str, entry: &str) -> Result<(), String> { }; let module = naga::front::wgsl::parse_str(source) .map_err(|e| format!("{}: {}", at(e.location(source)), e.message()))?; - naga::valid::Validator::new( + let info = naga::valid::Validator::new( naga::valid::ValidationFlags::all(), naga::valid::Capabilities::default(), ) .validate(&module) .map_err(|e| format!("{}: {}", at(e.location(source)), e.as_inner()))?; - if !module + let Some(index) = module .entry_points .iter() - .any(|e| e.name == entry && e.stage == naga::ShaderStage::Fragment) - { + .position(|e| e.name == entry && e.stage == naga::ShaderStage::Fragment) + else { return Err(format!("{file}: no fragment entry point `{entry}`")); - } - Ok(()) + }; + let uses = info.get_entry_point(index); + Ok(module + .global_variables + .iter() + .filter(|(handle, _)| !uses[*handle].is_empty()) + .filter_map(|(_, var)| var.binding.as_ref()) + .filter(|binding| binding.group == 0) + .map(|binding| binding.binding) + .collect()) } /// The option values saved for a pack (`shaderpacks/.txt`, `key=value`). @@ -1312,6 +1332,20 @@ override mode: i32 = 1; MANIFEST.replace("\"composite\"", "\"shadow\""), "stage kind `shadow`", ), + ( + MANIFEST.replace( + "kind = \"composite\"", + "kind = \"composite\"\nformat = \"rgba16float\"", + ), + "`format` needs api 2", + ), + ( + MANIFEST.replace("api = 1", "api = 2").replace( + "kind = \"composite\"", + "kind = \"composite\"\nformat = \"rgba32float\"", + ), + "stage format `rgba32float`", + ), ( MANIFEST.replace("grade.wgsl", "../grade.wgsl"), "outside the pack", @@ -1334,12 +1368,27 @@ override mode: i32 = 1; #[test] fn api_2_stages_and_pack_config_work() { - let manifest_v2 = MANIFEST - .replace("api = 1", "api = 2") - .replace("\"composite\"", "\"deferred\""); + let manifest_v2 = MANIFEST.replace("api = 1", "api = 2").replace( + "kind = \"composite\"", + "kind = \"composite\"\nformat = \"rgba16float\"", + ); let dir = pack(&[("pack.toml", &manifest_v2), ("shaders/grade.wgsl", GRADE)]); let loaded = ShaderPack::load(&dir, &BTreeMap::new()).unwrap(); - assert_eq!(loaded.stages[0].kind, StageKind::Deferred); + assert_eq!(loaded.stages[0].format.as_deref(), Some("rgba16float")); + assert!( + !loaded.needs_shadow() && !loaded.needs_gbuffer() && !loaded.needs_opaque_depth(), + "reading none of them costs no pass" + ); + let opaque = GRADE.replace("depth_at(in.uv)", "opaque_depth_at(in.uv)"); + let reads = pack(&[("pack.toml", &manifest_v2), ("shaders/grade.wgsl", &opaque)]); + let reads = ShaderPack::load(&reads, &BTreeMap::new()).unwrap(); + assert!(reads.needs_opaque_depth() && !reads.needs_gbuffer()); + let api_1 = pack(&[("pack.toml", MANIFEST), ("shaders/grade.wgsl", &opaque)]); + let error = ShaderPack::load(&api_1, &BTreeMap::new()).err().unwrap(); + assert!( + error.contains("opaque_depth_at"), + "api 1 stages don't see api 2's names: {error}" + ); let parent = dir.parent().unwrap(); let id = dir.file_name().unwrap().to_str().unwrap(); let mut cfg = PackConfig::load(parent, id).unwrap(); diff --git a/crates/horizon-client/src/shader_pack_prelude.wgsl b/crates/horizon-client/src/shader_pack_prelude.wgsl index ebe3ad4cf..7b16690f9 100644 --- a/crates/horizon-client/src/shader_pack_prelude.wgsl +++ b/crates/horizon-client/src/shader_pack_prelude.wgsl @@ -1,7 +1,6 @@ -// Horizon shader pack prelude, api 2 (docs/shader-packs.md): placed before -// every stage's source. Bindings, the Frame and FrameExt uniforms, the -// full-screen vertex shader, G-buffer/shadow accessors and PBR/post helpers -// that hide the renderer's reversed depth. +// Horizon shader pack prelude, api 1 (docs/shader-packs.md): placed before +// every stage's source. Bindings, the Frame uniform, the full-screen vertex +// shader and helpers that hide the renderer's reversed depth. struct Frame { view: mat4x4, projection: mat4x4, @@ -20,36 +19,12 @@ struct Frame { view_params: vec4, dimension: vec4, } - -struct FrameExt { - previous_view: mat4x4, - previous_projection: mat4x4, - shadow_view: mat4x4, - shadow_projection: mat4x4, - shadow_inverse_view: mat4x4, - shadow_inverse_projection: mat4x4, - // xyz: previous camera world position, w: frame delta time (seconds) - previous_camera: vec4, - // x: shadow map resolution, y: shadow distance (blocks), z: sun_path_rotation (rad), w: shadow strength - shadow_params: vec4, - // x: eye block light (0..240), y: eye sky light (0..240), z: smoothed wetness (0..1), w: center linear depth - environment: vec4, -} - @group(0) @binding(0) var scene_color: texture_2d; @group(0) @binding(1) var scene_depth: texture_depth_2d; @group(0) @binding(2) var previous: texture_2d; @group(0) @binding(3) var linear_sampler: sampler; @group(0) @binding(4) var nearest_sampler: sampler; @group(0) @binding(5) var frame: Frame; -@group(0) @binding(6) var frame_ext: FrameExt; -@group(0) @binding(7) var scene_normal: texture_2d; -@group(0) @binding(8) var scene_material: texture_2d; -@group(0) @binding(9) var opaque_depth: texture_depth_2d; -@group(0) @binding(10) var shadow_depth: texture_depth_2d; -@group(0) @binding(11) var shadow_sampler: sampler_comparison; -@group(0) @binding(12) var noise_texture: texture_2d; -@group(0) @binding(13) var repeat_sampler: sampler; struct StageIn { @builtin(position) position: vec4, @@ -67,10 +42,6 @@ struct StageIn { fn depth_at(uv: vec2) -> f32 { return textureSampleLevel(scene_depth, nearest_sampler, uv, 0); } -// The opaque world's depth at `uv` (before translucent water and stained glass). -fn opaque_depth_at(uv: vec2) -> f32 { - return textureSampleLevel(opaque_depth, nearest_sampler, uv, 0); -} fn is_sky(depth: f32) -> bool { return depth <= 0.0; } @@ -89,70 +60,6 @@ fn view_position(uv: vec2, depth: f32) -> vec3 { fn world_offset(uv: vec2, depth: f32) -> vec3 { return (frame.inverse_view * vec4(view_position(uv, depth), 1.0)).xyz; } -// World-space surface normal at `uv` from the G-buffer (or reconstructed from depth). -fn world_normal_at(uv: vec2) -> vec3 { - let encoded = textureSampleLevel(scene_normal, nearest_sampler, uv, 0.0); - if encoded.w > 0.001 { - return normalize(encoded.xyz * 2.0 - 1.0); - } - let step_uv = frame.resolution.zw; - let d0 = depth_at(uv); - let p0 = world_offset(uv, d0); - let px = world_offset(uv + vec2(step_uv.x, 0.0), depth_at(uv + vec2(step_uv.x, 0.0))) - p0; - let py = world_offset(uv + vec2(0.0, step_uv.y), depth_at(uv + vec2(0.0, step_uv.y))) - p0; - let n = cross(py, px); - let len = length(n); - if len > 1e-6 { - return n / len; - } - return vec3(0.0, 1.0, 0.0); -} -// G-buffer material data at `uv`: r = block light (0..1), g = sky light (0..1), -// b = water/translucent mask (0..1), a = roughness (0..1). -fn material_at(uv: vec2) -> vec4 { - return textureSampleLevel(scene_material, nearest_sampler, uv, 0.0); -} -// Reproject a camera-relative world position into previous-frame UV and clip depth. -fn reproject_uv(world_rel: vec3) -> vec3 { - let camera_delta = frame.camera_position.xyz - frame_ext.previous_camera.xyz; - let prev_rel = world_rel + camera_delta; - let clip = frame_ext.previous_projection * (frame_ext.previous_view * vec4(prev_rel, 1.0)); - if clip.w <= 1e-5 { - return vec3(-1.0); - } - let ndc = clip.xyz / clip.w; - return vec3(ndc.x * 0.5 + 0.5, 0.5 - ndc.y * 0.5, ndc.z); -} -// Sample the directional sun/moon shadow map with 5-tap PCF and normal offset bias. -// Returns 1.0 in full light and 0.0 in full shadow. -fn sample_shadow(world_rel: vec3, world_normal: vec3) -> f32 { - if frame_ext.shadow_params.w <= 0.001 { - return 1.0; - } - let dist = length(world_rel); - let max_dist = max(frame_ext.shadow_params.y, 16.0); - if dist >= max_dist { - return 1.0; - } - let light_dir = normalize(select(frame.moon.xyz, frame.sun.xyz, frame.sun.y >= -0.05)); - let ndotl = max(dot(world_normal, light_dir), 0.0); - let bias_pos = world_rel + world_normal * (0.06 + 0.12 * (1.0 - ndotl)); - let light_clip = frame_ext.shadow_projection * (frame_ext.shadow_view * vec4(bias_pos, 1.0)); - let ndc = light_clip.xyz / max(light_clip.w, 1e-5); - let shadow_uv = vec2(ndc.x * 0.5 + 0.5, 0.5 - ndc.y * 0.5); - if any(shadow_uv < vec2(0.002)) || any(shadow_uv > vec2(0.998)) || ndc.z <= 0.0 || ndc.z >= 1.0 { - return 1.0; - } - let texel = 1.0 / max(frame_ext.shadow_params.x, 512.0); - let ref_z = clamp(ndc.z + 0.0008, 0.0, 1.0); - var sum = textureSampleCompareLevel(shadow_depth, shadow_sampler, shadow_uv, ref_z); - sum += textureSampleCompareLevel(shadow_depth, shadow_sampler, shadow_uv + vec2(texel, 0.0), ref_z); - sum += textureSampleCompareLevel(shadow_depth, shadow_sampler, shadow_uv - vec2(texel, 0.0), ref_z); - sum += textureSampleCompareLevel(shadow_depth, shadow_sampler, shadow_uv + vec2(0.0, texel), ref_z); - sum += textureSampleCompareLevel(shadow_depth, shadow_sampler, shadow_uv - vec2(0.0, texel), ref_z); - let fade = smoothstep(max_dist, max_dist * 0.82, dist); - return mix(1.0, sum * 0.2, fade * frame_ext.shadow_params.w); -} fn luminance(c: vec3) -> f32 { return dot(c, vec3(0.2126, 0.7152, 0.0722)); } @@ -162,12 +69,3 @@ fn srgb_to_linear(c: vec3) -> vec3 { fn linear_to_srgb(c: vec3) -> vec3 { return select(1.055 * pow(c, vec3(1.0 / 2.4)) - 0.055, c * 12.92, c <= vec3(0.0031308)); } -// ACES fitted filmic tonemapping curve (linear HDR -> linear 0..1). -fn aces_tonemap(x: vec3) -> vec3 { - let a = 2.51; - let b = 0.03; - let c = 2.43; - let d = 0.59; - let e = 0.14; - return clamp((x * (a * x + b)) / (x * (c * x + d) + e), vec3(0.0), vec3(1.0)); -} diff --git a/crates/horizon-client/src/shader_pack_prelude_api2.wgsl b/crates/horizon-client/src/shader_pack_prelude_api2.wgsl new file mode 100644 index 000000000..80e9a205e --- /dev/null +++ b/crates/horizon-client/src/shader_pack_prelude_api2.wgsl @@ -0,0 +1,108 @@ +// Horizon shader pack prelude, api 2 additions (docs/shader-packs.md): placed +// after the api 1 prelude before the stages of an `api = 2` pack, so api 1 +// packs keep every name they may have declared themselves. +struct FrameExt { + previous_view: mat4x4, + previous_projection: mat4x4, + shadow_view: mat4x4, + shadow_projection: mat4x4, + shadow_inverse_view: mat4x4, + shadow_inverse_projection: mat4x4, + // xyz: previous camera world position, w: frame delta time (seconds) + previous_camera: vec4, + // x: shadow map resolution, y: shadow distance (blocks), z: 0, + // w: 1 while the shadow map is drawn this frame, else 0 + shadow_params: vec4, + // x: eye block light (0..240), y: eye sky light (0..240), z: smoothed + // rain (0..1), w: 0 + environment: vec4, +} + +@group(0) @binding(6) var frame_ext: FrameExt; +@group(0) @binding(7) var scene_normal: texture_2d; +@group(0) @binding(8) var scene_material: texture_2d; +@group(0) @binding(9) var opaque_depth: texture_depth_2d; +@group(0) @binding(10) var shadow_depth: texture_depth_2d; +@group(0) @binding(11) var shadow_sampler: sampler_comparison; +@group(0) @binding(12) var noise_texture: texture_2d; +@group(0) @binding(13) var repeat_sampler: sampler; + +// The opaque world's depth at `uv` (before translucent water and stained glass). +fn opaque_depth_at(uv: vec2) -> f32 { + return textureSampleLevel(opaque_depth, nearest_sampler, uv, 0); +} + +// World-space surface normal at `uv` from the G-buffer (or reconstructed from depth). +fn world_normal_at(uv: vec2) -> vec3 { + let encoded = textureSampleLevel(scene_normal, nearest_sampler, uv, 0.0); + if encoded.w > 0.001 { + return normalize(encoded.xyz * 2.0 - 1.0); + } + let step_uv = frame.resolution.zw; + let d0 = depth_at(uv); + let p0 = world_offset(uv, d0); + let px = world_offset(uv + vec2(step_uv.x, 0.0), depth_at(uv + vec2(step_uv.x, 0.0))) - p0; + let py = world_offset(uv + vec2(0.0, step_uv.y), depth_at(uv + vec2(0.0, step_uv.y))) - p0; + let n = cross(py, px); + let len = length(n); + if len > 1e-6 { + return n / len; + } + return vec3(0.0, 1.0, 0.0); +} +// G-buffer material data at `uv`: r = block light (0..1), g = sky light (0..1), +// b = water/translucent mask (0..1), a = roughness (0..1). +fn material_at(uv: vec2) -> vec4 { + return textureSampleLevel(scene_material, nearest_sampler, uv, 0.0); +} +// Reproject a camera-relative world position into previous-frame UV and clip depth. +fn reproject_uv(world_rel: vec3) -> vec3 { + let camera_delta = frame.camera_position.xyz - frame_ext.previous_camera.xyz; + let prev_rel = world_rel + camera_delta; + let clip = frame_ext.previous_projection * (frame_ext.previous_view * vec4(prev_rel, 1.0)); + if clip.w <= 1e-5 { + return vec3(-1.0); + } + let ndc = clip.xyz / clip.w; + return vec3(ndc.x * 0.5 + 0.5, 0.5 - ndc.y * 0.5, ndc.z); +} +// Sample the directional sun/moon shadow map with 5-tap PCF and normal offset bias. +// Returns 1.0 in full light and 0.0 in full shadow. +fn sample_shadow(world_rel: vec3, world_normal: vec3) -> f32 { + if frame_ext.shadow_params.w <= 0.001 { + return 1.0; + } + let dist = length(world_rel); + let max_dist = max(frame_ext.shadow_params.y, 16.0); + if dist >= max_dist { + return 1.0; + } + let light_dir = normalize(select(frame.moon.xyz, frame.sun.xyz, frame.sun.y >= -0.05)); + let ndotl = max(dot(world_normal, light_dir), 0.0); + let bias_pos = world_rel + world_normal * (0.06 + 0.12 * (1.0 - ndotl)); + let light_clip = frame_ext.shadow_projection * (frame_ext.shadow_view * vec4(bias_pos, 1.0)); + let ndc = light_clip.xyz / max(light_clip.w, 1e-5); + let shadow_uv = vec2(ndc.x * 0.5 + 0.5, 0.5 - ndc.y * 0.5); + if any(shadow_uv < vec2(0.002)) || any(shadow_uv > vec2(0.998)) || ndc.z <= 0.0 || ndc.z >= 1.0 { + return 1.0; + } + let texel = 1.0 / max(frame_ext.shadow_params.x, 512.0); + let ref_z = clamp(ndc.z + 0.0008, 0.0, 1.0); + var sum = textureSampleCompareLevel(shadow_depth, shadow_sampler, shadow_uv, ref_z); + sum += textureSampleCompareLevel(shadow_depth, shadow_sampler, shadow_uv + vec2(texel, 0.0), ref_z); + sum += textureSampleCompareLevel(shadow_depth, shadow_sampler, shadow_uv - vec2(texel, 0.0), ref_z); + sum += textureSampleCompareLevel(shadow_depth, shadow_sampler, shadow_uv + vec2(0.0, texel), ref_z); + sum += textureSampleCompareLevel(shadow_depth, shadow_sampler, shadow_uv - vec2(0.0, texel), ref_z); + let fade = smoothstep(max_dist, max_dist * 0.82, dist); + return mix(1.0, sum * 0.2, fade * frame_ext.shadow_params.w); +} + +// ACES fitted filmic tonemapping curve (linear HDR -> linear 0..1). +fn aces_tonemap(x: vec3) -> vec3 { + let a = 2.51; + let b = 0.03; + let c = 2.43; + let d = 0.59; + let e = 0.14; + return clamp((x * (a * x + b)) / (x * (c * x + d) + e), vec3(0.0), vec3(1.0)); +} diff --git a/crates/horizon-shaderpack/src/options.rs b/crates/horizon-shaderpack/src/options.rs index d25a3d776..3158b12cf 100644 --- a/crates/horizon-shaderpack/src/options.rs +++ b/crates/horizon-shaderpack/src/options.rs @@ -489,11 +489,14 @@ impl OptionValues { out.bools.insert(name.clone(), value); } } + // A saved value the option doesn't list (an old or hand-edited + // file) is dropped, as OptiFine's `ShaderOption.setValue` refuses it. for (name, o) in &options.strings { - if let Some(v) = saved.get(name) { - if *v != o.default { - out.strings.insert(name.clone(), v.clone()); - } + if let Some(v) = saved.get(name) + && *v != o.default + && o.allowed.contains(v) + { + out.strings.insert(name.clone(), v.clone()); } } out @@ -623,6 +626,13 @@ mod tests { !values.bools.contains_key("shadowHardwareFiltering"), "not a boolean: ignored" ); + let stale = [("QUALITY", "abc"), ("sunPathRotation", "")] + .map(|(k, v)| (k.to_owned(), v.to_owned())) + .into(); + assert!( + OptionValues::new(&set, &stale).strings.is_empty(), + "values the options don't list: ignored" + ); let edited: Vec = lines .iter() .enumerate() diff --git a/crates/horizon-shaderpack/src/pipeline.rs b/crates/horizon-shaderpack/src/pipeline.rs index db656e3ae..89898eb07 100644 --- a/crates/horizon-shaderpack/src/pipeline.rs +++ b/crates/horizon-shaderpack/src/pipeline.rs @@ -323,8 +323,6 @@ pub struct Passes { /// next frame starts unflipped. pub flipped_at_end: BTreeSet, pub directives: Directives, - /// Whether the folder uses shadow mapping (`shadow` program or `shadowtex*`). - pub shadow_enabled: bool, } /// The `const` directives of a program folder that aren't about targets @@ -341,24 +339,6 @@ pub struct Directives { pub wetness_half_life: f32, /// `drynessHalflife`, tenths of a second: `wetness` smoothing when dry. pub dryness_half_life: f32, - /// `centerDepthHalflife`, tenths of a second: `centerDepthSmooth`. - pub center_depth_half_life: f32, - /// `shadowMapResolution` (or `SHADOW_RES`), in pixels per side. - pub shadow_map_resolution: u32, - /// `shadowDistance`, in blocks. - pub shadow_distance: f32, - /// `shadowDistanceRenderMul` (-1 when unset). - pub shadow_distance_render_mul: f32, - /// `ambientOcclusionLevel` (0.0..=1.0). - pub ambient_occlusion_level: f32, - /// `noiseTextureResolution`, in pixels per side. - pub noise_texture_resolution: u32, - /// `shadowHardwareFiltering` / `shadowHardwareFiltering0..1`. - pub shadow_hardware_filtering: [bool; 2], - /// `shadowtex0Nearest` / `shadowtex1Nearest`. - pub shadow_nearest: [bool; 2], - /// `generateShadowMipmap` / `shadowtex0Mipmap` / `shadowtex1Mipmap`. - pub shadow_mipmap: [bool; 2], } impl Default for Directives { @@ -368,15 +348,6 @@ impl Default for Directives { eye_brightness_half_life: 10.0, wetness_half_life: 600.0, dryness_half_life: 200.0, - center_depth_half_life: 1.0, - shadow_map_resolution: 2048, - shadow_distance: 128.0, - shadow_distance_render_mul: -1.0, - ambient_occlusion_level: 1.0, - noise_texture_resolution: 256, - shadow_hardware_filtering: [false; 2], - shadow_nearest: [false; 2], - shadow_mipmap: [false; 2], } } } @@ -387,66 +358,13 @@ impl Directives { let mut out = Self::default(); for fragment in fragments { for c in const_directives(fragment) { - let raw = c.value.trim_end_matches(['f', 'F']); - let fval = raw.parse::(); - let ival = raw.parse::(); - let bval = raw.parse::(); - match (c.ty, c.key.as_str()) { - ("float", "sunPathRotation") if fval.is_ok() => { - out.sun_path_rotation = fval.unwrap(); - } - ("float", "eyeBrightnessHalflife") if fval.is_ok() => { - out.eye_brightness_half_life = fval.unwrap(); - } - ("float", "wetnessHalflife") if fval.is_ok() => { - out.wetness_half_life = fval.unwrap(); - } - ("float", "drynessHalflife") if fval.is_ok() => { - out.dryness_half_life = fval.unwrap(); - } - ("float", "centerDepthHalflife") if fval.is_ok() => { - out.center_depth_half_life = fval.unwrap(); - } - ("float", "shadowDistance") if fval.is_ok() => { - out.shadow_distance = fval.unwrap().clamp(8.0, 1024.0); - } - ("float", "shadowDistanceRenderMul") if fval.is_ok() => { - out.shadow_distance_render_mul = fval.unwrap(); - } - ("float", "ambientOcclusionLevel") if fval.is_ok() => { - out.ambient_occlusion_level = fval.unwrap().clamp(0.0, 1.0); - } - ("int", "shadowMapResolution") if ival.is_ok() => { - out.shadow_map_resolution = ival.unwrap().clamp(64, 8192); - } - ("int", "noiseTextureResolution") if ival.is_ok() => { - out.noise_texture_resolution = ival.unwrap().clamp(16, 2048); - } - ("bool", "shadowHardwareFiltering") if bval.is_ok() => { - out.shadow_hardware_filtering = [bval.unwrap(); 2]; - } - ("bool", "shadowHardwareFiltering0") if bval.is_ok() => { - out.shadow_hardware_filtering[0] = bval.unwrap(); - } - ("bool", "shadowHardwareFiltering1") if bval.is_ok() => { - out.shadow_hardware_filtering[1] = bval.unwrap(); - } - ("bool", "shadowtexNearest" | "shadowtex0Nearest" | "shadow0MinMagNearest") - if bval.is_ok() => - { - out.shadow_nearest[0] = bval.unwrap(); - } - ("bool", "shadowtex1Nearest" | "shadow1MinMagNearest") if bval.is_ok() => { - out.shadow_nearest[1] = bval.unwrap(); - } - ("bool", "generateShadowMipmap" | "shadowtexMipmap" | "shadowtex0Mipmap") - if bval.is_ok() => - { - out.shadow_mipmap[0] = bval.unwrap(); - } - ("bool", "shadowtex1Mipmap") if bval.is_ok() => { - out.shadow_mipmap[1] = bval.unwrap(); - } + // Java's `Float.parseFloat` takes a trailing `f`. + let value = c.value.trim_end_matches(['f', 'F']).parse::(); + match (c.ty, c.key.as_str(), value) { + ("float", "sunPathRotation", Ok(v)) => out.sun_path_rotation = v, + ("float", "eyeBrightnessHalflife", Ok(v)) => out.eye_brightness_half_life = v, + ("float", "wetnessHalflife", Ok(v)) => out.wetness_half_life = v, + ("float", "drynessHalflife", Ok(v)) => out.dryness_half_life = v, _ => {} } } @@ -568,19 +486,9 @@ impl JavaPack { for name in &groups[0..2].concat() { fragments.insert(name.clone(), fragment(name)?); } - let shadow_enabled = ["shadow", "shadow_solid", "shadow_cutout"] - .iter() - .any(|s| exists(s)) - || sources.iter().any(|s| { - s.contains("shadowtex0") - || s.contains("shadowtex1") - || s.contains("watershadow") - || s.contains("shadow2D") - }); let mut out = Passes { targets: target_settings(sources.iter().map(String::as_str), properties), directives: Directives::read(sources.iter().map(String::as_str)), - shadow_enabled, ..Passes::default() }; @@ -858,14 +766,14 @@ mod tests { assert_eq!(Directives::read([]), Directives::default()); assert_eq!(Directives::default().eye_brightness_half_life, 10.0); let d = Directives::read([ - "const float sunPathRotation = 30.0;\nconst float eyeBrightnessHalflife = 4.0f;\nconst int shadowMapResolution = 4096;\nconst float shadowDistance = 192.0;", + "const float sunPathRotation = 30.0;\nconst float eyeBrightnessHalflife = 4.0f;\nconst float wetnessHalflife = 300.0;", "const float sunPathRotation = -40.0; // Complementary Unbound", "const int sunPathRotation = 5;", ]); assert_eq!(d.sun_path_rotation, -40.0); assert_eq!(d.eye_brightness_half_life, 4.0); - assert_eq!(d.shadow_map_resolution, 4096); - assert_eq!(d.shadow_distance, 192.0); + assert_eq!(d.wetness_half_life, 300.0); + assert_eq!(d.dryness_half_life, 200.0, "the default"); } #[test] diff --git a/crates/horizon-shaderpack/src/translate.rs b/crates/horizon-shaderpack/src/translate.rs index 623ad760d..27fafe34b 100644 --- a/crates/horizon-shaderpack/src/translate.rs +++ b/crates/horizon-shaderpack/src/translate.rs @@ -806,20 +806,11 @@ impl<'a> Legaliser<'a> { fn unit(&mut self, unit: &mut ast::TranslationUnit) -> Result<(), String> { // Functions, their sampler parameters, and struct definitions first. for ed in &unit.0 { - if let ast::ExternalDeclarationData::Declaration(d) = &ed.content { - match &d.content { - ast::DeclarationData::InitDeclaratorList(list) => { - if let ast::TypeSpecifierNonArrayData::Struct(s) = - &list.head.ty.ty.ty.content - { - self.record_struct(s); - } - } - ast::DeclarationData::TypeOnly(q) => { - let _ = q; - } - _ => {} - } + if let ast::ExternalDeclarationData::Declaration(d) = &ed.content + && let ast::DeclarationData::InitDeclaratorList(list) = &d.content + && let ast::TypeSpecifierNonArrayData::Struct(s) = &list.head.ty.ty.ty.content + { + self.record_struct(s); } let proto = match &ed.content { ast::ExternalDeclarationData::FunctionDefinition(f) => &f.prototype, diff --git a/docs/shader-packs.md b/docs/shader-packs.md index 0ba8981fb..6718be0f7 100644 --- a/docs/shader-packs.md +++ b/docs/shader-packs.md @@ -13,16 +13,18 @@ Both are off by default. With no pack selected the renderer draws exactly what i | Part | State | | --- | --- | | Renderer layout (below) | today's code | -| Horizon shader packs: `composite`, `deferred`, `gbuffer`, `shadow`, `final` stages (API 2), uniforms, custom textures, hot reload | done (`examples/shaderpacks/horizon-ultra` + `horizon-sample`) | -| Shader Packs UI: import (`.zip`/folder dialog + drag-and-drop), profiles, sub-screens, sliders, toggles, reset to defaults | done (Horizon & Classic Video/Graphics settings) | -| Real-time shadow map pass (`"Horizon shadow"`, `shadowtex0/1`, `shadowModelView`, `shadowProjection`) & pre-translucent depth (`depthtex1/2`) | done | -| G-buffer normal & material pass (`"Horizon gbuffer"`, `scene_normal`, `scene_material`, `colortex1..3` initialization) | done | -| Java shader packs: preprocessor (`crates/horizon-shaderpack`: includes, options, Iris's macros, JCPP's `#if` and `#define` rules, `.lang` files) | done: ten packs tested (Compatibility, below) | -| Java shader packs: GLSL → WGSL (`horizon_shaderpack::translate`: syntax-tree legaliser, naga, 2D array & struct varyings, vertex `textureLod`, `mat2(vec4)`, `1 << 31` shifts) | done | -| Java shader packs: `shaders.properties` (`horizon_shaderpack::properties`: screens, sliders, profiles, `program.*.enabled`, image formats, blend modes, custom textures) | done, wired to UI and GPU passes | -| Java shader packs: full-screen pass plan (`horizon_shaderpack::pipeline`: `DRAWBUFFERS`/`RENDERTARGETS`, `colortexN` formats and clearing, buffer flips, blend state) | done | -| Java shader packs: full-screen passes drawn (`java_pack.rs`, `gfx/java_stages.rs`: `begin`, `prepare`, `deferred*`, `composite*`, `final` over Horizon's world) | done: with shadow maps, `depthtex1/2`, custom PNG textures, GL blend modes, `wetness`, `centerDepthSmooth` | -| Java shader packs: custom uniforms (`horizon_shaderpack::uniforms`), `sunPathRotation`, `clouds`/`sun`/`moon`, eye light | done | +| Horizon shader packs: `composite` stage, uniforms, hot reload, Shader Packs page | done (the page: list, pick, open the folder, drop a pack on it) | +| Horizon shader packs, api 2: stage `format`s, `[profiles]`, option descriptions, a `noise` texture, the opaque depth, a G-buffer reconstructed from depth, a sun/moon shadow map (Stages, below) | first slice: `examples/shaderpacks/horizon-ultra` | +| Horizon shader packs: `deferred`, `gbuffer`, `shadow` stages (the pack's own code in the world pass) | planned | +| Shader Pack Settings page: a pack's options, sub-screens, sliders, profiles and Reset, Horizon and Java packs alike; applied once on Done, as Iris does | done | +| Java shader packs: preprocessing + GLSL parse coverage | spike done: 450 of 470 programs reach valid WGSL (below) | +| Java shader packs: preprocessor (`crates/horizon-shaderpack`: includes, options, Iris's macros, JCPP's `#if` and `#define` rules, `.lang` files) | done: every program of the three test packs preprocesses; ten packs tested (Compatibility, below) | +| Java shader packs: GLSL → WGSL (`horizon_shaderpack::translate`: syntax-tree legaliser, naga; struct and nested-array varyings, vertex `texture`, `mat2(vec4)`, `1 << 31`) | done: the 464 programs the three test packs enable by default translate (below) | +| Java shader packs: `shaders.properties` (`horizon_shaderpack::properties`: screens, sliders, profiles, `program.*.enabled`, image formats, blend modes, `texture.*`) | done: read like Iris for the three test packs | +| Java shader packs: full-screen pass plan (`horizon_shaderpack::pipeline`: `DRAWBUFFERS`/`RENDERTARGETS`, `colortexN` formats and clearing, buffer flips, `blend.*`) | done: planned for the three test packs | +| Java shader packs: full-screen passes drawn (`java_pack.rs`, `gfx/java_stages.rs`: `begin`, `prepare`, `deferred*`, `composite*`, `final` over Horizon's world) | first slice: BSL and Complementary run (below); `depthtex1`/`depthtex2` before translucent geometry, `blend.*`, PNG `texture..*` and `texture.noise` | +| Java shader packs: custom uniforms (`horizon_shaderpack::uniforms`), `sunPathRotation`, `clouds`/`sun`/`moon`, eye light, `wetness` | done for the full-screen passes (below) | +| Java shader packs: `gbuffers_*`, `shadow`, `.dat` and resource-location textures, images, compute | planned | ## How the renderer draws a frame today @@ -63,7 +65,14 @@ The lightmap, fog and sky colours are computed on the CPU (`environment.rs`, `fo 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. + second while the page is open, so a pack dropped into the folder shows up. A `.zip` or pack folder dropped on the + window while the page shows is copied into the folder and picked (Iris's `ShaderPackScreen.onFilesDrop`); one of + that name already there is left alone. +- With a pack on that has options, **Shader Pack Settings...** opens them: Horizon packs' `[options]` and + `[profiles]`, Java packs' `#define`/`const` options laid out by `shaders.properties` (`screen`, `screen.`, + `sliders`, `profile.*`) and named by `lang/en_us.lang` (`option.*`, `value.*`, `screen.*`, `profile.*`, as Iris; + without one, the option's own name). The values are saved and the pack built again once, when the page closes + (Iris applies on Done), not on every click or slider step. A saved value an option doesn't list is ignored. - The choice is kept in `horizon-graphics.txt` (`shaderPack:`, empty = off). A pack's option values are kept in `shaderpacks/.txt`, as Iris does. - A pack that fails to load or compile leaves the vanilla picture (or the last pack that worked) on and says why on @@ -79,7 +88,7 @@ my-pack/ composite.wgsl bloom.wgsl textures/ - noise.png # planned + noise.png # api 2: [textures] noise LICENSE ``` @@ -112,6 +121,24 @@ step = 0.05 [options.vignette] label = "Vignette" default = true +description = "Darkens the corners." # optional: the button's tooltip +``` + +Api 2 (`api = 2`) adds: + +```toml +[[stage]] +kind = "composite" +shader = "shaders/lighting.wgsl" +format = "rgba16float" # this stage's target: rgba8unorm, rgba16float or rgb10a2unorm; the last stage + # always writes the screen's format, so earlier ones can keep HDR colour + +[profiles.low] # the Profile button cycles these; "Custom" when the values match none +vignette = false +saturation = 1.0 + +[textures] +noise = "textures/noise.png" # replaces the prelude's noise_texture (256x256 random RGB without it) ``` Options become WGSL [pipeline-overridable constants](https://www.w3.org/TR/WGSL/#override-decls): the shader @@ -176,6 +203,29 @@ Prelude helpers: `linear_depth(depth) -> f32` (blocks from the eye), `view_posit The uniform layout only grows: a new field goes at the end and the `api` number goes up; a pack that declares an older `api` still loads. +An `api = 2` pack's stages get a second prelude after the first (`shader_pack_prelude_api2.wgsl`; api 1 packs don't, +so names they declare themselves can't clash): + +| Binding | WGSL | What | +| --- | --- | --- | +| 6 | `frame_ext: FrameExt` (uniform) | last frame's view and projection and camera, the shadow map's matrices, resolution and distance, eye light, smoothed rain | +| 7, 8 | `scene_normal`, `scene_material: texture_2d` | the G-buffer (below) | +| 9 | `opaque_depth: texture_depth_2d` | the world's depth before translucent geometry (water, glass, ice) | +| 10, 11 | `shadow_depth: texture_depth_2d`, `shadow_sampler: sampler_comparison` | the sun's (the moon's at night) shadow map | +| 12, 13 | `noise_texture: texture_2d`, `repeat_sampler: sampler` | `[textures] noise`, linear, repeat | + +Helpers: `opaque_depth_at(uv)`, `world_normal_at(uv)`, `material_at(uv)` (block light, sky light, translucent mask, +roughness), `reproject_uv(world_offset)` (last frame's uv and depth), `sample_shadow(world_offset, normal)` (5-tap +PCF, 1 lit .. 0 shadowed), `aces_tonemap(rgb)`. + +What each costs, only while a stage reads it (naga reports the bindings each entry point uses): the opaque depth, a +depth copy between the opaque and translucent halves of the world pass; the G-buffer, one full-screen pass after +the world; the shadow map, a depth pass of the terrain and entities from the light. Limits of this first slice: the +G-buffer is reconstructed from depth and colour (normals from neighbouring depths, block light estimated from +brightness, sky light the camera's), not written by the world's shaders; the shadow map holds the sections the +camera draws, so casters outside the view throw no shadow, and none of the terrain where Metal draws sections as one +list (`gfx/flat.rs`, more than 4096 of them). The `deferred`, `gbuffer` and `shadow` stages above replace these. + ### How it renders With a pack on, the world pass draws into the world target of `gfx/world_post.rs` (it exists already for resolution diff --git a/examples/shaderpacks/horizon-ultra/pack.toml b/examples/shaderpacks/horizon-ultra/pack.toml index 446115073..9a59eec90 100644 --- a/examples/shaderpacks/horizon-ultra/pack.toml +++ b/examples/shaderpacks/horizon-ultra/pack.toml @@ -1,15 +1,15 @@ # Horizon Ultra: multi-pass API 2 WGSL shader pack with PCF directional shadows, -# G-buffer GTAO, water SSR & absorption, volumetric godrays, HDR bloom and ACES tonemapping. +# screen-space AO, water SSR & absorption, screen-space godrays, HDR bloom and ACES tonemapping. [pack] name = "Horizon Ultra" -description = "PCF sun/moon shadows, GTAO, water reflections, volumetric godrays, bloom and ACES filmic tonemapping." +description = "PCF sun/moon shadows, ambient occlusion, water reflections, godrays, bloom and ACES filmic tonemapping." authors = ["Horizon contributors"] version = "2.0.0" license = "MIT" api = 2 [[stage]] -kind = "deferred" +kind = "composite" shader = "shaders/deferred_lighting.wgsl" format = "rgba16float" @@ -23,10 +23,9 @@ kind = "composite" shader = "shaders/bloom_godrays.wgsl" scale = 0.5 format = "rgba16float" -mipmap = true [[stage]] -kind = "final" +kind = "composite" shader = "shaders/final_tonemap.wgsl" [profiles.low] @@ -82,8 +81,8 @@ max = 1.0 step = 0.05 [options.ao_strength] -label = "Ambient Occlusion (GTAO)" -description = "Screen-space horizon ambient occlusion in corners and crevices." +label = "Ambient Occlusion" +description = "Screen-space ambient occlusion in corners and crevices." default = 0.75 min = 0.0 max = 1.5 @@ -95,7 +94,7 @@ description = "Screen-space sky and terrain reflections on water and translucent default = true [options.godrays] -label = "Volumetric Godrays" +label = "Godrays" description = "Atmospheric light shafts cast through trees and terrain towards the sun." default = true diff --git a/examples/shaderpacks/horizon-ultra/shaders/bloom_godrays.wgsl b/examples/shaderpacks/horizon-ultra/shaders/bloom_godrays.wgsl index 534e9d983..d175eab6c 100644 --- a/examples/shaderpacks/horizon-ultra/shaders/bloom_godrays.wgsl +++ b/examples/shaderpacks/horizon-ultra/shaders/bloom_godrays.wgsl @@ -1,5 +1,5 @@ // Stage 3 (Composite, half-resolution): HDR bloom extraction + 9-tap tent filter -// and radial volumetric light shafts (godrays) towards the sun/moon. +// and radial light shafts (screen-space godrays) towards the sun/moon. override godrays: bool = true; override bloom_strength: f32 = 0.35; @@ -30,7 +30,7 @@ override bloom_strength: f32 = 0.35; } } - // Radial volumetric godrays cast from the sun's screen projection. + // Radial godrays from the sun's screen projection. var shafts = vec3(0.0); if godrays && frame.camera_state.x == 0.0 && frame.dimension.y > 0.5 { let sun_clip = frame.projection * (frame.view * vec4(frame.sun.xyz * 128.0, 1.0)); diff --git a/examples/shaderpacks/horizon-ultra/shaders/deferred_lighting.wgsl b/examples/shaderpacks/horizon-ultra/shaders/deferred_lighting.wgsl index 3930a5c21..e44773f37 100644 --- a/examples/shaderpacks/horizon-ultra/shaders/deferred_lighting.wgsl +++ b/examples/shaderpacks/horizon-ultra/shaders/deferred_lighting.wgsl @@ -1,10 +1,10 @@ -// Stage 1 (Deferred): G-buffer normal reconstruction, multi-tap GTAO ambient +// Stage 1: G-buffer normals, 8-tap screen-space ambient // occlusion, directional sun/moon PCF shadow mapping, and rain puddle wetness. override shadows: bool = true; override shadow_strength: f32 = 0.85; override ao_strength: f32 = 0.75; -fn compute_gtao(uv: vec2, depth: f32, view_pos: vec3) -> f32 { +fn compute_ao(uv: vec2, depth: f32, view_pos: vec3) -> f32 { if ao_strength <= 0.001 { return 1.0; } @@ -60,7 +60,7 @@ fn compute_gtao(uv: vec2, depth: f32, view_pos: vec3) -> f32 { let mat = material_at(in.uv); // Ambient occlusion from depth discontinuity neighborhood. - let ao = compute_gtao(in.uv, depth, view_pos); + let ao = compute_ao(in.uv, depth, view_pos); // Directional sun/moon shadow factor. var shadow = 1.0; From fe7bb3a34b54da4792b6f9b201a6e2eb2bd4c9ca Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 14:02:12 +0200 Subject: [PATCH 118/126] Java packs: the world goes where the pack's terrain program draws MakeUp's gbuffers write colortex1, and its composites read the world from there: with the world in colortex0, it showed nothing but fog. Iris's fallbacks for terrain pick the program (gbuffers_terrain, then textured_lit, textured, basic); its first draw buffer takes the world. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/gfx/java_stages.rs | 29 ++++++++++------ crates/horizon-client/src/java_pack.rs | 6 +++- crates/horizon-shaderpack/src/pipeline.rs | 18 ++++++++++ crates/horizon-shaderpack/tests/pack.rs | 36 ++++++++++++++++++++ 4 files changed, 77 insertions(+), 12 deletions(-) diff --git a/crates/horizon-client/src/gfx/java_stages.rs b/crates/horizon-client/src/gfx/java_stages.rs index f86055919..5079a8f03 100644 --- a/crates/horizon-client/src/gfx/java_stages.rs +++ b/crates/horizon-client/src/gfx/java_stages.rs @@ -2,7 +2,8 @@ //! Iris's colour targets (`colortex0..`, each with a main and an alternate //! side) and the pack's `begin`, `prepare`, `deferred`, `composite` and //! `final` programs as full-screen passes over them, as Iris's -//! `CompositeRenderer` runs them. Horizon's world enters `colortex0` and +//! `CompositeRenderer` runs them. Horizon's world enters the target the +//! pack's terrain program draws to (`colortex0` for most packs) and //! `depthtex0` after `prepare`, where Iris's gbuffers programs would have //! drawn (`depthtex1`/`depthtex2`: its depth before translucent geometry), //! and the last picture goes to `world_post`. The @@ -249,7 +250,8 @@ struct Bound { /// Per pass, then `final`. groups: Vec, world_in: (wgpu::RenderPipeline, wgpu::BindGroup), - /// The world goes to colortex0's alternate side. + /// The world's target, and whether the world goes to its alternate side. + world_target: u32, world_alt: bool, final_target: Option, present: (wgpu::RenderPipeline, wgpu::BindGroup), @@ -262,6 +264,7 @@ struct Bound { struct Folder { targets: Vec, world_at: usize, + world_target: u32, flipped_after_prepare: BTreeSet, flipped_at_end: BTreeSet, passes: Vec, @@ -326,6 +329,7 @@ impl JavaStages { Ok::<_, String>(Folder { targets: plan.targets.clone(), world_at: plan.world_at, + world_target: plan.world_target, flipped_after_prepare: plan.flipped_after_prepare.clone(), flipped_at_end: plan.flipped_at_end.clone(), passes, @@ -486,8 +490,9 @@ impl JavaStages { let folder = &self.folders[folder_index]; let plan = folder; let all = folder.passes.iter().chain(&folder.final_pass); - // Every target a pass reads or writes, and colortex0 (the world). - let mut used: BTreeSet = [0].into(); + // Every target a pass reads or writes, colortex0 (shown without + // `final`) and the world's. + let mut used: BTreeSet = [0, folder.world_target].into(); for pass in all.clone() { used.extend(pass.draw_buffers.iter().copied()); used.extend(pass.samplers.iter().filter_map(|s| match s.source { @@ -588,15 +593,15 @@ impl JavaStages { }) .collect(); - // The world goes into colortex0's side the gbuffers would write. - let colortex0 = &targets[&0]; + // The world goes into its target's side the gbuffers would write. + let world_target = &targets[&folder.world_target]; let world_pipeline = blit_pipeline( device, &self.common, &self.common.world_layout, "world_in", &[ - colortex0.format, + world_target.format, wgpu::TextureFormat::R32Float, wgpu::TextureFormat::R32Float, ], @@ -630,6 +635,7 @@ impl JavaStages { .create_view(&Default::default()) }); // Without `final`, Iris shows colortex0 as the last pass left it. + let colortex0 = &targets[&0]; let shown = final_target.clone().unwrap_or_else(|| { if plan.flipped_at_end.contains(&0) { colortex0.alt_view.clone() @@ -668,7 +674,8 @@ impl JavaStages { opaque_depth, groups, world_in: (world_pipeline, world_group), - world_alt: plan.flipped_after_prepare.contains(&0), + world_target: folder.world_target, + world_alt: plan.flipped_after_prepare.contains(&folder.world_target), final_target, present: (present_pipeline, present_group), output_view, @@ -679,11 +686,11 @@ impl JavaStages { } fn world_in(encoder: &mut wgpu::CommandEncoder, bound: &Bound) { - let colortex0 = &bound.targets[&0]; + let target = &bound.targets[&bound.world_target]; let side = if bound.world_alt { - &colortex0.alt_view + &target.alt_view } else { - &colortex0.main_view + &target.main_view }; let attachments = [ Some(color_attachment(side, None)), diff --git a/crates/horizon-client/src/java_pack.rs b/crates/horizon-client/src/java_pack.rs index 5e592d1b6..ee4d29d61 100644 --- a/crates/horizon-client/src/java_pack.rs +++ b/crates/horizon-client/src/java_pack.rs @@ -23,8 +23,11 @@ pub struct JavaFolder { /// `begin*`, `prepare*`, `deferred*`, `composite*`, in order. pub passes: Vec, /// How many of `passes` run before the world (`begin*`, `prepare*`): the - /// world's colour and depth enter `colortex0` and `depthtex*` after them. + /// world's colour and depth enter `world_target` and `depthtex*` after them. pub world_at: usize, + /// The colour target the world goes into, where the pack's terrain + /// program draws (MakeUp: colortex1). + pub world_target: u32, /// The targets whose alternate side the world is written to. pub flipped_after_prepare: BTreeSet, pub final_pass: Option, @@ -145,6 +148,7 @@ pub fn load( folder: name.to_owned(), targets: plan.targets, world_at: early.count(), + world_target: plan.world_target, passes, flipped_after_prepare: plan.flipped_after_prepare, final_pass, diff --git a/crates/horizon-shaderpack/src/pipeline.rs b/crates/horizon-shaderpack/src/pipeline.rs index 89898eb07..d851fc23a 100644 --- a/crates/horizon-shaderpack/src/pipeline.rs +++ b/crates/horizon-shaderpack/src/pipeline.rs @@ -313,6 +313,10 @@ pub struct Passes { /// The targets gbuffers programs (and Horizon's world) write on their /// alternate side, before and after translucent geometry. pub flipped_after_prepare: BTreeSet, + /// The target Horizon's world goes into: the first one `gbuffers_terrain` + /// (or the program Iris falls back to for terrain) draws to, `colortex0` + /// without one. + pub world_target: u32, pub deferred: Vec, pub flipped_after_translucent: BTreeSet, pub composite: Vec, @@ -532,6 +536,20 @@ impl JavaPack { out.begin = run(&groups[0], "begin_pre", &mut flipped)?; out.prepare = run(&groups[1], "prepare_pre", &mut flipped)?; out.flipped_after_prepare = flipped.clone(); + // Iris's fallbacks for terrain (`ProgramFallbackResolver`). + let terrain = [ + "gbuffers_terrain", + "gbuffers_textured_lit", + "gbuffers_textured", + "gbuffers_basic", + ] + .into_iter() + .find(|name| exists(name)); + if let Some(name) = terrain { + let buffers = + draw_buffers(&fragment(name)?).map_err(|e| format!("{}: {e}", path(name)))?; + out.world_target = buffers.and_then(|b| b.first().copied()).unwrap_or(0); + } out.deferred = run(&groups[2], "deferred_pre", &mut flipped)?; out.flipped_after_translucent = flipped.clone(); out.composite = run(&groups[3], "composite_pre", &mut flipped)?; diff --git a/crates/horizon-shaderpack/tests/pack.rs b/crates/horizon-shaderpack/tests/pack.rs index c957d7fb4..1e2ee8158 100644 --- a/crates/horizon-shaderpack/tests/pack.rs +++ b/crates/horizon-shaderpack/tests/pack.rs @@ -292,6 +292,8 @@ fn plans_the_full_screen_passes() { assert_eq!(passes.composite[0].mipmapped, [3].into()); assert_eq!(passes.composite[1].scale, 0.5); assert_eq!(passes.flipped_after_prepare, [].into()); + // No gbuffers programs: the world goes into colortex0. + assert_eq!(passes.world_target, 0); assert_eq!(passes.flipped_after_translucent, [3].into()); assert_eq!(passes.flipped_at_end, [1, 2, 3].into()); let final_pass = passes.final_pass.unwrap(); @@ -302,6 +304,40 @@ fn plans_the_full_screen_passes() { assert_eq!(final_pass.reads_alt, [1, 2, 3].into()); } +/// The world enters the target terrain draws to first (MakeUp's colortex1), +/// through Iris's fallbacks when `gbuffers_terrain` is missing or disabled. +#[test] +fn the_world_goes_where_terrain_draws() { + let dir = scratch("world-target"); + let shaders = dir.join("shaders"); + std::fs::create_dir_all(&shaders).unwrap(); + let write = |name: &str, text: &str| std::fs::write(shaders.join(name), text).unwrap(); + for program in ["composite", "gbuffers_terrain", "gbuffers_textured"] { + write(&format!("{program}.vsh"), "void main() {}\n"); + } + write("composite.fsh", "void main() {}\n"); + write( + "gbuffers_textured.fsh", + "void main() {\n/* DRAWBUFFERS:12 */\n gl_FragData[0] = vec4(1.0);\n}\n", + ); + write( + "gbuffers_terrain.fsh", + "void main() {\n#ifdef GRASS\n/* DRAWBUFFERS:42 */\n#else\n/* DRAWBUFFERS:3 */\n#endif\n gl_FragData[0] = vec4(1.0);\n}\n", + ); + let target = |properties: &str| { + write("shaders.properties", properties); + let pack = JavaPack::open(&dir).unwrap(); + let values = pack.values(&BTreeMap::new()); + let properties = pack.properties(&values, &env()).unwrap(); + pack.passes("", &values, &env(), &properties) + .unwrap() + .world_target + }; + assert_eq!(target(""), 3); + assert_eq!(target("program.gbuffers_terrain.enabled = false\n"), 1); + std::fs::remove_dir_all(dir).unwrap(); +} + fn scratch(name: &str) -> PathBuf { std::env::temp_dir().join(format!("horizon-shaderpack-{name}-{}", std::process::id())) } From 963d5cedd3671d1c04569b89d98940cd7d9187f9 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 14:02:12 +0200 Subject: [PATCH 119/126] Shader packs: keep the opaque depth and G-buffer only for packs that read them The world target made the opaque depth, normal and material textures for every scaled or anti-aliased frame, packs or not: 12 bytes a pixel nobody read. They now follow what the pack reads, and Post::generation tells the stages to bind again when its targets change (a recreated target of the same size, or a shadow map made after the stages bound). Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/gfx.rs | 12 +- crates/horizon-client/src/gfx/java_stages.rs | 11 +- crates/horizon-client/src/gfx/pack_stages.rs | 10 +- crates/horizon-client/src/gfx/world_post.rs | 199 +++++++++++-------- 4 files changed, 140 insertions(+), 92 deletions(-) diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 255f4dd0a..6a154d0de 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -3707,9 +3707,15 @@ impl Renderer { } else { self.world_post.shadow_active = false; } - let scaled = - self.world_post - .prepare(&self.device, [self.config.width, self.config.height], pack); + let scaled = self.world_post.prepare( + &self.device, + [self.config.width, self.config.height], + pack, + world_post::Extras { + opaque_depth, + gbuffer, + }, + ); let (world_view, world_depth) = match &scaled { Some((color, depth)) => (color, depth), None => (&view_target, &self.depth), diff --git a/crates/horizon-client/src/gfx/java_stages.rs b/crates/horizon-client/src/gfx/java_stages.rs index 5079a8f03..14d25745e 100644 --- a/crates/horizon-client/src/gfx/java_stages.rs +++ b/crates/horizon-client/src/gfx/java_stages.rs @@ -244,6 +244,8 @@ struct Common { struct Bound { folder: usize, size: [u32; 2], + /// `world_post`'s targets it binds (`Post::generation`). + post_generation: u64, targets: BTreeMap, depth: wgpu::TextureView, opaque_depth: wgpu::TextureView, @@ -382,11 +384,9 @@ impl JavaStages { ) -> &wgpu::BindGroup { let dimension = (frame.dimension[0] as i32).clamp(-1, 1); let folder = self.folder_for[(dimension + 1) as usize].unwrap_or(0); - if self - .bound - .as_ref() - .is_none_or(|b| b.folder != folder || b.size != size) - { + if self.bound.as_ref().is_none_or(|b| { + b.folder != folder || b.size != size || b.post_generation != post.generation() + }) { self.bound = Some(self.bind(device, queue, folder, color, depth, size, post)); } let now = std::time::Instant::now(); @@ -669,6 +669,7 @@ impl JavaStages { Bound { folder: folder_index, size, + post_generation: post.generation(), targets, depth, opaque_depth, diff --git a/crates/horizon-client/src/gfx/pack_stages.rs b/crates/horizon-client/src/gfx/pack_stages.rs index f80a64ce1..a067812e8 100644 --- a/crates/horizon-client/src/gfx/pack_stages.rs +++ b/crates/horizon-client/src/gfx/pack_stages.rs @@ -129,12 +129,12 @@ pub struct PackStages { shadow_sampler: wgpu::Sampler, noise_view: wgpu::TextureView, passes: Vec, - /// Built for this world target size. + /// Built for this world target size and `world_post` generation. targets: Vec, /// `world_post`'s bindings of the last stage's output. output: Option, world_size: [u32; 2], - shadow_size: u32, + post_generation: u64, started: std::time::Instant, last: Option, frames: u32, @@ -330,7 +330,7 @@ impl PackStages { targets: Vec::new(), output: None, world_size: [0, 0], - shadow_size: 0, + post_generation: u64::MAX, started: std::time::Instant::now(), last: None, frames: 0, @@ -355,11 +355,11 @@ impl PackStages { eye_light: [u8; 2], ) -> &wgpu::BindGroup { if self.world_size != size - || self.shadow_size != post.shadow_resolution + || self.post_generation != post.generation() || self.targets.len() != self.passes.len() { self.world_size = size; - self.shadow_size = post.shadow_resolution; + self.post_generation = post.generation(); self.targets.clear(); for pass in &self.passes { let target_size = size.map(|v| ((v as f32 * pass.scale).round() as u32).max(1)); diff --git a/crates/horizon-client/src/gfx/world_post.rs b/crates/horizon-client/src/gfx/world_post.rs index f592e8a1f..cb3e4b41c 100644 --- a/crates/horizon-client/src/gfx/world_post.rs +++ b/crates/horizon-client/src/gfx/world_post.rs @@ -102,20 +102,33 @@ struct GbufferUniform { env: [f32; 4], } +/// What the frame's shader pack reads beyond the world's colour and depth: +/// `Post` keeps these targets only while one does. +#[derive(Clone, Copy, Debug, Default, PartialEq, Eq)] +pub struct Extras { + pub opaque_depth: bool, + pub gbuffer: bool, +} + struct WorldTarget { size: [u32; 2], + extras: Extras, color: wgpu::TextureView, depth_tex: wgpu::Texture, depth: wgpu::TextureView, - opaque_depth_tex: wgpu::Texture, - opaque_depth: wgpu::TextureView, - normal: wgpu::TextureView, - material: wgpu::TextureView, - gbuffer_group: wgpu::BindGroup, + /// With `extras.opaque_depth` or `extras.gbuffer` (which reads it). + opaque_depth: Option<(wgpu::Texture, wgpu::TextureView)>, + gbuffer: Option, group: wgpu::BindGroup, opaque_captured: bool, } +struct Gbuffer { + normal: wgpu::TextureView, + material: wgpu::TextureView, + group: wgpu::BindGroup, +} + struct ShadowTarget { resolution: u32, depth: wgpu::TextureView, @@ -136,6 +149,8 @@ pub struct Post { pub antialias: bool, target: Option, shadow: Option, + /// Bumped whenever a target is made: bindings of the old ones are stale. + generation: u64, fallback_shadow: wgpu::TextureView, fallback_color: wgpu::TextureView, pub shadow_view: Mat4, @@ -363,6 +378,7 @@ impl Post { antialias: false, target: None, shadow: None, + generation: 0, fallback_shadow, fallback_color, shadow_view: Mat4::IDENTITY, @@ -374,12 +390,14 @@ impl Post { } /// The world's colour and depth targets this frame, or `None` to draw - /// it straight to the screen. `pack`: a shader pack runs this frame. + /// it straight to the screen. `pack`: a shader pack runs this frame, + /// reading `extras`. pub fn prepare( &mut self, device: &wgpu::Device, window: [u32; 2], pack: bool, + extras: Extras, ) -> Option<(wgpu::TextureView, wgpu::TextureView)> { if self.scale == 1.0 && !self.antialias && !pack { self.target = None; @@ -387,7 +405,12 @@ impl Post { return None; } let size = window.map(|v| ((v as f32 * self.scale).round() as u32).clamp(1, 8192)); - if self.target.as_ref().is_none_or(|t| t.size != size) { + if self + .target + .as_ref() + .is_none_or(|t| t.size != size || t.extras != extras) + { + self.generation += 1; let extent = wgpu::Extent3d { width: size[0], height: size[1], @@ -419,63 +442,69 @@ impl Post { | wgpu::TextureUsages::COPY_SRC, ); let depth = depth_tex.create_view(&Default::default()); - let opaque_depth_tex = make_tex( - "Opaque world depth", - wgpu::TextureFormat::Depth32Float, - wgpu::TextureUsages::RENDER_ATTACHMENT - | wgpu::TextureUsages::TEXTURE_BINDING - | wgpu::TextureUsages::COPY_DST, - ); - let opaque_depth = opaque_depth_tex.create_view(&Default::default()); - let normal = make_tex( - "World G-buffer normal", - wgpu::TextureFormat::Rgba8Unorm, - wgpu::TextureUsages::RENDER_ATTACHMENT | wgpu::TextureUsages::TEXTURE_BINDING, - ) - .create_view(&Default::default()); - let material = make_tex( - "World G-buffer material", - wgpu::TextureFormat::Rgba8Unorm, - wgpu::TextureUsages::RENDER_ATTACHMENT | wgpu::TextureUsages::TEXTURE_BINDING, - ) - .create_view(&Default::default()); - let gbuffer_group = device.create_bind_group(&wgpu::BindGroupDescriptor { - label: Some("Horizon gbuffer"), - layout: &self.gbuffer_layout, - entries: &[ - wgpu::BindGroupEntry { - binding: 0, - resource: wgpu::BindingResource::TextureView(&color), - }, - wgpu::BindGroupEntry { - binding: 1, - resource: wgpu::BindingResource::TextureView(&depth), - }, - wgpu::BindGroupEntry { - binding: 2, - resource: wgpu::BindingResource::TextureView(&opaque_depth), - }, - wgpu::BindGroupEntry { - binding: 3, - resource: wgpu::BindingResource::Sampler(&self.nearest), - }, - wgpu::BindGroupEntry { - binding: 4, - resource: self.gbuffer_uniform.as_entire_binding(), - }, - ], + let opaque_depth = (extras.opaque_depth || extras.gbuffer).then(|| { + let tex = make_tex( + "Opaque world depth", + wgpu::TextureFormat::Depth32Float, + wgpu::TextureUsages::TEXTURE_BINDING | wgpu::TextureUsages::COPY_DST, + ); + let view = tex.create_view(&Default::default()); + (tex, view) }); + let gbuffer = opaque_depth + .as_ref() + .filter(|_| extras.gbuffer) + .map(|(_, opaque)| { + let color_target = |label| { + make_tex( + label, + wgpu::TextureFormat::Rgba8Unorm, + wgpu::TextureUsages::RENDER_ATTACHMENT + | wgpu::TextureUsages::TEXTURE_BINDING, + ) + .create_view(&Default::default()) + }; + let group = device.create_bind_group(&wgpu::BindGroupDescriptor { + label: Some("Horizon gbuffer"), + layout: &self.gbuffer_layout, + entries: &[ + wgpu::BindGroupEntry { + binding: 0, + resource: wgpu::BindingResource::TextureView(&color), + }, + wgpu::BindGroupEntry { + binding: 1, + resource: wgpu::BindingResource::TextureView(&depth), + }, + wgpu::BindGroupEntry { + binding: 2, + resource: wgpu::BindingResource::TextureView(opaque), + }, + wgpu::BindGroupEntry { + binding: 3, + resource: wgpu::BindingResource::Sampler(&self.nearest), + }, + wgpu::BindGroupEntry { + binding: 4, + resource: self.gbuffer_uniform.as_entire_binding(), + }, + ], + }); + Gbuffer { + normal: color_target("World G-buffer normal"), + material: color_target("World G-buffer material"), + group, + } + }); let group = self.bind(device, &color); self.target = Some(WorldTarget { size, + extras, color, depth_tex, depth, - opaque_depth_tex, opaque_depth, - normal, - material, - gbuffer_group, + gbuffer, group, opaque_captured: false, }); @@ -523,6 +552,7 @@ impl Post { }) .create_view(&Default::default()); self.shadow = Some(ShadowTarget { resolution, depth }); + self.generation += 1; } let light_dir = if sun_dir.y >= -0.05 { sun_dir.normalize_or_zero() @@ -557,16 +587,19 @@ impl Post { /// right before translucent water and weather draw. pub fn capture_opaque_depth(&mut self, encoder: &mut wgpu::CommandEncoder) { let Some(t) = &mut self.target else { return }; + let Some((opaque, _)) = &t.opaque_depth else { + return; + }; encoder.copy_texture_to_texture( t.depth_tex.as_image_copy(), - t.opaque_depth_tex.as_image_copy(), + opaque.as_image_copy(), t.depth_tex.size(), ); t.opaque_captured = true; } /// Reconstruct the G-buffer `normal` and `material` textures after the - /// world pass finishes. + /// world pass finishes (with `Extras::gbuffer`). pub fn build_gbuffer( &mut self, queue: &wgpu::Queue, @@ -575,15 +608,11 @@ impl Post { eye_light: [u8; 2], wetness: f32, ) { - let Some(t) = &mut self.target else { return }; - if !t.opaque_captured { - encoder.copy_texture_to_texture( - t.depth_tex.as_image_copy(), - t.opaque_depth_tex.as_image_copy(), - t.depth_tex.size(), - ); - t.opaque_captured = true; + if !self.target.as_ref().is_some_and(|t| t.opaque_captured) { + self.capture_opaque_depth(encoder); } + let Some(t) = &self.target else { return }; + let Some(gbuffer) = &t.gbuffer else { return }; let [w, h] = t.size.map(|v| v.max(1) as f32); let uniform = GbufferUniform { inverse_view: frame.inverse_view, @@ -599,7 +628,7 @@ impl Post { queue.write_buffer(&self.gbuffer_uniform, 0, bytemuck::bytes_of(&uniform)); let attachments = [ Some(wgpu::RenderPassColorAttachment { - view: &t.normal, + view: &gbuffer.normal, resolve_target: None, depth_slice: None, ops: wgpu::Operations { @@ -608,7 +637,7 @@ impl Post { }, }), Some(wgpu::RenderPassColorAttachment { - view: &t.material, + view: &gbuffer.material, resolve_target: None, depth_slice: None, ops: wgpu::Operations { @@ -623,7 +652,7 @@ impl Post { ..Default::default() }); pass.set_pipeline(&self.gbuffer_pipeline); - pass.set_bind_group(0, &t.gbuffer_group, &[]); + pass.set_bind_group(0, &gbuffer.group, &[]); pass.draw(0..3, 0..1); } @@ -632,25 +661,37 @@ impl Post { self.target.as_ref().map(|t| t.size) } - /// The depth before translucent geometry (`capture_opaque_depth`). + /// Changes whenever `prepare` or `prepare_shadow` makes new targets: + /// bindings made from the views below must be made again. + pub fn generation(&self) -> u64 { + self.generation + } + + /// The depth before translucent geometry (`capture_opaque_depth`), or + /// the world's depth when nothing reads it. pub fn opaque_depth(&self) -> &wgpu::TextureView { - self.target - .as_ref() - .map_or(&self.fallback_shadow, |t| &t.opaque_depth) + match &self.target { + Some(WorldTarget { + opaque_depth: Some((_, view)), + .. + }) => view, + Some(t) => &t.depth, + None => &self.fallback_shadow, + } } /// Reconstructed world-space normals (`scene_normal`). pub fn normal(&self) -> &wgpu::TextureView { - self.target - .as_ref() - .map_or(&self.fallback_color, |t| &t.normal) + self.gbuffer().map_or(&self.fallback_color, |g| &g.normal) } /// Reconstructed material and light (`scene_material`). pub fn material(&self) -> &wgpu::TextureView { - self.target - .as_ref() - .map_or(&self.fallback_color, |t| &t.material) + self.gbuffer().map_or(&self.fallback_color, |g| &g.material) + } + + fn gbuffer(&self) -> Option<&Gbuffer> { + self.target.as_ref()?.gbuffer.as_ref() } /// The sun/moon shadow map (`shadow_depth` of api 2 packs). From 39ae54379601b12984c302462cf437ada48db790 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 14:02:12 +0200 Subject: [PATCH 120/126] Shader packs: test importing zips and folders, and refusing what isn't a pack Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/shader_pack.rs | 57 ++++++++++++++++++++++++ 1 file changed, 57 insertions(+) diff --git a/crates/horizon-client/src/shader_pack.rs b/crates/horizon-client/src/shader_pack.rs index d00384748..b1be9d3ea 100644 --- a/crates/horizon-client/src/shader_pack.rs +++ b/crates/horizon-client/src/shader_pack.rs @@ -1428,4 +1428,61 @@ override mode: i32 = 1; assert_eq!(values["invert"], "true"); assert!(load_values(&dir, "other").is_empty()); } + + /// Dropping a pack on the Shader Packs page: zips and folders, Java + /// and Horizon, and the things that aren't packs. + #[test] + fn imports_zips_and_folders_and_refuses_the_rest() { + let shaderpacks = scratch(); + let java = pack(&[("shaders/composite.fsh", "void main() {}\n")]); + let zip_path = scratch().join("Java Pack.zip"); + let mut zip = zip::ZipWriter::new(fs::File::create(&zip_path).unwrap()); + zip.start_file( + "Java Pack/shaders/final.fsh", + zip::write::SimpleFileOptions::default(), + ) + .unwrap(); + std::io::Write::write_all(&mut zip, b"void main() {}\n").unwrap(); + zip.finish().unwrap(); + + assert_eq!( + import_pack(&zip_path, &shaderpacks).unwrap(), + "Java Pack.zip" + ); + assert!(shaderpacks.join("Java Pack.zip").is_file()); + let folder = import_pack(&java, &shaderpacks).unwrap(); + assert!( + shaderpacks + .join(&folder) + .join("shaders/composite.fsh") + .is_file() + ); + // One already there is refused; one dropped from shaderpacks/ itself + // is just picked. + let again = import_pack(&zip_path, &shaderpacks).unwrap_err(); + assert!(again.contains("already"), "{again}"); + assert_eq!( + import_pack(&shaderpacks.join("Java Pack.zip"), &shaderpacks).unwrap(), + "Java Pack.zip" + ); + + let not_a_pack = pack(&[("readme.txt", "hello")]); + assert!( + import_pack(¬_a_pack, &shaderpacks) + .unwrap_err() + .contains("not a shader pack") + ); + let fake_zip = scratch().join("broken.zip"); + fs::write(&fake_zip, "not a zip").unwrap(); + assert!(import_pack(&fake_zip, &shaderpacks).is_err()); + let broken_horizon = pack(&[("pack.toml", "name = ")]); + assert!(import_pack(&broken_horizon, &shaderpacks).is_err()); + assert!(import_pack(&shaderpacks.join("missing"), &shaderpacks).is_err()); + let left: Vec<_> = fs::read_dir(&shaderpacks) + .unwrap() + .flatten() + .map(|e| e.file_name()) + .collect(); + assert_eq!(left.len(), 2, "nothing copied for refused packs: {left:?}"); + } } From fe3a3af5684f7afdb763d1c1f9f66dcc24bc68e0 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 14:16:51 +0200 Subject: [PATCH 121/126] Shader Packs page: the pack's settings button sits beside the folder button As in Iris's ShaderPackScreen: at the end of the list it scrolled out of sight with a few packs. It's greyed out while the picked pack has no options. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/options_ui.rs | 56 +++++++++++++++---------- 1 file changed, 35 insertions(+), 21 deletions(-) diff --git a/crates/horizon-client/src/options_ui.rs b/crates/horizon-client/src/options_ui.rs index 1bb9953bf..66ceb93e1 100644 --- a/crates/horizon-client/src/options_ui.rs +++ b/crates/horizon-client/src/options_ui.rs @@ -1236,6 +1236,14 @@ impl OptionsUi { self.shader_pack_config = Some(config); self.shader_pack_edited = false; } + /// The picked pack has options or profiles to show. + fn shader_pack_has_settings(&self, s: &Settings) -> bool { + self.shader_pack_config.as_ref().is_some_and(|c| { + !s.horizon.shader_pack.is_empty() + && c.id == s.horizon.shader_pack + && (!c.options.is_empty() || !c.profiles.is_empty()) + }) + } fn shader_pack_dir(&self) -> std::path::PathBuf { if self.shader_packs.dir.as_os_str().is_empty() { crate::shader_pack::folder() @@ -1683,23 +1691,6 @@ impl OptionsUi { None, )); } - let has_settings = !s.horizon.shader_pack.is_empty() - && self.shader_pack_config.as_ref().is_some_and(|c| { - c.id == s.horizon.shader_pack - && (!c.options.is_empty() || !c.profiles.is_empty()) - }); - if has_settings { - rows.push(Row::Buttons( - button( - 0.0, - 0.0, - 310.0, - Text::literal("Shader Pack Settings..."), - Act::Push(Page::ShaderPackOptions), - ), - None, - )); - } rows } Page::ShaderPackOptions => { @@ -2185,6 +2176,10 @@ impl OptionsUi { if matches!(page, Page::Video | Page::Controls) { top = 38.0; } + if page == Page::ShaderPacks { + // Two footer rows, as Iris's ShaderPackScreen. + bottom = h - 57.0; + } out.push(Widget { x: 0.0, y: if matches!(page, Page::Video | Page::Controls) { @@ -2273,15 +2268,34 @@ impl OptionsUi { out[list_start..].iter_mut().for_each(|w| w.list = true); let folder = match page { Page::Mods => Some(("Open Mod Folder", Act::OpenModFolder)), - Page::ShaderPacks => { - Some(("Open Shader Pack Folder", Act::OpenShaderPackFolder)) - } Page::ShaderPackOptions => { Some(("Reset to Defaults", Act::ResetShaderPackOptions)) } _ => None, }; - if let Some((label, act)) = folder { + if page == Page::ShaderPacks { + // Iris: the folder and the pack's settings above Done. + out.push(button( + cx - 154.0, + h - 51.0, + 150.0, + Text::literal("Open Shader Pack Folder"), + Act::OpenShaderPackFolder, + )); + let settings = button( + cx + 4.0, + h - 51.0, + 150.0, + Text::literal("Shader Pack Settings..."), + Act::Push(Page::ShaderPackOptions), + ); + out.push(if self.shader_pack_has_settings(s) { + settings + } else { + inactive(settings) + }); + out.push(done(h - 27.0)); + } else if let Some((label, act)) = folder { out.push(button( cx - 154.0, h - 27.0, From d9591047fa44e7fc5c1bb3f2c4863e5bd0bc83e4 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 14:17:13 +0200 Subject: [PATCH 122/126] Shader pack docs: MakeUp, Chocapic13' and Photon on the Java path, and where the world goes Co-Authored-By: Claude Opus 5.5 --- docs/shader-packs.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/docs/shader-packs.md b/docs/shader-packs.md index 6718be0f7..3cd6a7191 100644 --- a/docs/shader-packs.md +++ b/docs/shader-packs.md @@ -427,9 +427,11 @@ What makes Horizon look like OpenGL to the pack: Measured on the Mac mini (M4 Pro) with the packs' default options: BSL v10.1.8 and Complementary Reimagined r5.9.3 grade and light Horizon's world as their post-processing would. Sildur's Vibrant v2.02 draws only its sky: its `deferred` reads the albedo `gbuffers_*` write to `colortex4`. Without `gbuffers_*` and `shadow`, no pack has its -shadows, water or sky look yet; Distant Horizons' and Voxy's depth read as far. Not supported yet: images and -compute (`.csh`; a pack that needs them doesn't load), mipmapped targets (`colortexNMipmapEnabled` is read but -ignored), custom textures, the option screen; shadow matrices are identity. +shadows, water or sky look yet; Distant Horizons' and Voxy's depth read as far. Horizon's world goes into the target +the pack's `gbuffers_terrain` (or the program Iris falls back to) draws to first: `colortex0` for most packs, +`colortex1` for MakeUp. Not supported yet: images and compute (`.csh`; a pack that needs them doesn't load), +mipmapped targets (`colortexNMipmapEnabled` is read but ignored), `.dat` and resource-location custom textures (PNG +files in the pack only); shadow matrices are identity. ### Compatibility @@ -438,6 +440,7 @@ the authors' pages (dev-only test inputs, kept outside the repository). "Loads" the overworld, Nether and End is preprocessed, translated and validated, as the game does when the pack is picked (`java_pack::tests::real_packs_load` with `HORIZON_TEST_SHADERPACKS`); "drawn" means it was also picked in the game and screenshotted. Only full-screen passes run (above), so no pack has its own terrain, water, shadows or sky yet. +The MakeUp, Chocapic13' and Photon rows are from 2026-10-23, on Metal and on Vulkan (RTX 4080). | Pack | Version | Result | First thing that stops it | | --- | --- | --- | --- | @@ -446,10 +449,12 @@ and screenshotted. Only full-screen passes run (above), so no pack has its own t | Complementary Unbound | r5.8 | loads: 27 passes | | | Sildur's Vibrant Extreme | 2.02 | drawn: 18 passes, only its sky (above) | | | Steadfast | 0.8.0 | drawn: 3 passes | | +| MakeUp Ultra Fast | 9.6 | drawn: 6 passes, its fog, light shafts and grade over Horizon's world | | +| Chocapic13' | V9 High | drawn: 16 passes; its default TAA upscaling shrinks the world in its `gbuffers_*` vertex programs, which don't run, so the picture is magnified 1/0.7: turn TAA Upscaling off in its settings | | | Bliss | 2.1.2 | fails | `world0/deferred.vsh`: an operation naga forbids in a vertex shader | | Bloop | 1.8.0-Alpha-3 | fails | `world0/prepare1.fsh`: `mat2(vec4)` and other constructors naga's GLSL front end refuses | | Noble | v1.9.9 | fails (Apple and NVIDIA) | `world0/deferred4.vsh`: a `vec3[9][9]` varying (nested arrays between stages) | -| Photon | v1.4 | fails | `world0/prepare.vsh`: a struct varying (`CloudsParameters`) | +| Photon | v1.4 | fails | `world0/deferred1.fsh`: `textureGather` | | Rethinking Voxels | r0.1-beta9 | fails | `world0/prepare.fsh`: `1 << 31` overflows naga's constant folding; it also needs images | What the translator does for these packs, as Iris (JCPP and its GLSL transformer) does: From 7cc47e2b55817b1cba0daaa88b1aa3af495c8e56 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 14:41:40 +0200 Subject: [PATCH 123/126] Delete ten tools/ scripts nothing references command_parse_summary, structure_start_oracle, fetch_client_assets, compare_structure_starts, profile_behaviour_cache, command_tree_diff, compare_loot_fill, compare_structure_blocks, test_lan_lifecycle and PROFILE_SHARED_JSON.md: no workflow, doc, harness, test or other tool names them (review-plan.md, Dead code). History keeps them. Co-Authored-By: Claude Opus 5.5 --- tools/PROFILE_SHARED_JSON.md | 85 ------------ tools/command_parse_summary.py | 36 ----- tools/command_tree_diff.py | 79 ----------- tools/compare_loot_fill.py | 91 ------------ tools/compare_structure_blocks.py | 113 --------------- tools/compare_structure_starts.py | 55 -------- tools/fetch_client_assets.py | 46 ------- tools/profile_behaviour_cache.py | 57 -------- tools/structure_start_oracle.py | 38 ----- tools/test_lan_lifecycle.py | 222 ------------------------------ 10 files changed, 822 deletions(-) delete mode 100644 tools/PROFILE_SHARED_JSON.md delete mode 100644 tools/command_parse_summary.py delete mode 100644 tools/command_tree_diff.py delete mode 100644 tools/compare_loot_fill.py delete mode 100644 tools/compare_structure_blocks.py delete mode 100644 tools/compare_structure_starts.py delete mode 100644 tools/fetch_client_assets.py delete mode 100644 tools/profile_behaviour_cache.py delete mode 100644 tools/structure_start_oracle.py delete mode 100644 tools/test_lan_lifecycle.py diff --git a/tools/PROFILE_SHARED_JSON.md b/tools/PROFILE_SHARED_JSON.md deleted file mode 100644 index 976e43ecb..000000000 --- a/tools/PROFILE_SHARED_JSON.md +++ /dev/null @@ -1,85 +0,0 @@ -# Reproducing PR #607 block-facts startup profiles - -These are loader-only measurements. They include `Assets::load`, `BlockFacts`, and -`Behaviours` and exclude content root preparation, graphics, input setup, first -frame, and the rest of the client startup sequence. No full-client startup gain -has been measured. The prepared `26.3` resource root must match the revision. - -## Historical release builds - -From the PR branch checkout, use an absolute prepared resource-root path and a -single, explicit Cargo release profile for each detached historical worktree: - -```sh -PR_ROOT="$(pwd)" -BENCH_ROOT="$(mktemp -d)" -mkdir -p "$BENCH_ROOT/bin" -CARGO_TARGET_DIR="$BENCH_ROOT/target" -export CARGO_TARGET_DIR - -for entry in baseline:e422bd13 a01:a01d47f2 cf:cf837118 cd:cd61e11b; do - name="${entry%%:*}" - revision="${entry#*:}" - git worktree add --detach "$BENCH_ROOT/$name" "$revision" -done - -# e422bd13 predates the profiler; add the same baseline example source used -# for the benchmark, without changing any production implementation. -cp "$PR_ROOT/tools/baseline_loader_profile.rs" \ - "$BENCH_ROOT/baseline/crates/horizon-client/examples/shared_json_startup_profile.rs" - -for name in baseline a01 cf cd; do - (cd "$BENCH_ROOT/$name" && \ - cargo build --offline --release -p horizon-client --example shared_json_startup_profile) - cp "$CARGO_TARGET_DIR/release/examples/shared_json_startup_profile" \ - "$BENCH_ROOT/bin/$name" -done - -cargo build --offline --release -p horizon-client --example shared_json_startup_profile -cp "$CARGO_TARGET_DIR/release/examples/shared_json_startup_profile" "$BENCH_ROOT/bin/current" - -python3 tools/profile_shared_json.py \ - --resources /absolute/path/to/.local/horizon-client/26.3 \ - --baseline-binary "$BENCH_ROOT/bin/baseline" \ - --a01-binary "$BENCH_ROOT/bin/a01" \ - --cf-binary "$BENCH_ROOT/bin/cf" \ - --cd-binary "$BENCH_ROOT/bin/cd" \ - --binary "$BENCH_ROOT/bin/current" \ - --repeats 10 --output "$BENCH_ROOT/five-way.json" -``` - -The source tree of each historical revision is exact. The baseline profiler is -an added standalone measurement example, and therefore does not alter its -historical loader logic. Comparisons use alternating forward/reverse process -order, separate processes, Linux `wait4` CPU time and peak RSS, and saved raw -samples with 25th/75th percentiles, extrema, build hashes and system load. -Keep concurrent compilation and other CPU-intensive jobs idle if possible. -`ru_maxrss` records process peak residency and cannot establish the real game's -memory usage after rendering begins. If system load rises, preserve rather than -discard outliers and report the uncertainty. - -## Decoding passes and buffer lifetime - -```sh -cargo build --offline --release -p horizon-client --example gameplay_decode_profile -python3 tools/profile_gameplay_decode.py \ - --resources /absolute/path/to/.local/horizon-client/26.3 \ - --repeats 10 --output "$BENCH_ROOT/decode.json" - -python3 tools/profile_shared_json.py \ - --resources /absolute/path/to/.local/horizon-client/26.3 \ - --variant released="$BENCH_ROOT/bin/current"@deferred \ - --variant retained="$BENCH_ROOT/bin/current"@deferred-held \ - --repeats 10 --output "$BENCH_ROOT/lifetime.json" -``` - -The decoder profile measures the `Validate` pass and typed `Gameplay` pass -separately, including the JSON read in `total_ms`. The primary facts loader -continues both passes to preserve JSON validation, error precedence and useful -diagnostics, including overwritten fields and raw geometry. The lifetime -comparison measures current process `VmRSS` after materialisation, plus peak -RSS across the process. An explicit `drop` releases owned Rust values, but the -allocator may retain physical pages, so immediate RSS savings are not implied. - -When finished, `git worktree remove` each temporary historical worktree. Do -not `git clean` or reset the active PR working tree. diff --git a/tools/command_parse_summary.py b/tools/command_parse_summary.py deleted file mode 100644 index 2cd8d1f68..000000000 --- a/tools/command_parse_summary.py +++ /dev/null @@ -1,36 +0,0 @@ -#!/usr/bin/env python3 -"""Group the mismatches of tools/test_command_parse_parity.py by cause. - -usage: command_parse_summary.py MISMATCHES.jsonl [ROOT] -""" -import collections -import json -import sys -from pathlib import Path - - -def describe(side, kind): - if kind == 'parse': - if side.get('ok'): - return 'OK' - return f"ERR {side.get('error')!r}@{'c' if side.get('cursor') else '0'}" - return f"SUGG[{len(side['list'])}]" - - -path = Path(sys.argv[1]) -only = sys.argv[2] if len(sys.argv) > 2 else None -groups = collections.Counter() -examples = {} -for line in path.open(encoding='utf-8'): - m = json.loads(line) - root = m['in'].split(' ')[0] - if only and root != only: - continue - key = (m['kind'], describe(m['vanilla'], m['kind']), describe(m['rust'], m['kind'])) - if m['kind'] == 'parse': - key = key[:1] + (key[1][:90], key[2][:90]) - groups[key] += 1 - examples.setdefault(key, m) -for key, count in sorted(groups.items(), key=lambda kv: -kv[1])[:int(sys.argv[3]) if len(sys.argv) > 3 else 40]: - ex = examples[key] - print(f'{count:6} {key[0]} vanilla={key[1]} rust={key[2]}\n e.g. {ex["in"]!r}') diff --git a/tools/command_tree_diff.py b/tools/command_tree_diff.py deleted file mode 100644 index 8bd049b7a..000000000 --- a/tools/command_tree_diff.py +++ /dev/null @@ -1,79 +0,0 @@ -#!/usr/bin/env python3 -"""Structural diff between vanilla's exported command tree and Horizon's. - -usage: command_tree_diff.py VANILLA_TREE.json RUST_TREE.json [ROOT] - -Reports, for every shared node, the children Horizon lacks or adds, differing -argument parsers and executable/redirect flags. Missing subtrees are reported -once at their root. -""" -import json -import sys - -LOOSE = { - # Horizon's coarse argument kinds that stand in for several vanilla parsers. - 'brigadier:string': {'brigadier:string', 'minecraft:message', 'minecraft:component'}, -} - - -def same_parser(vanilla, rust): - if vanilla == rust: - return True - return False - - -def keyed(children): - """Literals by name; arguments by position (their names are internal).""" - out = {} - index = 0 - for name, child in children.items(): - if child['type'] == 'literal': - out[('l', name)] = (name, child) - else: - out[('a', index)] = (name, child) - index += 1 - return out - - -def diff(path, v, r, out): - vc, rc = keyed(v.get('children', {})), keyed(r.get('children', {})) - for key, (name, node) in vc.items(): - if key not in rc: - out.append(('missing', path + [name], node.get('parser') or 'literal', count(node))) - for key, (name, node) in rc.items(): - if key not in vc: - out.append(('extra', path + [name], node.get('parser') or 'literal', count(node))) - for key, (name, a) in vc.items(): - if key not in rc: - continue - _, b = rc[key] - if a['type'] == 'argument' and not same_parser(a['parser'], b['parser']): - out.append(('parser', path + [name], f"{a['parser']} vs {b['parser']}", 0)) - if bool(a.get('executable')) != bool(b.get('executable')): - out.append(('executable', path + [name], f"vanilla={bool(a.get('executable'))}", 0)) - if bool(a.get('redirect')) != bool(b.get('redirect')): - out.append(('redirect', path + [name], f"vanilla={bool(a.get('redirect'))}", 0)) - diff(path + [name], a, b, out) - - -def count(node): - return 1 + sum(count(c) for c in node.get('children', {}).values()) - - -def main(): - vanilla = json.load(open(sys.argv[1])) - rust = json.load(open(sys.argv[2])) - only = sys.argv[3] if len(sys.argv) > 3 else None - if only: - vanilla = {'children': {only: vanilla['children'][only]}, 'type': 'root'} - rust = {'children': {only: rust['children'].get(only, {'children': {}, 'type': 'literal'})}, 'type': 'root'} - out = [] - diff([], vanilla, rust, out) - for kind, path, detail, size in out: - print(f'{kind:10} {" ".join(path)} [{detail}]' + (f' ({size} nodes)' if size else '')) - missing = sum(size for kind, _, _, size in out if kind == 'missing') - print(f'-- {len(out)} differences, {missing} vanilla nodes missing in Horizon') - - -if __name__ == '__main__': - main() diff --git a/tools/compare_loot_fill.py b/tools/compare_loot_fill.py deleted file mode 100644 index 7ad307420..000000000 --- a/tools/compare_loot_fill.py +++ /dev/null @@ -1,91 +0,0 @@ -#!/usr/bin/env python3 -"""Compare Rust container loot (examples/loot_fill) with vanilla LootTable.fill. - -usage: compare_loot_fill.py RESOURCES TABLES SEED... -TABLES is a comma-separated list or `chests` for every chest table. Builds the -loot_fill example, runs VanillaLootFillOracle and diffs slot contents -(enchantments compared as sets). Tables vanilla cannot fill without a level -(exploration maps) are reported and skipped. -""" -import collections -import os -import subprocess -import sys -from pathlib import Path -try: - from . import lab, test_rust_parity as base -except ImportError: - import lab - import test_rust_parity as base - - -def build_dir(): - return Path(os.environ['HORIZON_ORACLE_BUILD']) if os.environ.get('HORIZON_ORACLE_BUILD') else lab.LOCAL/'loot-fill-oracle' - - -def run_oracle(out, tables, seeds): - lock, jars, libraries = base.verify_artifacts() - source = lab.ROOT/'mods/horizon/src/test/java/dev/horizonlab/parity/VanillaLootFillOracle.java' - build = build_dir() - classes = build/'classes' - classes.mkdir(parents=True, exist_ok=True) - dependencies = os.pathsep.join(map(str, [jars['server'], *libraries])) - compiled = subprocess.run(['javac', '--release', str(lock['minecraft']['java_major']), '-proc:none', '-cp', dependencies, - '-d', str(classes), str(source)], capture_output=True, text=True) - if compiled.returncode: - raise SystemExit('javac failed:\n' + compiled.stderr[-3000:]) - result = subprocess.run(['java', '-Xmx2G', '-cp', str(classes)+os.pathsep+dependencies, - 'dev.horizonlab.parity.VanillaLootFillOracle', str(out), tables, *seeds], - capture_output=True, text=True) - if result.returncode: - lines = [line for line in (result.stdout + result.stderr).splitlines() if 'Exception' in line or 'Caused' in line] - raise SystemExit('oracle failed: ' + ' | '.join(lines[:5])) - - -def parse(lines): - fills, errors = collections.defaultdict(list), set() - for line in lines: - t = line.split() - if not t: - continue - if t[0] == 'table': - fills[(t[1], t[2])] - elif t[0] == 'error': - errors.add((t[1], t[2])) - elif t[0] == 'fill': - fills[(t[1], t[2])].append((int(t[3]), t[4], t[5], t[6], tuple(sorted(t[7:])))) - return fills, errors - - -def main(): - resources, tables, seeds = sys.argv[1], sys.argv[2], sys.argv[3:] - out = build_dir()/'vanilla.txt' - out.parent.mkdir(parents=True, exist_ok=True) - run_oracle(out, tables, seeds) - vanilla, errors = parse(out.read_text().splitlines()) - names = sorted({k[0] for k in vanilla} | {k[0] for k in errors}) - subprocess.run(['cargo', 'build', '--profile', 'fast', '-q', '-p', 'horizon-world', '--example', 'loot_fill'], - check=True, cwd=lab.ROOT) - rust_out = subprocess.run([str(lab.cargo_target()/'fast/examples/loot_fill'), resources, ','.join(names), *seeds], - check=True, capture_output=True, text=True).stdout - rust, _ = parse(rust_out.splitlines()) - matched = differ = 0 - for key in sorted(vanilla): - if key in errors: - continue - if vanilla[key] == rust.get(key): - matched += 1 - continue - differ += 1 - if differ <= 20: - print('DIFF', key, '\n vanilla', vanilla[key], '\n rust ', rust.get(key)) - tables = collections.Counter(k[0] for k in vanilla if k not in errors and vanilla[k] != rust.get(k)) - if tables: - print('differing tables:', dict(tables)) - skipped = sorted({k[0] for k in errors}) - print(f'{matched} of {matched + differ} fills match; skipped (needs a level): {skipped}') - return 1 if differ else 0 - - -if __name__ == '__main__': - sys.exit(main()) diff --git a/tools/compare_structure_blocks.py b/tools/compare_structure_blocks.py deleted file mode 100644 index 51d71f57b..000000000 --- a/tools/compare_structure_blocks.py +++ /dev/null @@ -1,113 +0,0 @@ -#!/usr/bin/env python3 -"""Compare structure placement (terrain + structure pieces, no placed features) -between vanilla and Rust for target chunks. - -usage: compare_structure_blocks.py RESOURCES SEED DIMENSION CX,CZ... -Runs VanillaStructurePlacementOracle and the structure_blocks example and -reports, per chunk, the blocks and block entities that differ. -""" -import json -import os -import subprocess -import sys -from pathlib import Path -try: - from . import lab, test_rust_parity as base -except ImportError: - import lab - import test_rust_parity as base - - -def build_dir(): - return Path(os.environ['HORIZON_ORACLE_BUILD']) if os.environ.get('HORIZON_ORACLE_BUILD') else lab.LOCAL/'structure-placement-oracle' - - -def run_oracle(out, args): - lock, jars, libraries = base.verify_artifacts() - source = lab.ROOT/'mods/horizon/src/test/java/dev/horizonlab/parity/VanillaStructurePlacementOracle.java' - classes = build_dir()/'classes' - classes.mkdir(parents=True, exist_ok=True) - dependencies = os.pathsep.join(map(str, [jars['server'], *libraries])) - compiled = subprocess.run(['javac', '--release', str(lock['minecraft']['java_major']), '-proc:none', '-cp', dependencies, - '-d', str(classes), str(source)], capture_output=True, text=True) - if compiled.returncode: - raise SystemExit('javac failed:\n' + compiled.stderr[-3000:]) - result = subprocess.run(['java', '-Xmx4G', '-cp', str(classes)+os.pathsep+dependencies, - 'dev.horizonlab.parity.VanillaStructurePlacementOracle', str(out), *args], - capture_output=True, text=True) - if result.returncode: - lines = [line for line in (result.stdout + result.stderr).splitlines() if 'Exception' in line or 'Error' in line or '\tat ' in line] - raise SystemExit('oracle failed: ' + ' | '.join(lines[:8])) - - -def parse(lines): - chunks, current = {}, None - for line in lines: - t = line.split() - if not t: - continue - if t[0] == 'chunk': - current = (int(t[1]), int(t[2])) - chunks[current] = {'rows': {}, 'be': []} - elif t[0] == 'y' and current: - chunks[current]['rows'][int(t[1])] = t[2:] - elif t[0] == 'be' and current: - # Position, loot table and seed; the block entity type follows - # from the (separately compared) block state. - chunks[current]['be'].append(' '.join(t[1:4] + t[5:])) - return chunks - - -def state_names(resources): - names = {} - report = lab.LOCAL/'datagen/out/reports/blocks.json' - if report.exists(): - for block, info in json.loads(report.read_text()).items(): - for state in info['states']: - props = ','.join(f'{k}={v}' for k, v in sorted(state.get('properties', {}).items())) - names[str(state['id'])] = block + (f'[{props}]' if props else '') - return names - - -def main(): - resources, seed, dimension, targets = sys.argv[1], sys.argv[2], sys.argv[3], sys.argv[4:] - out = build_dir()/'vanilla.txt' - out.parent.mkdir(parents=True, exist_ok=True) - run_oracle(out, [seed, dimension, *targets]) - vanilla = parse(out.read_text().splitlines()) - subprocess.run(['cargo', 'build', '--profile', 'fast', '-q', '-p', 'horizon-world', '--example', 'structure_blocks'], - check=True, cwd=lab.ROOT) - rust_out = subprocess.run([str(lab.cargo_target()/'fast/examples/structure_blocks'), resources, seed, dimension, *targets], - check=True, capture_output=True, text=True).stdout - (build_dir()/'rust.txt').write_text(rust_out) - rust = parse(rust_out.splitlines()) - names = state_names(resources) - failed = 0 - for key in sorted(vanilla): - v, r = vanilla[key], rust.get(key) - if r is None: - print(key, 'missing from Rust') - failed += 1 - continue - diffs = [] - for y, row in v['rows'].items(): - other = r['rows'].get(y, []) - for i, (a, b) in enumerate(zip(row, other)): - if a != b: - diffs.append((key[0] * 16 + i % 16, y, key[1] * 16 + i // 16, a, b)) - total = sum(len(row) for row in v['rows'].values()) - be_v, be_r = set(v['be']), set(r['be']) - status = 'match' if not diffs and be_v == be_r else 'DIFF' - print(f'chunk {key}: {status}; {total - len(diffs)} of {total} blocks equal; block entities {len(be_v & be_r)} of {len(be_v)} equal') - for x, y, z, a, b in diffs[:12]: - print(f' {x} {y} {z} vanilla {names.get(a, a)} rust {names.get(b, b)}') - for e in sorted(be_v - be_r)[:6]: - print(' only vanilla be', e) - for e in sorted(be_r - be_v)[:6]: - print(' only rust be', e) - failed += status != 'match' - return 1 if failed else 0 - - -if __name__ == '__main__': - sys.exit(main()) diff --git a/tools/compare_structure_starts.py b/tools/compare_structure_starts.py deleted file mode 100644 index 363e7b76f..000000000 --- a/tools/compare_structure_starts.py +++ /dev/null @@ -1,55 +0,0 @@ -#!/usr/bin/env python3 -"""Compare Rust structure starts (chunkgen_bench --starts) with the vanilla oracle. - -usage: compare_structure_starts.py VANILLA RUST [--all] -Pieces are compared by type, bounding box and (for jigsaw pieces) position, -rotation, ground level delta and junction count. Without --all, vanilla -starts of structure types Rust does not generate yet are only counted. -""" -import collections -import sys - - -def load(path): - starts = {} - current = None - for line in open(path): - t = line.split() - if not t: - continue - if t[0] == 'start': - current = (int(t[1]), int(t[2]), t[3]) - starts[current] = [' '.join(t[4:])] - elif t[0] == 'piece' and current: - starts[current].append(' '.join(t[1:14])) - return starts - - -def main(): - vanilla, rust = load(sys.argv[1]), load(sys.argv[2]) - generated = {k[2] for k in rust} - matched = 0 - missing = collections.Counter() - for key in sorted(vanilla): - if key not in rust: - missing[key[2]] += 1 - if key[2] in generated or '--all' in sys.argv: - print('missing', key) - continue - if vanilla[key] == rust[key]: - matched += 1 - continue - v, r = vanilla[key], rust[key] - print('DIFF', key, 'pieces', len(v) - 1, len(r) - 1) - for i, (a, b) in enumerate(zip(v, r)): - if a != b: - print(' first difference at line', i, '\n vanilla', a, '\n rust ', b) - break - for key in sorted(set(rust) - set(vanilla)): - print('extra', key) - print(f'{matched} of {len(vanilla)} vanilla starts match exactly; not generated by Rust:', dict(missing)) - return 0 if matched == len(rust) == sum(1 for k in vanilla if k[2] in generated) else 1 - - -if __name__ == '__main__': - sys.exit(main()) diff --git a/tools/fetch_client_assets.py b/tools/fetch_client_assets.py deleted file mode 100644 index 2027593c5..000000000 --- a/tools/fetch_client_assets.py +++ /dev/null @@ -1,46 +0,0 @@ -#!/usr/bin/env python3 -"""Copy the pinned version's indexed client assets that are not in the game -jar from your own official launcher install: language files and the language -list (pack.mcmeta), the unifont glyph archives and their font definitions, and -the built-in Programmer Art and High Contrast resource packs. Every object's -SHA-1 is verified. Nothing is downloaded; files go to the private client -resource directory (or --target) and are never committed.""" -import argparse -from pathlib import Path -import shutil - -import lab - - -def wanted(name): - return (name == 'pack.mcmeta' - or name.startswith('minecraft/lang/') - or name.startswith('minecraft/font/') - or name.startswith('minecraft/resourcepacks/')) - - -def main(): - parser = argparse.ArgumentParser(description=__doc__) - parser.add_argument('--target', type=Path, default=lab.RESOURCES, - help='prepared resource directory (default: .local/horizon-client/)') - parser.add_argument('--minecraft-dir', type=Path, - help="official launcher game directory (default: the launcher's own)") - args = parser.parse_args() - lock, directory = lab.config() - manifest = lab.import_manifest(lock, directory, args.minecraft_dir) - store, index = lab.launcher_assets(manifest, args.minecraft_dir) - target = args.target - target.mkdir(parents=True, exist_ok=True) - shutil.copyfile(index, target / 'asset-index.json') - objects = lab.json.loads(index.read_text())['objects'] - selected = {name: info for name, info in objects.items() if wanted(name)} - total = 0 - for name, info in selected.items(): - source = lab.launcher_object(store, info['hash']) - lab.import_copy(source, target / 'assets' / name, info['hash']) - total += info['size'] - print(f'Client assets ready: {len(selected)} files, {total / 1e6:.1f} MB') - - -if __name__ == '__main__': - main() diff --git a/tools/profile_behaviour_cache.py b/tools/profile_behaviour_cache.py deleted file mode 100644 index 00ba65a6d..000000000 --- a/tools/profile_behaviour_cache.py +++ /dev/null @@ -1,57 +0,0 @@ -#!/usr/bin/env python3 -"""Measure the resource-dependent Behaviours::load portion of client startup. - -Build the behaviour_load_profile example in the checkout to be measured first: - cargo build --release -p horizon-world --example behaviour_load_profile - -Run the profiler from the repository root with the matching example binary. -This measures behaviour loading, not time to first rendered frame. With ---cache-dir, the example reads and refreshes the resolved snapshot there, as the -client does with its .horizon-cache folder: the first load of a run builds it -when it is missing, the next loads restore it. -""" -import argparse -import json -import re -import statistics -import subprocess -from pathlib import Path - - -def main(): - parser = argparse.ArgumentParser(description=__doc__) - parser.add_argument("--binary", type=Path, default=Path("target/release/examples/behaviour_load_profile")) - parser.add_argument("--resources", type=Path, default=Path(".local/horizon-client/26.3")) - parser.add_argument("--cache-dir", type=Path, - help="snapshot folder (default: no snapshot, every load is uncached)") - parser.add_argument("--repeats", type=int, default=5) - parser.add_argument("--output", type=Path) - args = parser.parse_args() - if args.repeats < 1: - parser.error("--repeats must be at least one") - samples = [] - for _ in range(args.repeats): - command = [str(args.binary.resolve()), str(args.resources.resolve())] - if args.cache_dir: - command.append(str(args.cache_dir.resolve())) - run = subprocess.run(command, text=True, capture_output=True, check=True) - values = {key: float(value) for key, value in - re.findall(r"^(registry_ms|behaviours_[0-2]_ms)=([\d.]+)$", run.stderr, re.M)} - if len(values) != 4: - raise RuntimeError(f"incomplete profile output: {run.stderr}") - samples.append(values) - summary = {key: {"median_ms": round(statistics.median(row[key] for row in samples), 3), - "samples_ms": [row[key] for row in samples]} - for key in samples[0]} - result = {"scope": "behaviour loader only; not full client startup", - "binary": str(args.binary), "resources": str(args.resources), "repeats": args.repeats, - "cache_dir": str(args.cache_dir) if args.cache_dir else None, - "metrics": summary} - print(json.dumps(result, indent=2)) - if args.output: - args.output.parent.mkdir(parents=True, exist_ok=True) - args.output.write_text(json.dumps(result, indent=2) + "\n") - - -if __name__ == "__main__": - main() diff --git a/tools/structure_start_oracle.py b/tools/structure_start_oracle.py deleted file mode 100644 index dc622ae19..000000000 --- a/tools/structure_start_oracle.py +++ /dev/null @@ -1,38 +0,0 @@ -#!/usr/bin/env python3 -"""Run the vanilla structure-start oracle for a seed and chunk rectangle. - -usage: structure_start_oracle.py OUT SEED X0 Z0 X1 Z1 -""" -import os -import subprocess -from pathlib import Path -import sys -try: - from . import lab, test_rust_parity as base -except ImportError: - import lab - import test_rust_parity as base - - -def main(): - out, seed, x0, z0, x1, z1 = sys.argv[1:7] - lock, jars, libraries = base.verify_artifacts() - source = lab.ROOT/'mods/horizon/src/test/java/dev/horizonlab/parity/VanillaStructureStartOracle.java' - build = Path(os.environ['HORIZON_ORACLE_BUILD']) if os.environ.get('HORIZON_ORACLE_BUILD') else lab.LOCAL/'structure-start-oracle' - classes = build/'classes' - classes.mkdir(parents=True, exist_ok=True) - dependencies = os.pathsep.join(map(str, [jars['server'], *libraries])) - compiled = subprocess.run(['javac', '--release', str(lock['minecraft']['java_major']), '-proc:none', '-cp', dependencies, - '-d', str(classes), str(source)], capture_output=True, text=True) - if compiled.returncode: - raise SystemExit('javac failed:\n' + compiled.stderr[-3000:]) - result = subprocess.run(['java', '-Xmx2G', '-cp', str(classes)+os.pathsep+dependencies, - 'dev.horizonlab.parity.VanillaStructureStartOracle', out, seed, x0, z0, x1, z1], - capture_output=True, text=True) - if result.returncode: - lines = [line for line in (result.stdout + result.stderr).splitlines() if 'Exception' in line or 'Caused' in line] - raise SystemExit('oracle failed: ' + ' | '.join(lines[:5])) - - -if __name__ == '__main__': - main() diff --git a/tools/test_lan_lifecycle.py b/tools/test_lan_lifecycle.py deleted file mode 100644 index 389b8438c..000000000 --- a/tools/test_lan_lifecycle.py +++ /dev/null @@ -1,222 +0,0 @@ -#!/usr/bin/env python3 -"""Check LAN shutdown when leaving a singleplayer world through the pause menu, -and that offline guests joining with their default names are not refused as the -host's profile (#195: everyone was "Player"). - -Requires a built horizon-client, prepared resources and a display on Unix: - xvfb-run -a python3 tools/test_lan_lifecycle.py --client target/fast/horizon-client -Worlds and settings are created in a temporary directory. -""" -import argparse -import json -import os -from pathlib import Path -import socket -import subprocess -import tempfile -import time - -try: - from . import lab -except ImportError: - import lab - -ROOT = Path(__file__).resolve().parents[1] -GROUP = '224.0.2.60' -DISCOVERY_PORT = 4445 - - -def command(endpoint, line): - with socket.socket(socket.AF_UNIX, socket.SOCK_STREAM) as connection: - connection.settimeout(60) - connection.connect(str(endpoint)) - connection.sendall((line + '\n').encode()) - with connection.makefile('r') as reply: - result = json.loads(reply.readline()) - assert 'error' not in result, (line, result) - return result - - -def wait_for(endpoint, line, predicate, timeout=60): - deadline = time.monotonic() + timeout - while time.monotonic() < deadline: - try: - result = command(endpoint, line) - except (FileNotFoundError, ConnectionRefusedError): - time.sleep(0.1) - continue - if predicate(result): - return result - time.sleep(0.1) - raise AssertionError(f'timed out waiting for {line}') - - -def announcement(scanner, port, timeout): - deadline = time.monotonic() + timeout - marker = f'[AD]{port}[/AD]'.encode() - while time.monotonic() < deadline: - scanner.settimeout(max(0.001, deadline - time.monotonic())) - try: - message, _ = scanner.recvfrom(4096) - except socket.timeout: - return False - if marker in message: - return True - return False - - -def scenario(endpoint, scanner): - wait_for(endpoint, 'screen', lambda value: value['screen'] == 'title') - command(endpoint, 'open LanLifecycle 0 creative') - wait_for(endpoint, 'status', lambda value: value['player'] is not None - and value['pending_chunks'] == 0) - assert command(endpoint, 'lan status') == {'open': False} - port = 0 - for _ in range(2): - port = command(endpoint, f'lan open {port}')['port'] - with socket.create_connection(('127.0.0.1', port), timeout=2): - pass - assert announcement(scanner, port, 5), 'LAN world was not advertised' - command(endpoint, 'key esc tap') - screen = wait_for(endpoint, 'screen', lambda value: any( - button['label'] == 'Save and Quit to Title' for button in value['buttons'])) - assert screen['screen'] == 'paused', screen - command(endpoint, 'click-button Save and Quit to Title') - wait_for(endpoint, 'screen', lambda value: value['screen'] == 'title') - assert command(endpoint, 'lan status') == {'open': False}, 'LAN stayed open after leaving' - try: - connection = socket.create_connection(('127.0.0.1', port), timeout=2) - except ConnectionRefusedError: - pass - else: - connection.close() - raise AssertionError('LAN still accepts connections after leaving') - # Discard datagrams queued before shutdown, then listen for more than - # two announcement intervals (the pinger sends every 1.5 seconds). - scanner.setblocking(False) - try: - while True: - scanner.recvfrom(4096) - except BlockingIOError: - pass - assert not announcement(scanner, port, 3.5), 'LAN kept advertising after leaving' - command(endpoint, 'open LanLifecycle') - wait_for(endpoint, 'status', lambda value: value['player'] is not None - and value['pending_chunks'] == 0) - assert command(endpoint, 'lan status') == {'open': False}, 'LAN reopened with the world' - command(endpoint, 'lan open 0') - command(endpoint, 'quit') - - -def start_client(client, resources, home, endpoint, log, *extra): - return subprocess.Popen([ - str(client), '--resources', str(resources), '--render-distance', '2', - '--test-terrain', '--control-socket', str(endpoint), '--timeout-seconds', '180', *extra, - ], cwd=home, env=dict(os.environ, HORIZON_HOME=str(home), HORIZON_NO_AUDIO='1', - HORIZON_PLAYER_NAME=''), - stdout=log, stderr=subprocess.STDOUT) - - -def guest_names(endpoint, port, guests): - """Two guests with default names join together; a guest named like the host is refused.""" - names = [] - for home, guest in guests: - wait_for(guest, 'screen', lambda value: value['screen'] == 'title') - command(guest, f'connect 127.0.0.1:{port}') - wait_for(guest, 'status', lambda value: (value.get('server') or {}).get('joined')) - kept = (home / 'horizon-player.txt').read_text() - assert kept.startswith('name:Player') and kept.strip() != 'name:Player', kept - names.append(kept.strip().removeprefix('name:')) - assert names[0] != names[1], names - status = wait_for(endpoint, 'lan status', lambda value: len(value['guests']) == 2) - assert sorted(g['name'] for g in status['guests']) == sorted(names), status - # The same home keeps its name: leave and join again as the same profile. - home, guest = guests[0] - command(guest, 'disconnect') - wait_for(endpoint, 'lan status', lambda value: len(value['guests']) == 1) - command(guest, f'connect 127.0.0.1:{port}') - wait_for(guest, 'status', lambda value: (value.get('server') or {}).get('joined')) - assert (home / 'horizon-player.txt').read_text().strip() == f'name:{names[0]}' - # A guest that really is the host's offline profile is refused, the others stay. - command(guest, 'disconnect') - command(guest, f'connect 127.0.0.1:{port} Player') - refused = wait_for(guest, 'screen', lambda value: (value.get('menu') or {}).get('disconnected')) - assert 'another location' in refused['menu']['disconnected'], refused - status = command(endpoint, 'lan status') - assert [g['name'] for g in status['guests']] == [names[1]], status - return names - - -def main(): - parser = argparse.ArgumentParser(description=__doc__) - parser.add_argument('--client', type=Path, required=True) - parser.add_argument('--resources', type=Path, default=lab.RESOURCES) - args = parser.parse_args() - client, resources = args.client.resolve(), args.resources.resolve() - with tempfile.TemporaryDirectory(prefix='horizon-lan-') as directory: - work = Path(directory) - endpoint = work / 'control.sock' - with socket.socket(socket.AF_INET, socket.SOCK_DGRAM) as scanner: - scanner.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) - scanner.bind(('', DISCOVERY_PORT)) - scanner.setsockopt(socket.IPPROTO_IP, socket.IP_ADD_MEMBERSHIP, - socket.inet_aton(GROUP) + socket.inet_aton('0.0.0.0')) - with (work / 'client.log').open('w+') as log: - process = start_client(client, resources, work, endpoint, log) - try: - scenario(endpoint, scanner) - assert process.wait(timeout=20) == 0, 'client exited unsuccessfully' - except Exception: - log.seek(0) - print('\n'.join(log.read().splitlines()[-20:])) - raise - finally: - stop(process) - names = guests_scenario(client, resources, work) - print('LAN lifecycle passed: leaving stops hosting and discovery; reopening stays private') - print(f'LAN guests passed: default names {names[0]} and {names[1]} joined together and kept; ' - '"Player" refused as the host\'s profile') - - -def stop(process): - if process.poll() is None: - process.terminate() - try: - process.wait(timeout=10) - except subprocess.TimeoutExpired: - process.kill() - process.wait(timeout=10) - - -def guests_scenario(client, resources, work): - host_home = work / 'host' - homes = [work / 'guest-a', work / 'guest-b'] - processes, logs = [], [] - try: - for home in [host_home, *homes]: - home.mkdir() - log = (home / 'client.log').open('w+') - logs.append(log) - processes.append(start_client(client, resources, home, home / 'control.sock', log)) - endpoint = host_home / 'control.sock' - wait_for(endpoint, 'screen', lambda value: value['screen'] == 'title') - command(endpoint, 'open LanGuests 0 creative') - wait_for(endpoint, 'status', lambda value: value['player'] is not None - and value['pending_chunks'] == 0) - port = command(endpoint, 'lan open 0')['port'] - return guest_names(endpoint, port, [(home, home / 'control.sock') for home in homes]) - except Exception: - for log in logs: - log.seek(0) - print(f'--- {log.name}') - print('\n'.join(log.read().splitlines()[-20:])) - raise - finally: - for process in processes: - stop(process) - for log in logs: - log.close() - - -if __name__ == '__main__': - main() From eeb4cdb680bb16739a1f4c85e3bea24ad2097052 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 15:06:50 +0200 Subject: [PATCH 124/126] Mod SDK: export_mod! exports only in WebAssembly, so the guests link on macOS A host build of a mod (cargo build or test on the workspace) made a cdylib whose component exports macOS's ld couldn't take: its exported-symbols list cuts `horizon:mods/events@0.1.0#init` at the `#`, so coords-hud and horizon-mods-test-guest failed to link. The exports now exist only for wasm32; on the host the macro still checks the mod and keeps it used. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-mod-sdk/src/lib.rs | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/crates/horizon-mod-sdk/src/lib.rs b/crates/horizon-mod-sdk/src/lib.rs index ccfdb7947..71c36cf80 100644 --- a/crates/horizon-mod-sdk/src/lib.rs +++ b/crates/horizon-mod-sdk/src/lib.rs @@ -135,7 +135,13 @@ macro_rules! export_mod { with(|m| $crate::Mod::chat(m, &text)) } } + // Only WebAssembly has the component's exports: a host build (cargo test or + // clippy on the workspace) checks the mod without them, which macOS + // couldn't link (its exported-symbols list cuts names at the `#`). + #[cfg(target_arch = "wasm32")] $crate::__export_horizon_mod!(Export); + #[cfg(not(target_arch = "wasm32"))] + let _ = ::init; }; }; } From 2eb699228a0064182aa9a8e8da4412c6cd1b6a4e Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 16:18:44 +0200 Subject: [PATCH 125/126] AGENTS.md and docs/architecture.md: a map of the code for agents AGENTS.md (CLAUDE.md links to it): the crates and what each owns, how to build and test fast, where each subsystem of horizon-client lives, how Game is organised, the two single-player paths and how to test both, the vanilla reference, and the rules that bite. docs/architecture.md: feature -> files -> checks for the 40 areas changed most in the last 30 days. Co-Authored-By: Claude Opus 5.5 --- AGENTS.md | 175 +++++++++++++++++++++++++++++++++++++++++++ CLAUDE.md | 1 + docs/README.md | 1 + docs/architecture.md | 57 ++++++++++++++ 4 files changed, 234 insertions(+) create mode 100644 AGENTS.md create mode 120000 CLAUDE.md create mode 100644 docs/architecture.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 000000000..d869aed2a --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,175 @@ +# Horizon: a map for agents + +Minecraft: Java Edition 26.3 rewritten in Rust (wgpu). Vanilla is the specification wherever it has the +feature. Read [CONTRIBUTING.md](CONTRIBUTING.md) once; this page tells you where things are. +Feature → files → harness for the most-changed areas: [docs/architecture.md](docs/architecture.md). + +## Rules that bite + +- **Never commit Mojang's files**: game jars, assets, decompiled source, prepared resources (`.local/`). + `tools/check_public_tree.py` rejects them; `git config core.hooksPath .githooks` runs it on commit. +- **Keep your runs away from real player data.** Any game or launcher you start gets fresh `mktemp -d` + folders in `HORIZON_HOME` (the game's data), `HORIZON_LAUNCHER_HOME`, `XDG_DATA_HOME` and + `XDG_CONFIG_HOME`, plus `HORIZON_LAUNCHER_NO_SELF_UPDATE=1` and `HORIZON_NO_AUDIO=1`. Never write to + `~/.local/share/{applications,horizon,horizon-launcher}` or `~/.local/bin`. +- **Mark what an agent posts.** A PR body starts with + `> 🤖 Opened by Ludovic's AI agent (Claude), not by Ludovic himself.` (issues: "Filed by", reviews: + "Review by"); every comment starts with `🤖 Agent:`. Never write as Ludovic. +- **Attribution.** Commits end with `Co-Authored-By: Claude `; PR bodies end + with `🤖 Generated with [Claude Code](https://claude.com/claude-code)`. +- Everything players run is Rust. Python/Java only for dev tools and harness drivers in `tools/`. +- Horizon-only features follow [docs/design-system.md](docs/design-system.md) and are off by default where + they would change the vanilla look. +- Small PRs (< ~500 lines). Labels: `feature` (players get something new), `skip-release` (they see no + change), none for a fix, `release-now` for crash fixes. Every merge to main ships + ([docs/release-flow.md](docs/release-flow.md)). +- Contributors first: `gh pr list --state open --search ` before you start; never duplicate theirs. + +## Crates + +Game workspace (root `Cargo.toml`); `launcher/` and `crates/horizon-telemetry-server` are separate workspaces. + +| Crate | Owns | +|---|---| +| `horizon-client` | The game: a lib (`src/lib.rs`, ~190 flat modules) and the bin (`src/main.rs` → `game.rs` + `game/`), plus `horizon-ctl` (`src/bin/horizon-ctl/`). Also the dedicated server (`--dedicated`) | +| `horizon-world` | Vanilla world data with no gameplay loop: NBT, regions, chunks, `datafix/`, `worldgen/`, `level/` (server-side block behaviour, ticks, redstone), entity physics, items, effects, food, damage | +| `horizon-core` | Simulation primitives: Java `Random`s, `jmath` (HotSpot-exact `Math`), positions, noise, density, paletted storage, `version.rs` (the pinned version) | +| `horizon-protocol` | Network protocol 777: codecs, framing, encryption, `packets/{handshake,status,login,configuration,play}.rs`, `entity_data.rs` | +| `horizon-assets` | Resource decoding: block-state and item models, baking, atlases | +| `horizon-prepare` | Builds `.local/horizon-client/26.3` from the player's own Minecraft install (runs the Java exporters) | +| `horizon-server` | `horizon-server`: `server.toml`, CLI, supervisor of the headless game ([docs/hosting.md](docs/hosting.md)) | +| `horizon-server-files` | `server.properties`, eula, ops/whitelist/bans, usercache | +| `horizon-friends`, `horizon-relay` | Play with Friends: invite codes, encrypted tunnel, the relay ([docs/play-with-friends.md](docs/play-with-friends.md)) | +| `horizon-shaderpack` | OptiFine/Iris packs: preprocessor, GLSL → WGSL ([docs/shader-packs.md](docs/shader-packs.md)) | +| `horizon-mods`, `horizon-mod-sdk`, `cargo-horizon-mod` | Sandboxed WebAssembly mods: runtime, SDK + WIT, `cargo horizon-mod` ([docs/mods.md](docs/mods.md)) | +| `horizon-port-pack` | Porting Java modpacks ([docs/modpacks.md](docs/modpacks.md)) | +| `horizon-theme` | Design tokens and fonts for the launcher, the game's own menus and the website | +| `horizon-telemetry`, `horizon-telemetry-server`, `horizon-bench` | Opt-in data collection, its ingest server, the benchmark report format | +| `horizon-dualsense`, `horizon-threads`, `horizon-release-sign`, `horizon-bots`, `voxel-kernels`, `xtask` | DualSense output, thread priorities, signed release checksums, load-test bots, occupancy kernels, repo tasks | +| `launcher/` | GPUI launcher: `main.rs` (UI), `backend.rs` (installs, updates), `cli.rs`, `mcp.rs`, `*_page.rs` | + +Other top-level folders: `tools/` (harnesses and dev scripts), `tests/` (Python unit tests: `python3 -m +unittest discover -s tests`), `mods/horizon/src/test/java/dev/horizonlab/parity/` (Java oracles), +`website/` (playhorizon.dev; its paths are relative to `website/`), `docs/`, `.github/workflows/`. + +## Build and test fast + +```sh +python3 tools/pr_ready.py # the self-check: fmt, clippy -D warnings, touched crates' tests, harnesses; paste its block in the PR +python3 tools/pr_ready.py --quick # same without harnesses +cargo test -p horizon-client --lib --bins --tests # skips the 104 examples (pr_ready does this); `--doc` separately +cargo build --profile fast -p horizon-client # optimized, quick to link: use it to play or run lan_e2e +python3 tools/parity.py --changed origin/main # the harnesses your branch can affect (CI's parity job) +python3 tools/parity.py --changed-files paths.txt --list # which harnesses cover these files, without running them +python3 tools/parity.py mob_ai sculk # named harnesses +python3 tools/lan_e2e.py --check chest # two real games over LAN (host in-frame); --server-thread for the host on its server thread +python3 tools/agent_control_e2e.py # horizon-ctl / MCP end to end +``` + +- Harnesses and the game need the vanilla data in `.local/` (`minecraft/`, `horizon-client/26.3`, `datagen/`, + `tools/`): see [docs/parity-workflow.md](docs/parity-workflow.md). Without it, pr_ready lists the + harnesses for CI. +- A harness = `tools/test__parity.py` (324 of them) + a Java oracle (`mods/horizon/src/test/java/dev/horizonlab/parity/Vanilla*Oracle.java`) + + a Rust probe: `crates//examples/_{probe,fixture}.rs` (horizon-world 175, horizon-client 104), + or the game binary with a fixture env var (`game/dispense_fixture.rs`, `game/sculk_fixture.rs`, + `game/command_harness.rs`, `game/net_harness.rs`). Copy a nearby harness for a new one. +- Probes build into `.local/parity-target/`; harnesses find binaries via `lab.cargo_target()`, never `target/`. +- What a change reruns (of 329 harnesses, measured 2026-10-23): a file of the game binary (`game.rs`, `game/`) + ~25, a file of the client lib ~103, of `horizon-world` ~103–109, of `horizon-core` ~119. Plan for it. +- Rust integration tests: `crates/horizon-client/tests/` (`lan_bot.rs`, `generation_saves.rs`, `streaming_meshes.rs`). +- **macOS:** `cargo build/test --workspace` may fail to link the two wasm guest cdylibs (undefined + `horizon:mods/events` symbols) until #1446 lands: add `--exclude coords-hud --exclude horizon-mods-test-guest`. + Their real check is `cargo test -p horizon-mods` (builds them for `wasm32-unknown-unknown`). +- Linux needs `libasound2-dev libudev-dev`; `--no-default-features` drops audio and controllers (the server build). +- Run and drive the game (starts the `horizon-client` beside `horizon-ctl`; other arguments go to the game): + `target/fast/horizon-ctl --socket $PWD/ctl.sock launch --world W --creative --offscreen --wait --resources $PWD/.local/horizon-client/26.3`, + then `horizon-ctl --socket … state|keys|turn|command|screenshot|quit` + ([docs/horizon-ctl-commands.md](docs/horizon-ctl-commands.md)). + +## Vanilla reference + +- Decompiled sources: `.local/minecraft/26.3/sources/{client,server}/` (`python3 tools/lab.py decompile`). +- Bytecode queries (callers through lambdas, every overload): + `python3 tools/rea_vanilla.py method net.minecraft.world.level.block.DispenserBlock dispenseFrom` + ([docs/decompilation-status.md](docs/decompilation-status.md)). +- A harness runs the oracle against the real 26.3 jars and the Rust probe on the same inputs, then compares + their JSON. Oracle runs are cached by `tools/parity_shim.py`; `--fresh` reruns them. +- Mirror vanilla's `Math` calls with `horizon_core::jmath`, and vanilla's RNG with `horizon_core::random`: + random draws must happen in vanilla's order. + +## horizon-client: where things live + +`L:` = lib (`crates/horizon-client/src/`), `G:` = bin (`crates/horizon-client/src/game/`). The lib can't see +`Game`; bin code reaches the lib as `horizon_client::`. + +| Subsystem | Files | +|---|---| +| Game loop, tick, frame | `game.rs`: `fn run`, `impl ApplicationHandler for Game` (`window_event`, `about_to_wait`), `fn tick`, `fn tick_world`, `fn render`; L: `clock.rs`, `window.rs`, `spans.rs` | +| Rendering | L: `gfx.rs` (`Renderer::new`, `Renderer::render`), `gfx/` (cull, occlusion, translucency, upload, timing, lod, weather, stars, end_sky), `*.wgsl`, `particles.rs`, `block_entity_render.rs`, `item_render.rs`, `fog.rs`, `clouds.rs`, `camera.rs`, `first_person.rs`; G: `render_tick.rs`, `item_draw.rs` | +| Chunks, streaming, light | L: `streaming.rs` (worker pool: generate, light, mesh), `world.rs`, `chunk.rs`, `chunk_map.rs`, `light.rs`, `mesher.rs` + `mesher/`, `vanillagen.rs` (binds horizon-world's generator), `lod.rs` + `lod/`, `ticket_levels.rs`; G: `world_loading.rs`, `postprocess.rs`; game.rs `fn update_world` | +| World generation | `crates/horizon-world/src/worldgen/` (`generator*.rs`, `feature_graph.rs`, `structure/`, `carver/`) | +| Block behaviour | `crates/horizon-world/src/level/` (`mod.rs`, `tick.rs`, `hooks.rs`, `redstone.rs`, `place.rs`, `interact.rs`); game.rs `fn tick_blocks`, `fn process_level_events` | +| Mobs | L: `mobs.rs` (types), `mobs/` (`ai.rs`, `goals.rs`, `brain.rs`, `*_brain.rs`, `nav.rs`, `path.rs`, `species.rs`, `spawning.rs`, `render.rs`, `anim.rs`); G: `creatures.rs` (ticking, spawning, mob events), one file per mob family (`dragon.rs`, `wither.rs`, `villagers.rs`, `piglins.rs`, `golems.rs`...), `natural_spawning.rs` | +| Other entities | L: `entities.rs`, `projectiles.rs`, `arrows.rs`; G: `boats.rs`, `minecarts.rs`, `mounts.rs`, `armor_stands.rs`, `paintings.rs`, `frames.rs`, `fireworks.rs`, `tnt.rs`, `explosion.rs` | +| Player actions | game.rs (`fn use_hand`, `fn use_item`, `fn attack`, `fn tick_mining`, `fn break_block`); G: `hand.rs`, `combat.rs`, `consume.rs`, `potions.rs`, `shield.rs`, `crossbow.rs`, `trident.rs`, `fishing.rs`; L: `motion.rs` + `motion/` (movement), `collisions.rs`, `items.rs`, `item_data.rs` | +| Inventory and containers | L: `menu.rs` (`AbstractContainerMenu.clicked`), `container_screen.rs`, `containers.rs`, `creative.rs`, `crafting.rs`, `recipe_book*.rs`, `stations.rs`, `merchant.rs`; game.rs `fn menu_ops`, `fn click_inventory`; G: `stations.rs`, `trading.rs`, `recipe_book.rs`, `machines.rs` | +| Commands | parse: L: `command/` (`args.rs`, `selector.rs`, `tree_*.rs`, `vanilla.rs`); run: G: `commands.rs` (dispatch) + `commands/*.rs` (`admin`, `execute`, `items`, `players`, `world_cmds`...); L: `scoreboard_cmd.rs`, `data_cmd.rs`, `nbt_path.rs`; G: `functions.rs`, `command_blocks.rs` | +| UI screens | `Screen` enum in game.rs; L: `title.rs` + `title/`, `options_ui.rs`, `multiplayer.rs`, `pack_screen.rs`, `graphics_ui.rs`, `screen_draw.rs`, `ui.rs` (widgets), `hud.rs`, `hud_layout.rs`, `hud_overlays.rs`, `chat.rs`, `tab_list.rs`; G: `startup_menu.rs`, `screens.rs` (pause, death), `options.rs`, `lan_screen.rs`, `chat.rs`, `sign_edit.rs`, `books.rs` | +| Multiplayer client | L: `net.rs` (network thread); G: `remote.rs` (`fn handle_packet`, `fn tick_remote`), `remote_*.rs` (mob data, objects, projectiles, vehicles, stations) | +| LAN host / server side | L: `lan/` (`conn.rs` handshake + login threads, `hub.rs` + `hub/` play state, `chunks.rs`, `entity.rs`, `tracking.rs`, `guest.rs`, `playerdata.rs`); G: `lan.rs` (`LanHost`), `lan_actions.rs` (`fn as_guest`, `fn tick_guests`), `lan_*.rs` per feature, `lan_entities.rs` (tracked entities) | +| Integrated server | G: `integrated.rs` (the server thread), `levels.rs` (one level per dimension, `fn tick_server`), `server_travel.rs` | +| Dedicated server | G: `dedicated.rs`, `dedicated/status.rs`; crates `horizon-server-files`, `horizon-server` | +| Save and load | L: `save.rs` (level.dat, regions, playerdata), `entity_nbt.rs`, `block_entity_nbt.rs`, `options_file.rs`; G: `saving.rs`, `persist.rs` (entities); `crates/horizon-world/src/{region.rs,nbt.rs,datafix/}` | +| Input | game.rs `fn window_event`, `fn key_pressed`, `fn play_mouse`; L: `keybinds.rs`, `keymapping.rs`, `key_names.rs`, `mouse.rs`, `input.rs`, `interaction_input.rs`, `gamepad.rs`, `osk.rs`, `clipboard.rs`; G: `pad.rs`, `pad_menu.rs` | +| Audio | L: `audio.rs` (mixer), `sound_engine.rs`, `sound_events.rs`, `music.rs`, `ambience.rs`; G: `music.rs`, `subtitle_hud.rs` | +| Resource packs | L: `packs.rs` + `packs/`, `pack_screen.rs`, `atlas_sources.rs`, `sprites.rs`, `mipmap.rs`, `model_library.rs`, `font.rs`, `lang.rs`; crate `horizon-assets`; G: `packs.rs` | +| Shader packs | L: `shader_pack.rs` (Horizon WGSL packs), `java_pack.rs` + crate `horizon-shaderpack` (Iris/OptiFine), `gfx/pack_stages.rs`, `gfx/java_stages.rs`; G: `shader_packs.rs` | +| Agent control | L: `control.rs` (socket), `bin/horizon-ctl/`; G: `control.rs`, `agent.rs`, `events.rs`, `ui_control.rs` ([docs/agent-control.md](docs/agent-control.md)) | +| Mods | crate `horizon-mods`; G: `mods.rs`; L: `mod_content.rs`, `mod_list.rs` | +| Horizon extras, settings | L: `extras.rs`, `graphics.rs`, `settings.rs`, `minimap.rs`; G: `extras.rs`, `tweaks.rs`, `options.rs` | + +## How `Game` is organised + +- `struct Game` (game.rs, ~290 fields) holds everything. Its methods are spread over ~180 files: game.rs keeps + the core (tick, render, input, inventory, world open/close) and each `game/.rs` adds an + `impl Game<'_>` block for one feature, with its own state types. Fields are private to the bin. +- Find a feature's code: `grep -rn "fn tick_\|fn _" crates/horizon-client/src/game*`; + the file is usually `game/s.rs`. Who calls it: grep the name in game.rs's `fn tick` / `fn tick_world`. +- Fields that say which mode runs: `remote` (this window is a client of a server: multiplayer, LAN guest, or + single player on its server thread), `lan` (`LanHost`: this world is open to the network), `integrated` + (the window's own server thread), `serving` (this `Game` *is* that server thread), `options.dedicated`. + `fn tick` returns `tick_remote()` when `remote` is set; nothing else of the local simulation runs. +- A server's players run through the same gameplay code as the local player: `as_guest` swaps the guest's + state (position, inventory, mode, mining, item use) into `Game` for one call (`game/lan_actions.rs`), and + `levels.rs` swaps whole dimensions in the same way. Changes reach clients through the block log, level + events and the entity tracker (`lan/tracking.rs`, `game/lan_entities.rs`). +- Shared read-only data: `Resources` (`res`: blocks, items, recipes, mob types, biomes) and `PackResources` + (`pack`), both in game.rs. + +## The two single-player paths + +1. **In-frame (default since #1428):** the window's `Game` ticks the world itself, one level that follows + the player (`fn enter_dimension`). This is what Stable players run and what harnesses test. +2. **Server thread (`--server-thread` or `HORIZON_SERVER_THREAD=1`):** `game/integrated.rs` runs a second + `Game` (`serving`) on a "Server thread" with one level per dimension; the window joins it as a client + through memory (`remote`), exactly as a LAN guest or a dedicated server's player does. Not at parity yet: + open `[server-thread]` issues list the gaps. + +LAN guests and dedicated servers always use the server code, so a fix there serves both. Test both paths +when you touch player-facing gameplay: + +```sh +cargo run --profile fast -p horizon-client -- --resources .local/horizon-client/26.3 --world T # in-frame +cargo run --profile fast -p horizon-client -- --resources .local/horizon-client/26.3 --world T --server-thread # server thread +python3 tools/lan_e2e.py --check # host in-frame, guest is a server client +python3 tools/lan_e2e.py --server-thread --check # host on its server thread (portals, levels, distance, lava need it) +python3 tools/parity.py dedicated_server server_entities server_player_damage +``` + +## Docs worth knowing + +[docs/parity-workflow.md](docs/parity-workflow.md) (runner, gate, shards, scopes) · +[docs/native-client.md](docs/native-client.md) (options, controls, horizon-ctl) · +[docs/server-levels.md](docs/server-levels.md) (levels per dimension) · +[docs/rust-parity.md](docs/rust-parity.md) (what is ported) · [docs/known-issues.md](docs/known-issues.md) · +[docs/release-flow.md](docs/release-flow.md) · [docs/README.md](docs/README.md) (index). diff --git a/CLAUDE.md b/CLAUDE.md new file mode 120000 index 000000000..47dc3e3d8 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1 @@ +AGENTS.md \ No newline at end of file diff --git a/docs/README.md b/docs/README.md index b4398ebfc..2e06b6e89 100644 --- a/docs/README.md +++ b/docs/README.md @@ -4,6 +4,7 @@ To play, use [the launcher](../launcher/README.md); the project site is [playhor ## Build and run +- [AGENTS.md](../AGENTS.md) and [Architecture](architecture.md): where each part of the code lives, how `Game` is organised, which harness checks which area. - [Build from source](../README.md#build-from-source): your own copy of the game, resource preparation, `cargo run`. - [Native client](native-client.md): options, controls, the dedicated server, `horizon-ctl` scripting, packaging, architecture. - [Host a server](hosting.md): install `horizon-server`, prepare the game files, first run, `server.toml`, the commands, the web panel, backups, services and Docker; what works today and what doesn't yet. diff --git a/docs/architecture.md b/docs/architecture.md new file mode 100644 index 000000000..99e9b630e --- /dev/null +++ b/docs/architecture.md @@ -0,0 +1,57 @@ +# Architecture: feature → files → checks + +The 40 areas changed most often in the 30 days to 2026-10-23 (commits on main touching the area; `game.rs` is +counted only for the game loop because nearly every gameplay change touches it). The crate map, how `Game` is +organised and how to build and test are in [AGENTS.md](../AGENTS.md). + +Paths: `L/` = `crates/horizon-client/src/`, `G/` = `crates/horizon-client/src/game/`, `W/` = +`crates/horizon-world/src/`. Checks: a bare name is a harness (`python3 tools/parity.py `, script +`tools/test__parity.py`); `lan_e2e ` is `python3 tools/lan_e2e.py --check `. + +For the full set of harnesses a file can affect, ask the runner: +`printf '%s\n' > /tmp/p.txt && python3 tools/parity.py --changed-files /tmp/p.txt --list`. +Any file of the game binary (`game.rs`, `game/`) selects the ~25 harnesses that run the binary; a client lib +file selects ~103. + +| # | Area (commits) | Files | Checks | +|---|---|---|---| +| 1 | Game loop, tick order, frame pacing (554) | `L/game.rs` (`fn tick`, `fn tick_world`, `fn render`, `about_to_wait`), `L/clock.rs`, `L/window.rs`, `L/spans.rs` | game_loop, frame_limiter, interaction_input, tick | +| 2 | Mobs in the game loop, spawning (166) | `G/creatures.rs`, `G/natural_spawning.rs`, `L/mobs/spawning.rs`, `L/mobs/spawn_rules.rs`, `L/mobs/spawn_selection.rs`, `L/mobs/finalize.rs`, `G/spawner.rs`, `G/trial_spawner.rs` | natural_spawn, spawn_rules, finalize_spawn, spawner, trial_spawner, mob_ai | +| 3 | World save and load (163) | `L/save.rs`, `G/saving.rs`, `G/persist.rs` (entities), `L/entity_nbt.rs`, `L/block_entity_nbt.rs`, `W/region.rs`, `W/nbt.rs` | save_roundtrip, world_reopen, world, datafix | +| 4 | World generation (153) | `W/worldgen.rs`, `W/worldgen/` (`generator*.rs`, `feature_graph.rs`, `structure/`, `placement/`), `L/vanillagen.rs` | chunk_generation, worldgen, server_world_gen, world_spawn, feature_graph, feature_placement, decoration and the other worldgen harnesses | +| 5 | Multiplayer client, packets in (145) | `G/remote.rs` (`fn handle_packet`, `fn tick_remote`), `G/remote_*.rs`, `L/net.rs` | dedicated_server, server_entities, lan_e2e (all) | +| 6 | Agent control, horizon-ctl (145) | `L/control.rs`, `L/bin/horizon-ctl/`, `G/control.rs`, `G/agent.rs`, `G/events.rs`, `G/ui_control.rs` | `python3 tools/agent_control_e2e.py`; `cargo test -p horizon-client --bin horizon-ctl` | +| 7 | CI and release (134) | `.github/workflows/` (`ci.yml`, `parity.yml`, `release.yml`, `launcher.yml`), `tools/ci/`, `tools/parity.py`, `tools/pr_ready.py` | `python3 -m unittest discover -s tests`; actionlint (`.github/actionlint.yaml`) | +| 8 | LAN host: connections, play state, tracking (133) | `L/lan/` (`conn.rs`, `hub.rs` + `hub/`, `chunks.rs`, `entity.rs`, `tracking.rs`, `guest.rs`, `playerdata.rs`), `G/lan.rs` | lan, lan_e2e (all), `cargo test -p horizon-client --test lan_bot` | +| 9 | Renderer core (132) | `L/gfx.rs` (`Renderer::new`, `Renderer::render`), `L/gfx/` (cull, occlusion, translucency, upload, timing, lod) | client_graphics, culling_rays, translucency; `horizon-client --benchmark standard` | +| 10 | Launcher (124) | `launcher/src/` (`main.rs`, `backend.rs`, `cli.rs`, `mcp.rs`, `servers_page.rs`) | `cd launcher && cargo test`; `python3 tools/launcher_mcp_e2e.py` | +| 11 | Mob types and species (117) | `L/mobs.rs`, `L/mobs/species.rs`, `L/mobs/data.rs`, `L/mobs/living.rs`, `L/mobs/drops.rs`, `L/mobs/gear.rs` | mob_attributes, entity_attribute, entity_death_loot, mob_ai | +| 12 | Guests' actions on a server (98) | `G/lan_actions.rs` (`fn as_guest`, `fn tick_guests`), `G/lan_{attributes,pvp,chat,crafting,stations,trading,mount_menu,waypoints}.rs` | server_player_combat, server_player_damage, server_player_targets, lan_e2e (all) | +| 13 | Modpack porting, mod content (97) | `crates/horizon-port-pack/`, `L/mod_content.rs`, `tools/port_*.py`, `packs/` | `cargo test -p horizon-port-pack`; `python3 tools/mod_port_harness.py` | +| 14 | Mob AI (96) | `L/mobs/ai.rs`, `goals.rs`, `brain.rs`, `*_brain.rs`, `nav.rs`, `path.rs`, `control.rs` | mob_ai (probe `examples/mob_ai_probe.rs`; known failure on main: drowned_*, #290) | +| 15 | Items and item use (96) | `L/items.rs`, `L/item_data.rs`, `G/hand.rs`, `G/consume.rs`, `G/potions.rs`, `L/effects.rs`; game.rs `fn use_hand`, `fn use_item` | use_item_on, item_use, item_use_lifecycle, consumable, consume_effect, status_effect | +| 16 | Options and settings screens (93) | `L/options_ui.rs`, `G/options.rs`, `L/settings.rs`, `L/options_file.rs`, `L/graphics_ui.rs`, `L/graphics.rs` | options, toggle_keys | +| 17 | HUD, chat, tab list (93) | `L/hud.rs`, `L/hud_layout.rs`, `L/hud_overlays.rs`, `L/chat.rs`, `G/chat.rs`, `L/tab_list.rs`, `L/locator_bar.rs`, `G/locator_bar.rs` | hud, tab_list, locator_bar, chat_screen, secure_chat | +| 18 | Command execution (88) | `G/commands.rs`, `G/commands/*.rs`, `L/scoreboard_cmd.rs`, `L/data_cmd.rs`, `G/functions.rs` | command_exec (corpus `tools/command_exec_corpus.py`), scoreboard, server_ops_feedback, lan_e2e commands | +| 19 | Chunk streaming, light, tickets (85) | `L/streaming.rs`, `L/world.rs`, `L/chunk.rs`, `L/chunk_map.rs`, `L/light.rs`, `L/ticket_levels.rs`, `L/tick_chunk_membership.rs`, `G/world_loading.rs` | light, chunk_status, random_tick_sections; `cargo test -p horizon-client --test streaming_meshes` | +| 20 | Mob models and animation (78) | `L/mobs/render.rs`, `L/mobs/anim.rs`, `L/mobs/body_anim.rs`, `L/mobs/keyframes.rs`, `L/entity.wgsl` | entity_model | +| 21 | Block behaviour, server side (78) | `W/level/` (`mod.rs`, `tick.rs`, `hooks.rs`, `data.rs`, `redstone.rs`, `place.rs`), `G/block_entity_ticks.rs`, `G/moving_pistons.rs` | block_update, redstone, random_tick, simple_block, piston_movement, block_entity_tickers | +| 22 | Player movement and collision (75) | `L/motion.rs` + `L/motion/`, `L/collisions.rs`, `W/entity_move.rs`, `W/player_travel.rs`, `W/collision.rs` | collision, entity_move, player_travel, living_motion, climbing, swimming; `python3 tools/test_native_scene_motion.py` | +| 23 | Resource packs and models (65) | `L/packs.rs` + `L/packs/`, `L/pack_screen.rs`, `L/atlas_sources.rs`, `L/sprites.rs`, `L/model_library.rs`, `G/packs.rs`, `crates/horizon-assets/` | resource_pack, pack_selection, pack_screen, model_resolution, item_model, mipmap | +| 24 | Container menus and inventory (61) | `L/menu.rs`, `L/container_screen.rs`, `L/containers.rs`, `L/creative.rs`; game.rs `fn menu_ops`, `fn click_inventory` | menu_click, container_screen, creative, lan_e2e containers clicks | +| 25 | Workstations (60) | `L/stations.rs`, `G/stations.rs`, `L/enchant.rs`, `L/brewing.rs` | enchanting, screen_layout, lan_e2e brewing loom stonecutter grindstone anvil smithing | +| 26 | Crafting and the recipe book (59) | `L/crafting.rs`, `L/recipe_book.rs`, `L/recipe_book_screen.rs`, `G/recipe_book.rs`, `G/machines.rs`, `G/machines/crafter.rs` | recipe, recipe_book, recipe_book_view, place_recipe, ghost_recipe, crafter | +| 27 | Vehicles and mounts (54) | `G/boats.rs`, `G/minecarts.rs`, `G/mounts.rs`, `G/mount_menu.rs`, `G/llamas.rs`, `G/passengers.rs` | server_entities, lan_e2e boats minecarts riding mounts | +| 28 | Villagers, trading, raids (50) | `L/mobs/villager*.rs`, `L/merchant.rs`, `G/trading.rs`, `G/villagers.rs`, `L/raid.rs`, `G/raids.rs`, `L/gossip.rs` | trading, raid, mob_ai | +| 29 | Title, worlds, startup (49) | `L/title.rs` + `L/title/`, `G/startup_menu.rs`, `L/title_edition.rs` | world_options; `cargo test -p horizon-client --lib title` | +| 30 | Dedicated server, horizon-server (48) | `G/dedicated.rs`, `G/dedicated/status.rs`, `crates/horizon-server/`, `crates/horizon-server-files/` | dedicated_server, server_files, user_cache, online_mode, server_ops_feedback | +| 31 | Particles and client effects (46) | `L/particles.rs`, `G/render_tick.rs`, `G/level_particles.rs`, `L/animate_tick.rs` | particle_providers, block_particles, entity_particles, emitter_particles, marker_particles | +| 32 | Bosses and the End (45) | `G/dragon.rs`, `G/wither.rs`, `G/end.rs` | server_dragon, end_podium, end_gateway | +| 33 | Protocol and packets (44) | `crates/horizon-protocol/src/` (`packets/play.rs`, `entity_data.rs`, `connection.rs`) | dedicated_server, online_mode, secure_chat; `cargo test -p horizon-protocol` | +| 34 | Multiplayer and LAN screens, friends (44) | `L/multiplayer.rs`, `G/lan_screen.rs`, `G/friends.rs`, `L/friends_screen.rs`, `crates/horizon-friends/`, `crates/horizon-relay/` | lan, world_options; `python3 tools/test_friends.py` | +| 35 | Dispensers (43) | `G/dispenser.rs`, `G/dispense_fixture.rs` (the harness side) | dispenser | +| 36 | Audio and music (38) | `L/audio.rs`, `L/sound_engine.rs`, `L/sound_events.rs`, `L/music.rs`, `G/music.rs`, `L/ambience.rs`, `G/subtitle_hud.rs` | sound_engine, sound_event, music, situational_music, ambient_sound, subtitle | +| 37 | Integrated server and levels (34) | `G/integrated.rs`, `G/levels.rs`, `G/server_travel.rs` | server_dimension_players, `lan_e2e --server-thread` (portals, levels, distance, lava) | +| 38 | Command parsing (34) | `L/command/` (`args.rs`, `selector.rs`, `tree_*.rs`, `vanilla.rs`) | command_parse (corpus `tools/command_parse_corpus.py`) | +| 39 | Benchmarks and telemetry (34) | `L/benchmark.rs`, `tools/perf_bench.py`, `L/telemetry.rs`, `crates/horizon-telemetry*/`, `crates/horizon-bench/` | `python3 -m unittest tests.test_perf_bench`; [benchmark.md](benchmark.md) | +| 40 | Explosions and TNT (31) | `G/explosion.rs`, `G/tnt.rs` | lan_e2e blast; no dedicated harness yet | From 1960dc6eb26600d32145eecece3d494ee4f9d019 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 23 Oct 2026 16:30:31 +0200 Subject: [PATCH 126/126] AGENTS.md: agents never add release-now Co-Authored-By: Claude Opus 5.5 --- AGENTS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index d869aed2a..9534fba83 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -21,7 +21,7 @@ Feature → files → harness for the most-changed areas: [docs/architecture.md] - Horizon-only features follow [docs/design-system.md](docs/design-system.md) and are off by default where they would change the vanilla look. - Small PRs (< ~500 lines). Labels: `feature` (players get something new), `skip-release` (they see no - change), none for a fix, `release-now` for crash fixes. Every merge to main ships + change), none for a fix. Agents never add `release-now`: the maintainer decides it. Every merge to main ships ([docs/release-flow.md](docs/release-flow.md)). - Contributors first: `gh pr list --state open --search ` before you start; never duplicate theirs.