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 01/64] 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 02/64] 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 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 03/64] 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>>>>; @@ -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, block: Option| { + 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 = (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 04/64] 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 = std::result::Result>; + +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 = 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 { + 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::>()?; + 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::()}) + ); + // 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 05/64] 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 { 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 06/64] 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 { - 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 { + 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 { + 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::() 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::() 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 = (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::() 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 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 07/64] 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> { 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::().unwrap(); @@ -38,6 +39,13 @@ fn main() -> Result<(), Box> { 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, // entity.vsh's lightMapColor, multiplied in after the overlay. @location(9) light_color: vec4, + @location(10) @interpolate(flat) weather_rect: vec4, } // Shipped light.glsl; normals are already transformed and RGBA8_SNORM packed. fn entity_light(normal: vec3, 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 { 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, n: u32) -> vec2 { + 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, b: vec2) -> vec2 { + let lo = a.x + b.x; + return vec2(lo, a.y + b.y + select(0u, 1u, lo < a.x)); +} +fn weather_sub64(a: vec2, b: vec2) -> vec2 { + return vec2(a.x - b.x, a.y - b.y - select(0u, 1u, a.x < b.x)); +} +fn weather_double_plus_float(base: vec2, 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(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; + 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(sign | (u32(exponent + 127) << 23u) | (mantissa & 0x7fffffu)); +} +fn weather_phase(animation: vec4, bases: vec4, snow: u32, time: vec4) -> vec2 { + 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, rect: vec4, dimensions: vec2) -> vec2 { + let size = vec2(dimensions); + let origin = vec2(round(rect.xy * size)); + let extent = max(vec2(round(rect.zw * size)), vec2(1)); + let local = min(vec2(floor(fract(uv) * vec2(extent))), extent - vec2(1)); + return origin + local; +} +// WEATHER_MATH_END + +struct WeatherTime { values: vec4 } +@group(1) @binding(1) var weather_time: WeatherTime; +@vertex fn vs_weather(@location(0) position: vec3, @location(1) uv: vec2, + @location(2) rect: vec4, @location(3) animation: vec4, + @location(4) bases: vec4, @location(5) color: vec4, + @location(6) light: vec4, @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 { + // 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) { + fn weather_geometry( + &mut self, + camera: glam::DVec3, + alpha: f64, + ) -> Vec { 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::() 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::()) 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, bases: vec4, time: vec4, uv: vec2, snow: u32, pad: u32 } +@group(0) @binding(0) var cases: array; +@group(0) @binding(1) var results: array>; +@compute @workgroup_size(64) fn main(@builtin(global_invocation_id) id: vec3) { + 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>(uv), vec2(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 { 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 08/64] 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, uv: vec2, @location(2) overlay: u32, @location(3) color: vec4, @location(4) light: vec4, @location(5) normal: vec4) -> 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, @location(1) uv: vec2, + @location(2) overlay: u32, @location(3) color: vec4, @location(4) light: vec4, @location(5) normal: vec4, + @location(6) offset: vec3) -> Out { + return entity_vertex(offset + position, uv, overlay, color, light, normal); +} struct CloudInfo { offset: vec4, colors: array, 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) { - 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 { + 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>, - /// 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 { + 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 { + 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 { + uv: Option<[f32; 2]>, + meshes: HashMap>, +} +impl Cache { + 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, + instances: Option, + 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 { + 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 { + 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::() 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> = 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 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 09/64] port-pack: check one mod jar (Works, Partly, Doesn't run) from its content and classes `horizon-port-pack check ` 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 --- 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, + /// What doesn't, with why. + pub skipped: Vec, + /// Required mods, by id. + pub depends: Vec, + /// The folder mod's namespaces (its id first): two mods on at once may + /// not share one. + pub namespaces: Vec, + 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 { + 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 = 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 { + 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::(); + if dropped > 0 { + skipped.push(plural( + dropped, + "structure processor written in Java", + "structure processors written in Java", + )); + } + let unsupported = wg.unsupported.values().sum::(); + 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, + /// Declared methods, by name (constructors and lambdas left out). + pub methods: Vec, + /// Every class the constant pool names (`net/minecraft/...`). + pub refs: BTreeSet, + /// 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 { + 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 = HashMap::new(); + let mut class_of: HashMap = 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 { + Some(self.take(1)?[0]) + } + fn u2(&mut self) -> Option { + let b = self.take(2)?; + Some(u16::from_be_bytes([b[0], b[1]])) + } + fn u4(&mut self) -> Option { + 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) -> 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 { + 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, + /// The game events it subscribes to, by simple name. + pub events: BTreeSet, + /// Blocks and items with behaviour, and the methods they override. + pub examples: BTreeMap>, +} + +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) -> Code { + let own: BTreeMap = 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 { + let mut pool: Vec> = Vec::new(); + let utf = |pool: &mut Vec>, 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>, 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 = 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 { + 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", + &["", "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::>(), + ["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 `: the coverage report, per mod ported, partial, not yet //! or not needed with the reason, in `/coverage.json` and //! `coverage.md`. +//! - `check `: one mod jar on its own, as the launcher's mod +//! browser installs it: carried over into `/carry/`, its classes +//! read, and the verdict (Works, Partly, Doesn't run) in +//! `/check.json`. //! - `port [--from ] [--resources ]`: 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 | inventory [--offline] | fetch [--from ] [...] | carry [--resources ] [...] | report | port [--from ] [--resources ]"; +const USAGE: &str = "usage: horizon-port-pack import | inventory [--offline] | fetch [--from ] [...] | carry [--resources ] [...] | report | check | port [--from ] [--resources ]"; fn main() -> ExitCode { let mut args: Vec = 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 ] [--resources ] ``` +`check ` 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 `/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 `/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 10/64] 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 --- 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, + /// 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, 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 = 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//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::(&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::(&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) { 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 { .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 { "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 11/64] 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// 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 . Co-Authored-By: Claude Opus 5.5 --- 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//` 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//` 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//`, 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 = 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, + /// What of a Java mod didn't port. + #[serde(default, skip_serializing_if = "Vec::is_empty")] + pub skipped: Vec, + /// A Java mod's namespaces: two installed mods never share one. + #[serde(default, skip_serializing_if = "Vec::is_empty")] + pub namespaces: Vec, } #[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, 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, 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 { .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//` 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 { + 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 { + 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 { + 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 { + 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 = 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//` 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, 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, + ) -> 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) -> Div { + /// The imported packs, above the Modpacks tab's search. + pub(super) fn imported_packs(&mut self, cx: &mut Context) -> 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, bool), Updates(HashMap<(SourceId, String), String>), + /// A Java mod's check: its jar read, or why it couldn't be. + Checked((SourceId, String), Result, String>), +} + +/// Where a Java mod's check is. +pub(super) enum Checking { + Running, + Done(Box), + Failed(String), } pub(super) struct Mods { @@ -50,6 +65,8 @@ pub(super) struct Mods { message: Option>, updates: HashMap<(SourceId, String), String>, confirm_remove: Option, + /// Java mods' checks, by source and project. + checks: HashMap<(SourceId, String), Checking>, tx: Sender, rx: Receiver, } @@ -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) { + let m = &mut self.mods; + let todo: Vec = 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 12/64] 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 --- 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::>()), + ("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 13/64] Launcher: test a Java mod's install, dependencies, id clash and removal offline Co-Authored-By: Claude Opus 5.5 --- 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 { + 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 14/64] 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 15/64] 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, mining: Option, creative: bool, + world: World, res: Resources, player: Option, audio: Audio, + hit: Hit, sequence: i32, packets: Vec, +} +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 { 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::>(), [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 16/64] 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 17/64] 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 --- 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 18/64] 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 19/64] 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, 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 { + 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, 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> { @@ -68,6 +72,7 @@ fn main() -> Result<(), Box> { 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 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 20/64] 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 { 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, /// Vertex ranges with another blend or depth/scissor state, in order. pub blends: Vec<(std::ops::Range, 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) -> Vec<(std::ops::Range, 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, + ) { + 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 21/64] 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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

HKJ1g<6>+)l=W zInx}yLoqeT#;#qv9d^I@w=h6Kv<$j*_>(%049`J829uT-kc7$xuD9&i)yX~P+mY>x zbE&@~%P9JNyxIY3FEoKV0)Ty5Bf2QUTs6RUalK4hFpnP3;g=|M|6%-ftwR~fyiYuY zt(`Ui&FRq;{pgIpW_#-pi(^kZ+fDz>qYnT_fT?r1Doxekz^E9yykXw~*aH$AAjpyR z{Mh5u;GP1A*h_+A{uAUklr^wxFfWd)_gxxK$SonG@=|Sl2B3z1Iyp}Q-Dkmt* zAlbiOs{fY>8*XFcu~yCw;{iz`|q24 zSrOXs@)FxpT7!$PQHDuaNIP<7GXV@19ps`)5!q%z*+hxl&$(nRvWAPHsYc&_?ND{~ z%C%YQ*nxiqInT^$tM&7+W!k&938X@~CjvbB|KED$P<8Fvb*zMPUu7AJ;F(Zo8Yr2$ z*98Cpr2+Vh5Ew@Vs@nj6^AZ|Kxsa?>3DHGBkTG79D3P@S`uQ{ff4m)KRNya~TF~!v zH4nQXMg&x{x9G9QCp-I=;E?8UjZ(uz6dZP2ZoX$9Jph5KSFc>DwyS{(q>bd*R@O!w z1V1=05j(oc{{2lrkPyw)Jxm55sP@3X^KfKf8dz&AXu;#gSJZkKKv4FJAsP&1j!;9< zkvY#GWgG-5+U*GXX84zSl0y8_9;c{rz-xmS#bJ@1{Y$U|0w*_c6}x7<{ix;-?awad z{Dli55J>kg;r-T+?>)Qs20$RKm8}ZqHKz63w08OHN~EU|qzj#oT|c=a|06&A1By@U zt83N4Ci-to6y8a2Iyl&uO@XH9`hp)tXog_MP}{D}3c{EwtKq{?Ju^61;8sll(CYd! zRni=w8^GHC=)76LV8H$^1qSa1pf5*kJrB_L{o~8kwX4^%6-@Vp=T1Lh?*!*wKG6oM zlk0Wv+}WhE9nOWVv6|r%+cWqPWo;iT$q3W#FrIxA_-BdmK|tliV*~t6yQtco(ae4b zQW`qqNNd)~_41N!!0$IS*n}*J1nT1xiH~j`wSi=iJ(68y%D>ivf59f5V5f}i@pVtx zjWNe*{fu=0{x!iGtY5AIPSMb|vm>9DdAne3@2b-8he>Qs8RK>AaZn-$dDNO1-A=v` zC*cLSt#av75Bw=}`j4w$SToJrSy^Q-UAoj4Eww)|J>W=Z`gHfe4YmM)2Pw!igTx6U2VT-$Bydu?c4mTib7K%0L~FzrO*%^ zH~<47zJ^3^oAc);qr1d4I7U@8U&2o()ZbS@7hBHf#|-;F~-wJ zBz4b*ybR4@fHRxx@co}mYpbjMk>E08k*7GgF9jSdReF)0gJoKUM5SU?N!BWgyk&e# zdJSe&9|HyfMhKa$1q?zT^^&=7aiA|oPL8NWHVsTP$VWU0=F2}7Nc zjBD(Ge>O1@i#=)8Tdy1r(#lf=&q(n!$TxG3Z^D3DJHIx=5$duO?e)hmOJZ6)nFSU# zS&Ymkz844JPov=u|4_cG$N>E1lX1KZY1uKHQh1o^*b__a9fj;(FHNJQ+|Tr&p9Zux zo_<|E^bWuXPZ|GD%?qfGyyJ|NN`>9F`S(Kh@4qj6?p;7Rf`OqBf;aXhjJhBa+4y(5 zdv&X0+rS4T!?q`@0ea8SSwM423+UqL0ubc!SmS-!XMg^&sB?jXq9(l9M0I8X z1|eaKYd>zh{yWf@zHk5jYs=NjxpQ6C1qb6eae4sCDK7_*`mzH6c&@KYS<)}#kK`7n zEj$p4E?3uyfVDEJaq{$^$#fh1YevlKT6j-1W$eCphPY>o^u}S72I^u+d|~)2zWq>g zv5fv#;W0$@KY4eV$i!htJT~6lffJoyXKY-ntSE1US(SDf?_TTv|J_-79Lg+^cHzcZ zL*PAjx02e5KeLv078u) zq94D2=pvHqTh9=Xgp!g2c!FsKfUUY@JJ;ocC8Y}xN=1#yIS6@Yl;RAo_bCE52^gG* z%6l%*hUg+a`rJ&-op}un0AOhf41vMU_5r{=DSedQx>{L@JE~j$dN|kMnuE+DK%U}Y zqz)AB*~5Ef?db!tG_t0%~1f_ztM9ND_ApmT?9><28YW>rp7C97yX!_o zX+lajyjvhJ1zWNz{(N&0WZeLP>qDkG}?N!S>A;xN#LJN4fr<^UndUy1B${RUwM*E z>avm|`OUXj>A)Yv*##VsvUV;C_(P;dkttiC+-ULNe~TFJm<(cDR)nwfl2SRuEEfLA z0ysrBcNZJNkbLY^ANb3qPuG;dA*4Fwcy#2A@hQ9rB=hYDafeQoEGQh#GfJ^@l4(4>l)&mE(Cd%k?^Y;_Z zJ1bvKgeJ7Se+LG)AkatuGMfnW6(` z_!Vr=2ym*fz?tvjD}$tKz+dN4lqN$e6#{=5;~;AY%?Ue83w6oyn8%C69z~Y1Z&rE? z(IsO+KP0=i|A6b(ksTD)reS`Y!l0k&J^i4JVBgz;a!FPW8<}VQ!khm+v|{SIdg#Co zFNyfp4W^CHJQ=|g>cmiRhaJOTDJxNMBHkh?-Tb7BFD~n!8X9cmx%@%WT6pbG6aC|v5}rH`sl2K=ajwG)#a85h&itn zazI18(00L(uwq|gFrB$XP-iI;vc|%x+XQOK`9y|+T=c#=dJmB@#`}7p$GN?1&p)xm z=zM4V`|?J2XC69Z$iN^L2hr0n`q;Pkel@_nB-#1>VFnLCpJQE}IX_jv2LoL$?#9x9 z$A`UAUIyCQ@rSbm2%3U!6o%I!j7%)CG7+HDh|~n?(B6R-NI_-u+oON@)Fb=wX0bsO z2~bpk!kxQzj(`8+)LLQ}i4B62un?h!?T2T(s7TJyU|pa-uUTv{J;O{>Bq6GnMCHbbB!Jy6TdVOh_ax~t6&DeF11uxlD(mLyhX-ry`L4w+)_pNS9d5DM{a&UyMO2?9$} zWkF*tF#hL~p9o+@si9{!v+o~E3c`RGQEZfxW;)0S^HrNpke9p`&z0Au%RT6qCt`Z| z3F7G&C6Ky5k)}XSv~3#?2onB2nV_Jp1MPt_fPwej zcc0Fx7En1*6}^~XcpCtrO(uL2zVcKDto-7GAXIM_FRkQURCNn|yZLe+C+21)z-ZHKRjvkEY*I25rfEa&|5pyTh-36y z?(RPo(MdE+w+Mypy;U_$i4QOr2v)8T1pYbonY(|;Pz_oU`fs>Ubm0i{0x2wLtxhfm zf+K~s;JM7YKE#jbt-oBE1Z%+*=3Nl*b6(Njd%Fewl;gc7PLEI5KSv8dLI)EX$*Z%} z^KPdNO~MfDSE4iPw;Y4?;UygqBvqksC<2%oI?~3^M(?sZ{wOJYgq74{0t9WRz71p~&Ypw2Yv z?ELufvp==`+M~fLTT*F-dXPI&=L;7uR1X{o?-6u80)@rGI?DXJ;eJ2?2y}-(RbL;p zceR(w=10}k`3>q1cLRZoh^h-j)20O0!R3uyx!AU{_||@SoCt8xS5O30t09ci$U&MGSJU8 z-(0@O`Ax#7oZLW01=0QYKOjDzz(7hDqTlF@)UYJ7X-W_Mif&-QeAXC$^6*z9uYSYE zL6~hy2!OzTEf~E4$zg@eU#2(uWD+pc>|(OM;GL03oA&F~k{@lkqVD~}jCdRjr+8)< zQmj&mM~kCD5B9ClrwRP9sTh+nlPo^|T0(ss%asxJEVc+YFH3?&c>ot)q@2$DkV4=4 zMYYJvq8CZkU)xqkv&hL*hOB#kY|&*kFlBP(XUL+?C}EK-hu(gz`8KYo?>htes6^=zWcjdqb3@<{LWx!pilv2Gqmal)M*^>~f%g zP2&Mb8KQ;*QFvs9+;ocjPD6Yyn*MAfr_?eS7;I0+j~;!&ZDHh;{rm3|j8h3Y>Wyio zHmwfzHnLeE^82kG5_M)zJ#sGt%6dtbL38WYEf%duJpd{7D8Td5rAzJqU;EnENL`-& z=04Rp-L-31`~T11r@+FR9_NYyH}yXFB?1iYK>~IbyCJ%85LBebL38Z`Xzit37$OU| z_XGBW!&KFaPwexMtU3vB8uISmy}SCS-!zw_cL}FH`*ZcwgI-i&`wJ2gz=o=vy|9JZ zw0`#2x$eL9^>rt33LOB*);WbL)xut-2mxAfSp-$M@6h~sTm;a!K#-5waFeZ& z)uk9X#?iR7OOcT#GKvGa=XW1YKkK?WcW&||gba|VcXtlpRA+)MKwfZvP!kMK_TV2k zZ)vV{JFl+NAJP5&#L3p9uiyMRBGHkA?UjdDlnT1|o`NvQWxod%Sb+3Kl*S~J&G%Z> z^rP6-IUZudI5jcj-Utek&_$>VwMQ4d0z(-tzm&G>1=Oev-zow^|RIC%0w;)U|Y$` z^UtmSpLuk$LvP={9S;QebcY15!+dlQ5Ngv-?pCH@89wnV&H;iv&*9M+MwvWvOmQ1_ zd>(*Rb3r`pPM`tFaDkB)*M3lq>#H|vX#onFW6PhmLli`!^0a8@&OSg#U01hm-Avzp zQR^=wdH@0&y8r&KCGEstedgf!;(zzO)%aI2wLSY&o46Khh#316 z9S1t#*ZmixHvsqrkB!O-V(4>(0KbWzd2C6DDx63lyX~}@9|s~K@=F1N9T?c9J$!IS z+_$~f=9xgg0Ss(_r2YH$x!@s%;U@xu<3J|v4-^E18GOrRG&0K=AUk(<-gO}mhyg3e zyzxKgT)fzUf%i9FfgteX)A47QJs>b=R@B&$ z7g3xSYuU(yjQ{vTcRc8ynq#$f;|=Hr6oKRw01EsU3gr>g0D%XyA^<0JPGk{xouaZY z2plAIOOoOI61*qmqC(~Z6XweZ4zjG$!9iR*C1DthvGnmRIVI#;9nVGtHROiQovspz?W2Lt~JKq*CfRW#$+t8*nDdX4y@!+ z9P?<5M$K5Va$K7k^wkzGrv#Zqz)vlP0)9Z=fG6T*sLXL={b4fpBV<{cVFUUpS#bFo zR6pO`0oeX!B~qp_33j{lGh}20pbV9dNE`SmZ9qZ>Igr{YdB0cr=y#`eyKK1cm$Y%C5B_D3VXlL@4x^4KBBR&TwT5U zzP=g4@4yP%3g!pYix*4uISEPmLU2$KN4)&+Ck<0FO?Dix=zZXsaV}~`J0C{FhfP6(tc?NOT z<>!zFApZz88l5wGGu<%HxkC)nF#-%TiN2Viv!6Ww=zgf|Z~pBvK0c6KNWdrnG_&)Ds}lzb>g$-ec51*QkvfGY& z?_R(iJ9f~=$gO?xmCKziioP4EyLzdzPTTi?PG|89b!L20%1sHMQ%R!Ig7=V{2$dus zHFpuXEI8%--cRsOO!g4;&!BT2f>7hMv~$PK_VIAPpI!o4h$jyN2&avZVYj=TE>HK5-lowh)xWqoKzy5lbQpdUsi!Va=!hflV5sR}UG{@EFAIt+y(fi$G(@NHGo z_{o5v^E4I^1oFAsDX3MV(U9bPWO^X5r^YLg8XP#=sixezsPckALduwHqpLW%8oFTL zC)k65gP7+3SD#sKJ!-<^!4{VU4>P?E0594WDhLpQKw#p)K#Tc6pnWuWxF3+?9?Yw9 zm?#Sb{xpaH%xPyQ2%uV)_aG#lk}79qi_F}>2sl_ojAS7EJ2)t{71Uox_srTP~PJsJf+`bNF$i4e&NmkjmSwH&jpVu z@{TaR(M5%)W%7|*U%xydm^8dyj|$EdlpT6(9(2Z9%h$@bp(;t-l#e$Ks_L7|_k=of z#{h$7q4Hq{2YO@;IX3FH3!jaDw$1Yjbma~}AbtWEn+s6g*ur5#bQ{=@dtIF9!k&KI ztRndmN96IcZte~Q3_;`$2%PBYAy5b;W*gY7%v@-Ke;f>hfBdBP28=Si!Fg01AQb8* zrNr=4iwJ8@IqDYeqDQFNY~^lK?AU?peHm%wpGwZ;_dZ-SYF%4!JH@B-U zih>%7%798jcG4z-S1_i9ZRY7@41Cz?AYbZHVfHf+%q|vDv_Pxk$D0Q+c0F=H1+J{l zlLmB5GAe|Yq>oId*MlVDLVkRulRi8uBpusxkiwjCrR&U#FvPMD1I+tvGyVRn=MJ&` zd+|bd+KVeY(1)LW4(bx#y@>*prpmatlQ=dHM@x@74yxv2u;Q@ni%*7jk)P}G#w7+* zrN$LAw?y#TFjp`5S*LsunUEh92BRc^ zznK8Q8Uf9mWWvOR?-e7AcJf+4)VPniQ&0yjaRYN3XfSM(jUfqKLGJRZ88DCnX=w$C zqbS{RduuR_JaT- zS~(Tmj5d_R=)+BY|M52i;6?y}f_S|q{kQ|#Kn4P3{=E?5X`F#h;K2ZjlLhxdYYxr| zSg$fk9FwY;^m*xgB*M5%`Jpzw3&26O9uia)S-(vK2bH(fw)th`b1KCjHHgdcFTuhr z6u`;@`DD)N9v`YPw1q%EDVqd>zW(&SX#VK6ig^I^9CsY{ye%21itqmJvdbasPC+Ws zGuneb%qMpo=w3Dq6Xkh0-$0lqp_UeMLfY}^U=Xd30ml`UU227xbp`_fDd2A`+bj6d z*$MPZ24FZ2Xn&vzPT9o4+u`uD0l)_IlQm&KXfizJ5u+a4NJoKIQ382UrmA-B+SQJO8_iuBqE7L0 z$axF!ChrHd*N(pI2cLaGgMd*ol^22qPpz-5S4&GS2>9(64|gCSTOVvZp+vq9t<)rd zFkUJp1ZP!K+<6&geC_-VLMSC)jARrjA6g7JVf9RzCwjJjkw?xAZrG~3d<&}FANSw=G$@44k9Ll`--@HB`!b*wNA$A zp4!39$0t1(>0Tp7-Nc;-dOZyJx!fRdOB4bVZW3Cf(n+krFZVTbhoEn!GRjdFI$1s6 zsAu?*(QZMxRaJew@_GB`H`~0WBJZtf! z+n!ab6hKIM*oD|BosjI=r!B@L;un#fFR(4+$SM6!As4J<5g2&s9(ykj4w77jtXN(z zM*XCQQhZav!KQ!fvcRCf+VeUIGSa>#r7{sY`Ij)5FB!;Zvbvj)0UOGR{FOPVjtJJ; z3a`q^k8+BZ$Fk8`jk-Vm-toiXT83CX5zB)i=QC2VNl3dFF=aury6y}-^vWetuJ#V_ zJZ_{O;gaP3h;NI~rX#qtV6M))+t*_4QiD-7DUEa1M6yXKTd>zpl|+u`&?AX7^Q3p1 zn=?$Ri9Nb!n_s+mp&O^xHp6H4;RyUuAF!}?rtCb*D~m20ronTXxWhj1nq{_oqy#c? zTbcfCyP8}ZKF438}wWHtBVX)$)vYEmDE8SXkTjR&Xo4#gVX(gQSb>h-{8KaG@5?-$9^07r(d6o1Yhdv zsTK&NWZAj^3~Q{c4FonX#Gn5196Jz2FvxrK>e2gj9ccy0Bov5}elkhDj8u!dPA>A! zsmrQdx!w^K)OfH{G96e7WRzHTkc>$HAjn^PHGmwGOM$QRWd2DdXK9p@3?eBL$j~j- znKg(2`I3}K^j3f~q}Lw4QxF8xaJg0W`ZN3Ff*`-Wd-seZer08iVUQ2DsmICqg3padk^u)JcUBgGb`7fK}z@UQ;+OZk;ff7 zdjO3A$S-ePR!3(e7txb$XW7GUYGwxDH6cF}J7$e_T+>CteEm<9t)F{6YV`<#s`)v|eZsXzMLkPikbns`6cK_rqNQ6Rb%wMpG) z{(XBPZU+SFT5zOk=W(I-V^)^+_4Cyd0RqO#In{dvHb5X(5~?3qczu1XI^ckSel}45 ze0xNYkO%w_Z6?{rDH>lwl|H&j;vuLt|7ZyWN8Ay~{uNi_J_Gi^-Ts zk`ds7gK2ZNp#I#ZmSvNsS-sFB#dGv;fdxxs0U9Qyg%?|g&CE?Q;|n8(e}o$Te%PkQ zWAEzq;q-wpR1tZ-VX(5|f6y)0W*)TRJ)Ea+igPtp_1>pn#6U!G%*EdwedpyP?f=)W z-^k=&nyen4MHB{X___H6xMX3H-tDG=a@LkkyxeSp8G` z*P}KNSjUZx*hsm~m2g9oD(&KnxYQs0{o4HxI2v`w3N=EINyYm}ceql8k*JKCrv2`2^tK}LHu+jOzfer|i!AW@?Id$gq76c?+`bE9t$K?6-;aKni z`k1*Om+wJ;vSVICbTdmW2?78XPDvllFN+T%W39>Z)~iRVAN~BSKX`>g?%$H>BY}fB za43C+oZbaje@!;sCS#w2MaRCio;6pe*g1G66hmSULLOx%l1y{5NJj_YBi<>;f;|P@X%F;o z3x=EIO9IG}#L-0>hhf$Yzl(|XBLlV2YWshLZQ80Q^^t8PQrW<{%8s>AADx$Vt&>v} z)g?@zZmnt8NkS)s%weltUVQQ(tzUa}0SHz#-hNh4j9%+77j+DkSQF{>&!0!uH49Ez zN2I&IvfpJUkeb%tLrH3Rqv{*%{vtlkP^W1r??%XT-SkI*Lk$TvsZ|yQ5Okm>Dzske zabI3AR+a>GKv1hYqo=lM)NxS19EUCeU?SdDjBGB=F~(CZ7V=iR7&I+-j2tcJZ9cRf zApk>`+?H<1b?u^~jBpKubG$Ka69+WuWvpjH6;mT7bITdgkk2wK#Bme2@pq zmZaBMqns$f4nv*~B4hcW<#}nU>c_trfIzVA{l|6es#B;P1Sy44RhKvOE9R(rfsBc4 z`1xN(i#hd=<*mFUV))NBWRrou5;-JwczsbXfy21g$T0l;Qht^yu=C7tVd zfDb=P6%+-Jdgah`pOg`SJ(wSvn%D+}olMbpUODWj-<+i2^+5-x4(c`Z{^`%7*wMOZ z6aoSHlqV^i%TmCWR@3yRDp84bF-QA*pauB|yB z;A>CqhsurYW3}$H@7=q%^*WTcE3ZG@>ykm+(2rgK?YVbP_4n`E$EB&w2LL+3QI_RzX`C zq8SQ;TJJwoRjaEj`TS@RMB=>tQEpf=oFak0H(!0Qx^~S!UM<4~`Vl>eXoGT~J$v?y zIc(rBnoPWIyLRucUVgF*csI~5fA0n|P!KUa1)4H(GUCZWJyJ@|M+nN3RuIfBy-NzW zeJVfJrV)UyOlpq!*3P|qRRH=?99jKYV6`k>H(&VB0YOAa7BtP=j-Bli@|_L>4oo3x{racmL?H znFI(TrUMQL(!Ll}J8N1S!6m8=bCF$HgPlN8KG-AA-==@5D7L6BgqaI_Y7v8+6cI+M zB0cda7U)rWpI7@~f+}05cZ&z&A%-Vy`wJjpw6`Qh6Mxh*jrJf90T27Qw5T0ijamWV z2l>-lv1j+*_Wv6H1j(}m2)Zy_ z`mXuzt4FH8f7d#C93dD19=SHboiFPEOpF6OO*}YAXC_{0ivb5|QPz7<8t$dMTm|Cy z9fHR`S0qJ_p9?nbWhwK3d?*;6VpzwvtFwa#{>u?@{A_ zk_cPv{P{Kgeb$~L$HsTyO@MmV*=<9*t5#nyuv z)y%fdTMx*0wA{Z_w*?L0%IcF;-?AaII@U~N#9zGudyYZ7mx>C`$!(~;*Kb;m**p8X z3}YiXz?8k>xy|RV#pJ}Z*wU+9hwNBQodrt>LPt%BlZ{DVK9OLMa1dggG%E=;N?pVSQMNi`=$`-3baywdU+Hl{~ zp1mDdT85Yn_xP-?zI)sQ0SoQdW&xi}bJ6~h>WA-qHldg~%!0oL65dMCK$v@BC;$#t z^U~X|AFBTDUso1<-(cL}O&{t^$zrySDO-XBXi6Jq5j>N#&7m{1kDo=vyfPeFCApb- z1lh&k`&0w}QgoQJy-l^=-FQ3~2yq z$yF>cSq;8ZN|q5*mU%P=^kAObz#j@kc5oa1f-=%GH0Z!@f*+o>~a$o=ZF*($pBfz-fA7 zu7aa}Dl|h@qpqHKXutE27CY6qCNl2a(ILMlKI&hZ3=2z2*g6>=VtilvJwW7B`$5bI z>Jn>`O?~R{iv=yoq_FK{y*b=0)ZF6a;`IDu(-FnC4G5;q=ILj@wT=y<-AiV~JUGx= zbUM2wU-FLP@}rj0PZ|gA%%Z3P=iDpS!0}AZRj4S-(f*Ik6&27WEeAfgc)kfuD)KAD ztU9#ZUyf{=2!;bN>u6iuxN$XIKQ34EeoNGSdHGOv^{S>5{f@^1Bf0dm52(9R^tmJy z3Fz3v-MZ4XNn)SI)~z@K=rTNXXt}y}<(gPx@4b7gzkA062@}AuPPyx?hj{vL_9%v$vX&Kn*GvYXkaTHi4f4?&W#xQT>4edvU<19nIHn zgN+UTZae=jIUYmf+ujAq2viShzA0FU1{9O+$Mi4X)Moli^)4sm(nH7NZOhPft*SHY zH|aZg`#+C<^FaIe?azm`%^$e*So7zD>j5~r(YgjEy|pwEU#AUk^cjK|a7?l*<{26_ z*P;r)zRI+}ol;K{2}S|Uke+{Hnz+CH(7QXs4^j;Efj>Gi@E|Bp{DRFqWYV*4B&miC zvw%1W-dKzhg^&LzHdJCwrH1m-G%(d0&mU_4YJot5AWJ+iog%gLUxL=c7A_MxMzE%P zUG3hzr~S+E((@&QZ9|WqoVFpTF2x2El&FtXEDP4iynk?IwK;lxP{?Mg-MjZz*Kb@a z4#nsjP3?n|$lYo59B;(d zN}3t7&7?QA&n_$=hI<44^~EA2%tSMK9!i{B@GrKINA&%An(-V-AodW$FuAyBY`gRU z7ziX;2^i3DOO?o#&MKe340LcwIq#7IZ6b=tBAMq44uPEVRSOwPpkK5qKF%cOMJpHX z7wMskH{CAdT=ycxr9K>%SQric-6|KI=uO0>rV0Sh&|Li8qPW#wG8XAkaWwTOH0 za>2n9pWYe007+u^7Buf{%H6crO+T$vd;7aTi;?u65W&GYLB1^j#1-QmWBq*jK)xv0 zM#%cT*Lv^|WVEvCM-GmqIG`qyb2J5a`5}8>g4USe8c{l#x!3qe0k+MXxGc56UoxOW z80?%fk$SPlJxVa>kWcD*HQW0kqg@O-`bsFT@W>Jo7LJ`q8%QvZI2HIu&D=<=Z+1^m zLo-w`J)*OT6iz&ra-CVfA(n4JKe&}9foOfFBf#uQE@9(r9nr&%C)!>MM1JpbcF~W{ ze@Nc(N6Da)z{{t%Z4+gD{ou}Cl~6y@UyIQBzWr{*!?qu{b@@*Gel6~p>~N$Tpc;)v zNgcx?+Y~go0*6F`KO=)?w++jiam<*urTSxPNi2!cL83-+Z934CM|L=Kb;{EH`@jSD zPq9t<9UT#t6e8=0ACcGFhUG`9!OWXn zs`J4jZX`_XQpPo|OY(967mDelNDhpMjt10zB0{& zXsKM`qn|wI0RW5v_T-~-nZOFgrbyR^9EMW_2$KLBNddJyUF^AI9~(|&>WQHB+qG*? zP_tj0+JO0M&)`<^&zxprA>c&lXukRN&>aj;jKUvp1Ug7uuKzq^|zx_lJzTWBJDn0%>dhzHonLYr6Zo6^(0)c&Y zOy_&ebJ77KnDAe1CXk z?P38>v-mm9j3G16WQfRSvfISu*lJmn!H~gAUVHWs40zYk8n8%G6qiWu(9`&GCfy@Y zE1K9I_w=z0I38E7T+v5tXMn2Y+Np_T(s~7Hp1~&Tj`ju*s2?I-yLv^HE7_C{HK3oJ zZ##RClrlnt4YOo%*5B5DJ1lU3}RDj#f2@>+OYuD~pNCO0l9~-!LKCmdw0uJSX zgA#TmDc#rZiAVE?KlaqH`r|;|%gz+GLQ;+n?YX zEJkmW`0iUcIGBX?%nb6)bnjGoAj>Y0uX79j1#HT;h1ui=G{iL#QLOXCv$VFhnvYWf zkEh7IC2MSrzf#y+46~xFVpmS;w+8N&2AtAaXwd8N=ep~M^47$%Ylsgn7CBJ7u=kF! z?*3y(jOWpv1cg;QcI*_lc2}%u!<=YYg7+)64TGX4g$tY0&U>cEf6(AO0VmS{esVBB zk&6ZRi95k#-}-Nabwz9tok+PPVitMaclZxK>@)nNk5Vy5Fnw0&QCGXBweVar=B>hV zJ&CpwWCr>X^2!|dB?}Xe>avl13mQCbE)BnES+3g`T@XzyzU^96r3523Z6YSQX4R;RGp{` zooV^t^7x|u(a+B&9W6ih2=VPrQYKvb7eY? zYjUT{w|jSYb(UAOx_I%Tu8X4b0H(N!2&^|1+qrYn@4Y{4fPg1@EEw&$aBR?bWKsYb zIwq&Y=b!BEy{6tX&A#ID<;(n9;_GR%R_7}5bR1UFd?VHmrzyg9(V)YMd~bz?&#c`D z$AJO>`hhwGEqH#`dMPhgVH=`OYOYJYtUmfcsbcXO>uusd9hR-HS@)opUbdo< zZx3D%^r}TgXnAg7QkI)U8Gu1Yk*^>PoWmAWrd^2fO4;y3ztUV%EZAU$)%ikV&;__o zVBwFoNWO|dd7Y<#T0~sN*g*Lj*Hi7(XUztouAX{mCoj#E?Ha5Zn9|NN1_17A4qL8J z(UJih7%~2G9;l#>k4PO0vC}pY`kILAvbwf9f`F+NIPu9B3J9oez|%i|#L~*@N(Ta} zuXJ8#W;Jr?4A63pk=Bp3Uca0Jp+GDoGn_D%P@dvXF1$!X4Lf(&v%!{d~!8b}# zldl0HMoh5`_|lScSxA5fm)d}SsRAd^FM$kYBc%`g5%{yS&%EyQDHM=dR@MOeanyi* zC@)G~pcIJ81s&r2>0X)U{vF$7MtB>aS!M306!{^Z|8Z>qy%CskD@OtL84w_ruZHW} z!z)e7^Dj~yF~vww(At3efS~s{EKC~N7GmKQ8JopHDI|U6Hkg{(Bmsh9Dro$YdLn&D zT3&2!C)LM{vyCM7?IrVt0Hi$QmLD3{O1W^5u;X10B+LVUPMz+)6h8IPj;Q0tDc3n> zndZbsV=7oDE$0|kEpRFw&DAK$ggA2DBB?Mk0kDHH8;ywt0v=pC=rXS3BsU=7a{>rh zm#9(fj;H29K=PdcP9$ynl@*{z)5Fsxm1!t~+3gtQRiCv22}Hbnm2Fp;XD$P$9BDlx z(Vo3Pz>{J|ImbSNZoR!HlAX^OtN)v?#zZczs0Z z!#%zvAyp$|H^mo^8t6ncPg<;ZjF)Y9x;JUL)>F2-S<7D`W(<)@;$Zah>0lmy^phM3 z1Ye9FeNq@bg3d4$t1Ib6H4Hd5s4+z7^1|cy5v7>2tWKl?MA?pR-lW2)D|3jL+8WWv zeZg^{%8>?n*ox8cfOAYd9$a8x4xODkHS3}P2)o8I$p;Tko1g2~iE)H2LotJhNSYG& z?A=rS$T?lyQdC zTRi}{wzf`}i1u93a;2lKgDTncXJiy#b||s4xu=s!c?ahZru(sNM6i2k5)-Hjn_SzN?U=7}Y+L6xT z*O*V6#!TH#eY{Z&VRMfKPZ^$na+z$?D;DTSflh7RkYPyx!F2P{Af`V>$n{K{t7A7% zbI@3To|n(WMI{+E1_l-qE!dy{bn8&a>E^dsI2c{o{JIIyZR;xh^#!&!6&*i;XLLJAt-ZJs=jJskva3cE>Oo04p(F+c<;;j-F{ zYAKTk_~L}V0I2?EIFgET(Wg^QMGaNg0Z5mV+zzVQh@$(f9x3fWEnwf|^}t*TpCpBq_6jb{uk8 zS2!vM7%z&*P5pcV3bUq}t2O|n(;RIv8BJv+n3=Nk8S`}S4Z27s9Qfz*#iW0A%1PPfU4(XSJEDTo}blOgB0%!x>;GmV(T|UMY3D`A0-xrpuyj zMRgpeP20ch_)`mex$9W?(9IMP8Td&rkcT}^>*7bAt$eC>I7l5A!MdgbF~j77E8JR= zNW^squs%qePMH&QiP4HG1I|^Jxev5tG<3{xQCJ*2*hSp^(Yt3vX0Jc(9=9K}fdgi5 zd))YJRf5U^gi(@;WKHjPtsMH5PN!p!*zcRU+O`y#t-}&PAW9e;vDA35a`e5|9;#MX zRv6LKUnf8LqM%B~@jxDqAG7=en<*Y@%+>v0Ke)sm6@K%06R6|*Y<+wOM7H+yA0?X^ zyS5(Q2^f!$F~+K?s`o#YgKLmCNWmRU=lRx454w9LQ&s2B>vtcL!G|Nz!uL<#_H<>D zG&Nn10ju!j%6SbPPMMq;paWuTGVGP*|I5fQZs3m_H*bpQ-!A)(y*};Y1^oU$X}r+K zJSirzAdfv@iM|Aig-5c(Qhz+x-GNT4Y>JMJk)891KQitP=YGzqfFD0MU4F<>b?#Vy z_$z2D2Ypt0+Mr-2qq8#ayX3H}7TuQ>(G`Z*Z2!;k26Fq(k!DeE!`LIPD-KV8(@PzV z^1K~v288iKRjY0*>>Ge&PM#54H|p)=Tba|sNWvS=fU_U_LcOKcbM329#eI2}tRWTY zN|mg-gPBzw>=wY-D?lN`9pXt8BS#f^WV5tk#x1Z2A~tde{^GeYjL^4RU;OuHZhAmq zI1YFnBIGO0O}*mvIUwW^)(dCtCcCFj8lmM)eSJO*tt8FWaLHx(f&ihW6*@lRrc0Jo zR)n?*zZvT!J>EKg#Jh7aLGf_U6DXpA+&D$d7BK64-hvMmpbWUr@MOshg{;Vm8X88VP5j(n|4$|=5JmX8pD63*p|CIa%e$~4 zCUgn1_=QJyga?e|CgMCs>Lz*EDdt04Ey9yba3|rND+c`~0E2~M$zNfS8aFbUc1-fv zBLxd3V)_G-fwqCH75Av?KVnS6+|aradEtN`6h9(}PefTDlh|)h*v2A2df@vL+WKryTVQSkcJd^6GZ%;cW{=!*UOK zCh?l1N}i#j1AKF+({XzJ8DgG@o&_!qr-0Vh1~3PMxoDLrbE914Pk!>JfO`x6^>Ww8 zIw&F&^oaAOrIK#rfEit(l*`a@}?Z@=OKtj$`ozP^qd_7r#aB75W9 z^E}Wmf2RZhiP43yrRnt~1LQ_8=|>SPAZjX`0|niTh^$nvJvUrc;AZ5#`H1$51OTk#$Yvt9D>R@)mZrI%_0g&I$l^hGS-D-Cm*NnbqG zV6`S5!QxcwRajR?Eg(?tTUJ3$3zq!VMlJ}p=~&Jz_Rc|#fyfAX?bQiWpWzDt@X1w4 z=uSHq1{j0n30+%lJOP*6=#%YnVDG(m;*&pB$G&k7!ir2;U0bb|4>nQYtaVUp$e^0h z1xS*HLHO>;SYsmBYb~o;#Ck|6ki=HoN=Llk3lqGNF2ig#YQaDBwHrk`m+!vzV0CRc z#UtB(>bg*bX6%QPpUB5uM*uTJ2h_AybAUP+0{kO)#?8JxwqB8A0Hp@_gH=cnv)cmx zVnGF33F0RbX){|`{CJRfX0PAKzAKWnW4tj^7%V7eVbl5hZ9t<&QIdA<*yR931J%W* zV9+vAxz(HiuuLVn?P=z_ngDh{iN8bWBaX|cBYaJTA(D|}-=dKplnSy@c#uX$8omNA zqXB^Ie%r5rYd8S5n#IZ$VpzM`Gmfc&hJb>j(dnZsG<5$2xGB(+4}g(?AYmX7 zARP^;T7P*B*A?;W6a%c1dqZ$77@{REAF3LQ{bF{wK(Prs;oSl~@u z0ko(#DNWME;`d_Ef)qDTqni`)?$aL`NE&(!pBQTfZ9haQWz|r0teYnPx%O>;t#RpLw{6-=LT~`MVbkWv_1^6F-We0u;IlOZ8e&_d%n{>qE zY52tlk`bS#9!cbu`>L*%mb#;;4gJF}P6vga{rV1}e8^AF7*PlKh%LekOP%Sb)RQAc~N zj7>nFX1uJfuB2->E1)NsdeG6kj&=vYSeNOYCLoAFZ@&6aJMM>w@0{E~!w5`T2XEp~ zGX1EU?lq?!38qa>??|H1Oy7RlIu2Y*UV&+K8N7DvqNm0HAU5!x0A|R7iDD+}!v-?$ zX@1nWp@2P18(IkVkw7}8%_q^kUw!s)b@L{1_njqU=Poy(U`KVeap@uxh=wXVH0sq`CAW<)iP^D5f(MF|Bvs zc(hj_2mD)PTLLB&Q^@^a$=cnAmsl|e{2Q&mC^hw5bM${Y@JBaqXyB*P1pb)`_)Fwx zfb>(Rkw6IvQWUH}N0VX-&2RrxpUKvbHZ9`XoGzujQ`$!v?b6eB9Z&)Rryv^- z3L4H^rgc zV%zflk3X-TA@94JiFIKD-^%q zrR16BF2K@e>wv#z!u^bPm6-$^2_c%qL};?#XC*Xs&#D5@kKetU{8a$@H9zE!UYWqq zcUQe1=ONxyDqMzwQDIsF;1m!N<{kG?dHQ&{K0NtSf@s#U( z|NWcu>0HseN|Qcx8S(1UrLg>`|{z5a1PnDWme~)GN zJrzr$ksmtPfuQcVE|P+yMU~d+;?XJA!GVZ>#Yu{#q}Z(X`B0nsxVvIg2K9U_ zC~ABF+kx`27eYfCHc3m#qr*rhk5B7B6!#d@7P0TB6!%BYz$&(o$fJ(M9JLBbDJQ@3 z13FpGe=N;d2Cadf-*)uso}TR@PCZ&*Ck)bB)(Nbgu934Arz+~lm0Py}5SZ5R(~sXi z(mk!~>K{HQF7$6Gm#SK10TnAqoED+0B3*(hOX>85^#KSh7$JFBhYDEFN_!q@og0J7 zfPhZ#0Wh5vkl)D8&dpbA4+s#jF4S**MdL|l@8m;dzid76dJs^%>GIa;^&2; z6^tMh$J-q>O|`tdGHPB)a-23-vlOL~VKgwpKs}rk6YsS-Qg4h+q8+8+pA(( z@EXnFoGX(`nl}CA%Gw0_x*4T=b+ksvM^t5PBX&)rxtW3%xCFRy165au&$u_wEV}p}CP~5-8(fj@B4(zT+ z2d^5Flv*lJHOM7%n^4epod=*&(PgFa;}dRICOO`a!-zC-*eCm#E|q?CVs{~bxyU~X z!6j(Yg2B*yf5tj2B~z7Dgz(gbu3tKvP(hDm!?hz9D3G~vwNxHXEV!qafzF~$|6GqQk*{{m z4+8l0=(Y2_He zK*+Z(nK>3rg)y=kBXCH-spi-b41A9?U$}W`M57F z%uIju%N_Y8G<7bp()jlhg5V_T$lhJKzx`;b`mcX5M}~2|q*tU3NkB$>je$UOcwDC? z8SEbH2#BP7FG!?{!BLIQ)q|tmSGBOZ^n>0%SY-MMthHKD+fyl(zx!yhx=%%jruM)^ zobqbYulPDYBC&!LV_T41q%?qkQ739=A#bz^sh#Wctf@h?R&yU}Ay=|>2K=+j@5TWB zY4;0p5wO1+CJend^9n2Yq?J$gCkMa_GODZ_Ib`y|r;uJ~4~Bq4W@_!K)V>^b92qe| z-^{oHtRYV5R2PIb>df&L_6mb`_uiYhTeN+pvjmcLNpiq_(5U)A11?GPnU^WF8)I@# zPzj=P1a>_Gz_p!vPHLog2fNODf^HF&cbgs z)+QJzi)jq=%uQl!@YHO3{15q2hiN%eDF{$-_?Uv5d6UkyA?bd}XidpXWGfl6rRiay zP)a#Kp@Qx(6=k}TVLdbJ?txod3pc#=h~{vcrWoAg-aX{<#hElvNP}W&RldzY3nskH=H5I#adcMR^b~_AN)sw7baRNlm`zC~ z%UeVM%V?{aVON%|z6^Tl$k0P)BcWNGxnoJ1LJ4C!Bg)cweILlaRv*R*TsW4pilaIt!D zA7A&NJ1C3{M;*vDzhge~`m^Pg#x4{FWdoCQ)G#*@@Taf@vl#0~m-qPbGbRb{F@X;h zZ1ey?M!yEn^ie-yse+?{uBuk%5x^c5fS?r6Rmz7w*Z?f12HCXhQkWm?oKOI5LE9vK zoeSXm5EY&qI6#H+_-iodx%ZoTsJ^5`%e zuv9!?xoVE$4wVwfSTd-A!j0wQs>8~S9*9!|8GvS;9_)gB)p)sVlTvD`1m05LTz)VB zKQBK&>n#loc&54Zd=aGr>j)j&i7j@o9?O2C4}4;b*}u1*fZqF$q>!~RZH@x;4kj+8TRHhqajkAsXr^ST6|7^(o8$<{ z)RXP`@7aS8ZT7g@vB!+~>!wQg?Yj(F44u1SYeM5m{(f&%+ zPIAp|rp3(uKH0+oJSZ+h2-1jp2-UYM66{Zu{Tx2gzn_Z}v+u3{)qngiUEd1ExPSS6 z@-V1c3whyW3QId4F`4b#x3z!2K7TVcilHnf18hUk1|PKp+^-ZGgq)G)^%cv8FeYn7 zpT-3t7=*ngUtU}QeA2!e>PohY(nE1(W~Tb$oZ@(i0%+)(+vUA}Y>$^8m20N~-GG_t znd-AMSG~dtQ8=R=WKnC2PtrP)>%MZNKN1?vSr%$jdh9`%W{bA}5O(X{qFPLYYPHDI-_1chma_R^F`h9R5dMMUJRG5(b>9mvOnsa z>UMe!@<}&BzRuyRV|oYs`w;*B6X`fGIO7&z&dJ9ku0Ok=EAM3eJNIsR)DUm?m z=CPd0Q#lZjQ@}oX^H{g%%Ssd2NE;GgLI4oKzB#-ny~_`c2i+C(86`#=_T>cZy?dee zolZUtfTcE3wM8a+=bT9(xPk)Yp@F{)qdciP!g~vngvMTtek)RPb%)aK0b_+uV(T_BpbF9w39;6*+ZuCPC>{4f%WC% zJFfp^9^Kc?;`dhDwrG*4JX#xlzhJLJMcsDZB3)O;qY3}<9w^%Z1FLXVd7!speqac` zz`AZx+s9Lbw;N%&riOkbU<5qHd}~TT6j9d~btq=R!0zuW$HI%*zqw%VfOeq(tEi zZ@zkH`25AWYpG1FC^DGQiKN@qu;zW;RPP=?+~?HQXJ1{7invw4Gokxh(qRZc!2KtT zXOzCaycPn1LVuws++j0MuMjl8ZX`65bKpOO=%$p-nUeB%vx^4P3y{59*Xe^;ah!`Vaf zOPYq6n&^@H4;<*9>cMi|#(_bbRquuPsT*OG$oD$rn>(+;3om#q=%*rpP?;oykZH5j z>yz^!EPEqnSwERZLkSnP-CUGtLSLSLf=h`37;^hvDo=0bamiXWzee557RzRcW|E8d zi?xv8HBn!MBm;iEytOftF$CufQk>aRXFtj35 z@@MZZy6?UhslTOC13$_i13@4eWbNv>5@SmholK#Ol2kNY&3qikx&0wKR%g^vVHH7* zC|G|&uS(TiqhurU#Wk&;FUS#ql`r_1Grm$=dTN0!;)iW7`D3Xl*x z@#p8e%h=;?byaEy1_tzMVIidurR;`%`5PP$OJEgkeO zwr9rB_LW*5uZZt4YCrAVwF|Rqd@xYr;f;9z@rA>EdkAonI~KfqVfT=;B?7)aZ^1z2 zJZL)_&n+oo@p#~ox2;tuK*n+DF1@li$FCZ4{t2m;+v`|p+X3X$^ruH}@7{d@-vFkT0hW^9C;$0~RdPoy8Kc>**OLUU9SOM<@6nM7Z=%U#;d<_#Oa0 zSZiVcpPHkR@1zCmjlZU*3pvy;isb;o)i+_#b2 z^U}Nx$W%A!y?iMvHfe#R{81N-?E+6hBkQS)>qFgNyuVaEc);yNbU=kKO1@YrH1_G4 z6UE zsHAHzq^G{i5ETm+BwbZ~k0hWs0RT0TEW!JjVB1=Ijp`WR@5&i=a68*aR0;7g zA7p7%A>B>Zg9mog&^@1P0YOKh#gW=Z$H#|JJ8IEWkZe=h$n=xtFiD$RG-+=lYlbMqnaKsBI$bZ6Dcw6L%cNd0!}8Q2y4{3{=z1al)Ei-{P33L`6- z&lJ0y4Fab3^`&le^vaRBU|w-Jljcq`H{F1YadpsMUk8Nsv~9-TT`RX%5+Lx|q^A1m zJ4f0L@NYkhBN?Z2n0+Oe0EHYq%uvHD(u_LrRpuLIs=?nhnR}-!2&kDU@|0?Zi}G6# zkfcn=rZ5!7MK+c;v^oHqr4>9?fP`qHHxa;07||cfi*Q7Hr8&yVnQb2`-aRGs$|{fH zsN_3o!SwA_nk#wF1U>cZ4~|w3+UV)}M3^bzKAtfK+dKUf`cry-14fqDQz=U&{j8+O z7xBhiAp8(&^>K$oAMJPz-@ z!N+|$#8)`ZNJN)5U?4SJgJZ(X7^3vTb6pg-uulBJ&v2Q$ckd$kes1p!#FQzx7PIBn zhsyGta71iK5{+f|j{yT+78qZ}(x)C$k;iqIKscUMaU9bD6P}&*JZCAc&})|AQCHR6 zoIRrLYW?;z=AJnA`UGWSmob&AThlD9LNrC&t7%1UPIe#6apEy4^h0;)z`+A9=tlun z?rUCE;y&A=lmilKxF|qEHHk?=b#?w4@~V7%9C_=Fln?F~w29sj{yy>!{NVvU9g$!Y z{JjEvlLPmD{m~J^n~UGTTiby1wxf~_uHo~QOegoX46f|F_qr$U$NaoBKR>Sk|4PQ0 zF^~(rl)A1`%0iUu0$+8{e)0Zdu@rF4r~S1mKHrs< zWd$eVSz%P>GY0fiMm^T>RckHfI?@y6y_CYd@|!~SU=`9EN?wsSaabx7h$Hb%w5EAk zWUf4TB|M1OD%WqL`w6yT6A*km@&aI&{RQ#QV?L#mDzqxq3{k!NL1xA2fa+V#4LqRODnDp1Cx_j4o;kjeNU@((4 z2ioklT3=twYV@FOn4%qR#Rjc!tJrh32}bfz2>|NH!IWIbr*=I?vPM%ACId%js|& z)#6uH1)By1SXbxD1@{dSQOO)p=u7a9qj?t2TUex{rPjrw)my(&G;!n4I*dC(ntfYlTkM> z6#Ry7s1C;^Ew8Z5z$21+XwG5P%fe?O0bznjbDOC>eV zh-!K5ot>G>4(8B!*Q>ak5epKGKPnm@^Hpmql5fe}uyq>U)MktMqt<*6dQmffL?Zb- zC$t8!*B1PurkGuqEb8VhZf=fzlKz+IaoRu`prieW)?&`PN03O_t`6|?tqil*s=MV-= zqga8peqD-ku|jxo)ucf}upTD@5;DIga9T$bpaG?aYOgLG;OOwlx=bGKzBe(tZBRH5 z$`pWyF@R0VRx%F4@`_m_X6c@n89n%Mm-FR?N3g)hC*6Fdy8glaht*trf+l=u0_|}g zdM5e$#hFjtr}#(tfTx*%>fcGqy{VA?YfY|F5Fxm;+>>uK_{Y2{t?AKt9)GwBNh?Wh zGiVzuDj1Qc_ni;Hsfe!x54+!fc0Qud2_6>G09~TW5p6r&_`3b1*FVzS7+6#9X~kZm z(a!r#rQX5?G{6l$g$0TS-<80ND*1iSKTlF%w%65Lue*EbAFV&aJ%Gr8w)y=M>kVm+ zsE%_7PD?qSzOL`TxfEahAvP`#>;wCK-1M|y*N(U?8S?ezUwPpmES7lPH({}>%MVz9 zum%6Z?QpWsGHp-;_~;q~q^6`FTfCP@lXOQ~ck1Z#?t=RZSKO~MjqEQGN(L-XqvTBP z)YSGMf8)vH;DuxxpYCnL=V`J5KN7?(Akj^wo<}0Cr^Ne@5AM6kF+aa!kRdT`5=1Xz zI;4JaM4*L!+l>~w4?;DJ7Xu!bIDu^rX`Ed2JO>RJh`N4g9k&3Ydf`#v4h*EX9$}Ws z>?FsFODr0c%qzb72(U1DB!Gop?_sss<-Y&Mk)gmRr!I$7;~i<{1{0@_*4LN2HD-ap zRKG_f8e`n#*sE=7QZ{K1rvfSy4VtFz-kZ7$GQzGC?R=diP{^Wn0WB3Buei9~Bw4F1 z$ZAaTuZb|nuYU6>eUBe}J8BIJ9m-15Y7{y`w>C1zk*x|g&Cd)ZlysnimRk|k50f$h zwP&8R8bn(h7`4TTRUoM3s1iwW?YdT`>&Y?PMn(3^^C)mzRsHIt#p>a3Ot#zQ?I~1$yYMCCy+t2;Lj^IO1QKi#gU|K_R;*M zVy%3mbc9yua)2CJgSqW2c$k&6L4~x`xb*gG&!wfB@*gH9HvM7(B?Q|SfS~=dUgqKZ zS1nR%-0_0IF=zH~F@0FHad*#xqF0x@XZmR0{25%+*E2(D1iZJy^%7XfCq z_e&^XSABCH+*c8UdMpqUgBm!{2wh8xfDn}I(w6kui$@mNehFFB<$(|4fG|W55SalH z#Deg|o1S)2j{kh_D$!Hvd8*Vf$KhcyT|VqQl7@Oc~+ zm}!7|Kon~lk>nz}jPBD+0%+ORb@jpPp~s(jr#$TMSj}ekzE*dDOj2emIcO7lBl$M0r{2FE2bE3Ghw0 zjMB);De=+qGEYtw=gdG6ZQzax0wXs4>Z7GL0=Zg{39;uqCB8hL2CMkx2S?jEd2{(D z?nafts26e6@kq27GK{sE*}?!*fcWg(%&_M$$APoR0D5V^(DQpH3V`<68Hv9RCD1{$ zzBkPG0aj^&4zTWv!KxmJD^RDj_EG310Jgk;@<{u4ecc728HzWhAbjtQh{a;*X|-#! zndYCdHan>D_Ui`x>(_Gs{O+B*(TEfxaR66snoY4vAWZPA(Mizu0WagW?c4FyoF^5T^WI2#b2!}_NFJoAwcfaywJ$1DhTAa)1JM6E?Hl#T&S{$J`ih4>)>Q%s zID^t7Wp=`Vedj+bL_t*WZkJI)1sVYdN=Yr-=OjU$kdkSWM+E8%`Q zcd7FVe04FF6$8D2EDZw=M^$7GKa{68{@b2uaNS$CR@ye~*}JzBWElELkMw_k@@{tz z(C-2ukejm#6gwJZj4^d8go<1n|zBotvxH;PEtnj-+&#msf_n z*T$s5Tr@fntRp1TFW)~}{kKmqc&`NA4+rtPCqp`@hkQD+%F%3&37LcqTAQ<_1SFI; ztBg!_Ref>cQT4{L?z#k>2Kc@~LZQ!FRm96Q&TB=Jyv-I#(%Yl4wDRZJuRmDoj-X~3 ztQxv5yKkSb^P?jCy+2{eqGaw9M1eiDTe}f55pVhy{0ol^I|GKj`;gc+m5v;HMUD4G zZDhxh1l!N4(Q52?{1BPYQb@q6R^LWaHH4aB zmISgPP(k8Yohs>Sg!_noUI7E0s0}!R{^rbz;5&Lph9E*)w63c6PaFxSc6sZ#(MnC~#60^a-4&#OR{z zo}|0ZkJvv4>$b0Y{73%@za0_|9SDF+Vi3x92v40i!k`ixJm)lWhhIZ!dcy`=z#xkO zB9ws4P@D2If-)!yu+~*7@T!a?;pyRdgJ%ISo`pW&wR2bU z=!>)0$h#nMs;k$Jh28_$8xfHMBLwd)4D)7YrrS08*;iMB=Xwl^o}0nEWxf5RT)Gc5 zeHwq)HjP{}CHg=p`_60ruQ_%9i>Q*7Uo+F?(DsG_32n{aetuEKSek$68L9tD=UZ_} zye4z|@5IqLettsE{TkC$D#duXsT-vO2M)Fy&~R=;V8j*uy%f_eJJG2iQOGAZ`*n{3is)!H8va#??z+|}3w!6|Ooqm&~q?$5PH zLJH1Uo^S8pBRm6X_R&Y3Aiw-@saj@_k;-F7b=j#4v3DO2Z?R7qw7~orVr)s#>rH_Y zsN~b24awu&krBxN3G~LZs+a(Ra#dz#LeIv}&f2k27|U55B)3_&E@`i#AHBT@gU|)F zgSxhjge+eA;_H=>N7dotM*@zSD_YnrFM)Ts7=NdW3VHS|3ue)vgw(7gf z-S~%?5!2=v45r$z^z2j5tHB#vdbe!q-|tQQR00pNSD!B*ou`$bk)@}%3tsM$ax?kk#&;hlw-Z-yQ*iwEQ5m;5c+VG|oX^w=y+>qQ?CvvyrF zmzCGRtLg4Nd#7Ms?b@}|V*~^xlc%&4Kr#24t66@jOz$3le#q*;z(R{!QXnMAtt1-P z$l2fxouX?Sp=rPi3IR95bCOfIQCeSL^ByyEQp+mg+zj4=rt&`HEjWmz*r4}1Fn|20 zB0>Wuc1NLm&y)a#Hl4okum=G#c}OcR;^|66Ckt8yY?_NeLP93AXJHA-D?oS^{s1YkRx~Axp6ZKB z8}cw&Z!^)@$`miJvP?YmteHfzvneugvc*duewl!O+Nx!3TfPy4f80(>BL{jg(bdouJ0nVOmkOw0>cSAqznH0EcGH(B!zd=aIjI@rj! z$53OwEH}Thmn#`}Q44|0q30D%E`3;6z`>3%T=1QOX;;yG`r?s2oN(2KL6!w0k?!KS zp9u3S$Kxj+wmxI$u3h1HG)?vB@nfC5$xwCwK7MR3-$wHFCH=aPunr_%SlEppG)?vS zSMDe?mRs3>XzoJbOhYPj+~WF7B=9$1*~e8RWKOkCwsf`e`ZI=(07un%ZQE-Bz4mDD z#R8y^So^tEhw)dzZAEhB66*SDG8~T|!=5(atuTU1d^A<6HJSBh(*6ToBr+~Yi7ZLM znk@ziwZ)=d$zQmo6^UwDaBmLb5d`b8T^y#r8gQ?GR#jCeHC~g&HU|e9P7YA~f&$ev zzSeT$qW^%8z-hw)rc(ctt{px&rjl|F2JKFwTUIF)mLu!g~ z%K-Mc(Nm9zfPr>W)6~wI04HrZ{*JSlN0H zWmDwvU78GV_T^vv=+Lg<2Ojum((0W%EFjht_H&Bk^x&9w-I4Q-?krnJ7x5R%VSz3Q zYvH`D{IYo(G_IdI15xAA6zc!PgOcp)?(^lFc0JqnastwQ36GH{1tnmUQBG~2aQ(mm z-#|7{1h)=2a0MO9jg$;fx{n@rkG}8e=a(~St+iM20@*|!faw6&^q}@0SOdW5Z6c3a zG_udT=mit$=vd%`x{)T$byCzRr9e0eR524EtZUkU4Q@11t;b43u&LR)zM%1%p^p$p z9ZPr%V$i`(E>Et+kuNs;q6LUAR!n{^FzHDEsJT9(=67uRa!Q;BEmO8}x@Ycn=&S77 z-GhOY`?1GyxJClZ4SSD*0Vy6m!jbqmFGWLVXa=VQYI84z`8BR9ynA;D2EKFLg{%MU ztE;h?G5#)?ggGxSnvQr+LIA2xN*<b9WK%CHQ!P>T-eHI8rFDc2m zSKQh_2^$C=Fy)H@usG!;zfeV)+Q-__;yIq~4Ym^m5EzKWCPF7AM8XoJwxLx2P^4CS z#q2+@ulk$!u_vI!NZ1BPRlLfo&G#6fQ23R$rz7KZn$ZRFaGO+{BQVFUY|7V0M%#qh z+C9}69hoI`#WU%UwXz#9Ie8eHq?D@jsM8yEd}_v4B{GUTnl_9kJQw*R&-&!Q9#3C* zK=WHsUd2F(Oo8g#75O#l$|j-S5Rjj>=`}gMReg zc_bGJOOOTd9^78FC!iFGc&BT-SvBr)A=IbJKEh8l@7FPR%jxz8RJH{EH|*O^HvwS~ z6`@njX+X%E>?gzn>~yyo`QvbxAf0NipLJaywM~ss zb)|#GcYoe^`M^Ns(IfhPmJH2-pC>~i&r_7+d-k;velt8GTW{sMZa0ws@F&TmE0rP* zRYM5reShb*10o=cp3Kb6R=@jFqkT8ed*lHS(aD+VB1nYm%;NCAkSY#uB z4;OWhVI6JKsiUzb^6fGTe9Y(GI(bR71k7} z_h>7#c?Y3Vb6ynT_J_k}GT@zB)ZRF6DBv%E4kiE&GbGGieKu&NjQc`0(TnPQq$(1agXSo-b)b5&FN?eR0?yl(F1Yh z=pdcQI(Ps9U?BpACfiIT3;FAMV0?BGcl>o; zCT$BF#^^$_44vwpwNo^x@6|)Igt}MI_F(L8&;m;_-%L-z;ZIuN@{Lg896318s%d*{ zuVK2k^Q@C!v%xG2L<92=w9SikOvuuE;lVkP^5(XZqP-Q&>2wTjAq3pUUDb(JS9kgg zY8@B|J0bY{o_CkvAHTXxf<|o>0Rpv~y7t6)iYx~@WYD9M-te?+lkYJ(H#^gVfSRbsK3%%cpn8F`iqsH^ z5(4VIO*e0@RQnI^@79V!c2?S^3@GfTQj-r7lA9(8l+?6Tv*89(C8Ra8g3-f7MpFzD z67n>;Afd*v5+AUMG#tl~Evpz!^O4tFb;)z-H&JgXew|lZJog&_{((8Go9dE9I@!?^ z=UQqYX%kw0&N{(qcoNtE_F-ZY%R+<%iHEv&QKf!nz(4cO>GxbUtkYDtR`Bsu3UCvF zIO=_Z3iW$s^XJUP9(W@5&*}TEhdjnD)geenH^sqQ5~XQC+e;#*Y|Ler;USJ5<~$G0dZ+;;*%gszCb?>rTu+sgBBVX z%Q%OyapE`xjzuI;i-+yQy35~~c*nlu*HIgga_GK@uQuAWDf-iY{hv`wu+bUYizGM~ zqGzdFH1G-}EGl%L9uS3?3ceiN#u^wK@E*UEJP$eebP-2T*YAfxeDu;Q<4c2rI@6K! z;!6XGaFp#s50GF)q3_D_dJ=8^^ev++j_I^^1uVC174IhGj^veAoBac97 zEpRN}eeGcIeQh0i$gnH6{jhiMJ~48h`PKcmpIHzS(9?KY)+VYieT0{n80+yeLfM6q zlDW~0QQCi?^V;{f_OP@$EdQDS$%YZ zxmT2+A*o_2{r;YEgAF;pnyO$hN#>v*Q3chdfTCa?xtzXd2NugmaSs4K+ji7f%Gl!!s)a`$^sZO% zg(J?+dK|~W@QKD=xG|xji3k8pb?4TtTT$57YHclkug3r>;+!_j4x{DcN`y79FW;@| zpZu#30PO5Y4y2%scgnzt>(0*341!*~>XbSJx&}Ky0=)bvx{5jh&_k!7!vR=c1GS!!5RuTB3>`>Iuo6=U2Bu(NB3{Uu5H%VBrNI{lgJF`Uq5V-!^09(m za$Ivv@Qik@3A4T}QdbMRc6&#L({eM@vx&0!%<~w;0`M8RZ3C;RO)oF*7`z~pIxGwA zTI8~Epb?I5mWl4`A}<+FLO<&tKfg#*R<4D2Uq1k!#Xz8D#h4?{Yisx}OzT-^$QV73 zk2UK7EDZ=K>)lf5j(@DZCP2@P2XYS_*kAqT54qr)Bk}>hn0MaDW(3)+}vFCfBneE7yvb?1&fwMHi#X9EK(hS$lL?0!rFUu>yp{x$AMuL1p3^>wox;JzuC z0Z-Ewx>mQE3DmuCwF9QZW~Z`npqs$he!=;$!OuPnq|NJVsuBB(MHP zH*w(6{IpGYZKH_=p1^TS3mU#J9NABvTG@E~BoUvIqg&(BIuFJGFI+-CxB&DqUZ>S52*~#=rVFKy2TF_ktSk^P?uEIX=~uL8(0&JTudEo+roB zVgG1wSNBpMQMhAkH`YG080m8Z9*RUkYTylPKlO6da3cAX(qm-}5d|Z~EzoAVYvIsN zXrK^^WjI0%9>wic0tE@8tV#|rymSL>QVFmx_8hb)6TS7B$h2d}&H?u|>GU_(NTAc^ z96cO+laXT4iR_GSPDZm7lMsw4@-9eBELHB7jyG*gT5SW1ILTu0$a)9v_B;k@WmKzQ zXs8;ML2dNDzH~1s@8s`3z3O`l4i9r)=$trJy37j8f#hwY3Msy@=GZ8G1{Y@24-^F9vH)9NPhOeDys9G|>fX z*|+aN_5XcpJo;ps=E>>r9%v?FDhrd`U1@sYhy%d6yVnwVNYQAJFl&7w?u|yq$)xT| zltC+J)D(0tTNLOCQup%jBYi5Um`npbjbDDS!~m;}cNI;T{xEoC>Vzxm4#9{hBiK~S zz@stG-k#L`fjG_1&8n;Z{QaeB?cqZvK!OHr)3rt}#a+6dlaw@?E~+qHdUImH3eAKu zG{thw2wr*ZSXfx_UN~L9+`4^RV}Gk38ZeG~{)aCv>huFOkE8Vd$;Ik}lMB_F2LjOb zMRF~e5Z>!Y6bIgUUwsF>q=~uq*74_ux5lFYz;I>GDCzM{l{%uCu2$aTE-M$Fr`g#X~-b z;?lP5Q`NT@S0cj~@bnB!6cp0Jgd@9%@M8g+o>`}IhzxggD z^sK%1iiwi?7lD5hlSQk>m^3$le`)FWBTr4EZ+OB@_5N%736DTpuI8C}>}g*bT**nz zm(j~nTsuF0`>3=&v3 zxa_86@#>f3SNIYJukN`Cc&f8Xzdx$SvPI2zQ|zCH6YPys#hFwO3G zumi*{4Z%YEvOre)@-5MmC6LZ*TS9=e5u%=|>uT|^1pw;=0F3K>cX2sv2VqPjezeS} zY=2BzZR^;c5h_@M0>Z-ezLe!MdzmQABdYw;(q2N`u$%z{VQ>nm=>tveopMwunb#K8 zz!B>hfuNxFZu@I%t0$a+{8h0QQah<$iN~UuR0G&%oA?l z>;CT9v#0&+?*H@pY}8$HY2DY3rk=6Vk>@>o_Ex|9{332GyMAe~Fh2{$b2!Rv z(&>hLc`~^T>EsLZ<=i5f_wV0dJp|DiePbUV2af3mf6@m=?ql?^Id!V@i$80S5T&^} zdT(U_K)p_)QvFQ8z4D|t>P$L$6nmR-27JRE<()XVCjoo;G~)C(Cc5x40}KjCEB91& zk-wry=oQ!uI$>p*1{`K)=J+GQ8GTsZ1AQlaFTh@zw__OVBDYi0@;^5B?e!^k*q{Kw zAH98a*e{wrRcLE!#|i@y1^~QGf__n52I%k~owLDA=t>EVlBM9vI?(F*iYYHbw9wfY3L3FW$LTPInYCP zL;wt}XraRf_cqk>Nc%;-%p(srx&numdNsks$M3PG+^Y}VcdENPl8*eG)J69MHeJp! z?`UwhkL56%7r2eC(z=4srm=t=^LiHjfN@>lMF6GPUv|Hc3Oeq!254PZhxXy)ropeD z5$N;X#hd=6hbb4)@ZZ81Q{E@hSl~cN9vEQD!D1W$SdXT+c*u=IK#c{FwW*FG^7e~0 zB6I(q|6)XIK?j0%^E3tWm?|vLz~LjickdpQiLDymAD98oMMaoZ+@|T->FSTC%-w^a zlqPV5I-rOpImvqqa|XpF1Nd2B`k&x^d4Yg}Af-3A`H9i(b; zN;a)gW^pPvu>1-|lK5?E{#t;&q6$G(a((o7aCX3;4&Z>foZX?ML6tZS0#5w=y$*b$ zfI;KQtxJsY9A%22-l+K^GT~~0Z_S7?(t!ZR^UtOgB5Lm03-#$y z`ne#x4aA`W_0&iW_@WylHK2n^vEF{+vm}ylV?Z|5EO!d1myxS zBrJ9I{7S){n;bY5rjxHcH#l(EJ|MlWqV&y0e||?T$WiLz@#bi*i7{gkJ?&g0=p}t3 z(ewK<<{{`3&%=x@XTN#?`3sBPJMHn4C$J5so*xDB?& zo4UHb9Bx()?Q_58KYZ{Y2qrPyRbx9QqB$HDj3$$_CBZNG_9HmwXvoI%cb<}-erqY(6Lob&V1UW;L4!B~@5J$P4`{4l|QzR4$XE=SLX>7m!ne%Tim4+Oy}ToKxuJ$7VY5GA|Y3Au5l`6K<%3}4qC zu18}jz5Bq+W_aGvnqOO^ zYD#VM(B<=2h&y|Lp_hImT^_=c_84kFGp)4r+=4RlE|ALyqXw~39^1BUA3lG5{stgt zE0=q+Y=Pjd);p!HmRj$?Ja3kkFL7)Sv9@5Kec7D)+6F7B%0Va4kH?Z0?oGohDXqAo=V^b8#|%bX#QN6|LRz z>AI@^@MqtP4~>VM!u6IvPxTcf#o|6BGoM&n`7-3Rhk{X2(YiqA=F5?i*9P(_*MDJk znvNbQ96L7pwusW!V~+dgueXt-AX8-+%nm04(&AZ>fFU2bWgpnP1}Bg{ITL$)sLcaZ z4So5+fW1-PgGyjeOY9f#AFEbYxTC)^jj_PkDdUkBRr~pSN2}!(+Uw`5#PhEV)ax>6 zBP&1Qh^DwGWxkgh^J8eF5@7F-9D01kkKgK|QJd5r&&B9Y_b+!xSCqn|xd1jQLYxI7 zo&h5Z84L1Q78qFL`wGkP&g)0ozIycNaa6S{KRrDif{S;J^=m+UY z4%pA$Jn206Tza~(5%r6EwsotCI_zeKwa?erA5~Lv`#Yn!EjHxM%uLglwgz@i_zS&X zzV%m#-FE_q3K*Tjt6x=H+J?9Wbd3&K`~2->a(5ASpr8doU0JJ9>_1(JxXCqY955#B zLUB{Cu8tZvRS$W+aAgGs9XVoyhcHGey2H-z7xGxyaQxEArQfUuVMn^*^UEb&&`&mV z^zzt&VWK>VTzfUZ)b{P$tFzx-k0%@HGw|Y(aB;XhC~00BzFcubqm%|^>F0|-jrw%= zZXa0c~C2AtxYOXo8m|Y@H%#TPF^yny(vC9x+gcK z(y9DaB;A-P1N@e6fsJG@=z>Ye;XTIp{!M5WC-)Ae>2&LnmnI(ki#)p``w9xeCgt}9vxv@f2lsTeeOoTse_&xBwbys0tF3SMS~7iXwxw zPPehZx<&@~z6E3yxFfZgZOw>6-@AuBnRk(QJ)kYQ4=$Fm9soeU*x7Hdv$DK+B=Tt3 zA_IUCW3Q^$r)*uW|N3@JZx7};=M4yat$a2rStvQ=`tn16t-a6#f%+IFTjXNV`q2ug z#s;Hy*wg`z-LE5*TolnRfKjKnKl$R+5P!b|r zM=)N!*oJr&r5~@C7vB;6P~<=rxJHC`+d=+Rd)C522IvWS`C z_kiiBK+~}R{C3lQB)F-nP6JgzE=NlMr}DLzZ_#t0fs%&A4SGxoNJEs~IlkCFy=%a| zh(Vtj`%h6~gzKjn5-n)NK#yO%)1NvdFKv6WNpsq4HUd)4eT!#Lr zKOg>z#^SmR2K*%Es1MljLIVB`R)EKj90-oYu3N7_1Tq5eOOtNi3V)zNQa4asKraRa zQ-Tc82v=hNNCE)EXU`p22ud1Ij~~OBuGhAHxayC8{l7QV#qF)@U|m%=mhS}l`}gdC z(K4r|O!+SF+D&w1*!u92l0|;(1uPyL5zp!%E80jupp8iH7Xwew9Necd;$;{WpK_OEe2GM9Plo< zw_sI{0X^WDVD5?rA>DyHcY5A=1`utLc~B4>wPtzsuKuQ9zHEU-CqpJ&21L;Spg8;Z ziwE1k-7gTifmw&u!03o{=kgBBwr5`oD&(OPApQzM!gWn%UJhHUB`M@(GvAvN|c42eQJgvZRV;F?^z0x zHAQ`@0P|RS0w4v(oCB!n60v|yHW*Io3y$V+>{sZOhO3(}3O^Hb90GC_Sm=F5O|jGt zx4<7x20t+OASU#o3QK!ssuj>b&KY+aC7`_9ArL!qyE zcLdt(388>e~s1EPn6#!Ggkz$Wo64^Bd z2B~>gQ>vz})}u?w?L9y@BINquUJF!)eU$>Xu5GT5f`$wyu%n*y{_Wezted81Os### zHYL&xTV(wNK>{%I`w#91M*EKWzE9kwO;pvT8}3)BBZqp>jciv85XzBuQWCBo{o~JZ zx_9qxa6h13lB{>4&on8Pu8}uiH32lb^u@U=^z>xFSXuz0tnfyhp57iFx8;oaWIm;9 znt%U;@nofoGmvo3QQFPAu;}gK2=GGT&NEoyE|Y9W#=Nl^O;vsLW*2So_kWHevl8>6 z$!rIJO1+0U8#k|hut#V{f`vJYn*s~D%@M924x^$UFq+45#rt&%ES$vgW98O!BFB#f z{Uo%-a5;71AqD|Gg_5dRpn#zs)+DFj_>E=>P^h&Cz@AF3q)dQX7TH1>6wLILg_0s6 znUlC`CNUHmBH7-0If8MWjl!5>h!IfNI~JvHvv5_mrr$M-rQ|Q z>S3QT(lg4s$#zhf2$4ESIin7tdM1`p_ui}6K%hQNaaUb)*TNp-97& zC~+X!kAC^T4xwyqkd4@*VR|@%>GDn4&CRF4$f>Jo?`|y%pgrBNv;+3uN5V+4$7v%T zDGB3&IF;1D+D0%2JUtTo_oPROIv%0>R1HCflpYr#A*LAyDygf@zMrVJbsmC!ZempV zUMZ=>(ZeWtz+3Yz3;+eS!%6)U;CM^qV6!S8LS#@$;_{o#Ue7^*| zW&V6T5`P}B1z8%%`)JqB?ii~{UwnO;kxxE~%S++rzSJAZy@UZBDrN$?_~>#H*1#R{ z&YWBRe6UA{*Ve+L!{q$!E6>i%v^x3IQ=wPh$(Ik%(Ws;EkJh7kOD+5U??M}CxT@CI z)}XGMHae+ks^5PR%7j&S%`@c^x<8g=s34{tH{y%tK2l6j=mRxboerj}QnkkE%DiP! z*oQ%NYA;YU!r70th4>O`VT<{ffrO=rfMq6cu@P0r0((lMU?dIFOlu|u?CIMv4g}$d zPsm#@uad65!ZRqxQ%^tZ(vm-V>u7tYI_@r>G4hW3)47{UP*1~6KY(;lk+DFY0O*O+ zj2j&d_|Rm{p{za>=atUjXUU67SW6GIOdUw3(+9%z*Y4v;d5XG4WX0 z9`#XSptCa9qojk|U?!>o@Bt>S0_uApNif$M*{e6_J*$_o}OE!$#iqOVo8AS!Ad({CWB`cD?Q% zPMPxkU2K*{T+SI92x{}cd2~DsW6F!V8~tq94^?E@uQ#!ylLE2ZE|O2hp7<9Cj>e8V3En^Eoh)0rC@$wWGI z@d8j#svl+X^S5vM#JL!g@vz|e*g0uYS^mt=Ew$J~4e0Jf2Nf#nhdIV`<8 z0K|~={-?nUaL5J$VkmM6CZXuRsIPcQQBa(;#?D3P=%)mPJMlq zOQq9qp0B;X%bzC?bZ2rE%LcXucnmsxB6NmW;foyX1dL(sD z0gbFrmWbYLqq-rt@(4gi1?)A?7}!(6c0U-X7Z>5S`sD#7S>jv`_>HclGbVG>_&fD% z`%C8%o~as93;=lR)~)=Cpu*XU{k1Wg?jV4qvJRvHJ$NC%roN^u2Rd-}wUCp0=bWy? zah;swwk$Ow$N|9?WS7j|eteaHp-LEdx0Z_ubtL$}w7#f`gb zZwU6$eg63Iqkv@n?$7?iPI^y;j3Kbb0&~dP z2Ggx4j!AuYfa8(fabg)vLf%c(kyy?+WerDkeA9vzQTCyI@eyYkKs9BQxEYRE%NVEO z42dj45NtXUObe8OLPQ0|A^_tVq7h68&p@1P7eYJbH4JOhhdp!7+#n645Ce_nv zkNP&%C;d@gHD06veaRG!Z8l(-3HF84x>#=6b6HKPfVuy%9!WR5!(pM^R&=kUX9ILf zI!~&f$DW>lf4x9q^knQXP)RUqwWf?s@4dEvj1WWmKkhyd}Ym zLNH7XUa6xfOAsMb3whgQ1BqGaWuNT>t@-uC=gp|~D}q(ST0rHLyjc*6Uu-gUu70D` z8+gI!c$e!wEfA~*xiulSqvNxr<|NTWP=oWPi^|cfl>z{1dJXGo*|>ipporz8OEv^w zMza>&3+Rt^e6-i(xl@c$c`r=`!ukO#h0{~Fw@bc_U8vn?~;zNVl`Ah^k2bH1$+V`EnQ^6c=Lb+7<@x5 zo!7(kqEcP+ZpHws3-v|RCS?lD%Wl$>Wn=MTlbzfo1Ph?9?%g$kReY+^3d!9kcpanq z#V%+Ao*^j@l6hK}X@Wnmw|i@RxM0-=CD8Q2FlPb|P(q*ryr(YRxwAR|fu=9tKex*|HAkdrXb;^JB_ATkvjVdQAln|51jJSxKwWvPOhwPe7I#n1nqESFwkR(fk zoV@+&!DzW;_y&qsNK7aZH0Ne#tKWWh-Y*z_67*)sBdjlO-rytjKDF;ll>k~ssdS|Q zO#;$%eMx>|btdmpHBjikAZe;X%G3EJ^+|nR`p)vwd#@dUoAA&4d)HXoY6NpzKi4RX zzNxCyFM%I0P(}uSM*gx^MAkqy5xK(c+s=jzzZw!CkE4X~zDSaUTMCns$bD)(k zuN}T8k-nzVK<61owKY1A>Lc|ala$%2Vsi!KP|Qn}DgF8->S~gz8nk()V@KRF5C|U>`bSjQeY9bF+&i=|{{Q+)V?c9`79od&f?m#DM4l zDP~_AR2e2=*9aHg*JrvJ=Euzj1Y26|2mk1?H{+Z17P|Gdb;q~vF6=i?Ojzb?2m~Ae zu`bdd=)I^Mo`aoPNOf3m=Gci)$2aF8ng)e)lj24T2*yQ_S)1d{fI!MF9op}XEBk47 zZnpaNqTOJ3PY>^(?|$uwjw#Rgk$+nkRxfQl*$6Ee1IQ#(FjShU{bnIJwBR7TM6}d1 z{x};muJ26*&h{H*4+`o)M_+H48pZ=KJo*bKqL5WX2Cp3LJUi(1-Y=;B50%b+w@h|G zI6H`!8A1E>U(8)Pb@d_{n1qu)EK+OU{$@@RVme_RSNm=C&g}pQwCUWX&_JlO!JtTq zvoCa%f&2bh0*0`DgwoniEbu`$>Y0Frh|C~%X+&hpN}78?S1IQQq}lb`Pu@9Nt*xyo zrSk!lLa>lkrf3s|9^twyhKGfS7zrEqp(AskV6^lm{pnnPXP%aj%D|N# zq@~VXxZ^z)C$pGEvn%W|q1|G&;k#~pM-;-f3guVxSG=$IaTVlZ>1*1=?no4KWWxQ% zdT*8RE<64zSMhaRwvteD!qbyf+GTvRU(?!t7sf4l#nJk!!ka(JRYCM_Won z!kfmP_K|)Equr;s`7{LlB7@ArD##VIGl@-5f<8z=$E5wUyy6+S9{IfsJKM;^-H~jM zS|Wno`i943JB}T=6bM9msktxaK0yPP4jt%uzzv1qi@HwxW#C(9x$#0^keW9GSPJeQ zOe(oCf;KW1(n*ExY4pYe3DUDwqV3Yr4CcB8#d zu;Mq8d8P9KDc^@{|sFo24&A6uw z=%!0u-LEb@U%3#ynupewO&(DoUX!Qmlc$0DK>ZR3!4z$(!@U=uO&d?2 zq^3iiy8JwT)H{87X_NBUMn< z;8a~#Plw3HA#&&<8`ss1Ze#1zbYHDj2^|y^q z3|?@^RDoVVab9Gkaunrc!M2hM%K5g~dkZaXNS+-Jo;T{NU^vjG!mpoZrKPC544J-i zroV2E+bkdSvkU!kA4Qppyy>@M`}Fo!F@5#TH3G+o=MiqiD@XUWf1jB92Zpsw&vRzE zS37s^3|@3!oV}ut!0fHSqN&ZUU0dMU-({#-(q;7hV#GYvP{Ru|ON6i{y{0v5PQ_Fo z#Rryn%R9=8Dzr0RH@rcHi|DSMCsWV-?rP-i1BY@BVZlkFQ$xoVQo_uGiFf z_qEOwDN7pV+N3-wbD5mE7y@8f{qT%{z4D~8th8`WKJN_B^ZNqzWRkH}qo|W>fRjZ_ zK!TW{GunUj_OW($-d??}s*7$VYS2+yg&{<<0>+v^E_VfeKY$5QSKT*dqr6!NMuv6r z!AN{{R0(@d+emcn+~xuhDC*}{6C<-~_?GK5?!LMVn2n$JFiU$+9-yJUgH5K|e*=pU z>WMoyxwV)5tBRMFMUrxT3@HvQ^RP>b`5FT=4$$n zl0G8ZiaIwWkr`z&-HkuW{dIml6&LUf~9Vi&~ z3R3O+_U`K389iZEZW%AJF0I~um~3JfcFuM=mQWpgjd?~w-QD>Wd&|^=&U4Zn+}B4{ zsjC4n^Z`HwTKSCwSZjzy7=fvcLyJsz-<~_zMF+Kga(ReM9D@((oqZ6yaZL2DM#AzA z@bfIa)A8;;!h^T{y@f6v-k*BT)XgS;^pOMzu(0ucohX=#eb^Rd@SkB$fx7)N;$OW0 zg+o1M*Xe_MZk?DkzhfSFhj{f9{@t?^FF!Zroc`ttd9NYa>wVko4*{kRA3t*5mvLoU z_t(|kyZ46T1`G_8u84U={Y@nXM9RI(u&W6dn}TQjpx3y$>uQ*jRKE~!bl!nrA6gf5V)wCuH2ua-BufptKLFf1CHjnAH9r8b zH|!w`>Xs8$aKoE#DJz?4QZrxfBEE#NH%9UjF--c=TSwbUw<7S5>s|`Toah~TV)W92 z-b&<_X)q>gnk|ycmD!sYS|wM)pO}wfj+Qqnr>qN$rEgm`_&&PN%JhMBpE+Wo$W%U! zWht9;5+~fm3G}u9S@-%9WtO{GuMa5x)AY@W2FB=8c24%v z2ipzr6GYaWZZZyBhQecS4?Rc<+}<1i6S<|z2LRKr#CvrB90=K95Eb`f%hs*Q6;yZb z_CE*%;1Inor#8KuEy3ef@4~LxpdHrmXp*C(KGaxM8}`!2y6(IOZKa_zO~ZRy6o6y)^*wm>^y!Az zNi`2w*naCjJl$}h$;|X@Hx>bK(oNd11+L$^Z`e8t00NC|)9_x98VmTV7*)b3v6Y1*$7HHjvW~bkY{!!p$A$3`Uf#}sG?!64xY4`uV z2PVizt@gIE!2Ql4Ixq(Qr1bTL?#{2J!`-??0Ih$0B?q$Z+}Q=Y_~P80i zT>#&5KtoOPi}ek`8&nQ-^XF_@mkUmtK8SyOpaB5?xqtsFo8Z}FTsL@?5OOE}$LbAh z24ILHY&WHVVVCjebJwd^mt52>{q>9f{j=#)mjx#`C{HkEeq6Ah)X~iw3>Kcb5b9%+ zidRl$ybVK(ASxCGO^L(>nOgyzY_9J5!wfGy^&ALA;tBBY=n&}Vbqve8DE+m2>rtF^ za*t0n_D(6HUEEmO_%KOOAIZKh+n~%SUDtiEjA*aK&_j2JpKZZEUT$78xLJ;hPz3dD z4ojwO9t8qxWDc@&nfUS&bs5#=oJK}0G!anZo(HCXUe%z0QvTq_n7)qZtR_>5_lH6a zIIfH)7CXWFoIPZ;y_H0mC3Kf|KjadjLzp=k9>cd2v{dindaw_`kFR6&Zop%(V;j|6 zk>1rN2x^E7_1DKG3YOMg-R)Iz;KW9brZRwsvEWTaVzb(|eOnL#w|nH#C+Are%|q(l z>6cIEO;CLh+N%Tjb4~ZLG#|(`K}zmDSSQvgcweTas``zO|EJ`q=)f$C_y56D&k%EH zM#>o6ALvNe1peZ_Y~QwB+_kK%rUnU$J{-0#ezBmPf4-;cd@@iaOkh3kGy%1 z(Ut_XV(SvevXf%eczA8@HxV*O5pOtH>4tJUcFqqb_T$I4&%!jl-QBl%<}cSss>ye? zah%R$u@s?q)IkrVzG8tIr09A#!zRolpRl^_+is$2Vr%E^}xW^sehqH7Vlg1o-s z`-9T)-Itk}?%nc-FD~XtsauE2Ir-|*U24Am;}Ihnbg87H78dqY|41I=jkP2BP?9LW zjJNhtZS2*DX}aUrIZ4;J+1XiG?Q+Q zXv+99#`ze@H3T$w2x-`4*9FAzktPlG0=^P3#vK`x_%>Db{+mnHBO72aN?(3+vj`eP zhHF?rOOXfkxN_>d^U6>+rZQR&nzgBID=rit^K2%q>&Sl6&GvLW2w}&J2c?M>fSArJ z5VV)+g6#LgP%@q`IqxIHl?EWCOsZd&p5GgMf6@lPjLF!jvmuS^H(ekiZ66r#zUYYq z02_O(7PW)|yO?y_6i0TW{zuf~Hf^cheSK*a)SE45 zLU4)~EI8!XCqFa*U~D&Pz>(o1Kix{hA^~7z0TAuLCW4qcy6Idb3T_CTekX#Mb9{WjIcp z5k*w(?h=n1ZWAU)^s!RDBZn3`?@LH|n2hN|i06PY%IpIPFhumU_gs=?eSQR30Q-Ug zoObNk5xfe{{KbzVOv!+B1TKT*mXoeeNYJntMPUR?rf>OOn^;fg*VcoE_`%7S4u}^L zJ^~l$a{3R+q*4cr3?zRdf6pEhaK!*XX^(JmUW0wWd&^e5UiuR3T*cWZg=5T>!y(y-HrkZk4QRpYRkL2;B z$57T8^zWe6(Urr&8VKHM9=cf+f3$oX0{G+a5ypeLe47ZCfQq@Us59ZNcI}DpNMJ2u;SDM|Cozs70l1gc!HrVtVcN7OnOzi zKlT_=fWrF5ti5v(Uc3f4Hp7uc|LANN#n`XlUM6;MO!<9#e8Zr2fS_Ns1%sR{x9_=r zvWDF5U9&+G%oC&2YTvE53kO>@-kplxX==Y}|2bSVL*U9#obK+tXa>YU5{jHVZM_QX zs(SA5o`KiZ!8=d@Am|IQqOb8(BkUM>mfF=dPoF!u8?zzjN)rThG5>FDbn~UVV-g#m zp*MCoNI@H#Jg`RGH#hN-Ja-2qrX6OoubEySqTmXy>pdsnCS9KW?5ghFcfVE`FfhDh zkna>)#=b5Zl12vtU^^Ko-J~GD(+h_Lfe*^fp4W%U$rEMiFM@w_sgJF%vQRQ=PRI}p&kk6eL9FI7%tWB?X|w*spqFkq;;KhGRf zzFWPvQ~&~cdV<{Zh}m^I1JOQ-Avf75$WczV9*HPq)W>74svu=5N%mn!F&c5Kv5&^0d51H*9YBlLpZK%ppv-NV%N*V~;t0QhSh@P|m-LL>`8 z?%?=aPGS{>h8|u6vi{NSH`wRUhE~><)F>=QuXi|d=)J8SB5WsEza z`_f18H*w#yCQg-gAGX{3{k-z=S^QfjA~D$yp;@wbVFw#|bh8bGMa!IaPki(<{Sx%S z;OU4GFsMCGMr*WF03f6X#*X34)QjdCVbnc$FbwJ479|aykX+{pD37C~3FN}ena4F* zuGaLE{Tr`KFu+L8x%v4v*F*tEYsGrc+8KZDyBkzfNSVo}vDgalEL92?1nx1BDkY0b z4Bc^GxLk{)RZH`b%S!txhbx|_b@kE_`qwk)(Ko0cNtXV3QCB$tPG35keAfzL3N7s3 zqXz(M{c%(bgz0EonfEO0X*UqR|AIcwD-#n-sGlTdh)Jwl9D(LG?9MmgrWC5s05X%BTG622gL7AkikuP?8DbSQx zH#Dy&1n6mbi$-EDUmYFS+JZiAy{$^;gX0bXl}s=%Z*uP!dl^#>@aUZ*;`IY+@s%`5eDfo`$I`@^(ls|Ey}NM)iPr*-wyUjL&=A{5f? z9zAP^uUp5WKn0|85(Vu@?tL_g@C3C#@Jwx;>hU!bBiqnC{@aC+HxyF)s*UPO9$yW^lPYS9<1ax4*?>;hhgfRRnN1UsiuBr?*C9LX-OTkKsZv=hinZo`@!=qyzRXD?C# zPjE{}z%W_clz`l?$)Jyz;3lYEHzed%m5>P}Sft2Y3OA?OBy!gT$+?_o76HoOk?5B7 zEv%~+Ka*#HywXghv$e7b`vuQFC`(#-Q4woHWpbH7RMq_Do6^YUKYDHF^mXa12JgEG z0*_ez=5&m}Lrse7A98c4U?TN9^PKHxsbPFw_0$e(6t3+E0L&W_c@E{I_*5aom`(QH zJL5p*V<_Rhd+}Tk=OwzA65sFY@-{Y}RIB&aTORvOP}r#WMjJ>L^tGthn+QwCZHVcR z9@Wg;ZB&MQs3Y0g6Z8>!gX-o`y>#N|AP7kMi+l+E(H;T%yUQZ53K~suT>x;!<-}j) zk+(sb(ZX(&Obnf_ip$(>?hf=oCX!D7(Un66V;E&Qq)`vveD>k>_=-bKNQ`pEytue85h}#yWagdcZe5-E=Bg~Vc2W}ZYU?FjgbN>E zeSrx~AnGpXvHRyUmq7nz4IstbqlX`bS$bgWr6c`OelFmLB6UBB@bc|m*xkPGK0W1o zyYc)^zI;fWLXW|<3Yvb`=mF_LI@e^P3kwUG9)IjxGbbZsK5FM$^}VcVzB;3e^#WuR zpPXl*N{oN@pk67U7uA{=pjSO3KyUMV2K4mxQX94uAZyBcg*2kIw9Dj`0+rAe%MJc! z447APEO@Ak*o^6Ot_VMy)u7P?)^wTYO(A&5R7)VmoPKM@0f6LqX9JJQIX-ysjENf^ zAU!Jf(A!Eqhw}g;Kp^F-VO_!_4!}W{V@kO&wF1{zcTjUQ&ELOgXHwcl`}JlekQ3kM z*f`n2nuz=1zKOWYtO5Clq;%d5+8e$CFiA&?ccQh_0n+z0OlF7 zX_?>&Q58hN)s|Om-c^AV29zQ#YmXQYMFXrVlr;o9YFdT?puj;+pivRT0C7MP*(RH| zL`HF+woaM5@apR3@*N%_g1MXl!L+*+Xy7Eu;t|sW;2}Zo;NBfs(V?Aqe8g;4z5ysC z_%dWnfE$f*Ilse1`E^U(fPgj%a48IvAaDYq#e>#E%+<>QMt1CQ_j&nY-tqjS#z`uX zEPg=Qu1mx+?F{2-YtonJE?38%V~)^LAfA`CYiHL7R+oQq_EP@@o)6b#5d}4~f}y4Y z4RdFnH(|1|AE82BRWC;XCHw&>Lx%=WM(8idA&M1cGZ%I*RBL^7HVsD;Y5osiUP#w+ zxny20N3*m)zHhKFv+h4zu<&0Zs8?#B{t%!ZZE)kKc}DbTKu^daY%5J>_5PbjtMw?N zpk)D=$1tSXjPe?zmIPhz z_{-0=*XzKQVU7w%+23Bgsg!QSTF&fi_Y|*X*#l6fPZwoj>$EC2*Hk28xJC)$O%lvi zzjreNH9UN+YT{0PgqIy>j*ys2mUC8SduhlwGUg%1E$)y5N} zkBG)Vb>GQVFTMV=MzY-a&3p>z&|roF?2Bl@Y(NK7un#E{(6wpTPUnT?vkt`sTq3X( zMdl5=)$`&byc>}RX3PtLo5;hi1pp&*H%HXMlm-JC>fY^ zaNiCB*b`)-3}fW=1o{-Vf?N+?4S*rV6phEBxd0UdPVW2m?NhCi_~yIoK%fqKq}#!z zx;kROKmh=BcPXX}rjvU-V>!~b)zOqB^UM47DDPW>N*#Ia^@`gDFETGJAf8&*ojXGy z@r$#UQ9~4|n**;io{2$sMq^>un*llh^pyo8Nh(>oCgeQ=Fj7@@guE>b-XGqXgGx*8EE2=`Joy$CZIG`uTwIqT{I%ecFFz z@51A9$%>m`%`@+xrmFVY$h#5Er<+eBg+6Zu;&~yb{rtPz4t^i<9~A{y2}d~*?JI)FhVp4k=6qc z)KU98000RYTnf{a5s3!U{Pg^xg`_MxUf%^TAxJWFjWcNH=el1Q9&bGHW^+7ed;oA; zphQ|Aa44%h&JE{)Yw@uod#jBnpsmr=&;)%6yOGdC3ULvL4}k=dVC?PeK2C45$Mjw1 zlQtTaR>HLC&Rx4bPe5GkwHFSuL}XlxS{+^fjJZ#=jU3iTXZKkQcoENpe!4|n!5CR2 zsG{ahgN7VMf7D-EjE+0AWMw(I6W;k4Tv+4li}4Ra{M^o2PYJ<%VdWg*-CN8Ly{9*o%(pjHtLwG?M?8(ZXTQ6t0ua=|gR_F^ zGD@mBK#NT;E$xT-+qQ2TUU$R2WjtPze(V2ipWas8H}`7~fCVj&c{Bvu>x+GNX_;&Z z0VR&Rdyw&P^1q-`FD@Odp7eHtUoQnzXnvRayW7KZWJ_^whCXCH1>+o+T!2VP8|;0O-@sHP;LKdjRlp0>Xo^Aiz7jV}aX|j%W8}i|1_9l}YE` zmU>Hj$6z22m>@0-$%XSf#SuW-N^qPxq7{i?icYmC zw{M&g3)Qxz|7KelzL<=G12@r~93J~^ zMHtH1I?mnNUqA=;?F#yJb7NC=%#Momxw0Ato~Y6IppN8pEYdjRwQF}z7o9FfgivjMAD3sP)R-uZc!xWfu56tF8FqVCw;qeo< zVV|3us}>KtXv{{rUbu2w?sT|`+v2I2rka|H0`QRDlC^kk+>^l-nt1^;G}>O2f`ZuR z%sT0pXClh_V|zSP08xB^Z^w@6QTvN?_-Fw1O_Xu)!hH3Z1O0}zPfh>E2O_zm@!anw z;iJdv)vnenF?b_%<<*-w>e>fxR)^`G*B9Hr@YjC2S`aCIdS<%%>=ftCh-ilIsc$Z= z>Z)l$ZN;@58g2(Xr|wLxi#_t4u7G4@_x9~Q$e7(`=e_vW>x*Fk z!zR2JxOq~fea#QB)|+mU9-aw3TTk6IVbXHE;srvyjBy=rxAL^Z7q)Gi zYS(JokJMsvN9wT`H)va*xA7DJg%N|N5o@1b@F`&9bZnSS=~VxtN3}7IKAT_>4R5F5 zJ(WIB%iDi39-F=!>LaiHI4bIPhsNdE*+m3M;Z=NW*quTSGgNbxYDOp_gFHAr>4vQiWv`k1^NLF%$2Pzx|KL zsr#_aJ4WfdygGLAnS0t??d}>3+mL#()z!*s7cn`?#`4BRU`oNbvB@3Y;^4mdWPEurfbmL-j6~EYxLbH6z&xIv?c{9l7zn0ZU2WfH zJOmw$A%F=lU?7W?q5TykDTH)RN`omjWKh#W??sCBj%F4SD?jQ8swAKs$+C0D&gzSE z{Sjbqsrvw+N$s(3Rw{z0MaQK1lKT{9;lUJEM)1XWLfK~S|-KsHB)tFdb+xM|1J|eA?)Mtt^$v5 zp*6s!*C_%5Fwn71=cJ!bynLknd+z~=(!QC~|0!1p7;2i^FT8EUkJ@SZCh^p|c;!|g zi$Fn@Wjy-)6kI{mm!E3w{knR%_7Hj!#eG6~K5d(_o{wHXMxA`+#;Rg!gusTF5b(qX zxL}!!w1@9S%fNzC+P2X;Le9zo8Dp@EphEVCSKgC(Z+q`wHxHbX2Ce^T5HdWLZKog! zz72fB=hWP5h`<~14;fqlApa5kp(X0bt_#p&OXnKIJMFl6sdX3udM(cMQHqeN^`Zzs zBd|GV4c8PPZ0}L%-Hf{TQ$u(&MW$bEU-TAo@IV-oUvG9`g5Sq}+v?ssXkg;UKy|;Y zZ*JBRSm+=Q!+&V*aIQOU^HX<3)pI!WThx7Qi6qwybl_5|wESapohsEsy6?qjtvvRLD0? z%4;YJ#JFmH%`)DTdt5LIH;KaDGv0l61KnvB<7w+k+*rA3Y2A55{ zB`jp7*n@|iXD8xg=Fj~6d@}!1@u`=vyVP`Mc6NC1&G~EnW5@ORgXUf~H)g@o78}<3 z7AKezGO zDC$rm1SBY)gCQXt`ySc}FHog7D?IQKZ975Xcw=(s&K(g8!{gq4c(lG=?b_wM8F}%Y zjOp_<|DBUd)#q(wVmJ5osjeE}X$FLfYSA+G1(*laucth*?!6?Wq(~}fqXrE7(NGI& z=P2Bo6B!{dQYRY`D9T9*bFsCMnb4+KLp6h+Xvj#ERRb9$%Bzm! z=u|~Y{JoP)?K=?BT)o41B1dCnJ;{cgrWtf;oYuW#yD81Q{`Y}|{Ha(nw|YZ}Uye>b zxs*WYf3Wu+T6W|}mf-VXkP#F?Et5=Lx_ZR+p56cdf<3c4Gu_qIRjDOYQfvAixP-W7 zb^-Sn5lq7JoMbp)Fc<&>-0eOCAkUdkzqx0Y8J)xX_YrUxZlQMc`8Vm9Cw^nr{FL&E z3F-SJbbTJ5V)y_4k2FgEk5g1&>+PBt%eI@7Cr@?D-ouBFlv)S-5NHIrI^Kls^-vl% z9Ml!+7yN75caCND-+PZAKNh*i9Z4A2OD{JWQayG1Kc2mK=Jip$eucbP)wFK;NzY-& z!D2{zI{UCqfth)!|<2g8o z8{+Dw^>}7*{?6kkPc!;RvvKrei}a$Jbrolb@qN?W{@wrG>OV=R5g6my2EnBi6EBF^ zKoLOb?6=O-ju41Qk3a@>YwzfgMEsI|0pJ<(?z%~p{AH(0mb zli@jxzutS8wm$L2L4U?=o6@6xR?!A`L-J{ll{=3sY|_}yCIAUXy6bKzhC0gfMans& zFjADiwbziFhu)~*OIRtXpP|S*H!ckaioV1EBC$s>@8;*AAc&fsFDDsk`jrTpX>1#^ zF5~$Q!FnN}eprfTJAK~4xn6I#EIglnS(U9xnwR~&Xf}WQ$2a;=D~N+SD#<#UH-?V; z_wV1Bp1UpLs_pXfgD6;{n9gFX9q!Vn^XJ0|KWY7xo~<>&{pudwD(vXOg$v#LV~XVP zitnA;+x)+O`!c%hNz;g-qVT=KNW;Q4VbC$R^j|){VT#r0-~RbSj)hV(83lO2u&^%a zQ!ayS9HSI?p&!fYGCp{1$=HF(l_Jr<{^i|nF#6~@yWBs&x*q_2^ES_!9B_C4-hD&E z0+7c5AeilNy7QJ^){sxB!=~U+9^pujq|i{X1L}$`)Bqvu$tD*wo#_nyL}qC`iSbH6 zlAJMalmGwW!&}|ALcHa7q*Et*-{RrJhdDDm$k^RIG4VKg?sYu=5N-)b01I(!v0l60 zg#?4d;Q7mMf6nN_knzJi*QS&wPo5Z4+#hq9xt+-AATOUWTR@8*-NZ9lsLcK zB)S|VV*oZED5ZE;SU1d7m{@y}-ZCf{tq#NE#S8t}^L=(R_+)c;O6zH7y0Fm!$P3ulPAx!+5&l%c{C@b;{o*t^)>JO?*9sscTb$? zqtN{CNgsR|k=Y2iYQ}4tBPY{swT01xQ_DGAmbJr!Us9TSF+(rV-$LwiU%M^A zaBE=dWP=`nx18>rm~U5geSH7Ed+`8(QUpChPYU;a#GgaT)?-U5(nYV!`y3y zmkUx3Pe~u(wxTsc*qtjl)|?{`=W4cJuJME=)}3zOA2`<2}6h z&IQ75h`PGpFz_moB^5*)x*L*R7yi%x_>zXuU|&(H*i0!_*i7J{Z@UhZ{2u`*N!F8g zZI*seU~?FNp_*X|bGJ2jPqc`T@xu8FoB!wEzRc2**OpsnH2q-ef;Cq!vjBV%l1kwc z%*vIa018u7USDX@c`^O#U*8p@>S7iC`PIDu{BuJ_l@;WLjtyIAF7VH=Aa(E>~gfV{X020)EON3M28 z)jiW6K6+=`bJ1PKVb&SC&3LP|T*lAS0iroi-j3d9eEUPcUHPN;ZcJ%U9zCME;k&LZ zJPl3-gFd)(O+6#K3v3za$+X?SRrl6QfXdyU9~1&$B{rM2HDN9Xhgh$_=;EPRW`?cf z)hS9b0VK#M$~DjB8{Z-1AjR8h{n>co{MjHQI09;%Zvfcp4BB!T0bqu|8ovoBmSfeppS)*xdO;9|0Idy!jwc3^)xk(vR*G z(3|8Y{=|>~WCVxfV=vyj1=j!07M#g}X;jPIx)SJ{RMCfXp58wt-Y^^&4Am44vPVGY z09?+`&2)ZT@E#uy(DW}wnAs{x2|1Gxdt10HQr>@VcA;0MD}1h znBE!?sLYQqIzH5b_WXjn$<7z}=vw$shC>h5rr<{qwT?7bTE?_8=MK&d7juALkpLL! zqQ^%1+dsd~h-l55hcUBi2gEwT*5m(~0lCp@gw|Kq_+~JtOycdz;vX4wh@fFXMDQ9> zh9BKNU-W)*bn!w20P;$_5rE;JKe|fI!GHf`zMWEY(BDizFB8lQiYx$OGE`ukO9uc3 zU|Wf5(18dOKKU8}dS(6a-~N1O^I(Wf^&o=K#7$Ku3?dEv;hVV8~)g-`u?~f`SqN^YQyPyMLc_=j6#C z!1#9$+96q>Rj&)@u2`h6=Yu=L`G0P!;-k60hU$XD9upcn)XUXHr_dhgNZ%5Zz`m=*w3gYEs&1qtPxD5IQ#8UaP{ z{VTR9lp#RX;7_0n0H1xR?A)2t;pigZ&i@b`+8f+U(1y}|`4eEK7;VThGd}k&Z0vwW z#$?IJ*HO!p$(;)`sEK;6lMlMTxjjSx2A`}Ts-hXLOb*k-n-9md&Q*?3h1gMi@$%IK zbU6y4Ft2{_jk^{N(v&fA3@{JKnbJ$xNz>ot}{o zhEhfGUeO<}KgWo~cD(X9(xd|gh4QgpTHn}CNj?CmMIm0gcup+f+i6g0M{;HR=hv^t ziLW^NaU|)~ty-D+ZwCm@xBI*jfFB*>KVt_l0c0uREL}gQjXGpfBf(oHA3#zVz-?+RclGV z*;(;Qn_pFanPwp%ms3;s|LmeoLH2e4!;fxzXVogqpM3q`_yBsQm`uQ8MKJHrA6?4; zWY`+)D3;*jpn?ATpYKd(!jYI*kcojlrA!u3Msi7tmmb`o;{Y3}kspk5^XoC}<}bgy z-A&OK&z=L=i=8X{=p;@v*{n~#{DEWbD&YVaSwNg*$;kuCdY_r%G<8dDMw2lEb1wQx z-A*6R2QO;qoA1#XpGu!=^$>i?%mj+RbMx|ix!;SI=J*HT2gE^AFv)-V;V0?%gC3f* zhWGlFi_=-auZF8*XZ)_6{jm-JZ2RwPeX+1wJoDfsZ*%{_lL`DA8J>GLH;?2nfDsf- zqP(VRu&uhb+<*8aP7TXK&F9;o4-U=*Ulp&0v;NYq2R0e>VU#~SKYIKuVLo?uIFf9* zWaecY*aNquk7sknd@X2TD`1eJ?ruD~J1s_)oqfEHFA(z2icHrg`IdC_&h72R@9%z^ zwVT&Y+2B}8X-;{1x$^IP{C^HmSL6wcH)PJRR2V3TJn0D5^9qcAzL-Kkk#{j`HiBJ! zG60;IGX+Nnf{JV#Zv+l`pFD8}8MbwQiWUTJWN^-3tV!zpr4eTs%yDP&&Hd`>>|f>H z8Qi>`yNN+TsUA?DkbreYE{)`(2~OgNqUeSBbQO=O9L!H+)nc4VUbs_Rf~w z-=EK2d^z4{4vI$iG>3d{+xqnKYBpbe>qmNQHrFnnOUg*+^XZPa0(C?kynp)4aR1G) z01bbB{`C*0+?!VqLd(i^&b^CT)QB%|BtXK$ph^}<5|;;{YA!VAuR#8qc<$hA^0D#v zPyFr0*^L?OdI89kRg{3}P^hU~yRO^tC#Palu%6nweUL=AMbU+TCLB50(O!#VFx+EW)zm<(G>M5eXV_T6v3|Ao@6 zhe1*~cWzysUJbKP9;gEQAXe{$^V8clx|B$W|I?eM_rZ{M;>3x~55cx$avruG_~#ym z#`|YW;;sibL`N4H393%{-BD?ZQlUAA=iIsWj+`$1ss{yy#`$%FHTvNMu8oaAta9HU z41W5^7i{Al$4%O<8$6`Zd#|N?VgdkkGTfcwSDoZU>ojAA+^6x%uJ0w&_uHJHf|Un;U6=KBI^_>?aCaLh|hJ4%gpP> z8K+;j7&V*EzfL0^VlD36x-9AyzJSoY(q+%Q_*w1;+b|PbBjyKHCSvwkqzik_440Pt zJvv`7XeEn*7&ilBSqmZ#p**poF75a4U)8sAOYaInqPwi+fB#*%K*ZdJKbQH#2Lmuf zb%?M+8W*vgI<>d?pa1dI;(B0i<02KWFCN*Eo`Egz494uv^Lsj-Ulb`AmH*qP;Kzn7 zgN7d};E`YQ({Jz@N^CuT_6z`O>&i^Vr+N<*miXC#+!zEO$eUc?)K=tgpZu^Gd~^T% zuYbDJ-FP3EkDYvrp<0r6B-scQ_8}+q=q*-+`{7j61ik1n<44!v!H>^=Lzvofo+`Zm(@cpdSNt_&C0?Z^Qmh%g$rj$2*qQL*4S`8@orZ3Qk$C}{I@o7dIIDEeLQ-O zSOjqS_>~CHdFR*7kwD>xdWY&N0G)Zxj|31V+n5C@Flx+m9uYv86j1uk`*Uyauc&qpb1I{nMuv0MOS7Shm@Bs?vgfI@p5B-ne=`(=2kpz~QKa40%be z7;zdu$o3&y9~YK(_T1Ty?eCv_yZRgpS);AdSxW}N40O}LE-C%}Tj!&GXRR%LaF>j@ zN%U;G@p(Rn(Y=cQ?eAZc;i)~(2k-d0Wx;P0+rdG92I>R?nv(Q+>;ry|dgmQW69U*x z4JgtgkCkEv=g)8czrRTllSAod-L1(Vx-lj+{PY{`HdplSmq`KudCGIhb1s;O+xcJr z^iCSZ<+j-X;H}TnD@*!u0l?q@!29yNxz2V~AAC$daJ*~c=y>bet-RgyZE7>j}IP85a2}o;mL>0_8@vOgLEAFtU&X;7&^|)v~$Jc{-SOtCL zw5VJCVjg^1fmhq`=Z`;oKrsT0RFI=jy?t~3q4e2Pe{1Mimtt|=fSEtEB!G=!U7+v$ zOK9{nL)l2LxdQFt20Xg{_>PT}`9lU7D1zmae7UcHmR>#W=J5~#cra|Koh>B%Ug&S_ z4eN-lN&6uJUfK}=in5+v3XB+Tg$Uku)3hl*G;Na(8qp>yyco8ui@MHi_bi8O=G`=X}uJ1})WQieMQSb%b(_4G@Xy7QDAIx5DQ{8UAsM67}dmK0`m= z2!aeV`5@RTyas3n`q~ilU;cD^^Wgsd44g^l908=LkoW&2S>%tY2Lv^smT>^}dS;-H zSD1p{0Mozx;ZCsi&1W?A2TsM`Khq-l6#-DU+a2&{_v7eDNxH?{Iq+HDZKIPjXI{pU z7n3TE2n9BbTM5IQucOGm@;MJ2cU6o5`aqVPF_Tjry?^I=zb1|{n`Vf7o42baqjXBAxK^i-)LffI%E>kfJ0~Rj63iDidH)TcRGEeiQ14G$S(sbca zME=D=HrA zQpSAB)njTep6j|qy^fDRn4{a!Wh$@^utogbxr5FB{?D)N!jWFQDcOSGPe3}aj-mMZ zg9GoZ9-kG<_wDTYxCN5Xi&<3+Mw(~=@=pHEiTq5h#*Z=@PxNhZ@eV4kM>6(jxRqJX!q#&sGac&!HnUbdk-Juix1k( z=Bjs@#(ZWT0;i(l2{4L4DXGKL#a?P!JRZ{cxm|)$9G|C}(O-TV-g7(Y;qRhzN3@OL znYwld+o6@HOVHMEn!9riU*h*vdoss^Me4c6nJmFYGPIJxf}) zx%S?_w9t8r9OUFL;iG@XaC9fy1TNsYTLvhWW(H{!zwu4HbK*p_b*XnY`)$daWKj&D z4FFvD+neY9LE8-Hi!9t<{bEG|L4HP{JJ5#(830Iv^+*AQ99KRTVV4feBsQ`TT#)sW zMM>wa=_+V$v4Qqw0t;$gR^OATgga1oG=KkBwwT)l@IkV_!t4*{208#xvSq&=(+5+t z*?jqpbpDqPP-1o(?wYvn+#Jp@+(|E>NzFsIsZirl2-d{?DmK1j{`vWLkrcV_(`C8@ zq2VLd&=Y3n#!I#|-06323K4=)zn(jHZu9RB;OjGm%1TbelVs`q))f8S``4oPuU^3f z?g8nhYWcVGP&w*1gHdH40V$u^w$#p%BlMpm_#vuV&`+5~sK{2;$Ib+UET{bq1M~Ro zIl%`26SqSG4F=%)!Nc;c#+(aiHO=lM+XA=|9WPn+bSN`YUy9mOEl+7}l zef3=rEJ8(016EyVs8c?H(MhogRmYFtzd5b9&!2}|;=ULzYy0TEo6~ySIqX^wN`S+V z{N;BJ2n3*%x-Lae*hj6SD!qYquWqK90W9&b+h#@S@M?RXXr;acfz056v4)( zbHqsgz6?`O4A>Bh0@&8-Qg*saHNB{*)f$0|x&L;2R85fx4jUZZlF~-CdPfSr2>D`F8j>CvOfl}UH=kNz%3}Bs}EQMtc$^d2HMI|OlvLwKXaBPKfEYV5E6v}}Hw4EFB zsq@6DBu&&|hk0Uf;_Utm&m(L$S1z43^iiJuKPA&3^ooxw=x$YxihS99%nEji(k+yQ zpcw$%3C`D$Ry0({bjWXkPG`@|7vi`NfKNXE-eb26)t2vPNj;lK%#FjSw_RGjOhpj+zOapZWS})Q8QB@>-_$ynaR>ST zZ*42MRtI{ukvb(MONOo(gpeE-oj+GTff4X^kjg5qRPd*6pQI$qp)e`;vWJuj79)jz z@ojWz1S-R!U>teQX_`kN9oaeo$O^FX4!M+XPs2?6h@z)rNiOp5@naug=^4Mhd#?lj z{BJCu4{jwD`hM4)tJit}AUtPFZA4a9{$^`?fe|kqi0Iv0S2s`M3#y22dk@n~Q4&6)4!xysCQ=%2-1<>gChb!yYOdY+OKW|3iVgsEHl2JUFM_GkBn5aBfD_qa zL6=k*e8YCc4ifasxU(0$h`{+Kq5(XNK)Rq?5^&J3H|?+Pww<_vEjX|ep4|vMiLBdr z%YYEd4Wn+$)GB8H3qcbpG3hQ#KgBg;K~)CC5u2LMw>(TJZm>D}ysUw)Ts)WZB{%K* zxjL93DKbo}L>`dbU526ofRX5YpvV|!cace$t{qr_w&G@tlMh@Cbmq*N{$rtu55Df{ z3xr5aH8|mMBACuKM#)Ukl3*t1zN#L zB)Bk=0{|aCaoa5cKlG{P_I~%H5bZjdi$6}w))tmuSn*Qbmgv;k0xo;|<`pjjtF>zx zn@QSf&lLklUSA0!#2EvZr(S07w+=lzWd3^JipI6u5ZYC{xp<+E?t4A#Iub3eZ8y6+ z;WpawatNO%ZqLq66Grk0{S;adVgS7;MDiisqmqIGvAlE+J&U4xX97U56}jf~B~uQp z5~7_NQGD%q1GZ_PO5Y0r-^Kv=#(t&Nn5gxry-}L_Hj1NZW4_stk~;7OF=1MB_4c3I z#Cskyz5lBp_2SuK1fT-y4LH?$4bTdfO}E~aoim6Wp%{orWwXmJjn>Jr| z3!dKxn#UCC4xMF&V4tD>Bb@6jbSY&%duA_)2z9qtyZ_u``OpvHw)(?QgH9CT^rC_^ zD5CU~V8a=j!1*9fyI%1eb#q+j&E<%xVZ7W~d^D7m4F0LeL7Z>C>*>=D2wXaUEq2bfXIU}`f^!N$7URrAy2t7D zM=PEi$(1vQ!}SdVg_-gP`eHg4i&#UocfE^Dc@LkhHqwjnR%WWJ3hW_k3iLT&j9Vbh z>PTBtzFC&YPidLMO}cSZ_FsPY&OEkLcIudf0ARcM>+f&Fb016eNxz-B{&_yt&pPMj z07eX^|M_>fA=nt#(eZFdSU}@#w-bj4B)I5T_hf^ekz?ET0H9E%(h7?;c807{g1ZNb z{qDnC-RycE*=SN;vY$wo&%Qj~^{13=9);~bqr0D=1r zKxV>tPV0Rmk12iH&%Ztj%HO zutnMA!kl~Emfv=B;o#ixsn{mpjw1l*-4C4f$?I1RMgp}8fUFM!`l-&pjIoz9r%xHt zdU1b7l}wKcZ<00(>43eg^K`-NO#Vp0Cc%mzfR~t`a!E*FbI5L|e{`S>t~mfGYw5CS zU*Ktl^%CABux!#Jpiig&YxPcLrO3qouja}-e;ohBxETfJ$x(jOU&MtCqKlwyX*HaN zl&zuaU8HkEf~11{v@3T+`Opa!`eZIv228~|YfcI8@9b>$_f8SpJ`q4Lo34M}TY4jr z3~B|DXTc(`^Y6Hb&$fTK|KO3eUv)~za{I;krj(JZ2JAMFl%&&GnU<@s7qNOOphI`4 zYy)w9Q1B859?Tiq5(*uD^h3)H|E6N2#Q1c&ixk{!KK;^*28`B_Vz31!D|1yUx>odI z61a`l98$hfgzi0RB5OrU=1HDDxt3X~&wIl8jOx?_neP0?fBVN6nHMf-69k?ZUP#Z)MGap8?HQ&&&Jxy{l%Se}3^}kU5r7T;=X;yoc^=JVTL_9UwI`y^z4K z3?Iq9ozj+|k^7;gloE$psqT|6$LKt=@ogW$=S)VsEF-O&(`U{POMMmJN*l<@2a!ZE z%62whe9Hgv2e-m)v5Nd}?hb7wq5{`H2hZRi^4@><+NNon>0;GA~DI6JX_=?|(7* zWq2UAfdX3?0feG?D-=?kaJ75MdCRny1|vk8A+yUD&-VcpUUB!>Z4sSB3qXjdptSK* zx;;7Ne)#C==Hh|BlgPihRgf=SeDFGJzV#7xPo9Dwa^TQp_KgO38D*fh@F+;(e8|H* zhi}S$O@416!${|3I+OwsY3SAyzPuy{z$-0_>P6+k>e{R^L}i;Rw|?L612Y`X$(cx4 z%gRy!na>xMG5%U31Wa?bGPv9`zH-2d=pZRwSciIA3~{Rr=udTVsFV zj@rz(F!hP!ugESio6#rSfrmghUoWM9<0k=kfHyS{5ohB~U5;LRA3D>oMai&8zykok z1Q5YpP~%Jb^;fWsf^a~kdR1sb1Z;9B-2SVTHn)dofFo!&WPuR`$Rq=Z&E}@NAz5kn z?(WIWSKs1G1F%%G-;?>ul}q|wEtX*e*1D&yVReZ6D^Recmw%iW5 zm&y)Lh|bMACqpm{MbPm+ZHK51(> zE}M?E)tCLlu3xlKI=k(n(E6Sp4W#WHq`0%)*KnUU@pXSiqZHhz;U3-5njse1KZGk~ z4~)d2rKzJ5h;ht=uBfBJ3pYUXhmLVN&e>7hBYj5)YMwkJZ{z7S@`CyU`95FVhFFi` zvXVh|uV>t-6zysn`B#FVMV;(W+t%xsq^xI%t~d5h?gpmP|76hw%SJyO{f>XXm7N6t zWi>wdj(Wh*|8KTKnVc=7%Vp-?o=ZD?&sFpCwYLS^12*Qhf6zM9(VVWJ0q5k6Veak_ zWk(mzdzU(Fn$5j?(XaK>JWIi^ssExDr+*EVn+p;GYGUU!d{c)rAd)P8P!Aq=Jk(GZ zKPO!j(`hU_$11Ee*hC;Z;ER9ditMa?-E9T#y18vPUw`KufQB6%Ve#|FtliwYadAiu z`zG#vf5^VR`*XO)LJDo_E=R?m)UImcds>`{yHxJhtd3qzC2WY#xh@g_iF)M$LSL@ z$)It>ZwB88{T>fl^6jNs9@Ygg;#I^jmMGg<43nP zj~>N@&83cJVop^Y@VZ z5il&;FFQVg%TLDubCSEl#I z%a`u^Rt6oWbn#nD8xxRg4wGs{x@?nxcjk$>cKO2e*x$4ouDO>l9Rz;i1n6}<;v&}l z<8RF$+tU5(iI_6AXrw4_yrAxZe@m}07g5@UgEJkl_xfdjBXV58ZQ&i1N~ACsy-F`@ zXNynaaS=W9es}9_{2l3?pO}mmBrD-|hM&N-#{MrI#!|Dn^(5OBB zU(KbP9|PA;a3+~3IsY#Y6iN7!Z}Pa#$SL)CvLgv`xkNK8cKbQ`(sRUI*6zvO%@^GzD)=13_!eeK@7aF)dR}x6fM#xKj&o=~`vQZ9 zxIzNtnd(C8y;%Xrp0#yZ;f3azDVtr=2wmcY5AJwdL%TC4Pj3GH>9;~r?WJc{X6ll) z{1obS#ltkpv0;_>sHxB6K3BvkNI8MwUJOr53g&+s=eiGOG=<;}~prg{)ZGt?TKQ z|8MT5QDY;0{N7CvtrodOZM*sQ2Nylsr+@gq4>HQPp`wejdg+F-T6{k9@XvQYI=gE( zAG~{`o2E}5hiyX6qyPQq{_)?}P-{``6j(t{v)me!q09U6=lK$v+qbT6o_c`ujE{su ze(ZL;y1e0XQ_GDbWd|_HYMhW*HJn5qWy&vg1+XP^lyzQ2Sm^?c% z?WKQu^eDRRSQL&e&C$Wx)AK{qY+iSP79nH&>6BdNA%SZGC^Y_f73cfMLUrfMcXbUB zwj!XG*5TF|De^5z;Fgrl?ymENqjgytcVOd*$#e-3P&XZ?h59zCSn3B2XdCR&2E@R; z(f~d+DiGzgfHmf`w>f*9DIfSY+9tS{vZhj+i`PHu0YJ;C(JqeA9BE}6)m*Q@lZX#L zgt1%F*iI*Lw%_=WwndT&WC4aSXD4lz0;&djf%>2hL6^n-XVrtK@wU14dgyZfniWH7 z{7X&J5!c}Zwh4w5uLFA^2Cu|;9z?d`UpSp~kLEz5v2;Mp$*Gk8l6vr{|D`SLF}7cL zCv*l9Rj%Z3%AD<9LCRP{lRVqx?Qv1WD-zN%Db+C5aUxE;r8iQ;g-=4BS0GI5<7yQeI0^|c{hM!AmR@&0#Ym`FaT$)Kr7@JtDs#X zj0F|sRGh50%XYM+f}sch!FvvDYq}e5kzjhfeUDBl(t~^>^-j0M{{Efooo+L@*-}2R zFI(bGaii2$Pwe(vcfTLE>~>ujAs~W0Ow1Tb@D-j*T(tt^q&{X;AoNMXrpXqI8)F_r zFIme${(My15a$Wq!dj0@JsW&)ZiZ+_0MLkPgn&r05!C=nf~Z&x1X6N>p3^`v6)=lf zjrVj9Sv1rfkZv08yAO?)-j?u^5}@bw>H@NhqxYoCNC-fzmGt%5h3I5ZcH-0QMT)Eh zWfMN3Ewd`1Zz9pn#p@rm**D;h&kYGosd8jly)K|!LpqS6!xo+AhrkW#TsEY;QO@xU zco{C^Ylc4d1qYy4ThS@_$LeZNs{sqE=AIUv&T z=%NW@+S#1oszrTgbja+;qA{GQkCY>LSNiL6LOJg*W;a5|Yc&bfK*(vcW2B-#@*1@p5*|Ur%SV1dARN zNNtZ7`o{r(3?R^Tv2v5N+kWg6Ssg%xY>F*0aygWUU|%u^=VW`vYv*~{I(+fXPvo5C z^+>tM^^IYQ>^Y~G^YoY*Ig`lKWC@UGi^Tl5uctpC#2>w1N85;RCy{-rY`@GOKD_0f zW5>gI$+lUwVAwNKEib3Y9nOLDLAj5+$h8-0@h`qX5#%$CGWv?JJ08wIO*1W7@8!g8 zqQMKxS@RzWq48FYn!J}pOk4Zel|3>(`x(vGHX&v_@~IgkQaKqhsQ zGq6}HdM~y?paXF}U!S5M8?YHHEX$18fMotUyg+oGdw@ubPY3-ir_3 z;{YTH%+Zh##%YKEslZ(_PH|7Vd8q9P#qz|4YD<)(%JJ9$?wE zfIf}+1SgODYqy*f;HhXtY{dmInL-pP=AV&}x>$qomg&= z3j09@F(|pBxmf+6&$B5DR=FI+Ks@F)Y*bEI=2F_p@WFF>QUHI1wUm)K@t}*s4IN^- zdg*|^30a)w(Xu4zV9io?>w0Pi+WHwk&WUHvU@*}E?Vo>rHyc3tEdYozYffJ@7yu-} zLkGP4<1_CDYF&UJO<`p1M=Y9itU;b0xfYkJN258E8WE2B`|r$00yxgkV<3qH&=@^( zAcS|WA7tyn`Ke`~j$M4t_~vd8!hH1Jjcx~qJ4{}q@uCX}jtKxjtXkl7eHmR$5f}OJ zy&K7P#P~7`t+Ef^y$-joe)a9o(A|@( z-M4Y;ZHe`DbAP%EHu?)R1dssi686ukOzVv)-AX@}?v85;nx?eO1Y=V9e#+jd-TsI= z^W08+mY)wAx$`SU9mH|7dD(X_K7&rGH%_vFbF3VM;Q(vQH};#bmLzMK_pjDWG3uDv zn#*j<-GF|U+5pxw_!vbDf_~GhOFN{cqaI@sX}RXYl{+&4C^&z;-ywiq!9Ow} z73`?UAk^#}>)-FQ1F7RZJD>}Yw+nI&hdI4P79wb&De zG5ON@16kbAzuoQ5!vgRB@_p(2ISf3)4i48jY3P3LKDza&M(H`ofkU)#zKQbEoU515 z32Ur2u0q=goZFgjp)K0H^SCx}yR-jmuw!*mgP(sz0)v@zjs?x{bmuNA#x+DYPM50` zg4K2bb(WgvdRaPjXLd!&e2s!!gI$i^iyhB)9XU0i#DV=!I~lXHG@d~_%5v*;SWh&*#6X`I zFQSNZlBg$eb0iiSaEQ0mPQVIuMK$3JqwK7D|G$3uLZWY6>W81>t=~G35%xV}>pDPy ztCDrd>CJ>wxWyHVl;@kHi^DCv-3_~Ke@>iKOx(&m*x-1yk60NfcK+NMZ>QAD?DPJ- z>LZ+D%(H;Bfrc=uXWb7Jie(FzixA4Hqkih7I|F|1d;feu`^-*%Ui1UlU%-Njhz6)l z5P|^2v*g`^BJnJFus^iIb2)jw#DCbR|sw&kC>*CyF%E}S%=h+yx*KXHAi zWj2p`uA)cH`75_u>{z2uU>%X^i!}w&5elGU0A8X?6P42et{CVMK(0U~;K;{j$=8fAeW3PHmm3v&Ya%spTs~~KeZ`1XLII9Eph+f+1c6Ldmx;ZB&`ny z*m3^se0wqioZLkPoqY_?{q4)~mQ_#oG`EDAC2W!Jz{c(u#+Lz)OLunp<4^Z_jDVhJ ziUlYAnGdX7^)5S^#o0D4FZJANo|&e|k7)Wjsu!L>_iI^aA?X4`Hq3_mE3uciKnk62aI%W_4J9zV^{B%D9)0*(GG zb-)+s1I6Gv0lqQcn5%(cvJO%E_SwK$R?6WmRLrNl?|=b7M~SS`A%kAGhH0l3 zy_iUdKoJCn!v3107A1|5escelZV_?Lo17~HK&CE%m>gY&Q5^si_cC;U_LGWj8^4`Y zypbA~DFATTzN8%Iw6FRzH1GvLY0#8zS3X<986J`ulySfOkBi>;f(~vQi;9MGFT=SP z*E0tgo(4??6HvP>$ry(I_=KL})TvX`hgyH&@n-YOuMb7JdUG+$KUkNOLKL?x4l z-4VnbZt#swuJJ&$SL2Otf`;m44#a$sP0=3%4WfzqwApO-_x3k0UcTgkqsH}#i&k-c z;-81O*?fCfhz`+oP&o+uR_7;TNAE~eIH5z1)~pU0@1qrdh@!WgOETH1#WUuQYsCKU zEq4a!{KeQs&U-Z5a7_4v)sOm`*=F7^zfsKxgT!w@; z1mNPiw7Ywvo0m_Yf!kA+2&t}Fp~q`eG`HLjtB!vBxd)lATspub;UA2p*!IueExncw zQjcYTBM3y$ON51UupJe+Ys=?MidmWU>sfLnV}j>ob$~ziX*v5WG)p6^i78kmiX=fh z7#l?bWx8O)4z0dY3jv)C9W>H!B=*~p+BJ?|Mf#E8p0=HKtqV1%n{wM!va|+^k%w4M z>PF;bZH)U%SR=J}y*A%nT-3qEn=O5Yo%rF2z%idq@#X?wCw6=mM7be%Lvn;H0MOGV ztXc+l;N>ObbHjsHQ?1%ZKRl06?%%Zg@_{G2sC~|$n4$VfmSb4pfBez$eWIV3*~AM8>y;vZ%%UpT;g0_f`K zbpX`q7U0Iz0hS|B=_xUhYYV0sNNyH_H}lr6p4a^f?E355yFV%5O0&6f^hC)% zwVAdK#|~e&rLAo@Uw!){1@z=VW>BNWb6RpKH=uoIbxSZb5u7Y`sj=S!LJekF#7B@>hHI{mq&_y6`lX4RK+A7uZt{7zzA;0 zi+}?gZ{VDJbO8npnyAAu=luBd18nJ$)7D4q_3sJ_%xe2>$1k2g3tjr5bGTtj!3cbA zneZg|`#ViD&ClTdodAH^VgKzwa>&-ZWlpIx=8?z?LB+O?|Y6qgOzxKs`AG=y^aX+r4z z-il!`+}2=K)$VVO+}Nc~wVmAr+5_};QXoAHvIjW~4mUg+Air~O)Uw8>(H-TqH>`U& zNE>{dOS&y}Qg23>rVJ$e=AObJ%A})R7h@xNyts!f3(Lh(Hl^tGGPhlJ#)zQhcPqcw zZW|tuk48EWQI!SY9Yj``2t^Sv^r1vG0<5LdsXzTN%@xzDD)o4hW~vr=1_&e&t|uAN zf%h4jNxF#OtQU)F+@x4cMZN}J8S}-;=SrT4G+YeFQTmI*X~ zHA*AFzdw-u6XfR`$d(g5$7W*00_ z70z}V1KK-Lt%nXAnv*_%`eDBRA9eglzn3AtOQBY4ok`WVcRE%z_}Le)YNxN%9|}Oy zu(-dlN}jPkP(pzPw7pXp)VHm|q%;gkT^MrNIX2S1gs3A6mcG-*Pr$6t!G!JFi6W3{>Qu zGf?ou#$y{&CmY!EKw=y|n>y7YTl(=kE5~%jjE&ftBF8bfQM~wd$KGHvug2;9;L({U zxnnV8Rcp7N%IRLCWo^Ie{knCPomSU^=F@}&vAn)z?%PQ$L?@cOma+K8n7)Zh{LuOu zG-cnQ1fVSI{w`ww9p7S~=xeOlH*aYCLnw-J?t&M-OnitVu3)_Hn+2=U}hNHn_izTlRK!&Hn*)Zb#=5@AlMn~JB^}ZWU zzIFBW0&OT$AE~$hEPcAnadZ>@D%z)p3Q%WeC#pk&m?didT6G>W^Q+6vL)a5A8Z#CM z)v`@S0|_S+Dez?&xcj*~qZ zBCX7MtSb(^Bk4KiS}ioI{wiy zs8ts6lPXmc))7DRr^OI~hd3BHRTb>*$PTWven;QOr$x|HrSk8SHmOQnLszUHc8JL20TT9~_2KDkr6qSJk6 zDp}Vparm>bzI`?%yv6$3ul%_4VzyBqV|%`C{*wW4PwwF4)ZLzMxyP~8DV)TE(A-TaHDJ)pX?(#VLDn(NGeD?$*X)0rvYB+4JluW`*F79Utuz-!BC zVa#OHPjxcW4R2UPyesMU!gWe?o)v`fUf0|B^A8P1m?EtTZ`oEQmLmMxUOI3_z0fPa zbH}<|uf*&L@@YXFqdy&So#rJYR2?-u4!UE(5<|rTmv4Xi`^|cq5QUs9m2{)1T5v!E z3=P|X4BWMbU+pXWvt$o?b-~Z6w$WMT;jHI2GlembG_g>?%}1HPwKX4^>Xg0j4j52s zbRKNKDLiD|kmd;HvdfFFM%%<-$Y2!{csK!Mhd0LY`o`s+Z^>0@9$Mpl*0T=p!**g$ z@6R>!ucb~@FTGpGu&Yi|JN;Z@+Qxn(3=&cLIsgVWyACE={#FD2y(l)iq&!ObNtAgy z=Q&it)S-JxaxU@4_4mZR!<0wmtxkr25b6ZySsFT-0LLWIXzd+k_wROeP!hhGo$dQp zD4IVO5~?lI6oUe=M+wewh9EW$2$#1};6z>K;J&oIH%Fuc?e7BZu z#rcFfzmfqCu{WIeX!XiCQ#Bkpf0q+E@B~}>X@t;*=E-rQq)Ti0Op85)GssENNuq^B&s& zRtx#&O}bm@-N~GQXFmNlJe9KX6!emFabf*6dfqVIeRm^sW+t|3=HP+89 zqz`&|PtV`)b2(Yom4+o!UgiBF+Lou}@unCtD*C)v5DGg0S6aVKpGP;16&EVvc7mS@ zzQ)^)a((Bpga=erdJtEbSjY_5y#5}i(p-qGa63qQ4`NQ7xa-98&u9u;GQN086Z$jd zjsVq#8u2Ky(%HQ^DCU+zSKogl*k`Z&GABv*W zPfJiC^F^Im!OI5bS(WxW_<5;Zs zVhW~0D2gl%+_T_;%5#?mi)G);P^2bo0EViWZpUya zB&p~V$TwWD$LdPff_+F5IrNm{oyigYyyJ65xEj|D9WnV{a32&WY;49y_f8)#ik7cF zk`SzP)vn`G4oZY~897Oh*tRwMlQHIm{9Zg+_T>jBIN4cG8tHmA^ca}oE&Gr}*@vY*6ARcltTsKHSDX^o#0 z<_`I1*zHJe-(B%C-1YpDo4~jaX3lmz0!W`~yo&!G{lSfP>K~CJH8JxPIyUFXE8fmJ6lr}X0hSz4&UaFf_Tto@CpzJ^~I zThOe+3W9=74^(BW%iz|1`FtsZ{0qSA!Ro|2O$S*>hOcAHpr21-sbdB-T2~(UU?|xH z2-{X#Iziu8;pxC#Na$F_ev&RV8tOes%7o+n;D(yvZ2(e-f1zG zib%-kDwn!D5Tv+ZCeNHuxrq0RJwJ@LKMvf}(vh~AAf9MIbMP+XRhW+oQn~4gX17oh6xsCK_@2A6y87z+ zOVl&>TrRbqorT%SuFs@O7RGJ29FKxwiupDe->d5|^3wBCH3};7@;!nT-i9(kJP*k+ zx^caaFUrNW`%iE8Nr4~h#0P&{3y%Ky?vL6Gh%QI1p7$MNvr~G!fRl3Ny>Yyr)x2V} z#{Jxi$Fc5&{)fH+L>()=an`k|GQQLZzsIw5qnC^1Ru4lLH{^2kRsx4^#i#qTPYaT0 zaYOucK$h;I#6i&ZHQ-V^T*!QGlD(f*kqd+OBFRGytP;n3hKX2k@bgW**W_k@b+9Ox zp^opCugmuEQNmStkGZbGiEpSVyBi%JF!e^?;4kEFHE4fXnD!(c;_220d?cOb`?U97 zt8Pw5W{t+xM4C#2X-opGs={OE6k-8HpmoJl{^)9cRfmR2Pg%kOd%7~mfnJQb=+;<= z#y78oLS>U^NYA-czo(x+@tLltnf}AE)N3;J=#kzaCY{cPPqr3x!P-|o8m6e#C{~5> zAK#Dee$Ip&_qyAu}Ka zlIccm30XYP@uu*@iD5B9I|d)Pgx(zGYJOj2Zc_^Ux(=mmUX+M19*0*I!|f1Ad8+W; z`{-jlDS`YDa}3I^fZ`^)w8nARtyRR@y%(RHu+L3O3yENkJRaQ@uKZlu_7$;Y?48WO zQ+V}j>(f5l<2?sk;~#mvY5Fr&neL5fM+U1&FX~knsF3`qFuKuOvNLu5wCS zQL+Onc2F*Du)a@tWWL)obu6u+w$+Hg=`r*|c6(DY5XG`J;$`^-4bOoJ@2wP>T^SbTf(J=dY#t-@ImA zeU7H;j&iwMB1J55#yctenp_~rrCREbxlh1^OC-Q^zC_qcG-(D=tj^0Xiy+_CC+Jgi zU0W_)vp6-LAdUpHtI}r6X}U-_B<^kf=oZWHz@++xagRMIy6CPAGI286rz92zFm7W~ zL|_v2Y9lrZ!OwZAi|D8OYq;lpONJZqrXImfBBTy%Yd1NvJj=kq?OMXSRQn*{gEXCR z&6gDU5VIUVpT7k@Xs4HX=h^Z5m=S@vu|PP24IA7o&zKQUW(EMbicLZlvs%HJW{2P< z*Zl|guv$oPl177YFV6yw%7Kn}iT9C4u60Ul1UCzkeR-1w!OoZJB!5{6{ZVe#921c0 zf=mK=9I{+!zczb|Bu+-6Nso%jBwO=KZe?qgm6_m2uZI}Sj!o#P*Ur&ho}tfSP3cYa z%}Oq~gl-PSzaLH<+hmS8;(A60nAQu>`UVq~V+_^H??^SGk2=j>F)zRTZ0{XJJM=`e zYAeg)TM#<<56W_3n#T3h*dd% z&8@s%9It+Jw4*#j9G@y&7kJ%!LfR_$KGizDE>J#x+iXne5oeEew71oOJhOAZ|8}`Y zXBk~thz(2upK-63Y1bXlbJ2>C*d}%|ikWz(eC?=q# zY8R@p_fry=irY=?BnH_S&C?@|hP z6;!&YGzEyz9#+mJgjP#7$Ks_b?*j^GVJCi#Jl|rRUTJTpJy`J_p~J&sQavlqhr*oT z_c%3AA`IbG_kBzbZ1;IM=f6~58GPzN{KjEP!D34t5vK1p^_8E6kKq!8tfSQ}^o!?< zJz*n_r}Ib_fyB9!Ny`1u{EwYnenm1y`Nzn3!cD4QTIjdto`OO?D*x?1)8 z8cbz%7u4m)aFGfw&-kRPz7(~Bb#}YOtY)Bde7);j zU?!@nlK9qi%%k)q3iaNbF4`0R#EYG-fHcB4n~px5@uyme|$mzGJIn>->k&<9c&9e&PC>k1IRF z;CqbQ{X7tb!-a21F#6>p78si~31F`u0_&F-Z<) z-FlhspUtPwvhTjOI_td*^fL>IO}&Lzqxn}SjFvu8vsbv zMKtUNg~K{Z+C*_x-6ng`8}01P?+kE%sno%#jQ&9*-8Rc<^_iVQ@Nni7=Rg$EBVm_f z9BKlPrm=|J5&;m)C!V$9Ub9#lj_J>sv45~x+i!e+>wqHv>5jvmWx~MH zu7PpPH{8}^pDyBpn6F5~@3S#WV?>jcgM)&tx|6>GaU@(Hy^tXEn-W07|2} zCCGcc>W`SmlwF{;ce~G$L&f}hbBh;aYfs_NgT!W9MXc$#fp6XpoOXp%iUS0!x;D^1 zpSkio-fy4ht|t@2+Z^(Q8bmB&4%rPgyW(t}jC5k^nwjn~B2_idI;bRw5VY0eLK+;A zYn^=v=Iwm1P8jZKyaHA*w^8^1l&_m+2VAs{>ws!wgsF|DtxKYDLEmOFZ$?K@2^GZazywlBv7RE!gsV3FlW%UNj)KL!wmp1u3(P>+bS2hiTl(gqTuL=zz}U24mhZX_2Mw1x@mT6AoGC z+(=$^OH%0o)+W>A6Fi7l6}u=8KX-rG8`7)3&3|X@seN>wI7U!kk(&S>M zrKvo9Jx#lz_A1k{11+O#ZWeQ|_t3Q0#-yNh!8}ZGuycm>iPqvhq8_)IMM+}xSfG}- zG~ov_UExWQP(oR&PuQ$z^E3m04p*zpDhGdTMs6lqWIo+ddiUqs9_+FKZ&fJ9=ij61 zles?&-Hy4oVptLl=|p@8rB){;Z*%|nKNiWI{UP6?VdBHIztTu{xbQ1mcf3=?Ys zAL~Agjj?K@MK+I~`#2;=YcoCQCc1ZYtsdJE+Hv82vYfs^9H?N%q)a!+oqZ9%m^xfV#i(WBGW$FH_2Y4Co1x=;R_YU$stOWUd%S z{goEPnej{L@%a$MQ)gCuIIPMo{P$-6^opjEMuF=~T|Of44Lx7d&_E%!5{k*pkHFy* z)iE=_LK&wO|48I{G-wYU-z?>_q3M+%cVuXdT_EL%-K^}Y)IZr~*gGRJ!I~7&J|->A zA*}VMH&HFpgxE1xp+k)et?s@%ISjy{S9BW;Lg<+QE zVUs4cd#Ff_ddFC`*yvr)BCzep{#W(ZEc1v(z zxCPRzR_uTLgNjl-?~JV&r;@&!Ou(Cyr4Egsx)$mq8d^^8=)iErd7?0_SX8a@*4TaE z6>E-U%!{DsoF44k#$o#btEG2xs+S#NZGO^{7D7@^y$ki4 zBDk-~sOkGtf*e$&=^{skT6BIQ2$-SCT@eZ*nQ9~mzKB!Ww~lteyFVsdC13vr&568I zD4>yZahl$E07O&cvR|R73jZ1{%B#)@1EZL`hi&^6zuAt7on39qPParzRQ<5j+J4Ru z`>aV5^WdaMJSD^-eb%|Ejr!7~m%k}p^h?LlsAOd;9l&h%W9E<0dzdX_qU$M2w6JH~@;_sfXy#81an%+|QcmHXcom{&Hx(FHoU^RgqGt)~8eYqdkY_#n;`&^wrE2P7kh}kuOg#a3mc&Bb(6H`rD0fReIGN6--P(Crqa7EhL zW$gP_OZD@ve56U4#Bzv3X<5vcAegg}3XS=Db|!|lx1kV4{HhaWvWaTu1EW_E4_u}W zl9AMC|6QQ@ICUxAr|;L8>vsKr!iZ^ZPguUA0?hFnCVmV+gm9DH{H)Sr7F7Q&5k@0A1;`PVL(P!>Aji<<>k2vMtzV-R>!STiLDw(!=j}y4m0KK1}OR*%G1@)t=mJsFoujeTuo-K&Wa>`PB?ZbdD* z1Sg2so4}Huxn`%mv~=Unc)a<(gce;2N`c8+TIcg4c&PH0d6Kf>aP&#Wg=1?I`PMmD zICqjC@c>$*0Snl!C~A_ZWZd7sH4n%rzPEa2i@^~D6O7@ih%h?0L6_e5*m|*+E^nj$ zNOok2sc-@R7EtvZpQ^h}b-VRBxT8Y&oW=`kftHpd5@Zyh_J|XD+_sh%l-92xPV2W_ z#1hPLRrJNh*tLyP_YL#3?DI8;GlGg$Gtk_j?pM;Q7pkS(q1r7WFte+O=bLLXA&{{G zDjLR_h_wB#e=lTY||8?{!}kKeM3$sKattL)$p&z{~POyfb~N+7`#F*4xv5zHl{ z+H_+Z1Mf#HX_{pF@lSz5HRVeA104YX`RDHx%dGJSO=D=K9}tVkE=GJ`e`%i`8VB~F zyD?_F=Hdd*pQe-1m{YLc&Mi>A$x8-+@x*FFl4(p_#$o#59v3oFOF<3JrN~z`9W_2G zlDs(e-HYXw%{$Rl#z6`Y4!em^X{?hhjd5taUDpJldk>|q(FgNrL@Hdol~_v6vbNpN z4D*grV965HPTwxn%uTVCjITTpx^Ei2&mZSTH?j5vd*S4hxOy=!RfejQ1+(npj3dHn$mqaK)r3pPmKZ-5KieouwBo3V591G zK>_hlCDCGOV~lFgfok*)WSogr+h8o=XPmcRXre0I7@&Uc%V>le@RX3Hb;eli1u^rj zmZPl33J0!*dG^~5Em1&mM3L$VdMVYCE}(i=6WUqn=457C*b#0o%UMnlb4ea{E)RN% zbH0z!5R~S{*`Hm^F8FSgwX%aCi2PqJlc|pGy2Q0#rU+pz#N6_n#xqhpqLbJ*j=bxNmjx3-`sGIs{sL-tUPDn@r!jIfHFJs)`cZ3ClL~hYI5c+N zFi2`iF$}wI9G|+}uL{fPojvAYIBa?r6Ee3mG@cq`OaxzUX$0o9Rrw6{AGqDB`Gqj_ z-##8O6FK^8%6sG4$^Obl2c#V1YWpmGHo{pc{y6y5x}6t28p2leaH;<1aJ+6iji2FL zQIWrbk3yT%kYMP((NC1EkZ%EUWF`(m_mBX*UIkq^(wGSbpI^7Kj@`oRSV&-@H~?9yy%9 zD6eq%+ug?z@X#we56d{}xG>*&Row$#!sXf34S`pD8PyvqCbeC@s4G{cl&5)a($g1+ zhnN#Khz*xJ!O|iafdDeN5js)xW^S9hKAPdAoVVmRwRO6NJ0Xo(Dl-}K%dBHiXj@5w zpw&3~6C6)Ea_+&YIz)=8%%GUMqO>OSq0O$T%&)WXSnaymL_AzusxEgR(DhZ#bnPvv zWBatKrMnZiN_3J28h|=r&c3;p;78-OWv<+H62p+X${Ra-+U?8)XUgQzSl!P1r|A*M z7)-*|N1^5~J?=vXNYY1VxJq3H5CQv}gQN(d_k*Nza(`V}_Jrxhnlr-^P(5KtG!q*m zV~$*7OtO>l$qgSTG)vW>va&+sc6#b*(bJJZ8LJL9jX?&BH6_om2!PB{9L&^a4vfBD zhmN0xJt2jrpTA(`_$3kx7)$@if&s@IPI2C>hfV#;De^H|lFmMSzuAEyT{DATu((rQ z5qf&Sc(?J>AySGFwrK8L^9hvV=XvI1d?-rVDAKUitY46TJ` zXLs{v+7X!qj{fbjrTnl_cX;e*rb&an7Ctq)3g^eDpUsI8+>&9dOkvBK`>7eAcc$p_ zO{JLPco)%wGq!n&|1tjW9E@qZ-A4<%+}ss0R3kjQHx6O5bEim!Ogr=k<#?_YdcnRk zK&(aFYXMYjDAoos#z@2uW2G;XVJ$9f(C`QV6&AE87tiIh476a5okH3p`d&%bu88uq z^&IW@6+raL5pyhlHj;0NGs~RGAWXjLm&wfA)Pz88$et?D(?YM7z6YFGlST(5c%ju^ z*D2|N74Lc#vJBW&4Ad=3v9ti75X3!H`gTzfzh|PQ{KjhC(NyVnl?cwc;&ISIj%N~oy@BBEEOJb)GVnxpY+S`4NC8G zcxGPwQWhBvam!EXb_pG&ci!G1SGZMJB9?sBkqyq75ywx9i|joDi~PLcp`>*sx;&9> z+&*HzuJ5{EVV%77`WeyRD76yNs6``+@Uc_mOGaAHvqRg4R6V_Tz}>(Jcf>}xbWrIu=>!etEf zxxa=1h&6CgV^o1~b4y}%Pv96BrXV@&Snf>+y?LO(`qBZ%;c{*nk&P9HSzHfwwB8Gb z7%7`=9R9vVHaW*IZe^xjji4KD9Vu2Jvw)+pT}e}!|56#={Nhx>h?QijvqCU`V;FkRDN0a6i7Y3@7vqZBQybYcF9Ba zYhp74&?)6wc`5&>v@E|k?F^nJ5VtMZBD(ux-`nc%Jy1Alny7vXM87}pt-{16znnFTcaNi!khwsW4K;ymt%2 z1j}}xZZj_9ZG_^pPfG*XBj*&1LE>gx9S7LaYA<5|oq@Wv9%WbJ>zEVRO&=;I zVTriT#xRsRk3NCm=Y{z`LR3D(9eHlABLhgA=O!_NV`W#5oQnus;J95~S$;2q9Bv>( zMF4^poWUQ^#@J&{NXEtId2s1yF#6O7xFONeg}Ct`Z3Vc`qglg2Q2}2rUaL>@ErWTa zQ5Ggo9TAGT05um7cVd~MGzT=S{BfdNO+cGy^}E9=DVww7VJUz0pU@Zw$q5H8T~@~0 zf%kcn@vCOk`{3{o=(yDxFNccq_%jFrYSq4K+AwLmr?3ugd zC95-gXnY_CFiEobjcl{JkASWPxcU&LOZX#r*RSTln{KA})VK(i`{?YmHMoev3t=R~ zl#`cT!p22LHRjpAp?91HKn26f=(;;!u2+Nx)MwUa(opdp?=da+VyMMWhpP4kTATHv zodG1D@;6?GZS(beb+6Y$k+*uZGy%19*~SvXIi5TsaBXy>Su1o0zrpXQh693@A6_4c zBnw~WCh8?h)t=MPU)yEVX0;MI(JNX>yA>s-8#8~z_tbQ{@xZnIqWe`vh!T0{uz1K2 z;BjU6=$F6oYh2EW)FLoN+Q>ulEV3nl8A!AaV@#EW#t$~rZb3CJd=zU3SZlmg)rk(t zK7#U9Nq;%#7kf#!qnqc9+o6|td})U5p_eBeV+G)^hXKs^9L>97+)&cb)KJjbYg-kZ zF&=zif2^=Z=ngbHrr>NZ_7ZW?^ooADY$*1`gfP$a+*s7Q1_P0`??gH7`g$#5WNpK$cu z$2fr5vtbJPhKi+bjY>3#-4RJ2**B{xwV=q|SQWs5m~;I;-4FXyuBFZP3LnjvgavE` zWiyPLGyXI)20Y%PHg+V+-$?Om%-4UjuhuA2E7@0W-zWPmuKz6uzyfKF zAls)L2{A7-0|~?G6@_Q4gB%EFN`cba^ZP)~FZIIt%JU9@6cg`ND zuVBvvrElL*jl0~FQw01u;K~gC@a7@`FrbZ~>UVPj{e`Bt14#zfvmqHKR7OR#qn$-{gVcp#-vZbv7_J{!F- zF4_k9`9@>OZJRq5MuY&_3M5>^RLI}p( zgCxY2l;*9t@(Bfn(gDxhK2kXASxY~eW<9~Ap{ypWAAlbg0AdsWog#6B_*UGdFW=l| zTZ;yFVvmx~)yvPUo^m{z(qtb`nxiLV%ZfF?9mH?&RX-LuW^r0-X9HCwn^tZ{UlV|) zRsOFp-~du&$&|QM9aK8`m1cEYp)u-w5Z<@Evyjka{8f4QLymh`57Y3<0+B5E9^}+} zVmZqg7a?3k-uUpPNz4=61#F(V8SRK9AZ z5*(3azA7^!pri^A%YdGC$Apw$Ms7Ahvg3-lLmM13yS@mB4skW~)Po;j1>#q6!P`JM zxUEY!XF={yJyBtM4F6Oi5$Y z0T0{A0_+1T>Hr191_z=Rzt3OTXIT?O_g_bOZI-&g6u@;dH( z76-QN=%&K)o|0q1-afm+0^k;{QAw;r-zYo!F`es;#~WAJn1W)|2_kUit~RoEa;)~b z0W`fXnC$6CB&_V8T$T2+^tA7<`xsq%?BACDd2u3^uj10+U-H)LL9lKhG#Iy;?a{2inS0Me zZ;t6CsFk?Y!q+@HV2Qf76>~-xbX@E-cmd_67oVms%CA#{IQEY<{~{nYZjgrjeYi5V z%7*NmT7}*(u$QcyOSBLC6`0}iQC?JxToWqKPpR&bTn=1?h%-v3YVvwkAC9-~5gk!) zNDG|g9##P77rc1`3OY&n$jHyZ?xSeL2FRG?3po#n=zodxv-U(0K=fhIxafhh-7I*w$NIP8Q+o0HEI34-@u zRsAIU9_5Z|0t5dSl^Q>tdxvZ;Xej?&oh3jK$rll7`Wtf~SyKnKibto-Qyr>t)lvb| zSH%7eW4`Sp@PTD_L+TAa>(bs{uOUyWItZ0>k+HP)R;a3tuHSf2rV#X)p>TKCy?7GX zPq5k>mZ1@(*`o$`D+TDjVkRU2xSIB`eFCPS2N+;~ylG?>FpnnnYkj>qLG#b zX+z7D)|OashK!qzfsUEOihtQk=KYnpXyTB-4t;JuOR1Db@SgdsX45F9y>V6PN_h?c zh8X}u9@<+j9BElO&(SMrl5aB z`;Jcmii3Vc@;@bmUbBKZ4TKQ+dL^*-a(Q>HYVKHAFXn90A)(-}T84X0T%uwI2yE*S zGwM_bctN2B7<;A`^l6C5l616$N+B2ceTtiXK2C?nE(@&!113j z^Zx+i|B3wP!EOUonS-(K7J1xZ?_yWO2w9h$XYTm9vc(x$gfI!Hh1agXyY3~0Y1bj4 zE)F?0y{h3(LJt~-g-;#sV2@G(w^<9e#0a`&UqhEx)x~-xMLGmpmH|xu1=IhCx|7-f z<@j5sGC&O(s9fRXV8&au5t*XgoZ zpVHL@#a%b&(p04KFnb#x(FVKxtRh8oqwKFgP6sVSN`{cQk%Vz*gJEVsSs;0 zAbkth(;G!PKQ8b`#avxmNaP_=pJM6wU=*@&zU-nyv10d*2#QuoJLYb+=rgsMe zo0yVexFf6j7}*a)5|O{i!sT#~n+#x#)3y*d1UWg-%Fu(p8?HiAhu+_kn@kAftkTN- zFs`^>_@1I#gCV)XoNVBVYLbJuUuHmO9CYi-sjsR-^)HeCQ!b1igk_BHPZc&q4^tI? zA^kk|;7;QV=gu4=*65&Sa!mP~mVe-3oPHV3h7gll!vhGxg|aQ%F;n^DOTKGKlo%?u z`uFHjD&RBjv=p+llwXa2 z`4GstTg@v|s;1OPs!D55guzL-*ic0;W&(ul6v3fW;?Sk-hKFgpQzk>h&!XW-yTTS= z9_ak1TmPz1^#dkjtKkGsEbvGsVVu)j0ahjApc)FBm)bE24f`m#26=}N8-^Y=iDJy^ zo+AcIsu01Ly#0_5j#|Ql4Hf|}ygccxawk9?r%!8tA5U@xzAZegM5Z@a)qgkqi>$u6 z#7#VUI6S(PO=QmhLNgB~ATc@bc?%z*r|fpsj?pQ{c!zG49FJ*O9_K3QJgUzXQDx;o z8vE#!E(jUZ5R3+ffs z&<+Ivx|HwpsCwrA68nJ#7pDPufH?YIKLp7?)U+ByQ z2-6ajt~HYlrNtzdVrybL;c~A;Lzg9Y%gKaWvbhg2jTW4RLP)IiG)PDQeqjNyv6vxP zp$L_W9MOTrn4(lb@LtgOQV?{>Gno4-Saj6eA5#A$>;E)A%S`n_gkDO+x>jGE8iBY3 z8qFe;0e->vrrxNGV7(W3A03P^UH@Jvx-j9Q1PmsinXMSLQGzr9RZ{^ z&l%_c4`bmiFd5_=h>TDK6Nr>CNK&64E4BHd8LjVMd^9w6<-iooEo&CE`VtgS*lGIa zprDT>&a5gUL1`2!Bf+60NMZQ5Ko{oArAlZ_C8BGtLJ-TfDFIXjvS?r9A30Gm4mlM7 zxxWfFGgEIorW$sEw$&8xz8Nxl;fYL!;s01<&M5|0jP!4!x`hY#X0iM+it5-!oRo|N zGiQ(sRD`sQOW`y#N#oRmP5RR6$`68F6e(0Pf}#B7{vNE0HN^Ey3Zxo`H2H<{y#@!8&Gmp`S7d|~4J^48NtkrH7gU(S(bGCbO^dBJ^!BmE2B zX%ZN)G>`%tI}I)Dg76->H&MxR8c0#PRgSndFtqOfr_7uaG(ewl>J%=XVj_P(ajf3B zpqU1Dp@F1U#mq@7mXZ5R!`-nN0Xr_W5=T|$MB2z4R49K9#cFxlV9RZi4Y%TRNTE_j z&^7CFp&AlunnH$K738gfO+g4})Me`AGC+p~{CQ+t-T*)kUXRI)=-i_hJEGmEXGv2B z_Wi%e{Lh2H*G8fcu9fhAR6`4FKR2Rk(gN#lSlpp%>Q97{%4A!35+u*jeivS8DLijR@e`^nN( ze{a4ng8NjU$t2->J1E2lt%eyxyO2c{jSg|g_3w%M_My;O-wMkABV)*=Zt<>_{J>Xn z2$CKGg*C>oG&2xU$6y{t&=Sz!^}^wtsrIMHYz84CXlR4RXm!M>DX-|6koQ+YeG&D>#j3_N?DiHiNd#K-PesMa-C;{cRE3hw#6R8mX!;(&Dialpk!lvab z5gh#BHeQNH@qcS!84Soj5{!;Z#jv2lVRcz3E|<#{p3O8bLO?o8!Yq*yYY*5t&`Wfd z_|B2&OM{PWYDu-|{uYxZI8$Um7o`Fq{(J5R6yi3p7V6U~5r79!1R+POhUPP4Nz#Lg zMEwQY#3wiKIsfq^FuyOtc>2O~hCCsa@0Hv|ixo!UZ>tr|*8&#)qpwZkL{ z9i`3aFrxTZ=|eJJFyEM82tW+suHwJayb}{o_Myy#(*-hkGO!7pqwm8M6j~vPsVgc~ zY&>7t48YWd5HUMJLMJg3R4SHdT2?_aGEB6m%lMwNu8WBRgZYYaxoZ9?7=uGn7;yq# zt9H^Dx_|-=E0sK92G?l{^C9TP{#*5sMt=xZ z0y5sl9{F)t1Qr5N6%f<%XAhuFgSr46gL;ukP8)8axGp2Y1>=jlv&kr-YN-2;j@#>B z?EN3AzB($dXW4oN7~I_%+}(Z9pn+h)gG+D-Zi5Aa2Y0t%!QI{6-6cSQhy{d)HpwRiU^tLxA9JDVE}Wpk(ec?h^hU^M}wgCm>>|(;KCk*)4he zKaBf0j2gh5Z?NEO;nOCaz-V>>K?^krd*51^U7$|6lc*jUuCY@(e=>KG)=u0hu z!BUb*Xx{_03&F;2xRf*UMAxLTsu5I5r3|M8_zrr{HQ4Y8JSU3HlA`L+shOCam{HZM zS)>M5D98H^ItU@Gw+vuAww4Z(0!ti?bQ9nDpRxTjU&>?v2M>v{31O)6Vfeg~T3BY~ zbdx(;R1Pe<%yF?GBx?hf*hSNYjQf5tr7QWig=;JaXuC~Z)R8_({_nK{#3Cn_UL~AL z<7UMK*ErUWP$9h{$dY=N!j2p=G{-7~CCi0P&O?C)o%+fC_w7_ZMJ=j%8$RR+i5Jk5 zWBWF^G816%@7(D1@8Nfp6LwXCsKfGxbZrU$$!Ru*QA1LMG8o9uTfutUb{YDk<`@i^cH#JW0& zr0Mk1fI01MJhCc$PNoL?R`o&nhwP|_c&y+Owi!ZJF#Dc^)teEifqyibL2p?}y#ds* z@);2*X$XG>>C_?&lH%La{`!EBZq_990`ncq{@UXjDuZI<>P1ko;f; zLNtcU{S*C$IJDX1qIc#GkEh**D}w(;00-ci+k4+SdZwtME%^{tkx-2SNysn*ddS|0 z*&QVYEOt!|)#s1M@wk)qwSSmU-N&MxYts-eB51*s@XqEH=_NEU0*U|u*~JP6-dlV) zoJmfIBobJODv`&RD);Pz43>QZt_)$2KWDuNBt--Dml}vgG?c^LmjMp3*L`6cCOE!i zXenA0g7^p0wnNNZj`iP>{j;3E$AWf6%w6X9&5z`L9n&{(qm-cc4oHr#$X7dG0UKk> zmyA%$BOX;#A=OsFcQ+@agvp}>tYIPwgkK}l=Fmkgs3)S1#!Bc^WuZbj_`_A_j-$R& z;g*L1=$EUjpu%+FQ_>oPp>Y&&&U8ZkiZH>w**37j@nihR;64W=EF}#O=KsBN&0H23 zOn;N;g9%~&PP00QsjaXLaHyLG_oWhro zlus@=g`zICBnJgk#TwC&&Q}a5zN(5>^@(=IZJ{+5ya}!24WbCk%zd6 z3!PFCdk@%Fo0?K7`9G_gc^$LA-D>a?gDxuEAdQ(>lJ3>zBvdY)H6S>h7t(Xncc?kX z#`;EUu$hj8blwYKrmf?Z<@BOR^Z=cvG{2LK0L0G}px(n;rq#$Yom1#vpjF9*%#$3k9yX<22w>0Q}u+2yDpzmm{gZf$t|-iDeD%C{GrP&=_3FsAC-Z< zHeVfq3zkMn%Bkig@s|!P%^Wfd+0QplQ#+uwTZBnd@aJ@yA)^R0LGh-i&;=rig~Iiq zaFXreR{~k@0>ikf_ftZGfUT&pQ!t28&gnZ`3w<{WND>-=Xc?3KeRB|$BLNK{DRH|E z2<8rMg99f3TBs2aLvC{Z3%6>8n>>J_*n|9T4BH>j%X$OsA!8I2GBOt1W|A(bd3vIR zs}mEk$by7BrGN;hVNlK7wtKt>mUU1}7d3s9Wbe|A#@ zZ@*4%wDJwdk$emcDQ!7lW#?Ni_(~lvtF6&fAb6`}o>R$s*?TDdBx!_)kL7=pm7M?!$sor-ik6s`tse26Tta9HQj*4qW5|wT2P^JwRG*zNH z#*=Zrd9K)&AB049!vOEd4C%qfjDDT~bPs%lq8C8I8+|-qxznf|fjjgD|0vPtCYsC2XBGoCR3KL-DqFTsT}_u)}35(XfXvG!}n%4$!mTN(Mfi zDO5~mGidp8JYzlxz(oh8mZRc+-jcEto6kx4{+UBX<0Qb-Wo2#D2{u+0)_F$=Y;33d zN5@ZO?x4Q~Oqu>3O^#uXx(*&m>K~Ck+)?ovOJQr^H^$j#N(7{3YeQ{(8&b9n5I|DY z9|c?>NStF3#||@7v{_=}2a8JOAQlCXAqDI6$2lP&-cwGSbiUO~_@Chvj`GoU0aO{t zup0pvpRcR0rU8`5P;2#+e$d%G*%u4=@$R7MMVV!`qaHNZO-%>I7T5hsnHUtPy_;dWz2( zGMNt!)5@{nF7HHWrp6I4st`!dtMae5|+QXpe95e7d> z>Un-UnO(%Jlu-SpZVuP+pj>C@++e`o$9X^s*AC!Bsv zRjfmUon?{ZQBC#PgM~$OC@#t@vc#$XrEOh#8%kSU<4NM8ABQj)2XN zx#zk9P$nd4R_fxI?t8PnZch?yk|})^zq^Q!H#q!fW*3e!jW9H3fS6dE!@|+ZwIifsdR@pn{78M(RWVad)HI6k_g5vW8gZ}Qh>19=V6QuI)MxRr zV;M_6a0enFGE%w_D3MY)A1#qmOv#NntKZxn`N!4-_3LvT-d_n!@Wy|!VxMoQkl;lK zo`WGVclm1qxd8vlap_?pUO;zkQWv;aMjwTcbhgqe`4?Rxq*!4K6(7ViV>l~5J)Lyv zsIBu3N#AtVap9Y9JEcI$_jey*5hh2vyK9A!(I?Icl0d-mfoxMz0S{H*tBX|O(WB2L?`^iWxCU_(kkPs%#KaHC@JMlG9lqvN0Pl_=hT}$1faHu5w!l!3 z7aZvrw0($w^o8tgKR5J3HTKW_I608i4}-3&$!7!D^RMuCo^dYV_I{fI42W`M9E1vQ zCf0*Njq9`Ns*5|t(GPfKAa6ZGFOHz)HX}2_gb&<-KbyvMgo(?h2)D)y4EmK$EWlv) z>i>F4mZA5C^iUn5qfQLB%-QVOPbh7!K6c*#WE-2XAHR&Sb1A-Z(Co| zKlL;xNjR8R1v!Mg*NUekEEW zTtx)BoeCvQYp?izh=(VVadE36n}11>)ThOc&DVi_l}_QOW<{u$5lp?{=%8~2~^@p5l6JIkaNO{t^=<1&(3SMzelU=kKdWW!tvi&Be-9D!j;kM zya(S)c#6FW3xY6Svu3l}PCq%O2Gq0APZ)!h@2m&x3^#bq7R76v1#_x+Z z32$`#;tz@wtLtVz)8f*R*sl}*9kP(=2(gHm_h;tlKCyk3LF;c0m> z8K-CB?(7slka=-JwA3NEq&C)xHgt2hdB0Com%UD@bbi{I@u{7&BlW6Tz9Thj@cFSW za<+5Uz3I?W@;>kU{?GZbr`DVL_2XyQ@%_^VSsI2x%Nlp{Q|HUw!KojTzn3ro?syX^ z$OK*i-4+R%PKkmI5CP)j4nP$IUrraRz~z`AWw6YoZDb<10l07h=4=G;O(lTgiz6TV z?``F{a+hB|Sbagq*k^AVZOelbfN?4NdM$6wb5y})ZP?~mUU!u|sb{$&QMt<4zS#oB zE@l8f^0p}wcu!?GlGyPCpN}bFG1eGA8)L5W+2_1|7I|M5w+iK2rHRPnLA=(Mv&5+f zTEsz8m=Az{)b)4>=*5#rv7(~ckYysCB)|qY>0M@4@s<g9Up?z1rmJPS$EPOClZx4WEu#5P$#jAn~mz zX6uXy3P-maAm`kdG|Wa5Ok0QzxHydlLI-=SK34vOSNv(1AnY5fq z6ib16kur4gOkA9Zgxnj`tFVpLJEm1suE|Ja)cLa*IX=iUzsU^@#hMt{QGM_oyd@o? zJsoeX>{tgI<{ySY=yCO$UtJ09JX_1*k=ev5jB@GMggD~$X5`V#u7{P{DSI^6P0Y9b!`rm z>XE}>Z;l|>r&(ork?%+a->M?j7VJfss?=v2)Tq4AHO1%3>og=DuJxgPoPhUVm(Q(LvX+`ix>0u4%0&x_%xY-eb z5URP{gAqfW3G@gx?{zvb&U9;DpCN*}>+D=QeQgDNUZbjaj|lftq%G$^=w;3Hiu#bi z^i(R;PQ4VBJyj6G$-vW|hi)7zv~8*~J8q7&kjlnIk$nB}k}GhFIaE}`%*RuqYYtx9 zY(8RqTqLFsS)^jX!Dh;X1-zF4=*q7ad~d}mEQoaCXV|O2I`VI9&L|1qExYOXy2kzO zEGJ814h1&zq%m^R6vu8W%lM#Cxn))1X7&u}Ws2gUWLY~rwql7(wUg6l zAsjXoKAqmpr*(E-_Jn~&u$)#1PJ;~Ig?#T^h2RPLSR<3@#cV}TNK@^u!26}8l2RfO zx0pWf!#H7lvP&@_v^NMx7kW+td(juM_%G=D{cTObwxGFx7fX+_^3;cdZSbL4qo1*4 zl-9q@wL{a1d4fhJ|ewzgx822>W4>_h*H;j!mF?)RgqH6rCM<(ND(wev>$3x0JJPrGVJsu(pO1p5ZN9y@!}Y)DC;c+AxA9)Ib| zq-fDwS>L!H(2uzOby~oShZt^T=L}iID%X~dDQBG}i`%k^UxRCkt2XGTL7|^OhWm7y z9)KqOc~4n8jXrDe`$8(Q;JovC(p9w|k8Z+)w(ZQn)-E-M#D}J`Ynob0TX_`fcrMknS_#{-vTMyqW(HkHlu-rLR`!e&limM?8X05P& z?#r|&sIRm<>SKc5jF0=fu>k?H*|S^cn2F|^0#62)X*GvBhDN6MtL{pI#J zby7BZq{xPmCtRjOJY2^XOBYKLBqbMN%q}P#P>?oY+4J4V--HgkdvP(>Xotib?8Xt~z$ zkJp)XdTDBSVawn-e+TUv4r{IZ{tQhVX8E7RlemJ{;Fr1iRGz!$V94*JHOa$cdwMsr zJ!#syqv*sLJKACg7@sTD8Z;lLFOc$4U8w_UnzhEjOxuvwfB5PfHEPtge}#7 zAN|kj|1a8nJZcyH{zKd+Y9#kApW2`lcb&kCHLlBBd48Z6Rx@kTSNeQ_D5$wM%2Al0 z^8aTC1}zyK<;Vi-NwDExnuK783G6TLYl4!CDc!LFww#>5i7e{A$MjGa{%f}VReLX; znkC1%5G$--AD<-b8zzuClBp!|4{_h;+2^x|*?G3F^w9k+twQo+mhd)uFz!@_#C4uL7DWa9@eJsem5<1j)7(wAHzpHgE-KHzF;{SV^lP1H1YH$!=m}7ahY}EIH z!|}~E?#IqPNN4Woxz*-=g9`tNtT(Yku!WQ&2lb4y3ti6b*x7jo*u~~9CwV_Y@N47j zH^=|F@z^<;CPR*{x`Ai@$ih<2t(oMXd!r)lKUy?|gin%iA4b!;FYVmVl`XXS6dP{; z_bciPIg6ZsVUGVuK2KmKcuxa#=j9Jeaw#6vOg?yfg)lW9T`^u?^W`;~t-LVb|BAVP zJ}H_uw?ETgATQO;35Lv~jrr{XO*3C{hf_mW# zbY2G7F&*z_4Q$XZ>rRr+*581PulUU6fGxtZ{b**jl=m(Sy%W=oePCtA^}>l6z)=U8 z4X;HmR$O{>K@(!NQ!(Ya{>ZYfI#Ad3qfAB+K<&VS3aC(sy+6 zZK{+|cBGu`te;3so*}|k-_E*7q4iSLjcau*E5->2He?f`=JKQ4qL_LJi)wBJLKa`W z@>~sENWCyFD&4+K_#qVoMLd29lqXwxC#N)KVs{1BDYp1mtkAcg*&}Qp6lsXjoK2Xu?>bMiyl-u8&aY@WzRgThE#m`_Z<755E)|Xn#o4vp)}A~) zt?>r6lQh`|L`FIEWs*emI=r;+SdUc9sm3?0Oc|88z2r)(2E&eFw!1x zs$MervZlQ|)IR;EqeF$lytz4`=g9VYtE86u?E82l-RRXpQ53pu-qms98-CR+8M58WFAEC~7ut`QjG6f5Vil2}9}+e79PKFkHKuWhaxj9FzTU89)4@)xBCW_tD>g%1L1o@uvOJ^UBiN_Gc|GH z_=MfQUcI7ws=A`qXS3Iewk~@4P(}NvxQu3gjsq#`?4)axR-g>YgsI7*_H&Qj5>!O( zHhTH*8topur}m7=Y|ebInLx;_@r(S;&@a_#Gg<`mN_|7V;Dt$A{$XW8=jq`qJ!1s- z54++KruZDr>Nz-*hcCM97=PW@XjP>grwy`tnty|i>@$urTp4r_+D)ftwKm*tYS0eF zF7!|FIEW9QVjrX}SL15Z!B)08t5Ma7$6W&l>-sNxr`u_;18W`adEztm7AV(uCI|W8 z&+DfB0ytU8b>Fouw=Y+o0gq-CsT4x!8P)hwKpQMJgK6^RWJQK1)a!~yEIRu+1L7-B zo0uZOu(*L1n;^RaSZLJ#6Bore|Dw~=tD5$S7P8pQU?NR|xNd^-G-1?23ibe+L0$bp z3L!_94_(7z;I}~gi+jnT^Ymk9)80Wf26%S4bV}taz1ZH;XYsic4WtrvVVC_~1p{4w zc@e*(BNyF{U(HBg;sz0nT<|j!QLRUKmz)p)D6bvC23lONwKbU)8V%vFD5y)gW*_>b zH?}a_K&@49Q_SXNNs-(!sK?25sVG)!AAu9aJGQ4prn9ZI;A>qM9p~?P^h!8RNv0u+ zofap}GyK?Ld5KZ5^$j)n3_6x$d^V~gKib=rlx>v8lBn>uK8k?&+!?iX;xPCHm&wc&q06h`tImFR7_43i1D3Q8 z2?dC$QIL%Tg^o-kk_yr^w|IE#Xv)VtmS|7kYYmkfm522BWNg}XV-mmhP|1l4Xh_r< z&^l`e1y!UqH)(Eq6@t?%w7-^B&xPUMyE2_+sTsJJ`f5;-+}IrZh+04UvaGkObsYP_ zo2S>B=0eXlB>DRmz*aW3qIF`#S?YVTq4EfnnBG_6yuKPvm-9)HN1lk)u+x-%k3(il z!@Q=st`s`SypKK?)_v7P0o=QuUDsicuLTrUOe}n<-ZRF09beSFn zX)yTuqO!I-KZ;1Y8D($unQ2k0d`b-kPD6a!E8zfCJt^-QD^_$~r++fmro1lg7jtry z8ZxOZgw$&tk2r9>u*|16q83r&owDR+0PzJh#PW^{EH`W+5*&BdGaU5v&hUvxqGZqu zWIAlQOuUuIVv%hu-)hYqhfl$HniP@ZoVW0_u+++HgQG{8L9#ENt+66RMu>HfBc`XwaV`7$sR9bwh=CYWNG?EtIT=IQwNkr|^$jK&f<^}6v6?&x+;rzpjUx6^WP+`g?a z*2;N2)4`g@8Pz^$QHLLX!bjk371U;+ey#USYr}nBX|x>bY`3+O)GqT-^a=H_PbNU^ z!r~{rf)zGPWz_HZ(@zT$Hu3|&lscL=bc zFepa?`&o-DQzI%1DaM?8^?VE#q2? z8vOe!k^;vt`~Xk9v*yBOtEi?!AC`>s+;YG8-%Oy5#;kXmUUiNtTB!Q=A_$7J^S}5{ zF`Rd#p%1DLqBf>gsec5&XY9(wv9ij<@>EGKf%g&HK{Z=a~ZZxO%!+(xaBp|*)?xUC)brU z`hJ$6Ny{$Iv|K2?Bu~k>x5_Zn?5#T^T$F~HebX4>&fL(>NCOpjb4H}QURnl7O#}*( z{uChN;@V^T?gH3d<>7{P#kKUfuxZ8f%kSbWn8e`~X--uR?(g`=%d zL1t5RI5f}%ZXG5&+RC%g)qP%2-6OZOKDUTM7H5c;%^%@gNTf9DBoQM1jO>@~Z$GnD z0g@B03j!Iy*a$LaVMQ^AWsO^NuWy?in7S)(dqzxPYY*qr6pZS)C?q^f)j!v$CSX2y z9SR4z>ylB&7GG`rnqEz{Ox~S`zu4J=RdvZ@9LD6N)0(+c9K)lz7W@Vr63vT`AuBrd z=%#DcfY<$`qAR$nkR>-5OKbriq+!0L1PSdYsQo0KTyESV6)EEmZ7g}}eLCR0c67_F zdPUbd$ZfyJ$V7>DxJEm8amYEZ45>Drr>*0ACdCnnZYGH%{}oAu=W+e%JHk9QTefQy z(XouFr_@b*Jrb?mA-3!&CmWu^b>knhv zgE6CxuC)#Dmq(UZs3SN7Zt|DT7Ib3zLleR@ykmz1%3Agd&L{R}Sey^D$Es(m; z>QD1uInVE4WZ_%?IVhtKcz()-AFWyl<}FV(xo<}3_Gog+Q3C6V*`Bct#~Vg4biFBU zw3TxDSYFmiFpt>sKjEpvYSRTe=k{7hGn##Nt|*t~u9GbR&WNROLoh)&GR@O(yr2Z< z(ehFlS6Y?`%8LaRkm-xmV7wpOW=u!YP9dy8gBBYWf_2QgQA3?!@rZB9HxK26gBL=( z1lADaWP)=E34UZ8Q(K1v0!RwZ=Pa`PBgXUo?pr^u3d6d|3G#?*Ejs{L|IFJXD8PK2 zgRi=E*#q~Z2%!@NpRYW)vE(Gwln>VezL zLWYa!JMG$HdGVZ0g%rK3y1AcQY^m*RH1a?35<<)j+bp6iy2>{_Ti13T$fkW#DY_0u z93wda@OP{)CNGhJ7FjOu%)Wq8Fys$AjSeCf&>UdZEIAh-EZo3K8KI!Sg>-)8!77T% za(-v)uhMW@vt`oBl!KMD5VfoKe10S>Gm5XVnv8huT0MdFIzO~^##Wz>4^^wWYg*{a zdsQzM(u00#jcOai0$+X|OoJGL=o{39fE z+_t^%%Zw= z`I}}AhTP6UIN}cQtt}?m5Mb}>R+_H({`xwVaTj^+1VU6TiEC8EVK-`=^*7Ts=APIU zDgV{VqNH{tik(LDTcn`r4}VThFkDkCFTeFZI36!WH!NlMzR8Gv(XY~1?>J@o?;!Tk zRWYxFkYf6Whf3GRzJ~H#{2AmU<_ej!?i#P(bsHSABG0C&sg*Eycws~amkO`X0o{EH z$!5`s=0H}h7lLHMAz!B-1}VelRc!1$vA(5geX?a0!ZWwTIF&7DQ7G{7A(mnAE4ufa z`s+t89s`O!B`=lp{tW30FS;+Y83bf$=l+XV;?RXS!gPJbb3}9Dqx34z7e#}^$xfP$ zt|wvxlQv7l@L|v)J+F}jDBi-4pPb%d;m=aFg@q8+j!g%gU(O-TH}jA9mE-j4?akO# zH!8zU_`*{ets^cuzj!UiwSw=gf3o6pJ_3QEOCOnsQL9B_W}cX@q*CqM{H4h8jH0Lo zBN5D(J9-o0Cl4)AhNC`+1HO{(;1d(ocOQg%Yk zH2PT316SBC*cQ-$il^gw$){)uFdY^595|YPWaf>C7)4oJD|qN4_AWXO@0a9o4d_3$ z26$<^@}M&u2(XB((Ib(9^t-MdrZE1tW4zBrrO$q4OptheQ7|^50yNim)`h>48#$4; zqBe^9m!sM(?w|gxy}4dgg4+BAsgpBJ;l+4I6Z|dSx(|s`K(^c{;*yKSV7OvQ&}kmU zbt+G6km#F8le-ee#G&C1@FtkV5;%cP(B^&Cvbn5x7}S2KhH`tX0D4g0HVG%YjFWw| zwX*&(m(6vx?rs?2)Wt#c0T8?HK@iA5&Vd;HzCTNFKd5B5O0rbz+i5dyMQq4&l2)r# zc91s8$z~Pu^Pt)H4DYX@Gw<@irr7WR6mc?wO615$UM$zV?=nUXR=cgIs)#(Bc- zYszyCiPQW^*_Fo^#L{HO{BUOYTGLsGM|ybo_Q^du73J1xp%0xpov0*#WP(;>(xN_= z)jx_Q02v2;8G~r+TXeZ^?D3iklefRD29%Dck8q(5K59K8(Bj;b@81YEAz6pQ>V5Wk zYrR6s9D%9Je;KC+#35$lo_a(s`M y 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

tY~h_iJHf*SBFApc=~{{1tWydPACVMb&9Jv%Q* zUxN1)))Kzm_DtWC87q|GWfJ7WBEir)_wd zks14#{`5Fp2OHst3XEtR_3=MV1FujYA0PX4N&5^Xt17cD|MmpbRR&-zQo=`enT@(E zXuN#QSO9wkHh_zqGPysofoAcKUTYV|sl+o7vTfiM(7PpN zVV`n<9p*OFwNL411nyZI!-uNiU{lRTIp*EX1sNt2(%{l095dAP!(sM8{J8~s*XC3y z)yDPTz^76Jorn?-0RP*x_|9HEi#4G zKtJvWw9+yto%J7JwAH11+-Mqa-pDa+ZTWkvPL0pE@%2!nz4I6eXzJ4)TRSP^e^*Qk z=Ewxl#pk9w{R-JjJa5LI&zE-~Vk-z+91rrQMl0P@PXAckjd0D)>4$^&_xIi17`0`A zj=OC%7y1=j1z4g+FXLN}wqx?ctsvk*4~^W_LCV~(DrfFe9pvKyl?;hC#a_GmFaBFkxE17N_DT(mqZ$rz=L)j4QPM={CkwpentE0tGa0bE>;fL^o$>t zX5G-|k z^?Vv_KK;OPdU|g7b<2A>hL__R`SRb}W(7LcjK*fGZnP!nOWK4tIQ#zl@7V+L`14i# zcbL!o_R&lOLn0X`I7mUpLTHeyWO=py$iQd|$oMIYE-HXw26X)G$&b*l71R@`hKoQ6 zi^Ihmgmh~|&y-0E>2mGZ$KeF|#-#wfXP2`5AHZH_G@be25z6ET&ri|Ma!lYRZ^=&I*9ZcIMz5-T?BE7meEtmYYH!cY zjra?rs4#(WRO{~k0h#r518rDTC*9w_4^a>hU&Vt?ARCeoToZ?2WRA|Tf51>cm3<$h zkQgSnvMmrBrnLs^>`e2a;cZT#zQVlT8Z?9(c2j|J_tTf53Or*|DwVgpF*YS}u4y_Q zX5UX2PjwwvZrGUH|8cKb_c2C5BI90IOlm^y_>0B__goTIQ6PFz8!{cN3OG#uQ0UD188BLUv`r@oVSzyYnm)K%28y2u_ z!~`_wJ;jBlg#HMpbPAwj3j+ToQtB}a#Mx=5=2HFX!_W_b@+)Ym0O$G|K!@KK5Gab@ zZSFH!ef)=LX$hmBf6l0fulQu}}ANfAaI^ z&v2grSZ3?t;l8`qKDc}7K4!r`v$3BM1m*6}4^z2+{4tg@jSuss?!W6E?}l@I?E^mS zxHmrGX$dJuFlYsi1%UEh)zA2_dN>UO^tbnT40wWeiR}Y`f&eTgK)t{_V4$G&?(PJx zb@%>;mxtG%BJ2KLwOP~NM)vhK-{XBKY`N}FX1Cze>D-;hskZic|MnWM4HyagvKAH0 z%nK$cf9XVpV`ag(94M|8)2E9HEE>hYmqq7XGO$3?y8x2wra z-(GBqdDlXDZYyNBY6>=IjLh9mKXgwg^0fI{rxr-Zc}gp1ofdm2_jx*e+5h%yf4xj> zH#nQuct-+3s%-OBAMs^6Rx`ROfOC|7doydz&i{UxHa!WH%_Frpz3SI-=V!K{)BH3K zd|k+A2F#D$GwYEJ74rxJLw{W-%0D*vBLw^4u954PwTPT`!E*Ga8^G;P&~#`_sv=60 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 z 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 T>`Y 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 22/64] 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> { @@ -12,8 +12,9 @@ fn main() -> Result<(), Box> { .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 23/64] 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 --- 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 (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//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 [--version ] play it as its own profile horizon-launcher modpack remove horizon-launcher mods [list] what the mod browser installed (docs/mod-browser.md) - horizon-launcher mods search [--kind resource|shader|modpack] [--everything] [--source modrinth|curseforge] + horizon-launcher mods search [--kind resource|shader|modpack] [--everything] [--source modrinth] horizon-launcher mods install checksum checked, with what it needs; a modpack is imported horizon-launcher mods update [] [--check] horizon-launcher mods remove 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> { - let mut all: Vec> = 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 = 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, }, - /// 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, 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 24/64] 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 --- 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; /// Versions, newest first. fn versions(&self, project: &Project) -> Result, String>; + /// The project's page: description, gallery, links, authors. + fn details(&self, project: &Project) -> Result { + 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 { + 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, + /// One loader (`neoforge`, `fabric`, `iris`...), in place of the kind's defaults. + pub loader: Option, + /// One Minecraft version, in place of the one Horizon plays. + pub game_version: Option, + pub environment: Option, + /// None: by relevance with search text, else by downloads. + pub sort: Option, +} + +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, + pub loaders: Vec, + /// Release versions, newest first. + pub game_versions: Vec, +} + +/// 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, + pub links: Vec, + pub authors: Vec, + pub followers: u64, + pub published: String, + pub updated: String, + pub categories: Vec, + /// `required`, `optional`, `unsupported` or `unknown`. + pub client_side: String, + pub server_side: String, +} + +fn strings(v: &Value) -> Vec { + 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 { + 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 = 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 = 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::>(), + ["A", "B"] + ); + assert_eq!( + d.links.iter().map(|l| l.label.as_str()).collect::>(), + ["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 { + 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 { + 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 { + 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 +/// (`/assets/minecraft/textures/block/`), never shipped. Kept beside the cache. +pub fn grass_block(home: &Path, resources: &Path) -> Option { + 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, 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, 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 { .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 = 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 { + 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 { + static TAGS: std::sync::Mutex> = 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 { 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, 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, 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>, updates: HashMap<(SourceId, String), String>, confirm_remove: Option, /// Java mods' checks, by source and project. - checks: HashMap<(SourceId, String), Checking>, - tx: Sender, + pub(super) checks: HashMap<(SourceId, String), Checking>, + /// The project page, filters and images. + pub(super) browse: super::mods_project::Browse, + pub(super) tx: Sender, rx: Receiver, } @@ -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) { + pub(super) fn mods_install(&mut self, source: SourceId, id: String, known: Option) { 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

{ + 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) -> Option
{ @@ -650,8 +683,10 @@ impl Launcher { ) } - fn mods_results(&self, cx: &mut Context) -> Div { + 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 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>, + versions: Option, String>>, +} + +/// The project page, filters and images' share of the Mods page's state. +#[derive(Default)] +pub(super) struct Browse { + pub(super) open: Option, + 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>, + image_queue: Option>, +} + +/// What the background sends this module. +pub(super) enum Loaded { + Details((SourceId, String), Result), + Versions((SourceId, String), Result, String>), + Image((String, u32), Option), + Tags((SourceId, PackKind), Result), +} + +/// 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 { + 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) -> Div { + let t = self.theme; + let this = cx.entity().downgrade(); + let f = self.mods.browse.filters.clone(); + let sorts: Vec<(Option, &'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 { + 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) -> Option
{ + 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 25/64] 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 --- 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 26/64] 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 --- 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, 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//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, Vec) { + let mut on: Vec<(std::path::PathBuf, String, Vec)> = 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 = 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)>, + log: Log, +) -> BTreeSet { + let mut by_namespace: BTreeMap> = 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::>(), ["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 ` (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, + /// Carried-over mods left off because an earlier one owns a namespace of theirs, with why. + pub left_off: Vec, /// 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 { let rows: Vec = pipeline::read_json(&work.join("coverage.json")).unwrap_or_default(); let records: Vec = 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 { 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 { + 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 = 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 27/64] 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 --- 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. `/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 ` (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, - /// 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, /// 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 { let rows: Vec = pipeline::read_json(&work.join("coverage.json")).unwrap_or_default(); let records: Vec = 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 { 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 28/64] 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 --- 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 zcmd4431C~*l{bFxd)g(-i!ASpY{kxEdCTgo2s=(7j-3! zTDlBnDAQppr8LR3a%dUK$MElTVOj<<4A8v<2rVB&DWz?I4khycckX@f=}DGshh^rA zBJ1htzIV?(_uR9e`xs}8<>HTp<*Z)WzN%)M-8i3v{(gf`$KXZ#b{zcebH(VZjB)Rh zo!bYt)f}xng!`A__k}xg!hXVX0N*#_`;46zU%vPKZ9^C1`(JVSpD+6K)&XztPYyB` z06dl(E*{vs+j2&B6Mo-|_JK-dD_JZAe zw(tH<{tSDJpT(tFUJq08t3~Nh z9%ojxdR)PX*k|M?f04~)z;NQ^Sd z*H!nl$CD1e3iLzo)4@yfeeT!#-@}$o3+4=SMdL_)Py2q~1`N}9gMOFOds_F6qTL14 zY@1D)PNZYmuljV;r4+IfAAo7cHz z2XORdwt`>8RwTio0ABt5Z~{l>Ym?fe&1u0xH0?6om)2_U_%9W@PYNI6_2X}fzVN$x zzIF|@{fTK^5v=<7&G1^Z^UF=YQ@iQH>t=#J#k~jR7!A0ikO2fYeICVcI&2yog8n|m zT!L0Nv1O_b-)$M-)_x~Gr;kO)DgQ>|9Q~%B*W0E0G~Y+*g=F{!YfNefdP@3kg4;Mx zZ7@FiZp;g$MmLS{rgnyv}+h?F7zgTQ6u>feJX!v@FZirqD`4>$A5%2w5DgU z#q_4%Ah(zEPqQ*HU!ZUPA9#O8yes){nSATt(FcFc^rr84tCzA$^#afh(d=?uLv3(g zIdA-B2etQh0WYmr(3jpH=3dA<^&*`A0;^+x z#pl_0hqZSeKB2F%Z2T72&e8XL`5qtVq47WQ5bNhb%y9_s+nF1mVZ3s2=WJY6!2D

)yeJp}!TdM$FWH_BD2dFXH?87x}nSsw`6eO?gqZs1DVm=BcyP zo7IErXVlNBf2ZE3KBRt2{XgpC>c6T#QIA=y7LTRevc%G6S!X%l(r5WX#es^uEB+G5 z50nHd0)aqvpf=DHSQ1zk*d5px7!BMPcp&igz>%tgs_LrRs*P2ft8LZU)p^za>Wb>K zs{5nz!?61 z=hO?Qp4Z#pj3;sY%J-pFKTY3XIsVGGUpe&3pI-UrSHAMfdb}3C(*Md9ydy9F*UP_r z`JI=~d%5@Jf|tFFz4XpYAG~zzr5IghBhC2^9316K_)6ZT^kd3jSKgxEl(&`lRYkSY zaq>Uquljedp1*@pWHB$Ovxrr*Ahex2wh(s0 z5>WJ+Y&AQVb%U-qu>rP&UCQ>btJq$49e<7gn*U#=n7^VdVAsQzxQ*S;?qv6~ud;{O zVfN4LG4?q7KKlWC3YN_;*e}_O?6>T{*h%&d_|o4v8M%*otX zeU+@3m9cWzEcIAhO{|c$v$gCjwuYU{j*#SS?>>Ut#~qj@HTp?q*f&K32;9fz@Em&tMO* znOI@9>_Ik%9b&WDH`oI99X5|W%o^A?*?jhG*36Eu5PO6zV&4U)_&;nZ`xo%l{|~(D z3ATcLkDbB(m9?@TvX$)LSQ~qi{fMn%KVe<$Kf%$SW}WO=wt@YW^|D{FDEke#+OJ`^ z9cP=_E9?UHGCQBW#I~{j%eJ!D*cSFXwwwKhUCiEQJK68qr`ey`MeL94680x{IeU*? z%}%jv*nZC0Fjv_SSD1%=2KMChtdE^w+u7^N5@o)!R5?Rg22L?UsZnMrA*EiKqXd;| zrB10;X7ii)0e&yPkKfOS#qr(zANf5zAG|MzH}OV3m(Sz%yn)Z>CA^x?<{qBKy*!)e zaUb{d0$#|Acrh>KWxSkM@Jb%wRXoUN@LFEOXYyG*#OwGR-pm*9g}eoPYYAVR#zKJ@>yETX z1A&f5nfIKInC;w6k=Xpw*sN&(j=;h0NKC02_^tzFvvq55OKDYAj74LtEw~cC0@l{w zS|8(~SfGDLeM|`jtAbVaF*Ov}_OP1oXRU29Ut6HRzjaK>Z)+W^QQKll+s3_tm?wyX zwt;Oi%lf@Xv6yh1Sk?BjDmr`A>*uXy0UQQfkNUU|zXfA#ePny|XaT2|^)X8*rq;#$ zZ4v4(R?ya_H7E^i3&g&+K4z)ibaWQaYHQ!x9<#Mas$yzQbi;WOG%h_D3B=Z~$Ek3% zG!Sc{qn2niFeY0AqFFeleG9~z==UaS`Mvd#0I+dzAP{q{kM!eAfPQn)(Ly>}*k9To zjYdm>t(d26Ym9A(#8?M4uEO`yj#vd9RdftIn!~nIi$|?&OEkJ|AR6O!(Wo|pXkZ)0 z6Ksvv$E=}1dmv`18NitAZR;a3d$2X;2)1Gda7llC%qGwcOa!)#*|)R?=tmlEsRWKXeT_9)Yk;A1BK_-22R1|_!Dv-95DT9h!EdF67Y&s9m^~D8 zw$&YlVj!^Yz}H}F5abeU9f&DgcEtEr01~s$sgF5B0fN?xVOiJ~Gy%Nf{wOu+Un!t< zg^oJCtgXFuPL)A8?ocuzdE{Mq9YAQq(E9`J2ZIANsRG%olqMt=CDeY<)NjuBCQNQE9L$ItN6Y9U4=V_Sm+8mG!Zl5QY#4#IoDg z(8zFr8H(l5w+;A~Bjzg?H_8!62>=IM0eCF8tv_(EKM>0W+UjF@p^lA_G0V1<(HXI< z?ZLhEF<+?ToJhyH@?>ch&ilmq{LmQ7YwM1T<>j@-_&{qcw~m$^NUL=$oBrhBPmC8} zF4UU!kuh3_Kv(NQ%rLsmnNtbFM4~^OBvm!L+ zpwG(Cn3F#1LcoT^f6UeoOa}uEF@6E9mik!8^kaeX*lP2Q({BAWpBNeeBV zX9eGen#kD76~UIV`P@%qT?l+&0BNu3$6^_1sgErRH54wZkF`wI6okDM%@<>eSV2vo zA+VZQ0#JMQ!Go)VtHFXI5PaaekVq|@`}2X}CE#5Ju|hPnfSuNeW@8@K8gsYRZ9mu$ z3+L&#!b;$Y@hrvG@2#c#?g>8}brI4wCWzmMQCZ3OVduGzF8%ozF z{o0!JtA4HdeyLZqgaXJfsE(ya5_+dua2%iU^?*8$2`19lMjIT=^u{3Rz{i4-7)Ji{|q@B2%)@~hqR_8Jp;_!8B z=CG0YdE+PPZJh68eLRb`p?wj(F`PN@f7}2c)`RR(_^f`z-omQR<5%;~@E4RE_%P-x zVP%7|O?gOpO!>ZApq{T@q7K7f_kj9{`eXH1>YHlZ(qy^Ta+~E|%Mr^Hmba}9*06P# z^-AlA^)BlX>l4;zttYG}Z8lqxt;^PL`@Zd%?R~q)USXeOUuM7B{-nd=C~(Yj%y+DE z-03*xc-ir1r^Q*|oaJ2NTg1R^b~pKc$Rt2@@(?# z@Er2|CaWx~A!|w2s;u2vH)P$O^H$+I!slcJ`X= zo3ii7ekl8~?5A^<<#grr=j_S(X3k?dPv$(Ab3EsboOg4TTyJhk?#;Ph%zZk~k(Zwr z$P4AQ_(eDCHf`7Qaw`Jc(ZGyj47SpIAN zkbi}Lr~d~3ZT=_xPx*i5KjDAN|9*kDprl}9!EnKmf=3Hkp{KC6u%&QKVNc_m1R?+*#w&Fd-`-=}2zg|*ZvZ>^blJA!s zEBRH)Yo)cNb4yp0t|{#)-BS8M>C0seW#O{5Ws$NQ%5E#WtL(wDqh(K&JyrIzvJ+)* zmAzj+w|qzWp7Qyy zy`%NFZS&i%ZhLN}XXW~pBP-u-U)VmrZZY zVq>hgD6(_Y;}_&@-n{wt&EMn+8uZ7IJ)E5j&}za4&F3)@8IKuCw4k^&e$2= zdH&98cRs%JgHLVz)R9m9YL{cz#$8YBdjG<;7w)<6$VELDvx|3J{PZOimqaf4{H0}= z-f`)%J>kndmxnKZ`U=|>fh*3s;)yGFT=~IOBYO+>KD77ceNFowzgoHa{Hwom^^;eh zxH^7K%Qf4s`PsG0uD$=dqU&zE?pN2ny}x4r`u(@>e{HC2X!FobL%$k!4BvKr;QBS! z@4Eic8*Df1xgmDL$s1d4+;ijIH$Hvin>RJwwEL!qZhHBE9=JK@=AxSe zH*dQ6=9_Q3`I|Stc1t-pkixc&?@=yO9t6|2vpM0JIHxL19b^jUh-xVc@3Y{DuVc(^ zvs%zh&9&MJ>k4zLa%-w`tF|fG@!dQ({>R(Y`5!zzq%5R+E(iClQ1-(=4R3h3Rps!Y zJ009P2=}AS>aYzmmrLox%~y6>pzy5j^w<@vwcXmqSYZLQw!GXNT$`OM|7AJL(cQcS zc=_?l4K4`!@s&P;%OjEDNObtbiOAfDn;-A)>FJJFA3n_IU)9}>p&+s(U{TLkYN2B> zZdYpHA3w|-V+xNQjxDG&wV7+QnFBBURBdL#Z=b$R$hc26Jo}=JlG;}So*9U5q`yxB zp8B*fFH){h_8WaQ^UaVoPK@i(@sl(#W9;*cHg)>ACcrb_XcJ29OU|b{g!!yQ^x(qq zPOGYLU#?P}2~R$qR$l9kn- zg?XM?TQehAT@}DRD=W&&N=u51#MEnZo}24;RwibBK^116CLDkLL{` z44sI@P7FojSDEOcr)Q*l?=Aa!M!Pk#ka$st)G)^EmNbFb@#iE>d`{3r3JrIJ&jJl2 zkjgC}UFLMSFkq{VGrJYB9k*MfW#(|$`#czUyL}Q$UJwM>Vmx9rHAKmHe<>2-O{5CN z-#aljcEa7wkN5PvSp8D>$i7?lf_C*a>I0SII8t~C_ZxJrS1d`5xsh~^>e$RSDtqL$TqVzI!kWT zMm#~@huM`T#IO?gCt8=+&PsbN_=!q%EZYQA+nDCdjS-(6UImOf5F7!5Fl}}q%IQSd z2#RVaQ&oW}kfhCK1*SC4LtH1@3kR~Bxdq1D&QfA?m?iKWU}+|?AQ0hlP+Bw^89Nw> z9CRzA;5g6pbdU5r1BPR)IT}yCz}IZVyHeM8A^2lCaA5;~Bz~!V2hS^I(Qpr#tc$Cz zK@UeXia9xE*U4;lCstd6)~r@bAG2663Zgo%PIbmYO6H;2#6yYD(u{}5a9K@_X;j;{ zyZ<=Ka}y&Q83mjP8Z0CX3mUW$4cZuBvja#MXKrT_Ejk=-tO&Qe-Q9&dK=~r}ZqQ>^ zDm{u7A=kG~lUNHnRq6}bglD2lXwrhOe{mAJlx^l9PD*o;OqWDkG+(mKY{XEfYBMWi z8{+-)KGld!i~CIAwM56VO)%qq662bI_~=yd)FTEwvCSfFy~)0s**!u&a9uu_<}-`U z3pe4r0)9P+TwSZpVjaXf(N>I|+idMNn!qfUB`43}EYsG8#+7rI^AX75u`yZ^G*NL% z>M-?D%+3jSF^h{^dO^(&yAx~E1)aiW9~All^AMezxtOOfi+eon9_qN5rOF3yD(y&N zuz+*~6Gww`FlJ(E!Jb<-n)w>ddr;7iF7wmVhHRtD{G>MV_cT1C4ft9kXe_}8Xs+e8 zK}}yUt~KE%n>B_*w4Q8; zKR({m!}+PJIL8zqPgK*z+_-~}EeY<9R7IN+KX zBP>|^Y&v%~xU!wNGQj~E3Q6jR21s(#J;L{nj>bnuw0_keb3HOPQrj#aUqpD;`m!m_>q%QoaDxPXNEejwgi`O5M6)g710bUJ^tg-6~RpAX>i!#V!7xn8ogwj$j^p;?*YIgT@83 z0`rxDeuS+NWSj z{;6?vt<5uJ-d(`!5^WvafjlW87ym2CCKB`_+sx#(<6qGz<}12=VZeq*j&zq%aNwrut-24*d*8!UXm1|&C%iB{d1#3k_>td zAMWWn^^C#}#m6~6L^+?B2!mG(9UtEvDrvAP#DZ!Y)WiarRYEqnoVv|CQO5@|2nZn^ z1T~U`00|CDI)u(T&iLU|S9SMr7B}myq<5TY(8NR@qU%bs&FoZ}mPE^FlS&gR@fLZl zZf7RT!ve9EOWDToIj}6PE(i1w7ZN~S@JJvzi$NcTYr@O3l&r08uotWXi^bW8r7YBW zsikC`BcOt2h~|V|CM5a)5FI`U1Puu+Mc?Qd?mR4TL;5}8>Vvl+(#*aMlBWy8b0M)X zG2lC}G~~^{xv1NVb8Gvp`D300s?<-3q= zbUh}$e?zv>`RK$pB(G$f$$b~HO=jOk0_IxeJrW%$6ZBx>>+(Jm{2QS8it(qB%Xc@h zoQJ%|&peW!tH6b{wj<_T9|<>rL2z}q3yKW0UkV2mCIB*Mr<*$*n*QK{1#IiXRDdQ* z!y#Ot9-#L2o2P6Z4VU?RIXO^-{62q9UQV7#ehFvPA~AuB=GjSlRoQ*HK3}d{v1(?7 z+w+FboEwe*v9R*?u6yS1hYcUN64N7$CHsG(kuD>7)xv0!DKo zTtdr*MksoQ$nA+A>w!b?=_DUPHrv$^3xSfzEhw~MquXR3fwqiG!!wMAaF0SRkl8EY zqzklW(QqEJ_{~lPvEadJq^48lhrR%{nLCA_ht&1{p7=A}9nU`_@zEjppAVMuXh+No z_~t^Pfd^oZm8&+mVO7{?Znv&vxm>)@4oTHcP5>tiZKv~WC#ZcMT?EJ6@M&BX4Hro7 zYmzh}3*AZ#Q=fexnKT^^%IB-15vhDfB82SkZ0r$EE6{uJ7G&09icL7DF&&U&YJ%U) zX0h*~d8H`_i+6B~)rC2CyLIKpYPI!woQk%7o9Pm(-8MY!Ych|Ae93Y;Xe456CbFsP z-M{GqaAJ*ef>6^0^(6Er;%yKHQ}SckMwgMsnoW|CBvdq;(Io$+7s%nVI(qHg$}Dax zp+;ryUJ`~pNf>HePN;)f@B?Z7)y#?t=8}XU{HLHr@@@eGM4p&esfdd?9X>%c>h2!x z+1LG|Sh`7eGvQ!U5)KSGZpba-@3M`KgXA{4KM-wzgNgn?d95z1lCCxMPI;}cxi$Q4 zgI?!ntHN#guBhbCaA1Ku;GR;kUR5A6;Rz%;?RFVzl%JWMQy!t!NyHFxV68}$!PRk0 zIBK8e&aZtf{tNPW=#E;_wC%0!$)+VxmpiFwKW zL-PIkIKr< zDLrt+mCXGLYWQO`I`{fbeBOCCG)E$y_xJrnWM2gT|6$+ziM2p;JRs;`@;OEu^Bf!V zC(oPbkK#tc7a%Pi@(4`F)FD5JpkLk8QTVB+yA4_-dfhP%dX;T-9V&_D$d4lY05KI@H9z5^Z!HYT|te|FSP#hf2Ori{_h>ZJOEF#^2FwxOa3L zPQXk)2-!xD5l!riba&ZC*F%iHOf>Ifi^B6EcPK8QG8o+C(ShiqI1s7olSU>;%8**V zKv*tVbbpAzjGjwYw7dHVABi76a)fus_a33(UWy%uK9M5R3-_g4vA734E;s^UDiZ)J zI|%?M*>QSUWD*-eTF%5Ig$YFqgIJ^>uVz?qbNBZS!=95C^^x)MBZAbrj{qo*-i`?$ z(;ki9-b&+(c}F=WXi2u2g^HJSw$?G>Kay>#QO6|Oq|lPNuNkPsNxF||UW9fCY2tzw zVFg#TL8-N654t(e;a(KIfOC-d27=f^3Zbn zf{5+Nk?KREWDJiUsy;FzP^ix<@d4qlG*b|W3LF$Ot-{=!f||(mPKGAeL`}S>`#5ay z!^gYhhHnt-o7Nok7L#l@Xx!i>wB}@+$$5ZmGdT~CZ6@#l)4Ub3yQS8&49;3bwd{ei z`tfVO(D8RFwpR~r{o~GW&BLj95F}?mm;^C?LMsA zIWRZI*$51rV>&OmN*Ti#uNU%zeRU#$8>dt(RVzFfR6~J81&Th{}tf6ks>{+;vo(_=S z=UParm|=lHHW+#K3r{|XL>d{~?96b0p za!lgQ(k$ldRykk%m_A-%myyqBS$Hv1?GQ9lKarkT!zni%*AFS%P*x=QBuqg#Xb+Pu z2+}clAaFcIykEGzrjV*;dT_NpaB!Q%fk8W1XM(2Wd0LA) zO;re*lIN53cvE{bEmtT+YqCA9SKUsm6uO_pF}E`=aI9&}x_eCwcv5eGBowF+I*udU zHM~i4M9k|s484$WtgVxmg`XM~(BSzq`J2MWO*u5e$F13~EkYI*vRgZ14Y0|ZrMj&^ z-DcbkFi9-wOjnE015B4on&imCC`H&!wOiC)TnRnc0=7N93n#H+wPBLAK&lEHng&O5 zJ^AEtaj`Mvb8@e%uD&6@TauPGrsdctsR)(J$TxuLVBu>KlXV<$a)cmN#is5=vn-F2 z1wb`>0`k`0hgpCg=kd56(o= z{w_2Tn6UA8Uw!qFZh+DQhX%-tk4hgq;1PW4t71+QbC-NRF-LU%H<%;YzJcaS%mtk% zz9!F0zGn6XEQDXqX5qG8^n*pDr8=zcBoh~kH`s!u-O`00Q(Xci@W>XSB`!k!zo1}+ z7V3}hg(@qOEjX)$Er+}!U>5!l8JU2hL+&-Ji*h;9tL83R-3i279ep0R;&8M(sMoZ~ zIZ&cC_5$Q4U|3dOKD1>^vxI}67^$or*#w*#py;$IY@CM#ZzcRC+a^LUV~+z~$~_H* zXTvei^&~CIejq&`2?-VpwwbeAkba7WYOc*$Smy&QD(tl7LqkLS9mM?^KOV2fAOybI zzkt3}R!kmEWF8`u6?OPDM7mtX66H=J75{*b)bvWR1bvqEoL}NP`pu<^QrxM0ANIe^NZ1}+t zkB`>Xjh=dsdPcvqaR288?a6*;y^e0j$H(75JU>SvJ|NG}{k=F(@j>>4pfPzqsI~t9 z=l{h7|BUa+`@D+#_)Pb&r*Wa*-0?GbzHy&g1^3~|2srftd;=u=K9Ifv8b7Re(*II>T!qWUV#@F;0%)Gk1|#b2@BDF4gEu=sp;o z-9C+_D%b=tnrwF?GiYo$IyQzpC`!_aAKnOV9Hi`n!;)_qzPQH(oF-qKwl?KDTA67b z4dJe*u1c&UVM9MI)_l$Q?~>QNz{@-QI%NnnCELtoqvQXm`K10)^GPj9J&j>dltI$Z%i;%2qspv&oirlnwG3RHRGnw%G9w+p z<*bmoae}&Ks2OaVH#PsVcmJ(J2f=rcAVthFeu&0&s%t^Y{=HjWOxsbVegmZa5p?m21p*)|^ zJ?K2i1$jPMKcu;)^Qn4Z;(YBs{A|FJ=vU~6kdC$EKf=C8<>2ZRbH6n?=3Z}v(9?(9 zQN?jOA@}6w(+j!l21L;AL$c2Tdu_Be@^tb>HL5HQ^-5s^OL3n8hCOPfuo zk?p81B1MFP^XbQEC4)g)F1chb@Vn#hiSTFq?h_}*9_$7=^_+T64pW!if@g?)JYgqk z_7SO>lO(JrtRvkra#Nb@E$}`Y>yha5mucve)~P%{ktfUZCYi0-R&C)h*0W-#d;uFE zw{hfCASu8O7hR%q0ODlQc#IM9#Jot??s7gLFfv{lys7=OhPx zrCxUxU=aC?pnql;ZXwNkMfrp>^+qhg$zxlLz4)_@Ag`gmQnTmnxu-o-$Y@36Mo20&_Y{ zk%)lm?9oO7t8uhIxDs_a^F5)j{Z{CMGx^gKb4bVA6yOasjy57j{4Gfvm}~R-M(jbS z>ts@HBVRlbBgUX;sb@3+U|&c}gK``M5=Vvhb(Ik#7Igbx8P=aXKT$r*^AqK>JU>xB z)A@ArS)QLLpXGff`fucU;lDBX2l*c4d9(k%Lg;Anyso1mHyyjjkq;(AtQOduBD#hp z0n+db16L44(En;AnuyiDc<9KHLob@+wCK;IM?<646=_?)(;@SGfSgp7PMbG5cNBG5 zK6G&C*8RP|Y$o$v=+9&+!h^5j;h31mceHtY%iur9ge@k|Q@mBD&tpQLlIJPLnmAAV zSe~c2s+smqBbG{P&i_y>wI>M2=|;o6>*>~DhF?m|HR=W-3si1XVQ=bAHi~+YWh2&) zWJ^dP!<8b%TC-`ixbC(;UzIp^E zcW}g@FM$_8lZ+Ql@7K;7@}6=u$X}zKH~AJtU9QMuXI49EF_0AP;X=;4P_@PTWd4j; zZPUwtkeUic0xpl`CISo40qK)`y1FK6xOR2tuELUPz64z543)DIE|kS)p$6RUM8-i1 zT#mkMuS?b4kmW30HE@oWVh^wk(5i&(OHR>b;P}AsE6L!&Dn>Ds4xx~l8s4BMNsL*c z8BM^L6&WK=>BGW2WlR}KpiH=Er-3p`{U>zkAnCLW{UMi$Ojyka52q($MM*w*Ti>MY zG6g-FAD(Za+A!&fm)J1)8T!l?^?&gAs}nr_DmkXLy0D3kY3j@vbF#}{AEMTeWj6W= zvMpiczrh0ly)+wjXfD)Ucrkb{AI$M6E|;dOWFb3F*Hvi6x+xV!FCv|?IEU7u(AcUL zXj%(CDSwZ=0#b+3)!2unQiYQ7|A@pdPiVB7dezOjP;JR`yaIc@o`>uS${{FZS9QdS z;oF##NF_i50qtVorpiezt6&@SF}JG^+SYa#LVz>VH+D0Z+qKoW#tGj>k&JSrV{X&nX_^*{&qWPSHj<* z3<-aSk9}IgKT8G)L@I=hSy6+7MW6+<0lm}d=tDSdy93bIOl(SZoKDBq#1(eHp6~Gx z+~n`2Kwxfej+@}t!3K9+gf(oy9JAnfRdFqR4} z7lH;dP0w(dY+nNYBjsA)qB4wU8p!}o1%g_NQYk!^R%Xr3wb+Y<&5*fC!+KUNJ zVjO_fIV3<``HX;7(&UvGs}qILR51-Etyn<^B+xK)U>cO$XD4s17<(4#+H{Yt!%iMs z6g|SYtMV@b+g#quPYlPOj3C(@`$um$wXdh=C0=Rf%ZZpb>^3sw)7ROH8J2bSmFes3 z?WX)0!8d4zr6H&1f~2jp2j37rO4WfQJN#i6hj+oxk*nrFjbt3zomOO@S!Lc&mdN|@ za!YoW$g&pETfpY=WcTIq?Ci>HgvltFheeT;=c8@BfZ&-a%;&SqFdsq56SN7Qmw^3& z4WHf+Kd$AgivcJ@qxg5~N>PYFQD@rtL#Hz#^Ov&Eh7Ur(Rk%>g`!lvQ z7^-xK@rR;g-JEszpp5l=2Q6aTC+T;;PO7QJ)AsP!?Q30e+1WxZ3Uso(JYQdNq2lvZ z`hcG8)C*8FEW5D|e3G6D%HyZ@@i+-!iIb`8wktZ5 z>b8Z_lbJP%StRB}vnh=k!C)bBFx1nl+jfiCEjEe*zZAP_02JC)1KJ0;qfSV65R%4; z1Q(LKXb|@SQ`YwFNa(*5$H`b5Sz(Ie2$q)|#gQFJBMp`hhKdc-XrBcUqcqn>Cg^R7 zd{dB@zP}V08b+1mCz8A#{b-u4wnTIt!`R8^MQwj6ZBB{KGu28}h*~K*iKfITq0d7K zV%qe+GS^DUIO~LZ0=hL!BT-L)#iDyWGmPtW>Irn4L6aL_mOOO6S#CgvfoYO@L2ic% zxCtr05~9}*P#lh|zHF58VcDXZ( zeP`b2jzqeL&x=OS`({JKH|NiHZ=^_FZ!ZNUH~!|CXPz<9)oJ)@X%Y-y?KC+i!3Vuf z)7%8K1gRkeNW(adx|fsC#jXRVs0+`6#!cI+K+n-4M_?wP7pd8pd5IPFim01{%;)z= ze=G*l!{WYjW1Lm4xe0P)NQX8Q>hGpfC$S@oRzG$K7$hEi zk2e3E(w|+783z?yYMLPpq|$H^{bs#+;!n}A7qele5MkSk84UX0{1)c!;ej4yB+mKx zsl7cquL6#YoPnhJ29SoKTpKAd8Ke!3ACiVXB}u6wJ(hf4LMEm7=-iqoMeI&xLc|v%1H5%h z!mYy(kB(Mr2|`l#etde8&>e)WOa7{r;WObj;C9qfpymlQqbVlvN{ZMtP>Y=4em8~S zDru9qw9YEI{Ivm*f<|a1#f3YOSbfzAzJ*HWg$5&vSjga{gcMD$5b>vJpx{obgG1fuOVzTXUUN<)bg%z+ZE$t`P2^aHA)Ck# z9gk%scOSG9vcD~sfY=2Ct5fsxh;(R^N5=_|j!H^4-YN(xf4F<-jbVP0JT~A(FUErg zy@<7#d4Dl zro$uy2p(gf4s6%V9klm|wqB5=j7(+Z5@~yoU?PyuAouA2XrMu+vEShKXYF6`g!qpe*0Tb?_Yd-Bk{lO?d{zg#XKf#PNIR79bVlo8>%`} zcN-QQQr6}Oex05&Ng|s#BdJ7EDvPZx#6}}p(kv3A6VVP09>@-g0Zl8`A@l^f2eV)d zV!K)Rac~D?H}TVobs%CoT0PP|QawWZ|GOya6lNZOsc(N^uizOWhZ?%$?uTvVCsL z;;(*nam(E8EiLoswp`fKGWY)b=eD#=q*sdUVC!Eh>qO{M#B}uPUM;4B*;JHi(5rx- zG+r`#H3=>D-$58oMsnOeqrJh=>h4=au6PnGKDIR60;-j99As%ZkflW$kRH#OI*LP> zTcD|0kSC@n4nL0A%|_@qh;W%>ILbvLhVyG#m9k)B2*$?T9ujg|5J&2@6v{CLaHJz| zA%06A07|(>%GKcobYZ&i&!pGk@kk#c`jdj8*tzGMqd)vrivGm&_)GEeUSO*VPx}D2 z684(lZ_o+S*QX(jD|Azki&2{|hm71sl%^&0 z5t5fd_Pj(r42_fkR36l21fZaJx;+lkQCLov9XtPeP}1PR&cB)jMcNdEC*aM>^7i5B z6<%+p7a|l}lGFXnBJ`u&FdCjCq-xMJVF%%qa8mw637Zy2nzS`l@$rPnO+uNRyDRx~ zkb$On3x*6_${Moi#9KDTgV35!lNH!IwY+o+Ny_? zD4jlE08P*sO|ce$kulanm?aN4_yp}(?&dE&@<_buzWa2Y7h@zpRNDPqfj_+tY!auJ zv{6iYt&Fh<5v6VFp~L<>NVFr3D~EI4~gDo9&siQj@cT(ynuTr$A^TL zBljaQ&3C5w5Glo)FV3XpJ130~@m`WjD8Bgy@fjN1v~r{|Hu73i_HcEk*q4xt34gqB zQfJPQ7W7BC&9?~Iv^jj95KGvKYbW+Yuv_tP1ZG8KC<_}TNO^?Nkh2d-D^7uE86~RD zlJ)1)P7c6oBR7m0ObYhIe~nabEuUMfR9`FhOGu=3tF*@ee@63Ll(PMjD~Dk2Pdn&? zLeE5V1OmvXAZk^TqD5MSC>kz7UWxW}pd_cqR6(MLS9Nu*8eZGgwf3IM%6n>R+!uFn z|JvQV*T#R}aq;hCv6w#h$gRfuKaDsMat+~@(e_9CWaC7ca{3V`5bZjKK$g@b0f>xbu&46 zMdc>vYM-411)&LQOh2tF8RJRW|5K0bAQe#W7@uHQ$~7-G$Db8-C?b|aL)0r#+@rey+_7m>{I9RPLLrpI zUR9~F9LkUtu^bwneAoi~L|RTXhUajcMkL2C{h2fYX(KrT4BCJ|l)uXHD`gme7QAoR z85MiJYVNi~D97Q@BOi9VR11Y$l^*|u%d{ulxDfZGSQ4>H2?O>2caf!!B}H)(Xpp*u zdIjd3B3jfpVp+&_$CiBB&a+ycD2Xhp%M-iJ30hAZMWSalp=S`B5pe0{TEJzPGq^rS zIksFzAPedm0$IYpq*n45gx_(mv~%X5bMah*G(jNDg*o(7ihVWo#@G}awj!B{;#okn zMp9a5c0OW_kXYA1$5NHCqU!-VGEc6OUTD(5B7ptA`zQn_){ErBKK8#DCj!s--}mbz zbS(kP|EkR{Xe#XG34wOD7g z8z7{KogB4VRykyv#$IIgIl|d`)`q#bkxBrBG@-SkIWlsWy`o2qkRWdk7|FF=fwfJ( z`N`u&7}@mVMZ(^cyiLT5w1qmX$BQJB!Ak8DE}ZVQ_ZfQ(=xg;fVnqP!v|~jn*Gw5J zTA+ENz;xiVP7^Dd(Q`8ylt+5I`GP9Jcb3IpQo_nLtdiGu#QgA|F2#aFN|py+GN`oR z+-_vEE65yCvbV~lXI1s|!DR~IFtM~l3qvtAW7Vvyv?Er4TP#j@3#9zAY_b1I#(P=m z2IRy2NHBba?or(i!<6))qy&A#nM2twTv`v5kVOV6P!9S9x-~lXb5Hd8TW^itP+oq+ z)~(II2Frgbx-ZKA)*JsTe`{YLu?HY8iFVh{Ss&*VF;W}v#w@;a;&LI#G0B-bv2HZx*FOGP0+QT^O%rl zlh%-k(MZ2$(fZH}N@s=vYza$>;b9x;0xhl3poYOo|#TCwN4Mr}G>?dcJ`JZU7rL zqk-WBOm>r5RR1jHkAKMLm|@~Hyv&pJIvFt{uptyNF(b4>CV7q-G)kh+i?9}@Zb^F{ zz`-PHRp_aILPtaIx`v5sD`gjiH$kddoV4ky6WK&gB*iEQ-Y5v(K#dZQcq79c zJPdfFnmedn+5)FdYvlS)n=ov!a1yd4W~Bv9e+fWfb!;pWQ5K(iYm9c&8B_8+JtHWR z8|@Yw8CBDC8aU2elh7o5&T=6oGE1C-pOfeiS|~n)lRUpgm(M9V5_D_5CIMsCYZ96# z`kTdK6{9qkD{+jB&o}_imyf>-eQQYA5T#J^g7jWX~(CKsnC~RzTU@ zr>6Nm4WDn5+2=b=2}58@IyBD^9TRO3e?P6-0NMkD@&!?O44l&>C7!QBCC5#j6q(3C zDb%0IjY)k2aYGHm^M|A7xsP@8ZSns=!N4=TIsTRIW0H^Jc^GGcYW%F6Z4YmOHH+Z& zTEgD}FR2^{3@<(fD;#zg%78r{A&wz(kl;VBGuw#=XJVbe&1-DyVe{K4#aKRU9W}oW zln*j%UJm#zU$AJN-!2O47HD!1Si<}ZWN~F%`_}k7QX-x>0hy?L_MENfY(2G;AIGy) zyW`b|@uV(n1(e{)0{(J#VHgipP6It2lt+c6a1Fb~rhXo-WVw+RtR;Se`%wNb72;sV zX$-b_>7_+G5HD7 znykPxhzXW#@~ESN8}lz=ksIsC`IhBNm~H__wuPjem|zVCmk_CN*epn>gWufn1A&dG z>>O&Qe2O#XP|I)9`t`9jVLSy9SkQW=$PwjmYt@cG1tsQF-G&AMp}{f{3LO*16luCI zFd?&ygw&Pbh)K~zuP)~WJcVpS7|(6=NN5s|&Y?9(ZYA1M37k^T)`Qg|a8hV7CEF$8 z#;eVbN{S!N4-t$Y88Jt@%yn3pq~t0rnj?ms({63O;_0bodMBKT)oO8ARL3yzWLl*5 zew}&*fu~=b5@%v@V(tWClkbY?htZ;ZY$;^}F8=NbZAA`_^26PT`HbSxNO;6C&1EC> zvi)imj_jalWS3$+x>c94j{pkcguthi8JSTEPNwN*K8J~z^g zu8%*V(bb(IS?q!YWtr)Us=A?%0G4dkD`80#KB-u@f?WxRqo6mT;5JhU*90BYyxApr zA(A$`Tyus@RapFQsM?S+lH$^|ry|xJVrW*x&=9Ac?1_3+=sCV|-$?iI?!DddYZ7!1d^y>ya1HkP!Ojd7kfh{A;dhG%UOj@M$V1qT`_wbIP?ux4r>u3G+;<~Z@#*_+pbvvIOlD)% zeem620z~rBz1z2Iw4FAV12U$uLA6kuC&qGgshuvCWA^P$zMnn%uvm0HW#kMtr+@T> zU=<{2G!f`0fk>-ZWO`=a&)%fle*`}a^-8+3(WlVUbwAAU9*Vd2h^NQ>Pw=PiBT0K{ zvhlTuZ(k>Ma%OROtSYIGK>$Viv^U zg;v%~kARsVyUANg3}&L6B{@+~%CDXTo|*0&ru~0)9;W9rW^n0fwhN7u^aNrm|Jsre zFeCAC@gym2?W3~nw$w|RJ69Z`DEann8rn1j>sWgw15em41h z&rjBuktu&o_ho<+kR1odELLa2tATm^2;PitIdwj+Jcr7Rqu+z4m^z>j2t(O#N%0YBE(Egp2r2Lp880~}9OVt4 z*Y}2&u$a>FXoG0XtiTa$DFG8@Y0;kPR0u;4=7a0NV#jWl29Q9Mux13J1n)%TmB5?A zv*05QRAbn}(6XGn+Vorj0`AlglI<=ZRvsy?8k6Z=`&0F=n_v%%x$9HieM%ikzmdeejzIb zy=+^toDB#SMUT%VbjvJDvR}xlO{y=UM+0L*lNPu_QMRs5>v)p+jcN4=JeW(DZ+I|Q zsw~BGr;LcakZ-wqBwo`aQerJytW!L5%1Td}01e4UxI+?U-f&(p3c=EanlKdAp5IOu zK|*Ji_5K#cYUve4dz^~)7>4Qq#dq zvoD~T7JLa?9lKxKuumPlq;QhcrkO}#WIOex0@#da{!)A#Bto`2E^=_^@M&BnY;}EY z!LpN^#JRU`_MYo$CDTZg#tcvM#wJ>OpU32EUn zjMwAAUhB~O#CUZ+3~7^aRV1E|YRrUSzw{6qAcA<3bYIG0BiC2%8bUi_@{zr9+6{QZ zTo4a|#|Z?J=~R%cI|{?m01>%mO<-XoR z+M*SCm8jj%>4i#GS4j#-hDiE)>t88<7T zVV9&1JA75fj`K;CNH^kqUvB}=Cv4{<-&<0FKuWzxV5`stiJx>){XU^$G+ToSLb70U+(-eujAhO&W48gbMY5KM;aD4bTu?w z-LPx(P)O*AM8|s#IzBUrhIdm^sGwn;kP5ky57PA$>H2-#-&@S>B}BRQ_H-{!K2a`u$WC}50S<<#gf_$CroiIO)F9@;At-!8G^s5w_$+%E-UigW1 zP6U0mq$_NWoYXVR_ZHI5uC##sw17T|;fJqD?Yw|!xiC%V1^(V5UO?zC04*n>pQ!jl zApheb>}e4-I4<#9Ghve+^z*KDo$IgYT;H|s+mfgcH}>|AjP&<5eya)pG7xorSN*Q8 zmU<#<&yjkPWkl0oQoaG}qLFnduXMzmnAgwI17R%UfiScamXDLt*_(?%bG}Q-AI#yT zer97!tN?dal-H_RWe|DQ+#k&L_p+e3DALS*>sDR9D|0Hk6&W*4?&PE2h&Kr1VH zt9T_Lvl2TvCrvcm8q=KS=|M^>Y(rC1Ss7zZ9Zel;&OU4Ps`iy_t!IYMSh0MWNtBc| zmZjOQ8T70xSPAWFHiU_95<#KrB1Tw4QpjjeBTl;pcWH7&e&j>IbX~P>-MTKmq^Wmc zWMrVX>06EX$IFE*Sr-aj)3B>yT`2x@lf+3~k$9#x?B|o}V&PM)WOb}r?I(>%u1pu{ zO%2?htE?>zYhQBkB`Sa3%<^ChCfINB&#+qQVi*lw1cMJytz5U7}zJ(9qkvtb7FVi96W3) zRXd$@(xy4QTJ*O|_U9c2b>wK{o3uk81Zsjxn2+eh2MH=LN|KX^B|SpJ7f!P?==mw# zVBePl+V{oB3ee?rdIPT@b}?USn$1o1p+H^0^q7T=+GWXUYM0O_b7`|-fAFWBU7hPL z!=J9B_H#qs4g9a)sc)#iVPu}I-u>e*b==YMVJ6vJuwlGe+~)Q|4RRN7SBcv-Smsf{unSdM;Df9*z#T=Uj=_pz zEN~bSMe@km7c8%$1x^cr1nqTt*Tr_mia#0zqIc+Cym{~ln`&Y z3*>hWG;y z?WnIu6qfker#0Jn9$N%Ik2A?W-ULA+B->7=_)J;|^Oe9zF7|l`^Yaw$&s8L+DlX%W z(qhM80aTGf&6Q&^i%Uyk2^YbuL%uZd3o6jOaLOL&?!tLg%*q_aWuiysD8*7M;5pPw zI^$dR(#cZ0Bo=j1qDy_(GGjRK!$C{4gEi;o@Z4VZ(fiaLSGt1%q*3Dam1u@`F&Ww) zcb_CyH3yDPv4MGkG*2?hC}PQhGc7w;>gB@QN%pM}v!Lb)cJ93m_;-}_>VsSG&qSbR z?@j&vo@*K!uJPPo|G|>i`!)J}Sd+JHY&Gjp-UMuqTT>d-|1=~gnf@P6YLfGfLSYmTlT}6}WO?bjuC8@g zcEQ?@|0+p(^6v@;MSoHmRH_86KjOKjzWy3`;<#^UnwL0BO9okfzNHV<9^`BG`!((~Cpb%Tr`lR)pY}y?CyJgNBsj3^ z0m;fw4h&+Q8d$_HGeSg9cKqCA5V0DUyQY`WQ^Y?ycBTs!@yyRp3RVRGtEd?)Bqz-O z99(3{e1&-{Y+2qt61)PMN2Nm3$V6sI0Z6JKYbVT)^dMI9azR_=V4WIm3D!9UWlaxv z;eRCXD!ev9?>zheG592R>X|>ExYN3>&b7p$=C7Wg#yOckFF%c<6fojk1^y)6zAgiY z5|J&T*URv{;6)1(;dvSP%D|--cdnz**ZR(N@y8pwx1JBCG}hR&wc&htCI7u1|Hdd- zaBv&`nH4D&UP(_w=>CR=`)?QsHFVX-KS;-`$WQr@;iqh5^OP*9Qw=b;)#EloswnzI zXsZyruI53+k|j=+y>?V!gMl%GZHt(Ld>Q#X$C-;QT3s#+HZwO=DDAMQ$k|usFEMm} z@(*4-X-5U7j^Ld}KLyk1hxm=wPbW+5lorsQOr2tjTR0i?q0v}ngtP!92?fPdk8qNn z;SDlSng_<8Kq<>Zw|NPSl9nJM;UB$M(*Bo7r9V39;FSaf18m`l$EOF;IiP$*VkKMHdr#J%Y2&!IkJkI<9sP0<(fOfch| zN@20@Mg+M|5s^b`=|{1MB})0*T0W4^=AwuG8X>*hzZX74>_=YThnqi1c~-Ee`PqCJ zPAb~{GbtPg0!v8(qlg-n7Ghi!P}2_egs^DlgfN%byhV5h3}~R`==pxh0gfzFNE~4d z3}*tI4kT4MC__nQSpE|p5Nor^T2R1AnM#!Hi9O74oxYV>!>J>NT6P2Od%z-wos1Zd2_$fpVE3X0b$&u5Pu0 zP~d1F-`gCz0Q)KoPveSkovE?P;oYC){#b5#NHfmK@@RyDfWIV0F+&)!=DqpzcR~$~ z*N@J(HhLnrhCni3{^xT{^RWh?RkBArVr77~ow;3L#&|-jCySoYYS*6On}zJmUP>Y3 z9_%WsXOPKC5PF`3m>8Ku7R^R7+-kay%WcIoSUp)DOBNNC$fp6H-kqk{NlK?kG1KWK z-mVl$M)SR_p`KLf^On>%?1zJ$p0)B9PI%Dr(QpP&76oNuNA=`Kme8}=X^&AslQIV? znm!**f+jhZAE1H!bWa5q3dz-ja7t|5npMx|)z^15EU7P!R$N5Df(L5NN9e*J{w#R;zuot=cZNq88k$UDmd) zb^CCYzx}tiX}6+9x7C$)Ygg0O*5v;^GjsF%<;A0q{p>%#%$a@#cp*U-dD_LrW6XJGs_Fn++nI7kQBXZjv6dcf!okO0Phz*4|HF^q;1sQwf4DM1KJLU6{blI?uJukwve5; z>-bfvE-x)zT5>I_BFoM(`u5tV;~{-VLrULa*jcjg5GqRHGq&#_B_}c?g!ptLWgM?A zPh2)shgqegtej3Uod$D**}|4mPG7@jz&JL^T#}5%?U=qe2pH*9>vhF_I_AP)8) zVnyl2Yu}>C(svKU|4{v95Bz%uuvGqcLi`WuR%DT3K(`{~aE?$z?_t0(_y?jV)gCZ5 z>#_sIw25?K|D0~9b(Kae%Hc_~nCt?TURIZg@f1*joItdoNErRRU1AVSP7Bdh#8U@DLxX5e%%&@o`>Y8LcIQ zwEPX}Q8`7OD#@41Xe!=STwGnfXVq23!YkEM^`y3EIG&wAkmO8Iu_=S-8X#r2kCG(K z79w^-xm{Nw$~T7;!={Y8cD>Wp^?)&bCTaHlUcGM8%rK|=C^X^&k|tY^IZ?OYgtUm7 zRUx~(Ysdzm{`7sg=j~b{kdx7S0B=mkli)mvrrOj|m?p5o)>E#rAFtO&(m0Va&DGXe z36%O8_|nwcxRETr0R=lZ@_omCklwHE(&MO9`7>pGXW0Go3uSC$_n=k{-9ImdW3!r% zynE%`+5KHzCrWRz*^fVbdU=2uAWdUixd$ZmNum&e)Q8<$DQ6FMS?Vi`>qs~nHU~Mn z?SMoLM-=mVn1)%4q9!GXMq@}8u~=0MYG*UE`6Ma_IiA!vb&0XL3~F-obJ@9)7qqjzU99zw(cYs_pE&_oW>V%0`pwRf3w7a>(AnD-#^kqe9_eXfvC7qS}i= zSpB;Rfjupa8SQYmzW~SILr8@f1WGHBAMM0mf7RK|wu?@)kzA6+Ohx0D)1%k zTK$Rkb2F59dSd(#en1qT8AxN9x9d+*68qho>SfK^+DUzP|CR7n z^cb2N*?B?Y!e}5O-JUtcb)h*C!8gudCC4n=rjnkO&W`lR-~(OLLF5@w;bceMlD7_b z_CCIA*RIPt4V^n$H;Aybxt;vQ_8fbMGTD;Pu1^(*oyl1Y3zud^*bwT@XIQ*6JHv~| ztHc_u%%$>`-w!1|tBzksYRv&SBo*O>aB68JieQ$U;mX8fL=1U#$hYLZ72AXzzVG-TS-uZaC@h()dnq z?|r&mU*J9zTKX&YH-E*nCaA~t5`E#x(CXy;3A*fY(-BB{UenEb%gKF*G0oRfzI*QE zzx!zNJEcEv`hqh>qwe_aQFfNdPOo`-mF>5Hx37u4o$nyhh&`5+-AMEzGHWeo#2eFa z92AdoTr^CVD`)RuV=ofL^w$7cDDKEG$xy5$iZMp`NgX@?KKaOlM;?0crH6Jre1vb| zB@@YiSxWwakQ~RC#yy^QZmM41fU+AdR3f ze`0N2T`dMv>uNuFB)9hY+Z15dGKPY)1) z$I7W0?lu~=BTw`i{IMRA4CxNnMBP?5jB~MN+rS2l$gK9MF#iQX&#syq%WG@PZ>(ut zrS+|Ha$i?Q6iZuWz}F+d!ZnUg32zem)_* z0x9qcq>i;%i)Z=Q*W6f9Q&VwcO{Y|DBLHeWMJw4o+uL_55L^7t>-!G$^$+mb^2FKT z)yjR)S7b8;2Y*~wcg`ODd{^~*&jY!%i~psvYu|qTfRU;5 z)F-T5GYJb)0V7w3#THtMkzcTzB3nmzj2XReCgpG|j8ozChx%SE>uOP$2{w3b zuB<6+B0mRFg8;D5yZm_hx;=5^XY!T0&DUoY7q2YpeX6KvMTx!_@!w=y4fzbpck{@& z6fD~FdloWINeqL=0WsecBW>VRrVQ$ zQv*5KIU6P*mWS7((Hvg5^mLt`p0>7t`Q61!C$sNcp?PMAed<)DrY@d3%mQ_#zo_R_ z<$-Ci<=v!2b*5R*lWxRxC4y3eR_RXUXFC^5YA1^0JqBwx|E3R=+ukL0HmGjb>KX~C zS>1^3)>YX2!Ejyms_H4?4-GLmje*n218@pXVv+DB5ClfjV`-?Gr-Mu{Jp+Br0LTQt zn?Nm?Ql2bJD}z&&vw>;|Mb}a%(S=K?h+upzwGv;v6zuElwIDycD*N)kDo!0H9cB#+ zcG&cB+iy4EIC1oaJ_0dFCOvyyZSQ5tAcyb9J)m(4=oBC1av2(8+eY7KvEd2s7H8(LUb;i~S%m~UV(%{e7E|k@u)Y*s_vk}b1AlaFjh*`qW3Uel{wpK3= z9<1NvDG@$*+-eR7_0$z=nKzDem(X<&-et93)~ej`ksLPP6|kqJpjG9K_ws78v%E|- zJ~wkb=A%_42P1srbdK1$2}TQYqGGKX(Q}MPA2w!!9y?}i18R5()Qsf=i(x>cM)?n; z{9Ul@zVowTLv1VF(3r8Rm4r-&Z1N#98Jn2QBztUEM+-8ek}<<-4sq9;Q!+F2JpEZA z(=RqTiFQr1pHnmk8>W;imXcvMJyI;Q)|Qe?!{ckR*dLZs#6YYdCnhDN3CiFhS-=tU z6sG8RtvQiJ~&Q z8HXv`kj%2kE-Ohde@+Nrmo!iYgBs(ZuCJG1Q@~==l*>Th)$n=Xx zH{U4@;ct^+qNP8tXbzUkO-ne{EOk7V88>b4M1-1uxzRF|3x*-poY}J~VKak-wW%YE zYNC22%ezMIHT=vU_Y;=y!leg7fHOUk6W?StdxYhZ0jUK&k)TENa zk~gwTzPh8PW?9LYKNXD~TU5NWcua0??nm}JdCaP&z z6!<`52dg*O?#>qTGueuLHlwjQ=N0JubT41#YFThJCwt`PIy+WkG(Bf6+JHHWmySZH z%~(4o%ge|x7NZ95lOmTCb;?mmX?3idc=3zq*m}R5Du_U*fCA@Nh;9MCoe#8TY>+AH zI?E51*B-6qzr2>IL8K-|@?FTGT(E1iYRZ(}2MbrZvGJvzoPC_7W@9r-$rv%M6FI`L zJ(ufpuY(@z^Wc69y#^RSuB7s>o)p5+4~ z&zMbBW)X0f;Rr(g+!f}xm6ZHjY3bAd^iSoH$m;OaNt33Ab$iy+S^SrEwuVA~i7AHQ#%GUr zC$BT#HGt@{MWBFHwuNa@0Wj@p&I<@cW5>v$r$%LW_MboF9d4}zHWlDQYL5}n|#)UWl(@kSb zw?bL1J!mO0teumZx$DP4j^16evLsZps%UvcZhD_a0r)`i3byU&xg{ml)o7Z1SBF;J zeDkW_cXdegoUbnKeb?fpP3L=8n)a74Tyd5VYej64n50=#2YZV zEz{4IN^Syqto13`sbw+j8lb;Ro=4|}5h`ZZ*7o+i`s%rQ6)0N8 z8iwBg-uCKMTJ=_cx!)fD^Szp7DEfCQ`gHG8*su%P{=EYGeSzRM>DbK~Khm*l&b)!o z(XnSl89f@ixy%VK#JsB1hmqEajD#l5%aDg+!Td1iSo!$Q$_lW2Vivww?ONxSjLdOog6C8H&?vM`I}^wXlN*B^Pr(y< znv8YI$FLMqOm?ru^ zL(<^WXhu48kxUAq-=&5&)$9oq#*DEF2NNbvK;9oSehmGOoR}0D=>(vBr^_KaJI?rl z;LQj?qHrVO=U3~A)xFg&HMkNV@-3cUQ~;xCnye5rV8f*ro-rT zq=y-bIL%4$5DLMPqtWDe#PY2gIgxEPx%xk zBx9L=CX_S9*?Z5lD6>4Ce%wqB8hWy=kkJfAVmpsM%Ac{COcSGd&DoRIRYVIj^iyEY zhL`!t^MH_bUrr8^b$#ix#U!3xXF|i0wS6|mL?Tt@2$WQt^Gs1Pm7L>`rG%a<@(a$; zU1WXmU{PGAC}oCnhv`Ge?|LIYRVS7wafkvzL=*^^&<7`*=z!BXBP0bOF#yO|=Qw&Q zHd02{cIkf5WN8XMIGvUbZ`Z2_`FnL&ZM;kG7kas*E2AsdmWza@SpiO|FHw4p(+@d~C^)t`O3qPkPELlQ-63^lpikCQ zN-gcU)tdT-=bg{laZ}MPFOxF0ykY`j2m-Aj^Ew+EJK+B8L}{v12%L9h8u2_w(N_*j=z@&-^``H*;COTyQ7t^s~@ha;^4%;rizJC%3*iv@HJ{*PZ`f zR+~?_?(C_KzVGVSOubA~wIXHA?5? zsvMTc^73+P7{}(V&DVLkdCQDGf*HXcm)DNA1SX7zpYYm#ehcGCvbQkp>G}op7bFr~ zn&!`+zhD8EYjjIP+l3b-(l1P0*owQbHF3d(iM<;)n)WMYeRV)tZOw%-`W2?bLhLu1 z18E2xX$Tx6X%J)~O=lsYWlLGJ|FW_&F89mm%A72tlvjSjnDkDHXa1U`p!_Z9{kY!R zfT`I;>xHhk>6ErjN(-;*`vbh{O(VNB*m>m1h*)lpST+m$Qw_e}VO3ZZrIK-!oY5IF z`%&GNXku`5L^``mtX4IN+oL05h$5-Ig8+Q&)>}Kfx`dN{c5C}q{_pST=<8Ga)cf>5 z>Vw{yUV&<6OLKv`Pvsm``atu6Sw#o6{#xIC+*qEmPaPsI8@!aU#}AWZ=&Oy~C8~3> z10b+2gpjHOSMY@ojc6gt%n^JlU-~N$oWJjpjOAa+ICOha(e0RmGyT=~4KGhqi|kmb zfa5`7^4IYWbJ8R&njo4<_{3;=@lkbZ#QU+XUhG+jg{pr2zG{h%tpmKSyfT7a7=|e=?Ykhh;foV zJ1JlSHL{^1ycR|Ga4gK^oIjm9pgYJi!iSq#qWH`=i6WnwVM?R77bB6R6}Kn%Ib!u ztWbqcD?(%5iNm0RsZIZ2-}Hee`dVFnIUhDoS*j8XNR^Q-C?K~8RKJNfz}$XFRtG`| zkFqFZwk4ZMN?(1lpWNahD~H=UsK`0POuFS4BDtdG#HlH=IOiYpy+==x)0~p)V`0$| zWI_kA^%ls_Lk$*>SwQ89W-VPjVsct&ETTRWwEX7jpYM9r%wc+}ml&jVKI14^+w<)( z*x?fgYD8uFBSLo{VH}58&XkhKm+^FJS#*k+(Ey`nZBrI88BwKYNUr_E%hUmtt?GWZ zEDL7-Qkfj>cXw^=L5^VY&Ux?G2X(Bs=b)DxU&Rt+^`7dkLe#jXh!7>^_Rkb7!AOB< zH_I@}s4E$biz+koY8N0=8#E&wJD*8b^W+$@-rpVcZg!{K?Grp$IzQXsVH%^g+Y?o%{vh|E~RV5_Iyud36msR-BMq zhqhG>efh4sI(?B46{FQvt5%A#A$vg3H{{$wv+mpbAX6V^@ES&+?AzW-?;)sE_T7t( zZfxI}5iH{iI}<;SRd1OG679}(2HLqgeXK4RjbS%VA~-F7LLh5&)&^;E*7(4}rFl6S zfp|Q&c2ss|z-+b>yDKt&^$~JB%PZM=*@IVNPKQzF*_lJbIb?BP=A~1yATofD9htWl zuCm#;bh6Eh^v*XA>q<+%!h*!+_3L#OZZRfMii*Sp$^*T7SFY^+S(vVu zETCq+zW>s{*YmvHP)1mln{|q55F?!5@MFC;4GnFchucypY&RfG7njqyY?uDM*=MKK zD&41kqov(BjE({so;0KKeWr;VD{Ibz(pL?%c`ZDRgv3kc7b-`&N<%S(!N?~J0Wi)XAM zv-!YwY$$BfZ*poC$M?uyZf1?(Vg9B8__e^M(hO|Uk7^77o2bAxQrwYX1KYqRO=o^_ z$?{@gTQj5h>LQGt^u4Nk^~DCZ0(Ey1b7#}%8q_gpGPsK&0)f0p|H+L6fIlXfIDJT< zoN2xg6uM8+I#2Ko6XZrFDo8ie8oB1!&VJ0Mu5tUArHd4@HdubgU>TzgsmOLH2j`b~ zLG`wG6z*MXO~Fi*`G2<`cepLJ<4?HfcEFa~knFs(uoUKZh^oIAgp06kRjUN`{ib&- zMfsnTUlMlfUvE-=843q&024+|jshJh*k30qiil^j@l9bX1?Z97L>*oQZyDxYQjTJ5 zo0OvrA`FQ&7cUR3fWSnGTEli@5=Ys#SC0oDVRdDa!p2yZu}!h!V&ulax*%t}1|X#Z zd8Ixyo{MODF>FXL7xaA zf=zENa*2~egiqv=>Of#cvd%gfu6{JEdwtPb>AqglE(K2~%>#w$d%BErQ)<7ye+JFF zQzb;vb0WnJcw+mABQJ>rV`B)$lB1Ze3Isv->BR6pG-8AyJ0N_1Cp@JhzquI7)4gW9 z3CY)TfM1~R#X&Iqb=zLQ`0lsAo2C8r{*Ly?o_DQA^`;vA2b~ z^q&Xy>-32K<9+A(gZfTpAAhH}c@M%1{+IThA`n{I^*8U>zLQgHq}TL2&)?Z@(_X0q zzyAt((-~i;KA&akBnLh|Hm-F*g1Nb>*^Z9wmlg


|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..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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 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 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 nj3(TKn{X3u!cDjd?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 zcmV8n26Vcrdktuv!EYQFW+`tWdF7W+Y2i$Arub2BiY2Z5A{mc#g?t%N` zS_eFs8BHE%PX+L}`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#dS=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 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 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/.webp and media/-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 @@ 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 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 29/64] 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 30/64] 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 31/64] 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 32/64] 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 33/64] 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 34/64] 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 35/64] 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 36/64] 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 37/64] 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 38/64] 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 zMib@53S#9q)$KHJ?ygDkO$G*bRXOXvk9dG(6?<+bK=CXM!c7DKtBgunfUQ^VGj(AO z6X1Fb1GG0`zQKaWg$x(w zk457#`GzK-5`bCHiy3j6=0$8HnQW3Q!Lapv&RAK&=b&48Tj% ze4&M>3pddJ!#$)Lfu5acv;*-Edd`sv3Y#M7_{(3403YjM{(;dLxOu?8)&2<}Bxw%P z_$qK0Ka5=Oegwu2kC~N>U@b?{AyoiVz%PJ?z+wn&6<{$GkWm3JGM1@B7Zuu(%$!uC z3^H(`7g6R39lxYD&t;(n*9VxOU}pMlN49ZK#^3#Ne{q|f&jwwU@bA}L6*@OU_cn??t0t(4>wz zRzDd~?HLO9x`DxW*<(sZUG#Y9fn6f}E zfr%stoeWv!rOC3o0?Rc`tNS@`6FYZGG7{^7DO_!ph~?l-Sqaw?!}xX{fAl){7?6E#enrUN|R z=U&UoYKTQ+OraRrmyGwht;4pve52!~h`qAV4CXhME$lxQcVhoxjBd=SwP|T(X@QAr zTE9Ps+i`~GD*+ku9VYNd9j-%n%#PjUFLcEi^o+_%f`4gI6cCJoe_4^72&@7GS4IQ$v2OKrRsmLQ_lsJY2BI+rjN zA%M_3Ksh%Yj;UV*lMiELjJY*+7SF?ZKXA33&<#)L%t#AnuH9<6R-@&{lY#5VJQ6@4 z03!fW0kC)KdjxG~lAeG<47SjsfgC@l^+xwAv23wu3pZSuS5S&8=>#%ZhJDSZ@p-m_ zfG`C?dOz(4pqrV8Hy~*MR$nXN#erIs&aB&=8{h|@04(H11f>5W#g^p&(D#tUi5w>S zP4uMzO7R=g_fz~&^hkA{RqrrUR8Ef9RHin9?0}40HN6`Bg_?%Y0)zmR=zjpnL2e<9 zh#k|`PcCfhTk}Xy-thzm4ggZh0$>j*)a($9>xSy7Ka%5779QGuHfGRLnd8JPgtp-} zgNV2%&=#?Mg1HYDWdcbfQx@xNZRa`1-wdc-a7|c)5Y=`ipwIw=c&@4AG6A9jMxHzw z#OAMiA9vm0Wc2m{fY%vsGt)0mtWANxsVD&Yl?DHbM}F`x&pv}&0Q_mNi`IP6NMj9P z=J-j8G`o;B9_)BXso*yP{<-|%-=@Xc)94!WDFF6TFIes3;9t&I6a2e-vE{xxj#jG? zza9KYtIY@uq!vshRS2$@5}W?4+f+^_WRN6)b)(qM4C3xV$z8Z@fQ?im5L*%RP8q_Tnrm$boQ_7_ z5KqX7sT1%xj24FinLy7WywBzZ$?>S2ZBWvpfr)6hwkD9gZ^6| zG~MM(evL^y0RmyjuQ8d0*+H-70*vWv&P|Z2w^gT!Dy1FvT5hYgsOOd^mH~pfz`vq^ zU`ar08B1^#_*VuPE2?#v1qxa~u#8*qDwbdxu(>L#VhP%~n_vkdj)f^Wu|@|1zT^46 zbI@f5pkuZi?xV0Tz|&SpV>8?X_zMOgl{KBX?SrlxPsY(=tFYKqO2F%aB5hQFe1JK& zDGA_fFbEhi&KP{8pNiW!)bbSI!*;meD18>Grven>HJogfm8Rw4bNm)MqbL{mnlb?` zgBJlXO@Tm|h>&(6_G8?GJ+UN=bP8#WLi!dkn2ABxg(hOe0JID_Voy`5?u@`vjKP$t zObq1_QivI(LjOtt7XVqL3j-j7z9`x|3@AGcz!x<6wEc9E1m}dFC&DHqU{o#xsum<3 z$go9>J*2&`Up1d22BOWLlb6)jt5fiJ?iXXI4X37m4!It15%vsfJa^=pd-KOj0x7#f z2C_`QQ!p@zK;T@%Wa`-ZSn`0)WTER9spGTwd=ja^HXZrsn}JWa&f3R1@y-E&w-NMH zn(VsU+yvY4rh&iP2>#s`;IC2#UDF=N-!jW8Yfh0Cv5AER{s25>6jJCE1lho!+XUcm z{YBtZ@Xv<7RIE(piv3!l-O{n_Ldf_oPjlQ!0sm~o7#wN$NkJemS#FR~4&2q=g*f?^ z2T;q6LMnQYCRU(zFq@<6UOR?ItNV>rX~S8Jp!bnKi1lFEY#CsbjS9#$*A~Bk7+6RDy@$;#hG(>v~DQ{8_Wz6w}miGg|fV9Clt4-P?pfQ=BJkLXB z&}izJn0ug3NCn30+Q_-~BWC6xlzD@RJEtdes-fyxUcBJ%k?OmJG&(T^@!E(G@E1o< zx>oBoH+aKfg2tg3eN4fQslY)JAjPQ9VB};tb)6KJTj7A#pEt$8#DD#IDj+x+s6<;5T@YJfS`jH zmu@)X>wfGeuGNHKTj1(jHPQf_H)gIj6^%gw(iHp~$?v93Vao@SI{ae9W^dKi*|m`Ua$+_70kEd?`jjB71`E6x^b|P||s|4Nh@ zFt{dw6Z#P8UsaMoulHJ0oPvS#0ibF}{U*7QOP|4*A|oB`aN zWiE;L%DzLL6oABM0RObTm7$4tBybgdcEZ|r=W%q6QrfPVw6wRmeE`v2qR*82qYhe+ zSlaHh5rKaGStz>!kY@oo)u2T54kOmzSgwQFa2Bgm(iQmR>%N;xDm3X_0tgPW_pwfF z^h_g`D*JDzg|`34fBXmkx_j_{ul()c`2SqFz1=1&vfO*~#O3Qn7htU54bRf|Ymc$B z8`arvub(di{qh`pR)kkQP|gDVFiFm_&uanyif&N=EUXgrvs!~i-N9(3$>>KQ4wji0 zlwf8ZeLYzCF3ee`K5+E7_C7|pUfo4m3jE91J*DhyXk>wZ8YDiP6PBq2{3{W8&ic{U zeRt&2bP@wHdB`dU6EjTmdb-k@()VeKga!tmMPl2!h`q%Dh6)CrOG5zO!_T{gz(Az< zX5q%F^`hl30D(nT9N;={u-Vh-c@z>>rG%VrNynytBsV4?%UK(E(!{r-@C+w3*G11_6mz+{J6 zZhB*Sm)bD{fYvFP0Xqf}Eo;xtq42q~`tV&dk>LP<3Ms>vqWMXS1xSrPgN9z5Ri^VF z{o92MlU$oRPwU+=hCpH9PJiU`a1HN3w-ow=y3hjSjyGdpCKf1k!3B=XbC96n%H9fG zbFV?nx!71vSchtAY3~#Cq2s~Kg`r3n2nfckL0QmAfNcIHiX+s@n3KqJN!u3X=+Dq@ z_W5ERqDSJ&PNe}jm9NeL7LU2#w+udL$ztxNdW5?st0~U&KzLQy8MTIg*MnT6C~ zLcq_HFKTz)zn;8swXP%ae-eY2bmr!E-OZ0?Zc=A0C>4#@@sqk@(gYEJ@`TgShz%w~ z(}u8$l)Z;I{bA(V(68)q-$W^3(D;)38SIyxhb>9{V{;PU9t}1F(bQt3=;<>ClXS3{ zz(Shz$F!(|ID8lf{<5MdAeaRI(xNCJm<0RsZnF#&w7}o8NP>c^0Ko-Qu9PThSds+) z(jo~6a$VM&+@&4MDo_yYzp6pOwC$78?6gur!G-oUFG-tk!fC?L1q3jttUrKtmL-ep zi=2SzUYZdw)2g@Jv_4^=PJW}IT7O`(0U*RSC{MQ`6CqjXSI1v#%wvr~5cm#&AEoxn z0tbT9bho%KVQ>%qPe=>Up)%u$`^=dol#<*G2=oLv2UZ^X3tMjuXauTWpt=V)(0@qZ zy02`(Fmz|%^EeF5WBnbmkuRpyUM;ZcS% z!KMT-$SK;`7Hx|*)ACSPYC|j(5#wC@VPP!_hzgJt=i}lTgL!1q0#JAesf8NVr)622 z(hj(Otl>tif0TAX`{H=*^zk-FsA7Bu53F^?Mo{&KSaEbzAuF62!!ajsS#|u!*(DTnC zWsmr}Fj$94G4XL!FDne)FCRQ`|91Q%1Ce!}H0uPlc35|9XkcB!ghbdSm~2B546F?S z1pz4HGo4iH6iWJ=>P?fX#2Ie~hi+kMy~kdR(K?y#vIH3$prQ(7S& ztD2H`GIfn9ufjFDb^51qy!%#-8Q6u0MMW#3I^P`Kcl`3pc`0(BsBoN!22!g zXD?q(==f0<26Yj-K(?0%o;M;{ik}Hap4( z+f5fQP>yN?0!T&uY-pd1x+}9%wL z-8G=$$u~o)3)%v1$aWv^O+a$S|MIH?|N6iD`ndG=Ha*sEvnq|ZOjsA-tn}W0_=kV= zumAo(99+q<-{gY#0`T`1gMV15s4}Vq{t){WnmCjO{%nYqJ7Vu67UHhz1eXDFf?Eju zAvE1J>p<|(ghN|u=!DJO4%X8CrXp(snjid2mWGJj!ma|pd6&RH%l^yToYq})`+my{ z@u#udCl?nzm+C09`9AA_G1jh!XszUQm0m0dH<|Z;k?`*F>#?kvhk9}5wA)^9~?XO>Mqt&E;{+4PvcNt!~dYgfC04a^I>Berx zF5`{Bbvtc0b$s1ewjYig86B!I4`y2%O#FEm$%v3sD{I`T<{tvOeqiKw51Og+FaYau zztaA?bvj>OD-a77_2}FIfQ31Pf`Y!DTMYUGaBKl|Gb}Lz0S#kJKS$YMEgyW=jTmX9 zb1L7#m9`nUsk#$O5oC&o)YWGr&juvMvh+Owr&QZd=kCzkQ>{K?NTWa2LA0b9Yj1)! z24D%W)CNF9Fy@ks`~d7m^uJiNAq~bl1B&PaE@xgcLIG5Otn4Vvy(J8jD0)Z>Hb8P1 zC%TX+h{Qk)nNUx=O%mWIwx+Zv4WlCD-RN7DfCN?h= zO1VF@Ou{whz^C#c;=f^GqYxF+*3iycLA$l4=g?moMeb9Df1L6%slmA9SGjkAfkhRC z4&YiCICuJVwD1!V>jtKwtCTk#s|+QI1_r2A1_o(X#CX~1 z)@y!nJoe`i13de~yFbtG*qa<+UUmCv+jXiiO2X>&pNtluw8xzAD@Y-gBSteD=CvcmmLsu zg`Vrou!%rH*&DP0p%I9QC(H*Pw%u5Crf6c_s!{o1??sFf(W?r05{&`}-%nfszYlX5 z-f`HmvnI~@tQAsfF#5xtz1_++2+;jZ(z_Z@&{6)_%ZmSd! zfKh9Pr2QQF8{IZb>ZTz~M~r>YhS(0{ArK! z8t4`T+;Rbb1;D>3|GpZ>-!$NF9bSl~hL?)OVG)hJLV`*v6RraAuZjyXwn|e$sFp-k zu?qOR=>Yhb#R%MpsF-k-2L7#6cGUpeZFK(46(Jjk*jpYtHJc2cUTJK0xA4}-uaBR) zzd2+OFbxlhvlgsHL~@v6-oUXoN8H4IstkaM76kPBNu(T;(Z{OeA&Z90(KC8HuvKqq~>9=hq|`*YHoVLtUF8u^~lHsz%z2#5f~HZ zB>0yWWdOlk3wH$pK@0pX-FE`~S_KFu!N0U9V*-){|I(riAeaX*OCEC-EWsooSQSgK z3@Dfe_*DW5<`|3hx?9efp~HL}zkZ0ZCigd(ZQ9r9SPk5~enMzbd1 z-V130Y>&^exZqvIMREZeb$Tn418^9DP}J2D^ASwQna{dVy*p%P>7omcnLxlXYbIg= z9TEr11SE|+En8E7g;hx`#84L2g)sGeSl$c`5nJs1arl~ZvyM|!TvKHxe)ny(F*vuNLk1sN@4`-5mZNIGB>v=dUOt%hIB zUHBW$Ou}=)>JL)epKyK9&tJagXAJ^vSVg=C01HGO7vQWk-m5nA$dlfi7U8At`__&TiKVJm!!p!Yrab5dK>`S++ z+Wi=1S*^l6$3s;M%O4MU4A&$bxFIRSNa^m}bH6`$6*J?}lwD#3%4ZiZM_!J=vZ5@b zBQtDzZvs2>WIxgU^L3VtV`T|O8wal4=#`$qEdvA#Gxl==f_cHeqJUr?@GmQtu>|vg ze|Z4GBq&&xEw_p#m}LJ|1qvoJWy*qrRj>rpK*1_lg0)uDb)0EGqz<27_{9SY_yN#E zn-F*>>^>Xn4y;bV{<8+(TbLtI`s*CyE1m-b1O&)49ZkH39O?H7OOVoY$Lws3?eQAm zAF2lc3X&=SzcBw*U=O;(0G&_^yjI4dYTRD7WkudnhF7`%7H%`*likumIM5| z4bOs-K;Yp|<6^yK%6ON-zhlw<4AtFESC?tB&`6aT(5N-*oSs*3q2g_eOnHoqm<^WS zg!S%b_c6C3G!=A3Sa-)|<{D-8W6d)1?#FJIH>w5!tzk*5-WkV}jJ(^$+K#pph79JD zGI9Hh-hKD$H_vzyCa#d=+}R39NS}%cc!EsK5Terva|ZvzXGUfgx?>unXA>99Ll^b} zZ&rr1wn?A+KVt3R-X=4tiEHn&j_GvBOc$_F*ia;N(^oUs>+EE@!rXV35o0xy-y#xTvYX8wTa$oqAT2oe-GM1qE z8ZqFehWQ*YFsO?swYV-nQgNxBgdK!Df zzCHkOQzv@wV?%*I#ELw@9M4^JHl-p1IMW+B^#>)vza;RtZj%!5m%77pkqVv`J=PV# z-#S%=RzzwpCOBG20`NlNYV{mtFS?tec2fj(_+H(a|OP+Az+Gnh>41e*lsp+z+gT(BFsQ1!63 zC?9#Dk*5uLpJX+gP3a~5+%Awu^h16ZxPzY_W~TD40|)~A^RGMcK6xEL(AF^tMy~@1 zD)>j`CIGc{06_&>(pc#00D=Vm`GOMVR0Ie%yNUBw6(BfHVF^|M3Rb26xKKu8v2Im> zf;;<*>GtR2vjr&tHsRpo_%PgZe?C4THW>gk0E74rasm@KTgZgde#x@(z$OGpsDL8+ z9)PsAU&ee`zsGMC6x1#e096C*511M?w*+y5* z7$dOk=+8s%2cYaes*|bb5GIRQ=(w1Y$wjPB5Jo-vTLKH~(Pwbp)w+OLh!3$SOhzDM z7_me~eOScs0k@)n7p&J=F=<5XlZy4~qd}W+= z??q0#fBTo!rQD{a{pN82{>Oj(hf@0)i@0bNVe45mZMo`LWYVn<{*?y)GRj`gs#p#F zB?F?O$*2tYlPaZ0{)(1jO)l9(7UORnk|Myrn*jduwxV|2RpMH29r*Va0D-pw{JSme zzr~1FdY4626PfFb>i~JH20=G1z#gdD2&C#rGf1^HwsZZ3l;MniWU1*##(rqxQ_Ha* zi%$VxS~C2xz@esY{jB!D{c&C$3lQ=9DT9D^KZTAdR_W|xN&<&|UuHl5@zICwe?0qv zo5?>L$n%#bhcr2s>^`jmCVo1}vkQV4*Vir_=~HzM8Zi-id^Qu2_rcNBf8Xe~+~|1f zX0y=iYN3AH+pD$yVyV0Zz(5QBrG8%$5L~4-SQZep;9qLFB>_PT{-s5gfMC3!lyY){ zg3A8O0|*v*mL}azSAl|g0l`%%=0)`%Hw6^jGQ-5n{yBkk`1d3{r_aC=R1Lq#@t3td zv9PIsakJ}ovHB-WL?)+m*W9bQ@dY&R020O-eG1|+JDK}0{m#zUICYo%vd$qp6H^~1 z{U~Xbwra#o)a&1B;#s4L{ZAu6Ps<<>5UIPef0~DZ#P{vooxd2fg{&}D zfsWAoxY~fTFqwgvu1~=vjk(o}Gn4%o-~oqOeGbgBx3d~~?0TENpJn@++3l9>D|Sp~ zU%#k5AkePT2-i3!+jdKiDXA}*wXc8w;IaGX7f%V`A%{=6`;J8ys#_;^2MNY&mLQQv zf*1fuuE4dxg}crLXQ6Wki>bi_aRdgl1v*qzR4s5@A8@~T{+#>0dmr5?(vrE^fvbSO zJb+*p7+A)6I1eDW3j8Yz2(AME(jrZ#HVqVvvH$W$4wm3D@NXTK;41KM6Ip_q{<{t+ zSOp-6*y`;#XNQgl3<`qDS8FW-fuoZN&6$VCkyamc81;KF`dT{;(x1be5a*|JuR#D+ zYrE#Z_s0S75vj@qyvb)H0rq6hreiAX7tA+r!XYlmc3eh;kszRLF;_wAva;P;J#q4t zpoNop=vjQ&=XAjOe&pgS_nA+n4V^prPEu!Efd}E30muLyGq$BaB@d^F22QTP0*ZlA zr%XVV9H3*UJGXVe9ebAS7~{;5xV5YChTg;YEyh^dUsw{!@N7cuI6-1d*}z{p@UIf!FHv?r z9i{x>-?ajNCBX;3D!m5ym;9RAamjCrvj2|0;>m1PIx(5xUxmP5@D720n9vkE;1$QU z$v|LmHQ?W->;7FC`)^rlo`mY($2VL2VOjR_Z3j_vG~ta$y<2lLO|^NKBj?G=tBbaD zJF_op<|CbwoJ*@0D#XOi=y*|-`e zcoGn-vd&3Rkkb__hy)y6}xWCZ14o{}O z>|GdG8iqObv)C?S#Gxs`XOPnp_hHgY6qmtqe@e%X--73;rXODaZ@_IiI+=R+WHL;d zM)zr3+}e|YHrM(o=%>*komTvHr0IuoF4_j*ot?ki{QwM1+ZUXiV`I>eL00XT>^%1L zyJ2Mpd5d@cn&qzhP_Ze!Hq|%JHd}Z9vwsj*l?Gc?InB<0qQ9hHIr_i+=Z*G%s-!+0 z^SKTC`QKNZwyXimbJa%Czw1VGn{N_JYtHrP$k=FTQWqzee2uWsX?B#M+OB)_yP4)5 z|J-<0O~uTm{n_|lY+p$*BrDC>GT)NN1-9ZQ$FJQ}_sjjq3u(Ck_p;6v zZR#13n&>8DLt?U%K$U+z70zd3!*jF146@Hqiq(=ksXX+aQPAdMP<64+OZgz~|* z3Ec>KSBPD(d-%0Y1twAb(7Ex8scSum#=MxMciTJe&Z9UuRaN>Im`+KyQ?t|D=*3JN zd7~BY`{6KJMeN>>3?C3@FQez+I?>)*Y}4sFF3TorNt!W@U)L{ta5lU$U@VPgnM`dh z6RqB2JC81^aUHhK&{a$I?A=+EEjxO4OhzFJR$;z1n*ewUVq+h$@6@H%Y6fDC!a!fh zslWpGv9{mbXKWE$t|^iRdR(;7!6~!o+fY8S?riFY{0txy!($~Y-#}_;C zeFHNH4M;BQ9ALP6>^}o;sgcct@yLd5<`uQ5Ovr!(dGmMw& z@}9^GCZOY2YcPWm0Hwy(-6rb}y2OyR9=JV|o;yuk$Fv;)%rJD_gQgpwi>6|N5Ow+E znCgOa(B7`c_N5wy`2OJ2Ugo~EK2=1-wOk`~(nyVeU9tJ3nONL-n(q~~7l6O2LxI0! zlm-7R@Ml548$Tauz#pO_@Xrg#RtWwr0Dl#*|E|K#GmVkCaDp;UnC*}ev+*qE(zIS& zEq`ZKI$)lMh<#ukexAaBTQlDLxxajoC@3z7-Mh2-X^wWlw5i}MV>Sd8J8Fv+NTtaH`zn-eisS#n$p#}p)9 zE;*M)+Ylh&KfiiPX~igOGMf5@H|o1&(Lz&xt+p2RTJpHlv@$y;RY0%xph2l;2dJF7^77kU5g;O9 zAKksC*R@lJT*SdoyOCBOt_$gVX;Eaa;o8FVQ^3)WDWKQ4*YIh#%CrNZr{8PAx{yM3 zo`$Yz^jB%YDCCaCr#_=UH!0Kj{=i7C1ZE6Bcro$1eck=0+rk{=&f0oj)DL z^bc0C{mMiY&Fg_bLDo_LO0pYi(E0{=15} zYH;>_tRG zoX3@V&a%!|LT4aP8~*#dkKJ!CestqY>9=aEZ#I1~b)&}2)yIKznA1Y*PbPxFP*{aJ zDcxTIwvPh0^U=O55=Gd7MfA-q7?=kTyb18H3P3Oo{HuZ`m<9e-0SIP+e^mg2Y3#qe z*VCr61aAW-AUHRg ziPYu>1f=;{$f>+uaz*-9lKBE)R}Tn)#P$FK0SbaZ0H&daW?(5;Nw3Et0hOWIMnOcd z;`EV621#J^4d))D#OKy^7@(p`$M7P%WFjIBSo$Q?lPpMl7iHOuA-$&khg=tBO9I%_ z0JCo{AS8}OS=@9EOa==dd(>m?|0J469m)I$VBpr>cBXEq-4~*Jn7*$nBIxX^KmGck z-<2=`WtV^ZSLqJF|LwP@{eq<9cwo0{FM)yhO!Vi`8j4`!7G^FFybX;13;sOkX7BBrS70OqN@U^|z|MuVA96Y{xRX zXi0i{QRZJpM)L~rFSDe=l$Fxp-!%iZw}Jf!;~lW?Rs{xoG|aLLBl9zx0*uQY;^%2; zq?!VvIw}?vRP7cFo6#b6cnub8nJ+2TKexgVFAH3P;Z^E zfM6M;m1S}K{Me7nz-j})g|u8Sk&_ZWm@9%AsA<4zo?+)`_zY}2?Hf^^*Z2=2i5yL7 z)iIrC7s8xF7=;sTD|MR;=j4)0#}6P;oOnqJ!N~5ATQnrohU`L&H_$@t9X9=fFaS;^ zB5cD!Ib1X>RGfhvg0=D?1CWYo>D&<46{Q~wAc^|7w-Oqs=Da1fL}$b3y#+#(Mwv%n z_9@$JHg#_I;c_t0hTY$*-!lljPBb=>>GuvW{H){7CdZWke>nCWPxd0LE{~ivFcUo*&=jN~-ay<2 z@ULiuiSa>}uy>a8p}k)zl_SaOc^}sn{Wp{74hj~ZpLf2f9&p{17#>YsxRb!vmZp{_ z*kubFU(LXk_F5~K#vIelOM+v!#a&q5sma~I5lXhCfl0e_^uCBO&3zxm0WCUm_ve?NIKb?r|?NWN7q_=nJa!%Y;j8%b8* zI-zB0AD^a2w{EE6N0QaIPH0&$z5pm%rRjq*1TRkpq}v6j=&C|lf+)9tHgvt+>Oep} zcY*v3D@q%-z;mN1x|bE{A6k~60(NQazA|CU8JzPNyHU|~VgW_HhpIB;Id~Y6cl5eG zKR+e#5888Sdcg|*A=ErWd35aZ8v%b<$eoQDyBNHgx<)5p@D2{?v&endmu=FCH3eDc zfT!ONiH(TGUSjGAqY$7O`dS#1sMGVDU8n~5r}b>L>TYy7W#0fwQDzN7-X3YaQJcaH1;?P8iZBMD z2%sMr%_%QlMDw?*^5n zL|ira_xg|he9TLVyv)DbkzRRQz`x_KR{^voBgg677mbxSUoNIo5x97j>6Pyz4!2m*Ed zm70Q>`Y)scS9RXP^zH2ae!2g^{jT#;zHqKFc5W*3!1ssaSFQhBQa1*a(t+Nwaov>(aWSeCLdUObur<q=&d4Rv9R>2f5Et(J{R zw;#6GeKJX8b1OV4b0WJ&ttvV!tf3!)_u}oM5{43F>*MKSA7VyskfO+&q z{Hm_3#v&{OP*Z?0sPh9%^Gr_OyLUd{UH||!1sEyGdQT$-__n0~-lh~_tePhyunfR| zSG>({OA4^MAphmogIJ%CbkU8aYGtJ2+W4|rtr-Y{v}y14vmbeb#B!V1B^ zRZ#>G%wl$DMNu%&f`56U2q0*|zdTU{5VYW5o+ttcra6Hwi=u#F5>Q+fML5tSQ2({ReYEF!^|2A+Z|erJujj z*h4A~ktvgVsL)h3IkX_!mY_0PK*#(!1AmoxP}?&Yulq z4D9`nBA_st3J(oO|6Ss87+r8b2o3Fy(IeD0diF1oWL(*30NK5Y`OxrW>N@)=H~uYJ zRZau_@>U)=HC@(4qpZMcU5upb$`Q?sBd4~bc*&nHq^MeqrFB2f-hUIbAy0b za7j<84;|+13UJ;Q7NDAfSP(GJIf%I-YhGK9-z{xR^Si(M$w%&=zx*L8Tgs2zHv@P1 z&Db^THP`y2;l^h?eydvRZ(Z;&&Ez8soG1$Z6=eq&1^&aLG{*m^yf_6w{mM;O=HG4Hm6`tc*nzASz#z_(SsF(-{2lF{H4bd;8zi)Q= z91KqEHvn+l6)-RmFwpkZQ?i+tcAnt6jE;RI`qH>a8QeooN%rU5=7rY_if@_LzpLN8R}n5?~%js zRm8HCc*|4-aOLOZVS*WFgv5Wf|H%FNWb+L{Y{ZT&aeUMSS!}-)5O5hgU7K^+{{F)k zAG%+E^^`JoNMaENA4`aRn+X1;MOwOW8SpPJAXo@;WFS~UO=!6_*VoFEXw}N zinO%hGT>iYRGl`w3=mXMuqx@NBq&%FAb6WohY@!lM+T)DZw5!+a1o##7CQjM;WIMp z5Us#iU+H)oUD#JM4giUmFXA@<3XzrzMxJKgVRMWPasDyRK>7Mz=Rh>TL*Pym*XW@S z35B^Ac#ty2-UCw+T7@-EU#_>H*T+mi1rU*0MfEddS|uW)o&Ys9;|1j-RT(Tsf3Tr2 z02NTI2QCzC6##?kOdMK`Kr+K?#4-O!~ku;UFyVj6+pta*Ydv!+8Mp3;$| zCf>A`VA&MlGQeN66S#|)@^GXS=oL3#P~2Uw$^kZV@Ka;WeiU@rs>?)dThY>r=J;wB zf)1m)VuMuU5xQB|xCN~JcXB^Ds*?G=uC^5Y>9UO>Qd%^Y?(eEFogliWV)uLsxqeeVs>x_J1*DXvAHDj+rE80`Sdk*%1_$9P7C^G9TqeD9RlNE0 zWjuYNqR>SU9RPI?n(p#-l%k{eGE!EC#}hM1Tnu_vW5AhkaH}e2G;pi9%$y4#n-WQP zyeckQGK?wqla+yS09Xm{azMPi>b?#l?pttWtT+^?{r}s0lV-`0>)z85ff(+bb7oa$ zC2Ll(L{^d1K$)bcmfEb}=JlfA>MeRNtt3h^N?$@|k|;_GeFbj1-=-IBZLis~r$>pT zBok=Bs((#&CWA_Teq&?RFSDn6r)N`FIN0=_eDm@w_Mq60oh!T{L}ARr&pL z5jV1$O_mpUy3a&@FWL9Wsot~<9)KdlE&XG1I-X^|)*^|N164HKUY`3#M`uRofb@Q@ zDu3u38#7X=xGE^n=xWStAN04sp?A#p2Fd%NBnf#PgRDBux;>H;2wb39kgAk zoxd3SF6ZM-gST%j%x(|2yj?POe5gt(vo+=tk_wgBe3`zKS-_WTkZR@*f`g%8Bil*t2{K|$dYQlSPt?Qq z_-yGa@@3wsEm^tIGGLb!R{JpSsj9>``mT41N?7q-p9NLlbWSaKB)J;~P$;&RTLcE=9G^U4y)#R&+r zN8v{(F2%MqxD#Mx!;eR)?&JBCEe}_4oY&58~=uv z*YKX4n)i=`{2@(m+~31hr^63+;;x|bDM z6!M#bR65VCj;VCR>d!veg+LxH+s0R*tM1(O;y}R}DFY`lIishPg@>EGgtl&iA@f)z z|HdzO^gWw7D)WUu28C) z6qjq4FCrr*C^Pbho%+%S0$xtr@1t0f6bq6=f`j$aQK5_y{Q{&6`3Q=Fg?-k zmu8!!0BLqej3rn1)A|Z|!a7c?JWjQ89`*>rW^0yqE@9oHmbu0z2M(if6d&>kejr_L~wk+7qZgrpkFqOIY_gWC>N9GMH zbUNIy@jppREz7pstA_mmYc~9qr=#OS;XJ&}uri3!&Rtl!>A}Oza4!8zooM2Rp?w8P zI?ta00Mq&0LKvpCnn@z7hauzJ4?2q%GuWt8uE%;BJ zCPA`Q;vbAcw$k+WaNOe#)ZiHmeU|(}z$yVQmDn8~c0_li8YWL|4tJqq)o}QajJ!GE zh7?yjeN&J4OBGOF?z;y>HdCt&TV@SYY4JXW24up)4sxbL>eQ(1-Ld87zsZ2}Dj-41 zOUS&W{|+|QG@_~rOxS4(GY`kQ%$`vm-!t{QKMh1$sz<1?9j<@3ro5W>Bn@cc><@e69;9A#-}T*d$V zD?-~QInfn>4L3|mQda>0F3>el?87Hm!Cm_AAmVMrGYgy`4M_JPH$7;$Tg3uaJlUH{ z1qxCw9-2lwVRGJSSNRjBfT_9fuk=lWnn1dnL`iOW#bx`N5=DelU2Rz8(aZCgt)-|Q z!DneAu}-m*5{aIWK472TxnQ0`V&Zc7aC;R_(|qLHlzop6S5LmzPsN2<_;`3q$G2-J+vDd3VqT2_8 z06xE;B03AZ(Bs#e7+o2GIc%b!!v?j;Fa8z0X=+f!WU}bnJ~bt--=Ao(S%XUdUW$K# zQ+KP;12meZ zKET=U3DKJ(Na5LiLe(o>6RSMw^UwDFRz>~kC(~KFx{4gSWNMJSUw?u`L>?2sw&VjA z092=3_)AyW#9U2wAq0lQ_rcc*5KArw6XE|pTXDijgEOk8DE7a7gDRTNAl5C>vW2V@ z&yd*a)gnPpk&42|m;T+OD-z}%!UqQmO-jx^5_O-e!+hixA2z~5$n;P`^_HDwiu&K& z+p2pi8z=0)6&>A!B1(U?>jf^cKkO}zm-vH0Ts2#Ca|{sAR>owR*QyvdqUjdi-qWEC zAoS`T2>q5F3K1HGE9%2krZgGCQ53YabKBvbWU>rCk&&f`ZHM9*TXiIFs)|)GYEIG` z5lMwDno)A2!Bf4xYsm^q2g0v%v;^H30`dnlD1q?r%Ge_HbhX?`KJ@JD$3Q~6_!o7( z8=%i9_y`}aX#3G`>T_F7p&WzIXMcMeS%@d*Mq8kgQ}0r15b!}08H-G@7eweLV$z~B zBJzZd$Q?{_a#`#?fg-!T_ntBx$V93a0y_`9E0seR=AXC726n0@-?Vw$v=#*Ds;j;G z3}8VH-OCsIO#!j0v%LZNcUksvyzg%(J1uQWYG6(DFZw#W?0G5^B<9_!1cj6cdDriM z)6-9Sgnp{})^X+)GEtAZl=atp3pKg1L%jEB;{j@-=XrWUP1VhV(uNwJ1Vk_Cl8wYI zRmRHt?Kwk!ADxGp*!d+eZ)(!d=<(>WYG?=uO8$*Ix%PY9zl>SCJ-c}m_-=*Ip1vC= z7@z3O7e&?9RO+|)YeP@PFX851pM%6>PL8it>o8!<3F52~uTd&?aIkT$eUeqXYLS*9 z5%`zduB06DX6IFbx>*nuFUPV{Mve{d|Bc;vl^dA^@V{ zRW1bd`87N{3On}fUGi&q-*Vy)A!S z(#HyE`fUS!Sk;sPpsflPeVQHU(VQGe(kkW^0U$93~%)j>; zb=1`+RSjfFX3T0_1_pxAwVhruk5C?!tgNa7n>um4TB@#Qt;9peW!Vjl$9SQs?172? zda_8rP;p9>J)vEe_6yBxuM=N~zw3+Gd|vedE0?wTB3-lJ%qF*o*gE?U;z^^_l25M)*2Xd<|I*VQ5hPq0@!0A|0QfkhsZ}C6y3LwraoB!A zPKEX^D@@|@McskK>C~!yZ-6vg0=o8MMUiuziT3N+yM}+?tlmhleHWtc<$f)gSjsE7 z_)n7DkJvJ85N5gN_`zJcnoma+{k~Dq@Mz*?g@Gf+>PvW7MQx7--`1V~P7BS+U6OV@ zZd{z2veDdaV7z{Ak&jUjWLPy|qub;YKa)b1(L7BZe(b4|Y-J3|R$xj&`CmS>1ar#b zU(^ZJj`nJQEBj6pX;vgJ#}>r3`Rc#G_c_CB45X?|)Bip!_$b9hyS43pmm?tDXR*HImrP2C6-YBobLmCUdkcyy_s1%_ z3>|l;t2n;A9CQOMc7;-<9x2$%LL$U>XQR>Lj1s$0ee(sWyBn(UmcZq`)!e-qqmlBt zu~V)GpLKbn1g>sA?EDbG!(h=JcyM778%N)+*pZ2NWsrB0IOcTkF{5f?E4bM~LVH*d zS(dY~AgwOPM=MH0e0SR}ck~6T+gq;f8f<0ND>Be9u=5rb%$$?JLN)SSK2HC(=?x!v zd5nVu%$$*o^$D3;Ri9;rXLI`Jy3gspH;K^yvXqoI#bKn1%@8oq;-{lNAr%>Xd;KBQMLQV zz!cM)Gi+v*-KpHM5q(D!pL8|5RtWuZCqRFti>9xBsB;T&w?J-AZ-0{rrqXr6 z<~oso7^nid))`>Ni7;GuQoeac8Y$o+K1FkKic*_srjAI90^unPy6S6K?5NPiGr9vZ z6Q^z!x&~Pkd}kD`VRDzkBnp1<5}*8qhRFy!mao$t%Th4P#fN7)EDE*^RMU)${TdE`Kvzxd5uM3u!YF_$& z5;S0DMDD-3nJLkL=KNcx{`KdoU=d%gB*42#0V`VJUDiJENVMbUqop9z80$Lmf7{?n z!r-^$(;VFlMPw&`ig* ztI2)Fo1PlygDbdk{$<8B?5j)Jmf)F|D*GS&vT-yQpI$-lt}-eryloh>GZG(R)>ETr z7ZjYRmdV;$INYo_cuk~tpu~O)Ph=aF=MlL1&tWJphYcvJd`34W-pC&tc)h>Hb0Z-z z@@8DDbnTZnNmk0xpKWwDYo~F?#IALX;2!!!*@P>W4Z>t-XkMZo;~zHbn8+^;y`92d zLLRf#q)K6R%wJ~wQPY*sKV|jLhdPc6S(?`H!p?EiLm>rR)R*mRy*XkqS$Sm|K1^>Jo2hc^`Ct?jNdGTFn(HUqdF9v8fv?zs zBgMeA7>CTF)c77`kB3gA;>o+Nk1)@uSUi2xNAWj2-Jp^?CaRrPbciKcJX81wHi2b> z53wS<<3mnow<`6l$MtXEj?DVcQ=_WbK3K$gqd&|Imd@!{Cx*rCg5cY|?&NSc4gupD zj8A9>a=Byvh^=?MJVII_;QV3k=OkM$Y$XU+#!cw$xm~xNfq=hhOULjw6HDL5>fatM zd3z#*mRKFkQ4nc<8CXCP-oB4g9Xk-7QvI71x6)<>0Hyl_s3Ah#$m;{)k*Lv58=niF z5elK(WGkCl_{`_>c6OYEf&y|dE0PvM$`U%icBny~v4S6x%BiA}%a@!lohJaGxPN){ zu(U?;K!DoE0~L+}WG)q{bP6S%n@bAX6coDTYD{8XWn)?=l)v{w4mHRabY8`Iu+g7B zs!k4VJL%?o+x^5^9E7yu9=+8)zO=O`CAThy5t>gUN8hNN7`Koo;+Ez=2@13BzH2xi z7MK)cJPd}B6P}W(RD25`R{PvWUk%~7>3_xFX*=lf(yKFP4>}Ry(yjez(^@jle?=Dr zw<=2PKT@)Z_{P=*ul4$MHuWRPb`^W5M73!v%fP9a7`_W2rfo4?$s&Y%g;0teSH`D0;UfIA2&zz1WXWQ8WtpxS$PNrYo) zaV6wPS6!7bqa|4%eYO3S=e}wcgs@E}Q`-6Uy@CM?EX9wK6(C5G_%~eXYZl%_8LUA+ zu{DDhf~e9Fs43glmgB{RL|#!Vq*2#|GhnyR``e#&2dv>vov&r@HRm`}-fq8Ufg zrFrNeIZ!$^QKu!orW;-mO~-MrukJl;51p2h$r_Zf`*=MXgJ4n1eF6~z(L|1{#FAUc z5q{-$Z6__&3@NUhPJzi*6MgFr!hiG{Ce z8*e}w zLbTNQeo}sEW^EOkXs{&+z&AlIw__ux8#ZoXV~c-eJ>kLEf(f(_V4XPz8+GlnGa64! znprPs9IbM|qB~a4r;i+12qj2#5CSf;beQ%Ue&PON5iOv-!OXRxe}henV~Ts5>s^%) zZSR-#rF-dIh1P#1+#qy+?;HRl2&aZyr>k;goA1rMb;P3Nh=C;PjotODtS09y1XJ?d zEyT{pJc6#Q^t7ILWTH^pEhJaSeOVs=5rC4w8>IeHHJ~IDO-J|lZy>+FtxjQ)j(F+o ztmqkPD-RC*@Dr}W8-(R} zqpeEo^Cdz#ZiC&C0n5B0WG)oFwB@o$cEhAp;LE<5??|ciypGC1dNWxbGxxlJH6q9J z(FNIL^L1{GGFOgRo;tjTZ2tH|?tdbdPh(r!*Fq%#Ai28|z>c*LRO2X{}3r0R#j%(=QzEub}-bv;b1;K7*GIT2Xugg*P zAwNMcZmFp!?l$3f{sdM($WFm_+l-D-FamTRl53QyU-4mzi!^7EtsKf6ih94AnNu{r z${qO@VYmLuc<1C7U1L=-craAC)0VoT`a<*yY{E>@1f-Ey!GngnUxuOOPCuG0DTEWTeh)9?m;u=?S(e*<>DSboJoI1_wo3mf~pu zl+_|t3g-TWu-AxH>JDl?+keVIfNN%C&WM>_PQG*#*9}mz|E7In7Pnq}xsh>Z^0P0x zg|$^$+?Yh-X0(awa&|!pM!)wgmWG*f(BH9_O}S-%;{qdo^ws2oV1ZdfGnu zr>dx)k*Uyr;-b1czQ3znQd-`C_wcLeE4S3=GrHgo!TmR))sd4)!?$xYOlHIwIfZ%3 z^h`uGHv;RZtGZ?DA2?%f-uj@qd3J#f4m8R%+lp5=F26I^wjP#j=ICAOI2ItrqpiVL z>2|$#scL%G7-H>u9U_XjxQ|A(Pug{Qjz0Ol0X01s^}c zcIJ?i0?vQ+f)W1~sf8J%#q}7IC}hEO>St?HZanzsV$*>*7en0`c%jox{|C(G=4HCM zrv>1IFCSk0wQL1gssD62>3i5YBPBr((0v=*)^Y!5aBD%Y$ZCal!jJDuKYLIVqVeuE z8s4fV>vH5lz+kS?PQ{R1F`OB*@OK)L0}go*$r8rb-daqI>!9;i?Ehxgpua67z9lH4 z1a6`lx?j(I(jGV6@_nYs~1SFo&0YEPl_e6GdS( z4j^k^;7TUPp8B1|CzyCX;(H^2p)7kR%tn`-rcTpk8xv6VWQ(mKM?G_D;mAyCV{(_F zytTyY?(`+40yW!T{yv6AfSLQ)c)M;3%Ix!H#7J?&^BR>)&U$iUAX0?`=h6+BcEo8N zpo3e8p~=M$O=R<9!#5h}bnd-aX{!wbG&!jLnw{v8%K%U4E=kk+{bRnGHz1o1WXpY8 zT;a=A?0VkvCF42QW|VkHWgb1ra?qF?k>Mq)%_uwedz3PG8 zx1Qvfv(uTafr!Tnm5S-Fvjl#exchi!1Z+}=EzoD^j+kk07%c3j@%qkf%FJ{{sju#C z)4dcm5KS`HjNlHVU=1p6oS=!bm}d6~py?m=%Y@2nAr&L6m#(!;q}>IM^^3@-;1KH;91w|*t*!__(b z?!la?E+fOFQVaa=fVJZ+1@2_V`rpu=@UBzlU*m^GPC>_kRJDOUssQ4zgF6cn22FI6 zDSv{<)#!;$uN4OO^SL1YIJOEwijlzo{Z`YRMVfnNd?@t?PRcvTIV!yItE8GVaG@UBmwQAYqRA{w_n$08IFxe z^^-WN2XeI2r(*I=O80kwQgi?nyYuPPO>IHDFI7t|_I7{ctEt%2*xYH6b|&mX7~9V< z=yz&z3jDAY1DUhH0ul;I52Q>7qaGF_bCcX)LXMme>Mx|PElA8-AY%&|i6k?Dv5#!f zYYoOI6HniJJ>`Eo390L2*#iJbMPE2MYS7OFo1A za3U$aiGkg!DT+}hc6K~??cq8F-|Fml2dc{i5kr#@yU$G8U`T0qrzkXv6vJx~c9Yg9 z`__`x0pl%SK?({I?Af>(BX^BM<5iUJ=<97RcWmCN!~Olz4^7gaw_jiCvA~I&HND>? zBcsi;Wx=Fgyw+%3$|isYu$$i>;6CEg%P``V?q4SpRQkQ$2hUvYEiJ7OXPN#zC%Im~ z{SAh?N_dT9t^6V#zI6LaoF5}>i)ZhcJ{2~k?sKNw#PS#^f732IMG}24C>5FYP6gYh zD9BAPwk+)C1p{xM7FSW@%Xa8T0*EXXT3y^iG{hQ5d8_FLQvL$zM#-1Dx2jh?5mVD? zu|}m?1yLPXEBEs(CHMn^A32J2l9RdJOr!S7E@hpaARxI zV>hSxAA&3e{cUY;?o#Y)5n{)JD_Wud4kQ})#F)&(O%S>7uJl7qg(C_x$ov;d$> zAeOH6fN}5AChcDjHS_z*R?y+fc}Dj*%fn7<6I1}=kg0fK z#(<~8S9c2Yc-iC#I~4GUl05q^QIp~Bsr-YD^sL{!u8*`5V z4o0d;yhhRp7~HEg-HQ_v9BwV0G4fu$YuoiZ%i<=WYtS{5gQuK}I{4DB_%LEHDD*}W zc2P27i!+*Dm7ct{hyEni+F)63JUDS@7ZFJU*t}HH!WjMF6H*lBQR&K{I|-8hZC0}{ z9fkfLX>6_$9K~5_{3$b;zJ*{(PBe_tIB(*^nW59OuPTqILvfzN4bRkKmV&@YUDIxg z0sdMdvudszTP|HQEg&X=N1X5PKZ;ie1)>IkEawe7yDG+-j9~0`5&|wr*6n$a&QW=j zFeCc;;M_<|k6hKj$|ajeRHQEhg|we5x!0+db*ErX8USimkSa^M&2SNTPb=%4EGYUu z1!ydxU*zx$3U%^nasmWx^W6uAN1XeGeua)FwpLv9+!*DT<)X0&6$D1xuyxze1I|u+ zrhwPXW4@Z5Ic9X1CE5A$2$gZFyO>Ih)&p+*m)GzL1iG$n5$@)y!-6-lvi?s!vb;Fi3Q1_ra-m$#af#iqy5sd}Tf)xxernnW z(yGnt)I}mJBn;S~KdhcQ+u8lYM3J&X+8>#4D0l~mB01|_8;)V}Xh_HkyAa6Uj)_E^ zWWMmq@Q3&p_dY<8=}EPZNpP1Uah_xeQZu8AY(Hjc$f9^k6ob%E=aB}U(hKJN8AGCC+Y#js|CQM8n??lc`qX)mwjR2h&JT8**xzWN8g476<4S@s8rE|v zK-djh1v?>NV6r%4(l%|HC`|{dHSXh|UJ?yS5M5;)0U|VnX-F%^bm8^?28VFGZ*}F> z-0+IqEy}W{jcu>sZ;2a#jD)YR9>^OUx>$DH!MIT1!=62HntU3i!gQaSpqQwe;2%kj zL=R!~`3r+7@NV;zhFEcZ`k0VBtj~l@K-TYiYHn=hV-Rs32`{`oDq6UlLst(V{IReb zd=L|EwD+r~)%3n-P*#K2$D3{qKgN~?_;Ow6_H>p_i+xk@jyngP{(^7r=XE=s5J;fX zXVRa{BZFSkH1_hnDT$|76Qky;=;xQ6jvxK#4|cj*?#`U&H$ID2;WQ^ksg5*>c_dAZgEjRHsN7xcH%7uowG)MW|W+TAY3p z3bC`mr51dhN6J?M-gU=3;FwuQi{0x|U((2W>w0#Opg6lm!0CtkLTYfMQ|=EV0XBJJ6IJExcT{l0#9$--Ydog&*) z2e^DdgJ0iVv;@Gx(%eY2ugIEb?s|g^9pM+2VOulEqA90*@~qJ{3&YzHB($01zg1b$ z(+9?Xn}-XmNkf>~=Hh_#NA`rZRU;b@?`kWbB!-EL&5x@VuV7XDL%`?qJ&3s#;BAOG zHyB)9R^+KHWpO6+Imt7kl-MUvR{@5}%*?!SkYBf-j%Gy*2y<3|g=u9X)4X{aJc!vr9Tn3fNJpQ1E-;D538UqWw|xhJ4KmE7B7wT9~O#I6P;#nBxK&!=Chq`@Ky8dnTn7d?prZ4g5a!hu^vbvb+2Re2kBNzbK zRVq;hk==?$y5YvNhXsuz>6dyV~%S|om&ZWT~r^Re<^eW`kh&=M4X1CYu1}<)? z0YGRH>uB4)jgxf0J6$@=Bro^o8Xqy7dW*3PPO?;$;9TI1D+*wd#w?B2cO5hM6XZ;e z8tKlDj4whKv{W0qtt5|jw}pr+ValueMc+<-;|4r|7Y!cE|0HE2W=U_*%(E7uM?6qb zlD@1{l^dqk%Pq7@82&h6u>6jc?w{uz_$~+Hd`w`|g?MBGGIzgfS>S&+(G@pl^R63V zG_LOo)M3g<{k9*7Pcr#j$%2;yU1yToztlXKMMVA#!1H;$U0RXhTNh4c^NDh5stm(U zL2!a)2o2Va7HfFAY3)B!(Hd9d?~DE*^R8>baNZ?>^Ci!xPv+AG#suDUT=Q*98P@rw}-#B%xYpWRr(=B zsO(#~i|5tQab|s=PHD|k+Zlg$e?M~Zg9x5O>y+R-pjI!W+FJPbB_gvu) z`v81tBoIM0{rcM2ypBpO1cUq0rbgL9PPyFlWm-h&g?*>$mQ2Qo`BW7-BTqoP+88A8 zM{aKX>KLU#QmfhI^1ggMqcq<4OZvf})^OV}6if{**6z5E51_m3{mHu!Pwy%2fOoj? z7_xHY@3O7;U6ht1+-7s*B`qBj6HTLr;zXV1+UK=|dw6aLV=-J64Dn3(;#kKb-fDP`SL2?nHtkzUDVBqv1j zIci|D9)p(V0wRb82%R)BX>K8djOxTvPbKXIDeKCOMD$!x8#yp0m@z#~yfHbRuC6LH zsVc$!!IKeke6h4Kzr=ef!nY@Y#QfQ;tPanacgkS9IzHEDS>IPwcpPRfX)7GpFPfO> zoN~9mw0!`Gut4SA)$kbCwT`dom&672HZXXnhDWS3C~lt}*i?q9K1Kc9wupebD*?iA zK3Y@%QD()l&JZIUd4*HwgBNJa8WMtCUgQ9OnvJSxdll%7#N3y%F!BD(z!$}4Sp|dE{Ghsh#c401Nfzu4`GU*nfjdLO}s*r@i3e0t;g41EPVaUv!{m8VP+8&b=QCUww8I z6sIRN0I(}Y*yfy@T0q95LK1~5$MkuBo8;MAl%vqSf=B4|bHys6yB*r<3%DN;I9w}1W+88t{+B6Ywso${7oa$8X+

xaDcPHowD0F1h(+d%s-&1 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 literal 1049503 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

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 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 43/64] 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 44/64] 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 45/64] 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 46/64] 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 47/64] 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 48/64] 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 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 49/64] 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 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 50/64] 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 51/64] 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 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 52/64] 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 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 53/64] 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 54/64] 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 55/64] 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 56/64] 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 57/64] 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 58/64] 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 59/64] 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 60/64] 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 61/64] 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 62/64] 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 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 63/64] 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 64/64] 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());